The topic provides detailed instructions for migrating a Zephyr instance that is currently installed or managed by a root user, to a non-root user.
The migration process involves transferring ownership of the Zephyr installation, Zephyr attachment files, and Zephyr managed services to the designated non-root user. Additionally, this topic outlines the creation of a non-root user if one does not already exist.
Before proceeding with the migration, ensure that the following prerequisites are met:
A Zephyr instance is installed and operated by a root user.
Administrative access to the system.
A non-root user account that will serve as the new owner of the Zephyr instance.
We are using zephyr as a non-root user as an example. This user will not be created as part of Zephyr. You need to create the user separately. |
Following are the steps to migrate a Zephyr instance from root user to non-root user:
Stop Zephyr.
Follow the commands and steps listed below.
Start Zephyr as a non-root user.
As mentioned in the step #2, follow the steps, changes and their required commands given below:
a. Migrating Zephyr installation
Run the following command to change ownership of the Zephyr installation:
sudo chown -R <non-root_user> <ZEPHYR_HOME> |
Example:
sudo chown -R zephyr /opt/zephyr |
If ZEPHYR_DATA or NODE_DATA folders are components of ZEPHYR_HOME, then you can skip those relevant commands. |
Run the following command to change ownership of the ZEPHYR_DATA folder:
sudo chown -R <non-root_user> <ZEPHYR_DATA> |
Example:
sudo chown -R zephyr /opt/zephyrdata |
Run the following command to change ownership of the NODE_DATA folder:
sudo chown -R <non-root_user> <NODE_DATA> |
Example:
sudo chown -R zephyr /opt/nodedata |
Run the following command to change the ownership of the symlink of ZephyrService.sh:
sudo chown -h <non-root_user> /etc/init.d/ZephyrService.sh |
Example:
sudo chown -h zephyr /etc/init.d/ZephyrService.sh |
Change the user in the ZephyrService.sh file using the following steps:
Open the file <ZEPHYR_HOME>/bin/ZephyrService.sh. Ex: /opt/zephyr/bin/ZephyrService.sh.
Locate the following line:
ZEPHYR_USER=root |
Change the above line to:
ZEPHYR_USER=<non-root_user> |
Example:
ZEPHYR_USER=zephyr |
Save the file.
If you have the file |
You need to change the user in the system unit file using the following steps:
Login as a root user.
Locate the unit file here: /etc/systemd/system/ZephyrService.service.
Open the file:
User=root |
Change the above line to:
User=<non-root_user> |
Example:
User=zephyr |
Save the file.
Run the following command to reload the changed configurations:
sudo systemctl daemon-reload |
You have successfully migrated your Zephyr instance from being operated by a root user to a non-root user.