On this page: Related pages:
On this page:
The Universal Agent can retrieve the runtime agent installation software from the Controller repository or from a local repository. This topic describes how to create each type of repository.
Using a Controller Repository
This type of Universal Agent Repository is not available for SaaS Controllers. Use a local repository instead.
Using the Controller as the repository location gives the Universal Agents in your environment a single, central point for accessing the runtime agents. To use the Controller repository, you need to be able to access the Controller installation directory.
- Create a subdirectory named
agent_binariesin the Controller home directory.
- Download the runtime agent distribution ZIP files to the Controller home subdirectory
agent_binariesfrom the download site.
Rename the downloaded agents to the format expected by the Universal Agent. Use the following naming conventions where <version> is the agent version number:
java-<version>.zipfor non-IBM versions of the Java agent
java-<version>-ibm.zipfor IBM versions of the Java agent
For example, java-22.214.171.124.zip or java-126.96.36.199-ibm.zip
Your directory should look similar to the following:
Specify the repository location to the Universal Agent, as described in Configure the Repository Location.
Using a Local Repository
If putting the repository in the Controller directory structure is not feasible for any reason, you can serve the agent distribution files from a local repository. The likely location for the repository in this case would be a shared network directory. The directory would need to be mounted by the machines running the Universal Agent.
The Universal Agent depends upon a defined directory structure within the repository directory and conventionally named runtime agent distribution files, as described in the following steps.
To create your own local Universal Agent repository:
repositorydirectory with the structure shown in the following example:
Your local directory should similarly have a directory named
monitorthat contains subdirectories for the runtime agent types,
machineand version, as illustrated by the example.
- Download the agent files to the appropriate location in the directory based on the agent type and version.
- Rename the downloaded agents to the format expected by the Universal Agent. For example, rename
- Specify the repository location to the Universal Agent, as described in Configure the Repository Location.
Agent Naming Format
The Universal Agent requires the runtime agent ZIP archive in the repository to have a specific name format. When placing runtime agent files in the repository, ensure that they are named as shown in the following table:
|File Name Format Required for UA Repository||Examples||Description|
|java-<version>.zip||java-188.8.131.52.zip||Java App Server Agent|
|machine-<version>-<bitness>bit-<os>.zip||machine-184.108.40.206-64bit-linux.zip||Machine Agent for 64-bit Linux|
|machine-220.127.116.11-32bit-linux.zip||Machine Agent for 32-bit Linux|
|machine-18.104.22.168-64bit-windows.zip||Machine Agent for 64-bit Windows|
|machine-22.214.171.124-32bit-windows.zip||Machine Agent for 32-bit Windows|
|universalagent-126.96.36.199-64bit-windows.zip||Universal Agent for 64-bit Windows|
|universalagent-188.8.131.52-64bit-linux.zip||Universal Agent for 64-bit Linux|
|universalagent-184.108.40.206-32bit-linux.zip||Universal Agent for 32-bit Linux|
Notice that the Universal Agent includes the bit number of the target operating system, since it bundles the JRE.
Configure the Repository Location
The repository types and locations are defined in the Universal Agent configuration,
To configure a local repository, use the
file:// protocol prefix for the location. For example, if the local repository is in the
/Users/appduser/repository directory, configure the repository location as follows:
Notice the extra slash "/" after
You can specify more than one repository location, in which case the Universal Agent will use the first agent file that matches a rule that it finds in the sequentially checked repositories.
To use a combination of a local and Controller repository, include both, as follows:
The Universal Agent first checks the local repository and then the Controller for the runtime agent downloads.