Show TOC Start of Content Area

Procedure documentation Availability Monitoring for Web Dynpro Applications  Locate the document in its SAP Library structure

Use

In the SAP Solution Manager, SAP CCMS Generic Request and Message Generator (GRMG) technology is used for the availability monitoring of various application types. This technology consists of the GRMG infrastructure and the GRMG application. The GRMG infrastructure is part of the Computing Center Management System (CCMS). It sends a text query to the GRMG application and receives a corresponding response; both the query and the response are messages in a defined XML format.

This SAP Java monitoring infrastructure can also be used for the availability monitoring (Heartbeat support) of Java Web Dynpro applications. The following three checks can be executed for any local Web Dynpro application or any Web Dynpro DC application:

      Was the application deployed on the server?

      Was the application started successfully?

      Was the back-end connection established using jRFC?

       The system checks whether the back-end systems defined for this application can be reached. No connection is established, but instead the system executes an RFC ping. It is therefore not necessary to log on to the back-end system with a valid user.

To instrumentalize the Web Dynpro application for the GRMG monitoring – that is, to supply the GRMG infrastructure with the application-relevant data – you must adapt the configuration template grmg-customizing.xml. This is done by entering the application URL in the configuration file. The template is part of the standard shipment of the SAP Web Application Server; the Visual Administrator tool is available for monitoring standalone Java Web Dynpro applications.

Prerequisites

      Installation of the SAP NetWeaver Developer Workplace 04

      Registration of the computers involved in the availability check with IP address in the internal network

       The name of the host (value of the %Host% variable in the GRMG configuration file) must enable an unambiguous IP address resolution in the CCMS system.

Installation of the CCMS agent SAPCCMSR with Option -j2ee

Note

See also, Installing and Registering CCMS Agents

Adjusting and Uploading the GRMG Customizing File

For every GRMG scenario, you first require a suitable GRMG customizing file, thus also for Web Dynpro applications. This file contains the information required for monitoring the Web Dynpro application in the form of parameters. This information is read and processed by the GRMG infrastructure, which runs on the central monitoring system. To make use of the Availability Monitoring function, you must adjust the customizing file grmg-customizing.xml.

      1.      First assign the configuration file to the Web Dynpro application. To do so, open the Navigator view in the SAP NetWeaver Developer Studio and import grmg-customizing.xml into the Web Dynpro project (context menu entry Import on the project name). The GRMG XML file can be found in your file system (operating system Windows) in the directory /saploc/prfclog/grmg of your Java engine installation.

       2.      Copy the XML file into the META-INF directory of the application project. This packs the configuration into the .ear file.

       3.      Execute the build and deployment for the Web Dynpro application in the Web Dynpro perspective of the SAP NetWeaver Developer Studio and start the application.

       4.      Start the Visual Administrator tool using go.bat in the directory /<SID>/j2ee/admin/ of your local server installation and choose Cluster Server Services Monitoring Runtime GRMG Customizing. Then proceed as described in The GRMG Runtime Control in the Visual Administrator .

       5.      Make the following parameter adjustments in the GRMG Customizing file:

                            a.      Name of scenario

<scenname>WDADM630</scenname>

                            b.      Name of application including vendor ID and name of development component

<scenstarturl>http://%HOST:%PORT/webdynpro/dispatcher/sap.com/tc~wd~tools/Explorer?sap.session.client=GrmgClient</scenstarturl>

       6.      Load the GRMG customizing into the CCMS. Proceed as described in Saving Your Work. Uploading the XML to the CCMS.

 

The following is the default source template of the GRMG configuration file for a Web Dynpro application. The template is delivered with the Web Dynpro runtime and configures the heartbeat server for the Web Dynpro application. In this XML source code, you must make the relevant adjustments for the availability check of the current Web Dynpro application.

 

<?xml version="1.0" encoding="UTF-8"?>

<customizing>

  <control>

    <grmgruns>X</grmgruns>

    <runlog></runlog>

    <errorlog></errorlog>

  </control>

  <scenarios>

    <scenario>

      <scenname>WDADM630</scenname>

      <scenversion></scenversion>

      <sceninst>001</sceninst>

      <scentype>URL</scentype>

      <scenstarturl>http://%HOST:%PORT/webdynpro/dispatcher/
       sap.com/tc~wd~tools/Explorer
?sap.session.client
       =GrmgClient
</scenstarturl>

      <scenstartmod>Unknown</scenstartmod>

      <scentexts>

        <scentext>

          <scenlangu>E</scenlangu>

          <scendesc>GRMG: Web Dynpro on %SID:%INST.</scendesc>

        </scentext>

      </scentexts>

      <components>

        <component>

          <compname>WDDEPLOY</compname>

          <compversion>001</compversion>

          <comptype>Unknown</comptype>
          <comptexts>

            <comptext>

              <complangu>E</complangu>

              <compdesc>Test whether Web Dynpro Application is
                deployed.
</compdesc>

            </comptext>

          </comptexts>

          <properties>

            <property>

              <propname>Unknown</propname>

              <proptype>X</proptype>

              <propvalue>Unknown</propvalue>

            </property>

          </properties>

        </component>

        <component>

          <compname>WDSTATE</compname>

          <compversion>001</compversion>

          <comptype>Unknown</comptype>

          <comptexts>

            <comptext>

              <complangu>E</complangu>

              <compdesc>Test whether Web Dynpro Application is 
                enabled and started.
</compdesc>

            </comptext>

          </comptexts>

          <properties>

            <property>

              <propname>Unknown</propname>

              <proptype>X</proptype>

              <propvalue>Unknown</propvalue>

            </property>

          </properties>

        </component>

        <component>

          <compname>WDJRFC</compname>

          <compversion>001</compversion>

          <comptype>Unknown</comptype>

          <comptexts>

            <comptext>

              <complangu>E</complangu>

              <compdesc>Test whether backend systems could be
                accessed using JRFC.
</compdesc>

            </comptext>

          </comptexts>

          <properties>

            <property>

              <propname>Unknown</propname>

              <proptype>X</proptype>

              <propvalue>Unknown</propvalue>

            </property>

          </properties>

        </component>

      </components>

    </scenario> 

  </scenarios>

</customizing>

 

Displaying Availability Data

The availability data is displayed in the heartbeat monitor of the CCMS. In the SAP system, start the transaction TZ20 and choose All Monitoring Contexts SAP CCMS Technical Expert Monitors SAP J2EE Monitor Templates Heartbeat Web Dynpro.

See also, Displaying J2EE Availability Data in the CCMS.

Monitoring Web Dynpro iViews

If you want to monitor Web Dynpro applications that you integrated in the SAP Enterprise Portal, proceed as described in Setting Up GRMG Monitoring of the Portal Infrastructure.

End of Content Area