sap adapter installation and configuration guide adapter installation and configuration guide...

SAP Adapter Installation andConfiguration Guide

vCenter Operations Manager 1.0

This document supports the version of each product listed andsupports all subsequent versions until the document is replacedby a new edition. To check for more recent editions of thisdocument, see http://www.vmware.com/support/pubs.

EN-000898-04

http://www.vmware.com/support/pubs

SAP Adapter Installation and Configuration Guide

2 VMware, Inc.

You can find the most up-to-date technical documentation on the VMware Web site at:

http://www.vmware.com/support/

The VMware Web site also provides the latest product updates.

If you have comments about this documentation, submit your feedback to:

[email protected]

Copyright © 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectualproperty laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents.

VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marksand names mentioned herein may be trademarks of their respective companies.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

http://www.vmware.com/support/

mailto:[email protected]

http://www.vmware.com/go/patents

Contents

SAP Adapter Installation and Configuration Guide 5

Updated Information 7

1 Introduction to the SAP Adapter 9

How the Adapter Collects Data 9Installation and Configuration Requirements 9SAP Adapter Resource Identification 11

2 Installing the SAP Adapter 13

Overview of Installation Steps 13Installing the SAP Adapter Files 13Installing the SAP JCo Files 15Redescribe the SAP Adapter 17SAP Adapter Folders and Files 17

3 Configuring the SAP Adapter 19

Add an Adapter Instance 19Add an SAP Resource 20

4 Troubleshooting the SAP Adapter 23

Troubleshooting an SAP Adapter Instance 23Viewing System Log Files 23SAP Adapter Classes 24

5 SAP Performance Metrics 25

SAP Metric Descriptions 25Entire System Metrics 25Logon Load Balancing Metrics 27Performance Overview Metrics 28Operating System Metrics 28Spool Metrics 29Background Processing Metrics 30Buffer Metrics 30

Index 33

VMware, Inc. 3


4 VMware, Inc.


The SAP Adapter Installation and Configuration Guide describes how to install the SAP adapter forvCenter Operations Manager.

Intended AudienceThis information is intended for anyone who needs to install and configure the SAP adapter.

VMware, Inc. 5


6 VMware, Inc.

Updated Information

The SAP Adapter Installation and Configuration Guide is updated with each release of the product or whennecessary.

This table provides the update history of the SAP Adapter Installation and Configuration Guide.

Revision Description

EN-000898-04 Updated for the 5.6 release. No substantive changes.

EN-000898-03 Updated the SAP metrics and added links to the SAP documentation in Chapter 5, “SAP PerformanceMetrics,” on page 25.

EN-000898-02 n Updated the credential requirements in “Installation and Configuration Requirements,” on page 9.n Updated the installation steps in “Install the SAP Adapter Files in a Standalone Installation,” on

page 13 and “Install the SAP Adapter Files in a vApp Installation,” on page 14.n Updated the installation steps in “Install the SAP JCo Files in a Standalone Installation on Windows,”

on page 15 and “Install the SAP JCo Files in a Standalone Installation on Linux,” on page 16.n Added troubleshooting steps for Linux and vApp installations to “Troubleshooting an SAP Adapter

Instance,” on page 23.

EN-000898-01 n Updated the installation and configuration requirements. See “Installation and ConfigurationRequirements,” on page 9.

n Added SAP Java Connector (JCo) file installation instructions for Linux. See “Install the SAP JCo Filesin a Standalone Installation on Linux,” on page 16.

EN-000898-00 Initial release.

VMware, Inc. 7


8 VMware, Inc.

Introduction to the SAP Adapter 1The SAP adapter is an embedded adapter for vCenter Operations Manager. The adapter uses SAP BAPI callsto collect metrics from an SAP server.

This chapter includes the following topics:

n “How the Adapter Collects Data,” on page 9

n “Installation and Configuration Requirements,” on page 9

n “SAP Adapter Resource Identification,” on page 11

How the Adapter Collects DataWhen you configure the SAP adapter, you define an adapter instance and add an SAP resource. The adapterinstance acts as a data collection trigger and the SAP resource represents an SAP server.

You can add multiple SAP resources to the same SAP adapter instance. The SAP adapter does not supportmanual or auto discovery of resources.

You define the metrics that the SAP adapter collects from an SAP server in an attribute package that you assignto the SAP resource. The adapter collects metrics only for the attributes in the attribute package.

During each data collection cycle, the SAP adapter opens a connection and logs in to the SAP server representedby the SAP resource. After logging in, the adapter requests metrics for the attributes in the attribute packagethat you assigned to the SAP resource. When multiple SAP resources are associated with the same adapterinstance, the adapter processes each resource sequentially.

The collection interval for the adapter instance resource determines the data polling interval for all of its SAPresources. The default collection interval is five minutes.

Installation and Configuration RequirementsThe SAP adapter has certain installation and configuration requirements.

Compatible SAP VersionsThe SAP adapter is compatible with the following SAP versions:

n SAP R/3 4.7

n SAP ECC 5.0 and 6.0

n SAP NetWeaver 7.0, ABAP + BASIS Support Package level 20

VMware, Inc. 9

SAP Java Connector File RequirementsYou must download certain SAP Java Connector (JCo) files from the SAP Web site. The SAP JCo files mustmatch the machine and JRE processor architecture and come from the same SAP library package. In aStandalone installation, you must copy the files to folders on the vCenter Operations Manager server. In avApp installation, you must copy the files to folders on the Analytics virtual machine.

Table 1-1. SAP JCo Files for Windows

File Folder

sapjco.jar vcenter-ops/user/plugins/inbound/sap_adapter3/lib

sapjcorfc.dll vcenter-ops/common/bin

librfc32.dll Windows/system32

Table 1-2. SAP JCo Files for Linux

File Folder

sapjco.jar vcenter-ops/user/plugins/inbound/sap_adapter3/lib

libsapjcorfc.so vcenter-ops/common/bin

librfccm.so vcenter-ops/common/bin

On a 64-bit Linux system, the SAP adapter requires the libstdc++.so.5 file to be in the /user/lib64 folder.The SAP adapter generates an error if this shared library file is not present. libstdc++.so.5 is a symbolic linkto the main .so file, for example, libstdc++.so.5.0.7.

The SAP adapter is compatible with SAP JCo 2.1.x. The SAP adapter does not support SAP JCo 3.0.8.

Compatible Java VersionsThe SAP adapter is tested with Java versions 1.6.0_07, 1.6.0_14, and 1.6.0_31.

vCenter Operations Manager Collector RequirementsThe SAP adapter requires a vCenter Operations Manager collector on a Windows or Linux server.

The SAP adapter supports Standalone and vApp installations on both local and remote collectors. The SAPadapter is tested with Windows 32-bit and 64-bit remote collectors and with Linux 64-bit collectors. The SAPadapter is not tested with Linux 32-bit collectors.

NOTE To use a remote collector with a vApp installation, you must work with your VMware ProfessionalServices representative.

SAP Credential RequirementsThe SAP adapter requires a user ID to connect to the host for the SAP server. You specify this user ID whenyou create a credential for the SAP adapter instance.

When you create a credential for the SAP adapter instance, you can specify an SAP user ID that has access toComputing Center Management System (CCMS) data. For information about assigning restricted roles, seethe SAP help.


10 VMware, Inc.

SAP Adapter Resource IdentificationThe SAP adapter uses certain resource identifiers. You must specify resource identifiers when you referenceSAP adapter resources with the vCenter Operations Manager API.

Adapter KindThe adapter kind for the SAP adapter is named SAP Adapter and the identifier key is SAP.

Adapter Instance Resource KindThe adapter instance resource kind for an SAP adapter instance is named SAP Adapter Instance and theidentifier key is SAPAdapter Instance.

SAP Adapter ResourcesThe SAP adapter creates a single resource kind named SAP Resource, which represents an SAP server. Theidentifier key for the SAP Resource resource kind is SAP. An SAP resource has several identifier keys.

Table 1-3. SAP Resource Identifier Keys

KeyPart ofUniqueness Default Name (en) Description

ashost Yes Host Host for the SAP server. Can be a host name or IP address.

client Yes Client ID SAP client ID.

sysnr Yes System Number SAP system number.

lang Yes Language Language code. The default is en.

Chapter 1 Introduction to the SAP Adapter

VMware, Inc. 11


12 VMware, Inc.

Installing the SAP Adapter 2Installing the SAP adapter involves downloading adapter files from the VMware FTP site and SAP JavaConnector (JCo) files from the SAP Web site. The procedure that you follow to install the files depends onwhether you have a vCenter Operations Manager Standalone or vApp installation.


n “Overview of Installation Steps,” on page 13

n “Installing the SAP Adapter Files,” on page 13

n “Installing the SAP JCo Files,” on page 15

n “Redescribe the SAP Adapter,” on page 17

n “SAP Adapter Folders and Files,” on page 17

Overview of Installation StepsInstalling the SAP adapter involves several steps. You must perform these steps in a particular order.

1 Install the SAP adapter files. See “Installing the SAP Adapter Files,” on page 13.

2 Install the SAP Java Connector (JCo) files. See “Installing the SAP JCo Files,” on page 15.

3 Redescribe the SAP adapter. See “Redescribe the SAP Adapter,” on page 17.

Installing the SAP Adapter FilesYou download the SAP adapter files from the VMware FTP site. How you install the SAP adapter files dependson whether you have a Standalone or vApp installation.

Install the SAP Adapter Files in a Standalone InstallationIf you have a standalone installation, you install the SAP adapter by extracting the adapter installation filesfrom a TGZ file and running an installation utility.

Prerequisites

n Download the adapter installation TGZ file anonymously from ftp://ftp.integrien.com/.

n Make a note of the build number in the TGZ file name. The build number appears after the adapter name,for example, adaptername-buildnumber.tgz.

n Read the release notes that are included with the TGZ file.

VMware, Inc. 13

ftp://ftp.integrien.com/

Procedure

1 Open the TGZ file and extract the TAR file to a temporary folder on your vCenter Operations Managerserver.

2 In the temporary folder, open the TAR file and extract and run the installer for your operating systemplatform.

3 Log in to the Custom user interface as an administrator.

4 Select Admin > Support.

5 On the Info tab, find the Adapters Info pane and click the Describe icon ( ).

The Describe icon is located at the top right of the Adapters Info pane.

6 Click Yes to start the describe process and click OK.

The Custom user interface finds the adapter files, gathers information about the abilities of the adapter,and updates the user interface with information about the adapter. If you have remote collectors, it installsthe adapter on the remote collectors.

The describe process might take several minutes. When the describe process is finished, the adapterappears in the Adapters Info pane. The build number is in the Adapter Version column.

7 Verify that the build number in the Adapter Version column for the adapter matches the build number inthe TGZ file that you downloaded.

The installation utility creates the sap_adapter3 folder and sap_adapter3.jar file in the vcenter-ops/user/plugins/inbound folder.

What to do next

Install the SAP JCo files. See “Installing the SAP JCo Files,” on page 15.

Install the SAP Adapter Files in a vApp InstallationIf you have a vApp installation, you install the SAP adapter from a PAK file.

Prerequisites

n Download the adapter installation PAK file anonymously from ftp://ftp.integrien.com.

n Make a note of the build number in the PAK file name. The build number appears after the adapter name,for example, adaptername-buildnumber.pak.

n Read the release notes that are included with the PAK file.

Procedure

1 Save the PAK file in a temporary folder.

2 Log in to the Admin user interface as the admin user.

For example: https://ipaddress/admin/

3 On the Update tab, click Browse to locate the temporary folder and select the PAK file.

4 Click Update and click OK to confirm the update.

The Admin user interface uploads the PAK file. The upload might take several minutes.

5 Read and accept the EULA and click OK.


14 VMware, Inc.

ftp://ftp.integrien.com

6 Click OK to confirm and start the update process.

The update might take several minutes. Status information appears on the Update tab when the updateis finished.


For example: https://ipaddress/vcops-custom/





The Custom user interface finds the adapter files, gathers information about the abilities of the adapter,and updates the user interface with information about the adapter.


11 Verify that the build number in the Adapter Version column for the adapter matches the build number inthe PAK file that you uploaded.

The installation process creates the sap_adapter3 folder and sap_adapter3.jar file in the vcenter-ops/user/plugins/inbound folder.

During the describe process, vCenter Operations Manager pushes the adapter to the remote collector.

What to do next

Install the SAP JCo files. See “Installing the SAP JCo Files,” on page 15.

Installing the SAP JCo FilesYou must download and install certain SAP JCo files for both Standalone and vApp installations. If you havea Standalone installation, the files that you must install depend on whether vCenter Operations Manager isinstalled on a Windows or Linux system.

Install the SAP JCo Files in a Standalone Installation on WindowsIf you have a vCenter Operations Manager Standalone installation on Windows, you must install certain JARand DLL files. The files must match the machine and JRE processor architecture of the server and come fromthe same SAP library package.

Prerequisites

n Verify that you have a user name and password to log in to the SAP Web site.

n Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of therequired files for Windows, see “Installation and Configuration Requirements,” on page 9.

Procedure

1 Copy the sapjco.jar file from the temporary folder to the vcenter-ops/user/plugins/inbound/sap_adapter3/lib folder on the vCenter Operations Manager server.

2 Copy the sapjcorfc.dll file from the temporary folder to the vcenter-ops/common/bin folder on thevCenter Operations Manager server.

3 Copy the librfc32.dll file from the temporary folder to the Windows/system32 folder on thevCenter Operations Manager server.

Chapter 2 Installing the SAP Adapter

VMware, Inc. 15

http://service.sap.com/connectors

What to do next

Redescribe the SAP adapter. See “Redescribe the SAP Adapter,” on page 17.

Install the SAP JCo Files in a Standalone Installation on LinuxIf you have a vCenter Operations Manager Standalone installation on Linux, you must install certain JAR andshared library (.so) files. The files must match the machine and JRE processor architecture of the server andcome from the same SAP library package.

Prerequisites


n Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of therequired files for Linux, see “Installation and Configuration Requirements,” on page 9.

Procedure

1 Copy the sapjco.jar file from the temporary folder to the vcenter-ops/user/plugins/inbound/sap_adapter3/lib folder on the vCenter Operations Manager server.

2 Copy the libsapjcorfc.so and librfccm.so files from the temporary folder to the vcenter-ops/common/bin folder on the vCenter Operations Manager server.

3 Verify that the libsapjcorfc.so and librfccm.so files have the same permissions as the other .so files inthe vcenter-ops/common/bin folder.

4 On a 64-bit Linux machine, verify that the libstdc++.so.5 file is in the /user/lib64 folder.

The SAP adapter generates an error if this library file is not present. libstdc++.so.5 is a symbolic link tothe main .so file, for example, libstdc++.so.5.0.7.

What to do next

Rescribe the SAP adapter. See “Redescribe the SAP Adapter,” on page 17.

Install the SAP JCo Files in a vApp InstallationIf you have a vCenter Operations Manager vApp installation, you must install certain JAR and shared library(.so) files in the Analytics virtual machine. The files must match the machine and JRE processor architectureof the Analytics virtual machine and come from the same SAP library package.

Prerequisites


n Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of therequired files, see “Installation and Configuration Requirements,” on page 9.

Procedure

1 Copy the sapjco.jar file from the temporary folder to the vcenter-ops/user/plugins/inbound/sap_adapter3/lib folder on the Analytics virtual machine.

2 Copy the libsapjcorfc.so and librfccm.so files from the temporary folder to the vcenter-ops/common/bin folder on the Analytics virtual machine.

3 Verify that the libsapjcorfc.so and librfccm.so files have the same permissions as the other .so files inthe vcenter-ops/common/bin folder.


16 VMware, Inc.



4 Verify that the libstdc++.so.5 file is in the /user/lib64 folder.

The SAP adapter generates an error if this library file is not present. libstdc++.so.5 is a symbolic link tothe main .so file, for example, libstdc++.so.5.0.7.

What to do next

Redescribe the SAP adapter. See “Redescribe the SAP Adapter,” on page 17.

Redescribe the SAP AdapterAfter you install the SAP JCo files, you must redescribe the SAP adapter.

Prerequisites

n Install the SAP adapter files. See “Installing the SAP Adapter Files,” on page 13

n Install the SAP JCo files. See “Installing the SAP JCo Files,” on page 15.

Procedure






The Custom user interface finds the adapter files, gathers information about the abilities of the adapter,and updates the user interface with information about the adapter. If you have remote collectors, it installsthe adapter on the remote collectors.


What to do next

Configure the SAP adapter. See Chapter 3, “Configuring the SAP Adapter,” on page 19.

SAP Adapter Folders and FilesThe installer places the SAP adapter files in the sap_adapter3 folder.

The sap_adapter3 folder contains several subfolders and files.

Table 2-1. SAP Adapter Folders and Files

Folder File Description

conf configuration.properties Main adapter configuration file.

describe.xml Describes the adapter.

history.txt Contains the history of the adapter changes.

version.tx Contains version information.

lib sapjco.jar SAP library file.IMPORTANT This file is not included with the SAP adapter. You mustdownload this file from the SAP Web site. See “Installing the SAPJCo Files,” on page 15.

Chapter 2 Installing the SAP Adapter

VMware, Inc. 17


18 VMware, Inc.

Configuring the SAP Adapter 3Configuring the SAP adapter involves creating an adapter instance and credential, adding an SAP resource torepresent an SAP server, and creating an attribute package to define the metrics that the adapter collects fromthe SAP server.


n “Add an Adapter Instance,” on page 19

n “Add an SAP Resource,” on page 20

Add an Adapter InstanceYou must create an adapter instance for the SAP adapter. The adapter instance defines the adapter type.

Prerequisites

n Install the SAP adapter. See Chapter 2, “Installing the SAP Adapter,” on page 13.

n Create a credential, or, if you plan to create a credential when you add the adapter instance, becomefamiliar with creating credentials. See “Add a Credential,” on page 20.

Procedure


2 Select Environment > Configuration > Adapter Instances.

3 Select the collector to use from the Collector drop-down menu.

Unless you added additional collectors, the only available collector is vCenter Operations Server. Youcan change the name of this collector when you install the standalone version.

4 Select SAP Adapter from the Adapter Kind drop-down menu.

5 Click the Add New Adapter Instance icon.

6 Type a name for the adapter in the Adapter Instance Name text box.

7 Select the credential to use to sign on to the data source from the Credential drop-down menu, or clickAdd to add a new credential.

8 Click OK to save your configuration.

What to do next

Add an SAP resource. See “Add an SAP Resource,” on page 20.

VMware, Inc. 19

Add a CredentialThe SAP adapter needs a user name and password to connect to the host for the SAP server. You use this username and password to create a credential for the adapter instance in vCenter Operations Manager.

You can add the credential before you create the adapter instance and select the correct credential when youdefine the adapter instance, or you can add the credential when you define the adapter instance.

Prerequisites

Install the SAP adapter. See Chapter 2, “Installing the SAP Adapter,” on page 13.

Procedure


2 Select Environment > Configuration > Credentials.

3 Select SAP Adapter from the Adapter Kind drop-down menu.

4 Select Credential from the Credential Kind drop-down menu.

5 At the top of the list of credentials, next to Action, click Add.

6 Type a unique name for the credential instance in the Instance name text box.

7 In the User name and Password text boxes, type the user name and password for the host for the SAPserver.

8 Click OK to add the credential for the adapter kind.

The credential appears in the list in the Manage Credentials window.

Add an SAP ResourceYou must add an SAP resource to represent an SAP server. You can add multiple SAP resources to the sameSAP adapter instance.

Prerequisites

n Add an adapter instance. See “Add an Adapter Instance,” on page 19.

n Create an attribute package to define the metrics that the SAP resource collects, or, if you plan to createan attribute package when you add the SAP resource, become familiar with creating attribute packages.See “Add an Attribute Package,” on page 21.

Procedure

1 Select Environment > Environment Overview.

2 On the List tab, click the Add Resource icon.

3 Type a name for the resource in the Resource name text box.

Use only letters and numbers in the resource name. Do not use nonalphanumeric characters or spaces.The resource description is for informational purposes only.

4 (Optional) Type a description of the resource in the Resource description text box.

5 Select SAP Adapter from the Adapter kind drop-down menu.

6 Select the SAP adapter instance from the Adapter instance drop-down-menu.

7 Select SAP Resource from the Resource kind drop-down menu.


20 VMware, Inc.

8 Provide SAP server connection information.

The SAP adapter uses this information to connect to the SAP server.

Option Description

Host Host for the SAP server. Can be a host name or IP address.

Client ID SAP client ID.

System Number SAP system number.

9 (Optional) Change the language code, if necessary.

The default language code is en.

10 Select the attribute package that defines the metrics that the SAP resource collects from the Attributepackage drop-down menu, or click Add to add a new attribute package.

11 Type the collection interval, in minutes, in the Collection Interval (Minutes) text box.

For example, if you expect the resource to generate performance data every 30 minutes, set the collectioninterval to 30 minutes.

The collection interval for a resource influences the collection status for that resource. The collectioninterval for the adapter instance resource determines how often to collect data. For example, if thecollection interval for the adapter instance resource is set to five minutes, setting the collection intervalfor a resource to 30 minutes prevents the resource from having the No Data Receiving collection statusafter five collection cycles (25 minutes).

12 Click OK to add the resource.

13 Start metric collection for the resource.

a Select Environment > Enviroment Overview.

b On the List tab, select the SAP resource.

c Click the Start Collecting icon to start metric collection for the SAP resource.

Add an Attribute PackageYou define the metrics that the SAP adapter collects in an attribute package that you assign to an SAP resource.The SAP adapter collects metrics only for the attributes in the attribute package.

You can add the attribute package before you create the SAP resource and select it when you define the SAPresource, or you can add the attribute package when you define the SAP resource.

Prerequisites

Become familiar with the SAP performance metrics. See Chapter 5, “SAP Performance Metrics,” onpage 25.

Procedure

1 Select Environment > Configuration > Attribute Packages.

2 Select SAP Adapter from the Adapter kind drop-down menu.

3 Select SAP Resource from the Resource kind drop-down menu.

4 Click the Add New Attribute Package icon.

5 Type a name for the attribute package in the Package name text box.

Chapter 3 Configuring the SAP Adapter

VMware, Inc. 21

6 Type a collection interval value, in minutes, in the Collection Interval (mins) text box.

For example, if you expect the resource to generate performance data every 30 minutes, set the collectioninterval to 30 minutes.

The collection interval for a resource influences the collection status for that resource. The collectioninterval for the adapter instance resource determines how often to collect data. For example, if thecollection interval for the adapter instance resource is set to five minutes, setting the collection intervalfor a resource to 30 minutes prevents the resource from having the No Data Receiving collection statusafter five collection cycles (25 minutes).

NOTE The collection interval that you set for the SAP resource overrides the collection interval in theattribute package that you assign to the SAP resource.

7 Select the check box next to each attribute to include in the package.

8 For each attribute, select whether a violation of the upper or lower dynamic threshold is a KPI.

9 Click OK to return to the Manage Attribute Packages window.

10 Click OK to save the attribute package.


22 VMware, Inc.

Troubleshooting the SAP Adapter 4Known troubleshooting information can help you diagnose and correct problems with the SAP adapter.


n “Troubleshooting an SAP Adapter Instance,” on page 23

n “Viewing System Log Files,” on page 23

n “SAP Adapter Classes,” on page 24

Troubleshooting an SAP Adapter InstancePerform these general troubleshooting steps to diagnose and correct problems with an SAP adapter instance.

1 Verify that you can connect to the host for the SAP server.

2 View the collection status and collection state of the SAP adapter instance resource on the EnvironmentOverview page in the Custom user interface.

3 Check the adapter and collector logs for errors. See “Viewing System Log Files,” on page 23.

For Linux and vApp installations, perform these additional steps:

1 Verify that libstdc++.so.5 is linked to the correct version of the specific libstdc5 library, for example,libstdc++.so.5.0.7. On a 64-bit Linux machine, verify that the 64-bit version of the library is installed.

2 Make sure that you redescribed the SAP adapter after you installed the SAP libraries or libstdc++.so.5.For more information, see “Redescribe the SAP Adapter,” on page 17.

Viewing System Log FilesYou can view SAP adapter errors in the vCenter Operations Manager adapter and collector log files in . Youcan view log files in the Custom user interface or in an external log viewer.

The SAP adapter log files are in the vcenter-ops/user/log/adapters/SAPAdapter folder. The collector log fileis in the vcenter-ops/user/log folder.

The logging level is set to ERROR by default. To troubleshoot issues, set the logging level to INFO. To viewdetailed messages, including micro steps, queries, and returned results, set the logging level to DEBUG.

NOTE If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level toDEBUG only for short periods of time.

For information about viewing log files and modifying logging levels, see the online help.

VMware, Inc. 23

SAP Adapter ClassesThe SAP adapter uses certain adapter classes.

Table 4-1. SAP Adapter Classes

Class Description

com.integrien.adapter3.sap.SAPAdapter Main adapter logic.

com.integrien.adapter3.sap.AdapterUtility Main utility class.

com.integrien.adapter3.sap.GenericMonitorBean Monitor bean class.

com.integrien.adapter3.sap.SAPAdapterConnectionPoolCreator Connection pool creator.

com.integrien.adapter3.sap.SapAdapterProperties Property file loader.

com.integrien.adapter3.sap.SAPConPoolRepos SAP connection pool.


24 VMware, Inc.

SAP Performance Metrics 5The SAP adapter can collect certain performance metrics from an SAP server.


n “SAP Metric Descriptions,” on page 25

n “Entire System Metrics,” on page 25

n “Logon Load Balancing Metrics,” on page 27

n “Performance Overview Metrics,” on page 28

n “Operating System Metrics,” on page 28

n “Spool Metrics,” on page 29

n “Background Processing Metrics,” on page 30

n “Buffer Metrics,” on page 30

SAP Metric DescriptionsFor descriptions of SAP metrics, see the SAP documentation.

SAP NetWeaverVersion Documentation Link

7.0 http://help.sap.com/saphelp_nw2004s/helpdata/en/d4/cc823bd26a5c42e10000000a114084/frameset.htm

7.3 http://help.sap.com/saphelp_nw73/helpdata/en/2d/83493b6b82e908e10000000a11402f/frameset.htm

Entire System MetricsEntire system metrics show the performance of the entire SAP system.

Enqueue MetricsTable 5-1. Enqueue Metric Descriptions

Metric Name Metric Name in SAP

Percentage length of the queue QueueLength

Number of errors in the enqueue work processes EndedWpENQ

Enqueue operations per minute ErrorsInWpENQ

Utilization of the enqueue server ErrorFreqInWpENQ

VMware, Inc. 25

http://help.sap.com/saphelp_nw2004s/helpdata/en/d4/cc823bd26a5c42e10000000a114084/frameset.htm

http://help.sap.com/saphelp_nw73/helpdata/en/2d/83493b6b82e908e10000000a11402f/frameset.htm

Dialog Overview MetricsTable 5-2. Dialog Overview Metric Descriptions


Dialog response time ResponseTime

Front end wait time FrontendResponseTime

Queue time QueueTime

Load generation time Load+GenTime

DB Request Time DBRequestTime

Dialog Utilization Utilisation

Percentage of dialog work processes in PRIV mode PrivMode Utilisation

Number of dialog work processes NumberOfWPDia

Errors in dialog work processes ErrorsInWpDIA

Number of completed dialog work processes EndedWpDIA

Number of errors in dialog work processes per minute ErrorFreqInWpDIA

Long runners LongRunners

Perentage length of Wait queue QueueLength

Log on Load Quality LogonLoadQuality

Dialog steps DialogSteps

Gui call back time GuiCallBackTime

Front end network time FrontendNetTime

Standardized response time ResponseTime(StandardTran.)

Update MetricsTable 5-3. Update Metric Descriptions


SAP update task V1: response time ResponseTime

SAP update task V1: wait time QueueTime

SAP Update Task V1: Percentage load for update task workprocess

Utilisation

Number of update1 work processes NumberOfWpUD1

Number of errors in update 1 work processes ErrorsInWpUD1

SAP update task V2: response time ResponseTime

SAP update task V2: wait time QueueTime

SAP Update Task V2: Percentage load for update task workprocesses

Utilisation

Number of update2 work processes NumberOfWpUD2

Number of errors in update 2 work processes ErrorsInWpUD2

Update requests containing errors AbapErrorInUpdate


26 VMware, Inc.

Gateway Summary MetricsTable 5-4. Gateway Summary Metric Descriptions


Gateway Clients Gateway_Clients

Gateway Connections Gateway_Connections

Gateway Remote Gateways Gateway_RemGateways

Gateway Communication Entries Gateway_CommAdmEnty

Gateway Work Processes Gateway_Workprocess

Gateway Malloc Failed Gateway_MallocFailed

Gateway Overflow Usage Gateway_OverflowUsage

Gateway Overflow Exceeded Gateway_OverflowExceeded

SysLog MetricsTable 5-5. SysLog Metric Descriptions


BasisSystem BasisSystem

Database Database

CCMS CCMS

Background Background

Communication Communication

Spool Spool

Security Security

Transport System Transport System

Batch Input Batch Input

Applications Applications

Customer Customer

Miscellaneous Miscellaneous

SyslogFreq SyslogFreq

Logon Load Balancing MetricsLogon load balancing metrics show user login performance.

Table 5-6. Logon Load Balancing Metric Descriptions


Number of logged-on users UsersLoggedIn

Response Time ResponseTime

Log on load quality LogonLoadQuality

Chapter 5 SAP Performance Metrics

VMware, Inc. 27

Performance Overview MetricsPerformance overview metrics show dialog service and memory use.

Dialog MetricsTable 5-7. Dialog Metric Descriptions


Response time of the dialog service ResponseTime

Number of users logged on UsersLoggedIn

Average time in the dispatcher wait queue QueueTime

Average load and generation time of GUI objects Load+GenTime

Average time for processing logical database requests DBRequestTime

Memory Management MetricsTable 5-8. Memory Management Metric Descriptions


Currently used roll area R3RollUsed

Extended memory EsAct

Amount allocated to heap memory currently HeapAct

Swap rate of the program buffer Program\\Swap

Operating System MetricsOperating system metrics show operating system performance.

Filesystem MetricsTable 5-9. Filesystem Metric Descriptions


Filesystem Freespace FREESPACE

Filesystem Percentage Used PERCENTAGE_USED

CPU MetricsTable 5-10. CPU Metric Descriptions


CPU:Average usage CPU_UTILIZATION

CPU:Average number of waiting processes 5MINLOADAVERAGE


28 VMware, Inc.

Swap Space MetricsTable 5-11. Swap Space Metric Descriptions


Available swap space FREESPACE

Percentage of swap space used PERCENTAGE_USED

Paging MetricsTable 5-12. Paging Metric Descriptions


Paging:Page-in:Pages per second PAGE_IN

Paging:Page-out:Pages per second PAGE_OUT

Commit Charge MetricsTable 5-13. Commit Charge Metric Descriptions


Available commit charge COMMITCHARGEFREE

Used commit charge COMMIT_PERCENT

LAN MetricsTable 5-14. LAN Metric Descriptions


LAN -- Packets in:Packets per second PACKETS_IN

LAN -- Packets out:Packets per second PACKETS_OUT

LAN -- Number of collisions COLLISIONS

Spool MetricsSpool metrics show the performance of the spool service and spool work processes.

Table 5-15. Spool Metric Descriptions


Percentage usage of the spool numbers UsedNumbers

Wait Time in spool service WaitTime

Spool Utilization Utilisation

Number of spool work processes NumberOfWpSPO

Number of errors in spool work processes ErrorsInWpSPO

Number of errors in spool work processes per minute ErrorFreqInWpSPO

Number of spool work processes that terminated after errors EndedWpSPO

Used area of the dispatcher queue as a percentage QueueLength


VMware, Inc. 29

Table 5-15. Spool Metric Descriptions (Continued)


Used area of the spool request queue as a percentage ServiceQueue

Used area of the spool request queue for processing ServiceQueuePriv

Number of pages in the spool request queue ServiceQueuePages

Used area of the entire device cache as a percentage DeviceCacheUsed

Used area of the fixed device cache as a percentage DeviceCacheFixed

Used area of the host spool request list as a percentage HostspoolListUsed

Background Processing MetricsBackground processing metrics show batch job performance and batch processing capacity.

System WideTable 5-16. System Wide Background Processing Metric Descriptions


Number of jobs that are ready to be executed SystemWideQueueLength

System-wide number of background work processes SystemWideClassABPWP

Number of free background work processes SystemWideFreeBPWP

Number of background work processes SystemWideTotalBPWP

Background Processing ServersTable 5-17. Background Processing Servers Background Processing Metric Descriptions


Utilization Utilisation

Number of background work processes NumberOfWpBTC

Number of errors in background work processes ErrorsInWpBTC

Number of errors in background work processes per minute ErrorFreqInWpBTCErrorFreqInWpBTC

Number of background work processes terminated after anerror

EndedWpBTC

Buffer MetricsBuffer metrics show the performance of the SAP buffers.

Buffer metrics apply to the following groups:

n Program

n Generic Key

n Single Record

n Screen

n CUA

n Table Definition


30 VMware, Inc.

n Field Description

n Initial Records

n ShortnameTAB

Table 5-18. Buffer Metric Descriptions


Percentage usage of the directory DirectoryUsed

Percentage usage of the buffer storage SpaceUsed

Percentage of the database queries HitRatio

Swaps due to a full buffer per minute Swap


VMware, Inc. 31


32 VMware, Inc.

Index

Aadapter classes 24adapter instances 19attribute packages 21audience information 5

Bbackground processing metrics 30buffer metrics 30

Cconfiguration steps 19credentials 20

Ddata collection 9

Iinstallation steps 13installing the adapter 13, 14introduction 9

JJCo files 15

Llibrfc32.dll 15librfccm.so 16libsapjcorfc.so 16log files 23logon load balancing metrics 27

Mmetric descriptions 25

Ooperating system metrics 28

Pperformance overview metrics 28

Rredescribing the SAP adapter 17requirements 9resource identification 11

SSAP performance metrics 25SAP resources 20sap_adapter3 folder 17sapjco.jar 15, 16sapjcorfc.dll 15spool metrics 29system metrics 25

Ttroubleshooting steps 23

Uupdated information 7

VMware, Inc. 33


34 VMware, Inc.

sap adapter installation and configuration guide adapter installation and configuration guide...

Documents