SAP Adapter Installation and Configuration Guide vcenter Operations Manager 1.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs. EN-000898-04
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: docfeedback@vmware.com Copyright 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property 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 marks and names mentioned herein may be trademarks of their respective companies. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc.
Contents SAP Adapter Installation and Configuration Guide 5 Updated Information 7 1 Introduction to the SAP Adapter 9 How the Adapter Collects Data 9 Installation and Configuration Requirements 9 SAP Adapter Resource Identification 11 2 Installing the SAP Adapter 13 Overview of Installation Steps 13 Installing the SAP Adapter Files 13 Installing the SAP JCo Files 15 Redescribe the SAP Adapter 17 SAP Adapter Folders and Files 17 3 Configuring the SAP Adapter 19 Add an Adapter Instance 19 Add an SAP Resource 20 4 Troubleshooting the SAP Adapter 23 Troubleshooting an SAP Adapter Instance 23 Viewing System Log Files 23 SAP Adapter Classes 24 5 SAP Performance Metrics 25 SAP Metric Descriptions 25 Entire System Metrics 25 Logon Load Balancing Metrics 27 Performance Overview Metrics 28 Operating System Metrics 28 Spool Metrics 29 Background Processing Metrics 30 Buffer Metrics 30 Index 33 VMware, Inc. 3
4 VMware, Inc.
The SAP Adapter Installation and Configuration Guide describes how to install the SAP adapter for vcenter Operations Manager. Intended Audience This 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 when necessary. This table provides the update history of the SAP Adapter Installation and Configuration Guide. Revision EN-000898-04 EN-000898-03 Description Updated for the 5.6 release. No substantive changes. Updated the SAP metrics and added links to the SAP documentation in Chapter 5, SAP Performance Metrics, on page 25. EN-000898-02 Updated the credential requirements in Installation and Configuration Requirements, on page 9. 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. 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. Added troubleshooting steps for Linux and vapp installations to Troubleshooting an SAP Adapter Instance, on page 23. EN-000898-01 Updated the installation and configuration requirements. See Installation and Configuration Requirements, on page 9. Added SAP Java Connector (JCo) file installation instructions for Linux. See Install the SAP JCo Files in a Standalone Installation on Linux, on page 16. EN-000898-00 Initial release. VMware, Inc. 7
8 VMware, Inc.
Introduction to the SAP Adapter 1 The SAP adapter is an embedded adapter for vcenter Operations Manager. The adapter uses SAP BAPI calls to collect metrics from an SAP server. This chapter includes the following topics: How the Adapter Collects Data, on page 9 Installation and Configuration Requirements, on page 9 SAP Adapter Resource Identification, on page 11 How the Adapter Collects Data When you configure the SAP adapter, you define an adapter instance and add an SAP resource. The adapter instance 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 support manual or auto discovery of resources. You define the metrics that the SAP adapter collects from an SAP server in an attribute package that you assign to 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 represented by the SAP resource. After logging in, the adapter requests metrics for the attributes in the attribute package that you assigned to the SAP resource. When multiple SAP resources are associated with the same adapter instance, the adapter processes each resource sequentially. The collection interval for the adapter instance resource determines the data polling interval for all of its SAP resources. The default collection interval is five minutes. Installation and Configuration Requirements The SAP adapter has certain installation and configuration requirements. Compatible SAP Versions The SAP adapter is compatible with the following SAP versions: SAP R/3 4.7 SAP ECC 5.0 and 6.0 SAP NetWeaver 7.0, ABAP + BASIS Support Package level 20 VMware, Inc. 9
SAP Java Connector File Requirements You must download certain SAP Java Connector (JCo) files from the SAP Web site. The SAP JCo files must match the machine and JRE processor architecture and come from the same SAP library package. In a Standalone installation, you must copy the files to folders on the vcenter Operations Manager server. In a vapp installation, you must copy the files to folders on the Analytics virtual machine. Table 1-1. SAP JCo Files for Windows File sapjco.jar sapjcorfc.dll librfc32.dll Folder vcenter-ops/user/plugins/inbound/sap_adapter3/lib vcenter-ops/common/bin Windows/system32 Table 1-2. SAP JCo Files for Linux File sapjco.jar libsapjcorfc.so librfccm.so Folder vcenter-ops/user/plugins/inbound/sap_adapter3/lib vcenter-ops/common/bin 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 link to 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 Versions The SAP adapter is tested with Java versions 1.6.0_07, 1.6.0_14, and 1.6.0_31. vcenter Operations Manager Collector Requirements The 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 SAP adapter is tested with Windows 32-bit and 64-bit remote collectors and with Linux 64-bit collectors. The SAP adapter is not tested with Linux 32-bit collectors. NOTE To use a remote collector with a vapp installation, you must work with your VMware Professional Services representative. SAP Credential Requirements The SAP adapter requires a user ID to connect to the host for the SAP server. You specify this user ID when you 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 to Computing Center Management System (CCMS) data. For information about assigning restricted roles, see the SAP help. 10 VMware, Inc.
Chapter 1 Introduction to the SAP Adapter SAP Adapter Resource Identification The SAP adapter uses certain resource identifiers. You must specify resource identifiers when you reference SAP adapter resources with the vcenter Operations Manager API. Adapter Kind The adapter kind for the SAP adapter is named SAP Adapter and the identifier key is SAP. Adapter Instance Resource Kind The adapter instance resource kind for an SAP adapter instance is named SAP Adapter Instance and the identifier key is SAPAdapter Instance. SAP Adapter Resources The SAP adapter creates a single resource kind named SAP Resource, which represents an SAP server. The identifier key for the SAP Resource resource kind is SAP. An SAP resource has several identifier keys. Table 1-3. SAP Resource Identifier Keys Key Part of Uniqueness 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. VMware, Inc. 11
12 VMware, Inc.
Installing the SAP Adapter 2 Installing the SAP adapter involves downloading adapter files from the VMware FTP site and SAP Java Connector (JCo) files from the SAP Web site. The procedure that you follow to install the files depends on whether you have a vcenter Operations Manager Standalone or vapp installation. This chapter includes the following topics: Overview of Installation Steps, on page 13 Installing the SAP Adapter Files, on page 13 Installing the SAP JCo Files, on page 15 Redescribe the SAP Adapter, on page 17 SAP Adapter Folders and Files, on page 17 Overview of Installation Steps Installing 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 Files You download the SAP adapter files from the VMware FTP site. How you install the SAP adapter files depends on whether you have a Standalone or vapp installation. Install the SAP Adapter Files in a Standalone Installation If you have a standalone installation, you install the SAP adapter by extracting the adapter installation files from a TGZ file and running an installation utility. Prerequisites Download the adapter installation TGZ file anonymously from ftp://ftp.integrien.com/. 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. 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 Manager server. 2 In the temporary folder, open the TAR file and extract and run the installer for your operating system platform. 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 installs the adapter on the remote collectors. The describe process might take several minutes. When the describe process is finished, the adapter appears 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 in the TGZ file that you downloaded. The installation utility creates the sap_adapter3 folder and sap_adapter3.jar file in the vcenterops/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 Installation If you have a vapp installation, you install the SAP adapter from a PAK file. Prerequisites Download the adapter installation PAK file anonymously from ftp://ftp.integrien.com. 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. 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.
Chapter 2 Installing the SAP Adapter 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 update is 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 adapter appears 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 in the PAK file that you uploaded. The installation process creates the sap_adapter3 folder and sap_adapter3.jar file in the vcenterops/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 Files You must download and install certain SAP JCo files for both Standalone and vapp installations. If you have a Standalone installation, the files that you must install depend on whether vcenter Operations Manager is installed on a Windows or Linux system. Install the SAP JCo Files in a Standalone Installation on Windows If you have a vcenter Operations Manager Standalone installation on Windows, you must install certain JAR and DLL files. The files must match the machine and JRE processor architecture of the server and come from the same SAP library package. Prerequisites Verify that you have a user name and password to log in to the SAP Web site. Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of the required files for Windows, see Installation and Configuration Requirements, on page 9. Procedure 1 Copy the sapjco.jar file from the temporary folder to the vcenterops/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 the vcenter Operations Manager server. 3 Copy the librfc32.dll file from the temporary folder to the Windows/system32 folder on the vcenter Operations Manager server. 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 Linux If you have a vcenter Operations Manager Standalone installation on Linux, you must install certain JAR and shared library (.so) files. The files must match the machine and JRE processor architecture of the server and come from the same SAP library package. Prerequisites Verify that you have a user name and password to log in to the SAP Web site. Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of the required files for Linux, see Installation and Configuration Requirements, on page 9. Procedure 1 Copy the sapjco.jar file from the temporary folder to the vcenterops/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 vcenterops/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 in the 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 to the 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 Installation If 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 architecture of the Analytics virtual machine and come from the same SAP library package. Prerequisites Verify that you have a user name and password to log in to the SAP Web site. Download the SAP JCo files from http://service.sap.com/connectors to a temporary folder. For a list of the required files, see Installation and Configuration Requirements, on page 9. Procedure 1 Copy the sapjco.jar file from the temporary folder to the vcenterops/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 vcenterops/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 in the vcenter-ops/common/bin folder. 16 VMware, Inc.
Chapter 2 Installing the SAP Adapter 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 to the 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 Adapter After you install the SAP JCo files, you must redescribe the SAP adapter. Prerequisites Install the SAP adapter files. See Installing the SAP Adapter Files, on page 13 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 installs the adapter on the remote collectors. The describe process might take several minutes. When the describe process is finished, the adapter appears 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 Files The 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 history.txt version.tx Describes the adapter. Contains the history of the adapter changes. Contains version information. lib sapjco.jar SAP library file. IMPORTANT This file is not included with the SAP adapter. You must download this file from the SAP Web site. See Installing the SAP JCo Files, on page 15. VMware, Inc. 17
18 VMware, Inc.
Configuring the SAP Adapter 3 Configuring the SAP adapter involves creating an adapter instance and credential, adding an SAP resource to represent an SAP server, and creating an attribute package to define the metrics that the adapter collects from the SAP server. This chapter includes the following topics: Add an Adapter Instance, on page 19 Add an SAP Resource, on page 20 Add an Adapter Instance You must create an adapter instance for the SAP adapter. The adapter instance defines the adapter type. Prerequisites Install the SAP adapter. See Chapter 2, Installing the SAP Adapter, on page 13. Create a credential, or, if you plan to create a credential when you add the adapter instance, become familiar 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. You can 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 click Add 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 Credential The SAP adapter needs a user name and password to connect to the host for the SAP server. You use this user name 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 you define 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 SAP server. 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 Resource You must add an SAP resource to represent an SAP server. You can add multiple SAP resources to the same SAP adapter instance. Prerequisites Add an adapter instance. See Add an Adapter Instance, on page 19. Create an attribute package to define the metrics that the SAP resource collects, or, if you plan to create an 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.
Chapter 3 Configuring the SAP Adapter 8 Provide SAP server connection information. The SAP adapter uses this information to connect to the SAP server. Option Host Client ID System Number Description Host for the SAP server. Can be a host name or IP address. SAP client ID. 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 Attribute package 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 collection interval to 30 minutes. The collection interval for a resource influences the collection status for that resource. The collection interval for the adapter instance resource determines how often to collect data. For example, if the collection interval for the adapter instance resource is set to five minutes, setting the collection interval for a resource to 30 minutes prevents the resource from having the No Data Receiving collection status after five collection cycles (25 minutes). 12 Click OK to add the resource. 13 Start metric collection for the resource. a b c Select Environment > Enviroment Overview. On the List tab, select the SAP resource. Click the Start Collecting icon to start metric collection for the SAP resource. Add an Attribute Package You 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 SAP resource, 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, on page 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. 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 collection interval to 30 minutes. The collection interval for a resource influences the collection status for that resource. The collection interval for the adapter instance resource determines how often to collect data. For example, if the collection interval for the adapter instance resource is set to five minutes, setting the collection interval for a resource to 30 minutes prevents the resource from having the No Data Receiving collection status after five collection cycles (25 minutes). NOTE The collection interval that you set for the SAP resource overrides the collection interval in the attribute 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 4 Known troubleshooting information can help you diagnose and correct problems with the SAP adapter. This chapter includes the following topics: Troubleshooting an SAP Adapter Instance, on page 23 Viewing System Log Files, on page 23 SAP Adapter Classes, on page 24 Troubleshooting an SAP Adapter Instance Perform 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 Environment Overview 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 Files You can view SAP adapter errors in the vcenter Operations Manager adapter and collector log files in. You can 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 file is 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 view detailed 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 to DEBUG 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 Classes The SAP adapter uses certain adapter classes. Table 4-1. SAP Adapter Classes Class com.integrien.adapter3.sap.sapadapter com.integrien.adapter3.sap.adapterutility com.integrien.adapter3.sap.genericmonitorbean com.integrien.adapter3.sap.sapadapterconnectionpoolcreator com.integrien.adapter3.sap.sapadapterproperties com.integrien.adapter3.sap.sapconpoolrepos Description Main adapter logic. Main utility class. Monitor bean class. Connection pool creator. Property file loader. SAP connection pool. 24 VMware, Inc.
SAP Performance Metrics 5 The SAP adapter can collect certain performance metrics from an SAP server. This chapter includes the following topics: SAP Metric Descriptions, on page 25 Entire System Metrics, on page 25 Logon Load Balancing Metrics, on page 27 Performance Overview Metrics, on page 28 Operating System Metrics, on page 28 Spool Metrics, on page 29 Background Processing Metrics, on page 30 Buffer Metrics, on page 30 SAP Metric Descriptions For descriptions of SAP metrics, see the SAP documentation. SAP NetWeaver Version 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 Metrics Entire system metrics show the performance of the entire SAP system. Enqueue Metrics Table 5-1. Enqueue Metric Descriptions Percentage length of the queue Number of errors in the enqueue work processes Enqueue operations per minute Utilization of the enqueue server in SAP QueueLength EndedWpENQ ErrorsInWpENQ ErrorFreqInWpENQ VMware, Inc. 25
Dialog Overview Metrics Table 5-2. Dialog Overview Metric Descriptions Dialog response time Front end wait time Queue time Load generation time DB Request Time Dialog Utilization Percentage of dialog work processes in PRIV mode Number of dialog work processes Errors in dialog work processes Number of completed dialog work processes Number of errors in dialog work processes per minute Long runners Perentage length of Wait queue Log on Load Quality Dialog steps Gui call back time Front end network time Standardized response time in SAP ResponseTime FrontendResponseTime QueueTime Load+GenTime DBRequestTime Utilisation PrivMode Utilisation NumberOfWPDia ErrorsInWpDIA EndedWpDIA ErrorFreqInWpDIA LongRunners QueueLength LogonLoadQuality DialogSteps GuiCallBackTime FrontendNetTime ResponseTime(StandardTran.) Update Metrics Table 5-3. Update Metric Descriptions SAP update task V1: response time SAP update task V1: wait time SAP Update Task V1: Percentage load for update task work process Number of update1 work processes Number of errors in update 1 work processes SAP update task V2: response time SAP update task V2: wait time SAP Update Task V2: Percentage load for update task work processes Number of update2 work processes Number of errors in update 2 work processes Update requests containing errors in SAP ResponseTime QueueTime Utilisation NumberOfWpUD1 ErrorsInWpUD1 ResponseTime QueueTime Utilisation NumberOfWpUD2 ErrorsInWpUD2 AbapErrorInUpdate 26 VMware, Inc.
Chapter 5 SAP Performance Metrics Gateway Summary Metrics Table 5-4. Gateway Summary Metric Descriptions Gateway Clients Gateway Connections Gateway Remote Gateways Gateway Communication Entries Gateway Work Processes Gateway Malloc Failed Gateway Overflow Usage Gateway Overflow Exceeded in SAP Gateway_Clients Gateway_Connections Gateway_RemGateways Gateway_CommAdmEnty Gateway_Workprocess Gateway_MallocFailed Gateway_OverflowUsage Gateway_OverflowExceeded SysLog Metrics Table 5-5. SysLog Metric Descriptions BasisSystem Database CCMS Background Communication Spool Security Transport System Batch Input Applications Customer Miscellaneous SyslogFreq in SAP BasisSystem Database CCMS Background Communication Spool Security Transport System Batch Input Applications Customer Miscellaneous SyslogFreq Logon Load Balancing Metrics Logon load balancing metrics show user login performance. Table 5-6. Logon Load Balancing Metric Descriptions Number of logged-on users Response Time Log on load quality in SAP UsersLoggedIn ResponseTime LogonLoadQuality VMware, Inc. 27
Performance Overview Metrics Performance overview metrics show dialog service and memory use. Dialog Metrics Table 5-7. Dialog Metric Descriptions Response time of the dialog service Number of users logged on Average time in the dispatcher wait queue Average load and generation time of GUI objects Average time for processing logical database requests in SAP ResponseTime UsersLoggedIn QueueTime Load+GenTime DBRequestTime Memory Management Metrics Table 5-8. Memory Management Metric Descriptions Currently used roll area Extended memory Amount allocated to heap memory currently Swap rate of the program buffer in SAP R3RollUsed EsAct HeapAct Program\\Swap Operating System Metrics Operating system metrics show operating system performance. Filesystem Metrics Table 5-9. Filesystem Metric Descriptions Filesystem Freespace Filesystem Percentage Used in SAP FREESPACE PERCENTAGE_USED CPU Metrics Table 5-10. CPU Metric Descriptions CPU:Average usage CPU:Average number of waiting processes in SAP CPU_UTILIZATION 5MINLOADAVERAGE 28 VMware, Inc.
Chapter 5 SAP Performance Metrics Swap Space Metrics Table 5-11. Swap Space Metric Descriptions Available swap space Percentage of swap space used in SAP FREESPACE PERCENTAGE_USED Paging Metrics Table 5-12. Paging Metric Descriptions Paging:Page-in:Pages per second Paging:Page-out:Pages per second in SAP PAGE_IN PAGE_OUT Commit Charge Metrics Table 5-13. Commit Charge Metric Descriptions Available commit charge Used commit charge in SAP COMMITCHARGEFREE COMMIT_PERCENT LAN Metrics Table 5-14. LAN Metric Descriptions LAN -- Packets in:packets per second LAN -- Packets out:packets per second LAN -- Number of collisions in SAP PACKETS_IN PACKETS_OUT COLLISIONS Spool Metrics Spool metrics show the performance of the spool service and spool work processes. Table 5-15. Spool Metric Descriptions Percentage usage of the spool numbers Wait Time in spool service Spool Utilization Number of spool work processes Number of errors in spool work processes Number of errors in spool work processes per minute Number of spool work processes that terminated after errors Used area of the dispatcher queue as a percentage in SAP UsedNumbers WaitTime Utilisation NumberOfWpSPO ErrorsInWpSPO ErrorFreqInWpSPO EndedWpSPO QueueLength VMware, Inc. 29
Table 5-15. Spool Metric Descriptions (Continued) Used area of the spool request queue as a percentage Used area of the spool request queue for processing Number of pages in the spool request queue Used area of the entire device cache as a percentage Used area of the fixed device cache as a percentage Used area of the host spool request list as a percentage in SAP ServiceQueue ServiceQueuePriv ServiceQueuePages DeviceCacheUsed DeviceCacheFixed HostspoolListUsed Background Processing Metrics Background processing metrics show batch job performance and batch processing capacity. System Wide Table 5-16. System Wide Background Processing Metric Descriptions Number of jobs that are ready to be executed System-wide number of background work processes Number of free background work processes Number of background work processes in SAP SystemWideQueueLength SystemWideClassABPWP SystemWideFreeBPWP SystemWideTotalBPWP Background Processing Servers Table 5-17. Background Processing Servers Background Processing Metric Descriptions Utilization Number of background work processes Number of errors in background work processes Number of errors in background work processes per minute Number of background work processes terminated after an error in SAP Utilisation NumberOfWpBTC ErrorsInWpBTC ErrorFreqInWpBTCErrorFreqInWpBTC EndedWpBTC Buffer Metrics Buffer metrics show the performance of the SAP buffers. Buffer metrics apply to the following groups: Program Generic Key Single Record Screen CUA Table Definition 30 VMware, Inc.
Chapter 5 SAP Performance Metrics Field Description Initial Records ShortnameTAB Table 5-18. Buffer Metric Descriptions Percentage usage of the directory Percentage usage of the buffer storage Percentage of the database queries Swaps due to a full buffer per minute in SAP DirectoryUsed SpaceUsed HitRatio Swap VMware, Inc. 31
32 VMware, Inc.
Index A adapter classes 24 adapter instances 19 attribute packages 21 audience information 5 B background processing metrics 30 buffer metrics 30 C configuration steps 19 credentials 20 D data collection 9 S SAP performance metrics 25 SAP resources 20 sap_adapter3 folder 17 sapjco.jar 15, 16 sapjcorfc.dll 15 spool metrics 29 system metrics 25 T troubleshooting steps 23 U updated information 7 I installation steps 13 installing the adapter 13, 14 introduction 9 J JCo files 15 L librfc32.dll 15 librfccm.so 16 libsapjcorfc.so 16 log files 23 logon load balancing metrics 27 M metric descriptions 25 O operating system metrics 28 P performance overview metrics 28 R redescribing the SAP adapter 17 requirements 9 resource identification 11 VMware, Inc. 33
34 VMware, Inc.