Installing the Avaloq Agent

This topic guides you through the installation of the Avaloq Agent in an AE system without using authentication. If you want to use one of the methods that are available for authenticating the Agent, you must follow additional installation steps. For more information, see Agent Authentication in the Automic Automation documentation.

It is best to install the Agent in a separate directory (such as C:\AUTOMIC\AGENTS\Avaloq or Automic/Agent/Avaloq).

Connecting to the Automation Engine

The Automation Engine and the Agent communicate using TLS/SSL, which requires using trusted certificates to prove the identity of the respective communication partner. Make sure you are familiar with the TLS/SSL and certificate implementation before installing the Agent. For more information, see TLS/SSL Considerations for Automic Automation in the Automic Automation documentation.

When the Agent communicates with an on-premises Automic Automation environment, the Agent establishes a connection with the Java communication process (JCP).

When you use certificates signed by a CA, the certificates are stored in the respective Java trust store by default. In this case, you only have to check that the root certificates already are in the respective store. If you do not want to use the default locations for the Agent, make sure you use the trustedCertFolder=, agentSecurityFolder=, and keyPassword= parameters (if applicable) in the respective configuration (INI) file to define the path to the folder where the trusted certificates are stored.

When the Agent communicates with the Automic Automation Kubernetes Edition, it establishes a connection to an ingress / HTTPS load balancer. Make sure that the address of the load balancer is defined on both sides: the Automation Engine and the Agent and that your HTTPS load balancer has the required certificates in place. For more information, see Connecting to AWI, the JCP and REST Processes Using an Ingress in the Automic Automation documentation.

Java Runtime Environment (JRE)

On the admin and/or user computer where the Agent is installed, install the Java Runtime Environment (JRE). For a list of compatible Java versions, see compatibility matrix.

If you have JRE installed, you can ignore this step.

Use the following command to check the version of the current Java virtual machine (VM):

java -version

If several JRE or Java SDK Versions are installed on the computer, make sure that the order of the directories is correct in the %PATH% or $PATH settings, since the first JRE that is found in the list of directories is used.

You can download the required JRE from https://www.oracle.com/java/technologies/.

Installing the Avaloq Agent

The installation of the Avaloq Agent is the same for Windows and for UNIX platforms.

1. If you have not already done so, install the Java Runtime Environment (JRE).

2. Download the Integration.Avaloq_Agent_<version>+build.<build number>.zipinstallation package from https://marketplace.automic.com/.

3. Unzip Integration.Avaloq_Agent_<version>+build.<build number>.zip to the location where you want to install the Agent, for example to an Avaloq folder.

   The installation package has an Agents\Avaloq\bin directory with the following content:

   • ecc-ae-sheet-ig-avaloq.jar

     Contains the AWI panels.

   • uc.msl

     Message library

   • ucxjcitx.unix.ini

     Agent configuration file for UNIX

   • ucxjcitx.win.ini

     Agent configuration file for Windows

   • ucxjavaloq.jar

   Note:

   The content of the two INI files is identical except for the slashes (for Windows) and backslashes (for UNIX).

4. On the host, install the JDBC driver.

   A suitable JDBC driver must be installed for all databases that the Agent uses. Refer to the particular vendor's installation guide.

   1. Create the JDBC folder in the BIN folder of the Avaloq Agent.

   2. Copy the JDBC driver files to the JDBC folder after successfully installing it.

   Oracle

   1. Install the JDBC driver from the Oracle site.

   2. Copy the relevant .jar (ojdbc8.jar or ojdbc10.jar) file to the JDBC directory of the Agent after you have installed the driver.

   3. The Agent searches the relevant .jar file classes in the JDBC folder. The file name is irrelevant. It is important to use the most current .jar file. You might want to store only one jar file in the JDBC folder.

5. Rename the supplied INI file by removing the OS-specific string:

   • If you are installing the Agent on a Windows platform, rename ucxjcitx.win.ini to ucxjcitx.ini.

   • If you are installing the Agent on a UNIX platform, rename ucxjcitx.unix.ini to ucxjcitx.ini.

6. Adjust the INI file to your environment.

   • If you use certificates signed by a CA, the certificates are stored in the respective Java or OS store by default. In this case, you only have to check that the root certificates are already in the respective store.

     If you do not want to use the default location for this component, make sure you use the trustedCertFolder=, agentSecurityFolder=, and keyPassword= parameters (if applicable) in the respective configuration (INI) file to define the path to the folder where the trusted certificates are stored.

     For more information, see Securing Connections to the AE (TLS/SSL) in the Automic Automation documentation.

   • name

     Name of the Agent object.

     Maximum length: 32 characters

     Allowed characters: "A-Z", "0-9", "_", ".", "$", "@", "-" and "#".

     Hyphens ("-") are only allowed in Agent names. They must not be used in the names of any other objects.

   • system

     Automation Engine system name. This entry must be identical to the entry in the .ini file of the Automation Engine server.

   • ra

     Used for additional trace. Before starting a newly installed or upgraded Agent, it is a good idea to turn Rapid Automation trace on by adding ra=99. This will give more troubleshooting information if something goes wrong during the installation. After a successful Agent start, you can set ra=0, and restart the Agent to turn Rapid Automation trace off.

   • connection

     Address of the communication process in the Automation Engine system to which the Agent should connect itself. The format is:

     <DNS name or TCP/IP address>:<port number>

   For more in formation, see Agent RA Core.

7. To install and start the Agent, run the following command on the location where you have stored the Agent installation files:

   <path to java> -jar ucxjavaloq.jar

   Tip:

   If Java is installed in a folder whose name contains spaces, the path to java must be in quotes, for example:

   "C:\Program Files (x86)\Java\jreX\bin\java" -jar -Xrs -Xmx1G ucxjavaloq.jar

   The Agent is now available and up and running. To check it, do the following:

   1. Open the Automic Web Interface (Automic Automation's web interface) and log in to Client 0.

   2. Go to the Administration perspective > Agents & Agent Groups > Agents page.

   For example (click to expand):

   

   Note:

   If you are installing the Agent for the first time, this command installs and starts it. If you have already installed it before and run this command, it will simply start it.

8. Newly installed Agents are not assigned to a Client automatically and are available on Client 0 only. You must assigned the Agent to the corresponding Client(s). For more information, see Assigning Clients to Agents in the Automic Automation documentation.

Next Steps

The Avaloq Agent is installed now and an Agent object template is available in Client 0. You can use this template to create additional Avaloq Agent objects.

To enable the communication between the Avaloq system and the Automation Engine, you must create Connection objects.

Once this is done, it is possible to start creating Avaloq Jobs.

See also:

• Implementation Overview for the Avaloq Agent
• Defining the Avaloq Agent

• Establishing the Connection to Avaloq