Web agent communication
For successful server and web agent communication, you must have configurations on the server and agent sides.
In most cases, the installer configures the properties that are mentioned later. This section provides the additional information that you must consider if issues arise in server and agent communication.
Server configuration
agentcomm.uri=wss://physical-host:port
. The
information is stored in the server/conf/server/installed.properties
file. The
default port is 7919. This port serves WebSocket endpoints that servers and web agents use and a
REST API that only web agents use. While setting the agentcomm.uri
property, make
sure it meets these requirements:- The URL is in this format:
wss://physical-host-or-ip:port
. Thewss
URL scheme is required and is the only supported scheme. The port must be explicit. - The URL port must not conflict with ports for the UI or JMS.
- Each server must have a unique URL. URLs that refer to
localhost
, a loopback address, or a load balancer are not recommended. - Every server in an HA cluster must be able to connect directly to this server with the URL.
- Agents and relays must be able to connect to one or more servers at the servers' URL ports. They can optionally be configured to use a common URL that all servers share, for example, one provided by a load balancer. However, servers must be configured with direct URLs.
When you use web agents, each server in a cluster has a distinct URI and each server establishes a direct connection to every other server, which results in two connections between each server. The server-to-server connections advertise connected web agents to the cluster and exchange messages for them.
When a new server is added to a Web agent-enabled cluster, it connects to the previously defined servers. The other servers respond by connecting back to the new one. In normal operation, each server has two connections to each of its peers.
Web agent configuration
When you install a web agent, you specify the agentcomm.server.uri
property. If
there is one server or if all servers share a URL, it can be configured directly, for example,
agentcomm.server.uri=wss://examplehost.org:7919
. Configure multiple servers as a
comma-separated list that is embedded in a random scheme, for example,
agentcomm.server.uri=random:(wss://examplehost1.org:7919,wss://examplehost2.org:7919)
.
Agents and relays connect to one or more servers at their respective URL ports. They can be
configured to use a common URL, for example, a load balancer. However, servers must be configured
with direct URLs. The agentcomm.proxy.uri
property can define a single HTTP proxy
URL or define a list in a random scheme. The property is optional if the agent connects directly to
servers.