Web agent relay configuration

Starting with V7.0.4.0, relays can be configured to support web agents exclusively.

In this mode, no JMS connection between relay and server is required and JMS agents will not be able to connect. You must upgrade relays for agents with web communication enabled and associate with the relay from the UI. However, a successful agent communication does not require any configuration. The following web communication parameters are defined in the relayInstallDir/conf/agentrelay.properties file:
agentcomm.enabled=true
agentcomm.server.uri=random:(wss://ucd1.example.org:7919,wss://ucd2.example.org:7919)

Agent relay limits

The maximum number of agents that can be assigned to a relay is limited in each of the releases. See to the following table to check the number of agents that are allowed for a relay for your installedIBM® UrbanCode® Deploy version.
Version Relay mode Agent type Limit with default proxy Limit with legacy proxy
7.0.4.0 or before JMS mode Web Agents 1K N/A
JMS Agents 1K N/A
Total 1K N/A
7.0.4.0 to 7.0.5.0 Web mode Web Agents 1K N/A
JMS Agents 0 N/A
Total 1K N/A
JMS mode Web Agents 1K N/A
JMS Agents 1K N/A
Total 1K N/A
7.0.5.0 or later Web Mode Web Agents 10K 1K
JMS Agents 0 0
Total 10K 1K
JMS Mode Web Agents 10K 1K
JMS Agents 1K 1K
Total 10K 1K

In Linux, use the following utilities to reach the design limit of 10K concurrent agents:

  • sysctl:
    fs.file-max >= 40000
  • ulimit:
    nofile >= 40000
  • sysctl:
    net.ipv4.ip_local_port_range >= "10000 65000"