Skip to main content
Version: 1.18.1 (latest)

Configure system users

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

Default users and groups#

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

Run 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 /etc/wandisco/livedata-migrator /var/log/wandisco/livedata-migrator /var/run/livedata-migrator
    livedata-ui
    chown -R <user>:<group> /opt/wandisco/ui /etc/wandisco/ui /var/log/wandisco/ui /var/run/livedata-ui /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. 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:

      hivemigrator
      systemctl edit hivemigrator

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

    1. Linux distributions with systemd

      hivemigrator
      systemctl restart hivemigrator
      hivemigrator-remote-server
      systemctl restart hivemigrator-remote-server
    2. Linux distributions without systemd

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

You can switch between default system users and custom users while installing or upgrading LiveData Migrator. For more information, go to Install LivedData Migrator and Upgrade LiveData Migrator.