Installing agent relays in interactive mode
Installing an agent relay from the command line involves running a batch file or shell script and specifying information about the agent relay.
- Ensure that the computer on which you are installing the agent relay has a supported
version of the Java™ Runtime Environment (JRE) or Java Development Kit (JDK).
For more information, see System Requirements for IBM® UrbanCode™ Deploy.
Important: Beginning in version 7.0.2, the IBM UrbanCode Deploy server and agent relays require a Java Runtime Environment (JRE) or Java Development Kit (JDK) version 11. -
If the target computer has an IBM JRE or Java developer kit, update to a supported version of the IBM JRE or Java developer kit.
- Set the PATH variable to contain the location of the JRE or JDK that you are using.
- Ensure that the firewall on the computer allows connection to the IBM UrbanCode Deploy server through HTTP/HTTPS.
- Install the IBM UrbanCode Deploy server.
- Ensure that you have an authentication token for the relay. If you intend to use the
component version replication option, the token must be assigned to a user with the server
configuration permission
Read Artifact Set List
. For information about tokens, see Setting server configuration security. - Set up an account on the computer for the agent relay to use.
- Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
- Ensure that there is no limit on the maximum memory size and virtual memory size.
For example, on most Linux™ systems, you can run the
ulimit -m
andulimit -v
commands and ensure that both return the valueunlimited
. To find out how to remove the limit on the maximum memory size and virtual memory size, see the documentation for the operating system.
If you must modify the relay, you can edit these properties in the
agentrelay.properties
file in the
relay_installation\conf directory.
Now you can install agents and connect them to the relay. See Installing agents.
To monitor the status of the relay and the agents that are connected to
it, click
For more information about an agent relay, in the Name column, click the relay.
. This tab shows the number of active and offline agents that are connected to
each relay, as shown in the following figure:For more information about an agent relay, in the Name column, click the relay.