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.
Configure the Repository Location
The repository types and locations are defined in the Universal Agent configuration file,
universalagent.yaml, using the
repositories keyword. You can specify a list of repository URLs (in order of preference) for retrieving AppDynamics monitor (agent) binaries and Universal Agent updates. The format is as follows:
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 that there are three slashes after
file:. The first two slashes indicate the file protocol, and the third slash refers to the root directory of the file system. All slashes should be forward slashes, even on Windows machines.
To configure a local repository on an HTTP server. Define the URL in any of the formats below:
You can also use basic authentication for an HTTP repository in the form:
You can specify more than one repository location, in which case the Universal Agent uses 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.
Using a Controller Repository
This type of Universal Agent Repository is not available for SaaS Controllers. Use a local repository instead.
Downloading the .NET Agent from a Controller repository is not supported. Place the .NET Agent distribution file in a local repository.
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 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
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, 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, including
machineand their respective versions, 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
java-<version>.zip. See Agent Naming Format.
- Specify the repository location to the Universal Agent, as described in Configure the Repository Location.
Agent Naming Format
The Universal Agent requires the downloaded runtime agent ZIP file in the repository to have a specific name format. When placing runtime agent files in the repository, ensure that they are named using the following format:
|Java App Server Agent|
|Machine Agent for 64-bit Windows|
|Machine Agent for 32-bit Windows|
|Machine Agent for 64-bit Linux|
|Machine Agent for 32-bit Linux|
|Universal Agent for 64-bit Windows|
|Universal Agent for 32-bit Windows|
|Universal Agent for 64-bit Linux|
|Universal Agent for 32-bit Windows|
|Bundled Analytics Agent|
|Windows .NET Agent|
Notice that the Universal Agent and the Machine Agent include the bit number of the target operating system because the downloads bundle the JRE.