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 script ccms_config.py. 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.
Prerequisites
You have configured parameter reporting for TREX (see Configuring Parameter Reporting).
UNIX: Calling Script ccms_config.py
...
1. Log on to the TREX host as root.
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 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 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
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.
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 GRMGin 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.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\prfclog\grmg
● On UNIX: /usr/sap/prfclog/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_trex44.xml.
The window GRMG customizing file uploaded successfullyappears.
○ Choose Upload/Download → Poll agents for new scenarios.
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/Stop → Start Scenarios.
The window GRMG scenarios have started appears.
Result
You have configured the monitoring of availability (heartbeat/GRMG) for TREX.