70
© SAP AG 2004, TEP12, 1 EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of SAP Solution Manager

EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

  • Upload
    vudiep

  • View
    232

  • Download
    0

Embed Size (px)

Citation preview

Page 1: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 1

EP Monitoring Infrastructure

Introduction to CCMSEP 6.0 Portal

EP Monitoring Infrastructure

Central Computer Monitoring System

Integration of SAP Solution Manager

Page 2: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 2

Overview: Installing the Monitoring Infrastructure

Installing the Monitoring Infrastructure

EP 6.0 Portal

Availability Monitoring

Install and configure the Prerequisites

Parameter Reporting

Log File Monitoring

Page 3: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 3

Software Requirements for CCMS/SolMan Monitoring

Included in SAP Web AS package on SAP Service Marketplace/Patches

SAP Web AS with Basis Support Package ≥ 29,SAP Solution Manager 3.1

EP Monitoring Package ≥ 3

StandAlone Log Viewer 6.30

SAPOSCOL Version 20.79

Included in SAP Enterprise Portal , EP Monitoring Package on SAP Service Marketplace/Patches

SAPCCMSR Patch Collection 8/2003+

Regular Shipment of SAP EP 6.0SAPJ2EE Engine 6.20 PL 16+

Regular Shipment of SAP EP 6.0Enterprise Portal 6.0 SP1+

Page 4: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 4

Required Support Infrastructure

SAP Router

WANWANSAP

SupportSAP

Support

via sapserv<n>

SAP Solution Manager 3.1 incl. Windows Terminal Server

SAP Web AS 6.20

Windows 2000 Advanced ServerEnterprise

Portal 6.0* DEV

Enterprise Portal 6.0*

INT

Enterprise Portal 6.0*

PROD

Windows-basedremote access

*On each server :- SAPOSCOL- SAPCCMSR

used connection types:- R/3 Support- Telnet- WTS- HTTP Connect

Page 5: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 5

SAP Java Components(e.g. SAP Enterprise Portal)

Central MonitoringSystem

Installation/Integration Steps

SAP J2EE

SAPCCMSRShared Memory

SAPOSCOL

SAP Web ASor

SAP Solution Manager

1. Install SAPOSCOL and SAPCCMSR

2. Configure SAPCCMSR

3. Configure SAPOSCOL

4. Update jmon.dll and jmonapi.jar

5. Configure J2EE Monitor Server

6. Setup Log file Monitoring

7. Setup StandAlone Log Viewer

8. Enable GRMG

9. Setup JARM Data

1

2

3

4 5

6

89

Log Viewer Server7

Log Viewer Client

Log filesMHS1

Page 6: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 6

Install and Configure the Infrastructure Prerequisites

Installing and configuring the Infrastructure Prerequisites comprises the following steps:

Unpack the EP_Monitoring package on each host of the EP environmentImporting a transport request into the Central Monitoring System(CEN)Post processing in Client 000 in CENSetting up SAPCCMSRSetting up SAPOSCOLSetting up JMonChecking the Shared Memory Segment

Page 7: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 7

Download EP_Monitoring Package from SMP

The EP_monitoring package can be downloaded from SMP.

Note: There are different packages for EP 5.0 and EP 6.0.Note: There is only one version for EP 6.0 this package will be constantly updated! [Don’t forget to note down the date of last download since there is currently no package-info included!]Note: Upcoming changes for EP on SAPJ2EE 6.40 SP3 (NW 04)

Page 8: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 8

Create a moni_temp directory

Page 9: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 9

Unpack the supportability archive into moni_temp

Unpack the archive use the complementary sapcar version.Under UNIX: first set the execute flag for sapcar by typing chmod a+x sapcarType in sapcar –xvf <package>

Page 10: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 10

Content of EP_monitoring package

ConfigFile for SAPOSCOL

GRMG Configuration

j2eeadm profile

Transport Packages for CEN including GRMG application includingCATjobs for CEN system preparation

Agent SAPCCMSR

SAPOSCOL

LogViewer 6.30

Jmon

Preparation on training system us500x done!

Page 11: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 11

Install and Configure the Infrastructure Prerequisites

Installing and configuring the Infrastructure Prerequisites comprises the following steps:

Unpack the EP_Monitoring package on each host of the EP environmentImporting a transport request into the Central Monitoring System (CEN) clarify with customer !Post processing in Client 000 in CEN clarify with customerSetting up SAPCCMSRSetting up SAPOSCOLSetting up Jmon APIChecking the Shared Memory Segment

Note: Important for customer systems!Check first if user CSMREG and/or role CSMREG are already installed ask the customer if you are not sure!Due to Basis Support Packages and administration already doneby the customer, you may overwrite customer settings by applyingthese transports!

test sapccmsr & RZ20 if you are not sure if the CEN & CSMREG(user / role) is already configured properly

[ In Appendix: CEN ]

Appendix: All slides with Windows Only in Red are also in Appendix: Unix Commands

Page 12: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 12

Windows only: execute install.cmd from moni_temp

Page 13: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 13

Establish an RFC Connection

SAPOSCOL is running now

SAPCCMSR needs to be installed and configuredDefining parameters for the RFC connectionInstalling the SAPCCMSRDefining properties for the Shared Memory Segment and other parameters by editing the profile j2ee.pfRestarting SAPCCMSR

Page 14: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 14

SAP / Non-SAP InstanceCentral Monitoring System

Setup an RFC Connection

SM59 connectionType T

SAPCCMSRGWProgram ID

<host>.sapccmsr.99

RFC Connection

Page 15: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 15

Definition of RFC Connection

To establish an RFC connection between the portal host and Central Monitoring System the file csmconf_sc needs to be edited. The following entries have to be made:

Central Monitoring System:CEN_CONFIG

CEN_SYSID=$SID$ => TS3

Login information for admin user, only used during registration:CEN_ADMIN_USER

CEN_ADMIN_CLIENT=$CLIENT$ => 600CEN_ADMIN_USERID=$USER$ => TEP12-XXCEN_ADMIN_PASSWORD=$PASSWD$ => initCEN_ADMIN_ASHOST=$CEN_HOST$ => hostCEN_ADMIN_SYSNR=$INSTANCE_NUMBER_OF_CEN$ => 14

Gateway information for RFC service "-DCCMS", used to build saprfc.iniCEN_GATEWAY

CEN_GATEWAY_HOST=$CEN_HOST$ => hostCEN_GATEWAY_SYSNR=$INSTANCE_NUMBER_OF_CEN$ => 14

login information for CSMREG userCEN_CSMREG_USER

CEN_CSMREG_CLIENT=$CLIENT$ => 600CEN_CSMREG_USERID=$USER_CSMREG$ => CSMREGCEN_CSMREG_PASSWORD=$PASSWD$ => initCEN_CSMREG_ASHOST=$CEN_HOST$ => hostCEN_CSMREG_SYSNR=$INSTANCE_NUMBER_OF_CEN$ => 14

Page 16: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 16

Windows only: Registration of SAPCCMSR (file-based)

Start the SAPCCMSR agent RFC registration by the following command: WINDOWS: sapccmsr –R –f <DRIVE>:\usr\sap\prfclog\csmconf_sc

Page 17: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 17

Windows only: Starting and Stopping SAPCCMSR

WINDOWS

SAPCCMSR can be started and stopped with the same parameters as in UNIX. However, it is recommended to use the Windows service tool instead:

Page 18: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 18

Windows only: Configuration of SAPOSCOL and SAPCCMSR as Service

Installing SAPOSCOL and SAPCCMSR as Windows service has the advantages:- Re-starting the Windows server will restart these servives automatically- If services are installed properly, they start always with the correct permissions (security)

SAPOSCOL:ntscmgr install SAPOSCOL –b <DRIVE>:\usr\sap\prfclog\saposcol.exe –p serviceSAPCCMSR:ntscmgr install SAPCCMSR <DRIVE>:\usr\sap\prfclog\sapccmsr\sapccmsr.exe –DCCMS pf=<DRIVE>:\usr\sap\prfclog\j2ee.pf

Page 19: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 19

Extending MONI_SEGM_SIZE

Extending the MONI_SEGM_SIZE to minimum of 64000000 is necessary due to amount of data reported by a standard EP portal installation

Page 20: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 20

Windows only: Configuration of SAPOSCOL: Editing dev_proc

Configuring SAPOSCOL by editing dev_proc is done to monitor dedicated processes on the portal host.

here you can see the output of a Windows based Portal

Page 21: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 21

Windows only: Configuration of SAPOSCOL: Assigning MTE classes and attribute-groups

Due to upcoming assignment of autoreaction methods and thresholds to this processes it is recommended to attach MTE-classes and attribute-groups onto the process names.

Structure oscolfile.txt

Page 22: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 22

Windows only: Starting and Stopping SAPOSCOL

WINDOWS

SAPOSCOL can be started and stopped with the same parameters as in UNIX. However, it is recommended to use the Windows service toolinstead:

Page 23: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 23

Windows only: Update Directories which have jmonapi.jar

In the moni_temp directory there is a file called jmon.dllThe right version of jmon.dll can also be found on SAP SMP under http://service.sap.com/patchesSAP Web AS SAP Web AS 6.20 Binary Patches SAP Kernel 6.20 32-Bit [64-Bit] <PLATFORM> Database Independent JMON: API for CCMS-Monitoring (SAR Archive for installation)

Copy jmon.dll to <Windows home>\system32

Find the directories where jmonapi.jar resides with the Windows‘Explorer

Page 24: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 24

Overview: Installing the Monitoring Infrastructure

Installing the Monitoring Infrastructure

EP 6.0 Portal

Availability Monitoring

Install and configure the Prerequisites

Parameter Reporting

Log File Monitoring

Page 25: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 25

Log File Monitoring

Setting up log file monitoring comprises the following steps:Configuring the SAP J2EE Monitor ServerStarting the SAP J2EE Engine and the J2EE Monitoring ServerGenerating the INI Files for Automatic Monitoring of SAP J2EE Engine Log FilesRegistering the INI Files in the SAPCCMSRGenerating the INI Files for automatic monitoring of the log files of J2EE ApplicationsIntegrate the monitoring server into a cluster node for automated startup

Page 26: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 26

Configuration of SAPJ2EE Monitor Server

Check monitorServer.properties

java.naming.provider.url=your hostname:<p4 port>java.naming.security.principal=Administrator

java.naming.security.credentials=<blank>

Add host name & instance no. to the root node for the SAPJ2EE Engine to avoid clashes, when several SAPJ2EE instances will report data into

the same CCMS sytsem.

Page 27: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 27

Test SAPJ2EE Engine Monitor Server

Start SAP J2EE Engine and the monitor server as user j2eeadm with /usr/sap/<portal>/j2ee/j2ee_00/tools/monitor

Page 28: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 28

Connecting to the SAP Visual Administrator

Check the monitor service node in the Visual Administrator

Page 29: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 29

Windows only: Generating INI Files for Automatic Monitoring of SAP J2EE Engine Log Files

The SAPJ2EE monitoring server generates control files that are required to monitor the J2EE Engine logs. After starting the monitoring server, create the log file templates by making the following entry in the monitor server console:

generateLT <J2EE home dir> <DRIVE>:\usr\sap\prfclog\logmon

Page 30: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 30

Windows only: Registering the INI Files at SAPCCMSR

In every generated sub directory of <DRIVE>:\usr\sap\prfclog\logmon a file log_templates.summary is stored.The content of the summary files should now be copied and inserted into the <DRIVE>:\usr\sap\prfclog\sapccmsr\sapccmsr.ini file.For Windows the registration can automated by the following command:

c:\usr\sap\prfclog\logmon\ALERT\log_template.summary >> c:\usr\sap\prfclog\sapccmsr\sapccmsr.ini

Page 31: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 31

Generating the INI files for automatic monitoring of J2EE Application and Portal Logs

Change Entry

Save the Changes and restart the service!

1

2

Restart SAPCCMSR afterwards!3

Page 32: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 32

Integrate the monitoring server into a cluster node for automated startup

Do the following steps...Add the following lines into <J2EE home dir> /cluster/server/services/shell/work/autorun.scr

add monitorstartmonitorserver

For a single node installation (i.e. one server process and one dispatcher process) these entries can be added to the autorun.scr of the dispatcher as an alternative Restart the SAPJ2EE Engine

Page 33: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 33

Overview: Installing the Monitoring Infrastructure

Installing the Monitoring Infrastructure

EP 6.0 Portal

Availability Monitoring

Install and configure the Prerequisites

Parameter Reporting

Log File Monitoring

Page 34: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 34

Availability Monitoring

Availability Monitoring comprises two major steps: Enabling availability monitoring for the SAP J2EE Engine

Is already done by configuration of the monitor serverEnabling the GRMG check for the portal: For the availability check using GRMG, the central monitoring system periodically calls a portal URL. The underlying GRMG application checks the portal and reports check results to the central monitoring system. This availability check is activated in the following steps:

Adjusting the GRMG customizing filesUploading the GRMG customizing file to the central monitoring systemActivate the GRMG check in the central monitoring systemChecking the mechanism in the delivered CCMS monitor

Page 35: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 35

Solution Manager

GRMGInfrastructure

EP-GRMGApplication

SAP J2EE Engine

CCMS

Central Monitoring System

SAP System

Other ComponentsGRMGApplication

SAP Web AS

LocalCCMS

GRMGApplication

HTTP-Request

HTTP-Response

Availability Monitoring Using GRMG: Overview

Page 36: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 36

Typical Web Server Situation

TX rz20 TX grmg

Web Server

GRMG Framework

GRMG application

Servlet

EJB

1

Servlet Engine

J2EE Server

SAP System (R/3)

SAP System (R/3)

CCMS Monitoring

3

2

45

8

6

7

9

10

11

Page 37: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 37

GRMG Configfile

In the Portal:Create a user called ‘heartbeat’ with password ‘grmg01’.Assign the user to the super_admin_role and eu_role.

Download the file grmgRequesthttp_template.xml from the moni_temp directory and edit it.

For entry <scenname> specify a unique name, e.g. EP6_TPxxFor entry <scenstarturl>http://…. insert the following values:

<host> = Name of Portal host<http-port> = Type in the HTTP-port, by default this is 50000<user> = heartbeat<password> = grmg01 (Note: The password cannot have more then 6 characters due to restrictions of CCMS GRMG application.)

For entry <scendesc>GRMG_HTTP_EP6_TPxxThere are three scenarios by default included:

Test of the clusterTest of a SAP System from the portalTest of a Website

Page 38: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 38

Importing the GRMG config file into CEN

Open transaction GRMG with /ngrmgUpload the file grmgRequesthttp_template.xml

Page 39: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 39

Check the results

In transaction GRMG you can see the results of your upload.

Select the uploaded scenario and start it!

In transaction RZ20 you can see the results after a few minutes.

START

Page 40: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 40

Results of GRMG Availability Check

Cluster communication is ok!

Testing a webcomponent is ok!

No real test scenario configured!

Check in Transaction RZ20:

Page 41: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 41

Overview: Installing the Monitoring Infrastructure

Installing the Monitoring Infrastructure

EP 6.0 Portal

Availability Monitoring

Install and configure the Prerequisites

Parameter Reporting

Log File Monitoring

Page 42: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 42

Parameter Reporting

Parameter Reporting comprisesEP Monitors for PRT, PCD, UMEKM Monitors for TRex and CMSAPJ2EE Monitors

Proceed the following steps: Check portal monitoring configurationSet up parameter reporting for SAPJ2EEManual adding of new monitor sets to CCMS

Page 43: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 43

Check Monitoring Configuration in EP 6.0 SP2

Page 44: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 44

Parameter Reporting for SAP J2EE Engine 6.20

Page 45: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 45

Parameter Reporting

SAP component forcentral monitoring

SAP component forcentral monitoring

J2EEJ2EE

Monitoring segmentSAPCCMSR

CEN

Jmon-APIJmon-API

Reports configuration parameters into the

monitoring segment of SAPCCMSR

Parameters can be displayed centrally!

Monitoring ServiceMonitoring Service

Page 46: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 46

CCMS: Parameter Reporting – PRT, PCD, UME, KM

In CCMS the following monitors can be customized:

PRTConfigurationStateVersion

PCDConfigurationStateVersion

UMEConfigurationStateVersion

KMConfigurationStateVersion

Page 47: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 47

CCMS: Parameter Reporting – PRT, PCD, UME, KM

Example: Checking the state of UME components and services

Page 48: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 48

Displaying JARM data

For EP 6.0 SP2 Patch 1 JARM data from the portal is not displayed in the target CCMS system.

Proceed as described in OSS Note 516920 & 689872Update reference.txt in <J2EE_directory>/cluster/server/managers.Update jarm.properties and default.properties in directory profiles.

Update cmdline.properties

Restart the J2EE Engine

Page 49: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 49

JARM Data in RZ20

Page 50: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 50

Overview: Unit Summary

You are now able to:

Install and Configure the Monitoring Infrastructure Prerequisites

Set up Log File Monitoring Infrastructure

Set up GRMG Availability Monitoring

Set up Parameter Reporting

Page 51: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

Appendix: Setup for CEN

Page 52: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 52

Importing a Transport Request into CEN

Import procedure: Copy the K*-files to directory /usr/sap/trans/cofilesCopy the R*-files to directory /usr/sap/trans/dataEnter CEN system. Start transaction STMS. This is SAP main tool to import change requests. Click on Import overview. Double click CEN system ID. You see the queue of change requests ready for importinto CEN system.Now , you have to insert the three change requests of the JSTF package into the CEN queue. Select Extras >> Other requests >> Add. Enter NBSK900051.Click ok.The change request appears in the queue.Do the same for change request NBSK900071 and BCEK079283.

Page 53: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 53

Importing a Change Request into CEN

Import procedure: To import request NBSK900051, position on NBSK900051 and click Import request (NOT: Import All requests!).Enter 000 for Target client and press ENTER. The change request is now imported into CEN system.Run the same procedure for the other two change requests.

Page 54: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 54

Post processing in Client 000: Activate CSMREG user Role

Activating procedure: Enter client 000 in CEN system. Start transaction PFCG. Enter role name CSMREG and click Change Role.Select the tab Authorizations. Click Change authorization data. Click Generate and acknowledge the profile name. The profile of the role CSMREG is now generated and ready for use.

Page 55: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 55

Post processing in Client 000: Creating User CSMREG

Post processing procedure: Enter client 000 in CEN system.Start transaction SCAT. This is a tool to run computer aided tests. In our case, it helps to run through difficult transactions in an automated way.Enter ZCSMREG_USER_ANLEGEN for the test case and press F8. Click once more F8 to start. CSMREG user is created automatically.

Page 56: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 56

Post processing in Client 000: Creating Batch Jobs

Post processing procedure: Enter client 000 in CEN system.Start transaction SCAT. This is a tool to run computer aided tests. In our case, it helps to run through difficult transactions in an automated way.Enter ZCCMSJOBS for the test case and press F8. Click once more F8 to start. All necessary batch jobs are created automatically.

Page 57: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 57

Post processing in Client 000: Creating Monitor Set

Post processing procedure: Start transaction RZ20. This is the CCMS alert monitor to monitor your EP system landscape centrally.Choose Extras Activate maintenance function. Place the cursor on EP JSTF Collection, and choose Copy. Name your monitor set (<my monitor set>) and choose ENTER.

Page 58: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

Appendix: UNIX Commands

Page 59: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 59

UNIX only: execute install_root.sh from moni_temp

Page 60: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 60

UNIX only: execute install_user.sh from moni_temp

Page 61: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 61

UNIX only: Registration of SAPCCMSR (file-based)

Start the SAPCCMSR agent RFC registration by the following command: UNIX: sapccmsr –R –f /usr/sap/tmp/sapccmsr/csmconf_sc

Page 62: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 62

UNIX only: Starting and Stopping SAPCCMSR

UNIX

- SAPCCMSR should be started by the following command sapccmsr –DCCMS pf=/usr/sap/tmp/sapccmsr/j2ee.pf

- SAPCCMSR should be stopped by the following command sapccmsr –stop pf=/usr/sap/tmp/sapccmsr/j2ee.pf

Page 63: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 63

UNIX only: Starting and Stopping SAPOSCOL

UNIX

Starting SAPOSCOL needs to be done by a user with root permission with

/usr/sap/ccms/bin/saposcol –l

Stopping SAPOSCOL needs to be done by a user with root permission with

/usr/sap/ccms/bin/saposcol –k

Page 64: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 64

UNIX only: Troubleshooting Shared Memory Segment properties

Type ipcs –ma (UNIX only!) to view Shared Memory Segment Properties: Key must be 04x4dc4Hostname need to be ≤ 13 characters (current limitation of CCMS)Segsize should be ≥ 64 MB--rw-rw---- is required as write permission to the group sapsys

Adapting j2ee.pf for SAPCCMSRStop SAPJ2EE to disconnect JMON from Shared Memory SegmentStop SAPCCMSR agent with /usr/sap/ccms/bin/sapccmsr -stopDelete the shared memory segment with /usr/sap/ccms/sapccmsr -initshmCheck entry NATTCH by command ipcs –ma > Entry must be 0Go to /usr/sap/tmp/sapccmsrOpen j2ee.pf by vi to add the following lines

SAPLOCALHOST=<short hostname>alert/MONI_SEGM_SIZE=64000000ipc/shm_permission_1008=760

Create the new segment with necessary parameters by starting sapccmsr with sapccmsr –DCCMS pf=/usr/sap/tmp/sapccmsr/j2ee.pf

Page 65: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 65

UNIX only: Identifier for java processes for SAPOSCOL

To ease identifying different java processes of SAPJ2EE DISPATCHER & SERVERthe following parameters should be added:

The parameter –D:DSP for the dispatcher is added to \<host>\usr\sap\>portl>\j2ee\j2ee_00\cluster\dispatcherThe parameter –D:SVR1 is added to /usr/sap/<portal>/j2ee/j2ee_01/cluster/server/cmdline.properties

[Configuration of cmdline.properties]

Page 66: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 66

UNIX only: Configuration of SAPOSCOL: Editing dev_proc

Configuring SAPOSCOL by editing dev_proc is done to monitor dedicated processes on the portal host.

here you can see the output of a UNIX based Portal

Page 67: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 67

UNIX only: Configuration of SAPOSCOL: Assigning MTE classes and attribute-groups

Due to upcoming assignment of autoreaction methods and thresholds to this processes it is recommended to attach MTE-classes and attribute-groups onto the process names.

Structure oscolfile.txt

Page 68: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 68

UNIX only: Update All Directories which have jmonapi.jar

In the moni_temp directory there is a file called libjmon.soThe right version of libjmon.so can also be found on SAP SMP under http://service.sap.com/patchesSAP Web AS SAP Web AS 6.20 Binary Patches SAP Kernel 6.20 32-Bit [64-Bit] <PLATFORM> Database Independent JMON: API for CCMS-Monitoring (SAR Archive for installation)

Copy libmon.so to all directories where jmonapi.jar is installed

Find the directories on UNIX by typing find /usr/sap –name jmonapi.jar

Page 69: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 69

UNIX only: Generating INI Files for Automatic Monitoring of SAPJ2EE Engine Log Files

The SAPJ2EE monitoring server generates control files that are required to monitor the J2EE Engine logs. After starting the monitoring server, create the log file templates by making the following entry in the monitor server console:

generateLT <J2EE_directory>/usr/sap/tmp/logmon

Page 70: EP Monitoring Infrastructure - SAP · EP Monitoring Infrastructure Introduction to CCMS EP 6.0 Portal EP Monitoring Infrastructure Central Computer Monitoring System Integration of

© SAP AG 2004, TEP12, 70

UNIX only: Registering the INI files at SAPCCMSR agent

In every generated sub directory of /usr/sap/tmp/logmon a file log_templates.summary is stored.The content of the summary files should now be copied and inserted into the /usr/sap/tmp/sapccmsr/sapccmsr.ini file.For UNIX the registration can automated by the following command: ex.: grep Log File /usr/sap/tmp/logmon/ALERT/log_template.summary >> /usr/sap/tmp/sapccmsr/sapccmsr.ini