Unsupported content


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Upgrading the RSCD Agent using an Agent Installer Job

As of BMC Server Automation version 8.5.01 (that is, after applying Service Pack 1), you can upgrade an enrolled RSCD agent by using the BMC Server Automation built-in Unified Agent Installer Job. This single-phase operation comprises all the checks, staging, and commits in one job, in-line with the existing Agent installation job. The upgrade can be performed on the Solaris, Linux, Microsoft Windows, and AIX platforms.

You can perform the upgrade by using the Unified Agent Installer Job or using CLI.

This topic includes the following sections:

Limitations when using an Agent Installer Job

For upgrades, Agent Installer Jobs have the following limitations:

  • Can only install or upgrade agents running version 8.2 or later
  • Cannot uninstall agents
  • Upgrade for HP-UX is not supported using the Unified Agent Installer Job
  • Supports only upgrade to native installers

In general, BMC Server Automation supports shell to shell upgrades and shell to native upgrades for independent installers. However, the Unified Agent Installer Job supports only upgrades to native.

The following table outlines the options for upgrading agents using the Unified Agent Installer Job.


Existing agent currently installed using

Supported for independent agent upgrade1

Supported for upgrade using the Unified Agent Installer (Native Only)































SH/Software Depot (SD)

Not supported with the Unified Agent Installer 





1 Independent agent upgrade includes manually running the agent installer or silently upgrading (either from the command line or using the File Deploy Job approach).

Upgrading using an Agent Installer Job

  1. Open the Job folder and right-click the subfolder where you want to create the job.
  2. Select New > Agent Installer Job.
    The Agent Installer Job Wizard opens for creation of an Agent Installer Job.


    Existing agent installer jobs can only be used for installing the agent on agentless targets. To upgrade the agent, you must create new agent installer jobs and reuse the existing bundle.

  3. Enter basic job information (such as job name and description) on the General panel.
  4. Click Next to display the Options panel.
    The Options panel indicates the agent bundle on which the Agent Installer Job is based and various other settings. See the following figure.
  5. In the Agent Bundle field, navigate to the bundle on which this job is based or keep the default agent bundle.
  6. From Operation Type field, select one of the following operation types:
    • Install - Installs agent on servers with no existing agent

    • Upgrade - Upgrades the agent only on servers with an installed and available agent

    • Install/Upgrade - Installs or upgrades the agent, depending on the current state

    For the Install option and Install/Upgrade option, SOCKS proxy Repeaters are not supported. For more information, see Running the Unified Agent Installer.

    For Upgrade option and Install/Upgrade option, BMC recommends not to execute any other BMC Server Automation Jobs while the RSCD Agent on the server is being upgraded.

  7. You can choose the operation type only during job creation. After the job is created, this field is disabled.
  8. Perform the relevant configuration in the displayed Agent Options fields (depending on your Operation Type selection):
    • Install Options
      Update Server PropertiesUpdate the system with properties from the target servers on which you are installing agents.
      Update Configuration Objects RegistrationRegister any configuration objects that are found on the agent and defined in the Configuration Object Dictionary.
      Push Agent ACLsPush 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.

    • Upgrade Options

      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 UpgradeIf this option is selected, it will go ahead with agent upgrade, which will kill the job in progress, giving precedence to the upgrade operation.


    The upgrade operation is performed in two steps: copying the installer to the staging area and executing the script to run the upgrade.

    After the installer is copied to the staging area, if another job is found to be in progress (which is using the agent) and the option to skip the upgrade is selected, the upgrade operation will not be executed.

    In the case of a forced upgrade (when the skip upgrade option is not selected), the upgrade operation gets precedence, and kills the the job in progress.

    The upgrade operation can end successfully or fail with error messages or warnings. In either case, the staging directory is deleted at the end of the operation.

  9. Choose the relevant Job Option:



    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.

  10. Step through all other wizard panels, as described in Creating an Agent Installer Job.
  11. Click Finish after completing the last step of the wizard.


A custom install path is not retained during an upgrade operation using a native installer. By default, the agent is upgraded to /opt/bmc/bladelogic on a non-windows platform.


If you want to retain a custom path during an upgrade on a non-windows platform, specify the path within the installation command using one of the following methods:

  • Linux :  With RPM, append the --prefix option to the command.
    For example, rpm -ivh BladeLogic_RSCD_Agent-8_5- --prefix /usr/nsh
  • Solaris: In the response file (/var/sadm/install/admin/default), update the basedir parameter with the custom path value (basedir=default).

Server Locking

While the upgrade script is running on the target, the target will be locked. If you try to execute another job on that target, the following message is displayed:

Server is locked for maintenance activity by a BSA system process.

Server Locking is not supported for the following types of jobs:

  • Snapshot, Audit and Compliance  Jobs: If the Agent upgrade is running on any target server and, during that time, you try to execute a Snapshot, Audit or Compliance Job, these jobs will fail without a Server Locking error message. If the Compliance Job is running during remediation, then the Server Locking error message will be displayed.
  • Patch catalog: If the Agent upgrade is running on the Patch Repository server and, during that time, you try to execute a Patch Catalog job, then the job fails without a Server Locking error message.
  • Execution Task, Batch Jobs: If the Agent upgrade is running on any target server and, during that time, you try to execute an Execution Task or Batch Job, the job returns error messages depending on the child jobs that fail under it (If the child jobs support Server Locking, an error message will appear)
  • NSH Script Type2, NSH script Type4: These jobs do not provide support for Server Locking.

Agent Installer Job Results View

The Activity node under every server shows jobs that have executed on that server during a particular period of time. When you expand the run node for that job, you can see the following nodes under it, based on the results of the job:

  • Failed
  • Warning
  • Success
  • Running

Under the Success node, the following additional nodes are displayed (depending on the operation type selected):

  • Installed
  • Upgraded .

These nodes show the logs for the servers that were successfully installed or upgraded.

Under the Running node, you can view all servers on which the Job is running.

Under Failed and Warning nodes, additional nodes are displayed for respective error messages.


In BMC Server Automation 8.5 SP1, you must manually check the target servers that are displayed with the pending reboot warning. The RSCD agent maybe successfully upgraded on some servers requiring only a reboot. However, some servers may not have RSCD agents upgraded successfully on them.

To see complete error or warning messages, click the respective node for a target, as in the following figure:

Upgrading through CLI

The following set of BLCLI commands are available for creating an Agent Installer Job for performing an Install operation or an Upgrade operation and for setting various job options for an Upgrade operation:

To set job options for an Install operation, use the other BLCLI commands in the AgentInstallerJob namespace.

Was this page helpful? Yes No Submitting... Thank you