Page tree
Skip to end of metadata
Go to start of metadata

This topic describes how to create an agent bundle for use with the Unified Agent Installer.

This topic contains the following sections:

About agent bundles

An agent bundle maps target platform types to their corresponding agent installers. Optionally, an agent bundle can also specify the contents of the following agent configuration files: exports, users.local, and secure (optionally different settings for each platform).

For example, suppose you want to install agents on Microsoft Windows 32-bit servers. Following the instructions in Adding agent installer packages to the Depot, you would create a depot software object for the Windows 32-bit agent installer package, and this object would be based on the installer file RSCD86-WIN32.msi. When you create an agent bundle, you include a line that says: for each Windows 32-bit target system, use the RSCD86-WIN32.msi package to install an agent.

You may need to create only one agent bundle to specify the installers and settings for all your platforms. However, there are some situations where you need to create more than one bundle:

  • You need agent bundles with different permissions for each bundle.
  • You need to have different agent configuration file contents for the same platform.

When you create an agent bundle, it is stored in the file server.

Before you begin

Required authorizations

To create and use agent bundles, your role must be granted the following authorizations:

  • DepotFolder.Read on the folder where the agent bundle is stored
  • DepotFolder.Write on the folder where the agent bundle is stored
  • DepotFolder.Read on the folders where agent installers are stored
  • WindowsSoftware.Read, AIXSoftware.Read, LinuxSoftware.Read, or SolarisSoftware.Read, to access the appropriate agent installer
  • AgentBundle.Read
  • AgentBundle.Create

Familiarity with exports, users.local, and secure files (optional)

When you create an agent bundle, you do not have to specify the contents of the exports, users.local, and secure files. If you omit these settings, the system uses the defaults from the agent installer package.

However, if you want to specify these configuration settings in the agent bundle, familiarize yourself with the various options and syntax for these files. See Setting up configuration files. Use care when defining non-default configurations. The installation process does not validate configuration settings. An incorrect setting can prevent an agent from starting or block users from accessing the agent.

To create an agent bundle

  1. Open the Depot folder. Select a sub-folder, right-click and select New > Agent Bundle. The New Agent Bundle wizard opens.
  2. Define the agent bundle, as described in the following sections:
  3. Click Finish after completing the last step of the wizard.