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 (03:18 minutes) describes how to upgrade BMC Client Management.

Before you begin

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


If you use the RSSO integration, ensure that on the RSSO server, the realm used has the master server DNS alias as one of the application domains. 


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

You also need to check the compatibility of your Microsoft 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.

StepProcedureCorresponding view

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


Launch the upgrade.exe file to start the upgrade wizard.
A popup requests you to select your language for the installation procedure.


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.


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.


(Optional) Click Change if you want to change the installation path.


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.


Click Next.
The next window lists all of the requirements that need to be fulfilled before you can start the actual upgrade process. 


If appropriate, select the All these requirements are met option, otherwise abandon the upgrade and execute the necessary tasks before relaunching the process.


This step is version specific if you are upgrading from version 12.5 or earlier versions.

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

Select I have read and I accept to upgrade.


Click Next.
The Predefined Objects window displays.


Select the language of predefined objects to import and click Next.


This step is version specific if you are upgrading from version 12.1.

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.


The Continuous Improvement Program window is displayed.


Select the appropriate option and click Next.
The Ready to Upgrade window displays.


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.


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

Do the following to upgrade the BMC Client Management master and databases on all supported platforms:

StepProcedureCorresponding view

Navigate to to access the master support tools. Add executable rights on the script by running the following command:

chmod +x


Enter the command ./ to start the upgrade process.


When prompted, enter to confirm that you want to continue with the upgrade process.

4The End License User Agreement is displayed.


On the next screen, you must answer the following questions:

QuestionResponse options
Do you accept terms of the license?y/n
Is this installation in a SaaS environment?y/n
The install directory for the BMC Client Management master is /usr/local/bmc-software/client-management/master

(1) Continue
(2) Select another installation directory (without the trailing slash)

Do you want to back up your Master files before upgrading? (Requires 3,5G)y/n
Do you want to automatically upgrade the agents in your network?y/n
I have read and I accept to upgrade.y/n
Are your tablespaces located on this computer?y/n
Enter the path where the tablespaces are located:
Enter the language in which you want to import the predefined objects:us. fr, de, es, jp, bpt
For security purposes, it is possible to lock the BMC client Management service on all agents running on Microsoft Windows. Do you want to lock the agent services?no

The file extraction process is initiated.

6After the upgrade process is complete, view the log files.


If you enter y, the log files are displayed.

8You can now view the database upgrade log files.


If you enter y, the database upgrade files are displayed.

10The upgrade process for BMC Client Management master and databases is now complete.

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



    The upgrade procedure for the master and database on Linux systems is unclear. Please update the proper steps with screenshot as it has been provided for windows os upgrade.

    Sep 05, 2023 07:47