Uninstalling agent relay services using systemd

You can uninstall an agent relay running as a systemd service when the agent relay is no longer required.

Before you begin

You must have completed the following tasks:
  • Verified that the agent relay is installed as a systemd service.
  • Ensured that you have the necessary permissions to uninstall agent relay.
  • Stopped the active deployments or tasks that are currently running on the agents that go through the agent relay services running on systemd.
  • You must be a root user.

About this task

To uninstall an agent relay service, you must stop the agent relay, disable the automatic startup setting, and remove the associated service unit file.

Procedure

  1. Log in to the agent host machine.
  2. Stop the agent relay by using the following command: 
    sudo systemctl stop devops-deploy-agentrelay
  3. Disable the automatic startup setting of the agent relay by using the following command: 
    sudo systemctl disable devops-deploy-agentrelay
  4. Remove the service unit file by using the following command: 
    sudo rm /etc/systemd/system/devops-deploy-agentrelay.service
  5. Reload the systemd configuration to check agent status by using the following command: 
    sudo systemctl daemon-reload

Results

You have uninstalled an agent relay running as a systemd service.