Agent Installer Job - Options

The Options panel indicates the agent bundle on which the Agent Installer Job is based and various other settings. This topic contains the following sections:

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

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
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

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.
New in 8.9.02Install Microsoft Visual C++ Redistributable (Windows Only)	Specifies whether to install Microsoft Visual C++ 2015 Redistributable Update 3 on the target server before agent installation. By default, this option is selected. From TrueSight Server Automation 8.9.02 and later, Microsoft Visual C++ 2015 Redistributable Update 3 must be installed for all Microsoft Windows RSCD agent versions. Note: As a prerequisite to install Microsoft Visual C++ 2015 Redistributable Update 3 on Windows 2012 R2, you must have the following patches installed on your server: KB2919442 (Required for 2919355) KB2919355. This patch requires several other patches: clearcompressionflag.exe, KB2919355, KB2932046, KB2959977, KB2937592, KB2938439, and KB2934018. This are all available on the download page for KB2919355. For more information about the prerequisites for Microsoft Visual C++ 2015 Redistributable Update 3, refer to the Microsoft documentation here.

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.

New in 8.9.02Install Microsoft Visual C++ Redistributable (Windows Only)

Specifies whether to install Microsoft Visual C++ 2015 Redistributable Update 3 on the target server before agent installation. By default, this option is selected.

From TrueSight Server Automation 8.9.02 and later, Microsoft Visual C++ 2015 Redistributable Update 3 must be installed for all Microsoft Windows RSCD agent versions.

Note:

As a prerequisite to install Microsoft Visual C++ 2015 Redistributable Update 3 on Windows 2012 R2, you must have the following patches installed on your server:

KB2919442 (Required for 2919355)
KB2919355. This patch requires several other patches: clearcompressionflag.exe, KB2919355, KB2932046, KB2959977, KB2937592, KB2938439, and KB2934018. This are all available on the download page for KB2919355.

For more information about the prerequisites for Microsoft Visual C++ 2015 Redistributable Update 3, refer to the Microsoft documentation here.

Where to go from here

Agent-Installer-Job-Targets