Agent Installer Job - Options

The Options panel indicates the agent bundle on which the Agent Installer Job is based and various other settings.

Agent Bundle

Displays the agent bundle on which this job is based. To base this job on a different agent bundle, use this option to navigate to the bundle.

Operation Type (8.3.03 or later)

Choose the type of operation that this job will perform. You can choose the operation type only during job creation. After the job is created, this field is disabled.

Install - Installs agent on servers with no existing agent
Warning
Note
For the install option, SOCKS proxy and Advanced Repeaters are not supported. For more information, see Running the Unified Agent Installer.
Upgrade - Upgrades agent only on servers with an installed and available agent
Install/Upgrade - Installs or upgrades the agent based on current state

Agent Install Options

If an agent is successfully installed, the actions you select are performed.

Field	Description
Update Server Properties	Update the system with properties from the target servers on which you are installing agents.
Update Configuration Objects Registration	Register any configuration objects that are found on the agent and defined in the Configuration Object Dictionary.
Push Agent ACLs	Push agent access control lists (ACLs) to the servers that this job targets. To push ACLs, the system converts the access control list defined for a server into a users configuration file and pushes that file to the agent. The access control list is derived from user permissions defined in the RBAC system.

Agent Upgrade Options (8.3.03 or later)

Field	Description
Push Agent ACLs	Push agent access control lists (ACLs) to the servers that this job targets. To push ACLs, the system converts the access control list defined for a server into a users configuration file and pushes that file to the agent. The access control list is derived from user permissions defined in the RBAC system.
Skip Upgrade	If this option is selected, upgrade operation will not be executed if there is any other job in progress, due to which agent is already in use.
Force Upgrade	If this option is selected, it will go ahead with agent upgrade, which will kill the job in progress, giving precedence to the upgrade operation.

Job Options

Field	Description
Preserve Staging Area On Failure	Specifies whether information copied to a staging area on a target server during installation should be preserved if the installation or upgrade fails. By default, this option is not selected, so that when the system has finished installing or upgrading an agent, it automatically deletes all files in the staging area.