Managing agents remotely

After an agent is installed, you can manage (with the monitor process) many of its features from the IBM DevOps Deploy (Deploy) web application.

1. Display the Agents pane (Resources > Agents).
2. Click Actions button on the desired agent.
   Actions are described in the following table.

   Table 1. Agent management

   Action	Description
   Edit	Edits the agent name, description, and team configuration.
   Delete	Deletes the agent permanently from the system.
   Mark as Unavailable	Makes the online agent unavailable for running jobs or being used by agent pools. The Unavailable status acts like Offline status without having the agent or agent service shut down. You can make the unavailable agents online by using the Mark as Available option from the actions menu.
   Restart	Shuts down and restarts the agent. While the agent is shut down, its status is Offline.
   Test Connection	Runs the agent settings and connection test. Test results are displayed in the Connection Test dialog.
   License	Sets the license from unlicensed to authorized.
   Set License Type	Changes the license type.
   Set Configuration Template	Applies an agent configuration template to the agent.
   Upgrade	This option shuts down the agent and applies the upgrade. While the agent is shut down, its status is Offline. After the upgrade is applied, the agent is restarted.
   Set Java Home	Updates JAVA_HOME for the agent. The Java Home lists the packages that are installed on the agent. Select an appropriate package or enter the absolute path of a valid JAVA_HOME directory.
   Install Java Package	Installs the Java package on the agent. The Java Package list displays the packages that are added to the system and matches the agent architecture and OS.
   Uninstall Java Package	Removes the Java package from the agent. The Java Package list displays the packages that are installed on the agent.

   Note:

   • The Java packages are added or managed in the System Settings. Ask your administrator, if you want a specific Java package added to the system.
   • Agent properties and Java home information is available from the agent's Metadata tab.
3. Optional: Perform the following actions on multiple selected agents using the Bulk Actions option:

   Bulk action	Description
   Restart	Shuts down and restarts the selected agents. While the agents shut down, their status is shown Offline. When the agents start, the status is changed to online.
   Upgrade	Shuts down the selected agents and applies the upgrade. While the agents shut down, their status is shown Offline. After the upgrade is applied, the agents are restarted.
   Add Tag	Allows you to apply tag to selected agents.
   Remove Tag	Removes the applied tag from the selected agents.
   Set License Type	Changes the license type for the selected agents.
   Mark as Unavailable	Makes the online agents unavailable for running jobs or being used by agent pools.
   Mark as Available	Makes the unavailable agents online for running jobs or being used by agent pools.
   Apply Configuration Template	Applies the agent configuration template to the selected agents. The configuration templates must already be set the agents. See Migrating agents to Web for more information.
   Set Configuration Template	Adds the selected agents to an agent configuration template.
   Delete	Deletes the selected agents permanently from the system.
   Install Preferred Java Package	Installs the Java package that are set as preferred in the Systems Settings. See Managing Java packages on agents in bulk for more information.
   Set Java Home to Preferred Java Package	Updates the Java home of the selected agents as configured for their preferred Java package.
   Remove Unused Java Packages	Removes Java packages for the selected agents that are neither active nor configured for the agent.