Best practices for fault-tolerant BMC Client Management server cluster deployment

A fault-tolerant (high-availability (HA)) deployment safeguards you against any unplanned downtime of a member node. If one member node of the cluster goes down, the connection is automatically diverted to the other available nodes. This topic walks you through some best practices for such fault-tolerant BMC Client Management server cluster deployment.


The basic concept of a BMC Client Management fault-tolerant cluster deployment is to have the service run on individual member nodes and use a common master file directory from a shared location. The following diagram provides a high-level view of the architecture:


When deploying this cluster architecture, ensure the following:

  • Minimum two servers as member nodes for the cluster with individual static IP address.
  • Only one master directory on a shared location, which must be accessible to each member node in the cluster.
  • A cluster management system to ensure that only one member node has the service running at any given time.


    You can manage the cluster by starting and stopping the service on each member node manually. However, it is not recommended for production environment.

  • All the member nodes have Java installed as per software requirement. It is recommended that all the member nodes have the same Java version.

Setting up the cluster

  1. Install the database client on each node. For more information, see corresponding database client documentation.
  2. On the currently active node, install BMC Client Management master server. For more information, see Installing BMC Client Management on-premises.
  3. On the other cluster nodes, create BMC Client Management agent service. To create the BMC Client Management service on other member nodes:
    • For Windows cluster, use the SC command. For example:

      sc create "BMC Client Management Agent" binPath= "f:\Program Files\BMC Software\Client Management\Master\bin\mtxagent.exe" DisplayName= "BMC Client Management Agent"
    • For Linux cluster, copy the /etc/init.d/BMCClientManagementAgent file to each node.
  4. In the \BMC Software\Client management\Client\config\mtxagent.ini file, set the StaticIPAddress parameter to include the IP address created by your cluster management system. For more information, see the relevant cluster management system documentation or contact their technical support.
  5. In the \BMC Software\Client management\Client\config\identity.ini file, in the [identity] section, add a hostname parameter and provide a value to it as follows:
    hostname = myMasterName.


    By default, the hostname parameter is not available in the identity.ini file. You need to add this parameter and provide a master server name.

    This name is displayed in the console all the time and not the name of the currently active cluster node.

  6. When rolling out agents, select your managed device, go to Agent Configuration > Module Configuration > File Store, and set the TrustedAddress parameter to include IP address of each member node of the cluster and the cluster itself. For more information about the TrustedAddress parameter, see Setting the File Store module parameters.

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