Configuring Monitoring of Availability (Heartbeat/GRMG)

Configuring Monitoring of Availability (Heartbeat/GRMG)

Use

You can use the Generic Request and Message Generator (GRMG) to monitor the availability (heartbeat/GRMG) of TREX components.

You configure these monitoring functions by doing the following:

  • Calling the scriptccms_config.py. with the parameter--grmg
  • Uploading the XML configuration fileGRMG_config.xml, which was created on calling the script, to the SAP system using transactionGRMG.

Prerequisites

You have configured parameter reporting for TREX (seeConfiguring Parameter Reporting).

UNIX: Calling Script ccms_config.py

  1. Log on to the TREX host asroot.
  2. Go to the directory <TREX_DIR>.
  3. Set the environment variables required by TREX by executing the following scripts.

    Bourne shellsh, Bourne-again shellbash, Korn shellksh

    . TREXSettings.sh

    C Shell csh:

    source TREXSettings.csh

  4. Go to the directory<TREX_DIR>/exe/CCMS, in which the script for installing the TREX monitoring functions is located.
  5. Execute the following command to configure monitoring of availability (heartbeat/GRMG):

    python ccms_config.py --grmg

Windows: Calling Script ccms_config.py

  1. Log on to the TREX host asadministrator.
  2. Go to the directory<TREX_DIR>.
  3. Set the environment variables required by TREX by entering the following command into a prompt.

    TREXSettings.bat

  4. Go to the directory<TREX_DIR>\exe\ccms, in which the script for installing the TREX monitoring functions is located.
  5. Execute the following command to configure monitoring of availability (heartbeat/GRMG):

    python ccms_config.py --grmg

Windows and UNIX: Uploading XML Customizing File by Transaction GRMG

GRMG checks the availability of TREX services. The SAP system (CCMS) uses an HTTP request to send an XML file defined for GRMG to one of the TREX GRMG servers that runs on the TREX host. The TREX GRMG server analyzes the XML file and starts the relevant scenario text to check the availability of the individual TREX server on the selected TREX host. To activate the monitoring of availability (hearbeat/GRMG) in the SAP system you may have to upload the XML configuration fileGRMG_config.xml, which was created on calling the script.

  1. Start transaction GRMGin the SAP system.
  2. Choose Upload/Download.

    There are two ways to upload the TREX scenario:

    • Choose Upload/Download → Upload Scenario.
      1. In the GRMG Customizing: Upload window, choose the path to the XML customizing fileGRMG_config.xml.

        If you have carried out the configuration steps inConfiguring Parameter Reporting, the XML customizing file GRMG_config.xml is located in the following directory:

        • On Windows:<disk_drive>:\usr\sap\prfclog\grmg
        • On UNIX:/usr/sap/prfclog/grmg
      2. Choose the XML customizing file for the corresponding TREX instance and choose Open.

If you have chosen the instance number44 for TREX, the XML customizing file has the nameGRMG_config_trex44.xml.

The window GRMG customizing file uploaded successfullyappears.

  • Choose Upload/Download → Poll agents for new scenarios.
  1. In the list GRMG Scenarios for Availability Monitoring, choose the corresponding TREX scenario.
  2. Choose Start/Stop → Start Scenarios.

    The window GRMG scenarios have startedappears.

Result

You have configured the monitoring of availability (heartbeat/GRMG) for TREX.