Notices

Preface

Part 1: Overview

1. Overview of PFM - Agent for Enterprise Applications

1.1 Features of PFM - Agent for Enterprise Applications

1.1.1 Collect SAP system performance data

1.1.2 Collect performance data according to its characteristics

1.1.3 Save performance data

1.1.4 Notify about problems in SAP system operations

1.1.5 Easily define alarms and reports

1.1.6 Extract the SAP system's log information and CCMS alert information

1.1.7 Collect the SAP system's monitor information

1.1.8 Operation in a cluster system

1.2 Overview of collecting and managing performance data

1.3 Examples of performance monitoring using PFM - Agent for Enterprise Applications

1.3.1 Purposes of performance monitoring

1.3.2 Selecting a baseline

1.3.3 Examples of performance monitoring

Part 2: Setup and Operation

2. Installation and Setup (In Windows)

2.1 Installation and setup

2.1.1 Before installation and setup

2.1.2 Flow of tasks for installation and setup

2.1.3 Installation procedure

2.1.4 PFM - Agent for Enterprise Applications setup procedure

2.2 Uninstallation and unsetup

2.2.1 Before uninstallation and unsetup

2.2.2 Unsetup procedure

2.2.3 Uninstallation procedure

2.3 Changing the PFM - Agent for Enterprise Applications system configuration

2.4 Changing the PFM - Agent for Enterprise Applications operation method

2.4.1 Changing the performance data storage location

2.4.2 Updating the Store version to 2.0

2.4.3 Settings for updating an instance environment

2.5 Starting the command prompt

2.6 Backup and restoration

2.6.1 Backup

2.6.2 Restoration

2.7 Settings for using a Web browser to reference manuals

2.7.1 Settings procedures

2.7.2 Browsing procedure

3. Installation and Setup (In UNIX)

3.1 Installation and setup

3.1.1 Before installation and setup

3.1.2 Flow of tasks for installation and setup

3.1.3 Installation procedure

3.1.4 PFM - Agent for Enterprise Applications setup procedure

3.2 Uninstallation and unsetup

3.2.1 Before uninstallation and unsetup

3.2.2 Unsetup procedure

3.2.3 Uninstallation procedure

3.3 Changing the PFM - Agent for Enterprise Applications system configuration

3.4 Changing the PFM - Agent for Enterprise Applications operation method

3.4.1 Changing the performance data storage location

3.4.2 Updating the Store version to 2.0

3.4.3 Settings for updating an instance environment

3.5 Backup and restoration

3.5.1 Backup

3.5.2 Restoration

3.6 Settings for using a Web browser to reference manuals

3.6.1 Settings procedures

3.6.2 Browsing procedure

4. Operation in a Cluster System

4.1 Overview of cluster systems

4.1.1 HA cluster systems

4.2 Processing at failover

4.2.1 Failover when an error occurs on a PFM - Agent host

4.2.2 Effects of PFM - Manager failure

4.3 Installation and setup

4.3.1 In SAP NetWeaver 7.0 or later (in Windows)

4.3.2 In SAP NetWeaver 7.0 or later (in UNIX)

4.3.3 In SAP NetWeaver 2004 or earlier (in Windows)

4.3.4 In SAP NetWeaver 2004 or earlier (in UNIX)

4.4 Uninstallation and Unsetup

4.4.1 In SAP NetWeaver 7.0 or later (in Windows)

4.4.2 In SAP NetWeaver 7.0 or later (in UNIX)

4.4.3 In SAP NetWeaver 2004 or earlier (in Windows)

4.4.4 In SAP NetWeaver 2004 or earlier (in UNIX)

4.5 Changing the system configuration of PFM - Agent for Enterprise Applications

4.6 Changing the PFM - Agent for Enterprise Applications operation method

4.6.1 Settings for updating an instance environment

5. Extracting System Log Information

5.1 Overview of the system log information extraction function

5.2 Extracting system log information

5.2.1 Setup

5.2.2 Output example

5.3 Environment parameters file

5.3.1 Setup procedure

5.3.2 Settings

5.4 Using a command to extract system log information

5.4.1 Before executing the command

5.4.2 Using the command to extract system log information

5.4.3 Environment parameters file for extracting system log information by command execution

6. Extracting CCMS Alert Information

6.1 Overview of the CCMS alert information extraction function

6.2 Extracting CCMS alert information

6.2.1 Setup

6.2.2 Output example

6.3 Environment parameters file

6.3.1 Setup procedure

6.3.2 Settings

6.4 Using a command to extract CCMS alert information

6.4.1 Before executing the command

6.4.2 Using the command to extract CCMS alert information

6.4.3 Environment parameters file for extracting CCMS alert information by command execution

7. Collecting Monitor Information

7.1 Overview of collecting monitor information

7.2 Settings for collecting monitor information

7.2.1 Setting a monitor set name and a monitor name

7.2.2 Settings for performance data collection

Part 3: Reference

8. Monitoring Template

Overview of the monitoring template

Format of alarm explanations

List of alarms

Buffer - CUA

Buffer - FieldDescri

Buffer - GenericKey

Buffer - InitialReco

Buffer - Program

Buffer - Screen

Buffer - ShortNameTA

Buffer - SingleRecor

Buffer - TableDefini

Dialog ResponseTime

Extended Memory

Heap Memory

Paging Area

Roll Area

SystemWideQueue

ServerSpecificQueue

Utilization % (alarm for monitoring the average usage of background work processes)

QueueLength %

Utilization % (alarm for monitoring the average usage of dialog processes)

Format of report explanations

Organization of report folders

List of reports

Dialog ResponseTime

Dialog ResponseTime Status

Dialog ResponseTime Trend (hourly historical report)

Dialog ResponseTime Trend (daily historical report)

Dialog ResponseTime Trend (Multi-Agent)

Dialog Utilization %

Process Detail

Process Overview Status

SAP Buffer Detail (CUA)

SAP Buffer Detail (FieldDescription)

SAP Buffer Detail (GenericKey)

SAP Buffer Detail (InitialRecords)

SAP Buffer Detail (Program)

SAP Buffer Detail (Screen)

SAP Buffer Detail (ShortNameTAB)

SAP Buffer Detail (SingleRecord)

SAP Buffer Detail (TableDefinition)

SAP Buffer Hitratio

SAP Buffer Hitratio Status

SAP Buffer Hitratio Trend (hourly historical report)

SAP Buffer Hitratio Trend (daily historical report)

SAP Memory Detail

SAP Memory Used

SAP Memory Used Status

SAP Memory Used Trend (hourly historical report)

SAP Memory Used Trend (daily historical report)

UsersLoggedIn Trend (hourly historical report)

UsersLoggedIn Trend (daily historical report)

UsersLoggedIn Trend (Multi-Agent)

Background Processing SystemWideQueue

Background Service ServerSpecificQueue

Background Service Utilization %

9. Records

Data model

Format of record explanations

List of ODBC key fields

Summary rules

List of data types

Field values

Fields added only when data is stored in the Store database

Notes about records

List of records

Background Processing (PI_BTCP)

Background Service (PI_BTC)

CCMS Alert Monitor Command (PD_ALMX)

Dialog Service (PI_DIA)

Enqueue Service (PI_ENQ)

SAP Buffer Summary (PI_BUFF)

SAP Instance Summary (PD_SRV)

SAP Memory Summary (PI_MEM)

Spool Service (PI_SPO)

System Log Monitor Command (PD_SLMX)

Update1 Service (PI_UPD1)

Update2 Service (PI_UPD2)

User defined Monitor (Perf.) (PI_UMP)

Work Process Summary (PD)

WorkLoad Summary Interval (PI)

10. Commands

Format of command explanations

List of commands

jr3alget

jr3slget

11. Messages

11.1 Message format

11.1.1 Format of output messages

11.1.2 Format of message explanations

11.2 Message output destinations

11.3 Messages output to syslog and Windows event log

11.4 Messages

Part 4: Troubleshooting

12. Error Handling Procedures

12.1 Error handling procedures

12.2 Troubleshooting

12.2.1 Setting up or starting services

12.2.2 Executing commands

12.2.3 Report definitions

12.2.4 Alarm definitions

12.2.5 Collecting and managing performance data

12.2.6 Other problems

12.3 Log information

12.3.1 Log information types

12.3.2 Log files and directories

12.4 Data to be collected in the event of an error

12.4.1 In Windows

12.4.2 In UNIX

12.5 Data collection procedure

12.5.1 In Windows

12.5.2 In UNIX

12.6 Detecting problems within Performance Management

12.7 Performance Management system error recovery

Appendixes

A. System Estimates

A.1 Memory requirements

A.2 Disk space requirements

A.3 Disk space requirements for cluster use

B. Kernel Parameters

C. List of Identifiers

D. List of Processes

E. List of Port Numbers

E.1 Port numbers of Performance Management

E.2 Firewall passage directions

F. Properties of PFM - Agent for Enterprise Applications

F.1 List of Agent Store service properties

F.2 List of Agent Collector service properties

G. List of Files and Directories

G.1 In Windows

G.2 In UNIX

H. Migration Steps and Notes on Migration

I. Version Compatibility

J. Outputting Action Log Data

J.1 Types of events output to the action log

J.2 Format for saving the action log files

J.3 Format of output action log data

J.4 Settings for outputting action log data

K. Version Changes

K.1 Changes in version 09-00

K.2 Changes in version 08-00

L. Glossary

Index

All Rights Reserved. Copyright (C) 2010, Hitachi, Ltd.