Show TOC

Configuring Monitoring of Availability (Heartbeat/GRMG)Locate this document in the navigation structure

Prerequisites

You have configured the parameter reporting for TREX (see Configuring Parameter Reporting).

Context

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 ccms_config.py script with the parameter --grmg

  • Uploading the XML configuration file GRMG_config.xml, which was created on calling the script, to the SAP system using transaction GRMG.

Procedure

  • UNIX: Calling the ccms_config.py script

    1. Log on to the TREX host with the <sapsid>adm user.

    2. Go to the directory <TREX_DIR>.

    3. Set the environment variables required by TREX by executing the following scripts.

      Bourne shell sh, Bourne-again shell bash, Korn shell ksh

      . TREXSettings.sh

      C Shell csh:

      source TREXSettings.csh

    4. Go to the <TREX_DIR>/exe/CCMS directory, 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

      If the superuser script requires authorizations for creating a directory, it will prompt you for the superuser password.

  • Windows: Calling the ccms_config.py script

    1. Log on to the TREX host as administrator.

    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

      Note

      If you need help on the configuration script ccms_config.py, enter: ./ccms_config.py -? ( -h or --help).

  • 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 file GRMG_config.xml, which was created on calling the script.

    Caution

    The configuration file GRMG_config.xml will be uploaded automatically by the CEN at the latest one hour after creation of the file. This means you only have to upload the file manually by transaction GRMG if you want to check the monitoring of availability (heartbeat/GRMG) immediately after you have created the file by means of the Python script ccms_config.py. with the parameter -grmg.

    1. Start transaction GRMG in the SAP system.

    2. Choose Upload/Download.

      There are two ways to upload the TREX scenario:

      • Choose Start of the navigation path Upload/Download Next navigation step Upload Scenario End of the navigation path.

        1. In the GRMG Customizing: Upload window, choose the path to the XML customizing file GRMG_config.<SAPSID>_<TREX_instance>.<host>.xml.

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

          • On Windows: <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_number>\<trex_hostname>\trace\grmg

          • On UNIX: /usr/sap/<SAPSID>/TRX<instance_number>/<trex_hostname>/trace/grmg

        2. Choose the XML customizing file for the corresponding TREX instance and choose Open.

          Note

          If you have chosen the instance number 44 for TREX, the XML customizing file is called GRMG_config.TRX44.myhost.xml.

          The window GRMG customizing file uploaded successfully appears.

      • Choose Start of the navigation path Upload/Download Next navigation step Poll agents for new scenarios End of the navigation path.

        Note

        This upload of the TREX scenario will only work if the SAPCCMSR agent is running and has been registered previously.

    3. In the list GRMG Scenarios for Availability Monitoring, choose the corresponding TREX scenario.

    4. Choose Start of the navigation path Start/Stop Next navigation step Start Scenarios End of the navigation path.

      The window GRMG scenarios have started appears.

Results

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