SAP Adapter Installation and Configuration Guide

SAP Adapter Installation and Configuration Guide
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
SAP Adapter Installation and Configuration Guide
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
SAP Adapter Resource Identification 11
9
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
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 for
vCenter Operations Manager.
Intended Audience
This 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 when
necessary.
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 Performance
Metrics,” on page 25.
EN-000898-02
n
n
n
n
EN-000898-01
n
n
EN-000898-00
VMware, Inc.
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.
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.
Initial release.
7
SAP Adapter Installation and Configuration Guide
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:
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 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:
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 Adapter Installation and Configuration Guide
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
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 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
SAP Adapter Installation and Configuration Guide
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:
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 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
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
SAP Adapter Installation and Configuration Guide
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
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
14
Read and accept the EULA and click OK.
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
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 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
SAP Adapter Installation and Configuration Guide
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
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 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
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 the
required files, see “Installation and Configuration Requirements,” on page 9.
Procedure
16
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.
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
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 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
Describes the adapter.
history.txt
Contains the history of the adapter changes.
version.tx
Contains version information.
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.
lib
VMware, Inc.
17
SAP Adapter Installation and Configuration Guide
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:
n
“Add an Adapter Instance,” on page 19
n
“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
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, 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
SAP Adapter Installation and Configuration Guide
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
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 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.
20
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.
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.
9
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.
(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
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 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
SAP Adapter Installation and Configuration Guide
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.
22
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.
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:
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 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 Installation and Configuration Guide
SAP Adapter Classes
The SAP adapter uses certain adapter classes.
Table 4-1. SAP Adapter Classes
24
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.
VMware, Inc.
SAP Performance Metrics
5
The 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 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
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
SAP Adapter Installation and Configuration Guide
Dialog Overview Metrics
Table 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 Metrics
Table 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 work
process
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 work
processes
Utilisation
Number of update2 work processes
NumberOfWpUD2
Number of errors in update 2 work processes
ErrorsInWpUD2
Update requests containing errors
AbapErrorInUpdate
26
VMware, Inc.
Chapter 5 SAP Performance Metrics
Gateway Summary Metrics
Table 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 Metrics
Table 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 Metrics
Logon 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
VMware, Inc.
27
SAP Adapter Installation and Configuration Guide
Performance Overview Metrics
Performance overview metrics show dialog service and memory use.
Dialog Metrics
Table 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 Metrics
Table 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 Metrics
Operating system metrics show operating system performance.
Filesystem Metrics
Table 5-9. Filesystem Metric Descriptions
Metric Name
Metric Name in SAP
Filesystem Freespace
FREESPACE
Filesystem Percentage Used
PERCENTAGE_USED
CPU Metrics
Table 5-10. CPU Metric Descriptions
Metric Name
Metric Name in SAP
CPU:Average usage
CPU_UTILIZATION
CPU:Average number of waiting processes
5MINLOADAVERAGE
28
VMware, Inc.
Chapter 5 SAP Performance Metrics
Swap Space Metrics
Table 5-11. Swap Space Metric Descriptions
Metric Name
Metric Name in SAP
Available swap space
FREESPACE
Percentage of swap space used
PERCENTAGE_USED
Paging Metrics
Table 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 Metrics
Table 5-13. Commit Charge Metric Descriptions
Metric Name
Metric Name in SAP
Available commit charge
COMMITCHARGEFREE
Used commit charge
COMMIT_PERCENT
LAN Metrics
Table 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 Metrics
Spool 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
VMware, Inc.
29
SAP Adapter Installation and Configuration Guide
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 Metrics
Background processing metrics show batch job performance and batch processing capacity.
System Wide
Table 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 Servers
Table 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 an
error
EndedWpBTC
Buffer Metrics
Buffer metrics show the performance of the SAP buffers.
Buffer metrics apply to the following groups:
30
n
Program
n
Generic Key
n
Single Record
n
Screen
n
CUA
n
Table Definition
VMware, Inc.
Chapter 5 SAP Performance Metrics
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
VMware, Inc.
31
SAP Adapter Installation and Configuration Guide
32
VMware, Inc.
Index
A
S
adapter classes 24
adapter instances 19
attribute packages 21
audience information 5
SAP performance metrics 25
SAP resources 20
sap_adapter3 folder 17
sapjco.jar 15, 16
sapjcorfc.dll 15
spool metrics 29
system metrics 25
B
background processing metrics 30
buffer metrics 30
C
configuration steps 19
credentials 20
D
T
troubleshooting steps 23
U
updated information 7
data collection 9
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
SAP Adapter Installation and Configuration Guide
34
VMware, Inc.
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising