Version: 1.18.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:

Service	Default system user	Default system group
`livedata-migrator`	`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 or services you want to change the user/group for.

LiveData Migrator and LiveData UI#

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
```

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/

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#

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
```

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

Once you've finished making changes, restart the corresponding service:
Hive Migrator
```
service hivemigrator restart
```
Hive Migrator remote server
```
service hivemigrator-remote-server restart
```