Configure system users

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

info

There are updates to the way the Hive Migrator user is configured in Data Migrator 1.20. Before upgrading, complete all steps in Hive Migrator and Hive Migrator remote server to maintain successful metadata migrations.

Defaults

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

Service	Default system user	Default system group
livedata-migrator	hdfs	hdfs
livedata-migrator-data-agent	hdfs	hdfs
livedata-ui	hdfs	hdfs
hivemigrator	hive	hadoop
hivemigrator-remote-server	hive	hadoop

Running a service as a different user or group

Follow the steps depending on which service user/group that you want to change.

Data Migrator and WANdisco UI

Adjust the system user or group in the service configuration.

1. Only do this step if running a Linux distribution with systemd
   Create an override service file for the following services:

   Data Migrator

   systemctl edit livedata-migrator
   Data Transfer Agent

   systemctl edit livedata-migrator-data-agent
   WANdisco 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. Update the values for USERNAME and GROUPNAME in the configuration file for the following services:

   Data Migrator

   /etc/wandisco/livedata-migrator/vars.env
   Data Transfer Agent

   /etc/wandisco/livedata-migrator-data-agent/vars.env
   WANdisco UI

   /etc/wandisco/ui/vars.env

3. Change ownership of the related directories to the new system user/group:

   Data Migrator

   chown -R <user>:<group> /opt/wandisco/livedata-migrator /etc/wandisco/livedata-migrator /var/log/wandisco/livedata-migrator /var/run/livedata-migrator
   Data Transfer Agent

   chown -R <user>:<group> /opt/wandisco/livedata-migrator-data-agent /etc/wandisco/livedata-migrator-data-agent /var/log/wandisco/livedata-migrator-data-agent /var/run/livedata-migrator-data-agent
   WANdisco UI

   chown -R <user>:<group> /opt/wandisco/ui /etc/wandisco/ui /var/log/wandisco/ui /var/run/livedata-ui /var/log/wandisco/audit

4. After you've made the changes, restart the corresponding services:

• Data Migrator
• Data transfer agents
• WANdisco UI

Hive Migrator and Hive Migrator remote server

Adjust the system user or group in the service configuration.

1. Only do this step if running a Linux distribution with systemd
   Create an override service file for the following services:

   Hive Migrator

   systemctl edit hivemigrator
   Hive Migrator remote server

   systemctl edit hivemigrator-remote-server

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

   Example

   [Service]
   HIVE_MIGRATOR_SERVER_USER=<user>
   HIVE_MIGRATOR_SERVER_GROUP=<group>

2. Update the values for User and Group in the configuration file for the following services:

   Hive Migrator

   /etc/wandisco/hivemigrator/vars.sh
   Hive Migrator remote server

   /etc/wandisco/hivemigrator-remote-server/vars.sh

3. Change ownership of the related directories to the new system user/group:

   Hive Migrator

   chown -R <user>:<group> /opt/wandisco/hivemigrator /etc/wandisco/hivemigrator /var/log/wandisco/hivemigrator /var/run/hivemigrator
   Hive Migrator remote server

   chown -R <user>:<group> /opt/wandisco/hivemigrator-remote-server /etc/wandisco/hivemigrator-remote-server /var/log/wandisco/hivemigrator-remote-server /var/run/hivemigrator-remote-server

4. If using an identity other than hive for Hive Migrator, ensure there is an entry for hadoop.proxyuser.<custom user>.hosts in the hive-site.xml. This entry must have a value of either * or the hostname of the Data Migrator host.

5. Once you've finished making changes, restart the corresponding services:

• Hive Migrator remote server
• Hive Migrator