Performing the upgrade

This section guides you through the upgrade process of the BCM master and database on all supported platforms.

This BMC Client Management video (3 mins 18 seconds) describes how to upgrade BMC Client Management.

Before you begin

Before starting the actual upgrade you need to upgrade the database first.


If you are upgrading your agents manually, ensure that you always upgrade your master first, and then the agents. An agent cannot communicate with a master that is of an earlier version than the agent.

You also need to check the compatibility of your SQL Server Database. For more information, see Software requirements.

To upgrade the master and database on Windows systems

The update processes of the master and the database are closely linked together and consist of the operations described in the following procedure.

  1. Change to the upgrade/master directory.
    This directory contains the master upgrade packages for all supported platforms.

  2. Launch the upgrade.exe file to start the upgrade wizard.
    A popup requests you to select your language for the installation procedure.
  3. Select the language and click OK. Wait for a few moments while InstallShield prepares the Windows Installer installation and the configuration of BMC Client Management.
    The License Agreement window displays.
  4. Select I accept the terms of agreement and click Next.
    The Check Upgrade Settings window displays showing the currently installed version number and the version to which you are upgrading.
  5. (Optional) Click Change if you want to change the installation path.
  6. Click Next.
    The Upgrade Options window displays. If you do not want to automatically upgrade all your clients after the master is upgraded to the new version, clear the Client Agent Options option.
  7. Click Next.
    The next window lists all of the requirements that need to be fulfilled before you can start the actual upgrade process. 
  8. If appropriate, select the All these requirements are met option, otherwise abandon the upgrade and execute the necessary tasks before relaunching the process.
  9. This step is version specific. 

    This window displays only when you are upgrading from 12.5 and earlier versions.

    Select I have read and I accept to upgrade.

  10. Click Next.
    The Predefined Objects window displays.
  11. Select the language of predefined objects to import and click Next.
  12. This step is version specific.

    This window displays only when you are upgrading from version 12.1.
    The Service Lock Configuration window appears on the screen.

    Select Lock the Client Management Agent Service to prevent local administrators from stopping or starting the service. If you select this option, you have to specify Unlock Password. Click Next.

  13. The Continuous Improvement Program window displays.
  14. Select the appropriate option and click Next.
    The Ready to Upgrade window displays.
  15. Click Upgrade to start the upgrade process.
    The upgrade first stops the agent (that is, the blueicon in the system tray disappears) and then upgrades all components that you have selected to upgrade.
  16. In the wizard complete window, click Finish.
    To view the upgrade log, select the respective option. We recommend that you select this option because the log file contains important information if you face a problem during the upgrade.

To upgrade the master and database on Linux systems

The update processes of the master and the database are closely linked together and consist of the operations described in the following topics.

  1. Open the /root/BMC/upgrade/master folder.
  2. Open a terminal window, and change directory to /root/BMC/upgrade/master.
  3. Add executable rights on the script by running the following command:

    chmod +x
  4. Execute this command:

  5. The upgrade executable first stops the agent.
  6. Answer the questions that appear in the terminal window.

    This upgrade process automatically updates all operational rule steps, report templates, and predefined objects. If you want to manually update the predefined objects at another time, see Upgrading the Predefined Objects.

  7. The upgrade process restarts the agent.

Where to go from here

Performing the console and the predefined objects upgrade

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


  1. Sai Kumar Manepu

    The following video has step by step instructions to upgrade BCM Master on a Windows Server :

    Dec 09, 2020 08:23
  2. Sai Kumar Manepu

    Dec 09, 2020 08:24

    The BCM upgrade steps for master and database on Linux systems are unclear/incomplete. Kindly update the document and include the detailed steps as provided for BCM windows upgrade.

    Sep 06, 2023 02:08