Silently upgrading Windows agents
You can upgrade the RSCD agent silently. To silently upgrade one or more RSCD agents on Windows systems, use a TrueSight Server Automation File Deploy Job to deploy the RSCD agent installation program for the version to which you want to upgrade.
The deployment copies the installation program to any target servers you specify and then silently executes the program using the existing installation settings.
To silently upgrade the RSCD agent
- Log in to the system where you want to upgrade the Agent.
- Copy the installation file (RSCD<version-platform>.msi) to a directory on the Windows system.
- Change to the directory that contains the installation file.
- At the command prompt, enter the command:
msiexec /I RSCD<version-platform>.msi /QN <PROPERTY=value> <PROPERTY=value>
where:- RSCD<version-platform>.msi is the name of the agent installer.
- /QN — Sets the user interface level to no UI. Optionally, you can use /QB to display a progress bar for the installation.
- (Optional)/L*V <logLocation> — Logs information about the installation to the file you specify.
<PROPERTY=value>— Specifies a property that overrides the default installation settings. You can specify one or more of the following properties:
Configure the following properties to use the Smart Agent capabilities.
PropertyDescriptionSMARTHUB_HOSTNAMESpecify the host name of the system where the Smart Hub is installed. For example, "smarthubprod1.bmc.com"SMARTHUB_PORTSpecify the listener port of the Smart Hub. The default port is 443.ENROLL_INTERVAL_MINSpecify the interval for enrolling the agent. The default interval is 15 minutes. The interval range can be 1 - 360 minutes.ENROLL_ASShows the predefined identifier that is used for enrolling the server. Specify one of the following identifiers to be used for the enrollment:- "<HOSTNAME>": Indicates the server host name. This is the default identifier.
- "<SMARTHUB_PEER_IP>": Indicates the IP address of the server.
- "<SMARTHUB_PEER_FQDN>": Indicates the fully qualified domain name of the Smart Hub IP address.
- NEW IN 20.02.01 <UUID>: Indicates the UUID value that is generated for the server.
Note: Use this identifier for enrolling servers in the public cloud, such as AWS.
- <UPPER>: Changes to upper case characters.
- <LOWER>: Changes to lower case characters.
Note: If both the operators are provided, <UPPER> will have precedence over <LOWER>.IdentifierSample enrolled value<HOST_NAME>oracle_prod2<SMARTHUB_PEER_FQDN>oracle_prod2.bmc.com<HOSTNAME><UPPER>ORACLE_PROD2<HOSTNAME>.dev.bmc.com<UPPER>ORACLE_PROD2.DEV.BMC.COM<UPPER><SMARTHUB_PEER_FQDN>ORACLE_PROD2.BMC.COMRHEL-db-prod1.prod.bmc.com<UPPER>RHEL-DB-PROD1.PROD.BMC.COM<LOWER>RHEL-db-prod1.prod.bmc.comrhel-db-prod1.prod.bmc.com<UPPER>Error msg : Unable to set enroll_as value from : <UPPER><UPPER><HOSTNAME><LOWER>ORACLE_PROD2HEARTBEAT_INTERVAL_MINSpecify the interval at which the Smart Agent sends heartbeats to the Smart Hub for status updates. The default interval is five minutes. The interval range can be 1 - 360 minutes.SMARTAGENT_SERVICEIndicates whether the Smart Agent service is enabled. When the service is enabled, the Smart Agent is started automatically after installation.- For new installation, the default value is set to 1, which indicates that the Smart Agent service is enabled.
- For upgrade, the default value is set to 0, which indicates that the Smart Agent service is disabled. The Agent is not started automatically after the upgrade.
ACCESS_KEYSpecify the access key that is generated after registering the Smart Hub in the Application Server. For more information, see Configuring-the-Smart-Hub-and-Smart-Hub-Gateway.SERVER_PROP_STR DEPRECATED IN 21.02Comma-separated list of server properties of type String. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
Note: For 21.02.01 and earlier versions, enter the property names and their value in upper case characters only.SERVER_PROP_INT DEPRECATED IN 21.02Comma-separated list of server properties of type Integer. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
Note: For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.SERVER_PROP_BOOL DEPRECATED IN 21.02Comma-separated list of server properties of type Boolean. This property is deprecated in version 21.02. Use the SERVER_PROP_LIST property instead.
Note: For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.SERVER_PROP_LISTNEW IN 21.02
The list of server properties that you want to configure. For 21.02.01 and earlier versions, enter the property names and their values in upper case characters only.
Note: The SERVER_PROP_LIST parameter supports custom server properties in addition to predefined ones. By including them in the SERVER_PROP_LIST variable, you can define and assign custom properties during agent installation. These properties will be registered with the agent and can be used for automation, reporting, and policy enforcement.
For example: SERVER_PROP_LIST="CUSTOM:Location=DC1,CUSTOM:Environment=Prod"WM_INTERVAL_SEC NEW IN 20.02.01Specify the interval (in seconds) at which the Smart Hub is polled for work requests. The default is 300 seconds.TUNNEL_ENABLE NEW IN 20.02.01A Boolean value that indicates whether the tunnel feature is enabled. By default, it is disabled.TUNNEL_IDLE_TIMEOUT_MIN NEW IN 20.02.01The idle connection timeout in minutes. The default is 720 minutes.CLOUD_ACCOUNTSpecify the cloud account to which the server belongs.CLOUD_REGIONSpecify the cloud region where the server is located.CLOUD_RESOURCE_NAMESpecify the cloud resource name for the server.CLOUD_RESOURCE_IDSpecify the cloud resource identifier for the server.CLOUD_VPCSpecify the cloud VPC where the cloud is located.AUTO_USP_ENABLED NEW IN 21.02A Boolean value (true or false) that indicates whether the Auto USP feature is enabled. By default, it is enabled. If you want to disable this feature, add this property and specify its value as false.AUTO_USP_INTERVAL_H NEW IN 21.02The interval (in hours) at which the server properties are validated to detect a change. The default interval is two hours.CONFIG_POLICY_ENABLEDNEW IN 21.02A Boolean value (true or false) that indicates whether the Configuration Policy feature is enabled. By default, it is enabled. If you want to disable this feature, add this property and specify its value as false.
To silently upgrade RSCD agents using the File Deploy job
- Copy the RSCD installation program (RSCD<version>-<platform>.msi) to the server on which you plan to create the File Deploy Job. Put the file in the <WINDIR>\Temp directory, where <WINDIR> is typically C:\winnt or C:\Windows.
- In the TrueSight Server Automation Console, select the installation file for the version of the agent to which you want to upgrade. Then right-click, and choose Deploy Files from the pop-up menu:
RSCD<version>-<platform>.msi
The File Deploy Job wizard opens. - For Name, assign a name to this File Deploy Job. For Save in, specify the job group where you want to store this job.
- For Destination, enter /c/tmp or a directory with no spaces in its path, and then click Next.
- Select the servers being upgraded, and then click Next two times to display the Advanced Options panel.
- For Post-command, enter the following command:
msiexec /I "C:\tmp\RSCD<version>-<platform>.msi" /qn REBOOT=ReallySuppress
If necessary, replace C:\tmp with the destination directory that you used for the installer. - Click Finish.
The file is deployed to the target servers and the installation runs silently on each machine.
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*