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
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:
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
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
SAP Adapter Installation and Configuration Guide
4 VMware, Inc.
SAP Adapter Installation and Configuration Guide
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
SAP Adapter Installation and Configuration Guide
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
SAP Adapter Installation and Configuration Guide
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.
SAP Adapter Installation and Configuration Guide
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
SAP Adapter Installation and Configuration Guide
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.
This chapter includes the following topics:
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
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.
SAP Adapter Installation and Configuration Guide
14 VMware, Inc.
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.
7 Log in to the Custom user interface as an administrator.
For example: https://ipaddress/vcops-custom/
8 Select Admin > Support.
9 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.
10 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.
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.
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
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 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 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 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, 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.
SAP Adapter Installation and Configuration Guide
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
1 Log in to the Custom user interface as an administrator.
2 Select Admin > Support.
3 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.
4 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.
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
SAP Adapter Installation and Configuration Guide
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.
This chapter includes the following topics:
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
1 Log in to the Custom user interface as an administrator.
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
1 Log in to the Custom user interface as an administrator.
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.
SAP Adapter Installation and Configuration Guide
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.
SAP Adapter Installation and Configuration Guide
22 VMware, Inc.
Troubleshooting the SAP Adapter 4Known troubleshooting information can help you diagnose and correct problems with the SAP adapter.
This chapter includes the following topics:
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.
SAP Adapter Installation and Configuration Guide
24 VMware, Inc.
SAP Performance Metrics 5The SAP adapter can collect certain performance metrics from an SAP server.
This chapter includes the following topics:
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
Dialog Overview MetricsTable 5-2. Dialog Overview Metric Descriptions
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
SAP Adapter Installation and Configuration Guide
26 VMware, Inc.
Gateway Summary MetricsTable 5-4. Gateway Summary Metric Descriptions
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
Filesystem Freespace FREESPACE
Filesystem Percentage Used PERCENTAGE_USED
CPU MetricsTable 5-10. CPU Metric Descriptions
Metric Name Metric Name in SAP
CPU:Average usage CPU_UTILIZATION
CPU:Average number of waiting processes 5MINLOADAVERAGE
SAP Adapter Installation and Configuration Guide
28 VMware, Inc.
Swap Space MetricsTable 5-11. Swap Space Metric Descriptions
Metric Name Metric Name in SAP
Available swap space FREESPACE
Percentage of swap space used PERCENTAGE_USED
Paging MetricsTable 5-12. Paging Metric Descriptions
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
Available commit charge COMMITCHARGEFREE
Used commit charge COMMIT_PERCENT
LAN MetricsTable 5-14. LAN Metric Descriptions
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Chapter 5 SAP Performance Metrics
VMware, Inc. 29
Table 5-15. Spool Metric Descriptions (Continued)
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
Metric Name Metric Name in SAP
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
SAP Adapter Installation and Configuration Guide
30 VMware, Inc.
n Field Description
n Initial Records
n ShortnameTAB
Table 5-18. Buffer Metric Descriptions
Metric Name Metric Name in SAP
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
Chapter 5 SAP Performance Metrics
VMware, Inc. 31
SAP Adapter Installation and Configuration Guide
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
SAP Adapter Installation and Configuration Guide
34 VMware, Inc.