You can configure agents for failover. You specify the location of a backup server or
agent relay to use if the primary server or agent relay fails.
About this task
If you did not configure the agent for failover when you
installed the agent, you can also configure it for failover by modifying
its properties.
Procedure
- Open the /agent-install/conf/agent/installed.properties
file.
- Append more server or agent relay locations to the
locked/agent.brokerUrl=failover\: parameter. The agent configuration syntax is
IP_or_hostname\:JMS_port. Separate each agent relay
and server with a comma. An example parameter that specifies one a primary agent relay and a backup agent
relay might resemble the following code:
locked/agent.brokerUrl=failover\:(ah3\://primary-relay-server.example.com\:7916,ah3\://backup-relay-server.example.com\:7916).
- Append the host names or IP addresses of the agent relays and servers to the
agent.jms.remote.host property, separated by commas.
- Append the agent communication port numbers of the agent relays and servers to the
agent.jms.remote.port property. For example, if the agent.jms.remote.host property listed two
servers and both servers use port 7916 for agent communication, the
agent.jms.remote.port looks like
this:
agent.jms.remote.port=7916,7916
Each agent relay and server
that is listed in the agent.jms.remote.host must have a corresponding
port in the agent.jms.remote.port property, even if the port numbers
are the same as other agent relays or servers.