Managing Agents Remotely

Once an agent is installed, you can manage many of its features from the Deployment Automation user interface. Agent properties can be also changed directly on the agent machine by editing the agent's conf/agent/installed.properties file and restarting the agent.

To manage an agent:

  1. Navigate to Management > Resources.

  2. Select the Agents tab.

    In the user interface, you can see the following information about each agent:

    • Name and description
    • Licenses assigned
    • Status, such as Offline, Connected, and Online
    • Version
    • Agent relay it is connected through, if any
  3. Click an action link for the desired agent.

    Action Description
    Edit This option enables you to edit the agent's description and impersonation settings. You can also specify an internal agent name that is resolved dynamically to a regular agent name. The server updates the agent name with the internal agent name that you specified. For more information see Dynamically Registering Agents.
    Restart This option will stop and restart the agent. While the agent is stopped, its status will be Offline.
    Upgrade This option will stop the agent and apply the upgrade. While the agent is stopped, its status will be Offline. After the upgrade is applied, the agent will be restarted. Before its status is Online, it might briefly be Connected.
    Test This option will perform an agent settings and connection test. Test results are displayed in the Connection Test dialog.
    Inactivate This option will deactivate the agent. Agents that are deactivated cannot perform deployments. To reactivate the agent, check the Show Inactive Agents check box on the Agents pane, then click Activate for the agent.
    Delete Removes the agent.