{"type":"doc","content":[{"type":"panel","attrs":{"panelIconId":"atlassian-info","panelIcon":":info:","panelColor":"#FFBDAD","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation-and-upgrade-guides/upgrade-zephyr-enterprise/zephyr-on-premise-upgrade-instructions/change-ownership-to-non-root-user.html"}},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"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. ","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites for Migration","type":"text"}]},{"type":"paragraph","content":[{"text":"Before proceeding with the migration, ensure that the following prerequisites are met:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Zephyr instance is installed and operated by a root user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Administrative access to the system.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A non-root user account that will serve as the new owner of the Zephyr instance.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"We are using ","type":"text"},{"text":"zephyr","type":"text","marks":[{"type":"strong"}]},{"text":" 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.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Migration Steps","type":"text"}]},{"type":"paragraph","content":[{"text":"Following are the steps to migrate a Zephyr instance from root user to non-root user:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop Zephyr.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the commands and steps listed below.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start Zephyr as a non-root user.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"As mentioned in the ","type":"text"},{"text":"step #2","type":"text","marks":[{"type":"strong"}]},{"text":", follow the steps, changes and their required commands given below:","type":"text"}]},{"type":"paragraph","content":[{"text":"a. Migrating Zephyr installation","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Run the following command to change ownership of the Zephyr installation:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo chown -R ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo chown -R zephyr /opt/zephyr","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"b. Migrating Zephyr attachment files","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If ZEPHYR_DATA or NODE_DATA folders are components of ZEPHYR_HOME, then you can skip those relevant commands.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to change ownership of the ZEPHYR_DATA folder:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo chown -R ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo chown -R zephyr /opt/zephyrdata","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to change ownership of the NODE_DATA folder:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo chown -R ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo chown -R zephyr /opt/nodedata","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"c. Migrating Zephyr Services","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to change the ownership of the symlink of ZephyrService.sh:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo chown -h /etc/init.d/ZephyrService.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo chown -h zephyr /etc/init.d/ZephyrService.sh","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the user in the ","type":"text"},{"text":"ZephyrService.sh","type":"text","marks":[{"type":"code"}]},{"text":" file using the following steps:","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the file ","type":"text"},{"text":"/bin/ZephyrService.sh","type":"text","marks":[{"type":"code"}]},{"text":". Ex: ","type":"text"},{"text":"/opt/zephyr/bin/ZephyrService.sh","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Locate the following line:","type":"text"}]},{"type":"codeBlock","content":[{"text":"ZEPHYR_USER=root","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the above line to:","type":"text"}]},{"type":"codeBlock","content":[{"text":"ZEPHYR_USER=","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"ZEPHYR_USER=zephyr","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If you have the file ","type":"text"},{"text":"/etc/systemd/system/ZephyrService.service","type":"text","marks":[{"type":"code"}]},{"text":" on your system, then you need to perform the following steps additionally.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You need to change the user in the system unit file using the following steps:","type":"text"}]}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login as a root user.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Locate the unit file here: ","type":"text"},{"text":"/etc/systemd/system/ZephyrService.service","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"User=root","type":"text"}]},{"type":"paragraph","content":[{"text":"Change the above line to:","type":"text"}]},{"type":"codeBlock","content":[{"text":"User=","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"User=zephyr","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to reload the changed configurations:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo systemctl daemon-reload","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You have successfully migrated your Zephyr instance from being operated by a root user to a non-root user. ","type":"text"}]}],"version":1}

Browser not supported