Skip to main content
Version: 1.19.1

Configure 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 \chown -R <user>:<group> /var/log/wandisco/audit/
  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

Hive Migrator and Hive Migrator remote server#

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

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

    Hive Migrator
    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
    Hive Migrator 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/hivemigrator-remote-server
  3. Once you've finished making changes, restart the corresponding service:

    Hive Migrator
    service hivemigrator restart
    Hive Migrator remote server
    service hivemigrator-remote-server restart