Uninstalling a Runner

Uninstalling a runner depends on how the runner was originally deployed. The following tabs highlight the steps to ensure that runners are successfully uninstalled from your environment without leaving residual services or configurations.

A deleted runner cannot be restored.

Installed using `install.sh`

Option 1 - As a systemd service

Complete the following steps:

1. Specify the following command to stop the service if it is currently running:

   sudo systemctl stop traceable-runner.service

2. Specify the following command to check the status of the service:

   sudo systemctl status traceable-runner.service

   The above command and recent log entries show whether the service is active, inactive, or has failed.

3. Specify the following command to disable the service:

   sudo systemctl disable traceable-runner.service

   The above command prevents the service from starting automatically at boot time.

4. Specify the following command to remove the service unit file from your custom location:

   sudo rm /etc/systemd/system/traceable-runner.service

   The above command removes the file from the /etc/systemd/system directory. This directory usually contains the systemd service files created or customized by the system administrator.

5. Specify the following command to remove the service unit file from the standard location:

   sudo rm /user/lib/systemd/system/traceable-runner.service

   The above command removes the file from the /user/lib/systemd/system/ directory. This directory usually contains systemd service files provided by installation packages.

6. Specify the following command to reload the systemd manager configuration:

   sudo systemctl daemon-reload

   The above command reloads the manager configuration. You must run this command to ensure that systemd is aware of the above steps.

Option 2 - Not as a service

Complete the following steps:

1. Specify the following command to stop the runner:

   traceable runner stop <runner_name>

2. Ensure that the Traceable runner process is currently not running:

   ps -ef | grep traceable

3. Specify the following command to remove the Traceable CLI installation:

   delete $HOME/.local/traceable directory

Installed using Helm chart

Enter the following command to uninstall the runner:

helm uninstall <deployment_name>

Installed on AWS ECS

Complete the following steps:

1. Open your web browser and log in to the AWS management console.

2. In the console, navigate to the Amazon Elastic Container Service.

3. Click the cluster where you installed the runner.

4. Delete the runner service.