How do I shut down an ssh connected linux agent?

Article ID:204576404
1 minute readKnowledge base

Issue

How do I shutdown/restart agent process gracefully on a linux box?

Environment

  • CloudBees Jenkins Enterprise

  • Linux Agents

Resolution

Sometimes you want to terminate the agent process on a linux ssh-connected node.

Whilst you can log on to the node, identify the java process and terminate it with kill, there is a much easier way via the Jenkins UI on the controller.

  1. Navigate to "{JENKINS_URL}/computer"

  2. Select the node you wish to shutdown.

  3. Select "Disconnect" from the menu on the left. This will terminate the process.

Screen_Shot_2015-05-15_at_11.47.06_AM.png

If you wish to gracefully shutdown, then select "Mark this node temporarily offline", wait for the running builds to finish and then select "Disconnect".

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.