Skip to main content
Version: 1.14.0

Configuring System Users

Adjust the system user or group for each LiveData Migrator service to suit your environment.

Defaults#

The default system users and groups for each service are as follows:

ServiceDefault system userDefault system group
livedata-migratorhdfshdfs
livedata-uihdfshdfs
hivemigratorhivehadoop
hivemigrator-remote-serverhivehadoop

Running a service as a different user or group#

Follow the steps depending on which service or services you want to change the user/group for.

LiveData Migrator and LiveData UI#

  1. Adjust the system user or group in the service configuration. Choose one of options below depending on your operating system.

    1. Linux distributions with systemd
      Create an override service file for the intended service:

      livedata-migrator
      systemctl edit livedata-migrator
      livedata-ui
      systemctl edit livedata-ui

      In the text editor that opens automatically, override the User and Group variables with your preferred user and group:

      Example
      [Service]User=<user>Group=<group>
    2. Linux distributions without systemd
      Update the values for USERNAME and GROUPNAME in the configuration file for the intended service:

      livedata-migrator
      /etc/wandisco/livedata-migrator/vars.env
      livedata-ui
      /etc/wandisco/ui/vars.env
  2. Change ownership of the related directories to the new system user/group:

    livedata-migrator
    chown -R <user>:<group> /opt/wandisco/livedata-migrator \chown -R <user>:<group> /etc/wandisco/livedata-migrator \chown -R <user>:<group> /var/log/wandisco/livedata-migrator \chown -R <user>:<group> /var/run/livedata-migrator
    livedata-ui
    chown -R <user>:<group> /opt/wandisco/ui \chown -R <user>:<group> /etc/wandisco/ui \chown -R <user>:<group> /var/log/wandisco/ui \chown -R <user>:<group> /var/run/livedata-ui
  3. Once you've finished making changes, restart the corresponding service:

    1. Linux distributions with systemd

      livedata-migrator
      systemctl restart livedata-migrator
      livedata-ui
      systemctl restart livedata-ui
    2. Linux distributions without systemd

      livedata-migrator
      service livedata-migrator restart
      livedata-ui
      service livedata-ui restart

HiveMigrator and HiveMigrator remote server#

  1. Update the values for HIVE_MIGRATOR_SERVER_USER and HIVE_MIGRATOR_SERVER_GROUP in the configuration file for the intended service:

    hivemigrator
    /etc/wandisco/hivemigrator/vars.sh
    hivemigrator-remote-server
    /etc/wandisco/hivemigrator-remote-server/vars.sh
  2. Change ownership of the related directories to the new system user/group:

    hivemigrator
    chown -R <user>:<group> /opt/wandisco/hivemigrator \chown -R <user>:<group> /etc/wandisco/hivemigrator \chown -R <user>:<group> /var/log/wandisco/hivemigrator \chown -R <user>:<group> /var/run/hivemigrator
    hivemigrator-remote-server
    chown -R <user>:<group> /opt/wandisco/hivemigrator-remote-server \chown -R <user>:<group> /etc/wandisco/hivemigrator-remote-server \chown -R <user>:<group> /var/log/wandisco/hivemigrator-remote-server \chown -R <user>:<group> /var/run/livedata-hivemigrator-remote-server
  3. Once you've finished making changes, restart the corresponding service:

    hivemigrator
    service hivemigrator restart
    hivemigrator-remote-server
    service hivemigrator-remote-server restart