Control-M/EM UNIX Cluster Configuration

The Control-M/EM UNIX installation is not cluster aware. Therefore, you must configure the UNIX cluster manager to manage Control-M/EM components.

Before you can configure Control-M/EM in a cluster environment on UNIX, you must do the following:

BMC provides demo scripts that start, check, and stop Control-M/EM components. You can build your own scripts and use the provided scripts as an example, or update the scripts to match your installation. After your scripts are ready, you can configure the cluster manager to use the scripts.

The following demo scripts are located at <Control-M/EM_HOME>/bin:

  • demo_ha_cluster_start

  • demo_ha_cluster_check

  • demo_ha_cluster_stop

  • (Main Script) demo_ha_cluster

To get the usage, run the scripts with –help (or with no parameter).

The following procedures describe how to configure Control-M/EM in a clustered environment on UNIX using BMC-provided demo scripts:

Modifying the Demo Ha Cluster Script

This procedure describes how to modify the demo ha cluster script with the Control-M/EM home directory and the UNIX account name. This enables you to provide the cluster manager with the required scripts to start, check, and stop components.

Begin

  1. Navigate to the following directory:

    <Control-M/EM home dir>/ bin

  2. Open the demo_ha_cluster script.

  3. In the User Definition section, do the following:

    1. Change the EM install directory to the location where Control-M/EM is installed.

      EM_DIR="/data/emuser/ctm_em"

    2. Change the UNIX install account name to the Control-M/EM user account that you created (see Configuring a User Account on UNIX).

      EM_ACC="emuser"

Configuring the Control-M/EM Configuration Agent as a Cluster Resource

This procedure describes how to configure the Control-M/EM Configuration Agent as a cluster resource using the BMC provided demo scripts. You must perform this procedure to activate your cluster environment.

Begin

  • From your cluster manager, add the following commands:

    • Start: demo_ha_cluster_start -C Config_Agent

    • Check: demo_ha_cluster_check -C Config_Agent

    • Stop: demo_ha_cluster_stop -C Config_Agent

  • The Configuration Agent is now managed by the cluster manager. If there is a failover or move, the cluster manager starts up the Configuration Agent on the other host.

Configuring Control-M/EM Kernel Components as Cluster Resources on UNIX

This procedure describes how to configure the CMS, and PostgreSQL database (if installed) components as cluster resources on UNIX.

This procedure is optional. If you do not do it, the Configuration Agent continues to manage the Control-M/EM components.

Begin

  1. Set the system parameter ClusterInstall to 1, as described in General parameters.

    The CMS, and PostgreSQL database components are no longer managed by the Configuration Agent.

  2. From your cluster manager, add the start, check, and stop commands, as described in Control-M/EM UNIX Cluster Commands.

    The Control-M/EM components are now managed by the cluster manager.

Configuring Additional Control-M/EM Components as Cluster Resources on UNIX

This procedure describes how to configure additional Control-M/EM components as cluster resources on UNIX using the BMC provided demo scripts.

This procedure is optional. If you do not do it, the Configuration Agent continues to manage the Control-M/EM components.

Begin

  1. Ignore the following components, as described in Ignoring a Control-M/EM Component:

    • Gateway

    • GUI Server

    • GCS

    • SLA Management

    • Forecast Server

    • Self Service Server

  2. From the command line, run the following command to ignore the Web Server:

    em updater -cluster_components 9.0.21.100

  3. From your cluster manager, enter the start, check, and stop commands, as described in Control-M/EM UNIX Cluster Commands.

    The Control-M/EM components are now managed by the cluster manager.

Control-M/EM UNIX Cluster Commands

The following table lists the start, check, and stop commands for each Control-M/EM component.

The demo_ha_cluster_check command returns a 0 value if the component is up and a different value if the component is down.

Control-M/EM component

Commands

CMS

  • Start: demo_ha_cluster_start -C CMS

  • Check: demo_ha_cluster_check -C CMS

  • Stop: demo_ha_cluster_stop -C CMS

PostgreSQL Database

  • Start: demo_ha_cluster_start -C DBPostgres

  • Check: demo_ha_cluster_chec -C DBPostgres

  • Stop: demo_ha_cluster_stop -C DBPostgres

Gateway

  • Start: demo_ha_cluster_start -C Gateway -dc <Data Center Name>

  • Check: demo_ha_cluster_check -C Gateway -dc <Data Center Name>

  • Stop: demo_ha_cluster_stop -C Gateway -dc <Data Center Name>

GUI Server

  • Start: demo_ha_cluster_start -C GUI_Server -name <Logical Name>

  • Check: demo_ha_cluster_check -C GUI_Server -name <Logical Name>

  • Stop: demo_ha_cluster_stop -C GUI_Server -name <Logical Name>

GCS

  • Start: demo_ha_cluster_start -C GCS

  • Check: demo_ha_cluster_check -C GCS

  • Stop: demo_ha_cluster_stop -C GCS

Web Server

  • Start: demo_ha_cluster_start -C Web_Server

  • Check: demo_ha_cluster_check -C Web_Server

SLA Management (BIM)

  • Start: demo_ha_cluster_start -C BIM

  • Check: demo_ha_cluster_check -C BIM

  • Stop: demo_ha_cluster_stop -C BIM

Forecast Server

  • Start: demo_ha_cluster_start -C Forecast_Server -name <Logical Name>

  • Check: demo_ha_cluster_check -C Forecast_Server -name <Logical Name>

  • Stop: demo_ha_cluster_stop --C Forecast_Server -name <Logical Name>

Self Service Server

  • Start: demo_ha_cluster_start -C Self_Service_Server

  • Check: demo_ha_cluster_check -C Self_Service_Server

  • Stop: demo_ha_cluster_stop --C Self_Service_Server

Control-M/EM Configuration Agent

In some cases, after setting a virtual host name online, the physical host name of the cluster host becomes unavailable. In such case, additional configuration is required for the Control-M/EM Configuration Agent. This configuration provides the ability to send life check communications to the Control-M/EM Configuration Agent using the virtual host name.

This configuration should only be used if the Control-M/EM Configuration Agent appears in the Configuration domain as Not Responding after you start the Control-M/EM Configuration Agent.

Begin

  1. Stop the Control-M/EM Configuration Agent from root_menu or by running the command stop_config_agent from the shell prompt (this requires the Control-M/EM DBO password).

  2. Modify the following HostPort Control-M/EM system parameter values, as described in Configuring Control-M/EM System Parameters:

    Field

    Value

    Category

    General (the default value)

    Name

    HostPort (the default value)

    Value

    vhemxxx:0, as described in the following format:

    <Virtual_Hostname>:<Port_Number>

    The 0 (zero) port number value instructs the Control-M/EM Configuration Agent to listen on a random port that is chosen when the Control-M/EM Configuration Agent starts up. If a port other than zero is defined, the Control-M/EM Configuration Agent will use that port number.

    Component Type

    Config Agent

    Component Name

    * (Default)

    Component Host

    * (Default) Computer hostname

    If the installation of the Control-M/EM components is distributed between additional hosts other than the cluster hosts, a separate condition must be specified with the physical host names of each cluster host specified in the Host Name parameter.

  1. Click Save.

  2. Start up the Control-M/EM Configuration Agent.

Global Condition Server

In some cases, after setting a virtual host name online, the physical host name of the cluster host becomes unavailable. In such case, additional configuration is required for the GCS. This configuration should only be used if the GCS failed to start after a failover.

Begin

  1. Shut down the GCS, as described in Shutting Down a Control-M/EM Component.

  2. Verify that the GCS is not running on any of the cluster hosts (ps -ef | grep gcs).

  3. Modify the following HostPort Control-M/EM system parameter values, as described in Configuring Control-M/EM System Parameters:

    4. Field

    Value

    Type

    General (the default value)

    Name

    HostPort (the default value)

    Value

    vhemxxx:55443, as described in the following format:

    <Virtual_Hostname>:<Port_Number>
    Do not define the port number as 0.

    Component Type

    GCS

    Component Name

    * (Default)

    Component Host

    * (Default)

  1. Click Save.

  2. Start up the GCS, as described in Starting Up a Control-M/EM Component.