vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide This document supports the version of each product listed and supports all subsequent versions until a new edition replaces the document. To check for more recent editions of this document, see http://support.bluemedora.com.

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com The Blue Medora web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: support@bluemedora.com Copyright 2014 Blue Medora LLC. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora LLC in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora LLC 3225 N Evergreen Dr. NE STE 103 Grand Rapids, MI 49525 www.bluemedora.com 2

Table of Contents vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide... 4 1 Introduction to the Management Pack for SAP HANA... 5 How the Adapter Retrieves Data... 5 Data that the Adapter Retrieves... 5 Installation and Configuration Requirements... 6 Understanding Management Pack for SAP HANA Dashboards... 6 2 Installing the Management Pack for SAP HANA... 8 Install the Management Pack in a Standalone Installation... 8 Install the Management Pack in a vapp Installation... 9 Management Pack Folders and Files... 10 Install SAP HANA Adapter Dashboards in a Standalone Installation... 10 3 Configuring the Management Pack for SAP HANA... 11 Overview of Configuration Steps... 11 Licensing the Adapter... 11 Add a Credential... 12 Add an Adapter Instance... 12 Validate the Adapter Data... 13 4 Troubleshooting the SAP HANA Adapter... 14 Troubleshooting a SAP HANA Adapter Instance... 14 Viewing System Log Files... 14 3

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide The vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide describes how to configure the Management Pack for SAP HANA Monitoring (HANA) adapter. Intended Audience This information is intended for anyone who wants to install or configure the Management Pack for SAP HANA Monitoring. 4

1 Introduction to the Management Pack for SAP HANA The Management Pack for SAP HANA is an embedded adapter for vcenter Operations Manager. The adapter collects data from SAP HANA database management tables. This chapter includes the following topics: 1. How the Adapter Retrieves Data, on page 5 2. Data that the Adapter Retrieves, on page 5 3. Installation and Configuration Requirements, on page 6 4. Understanding Management Pack for SAP HANA Dashboards, on page 6 How the Adapter Retrieves Data The Management Pack for SAP HANA connects to SAP HANA via a standard JDBC connection. All data is fetched from the system monitor views with some final processing before it is provided to vcenter Operations Manager. One or more failover hosts can be configured to allow collection to continue through an interruption of the primary host. Collection can be done at any interval configurable through vcenter Operations Manager. Data that the Adapter Retrieves The Management Pack for SAP HANA retrieves a variety of data from SAP HANA related to SAP HANA hosts, services, disks, and the system as a whole. SAP HANA System The metrics collected at the system level are aimed at keeping track of the health of the system. For example, data about CPU usage, memory usage, and disk usage are collected to monitor the entire system s resources and workload. Data about alerts and much more is also collected to help find errors in other parts of the HANA environment. SAP HANA Host The metrics collected at the host level are aimed at keeping track of the stress that the HANA host is under to highlight when it is too busy. Metrics at the host level include workload metrics such as running connections, active threads, and data sent over the network. These, along with memory usage and CPU usage give a good picture of a HANA host. SAP HANA Service The metrics collected for a HANA Service keep track of the stress that the service is under. Information on memory usage, active threads, and CPU usage help with this, SAP HANA Disk Basic disk metrics, including space, usage, and writes per second are collected on HANA disks. 5

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide Installation and Configuration Requirements Before you install the SAP HANA adapter, verify that your system meets certain requirements. SAP HANA Compatibility The Management Pack for SAP HANA is compatible with SAP HANA SP6+. vcenter Operations Manager Compatibility The Management Pack for SAP HANA is compatible with vcenter Operations manager version 5.7.2+ Connection Requirements The Management Pack for SAP HANA requires a JDBC connection to the SAP HANA database. The primary and failover hosts must have the correct port open (often 30015). The configured credentials must refer to a user with read access to all SAP HANA monitor views in the SYS schema. Understanding Management Pack for SAP HANA Dashboards SAP HANA Environment Overview This dashboard is used to see the overview of the relationships and statuses of your SAP HANA Systems, their hosts, and the VMware Virtual Machines supporting them. Click on the desired relationship to see related systems. You must have at least one SAP HANA System configured for the dashboard to display useful information. The VMware Management Pack is recommended for standalone installations of vcenter Operations Manager. If SAP HANA is not virtualized on VMware, portions of this dashboard will not apply. This dashboard includes all active Virtual Machines by default. To only include Virtual Machines that are part of your HANA System, use the following steps. 1. Click on the Setting icon in the SAP HANA Relationship View widget. 2. Under the Select Resource Kinds menu, click Select Tags. 3. Under the Select Which Tags to Filter menu, click SAP HANA Tags > VMWare VMs Hosting: SAP HANA Hosts. SAP HANA System Overview This dashboard is used to see a variety of information about an SAP HANA System, including alerts, running and inactive hosts, license, memory, CPU, running connections, expensive statements, HANA reported status, and more. SAP HANA on VMware Layer View This dashboard is used to see trending on various key performance indicators related to Virtual Machines and ESX Hosts. You must have at least one SAP HANA Host running on VMware for the dashboard to display useful information. 6

The VMware Management Pack is needed for standalone installations of vcenter Operations Manager. SAP HANA Host Overview This dashboard is used to see a variety of information about an SAP HANA Host, including CPU, memory, network traffic, and workload data, and various metrics from related VMs, if applicable. Also allows drilling down to individual services. Select a system and a host from the appropriate widgets. Top SAP HANA Resources This dashboard is used to see SAP HANA hosts, systems, and services ranked by several metrics, including CPU utilization, memory utilization, active thread counts, and more. SAP HANA Heat Maps This dashboard is used to compare pairs of metrics. Six heat maps are included: SAP HANA Host CPU% sized by memory - Color represents CPU utilization; Size represents total memory for that SAP HANA Host Table Growth - Color represents that rate of growth of each table. SAP HANA Service Memory Util sized by MB - Color represents memory utilization; Size represents used memory. SAP HANA Service Response Time sized by Requests/s - Color represents average response time; Size represents requests per second. Disk Utilization Sized by Size - Color represents disk utilization; Size represents disk size. Table Size - Color represents the size of each table. 7

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide 2 Installing the Management Pack for SAP HANA How you install the Management Pack for SAP HANA depends on whether you have a vcenter Operations Manager Standalone or vapp installation. This chapter includes the following topics: Install the Management Pack in a Standalone Installation on page 8 Install the Management Pack in a vapp Installation on page 9 "Management Pack Folders and Files, on page 10 "Install SAP HANA Adapter Dashboards in a Standalone Installation, on page 10 Install the Management Pack in a Standalone Installation If you have a standalone installation, you install the management pack for SAP HANA by extracting installation files from a TGZ file and running an installation utility. Prerequisites Obtain the management pack installation file from http://www.bluemedora.com/vcops-trials. 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. 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. In the $ALIVE_BASE/user/plugins/inbound/sap_hana_adapter3/conf directory create a file called license.properties with licensekey=your_key on the first line. Make sure that the license.properties file is owned by the vcenter Operations Manager user. The user, group, and permissions should match other files in the $ALIVE_BASE/user/plugins/inbound/sap_hana_adapter3/conf directory. 4. Log in to vcenter Operations Manager as an administrator. 5. Select Admin > Support. 6. 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. 7. Click Yes to start the describe process and click OK. 8

vcenter Operations Manager 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 may 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. 8. Verify that the build number in the Adapter Version column for the adapter matches the build number in the TGZ file that you downloaded. Note: The installer creates the sap_hana_adapter3 folder and sap_hana_adapter3.jar file under the $ALIVE_BASE/user/plugins/inbound/ folder. Install the Management Pack in a vapp Installation If you have a vapp installation, you install the SAP HANA Adapter from a PAK file. Prerequisites Obtain the adapter installation file from http://www.bluemedora.com/vcops-trials. 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. 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 analytics VM and navigate to $ALIVE_BASE/user/plugins/inbound/sap_hana_adapter3/conf. In the file called license.properties, put licensekey=your_key. (If this file does not exit, create it making sure to pay attention to the user, group, and permissions of the file. These should match the other files in the same directory) 8. Log in to the Custom user interface as an administrator. For example: https://ipaddress/vcops-custom/ 9. Select Admin > Support. 10. The adapter should appear 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 9

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide the PAK file that you uploaded. Note: The installer creates the sap_hana_adapter3 folder and sap_hana_adapter3.jar file under the $ALIVE_BASE/user/plugins/inbound/ folder. Management Pack Folders and Files The installer places the SAP HANA Adapter files in the sap_hana_adapter3 folder. The sap_hana_adapter3 folder contains several subfolders and files. Table 2-1. SAP HANA Adapter Folders and Files Folder Files Description conf describe.xml Describes the adapter. license.properties License file of the adapter version.txt Contains version information of the adapter tablespace.conf This is a configuration file for selecting system tables that you would like the adapter to collect information on. lib ngdbc.jar JAR file that contain classes & resources used to implement the adapter. Install SAP HANA Adapter Dashboards in a Standalone Installation Management Pack for SAP HANA dashboards are deployed by default to a vapp. For a standalone installation, you can import the dashboards manually using a batch file or shell script. Prerequisites Install the SAP HANA Adapter. See Install the Management Pack in a Standalone Installation, on page 8. The VMware Management Pack is required for complete installation of all dashboards included in the management pack. See Understanding Management Pack for SAP HANA Dashboards, on page 6. Procedure 1. Navigate to %ALIVE_BASE/user/plugins/inbound/sap_hana_adapter3/conf/scripts. 2. Run the appropriate script file. OS Windows Linux Script File SapHanaInstall.bat SapHanaInstall.sh 10

3 Configuring the Management Pack for SAP HANA To configure the management pack for SAP HANA, you must add a credential and an adapter instance in vcenter Operations Manager. This chapter includes the following topics: Licensing the Adapter, on page 11 Overview of Configuration Steps, on page 11 Add a Credential, on page 12 Add an Adapter Instance, on page 12 Overview of Configuration Steps Configuring the SAP HANA Adapter involves several steps. You must perform these steps in a particular order. Add a credential for the adapter instance. See Add a Credential, on page 12. Add an adapter instance. See Add an Adapter Instance, on page 12. Licensing the Adapter The Management Pack requires a valid license for full operation. Please visit http://bluemedora.com/product/vcenter-operations-management-pack-sap-hana for pricing and licensing information or contact sales directly at sales@bluemedora.com. To receive a trial version of the Management Pack please visit the trial request page at http://www.bluemedora.com/vc-ops-products-trial-request and fill out the form. Installing the License 1. Navigate to %ALIVE_BASE/user/plugins/inbound/sap_hana_adapter3/conf/. 2. Create and/or open a file called license.properties in a text editor. NOTE In a vapp installation, modify the license.properties file on the Analytics virtual machine. 3. Add a licensekey property and set it to your provided license key string. For example: licensekey=1/sample/01-02-2014/trial/01-04- 2014/limited/2DBE4EC0F314B6E3401E4A5AF38C5CF27390E760 4. Ensure the license.properties file is owned by the admin user, is readable and writeable by user, and readable by group and other. To do this run these commands: chmod 644 license.properties chown admin:admin license.properties 11

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide 5. Restart any existing SAP HANA Adapter instances in the Custom UI 6. Navigate to Environment > Environment Overview. 7. Expand Adapter Instances tag in the left hand tree view and select SAP HANA System. 8. Select all adapter instances and click the Stop Collecting icon. 9. Select all adapter instances and click the Start Collecting icon. Add a Credential The SAP HANA Adapter uses a user name and password to connect to the HANA Database to query and retrieve metric data. 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 The SAP HANA Adapter is installed. Procedure 1. Log in to the Custom user interface as an administrator. 2. Select Environment > Configuration > Credentials. 3. Select SAP HANA Adapter from the Adapter Kind drop-down menu. 4. Select the credential kind 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. Fill in the user and password field for an SAP HANA user with read access to system tables and views. 8. Click OK to add the credential for the adapter kind. The credential appears in the list in the Manage Credentials window. Add an Adapter Instance Prerequisites The SAP HANA Adapter is installed. 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 12. 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 12

change the name of this collector when you install the standalone version. 4. Select SAP HANA 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. Configure the adapter settings. Option Description Host Port Support Autodiscovery Failover This is the name or IP address of a host participating in the SAP HANA System This is the port that is being used for the SAP HANA System. For an instance number 00, this would be 30015. For an instance number 01, this would be 30115, etc. If Autodiscovery is enabled, the adapter will collect data on all metrics supported. To disable this, disable Autodiscovery and use manual discovery through the vcenter Operations User Interface. This field is used in distributed systems. If the primary HANA host were to go down, the adapter will use this field to continue collecting data on the system. Enter this as a comma separated list of the other hosts in your environment. 8. 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. 9. Click OK to save your configuration. Validate the Adapter Data After you add an adapter instance for the SAP HANA adapter, verify that resources are created and that metrics are collected through the adapter instance in vcenter Operations Manager. Prerequisites Add an adapter instance for the SAP HANA adapter. See Add an Adapter Instance on page 12. If you disabled auto-discovery when you created the adapter instance, discover the resources manually. For information about using manual discovery, see the online help. Procedure 1. Log in to the Custom user interface as an administrator. 2. Select Environment > Environment Overview and examine the resources on the Environment Overview page. 3. Verify the details for each resource. 4. Select the HANA System resource you created and click on the Show Detail icon. 5. Select Hosts > Total Hosts to verify that it has the correct number of hosts running in your HANA Environment. 13

vcenter Operations Management Pack for SAP HANA Installation and Configuration Guide 4 Troubleshooting the SAP HANA Adapter Known troubleshooting information can help you diagnose and correct common problems with the SAP HANA adapter. This chapter includes the following topics: Troubleshooting a SAP HANA Adapter Instance, on page 14 Viewing System Log Files, on page 14 Troubleshooting a SAP HANA Adapter Instance Perform these general troubleshooting steps to diagnose and correct problems with an SPA HANA adapter instance. 1. Verify that the SAP HANA database is running. 2. View the collection status and collection state of the 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 14. Viewing System Log Files You can view SAP HANA adapter errors in the adapter and collector log files. You can view log files in the Custom user interface or in an external log file viewer. 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. 14