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 carrying out the following steps:

●      Calling the script ccms_config.py. with the parameter --grmg

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

Prerequisites

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

UNIX: Calling the ccms_config.py Script

...

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

       2.      Go to the <TREX_DIR> directory.

       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 <TREX_DIR> directory.

       3.      Set the environment variables required by TREX by entering the following command into a prompt.

TREXSettings.bat

       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 you need help on the ccms_config.py configuration script, enter: ./ccms_config.py-? (-h or --help).

Windows and UNIX: Uploading XML Customizing File in 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 GRMG_config.xml file that was created on calling the script.

The GRMG_config.xml customizing file is uploaded automatically by the CEN one hour after the creation of the file at the latest. This means you only have to upload the file manually in transaction GRMG if you want to check the monitoring of availability (heartbeat/GRMG) immediately after you have created the file by means of the ccms_config.py. Python script 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 Upload/Download → Upload Scenario.

                                                  i.       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 GRMG_config.xml customizing file is located in the following directory:

●        On Windows: <disk_drive>:\usr\sap\<SAPSID>\
TRX<instance_number>\<trex_host_name>\trace\grmg

●        On UNIX: /usr/sap/<SAPSID>/TRX<instance_number>/
<trex_host_name>/trace/grmg

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

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

The window GRMG customizing file uploaded successfully appears.

○       Choose Upload/Download → Poll agents for new scenarios.

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

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

       4.      Choose Start/Stop → Start Scenarios.

The window GRMG scenarios have started appears.

Result

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