In silent mode, you specify the installation properties in a text file and then run the
agent relay installation without command-line prompts.
- 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
and ulimit -v
commands and ensure that both return the
value unlimited
. To find out how to remove the limit on the maximum memory size and
virtual memory size, see the documentation for the operating system.
To install the agent relay in silent mode, you specify the installation properties in a
properties file. The example.agentrelay.install.properties file is
provided as an example of a properties file. The
example.agentrelay.install.properties file is in the agent relay
installation file.
-
Download and extract the agent relay installer to the computer on which you want to
install the agent relay:
- To download the installer from the server, click Help
, located in the upper-right corner of the page, and then click
Tools. Then, click IBM UrbanCode Deploy Agent Relay and download and extract the file.
- To find the installer on the server with the command line, go to the following
location and copy the file to the target system:
installation_folder/opt/tomcat/webapps/ROOT/tools/agent-relay.zip
-
Expand the compressed installation file.
-
Open the example.agentrelay.install.properties file for editing,
or copy the example.agentrelay.install.properties file to a new
properties file.
-
Customize the installation by specifying the properties in the agent relay installation properties file.
If you do not specify a property, the default value is used. These properties are
copied to the agentrelay.properties file of the completed
installation.
-
Save the file.
-
Run the installation file with the install-silent.cmd command on Windows™ or the
./install-silent.sh command on Linux. Provide the properties file as a command-line argument.
For example, on Windows, if the properties
file is named
installrelay.properties, type the following
command:
install-silent.cmd installrelay.properties
On Linux, if the properties file is named
installrelay.properties, type the following
command:
./install-silent.sh installrelay.properties
To install a FIPS-compliant agent relay, add the
-fips
parameter,
as in the following
example:
./install-silent.sh installrelay.properties -fips
-
If the relay is on Linux or UNIX and will connect to 400 or more agents, increase the
process and file limit for the server:
-
Add the following lines to the file that sets process and file limits.
For example, for Red Hat Enterprise Linux, version 7, use the
/etc/security/limits.conf file. For AIX, use the
/etc/security/limits.d/90-nproc.conf file.
relayUser soft nofile 60000
relayUser hard nofile 60000
relayUser soft nproc 65535
relayUser hard nproc 65535
Use
the name of the operating system user that is running the agent relay for
relayUser
. By default, the agent relay installation program
creates a user that is named
agentrelay
.
-
Restart the computer that hosts the agent relay.
-
To start the agent relay, go to the installation folder for the relay and run the
following command:
Any messages that are created during the installation are stored in the file
agentrelay-install.log.
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 . 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.