Installing Universal Agent
Overview
These pages provide information and instructions for the installation of Universal Agent, which differ for each supported operating system.
Note
If you are upgrading from a previous version of the Agent - for example, from Agent 6.2.0.1 to 7.6.0.0 - see Upgrading Universal Agent for instructions.
If you are applying maintenance to the Agent - for example, applying maintenance to Agent 7.6.0.0 to increase its maintenance level to Agent 7.6.0.1 - see Applying Maintenance to Universal Agent for instructions.
The following table identifies the different operating systems on which an Agent can be installed, and the Agent packages that can be installed on each system.
Operating System | Universal Agent | Universal Enterprise Controller | UEC Client Applications | Universal Agent for SOA |
|---|---|---|---|---|
z/OS 1 |
|
|
| |
z/OS USS |
|
|
| |
Windows | ||||
UNIX - AIX |
|
|
| |
UNIX - HP-UX |
|
|
| |
UNIX - Solaris |
|
|
| |
UNIX - Linux |
|
| ||
IBM i 2 |
|
|
|
1 Universal Agent for z/OS contains Universal Enterprise Controller.
2 Workload Automation 5.1.1 is installed on IBM i.
For each Universal Agent installation package, the following information is provided:
Installation package components
Product compatibility
Installation requirements
Installation upgrades
System upgrades
Distribution files
Installation procedures
Product customization
Configuration
Licensing
File inventory lists
Note
You can install Agents before, during, or after installation of Universal Controller.
Platform-specific installation requirements, including system requirements, are located on the Installation Requirements page specific to that platform:
Requirements relevant to all platforms are shown below.
Since platform requirements may change with new releases of a product, please consult the Platform Support page to make sure that your platform is supported before performing an installation.
Space requirements for Universal Agent are driven largely by logging. A minimum 500MB of space is recommended. Each Agent contains a Universal Broker log and an Agent log.
The Universal Broker LOG_FILE_GENERATIONS configuration option lets you specify how many log files to save in the Universal Broker log directory. The default is 5.
The Agent log rolls over at midnight (12:00 a.m.) or whenever the Agent is restarted. The Log File Retention Period in Days Universal Controller system property lets you specify the number of days that an Agent log file (in addition to a Controller log file) is retained before it is purged. The default is 5 days.
Agent components run on z/OS, Windows, UNIX, and IBM i operating systems. These systems must be connected with a network that supports TCP/IP. For example, the Universal Command Manager running on a z/OS system must be able to establish a TCP/IP socket connection with the Universal Command Server running on a UNIX or Windows system.
TCP/IP provides a set of commands to verify network connectivity between systems. For example, the ping command can determine if an IP connection is possible between two systems. However, the ping command may not work in all network environments. In addition, the ping command may work, but a firewall may deny all other connection attempts between the two systems. Check with your local network administrator to determine the capabilities and topology of your network.
Universal Agent offers configuration parameters that can facilitate connections through network firewalls. Due to the large variety of firewall configurations, all possibilities cannot be discussed in this document. Check with your local network administrator to determine if a firewall is between the computer systems involved.
In order to install any of these Agent components, you must be able to write to the directory from which the installation is launched.
Universal Agent is composed of several components that utilize the TCP/IP network for component communications. TCP/IP routes must be available between the distributed components and firewall rules open, if necessary.
The primary components using TCP/IP are Universal Broker, Universal Managers, and Universal Automation Center Agent (UAG).
Universal Broker | Executes on all servers on which workload management services are required. The Universal Broker accepts TCP socket connections on port 7887 from remote clients such as Universal Command Manager and Universal Data Mover Manager. A server running Universal Agent will need to be able to accept TCP connections on port 7887 in order to provide such services. |
|---|---|
Universal Manager | Components include Universal Command Manager, Universal Data Mover Manager, and others. Manager components initiate TCP socket connections to remote Universal Brokers. If Universal Manager services are required, the Managers will need to be able to open TCP connections to remote Universal Brokers on port 7887. |
UAG | Initiates a TCP socket connection to the Universal Message Service (OMS) deployed on a remote, centrally located server. OMS accepts TCP connections on port 7878. UAG must be able to open a TCP connection to the remote OMS server on port 7878. |