Detecting Agent Relays

If you upgrade a server configuration where the agent relays communicate with the server through network relays, the server cannot automatically detect the agent relay, and you will need to tell the server where to find it.

After upgrading an agent relay:

  • If the agent relay name appears as an automatically-generated name with an ID string appended to it and no status information appears, you must use the Detect Agent Relay option for that agent relay.
  • If the agent relay name appears as the correct name of the agent relay and you can see the status information, you must not use the Detect Agent Relay option.

    Note: If you take the server offline and upgrade all agent relays before bringing the server back online, you may not need to use the Detect Agent Relay option. This should be used only if necessary.

To detect an agent relay:

  1. Upgrade your agent relays. See Upgrade agent relays.

  2. Navigate to Management > Resources > Relays.

  3. If the agent relay name does not appear as the correct name and the Status field is blank, click Detect Agent Relay.

  4. Enter the requested information as follows:

    Option Description

    Host

    Remote hostname or IP address the server will use to connect to the relay

    JMS Port

    Remote port used to communicate over JMS protocol

    Timeout

    How long the search should continue before timing out, in seconds
  5. Click Save. In the Relays list, the agent relay should now appear with its given name.

  6. If the agent relay shows a status of Offline, in the Actions column, click Activate to activate it on this server.

The correct name, status, and other important information should now appear for the detected agent relay.

Related Topics

Server and Agent Communication Configuration

Agent Relay Installation

Upgrade agent relays