The following guide describes how to install an agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. More detailed information is provided in the document Advanced Security.
Automic strongly recommends installing the agent in a separate directory (such as UC4/Agent/rapidautomation or C:\AUTOMIC\Agent\rapidautomation).
The files that belong to the RA agent are stored in the directory IMAGE:AGENTS\RAPIDAUTOMATION.
File name |
Description |
---|---|
SETUP.EXE | The Windows installation executable for the RA agent core |
uc.msl | Message library |
ucxjcitx.jar |
Agent for Rapid Automation |
ucxjcitx.ini |
Configuration file |
*.jar | Libraries |
![]() |
1. | Installing Java Standard Edition |
---|
This installation step can be omitted if the required version of Java Standard Edition is already available.
java -version
Note that the order of the indicated directories is relevant when specifying %PATH% or $PATH if several versionsAn application version holds zero or more deployment packages and may have dependencies to zero or more application versions of the same (or to different) applications of JRE or Java SDK are installed on your computer. The Java Runtime Environment listed first is used.
![]() |
2. | Setting up the Agent |
---|
![]() |
3. | Loading the RA Solution |
---|
![]() |
4. | Creating Connection objects |
---|
![]() |
5. | Starting the Agent |
---|
The agent can also be started via the ServiceManager.
Note that the storage limit should be set to at least 256MB (or 512MB) for starting Java agents (Databases, RA, JMX, SAP). You can specify a value for the storage limitation of Java applications by using the start parameter -XmX. Specifying a value that is too low can cause the agent to crash. The default value depends on the Java version that is used.
The Java parameter -Xrs ensures that the agent ends properly when a normal end is initiated. Automic recommends using this parameter. More detailed information is provided in the Java documentation.
![]() |
6. | Important notes for creating jobs |
---|
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |