Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide

Transcription

1 Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide v MK-92ADPTR111-04

2 2018 Hitachi Vantara Corporation. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including copying and recording, or stored in a database or retrieval system for commercial purposes without the express written permission of Hitachi, Ltd., or Hitachi Vantara Corporation (collectively Hitachi ). Licensee may make copies of the Materials provided that any such copy is: (i) created as an essential step in utilization of the Software as licensed and is used in no other manner; or (ii) used for archival purposes. Licensee may not make any other copies of the Materials. Materials mean text, data, photographs, graphics, audio, video and documents. Hitachi reserves the right to make changes to this Material at any time without notice and assumes no responsibility for its use. The Materials contain the most current information available at the time of publication. Some of the features described in the Materials might not be currently available. Refer to the most recent product announcement for information about feature and product availability, or contact Hitachi Vantara Corporation at Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi Vantara Corporation. By using this software, you agree that you are responsible for: 1. Acquiring the relevant consents as may be required under local privacy laws or otherwise from authorized employees and other individuals; and 2. Verifying that your data continues to be held, retrieved, deleted, or otherwise processed in accordance with relevant laws. Notice on Export Controls. The technical data and technology inherent in this Document may be subject to U.S. export control laws, including the U.S. Export Administration Act and its associated regulations, and may be subject to export or import regulations in other countries. Reader agrees to comply strictly with all such regulations and acknowledges that Reader has the responsibility to obtain licenses to export, re-export, or import the Document and any Compliant Products. Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi Vantara Corporation. Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries. AIX, AS/400e, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, eserver, FICON, FlashCopy, IBM, Lotus, MVS, OS/390, PowerPC, RS/6000, S/390, System z9, System z10, Tivoli, z/os, z9, z10, z13, z/vm, and z/vse are registered trademarks or trademarks of International Business Machines Corporation. Active Directory, ActiveX, Bing, Excel, Hyper-V, Internet Explorer, the Internet Explorer logo, Microsoft, the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint, SharePoint, Silverlight, SmartScreen, SQL Server, Visual Basic, Visual C++, Visual Studio, Windows, the Windows logo, Windows Azure, Windows PowerShell, Windows Server, the Windows start button, and Windows Vista are registered trademarks or trademarks of Microsoft Corporation. Microsoft product screen shots are reprinted with permission from Microsoft Corporation. All other trademarks, service marks, and company names in this document or website are properties of their respective owners. Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide ii

3 Contents Chapter 1: Hardware and Software Requirements Hardware Requirements for Adapter Management Server Storage Models Software requirements...11 HANA Database Operating Systems Replication Software and Consistency Groups Host Interface and Volume Type...13 Chapter 2: Architecture Chapter 3: Installation Distribution Package...18 Installing the HANA Management Service on the VMware vcenter...18 Obtaining the Virtual Appliance OVA file Creating Command Devices...19 Deploying the Virtual Appliance in ESXi environment...20 Installing the HANA Management Service on the Hyper-V Obtaining the hyper-v Appliances file Creating Command Devices...22 Deploying the Virtual Appliance in Hyper-V environment...23 Importing the delivery unit to SAP HANA Configuring the HTTP Destination Changing the Session Timeout...28 Upgrading the HANA Management Service Uninstallation of the Hitachi HANA management service...31 Uninstalling the delivery unit Backing Up the Adapter Configuration Repository Contents Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 3

4 Chapter 4: Operations Overview of Features...33 Launching the UI for Hitachi Adapter for the SAP HANA Cockpit Registering a HANA Instance Registering a HANA Host Registering Hitachi Storage Creating a HANA Storage Snapshot with Hitachi Thin Image Verifying HANA Storage Snapshot from HANA Studio...44 Recovering a HANA Database from a HANA Storage Snapshot Cloning HANA Systems Using Hitachi Thin Image...50 Splitting Replication Pairs Using Thin Image Cloning HANA Systems Using Hitachi ShadowImage...54 Splitting Replication Pairs Using ShadowImage Backing up HANA OS by Using HTI/ShadowImage Backing up Full HANA System Deleting Replication Pairs...60 Monitoring Operations - Job Progress Report Collecting Storage Data and Cache Host Resource Usage Data Collection Host Resource Usage Data Collection Force Update Alerts...66 Threshold Configuration SMTP Configuration Saving SMTP Configuration Testing SMTP Configuration...71 Trend...71 Host Resource Trend CPU Usage Trend...72 Memory Usage Trend Filesystem Trend...73 LUN Usage Trend Contents Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 4

5 Chapter 5: Reporting Reporting Overview Device-Mapping Report Hostgroup Report...79 LUN Performance Report LUN Performance Detail Report...82 LUN Performance History Chart...82 Port Performance Report...83 Replication Report Storage Pool Report Parity Group Report...88 CLPR Report...88 Storage Snapshot History Report Storage Layout Graph Storage Layout History Report Standalone GUI Chapter 6: Logging, Troubleshooting, and Error Messages...93 Logging Troubleshooting Changing the Session Timeout Cleaning the Cache When the Delivery Unit Fails to Import Restarting the Web Service to Solve an Error Message Troubleshooting Diagnostic Steps...97 When All Troubleshooting Recommendations Have Been Exhausted...97 Error Messages...98 Contents Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 5

6 Preface This guide explains how to install, configure and use Hitachi Storage Adapter for the SAP HANA Cockpit with supported Hitachi Enterprise family storage array models. Intended Audience This document is intended for customers of the Hitachi Storage Adapter for the SAP HANA Cockpit: database administrators, storage administrators, and architects implementing backup, recovery, and cloning solutions for SAP HANA databases. Ideally, readers understand the architecture, administration, and backup and recovery concepts of SAP HANA databases. Related Document SAP HANA Administration Guide This document describes the administrative tasks that SAP HANA system administrators perform regularly and on demand. Release notes Read the release notes before installing and using this product. They may contain requirements or restrictions that are not fully described in this document or updates or corrections to this document. Release notes are available on Hitachi Vantara Support Connect: Document conventions This document uses the following typographic conventions: Preface Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 6

7 Document conventions Convention Description Bold Indicates text in a window, including window titles, menus, menu options, buttons, fields, and labels. Example: Click OK. Indicates emphasized words in list items. Italic Indicates a document title or emphasized words in text. Indicates a variable, which is a placeholder for actual text provided by the user or for output by the system. Example: pairdisplay -g group (For exceptions to this convention for variables, see the entry for angle brackets.) Monospace < > angle brackets Indicates text that is displayed on screen or entered by the user. Example: pairdisplay -g oradb Indicates variables in the following scenarios: Variables are not clearly separated from the surrounding text or from other variables. Example: Status-<report-name><file-version>.csv Variables in headings. [ ] square brackets Indicates optional values. Example: [ a b ] indicates that you can choose a, b, or nothing. { } braces Indicates required or expected values. Example: { a b } indicates that you must choose either a or b. vertical bar Indicates that you have a choice between two or more options or arguments. Examples: [ a b ] indicates that you can choose a, b, or nothing. { a b } indicates that you must choose either a or b. This document uses the following icons to draw attention to information: Icon Label Description Note Calls attention to important or additional information. Preface Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 7

8 Conventions for storage capacity values Icon Label Description Tip Caution WARNING Provides helpful information, guidelines, or suggestions for performing tasks more effectively. Warns the user of adverse conditions and/or consequences (for example, disruptive operations, data loss, or a system crash). Warns the user of a hazardous situation which, if not avoided, could result in death or serious injury. Conventions for storage capacity values Physical storage capacity values (for example, disk drive capacity) are calculated based on the following values: Physical capacity unit Value 1 kilobyte (KB) 1,000 (10 3 ) bytes 1 megabyte (MB) 1,000 KB or 1,000 2 bytes 1 gigabyte (GB) 1,000 MB or 1,000 3 bytes 1 terabyte (TB) 1,000 GB or 1,000 4 bytes 1 petabyte (PB) 1,000 TB or 1,000 5 bytes 1 exabyte (EB) 1,000 PB or 1,000 6 bytes Logical capacity values (for example, logical device capacity, cache memory capacity) are calculated based on the following values: Logical capacity unit Value 1 block 512 bytes 1 cylinder Mainframe: 870 KB Open-systems: OPEN-V: 960 KB Others: 720 KB 1 KB 1,024 (2 10 ) bytes Preface Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 8

9 Accessing product documentation Logical capacity unit Value 1 MB 1,024 KB or 1,024 2 bytes 1 GB 1,024 MB or 1,024 3 bytes 1 TB 1,024 GB or 1,024 4 bytes 1 PB 1,024 TB or 1,024 5 bytes 1 EB 1,024 PB or 1,024 6 bytes Accessing product documentation Product user documentation is available on Hitachi Vantara Support Connect: knowledge.hitachivantara.com/documents. Check this site for the most current documentation, including important updates that may have been made after the release of the product. Getting help Hitachi Vantara Support Connect is the destination for technical support of products and solutions sold by Hitachi Vantara. To contact technical support, log on to Hitachi Vantara Support Connect for contact information: contact-us.html. Hitachi Vantara Community is a global online community for Hitachi Vantara customers, partners, independent software vendors, employees, and prospects. It is the destination to get answers, discover insights, and make connections. Join the conversation today! Go to community.hitachivantara.com, register, and complete your profile. Comments Please send us your comments on this document to doc.comments@hitachivantara.com. Include the document title and number, including the revision level (for example, -07), and refer to specific sections and paragraphs whenever possible. All comments become the property of Hitachi Vantara Corporation. Thank you! Preface Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 9

10 Chapter 1: Hardware and Software Requirements This release supports only the hardware and software listed in this document. Hardware Requirements for Adapter Management Server Item Requirements CPU Memory Graphics HDD Capacity Supported HBAs Pentium 4 or more 4 gigabytes or more 800x600, 16-bit color or more 40 gigabyte or more All the HBAs certified by Microsoft or VMware on the hypervisor are supported. Storage Models Model Microcode/Firmware Supported VSP G1000/G1500/F /81 Yes VSP GX00/Fx00 (x=2/4/6) x0/00 Yes VSP Gx00 with NAS Module (G400/G600/ G800) VSP G350/G370/G700/G900 VSP F350/ F370/F700/F x0/ x0/00 Yes Yes Chapter 1: Hardware and Software Requirements Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 10

11 Software requirements Software requirements This adapter is pre-configured as a VMware virtual appliance or Hyper-V virtual appliance. It can only be hosted on a VMware ESXi 6.0/6.5 server or a Windows 2012 R2 server. For the VMware environment, it can only be deployed using a vcenter server. Virtual Appliance Requirement ESXi 6.0/6.5 HyperV on Windows 2012 R2 HANA Database Operating Systems HANA database operating system OS Version Redhat Enterprise Linux 7.2-HANA 2.0 SPS01 Scale-up Dedicated Redhat Enterprise Linux 7.3-HANA 2.0 SPS02 Scale-up Multi-tenant SuSE Linux 12.0SP2-HANA 2.0 SPS01 Scale-up Dedicated SuSE Linux 12.0SP2-HANA 2.0 SPS02 Scale-up Multi-tenant Supported Yes Yes Yes Yes Note: This release only supports scale-up and dedicated hardware. MDC, MCOD, Virtualized, and MCOS are not supported. See the following link for more information on SAP HANA system configuration types: 64/83b71787f2439c907bd e72/content.htm?frameset=/en/df/ 16fa40b3dc4ed3b86e575ad6d1198d/frameset.htm&current_toc=/en/aa/ c4bed f59dd8fdeab3ffafb3/plain.htm&node_id=9 This adapter has been certified to support only the configurations that are described in the Hitachi Unified Compute Platform for the SAP HANA build guide. Contact the Hitachi Vantara Support Center to access this guide. Although HANA 2.0 supports both single- and multi-tenant databases, this adapter supports single-tenant databases only HANA Volumes Chapter 1: Hardware and Software Requirements Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 11

12 Replication Software and Consistency Groups Volume Name Volume Type Supported OS LVM Yes OS Plain LUN Yes Data, Log, and Share LVM Yes Data, Log, and Share Plain LUN No Replication Software and Consistency Groups Replication Software Replication Software Supported Hitachi ShadowImage Hitachi Thin Image Yes Yes Consistency Groups Copy Type CTG Range Hitachi ShadowImage (1, 2, 3)1 Hitachi Thin Image *1: "CTG IDs are numbers between 0 and FF. CTG IDs 00 to 7F (or 0 to 127) are used for SI, SS, and HTI. CTG IDs 80 to FF (or 128 to 255) are used for HTI only." (Ref:Hitachi Virtual Storage Platform G1000 Hitachi ShadowImage User Guide, MK-92RD8021) *2: " CTG IDs are numbers between 0 and FF. CTG IDs 00 to 7F (or 0 to 127) are used for SI and HTI. CTG IDs 80 to FF (or 128 to 255) are used for HTI only." (Ref: Hitachi ShadowImage User Guide, MK-94HM8021) *3: When creating Thin Image by using this adapter, each CTG is associated with one snapshot group. Chapter 1: Hardware and Software Requirements Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 12

13 Host Interface and Volume Type Host Interface and Volume Type Host Interface Interface Supported FC Yes Volume Types Volume Type Supported HDP/HDT/HRT Parity Group Yes Yes Chapter 1: Hardware and Software Requirements Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 13

14 Chapter 2: Architecture SAP HANA is an SAP Fiori Launchpad site that provides you with a single point of access to a range of web-based applications for the online administration of SAP HANA. The Hitachi Server Adapter for the SAP HANA Cockpit runs as a web application and access SAP HANA through a web browser. This adapter provides registration, monitoring, and additional reports for adapter management: Generates the following reports for the Storage: Overview LUN Performance Port Performance Replication Storage Snapshot History Host Group Storage Pool Parity Group CLPR Schedule Allows users to register and monitor Hitachi storage subsystems. Allows users to create and manage HANA storage snapshots by using Hitachi Thin Image (HTI). Allows users to create and manage replication by using ShadowImage and Hitachi Thin Image. The adapter can be configured in any of three ways, which are listed below. (1) Single HANA Instance Use this adapter to manage only one HANA instance on your environment. To do so, install the adapter and deploy the delivery unit to the specified HANA instance. Chapter 2: Architecture Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 14

15 (2) Multiple HANA Instances To manage multiple HANA instances with one adapter installation, deploy the delivery unit to any of the HANA instances, and then remotely manage multiple HANA instances. The delivery unit should be imported to one HANA instance on your environment. However, importing the delivery unit to every HANA instance is not necessary. The adapter is the central management mode in this scenario. In other words, all HANA instances that import the delivery unit and share the adapter web service share the same data. It can be used for high availability purpose. Chapter 2: Architecture Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 15

16 For example, if one HANA instance is down on your environment, you can still use another HANA instance with this adapter for management operation. Chapter 2: Architecture Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 16

17 (3) Multiple HANA Instances with SAP HANA Express The delivery unit also can be imported in the SAP HANA 2.0 express edition. You may use SAP HANA 2.0 express edition only to manage multiple HANA instances on your environment. Chapter 2: Architecture Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 17

18 Chapter 3: Installation Installation includes Hitachi HANA Management Service located at VMWare vcenter and Delivery unit of Hitachi Storage for SAP HANA adapter located at Import delivery unit to SAP HANA. Distribution Package The Hitachi Storage Adapter distribution packages for the SAP HANA Cockpit contain the following: HANA-Storage zip Installing the HANA Management Service on the VMware vcenter Obtaining the Virtual Appliance OVA file The Hitachi HANA Management Service is packaged as a Virtual Appliance OVA file in this adapter zip file. The OVA file name: hitachi_adapters_for_hana_v0x_x_x.ova Check the service status using hihana_check.sh After the OVA installation is completed, you can run the script to check the service status. Also you can run the hihana_check.sh script to find the cause of a problem prior to contacting HiHANA Support. hihana_check.sh Checks the following: Checks whether HiHANA Web service is up and running. Checks whether the HiHANA async worker is up and running. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 18

19 Creating Command Devices Checks whether the HiHANA scheduler is up and running. Checks whether the puma web service is up and running. Note: You must be a super user to run the following command. /opt/hitachi/hihana/scripts/hihana_check.sh Creating Command Devices This includes how to install, configure, and map a command device for your storage system. Communication between the Hitachi adapter and the Hitachi storage system is carried in-band and requires a command device. We recommend that you create a command device and map it to the ESXi host before completing the following steps. Command devices can be mapped using Fibre Channel or the iscsi software initiator. In a VMware ESXi environment, command devices can be mapped to the ESXi Servers using either Fibre Channel and iscsi protocols. This command device can then be mapped to Hitachi Adapters Virtual Appliance VM using Raw Device Mapping. Document Command Control Interface: Installation and Configuration Guide, MK-90RD7008 Description Describes command control interface (CCI) features, installation, and configuration for the VSP series The following figure illustrates the required command device settings. The settings are the same for all supported storage subsystems. Note: When creating a command device, the sequence of events is important. Do not map the LDEV to a Host Group before designating it a command device. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 19

20 Deploying the Virtual Appliance in ESXi environment Deploying the Virtual Appliance in ESXi environment Note: Do not power on the virtual machine before mapping the command devices or they will not be configured. If the Virtual Machine is already on after mapping the command device, you must reboot to initiate the Discovery sequence. Procedure 1. Download the OVA file. 2. Using the vsphere Client, connect to a vsphere vcenter instance managing the ESXi server. 3. Select the ESXi server on which you want to create a VM. 4. Go to the vsphere Client File menu. 5. From this menu, select Deploy OVF Template. The Deploy Wizard opens. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 20

21 Deploying the Virtual Appliance in ESXi environment 6. Complete the following options in the Deploy Wizard. Option Select template Select name and location Select a resource Review details Accept the license agreement Select storage Select network Customize template Description Type a URL or select the downloaded OVA file. Name the appliance or keep the default name. Choose the location to which you want the template deployed. Select a host or cluster where to run the appliance. Review the details of this appliance (i.e., size on disk) Click the "Accept" button to accept the license agreement. Select the datastore location for virtual machine files. Select the destination network for this appliance. Provide the static IP address, netmask, and gateway for the Hitachi Adapter Virtual Appliance. Ready to Complete Verify the details, and then click Finish. 7. Before powering on the virtual machine, map the command device to the Hitachi Adapter Virtual Appliance. The below procedure is for mapping a command device using Fibre Channel protocol. a. Right-click the newly deployed virtual appliance, and then select Settings. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 21

22 Installing the HANA Management Service on the Hyper-V b. On the Virtual Hardware tab, go to New device, then select RDM Disk, click Add. c. Select the previously created command device. d. Accept all the defaults. 8. Power on the virtual machine. The Hitachi Adapters Virtual Appliance queries for command devices and configures itself automatically. Default username/password: root/hitachi1 Tip: If you have trouble identifying the command devices, you can match the Device WWN with the LDEV ID. The last four digits of the Device WWN, starting with naa.6006, correspond to the LDEV ID. Note: Alternatively, you may use the iscsi software initiator to map a command device directly to the Hitachi Adapters Virtual Appliance. Installing the HANA Management Service on the Hyper-V Obtaining the hyper-v Appliances file The Hitachi HANA Management Service is packaged as a Hyper-V appliance that is shipped as part of this adapter zip file. Download the zip file. The zip file name: hyperv_hitachi_adapters_for_hana_v0x_x_x.zip Creating Command Devices This includes how to install, configure, and map a command device for your storage system. Communication between the Hitachi adapter and the Hitachi storage system is carried in-band and requires a command device. We recommend that you create a command device and map it to the ESXi host before completing the following steps. Command devices can be mapped using Fibre Channel or the iscsi software initiator. In a VMware ESXi environment, command devices can be mapped to the ESXi Servers using either Fibre Channel and iscsi protocols. This command device can then be mapped to Hitachi Adapters Virtual Appliance VM using Raw Device Mapping. Document Command Control Interface: Installation and Configuration Guide, MK-90RD7008 Description Describes command control interface (CCI) features, installation, and configuration for the VSP series The following figure illustrates the required command device settings. The settings are the same for all supported storage subsystems. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 22

23 Deploying the Virtual Appliance in Hyper-V environment Note: When creating a command device, the sequence of events is important. Do not map the LDEV to a Host Group before designating it a command device. Deploying the Virtual Appliance in Hyper-V environment Note: Do not power on the virtual machine before mapping the command devices or they will not be configured. If the Virtual Machine is already on after mapping the command device, you must reboot to initiate the Discovery sequence. Procedure 1. Unzip the zip file to a folder on the Hyper-V host. Example: c:\hitachihanappliance 2. Open the Hyper-V Manager. 3. Select the Hyper-V host to create a VM. 4. Right click the Import Virtual Machine. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 23

24 Deploying the Virtual Appliance in Hyper-V environment 5. Complete the following options in the Import Virtual Machine Wizard. Option Locate Folder Select Virtual Machine Choose Import Type Summary Description Select the folder to which the folder unzipped. Example: c:\hitachihanaappliance) Select the packer-hihana-api VM. Select Register the virtual machine in-place. Verify the details, and then click Finish. 6. Before powering on the virtual machine, map the command device to the Hitachi Adapters Virtual Appliance. For mapping a command device using Fibre Channel protocol, follow the steps below: a. Right-click the newly deployed virtual appliance, and select Settings. b. On the Hardware tab, select SCSI Controller, then click Add. c. Click Add again. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 24

25 Deploying the Virtual Appliance in Hyper-V environment d. Select physical hard disk, and click Apply. e. Click Ok. 7. Power on the virtual machine. The Hitachi Adapters Virtual Appliance queries for command devices and configures itself automatically. Default username/password: root/hitachi1 8. To change the IP of the virtual machine, log in to the VM by using SSH. Navigate to the /etc/sysconfig/network-scripts directory, and locate its configuration file, ifcfg-eth0. Change the IP in the file as follows: 9. Save the change. 10. Reboot the VM. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 25

26 Importing the delivery unit to SAP HANA Tip: If you have trouble identifying the command devices, you can match the Device WWN with the LDEV ID. The last four digits of the Device WWN, starting with naa.6006, correspond to the LDEV ID. Note: Alternatively, you may use the iscsi software initiator to map a command device directly to the Hitachi Adapters Virtual Appliance. Importing the delivery unit to SAP HANA After installing Hitachi HANA Management Service, import the delivery unit to SAP HANA. This operation requires the following roles for the client: sap.hana.uis.db::site_designer sap.hana.xs.admin.roles::httpdestadministrator sap.hana.xs.lm.roles::administrator Procedure 1. Go to page=dumanagementtab 2. Access SAP HANA Application Lifecycle Management. 3. Click PRODUCTS. 4. Click Delivery Units tab. 5. Ensure that you have deleted any existing delivery units. See Uninstallation of the Hitachi HANA management service (on page 31) 6. Click Import. 7. Select the delivery unit file, HANA_ADAPTER_DU-hds.com.tgz. Configuring the HTTP Destination Next, you need to configure the HTTP destination. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 26

27 Configuring the HTTP Destination Procedure 1. Go to HANA_Adapter_No_MVC.services/httpDestination/HitachiHanaService 2. On the XS Artifact Administration screen, type HitachiHanaService to find the httpdest file. 3. Click Edit if you wish to modify the httpdest file by changing the IP address and port of the Hitachi HANA Management service. 4. Click the Authentication Details tab. 5. Click Edit. 6. Select SSL Enabled. Note: If the name of the target system is not the default HIT, then editing the http destination directly is not allowed. In this case, extend the http destination, and edit by performing the following steps: 7. Uncheck SSL Host Check. 8. Select Anonymous under SSL Authentication Type if using self- signed SSL certification. 9. Select Basic under Authentication Type. 10. Provide the username and password for http basic authentication. Default username/password: Admin/Hitachi1 11. Click Save. 12. Click Extend on the bottom right of the screen. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 27

28 Changing the Session Timeout 13. If this is the first time that you are installing the adapter, click New Package, and provide the extension package with extension name. Otherwise, select an existing package. 14. Click Create Extension. 15. Click Edit. Changing the Session Timeout SAP HANA only allows 10 minutes as the maximum timeout as default. Many storagerelated operations require more than 10 minutes. If you need to increase the maximum timeout value, follow the procedure: Procedure 1. From HANA Studio, select the HANA system. 2. From HIT system view, choose Configuration and Monitoring, and Open Administration. 3. Click the Configuration tab, and expand xsengine.ini. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 28

29 Changing the Session Timeout 4. On httpserver, find or create the max_request_runtime and sessiontimeout parameters. Change both parameters to a higher number of seconds, such as 1800 or more. 5. Modify the icm/server_port parameter in the profile under the webdispatcher.ini section by changing the value of PROCTIMEOUT to 1800 or more if necessary. If you are using http to access SAP HANA, you only need to change icm/server_port_0. If you are also using https, you need to change icm/ server_port_1 as well. Note: Skip this step, if you use SAP HANA2.0 SPS2 which doesn't have webdispatcher.ini. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 29

30 Upgrading the HANA Management Service Upgrading the HANA Management Service Some users may already installed the previous version and have some data/ configuration. If they want to upgrade the previous version to this new version and keep the data/configuration, they can use the following steps for upgrading, after installing the OVA of the new version. Procedure 1. Log in the VM that has the new version by using SSH and a user account that has root privilege. 2. Go to the /opt/hitachi/hihana/scripts folder 3. Run the shell script:./hihana_upgrade.sh 4. Provide the IP/DNS address of the previous version: SSH username and password. 5. Confirm the upgrade. Then the upgrade script automatically connects with the previous VM version and transfer the data/configuration to the new VM version. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 30

31 Uninstallation of the Hitachi HANA management service Uninstallation of the Hitachi HANA management service Procedure 1. Go to vcenter or Hyper-V Manager. 2. Select the virtual appliance. 3. If you are using vcenter, right-click the server that you are deleting, and select Delete from Disk. 4. If you are using Hyper-V, select Delete. Uninstalling the delivery unit Procedure 1. Go to page=dumanagementtab 2. Access SAP HANA Application Lifecycle Management. 3. Click PRODUCTS. 4. Click Delivery Units. 5. Select HANA_Adapter_DU (hds.com). 6. Click Delete. Backing Up the Adapter Configuration Repository The adapter uses the SQlite database to store the history records of HANA storage snapshots, performance information, and scheduler information. Even if the SQlite database crashes, you can still find the records of the HANA storage snapshot from the HANA database. Backing up the SQLite database is optional. Procedure 1. Log in to the virtual appliance with a super user account (for example, root). 2. Stop the Hitachi HANA Management service by typing service supervisord stop. 3. Copy the all db files (for example, hanastoragedata.sqlite) from the installation directory (/opt/hitachi/hihana) to the backup location that you prefer. Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 31

32 Backing Up the Adapter Configuration Repository 4. Restart the Hitachi HANA Management service by typing service supervisord restart Note: To recover the DBs, then copy the backup files back to the installation directory (/opt/hitachi/hihana) and restart the service by typing service supervisord restart Chapter 3: Installation Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 32

33 Chapter 4: Operations HANA storage adapter helps SAP HANA users to efficiently manage their Hitachi storage on SAP HANA environment. It simplifies storage replication operations and monitors storage performance as well as status. It supports Hitachi thing image, shadow image and HANA storage snapshot for OS backup, database backup and database clone. It also provides detailed information of Hitachi storage, such as used capacity, free capacity, LUN/Port performance, storage topology. Overview of Features To use this adapter, you must first register the HANA instance, the HANA host, and the storage. The following workflow shows the sequence of registration. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 33

34 Launching the UI for Hitachi Adapter for the SAP HANA Cockpit Launching the UI for Hitachi Adapter for the SAP HANA Cockpit Procedure 1. After you install the Hitachi Adapter for the SAP HANA Cockpit, open the adapter by navigating to the following link: HANA_Adapter_No_MVC/WebContent/index.html (The IP address in this link is an example. Replace it with your own.) 2. Log in as a system user for SAP HANA instance. 3. Once you are logged in, the following screen appears. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 34

35 Registering a HANA Instance Registering a HANA Instance HANA instance registration registers the provided HANA instance with a HANA host on the inventory of the management web service. You can perform subsequent management operations by using the results of this registration feature. Procedure 1. After you log in to the UI, click the + sign next to HANA Instances on the upper left. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 35

36 Registering a HANA Host 2. Provide information for the parameters listed below. Input Parameters Name Master Host Name HANA Instance Number HANA User Name HANA Password Description DNS name or IP of the master host Instance number of this HANA system User name of this HANA system Password of this HANA system Registering a HANA Host After you register the HANA instance, you can register the hosts of the specified HANA instance. This feature registers the related HANA hosts on the inventory of the management web service. Note: The host name must be the same as the name presented on the HANA instance database. You can perform subsequent management operations by using the result of this registration feature. Provide the SSH credential that has root privileges. The adapter can then scan the host and find all the volumes of Logical Volume Management (LVM) on the HANA host. To add a HANA host, follow the procedure: Procedure 1. Click on the HANA instance that appears under HANA Instances on the left. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 36

37 Registering a HANA Host 2. Click Register Host under Actions, on the left bottom. 3. Enter the correct parameters in the next window. Input Parameters Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 37

38 Registering Hitachi Storage Name Type Description HANA Host Name String DNS name or IP address of the master host. This must be the same as the name that is presented to the HANA database. SSH User Name String SSH user name of this HANA host. This user account must have sudo privilege by using SSH. SSH Password SecureString SSH password of this HANA host. This user account must have sudo privilege by using SSH. Registering Hitachi Storage After you register a specified HANA host, you can register the Hitachi storage systems that the HANA host has used, assuming that each HANA host uses only one Hitachi storage system. This feature registers the related Hitachi storage on the inventory of the management web service. You can perform subsequent storage management operations (that is, Hitachi Thin Image and ShadowImage) after you register the storage by using the adapter. Provide the user credentials and IP address that provide access to the Hitachi storage. The adapter scans the Hitachi storage according to your input. See the following screenshot. Input Parameters Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 38

39 Creating a HANA Storage Snapshot with Hitachi Thin Image Name Type Description Storage Serial Number String Serial number of the Hitachi storage Storage Location (IP) String IP of the Hitachi storage Storage User Name String User name for accessing the Hitachi storage Storage Password String Password for accessing the Hitachi storage Creating a HANA Storage Snapshot with Hitachi Thin Image This feature allows you to create a HANA storage snapshot using Hitachi Thin Image. With this feature, you may either create the HANA storage snapshot instantly or schedule a specified date/time for automation of the HANA storage snapshot. You can also choose to use HTI or floating device when you create the HANA storage snapshot. Before you begin Create a Hitachi Thin Image (HTI) pool on your Hitachi storage system, before using this feature. A HANA storage snapshot is an option of a database backup. It includes all the data that is required to recover the database to a consistent state. A HANA storage snapshot captures the content of the SAP HANA data area at a particular point in time. Strongly recommended that you create a full file system backup of your HANA instance before you create any HANA storage snapshot. SAP does not provide an integrity check for an HANA storage snapshot. Instead, SAP recommends that you combine storage snapshots with traditional data backups. Note: SAP does not support storage snapshots with SAP HANA if the data resides in multitenant database containers. Use this feature only with SAP HANA single-database containers. See Create a Storage Snapshot (SAP HANA Studio) for details. Hitachi Thin Image has two options: HTI and floating device. This adapter supports both of them for creating a HANA storage snapshot. They have the following differences. 1. Floating device does not have a V-VOL ID or an LUN name. Therefore, it cannot be mapped to any host group. 2. Due to the reduction of internal resources of storage (for example, V- VOL ID), the speed of floating device is faster. 3. Floating device is only available on VSP G/Fx00 and G/F1000 series. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 39

40 Creating a HANA Storage Snapshot with Hitachi Thin Image Input Parameters Name HTI Pool LUNs HTI pool for the storage snapshot Description Selected LUNs for the storage snapshot. Initially, all LUNs in the data volume are selected by default. Note: This operation may take a while. However, SAP HANA by default allows 300 seconds as the maximum session timeout period. If you receive a timeout error, change the session timeout. See Changing the Session Timeout (on page 94). Procedure 1. Select the type of the task. You may either select Execute Now to create the HANA storage snapshot instantly or select Recurring to create a schedule that automatically and recurrently creates the HANA storage snapshot according to the schedule. If you select to create it instantly, then go directly to step Define the recurring schedule. Provide a unique schedule name. Select the recurring time of the schedule. You can select a daily, weekly, or monthly schedule and define the start time. The time that you set is relative to the time zone that is set on the adapter management server that runs the task. After the schedule is created successfully, the following image appears (dailynoon is an example of a schedule name). Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 40

41 Creating a HANA Storage Snapshot with Hitachi Thin Image Note: It is recommended that you schedule a few snapshots per day with at least one hour between jobs. This is to ensure that the previous jobs complete successfully before the next jobs begin. The Schedule tab displays all created schedules. It allows you to view the details of a schedule. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 41

42 Creating a HANA Storage Snapshot with Hitachi Thin Image The following table describes each property. Property Description ScheduleName ScheduleType ScheduleSetting Previous FireTime Local Next FireTime Local Schedule name Schedule type (for example, floating device snapshot, HTI snapshot) Trigger settings of the schedule (for example, every day at 2 PM) Previous fire time of this schedule (local time zone) Next fire time of this schedule (local time zone) The Job Progress section displays the progress of the jobs and whether each job has succeeded or failed. See the following screenshot for an example. Below the Job Progress section, the Job History section displays the history of all schedules. The history report of schedules allows you to view when each schedule started, how long each schedule has been running, and the error message if the schedule task has failed. See the following screenshot for an example. You may manually delete a HANA storage snapshot schedule from the schedule list when you no longer want to run the schedule. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 42

43 Creating a HANA Storage Snapshot with Hitachi Thin Image To delete a schedule, follow these steps: a. Open the list of schedules. b. Find the schedule that you want to delete. c. Click the red icon on the Delete column. d. In the Confirm dialog box, click OK. Then this schedule is deleted permanently. 3. Select the type of Hitachi Thin Image. You can select HTI or floating device. If you select floating device, then go directly to step Select the host group. The UI lists all available host groups with the associated port of the Hitachi storage array. Select the host group that you need to map for the HTI. It is suggested that you create and use a dummy host group. 5. Select the HTI pool. The UI lists all available HTI pools for selection. Also, the UI lists all LUNs of HANA data volume of the specified HANA instance for review. 6. Confirm the selection by clicking Confirm. If the task is an instant task, the adapter creates the HANA storage snapshot instantly and displays the result. If the task is scheduled, the adapter shows this message: This schedule has been created successfully. If you chose to create the snapshot using Execute Now, the software will instantly create a task for this operation and display "This task has been created." screen. You can come to job progress report to monitor the progress. When the job is completed, you can come to job history report to view the results as the following image. The red box in the following image shows the group ID, which can be used in the recovery procedure for locating this particular snapshot. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 43

44 Verifying HANA Storage Snapshot from HANA Studio Verifying HANA Storage Snapshot from HANA Studio After the operation, verify the backup status by using the specified backup ID and HANA Studio. Procedure 1. Open HANA Studio, and right-click the HANA instance. 2. Choose Backup and Recovery 3. Click Open Backup Console. 4. Click Backup Catalog tab and select the backup snapshot, making sure that the listed ID under Backup Details matches the provided backup ID. Recovering a HANA Database from a HANA Storage Snapshot Note: It is recommended that you cancel any scheduled snapshots before beginning the recovery process. To recover your HANA database from a HANA storage snapshot, follow the steps in the following three sections: 1. Putting the HANA System Offline 2. Reverting a HANA Storage Snapshot Using the Windows Offline Client 3. Recovering the HANA System Using HANA Studio Procedure 1. Putting the HANA System Offline a. Use HANA Studio to bring the HANA system offline. b. Select Backup and Recovery. c. Select Recover System. d. Select Recover the database to a specific data backup or storage snapshot. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 44

45 Recovering a HANA Database from a HANA Storage Snapshot e. Click Next f. A list of snapshots appears. Select the snapshot to recover. Keep this window open and proceed to the next step. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 45

46 Recovering a HANA Database from a HANA Storage Snapshot g. Use SSH to access your HANA system. Type umount /hana/data to let HANA host unmount the data volumes. Once you finish the steps in this section, proceed to the following section. 2. Reverting a HANA Storage Snapshot Using the Offline GUI a. Navigate to the standalone web GUI by using browser to access <HiHANA_Appliance_IP>:8028/offline b. Select the HANA instance. c. Under Operation Type, select Revert. d. Select the snapshot group to revert, and click Step 4 in the lower left corner of the screen. e. Review the information, and click Confirm. Once you finish these steps, proceed to the following section. 3. Recovering the HANA System Using HANA Studio a. Use SSH to access your HANA system. Type mount a to let HANA remount the recovered data volumes. b. Return to HANA Studio, and click Refresh. The snapshot in the screen that you kept open should now display green, as shown in the following example. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 46

47 Recovering a HANA Database from a HANA Storage Snapshot c. Click Next. d. Click Finish. Wait until HANA Studio displays the success message. The following three screens appear. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 47

48 Recovering a HANA Database from a HANA Storage Snapshot Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 48

49 Recovering a HANA Database from a HANA Storage Snapshot Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 49

50 Cloning HANA Systems Using Hitachi Thin Image Cloning HANA Systems Using Hitachi Thin Image This operation can support OS backup and HANA system replication/cloning. Note: SAP does not support storage snapshots with SAP HANA if the data resides in multitenant database containers. Use this feature only with SAP HANA single-database containers. If you wish to put a Hitachi Thin Image (HTI) pair on a specified HTI pool, create the pool on your Hitachi storage before using this feature. The following figure shows a scenario of support for HANA system replication/cloning. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 50

51 Cloning HANA Systems Using Hitachi Thin Image Before you begin If you plan to place an HTI pair in an HTI pool, first create one on your Hitachi storage. SAP recommends that you select only data, log, and shared volumes. Procedure 1. List all LDEVs of data, log, and shared volumes of the specified HANA instance. 2. List all available HTI pools and host groups for selection. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 51

52 Splitting Replication Pairs Using Thin Image 3. Select all LDEVs, HTI pools, and host groups that you listed in the first two steps. 4. Confirm the selection by clicking Confirm. 5. The software creates a task for this operation and displays This task has been created screen. You can go to a job progress report to monitor the progress. When the job is completed, you can go to job history report to view the results. Splitting Replication Pairs Using Thin Image Procedure 1. Wait until the status of all HTI pairs of the consistency group is PAIR. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 52

53 Splitting Replication Pairs Using Thin Image 2. (HANA Studio) Bring the HANA system offline. 3. Navigate to the standalone web GUI by using browser to access: of hihana appliance>:8028/offline. 4. Select the HANA instance. 5. Under Operation Type, select Split. 6. Select the snapshotgroup. 7. Review the information, and click Confirm. Note: Before you can mount the V-VOLs to the new server, you may need to reboot the server to make the LUNs visible on the remote host. 8. Mount the V-VOLs to the new HANA server, and use the SAP HANA utility (hdblcm) to register the new HANA system by following the official SAP HANA system clone procedure. (See c6/22d640e47e4c0ebca8cbe74ff9550a/content.htm.) Example of a mount command: saphanas :# vgchange -a y vglog 1 logical volume(s) in volume group "vglog" now active saphanas : /# mount /dev/mapper/vglog-lvlog /hana/log 9. Follow the SAP HANA system clone procedure in Copy or Clone an SAP HANA System. Note: The hdblcm may not start and return error messages in some cases (for example, the target host already has a HANA instance that has the same instance name and number as a HANA system clone). You can use hdbreg or hdbrename to register or regname the cloned HANA instance on the target host. You can find hdbreg/hdbrename in the <installation path>/<sid>/global/hdb/install/bin folder. ( ce24c3bb571014bcfdf6abefff1d4f/content.htm) Input Parameters Name Type Description HTI Pool String HTI pool for the Thin Image pairs Hostgroup String Host group for the V-VOLs of the replication pairs LUNs String Selected LUNs for the Thin Images. All LUNs of the data, log, and shared volumes are selected by default. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 53

54 Cloning HANA Systems Using Hitachi ShadowImage Cloning HANA Systems Using Hitachi ShadowImage This operation can support OS backup and HANA system replication/cloning. The following figure shows a scenario of support for HANA system replication/cloning. Before you begin If you plan to place the ShadowImage pair in a DP pool or parity group, first create one on your Hitachi storage. SAP recommends that you select only data, log, and shared volumes. Procedure 1. List all LDEVs of the data, log, and shared volumes of the specified HANA instance. 2. List all available DP pools, parity groups, and host groups for selection. 3. Select the LDEVs, DP pool/parity groups, and host groups that you listed in the first two steps. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 54

55 Splitting Replication Pairs Using ShadowImage 4. Confirm the selection by clicking Confirm. 5. The software creates a task for this operation and displays This task has been created screen. You can go to a job progress report to monitor the progress. When the job is completed, you can go to job history report to view the results. Splitting Replication Pairs Using ShadowImage Procedure 1. Wait until the status of all SI pairs of the consistency group is PAIR. 2. (HANA Studio) Bring the HANA system offline. 3. Navigate to the standalone web GUI by using browser to access of hihana appliance>:8028/offline. Select the HANA instance. 4. Under Operation Type, select Split. 5. Click the Consistency Group and select the specified Consistency Group from the dropdown list. 6. Review the information, and click Confirm. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 55

56 Backing up HANA OS by Using HTI/ShadowImage Note: Before you can mount the V-VOLs to the new server, you may need to reboot the server to make the LUNs visible on the remote host. 7. Mount the V-VOLs to the new HANA server, and use the SAP HANA utility (hdblcm) to register the new HANA system by following the official SAP HANA system clone procedure. See c6/22d640e47e4c0ebca8cbe74ff9550a/content.htm. Example of a mount command: saphanas :# vgchange -a y vglog 1 logical volume(s) in volume group "vglog" now active saphanas : /# mount /dev/mapper/vglog-lvlog /hana/log 8. Follow the SAP HANA system clone procedure in Copy or Clone an SAP HANA System. Note: The hdblcm may not start and return error messages in some cases (for example, the target host already has a HANA instance that has the same instance name and number as a HANA system clone). You can use hdbreg or hdbrename to register or rename the cloned HANA instance on the target host. You can find hdbreg/hdbrename in the <installation path>/<sid>/global/hdb/install/bin folder. See ce24c3bb571014bcfdf6abefff1d4f/content.htm. Input Parameters Name Type Description DP Pool or Parity Group String DP pool/parity group for the ShadowImage pairs Hostgroup String Host group for the S-VOLs of the replication pairs LUNs String Selected LUNs for the ShadowImages. All LUNs of the data, log, and shared volumes are selected by default. Backing up HANA OS by Using HTI/ShadowImage Creating Thin Image and ShadowImage can also support OS backup. The following figure shows a scenario of support for OS backup. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 56

57 Backing up HANA OS by Using HTI/ShadowImage Before you begin If you plan to place an HTI pair in an HTI pool, first create one on your Hitachi storage. If you plan to place a ShadowImage pair in an HDP pool, first create one on your Hitachi storage. Procedure 1. List all LDEVs of the specified HANA instance. 2. List all available HTI pools and host groups for selection. 3. Select the host groups and the LDEV of the OS that you listed in the first two steps. An example is shown in the following screenshot. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 57

58 Backing up Full HANA System 4. Confirm the selection by clicking Confirm. 5. The software creates a task for this operation and displays This task has been created screen. You can go to a job progress report to monitor the progress. When the job is completed, you can go to job history report to view the results. 6. To split replication pairs, follow the steps under Splitting Replication Pairs Using Thin Image (on page 52) or Splitting Replication Pairs Using ShadowImage (on page 55), excluding the first step. 7. To recover the OS, shut down the OS, and use the revert procedure. See Standalone GUI (on page 91). Backing up Full HANA System Before you begin If you plan to place an HTI pair in an HTI pool, first create one on your Hitachi storage. If you plan to place a ShadowImage pair in an HDP pool, first create one on your Hitachi storage. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 58

59 Backing up Full HANA System Procedure 1. List all LDEVs of the specified HANA instance. 2. List all available HTI pools and host groups for the selection. 3. Select the host groups and the LDEV of the OS that you listed in the first two steps. An example is shown in the following screenshot. 4. Confirm the selection by clicking Confirm. 5. The software creates a task for this operation and displays This task has been created screen. You can go to a job progress report to monitor the progress. When the job is completed, you can go to job history report to view the results. 6. Wait until the status of all SI/HTI pairs of the consistency group is PAIR. 7. To split replication pairs, see Splitting Replication Pairs Using Thin Image (on page 52) or Splitting Replication Pairs Using ShadowImage (on page 55), excluding the first step. 8. To revert the replication pair created above, start the HDB service on HANA, and then stop the service. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 59

60 Deleting Replication Pairs Deleting Replication Pairs Deleting the replication pairs and S-VOL/V-VOL on a specified consistency group or snapshot group created in Creating a HANA Storage Snapshot with Hitachi Thin Image (on page 39), Cloning HANA Systems Using Hitachi Thin Image (on page 50), or Cloning HANA Systems Using Hitachi ShadowImage (on page 54). Procedure 1. Navigate to the Actions tab on the left panel, and click Delete Replication Pairs. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 60

61 Deleting Replication Pairs 2. Click Step Select the group mode (Snapshot Group or Consistency Group) and the group to delete (see under Select a Group). The default group mode is Snapshot Group. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 61

62 Monitoring Operations - Job Progress Report After you select the group and group mode, click Step Verify the details, and click Confirm. Then the software creates a task for this operation and displays This task has been created screen. You can go to a job progress report to monitor the progress. When the job is completed, you can go to job history report to view the results. Monitoring Operations - Job Progress Report Checking the current progress of running tasks. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 62

63 Collecting Storage Data and Cache This report includes the following: Property Job Name Job Instance Status Progress Update On Description The name of the job. If the job is a recurring job, then the name is the schedule name. If it is a one-time job, then the adapter automatically creates a unique name for this job. The status of the latest instance of the job (Failed, Success, Canceled, Running, Waiting To Run) The current progress information of this job instance The time stamp of the progress information The following operations can be monitored by using the job progress report: Procedure 1. Creating a HANA Storage Snapshot with Hitachi Thin Image (on page 39) 2. Cloning HANA Systems Using Hitachi Thin Image (on page 50) 3. Cloning HANA Systems Using Hitachi ShadowImage (on page 54) 4. Backing up HANA OS by Using HTI/ShadowImage (on page 56) 5. Deleting Replication Pairs (on page 60) The job progress report displays the progress of all running jobs. If the job is completed, it keeps the progress info for up to 72 hours. The report automatically removes completed jobs that are older than 72 hours. If the job is failed, you can find the detailed error message in the job history report. Collecting Storage Data and Cache This is a pre-defined scheduled job that collects information from registered Hitachi storage. It collects the following information and store for performance reports and cache. Hostgroups Replication Pairs LUN Performance Port Performance LUN Information Storage Pools Parity Group CLPR Schedule Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 63

64 Host Resource Usage Data Collection The dates of all updates that have taken place within the last month are used for performance reports (LUN performance and port performance). The date of the latest update is used as a cache layer. This adapter checks the cache first when it needs any storage-related information. If it cannot find the required information on the cache or if the data of the cache layer is expired (default expire value: 2 hours), then it queries the registered Hitachi storage to get the up-to-date information. You can check the details of this schedule job from the Overview tab. It shows the current scheduled time interval. This job is repeatedly executed on the defined time interval. Also, you may check the previous fire time and next fire time of this job. Configure the Time Interval for Scheduled Storage Data Collection Job You may configure the time interval of the scheduled storage data collection job. The default value is 30 minutes. The minimum value is 15 minutes, and the maximum value is 2,880 minutes (two days). Input the time interval value, and then click Ok. Then this scheduled job is executed with the new time interval. Storage Data Collection Force Update You may manually kick off a storage data collection. After you click Update Storage Data on the action list in the lower left corner, this adapter starts to run the storage data collection instantly. Host Resource Usage Data Collection Host Resource Usage Data Collection Job is a pre-defined scheduled job that collects information from registered HANA host. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 64

65 Host Resource Usage Data Collection The following operations are supported. Get the Schedule of Host Resource Data Collection Start a Host Resource Usage Data Collection Task Instantly Modify the Interval of a Host Resource Usage Data Collection Task The Host Resource Usage Data Collection task is a predefined schedule task (default time interval: 30 minutes). This task checks all registered HANA hosts and collects the resource usage (i.e., CPU, Memory and disk). The collected data can be sent to analytic framework/platform for capacity/performance analysis and troubleshooting. It collects Host CPU Usage, Host Memory Usage, and Host Disk Usage. The user can check the details of this scheduled job from the Host Resource Usage Collection Job section on the Host tab as below: Configure the Time Interval for Scheduled Host Resource Usage Data Collection The user can configure the time interval of the scheduled host resource usage data collection job. The default value is 30 minutes. The min value is 5 minutes and the max value is 2880 minutes (2 days). The user needs to input the time interval value and click the Ok button. Then this scheduled job will be executed by the new time interval. Start a Host Resource Usage Data Collection Task Instantly Host resource usage data collection task is an asynchronous task. This API can start this task, but it does not return the final result of the execution. To check the progress, status, and result of this task, refer to the job-related APIs. Modify the Interval of a Host Resource Usage Data Collection Task The default interval of the Host Resource Usage Data Collection task is 30 minutes. The value of the interval for the Host Resource Usage Data Collection Task should between 5 and Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 65

66 Host Resource Usage Data Collection Force Update Host Resource Usage Data Collection Force Update The user can manually start a Host Resource Usage Data Collection. When the user clicks the Update Host Resource Usage Data on the action list of the lower left corner, the adapter starts the Host Resource Usage Data Collection instantly. Alerts Alerts appear at the top tab of the home page for the Hitachi Storage Adapter for the SAP HANA Cockpit. To refresh the information, you may either click the circular arrow in the upper right corner of the UI or use the refresh button of your browser. The adapter scan all storage pools and generates alerts for any abnormal statuses. The following alerts are preconfigured into the Storage Adapter for the SAP HANA Cockpit. Metric Type Alert Type Condition Message OVERTHRESHOLD Warning Pool status is overthreshold. FAILURE Error Pool status is failure. SUSPENDED Warning Pool status is suspended. Storage pool <poolname> status is overthreshold. Storage pool <poolname> status is failure. Storage pool <poolname> status is suspended. See the following screenshot for an example of the Alerts tab. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 66

67 Threshold Configuration Threshold Configuration Users can configure the pre-defined thresholds. If the configured thresholds are triggered, the adapter sends the notifications to notify the users. Click the Threshold Configuration toolbar button, click the Alert tab. The Threshold Configuration dialog will be displayed. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 67

68 Threshold Configuration Users can change the following threshold values. Save the changes. Input Parameters Name Type Description Comments Host CPU Usage Threshold Integer The threshold of the HANA host CPU usage(min:0% Max:100%, Default:80%) N/A Host Memory Usage Threshold Integer The threshold of the HANA host memory usage(min:0% Max:100%, Default:80%) N/A Storage Port IOPS Threshold Integer The threshold of the port IOPS of the associated Hitachi storage array usage(min:0 Max:1,000,000, Default:8000) N/A Storage LUN IOPS Threshold Integer The threshold of the LUN IOPS of the associated Hitachi storage array usage(min:0 Max:1,000,000, Default:8000) N/A Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 68

69 SMTP Configuration Name Type Description Comments Storage Pool Capacity Threshold Integer The threshold of the used capacity rate(percentage) of storage pools of the associated Hitachi storage array usage(min:0%, Max:100%, Default:80%). Notes: This threshold of the adapter is different with the threshold of storage pool of the storage array that can be configured by using Hitachi Device Manager. The adapter will only send notification when this threshold has been triggered. N/A SMTP Configuration The adapter can send an notification when the pre-defined thresholds are triggered. To send the notifications, users need to configure the SMTP first. To access the SMTP configuration, Users can click Alert tab then click the SMTP Configuration toolbar button, as shown below. Input Parameters Name Type Description Comments SMTP Host String The DNS name or IP of the SMTP server SMTP Port Integer The port of the SMTP server. Default value is 25. N/A N/A Default From String The address that is used to send the notification. N/A To String The addresses that will receive the notification. Notes: It supports multi recipients. Multi recipients should be separate by comma. N/A Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 69

70 Saving SMTP Configuration Name Type Description Comments SMTP Username String The user name for accessing the SMTP server. SMTP Password Secure String The password for accessing the SMTP server. Enable TLS Boolean If the SMTP server requires TLS, enable this option. Default value: false. Timeout Integer The timeout value(second) of the SMTP server. Default value:120 second. N/A N/A N/A N/A Saving SMTP Configuration After providing the SMTP configuration information, click Save. Then the saved information generates an automated notification. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 70

71 Testing SMTP Configuration Testing SMTP Configuration Users can test the saved SMTP configuration to verify the saved information. Click the Test SMTP Configuration button then the adapter sends a test to the saved recipient address. If the user cannot receive the test in 30 minutes, they should check the spam folder or the SMTP configuration on their environment. Trend The trend feature allows the users to use the built-in analytics framework to forecast the usage of host resource and storage resource. The trend result can be used for capacity planning, troubleshooting, and optimization. The forecast uses Holt-Winters method(aka "triple exponential"). This method incorporates a third exponential term which tracks the seasonal aspect of the data. The default value are set as below: Period = 7 (days) Windows (size) = 30 Predict (number of forecast) = 30 Interval = 2 (hours) Host Resource Trend This panel includes three components: CPU Usage Trend Memory Usage Trend Filesystem Trend Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 71

72 CPU Usage Trend CPU Usage Trend To get the trend of the host CPU usage, use this operation. It returns the forecast of the used percentage of the host CPU. This chart shows forecasted CPU usage of a specified HANA host by using the historical data of CPU usage. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 72

73 Memory Usage Trend Memory Usage Trend This report shows memory usage trend of a specified HANA host by using the historical data of memory usage. Filesystem Trend This report shows filesystem usage trend of a specified HANA host by using the historical data of filesystem usage. Users can click the Filesystem Usage Forecast tile. Then select the preferred host filesystem from the popup list by clicking the Click button: Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 73

74 LUN Usage Trend The filesystem usage trend chart will be display as below: LUN Usage Trend This report shows LUN usage trend of the registered Hitachi storage. Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 74

75 LUN Usage Trend It uses the historical data of the used capacity of the LUN for calculating the trend. Note: The used capacity attribute is only applicable for LUNs on DP pool. Other types of LUNs are always same as total capacity or 0. Users can click the LUN Usage Trend tile as below: Then select the preferred LUN from the popup list by clicking the Click button: The LUN usage trend chart will be display as below: Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 75

76 LUN Usage Trend Chapter 4: Operations Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 76

77 Chapter 5: Reporting The following sections describe reports that you can generate to retrieve information about HANA hosts. These reports include device-mapping reports, LUN performance reports, port performance reports, replication reports, and storage snapshot history reports. Reporting Overview To generate reports, first navigate to the Storage tab. Filtering To filter the results of a report, click the parameter that you wish to filter, and type a value into the Filter box. The following three screenshots show an example of filtering the parameter Consistency Group ID. Filtering is only applicable for table-based reports. Filter Context The context filter filters the information and only displays the data related with the specified HANA instance. For example, if a HANA host with an IP address of only uses port CL4-A, then only port CL4-A is displayed in the port performance report when the context filter is turned on. If you turn off the context filter, then all ports of this Hitachi storage array are displayed. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 77

78 Device-Mapping Report You can turn on or turn off the context filter located on left upper corner, as shown below. The context filter is turned on by default. It can help you to quickly find storage information related with your HANA system. The context filter is available for the following reports: LUN Performance Port Performance Replication Host Group Storage Pool Device-Mapping Report After the registration of a specified HANA host and the Hitachi storage, the adapter can generate a device-mapping report that describes the LUNs for the specified HANA host. It shows the related Hitachi storage on the inventory of the management web service. This report shows information about registered storage with the HANA host that you specify. The adapter refreshes the data each time you run the report. To generate a device-mapping report, follow the procedure below. Procedure 1. Click the HANA Host. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 78

79 Hostgroup Report 2. Click Device Mapping tab. You can perform subsequent storage management operations (HTI and ShadowImage) by using the result of this registration feature. Provide the user credential that has access permission to the Hitachi storage as well as to the IP address for this feature. The adapter uses your inputs (see below) to scan the Hitachi storage. All the parameters are required. Property LUN Number Volume Group Mount Point WW ID Description Logical device number Volume group on the HANA host Mount point on the HANA host World Wide Identifier of the logical device Hostgroup Report This report shows information for all hostgroups of the storage registered with the specified HANA host. This report only shows up-to-time data (the latest list of host groups). Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 79

80 LUN Performance Report See the following table for the details of this report. Property Description Hostgroup Name Hostgroup Id HostMode ResourceGroupId Port Paths Hostgroup name Hostgroup ID Host mode information (that is, UNKNOWN, NOT_SPECIFIED, RESERVED, STANDARD, LINUX, VMWARE, HP, OPEN_VMS, TRU64, SOLARIS, NETWARE, WINDOWS, HI_UX, AIX, VMWARE_EXTENSION, WINDOWS_EXTENSION, UVM) ID of the resource group that this host group belongs to Port that this host group resides on LUN paths that are mapped to this host group LUN Performance Report LUN performance reports show information about the performance of all LUNs in registered storage with the HANA host that you specify. The adapter refreshes the data each time you run the report. To generate a LUN performance report, follow the procedure. Procedure 1. Click the Storage. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 80

81 LUN Performance Report 2. Click LUN Performance tab. See the following table for the details of this report. Property LUN Number ReadRate in KB/s WriteRate in KB/s IORate in KB/s RandomReadRate in KB/s RandomWriteRate in KB/s RandomIORate in KB/s SequentialReadRate in KB/s SequentialWriteRate in KB/s SequentialIORate in KB/s ReadCount (IOPS) WriteCount (IOPS) RandomReadCount (IOPS) RandomWriteCount (IOPS) SequencialReadCount (IOPS) SequencialWriteCount (IOPS) Description Logical unit number Read rate in KB/s Write rate in KB/s IO rate in KB/s (ReadRate + WriteRate) Random read rate in KB/s Random write rate in KB/s Random IO rate in KB/s Sequential read rate in KB/s Sequential write rate in KB/s Sequential IO rate in KB/s Read count (IOPS) Write count (IOPS) Number of random reads (IOPS) Number of random writes (IOPS) Number of sequential reads (IOPS) Number of sequential writes (IOPS) Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 81

82 LUN Performance Detail Report LUN Performance Detail Report Procedure 1. Click Details on the LUN Performance report to see a chart that summarizes the details of the specified LUN performance. LUN Performance History Chart Procedure 1. Click under the History tab on the LUN Performance report to see a chart that presents the history (all entries from the last month in the storage data collection) of the specified LUN performance. You can select Grouped or Stacked to change the way the data is presented. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 82

83 Port Performance Report Port Performance Report Port Performance report shows information for the performance of all ports in registered storage with the HANA host that you specify. The adapter refreshes the data each time you run the report. Procedure 1. Click the Storage. 2. Click Port Performance tab. See the following table for the details of this report. Property Description Port Name Average IOPS Max IOPS Min IOPS Max Port Transfer Average Port Transfer Min Port Transfer Collection Date Time Port name Average IO per second Maximum IO per second Minimum IO per second Maximum port transfer (KB per second) Average port transfer (KB per second) Minimum port transfer (KB per second) Timestamp of the performance data taken Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 83

84 Replication Report Port Performance History Chart You also can click History on the Port Performance report to see a chart that presents the history (all entries from the last month in the storage data collection) of the specified port performance. You can select Grouped or Stacked to change the way the data is presented. Replication Report Replication report shows information for all replication pairs in registered storage with the HANA host that you specify. The adapter refreshes the data each time you run the report. Procedure 1. Click the Storage. 2. Click Replication Report tab. See the following table for the details of this report. Property Serial Number Description Serial number of the storage. If it is -1, the pair is a remote replication pair. Data Pool ID ID of the data pool that this replication pair uses. If it is -1, then the replication pool does not use any data pool on this storage device. Consistency Group ID P-VOL ID of the consistency group for this replication pair. If it is -1, then this pair does not use any consistency group. LUN number of the P-VOL Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 84

85 Storage Pool Report Property S-VOL/V-VOL Pair Type Pair Status Pair Name Mirror ID Description LUN number of the S-VOL or V-VOL. If the pair type is TI, then it is the LUN number of the V-VOL. If the pair type is SI, then it is the LUN number of the S-VOL. Type of pair (SI, TI, UR, TC) Status of the pair (that is, SMPL(PD), COPY, PAIR, PFUL, PFUS, PSUS, RCPY, PSUE) Name of the pair ID of the mirror unit Storage Pool Report Storage Pool report shows information for all storage pools of the storage that is registered with the specified HANA host. This report only shows up-to-time data (the latest list of storage pools). See the following table for the details of this report. Property Description Serial Id Name TotalCapacityInMB FreeCapacityInMB Type Status Storage serial Storage pool ID Storage pool name. For parity group, it is blank. Total capacity (MB) Free capacity (MB) Type of this storage pool (UNKNOWN, HDP, SNAPSHOT, HDT, HTI, DATAPOOL, HDT_AF, PARITYGROUP, RAIDGROUP) Current status of this storage pool (UNKNOWN, NORMAL, OVERTHRESHOLD, SUSPENDED, FAILURE, SHRINKING, REGRESSED) Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 85

86 Storage Pool Report Property Description UtilizationRate SubscriptionRate SubscriptionWarnin grate WarningThresholdR ate DepletionThreshold Rate Tiers VirtualLUCount Utilization percentage Current subscription percentage. For a non-hdp/hdt pool, this value is blank or -1. Subscription warning rate. For AMS data pools and RAID devices, this value does not apply and is blank or -1. Warning threshold percentage. If no warning threshold is set or if this represents a data pool, this value is -1. Depletion threshold percentage. If no depletion threshold is set, this is -1. This is also known as the high-water mark. For data pools, this value represents the singular threshold. The tiers property for HDT pool. Virtual LU count. For DP/DT pools, this value represents the number of virtual volumes. For CoW/TI pools, this value represents the number of snapshots. For AMS data pools, this value is not valid and is set to -1. If the storage pool is a HDT pool, then the users can click the button on the Tiers column to check the sub-report of Tiers as below. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 86

87 Storage Pool Report The Tiers sub-report includes the following: Property Description Id Drive Speed Drive Type Type Total Capacity Used Capacity Utilization Rate Pool tier ID. Pool tier drive speed (RPM). Pool tier drive type. Possible values are SAS,SATA, SSD, FMD, NL_SAS, SAS_SED,SAS_SFF, SSD_SFF, FMC, UNKNOWN. Pool tier type. Possible values are INTERNAL, EXTERNAL_HIGH, EXTERNAL_MID, EXTERNAL_LOW, COEXISTENCE, UNKNOWN. Pool tier total capacity in BYTE. Pool tier used capacity in BYTE. Pool tier utilization rate. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 87

88 Parity Group Report Parity Group Report This report shows information for all drive groups of the storage that is registered with the specified HANA host. This report only shows up-to-time data (the latest list of drive groups). See the following table for the details of this report. Property DriveGroupId TotalCapacity FreeCapacity RaidLevel CLPRId CopybackMode The ID of the drive group Total capacity of this drive group (unit: bytes) Free capacity of this drive group (unit: bytes) Drive Group RAID level. Possible values: RAID0, RAID1, RAID5, RAID6, RAID1+0 Cache Logical Partition ID Copy-Back mode is required for this drive group. This mode does not apply to external drive groups; it is only applicable with SVP IP for VSP Gx00 and Fx00. Does not have copyback/encryption for OUT-OF- BAND mode. CLPR Report This report shows information for all Cache Logical Partition (CLPR) groups of the storage that is registered with the specified HANA host. This report only shows up-to-time data (the latest list of CLPRs). Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 88

89 Storage Snapshot History Report See the following table for the details of this report. Property Description CLPR Id CLPR Name Used Cache Capacity Cache Capacity Usage Rate Write Pending Capacity Write Pending Rate The ID of the CLPR. The name of the CLPR. Used capacity of the cache of this CLPR (unit: bytes) Capacity of the cache of this CLPR (unit: bytes) The rate of used cache. Write pending capacity of the cache of this CLPR (unit: bytes) The rate of write pending cache. Storage Snapshot History Report Storage Snapshot History report shows information about the storage snapshots that the adapter has created since installation. Procedure 1. Click the Storage. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 89

90 Storage Layout Graph 2. Click Storage Snapshot History tab. See the following table for the details of this report. Property Description Instance Host Name Storage Serial Backup ID Backup External ID Group ID Storage Snapshot Status Current Status Update On Details HANA instance name Serial number of the storage Backup ID of this storage snapshot Backup external ID of this storage snapshot ID of the group for this storage snapshot Status of this storage snapshot (success or fail) Whether the snapshot is available Timestamp of the collection Thin Image pair details of the storage snapshot (that is, P-VOL or V-VOL) Storage Layout Graph The storage layout graph visualizes the hierarchical relationship of storage context of a specified HANA host. It shows the structure of LUNs, hostgroups, storage pool, and ports in the registered Hitachi storage for a specified HANA host. The graph displays information about the hostgroup that connects the LUNs to the storage port with the external host. This feature automatically checks the storage layout from collected storage data. If the layout is changed, the layout graph changes as well after the storage cache is updated. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 90

91 Storage Layout History Report Storage Layout History Report The adapter backs up the storage layout as a daily task. It saves the data for up to 30 days. To check the graph, select any of the historic storage layout from the past 30 days, and then click Ok. This feature allows you to monitor and compare the changes of storage configuration. For example, if you want to troubleshoot a problem that is caused by recent changes with the Hitachi storage on your HANA environment, you can check the Storage Layout History Report and compare the changes between now and the previous week. Standalone GUI A standalone web GUI has been provided for the storage related operations when the HANA system is offline. It can connect to the HANA management web service and execute the storage related operations. This standalone GUI application supports the following operations: split pairs by snapshot group or consistency group resync pairs by snapshot group or consistency group revert pairs by snapshot group or consistency group To use this standalone GUI, follow the procedure bellow: Procedure 1. Open a browser. 2. Go to 3. Log in to the web GUI. Default username/password: Admin/Hitachi1 Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 91

92 Standalone GUI 4. Select the HANA instance that you want to run this operation (for example, Split, Resync, and Revert). Click Step Select the operation (for example, Split, Resync, and Revert). Also, you may click Update Storage Cache to get up-to-date storage information. 6. Select the group type (for example, Snapshot Group or Consistency Group), and then select the specified group from the dropdown list. Click Step The web GUI lists all pairs of the selected group for review. After reviewing all details, click Confirm to start the operation. Note: If the replication pair type is HTI, then it is recommended to go with the snapshot group first. When using the consistency group mode, note that APIs that this adapter uses may not return valid CTG IDs in some cases. It is highly recommended to check the PVL, P-VOL name, and MU ID to select the pair rather than using the CTG ID. The standalone GUI executes the operation and then displays the result if it is successfully completed. Chapter 5: Reporting Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 92

93 Chapter 6: Logging, Troubleshooting, and Error Messages Logging Find log files in this location: /opt/hitachi/hihana/logs The adapter supports the following logging levels: CRITICAL (or FATAL) ERROR WARNING INFO DEBUG The default logging level is INFO. You can change the logging level in the config.py file in the installation folder as shown below: LOGLEVEL = 'DEBUG' Log Generation and Rotation Multiple log generation and rotation of the adapter log files create multiple log files. The active log filename is hihana.log. The log generation and rotation of the adapter log files allow you to do the following: Rotate the current or active log file by incrementing the log file name, appending consecutive numbers that start from zero to a user-specified limit or a system default. Specify a maximum log file size in config.py by editing the [HIHANA_LOG_SIZE_MB] key. If the value of the log file size is greater than the specified [HIHANA_LOG_SIZE_MB] value, then the log file is automatically rotated. The default value of [HIHANA_LOG_SIZE_MB] is 50. Specify a maximum number of backup log files in config.py by editing the [HIHANA_LOG_BACKUP_COUNT] key. The default value is 10. The default log level is INFO. Following is a sample of normal log output: [22413:{ }] [ :11:46,321] [hihana] [INFO] [hostservers.py] [get_serverfrus][enter] [22413:{ }] [ :11:46,322] [hihana] [INFO] [hostservers.py] [get_serverfrus][hostname:saphanas ] Chapter 6: Logging, Troubleshooting, and Error Messages Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 93

94 Troubleshooting [22413:{ }] [ :11:46,323] [hihana] [INFO] [pumahelper.py] [call_puma_api][puma API GET call: Headers: {'X-Management-IPs': u' ', 'X-Subsystem-User': u'admin', 'Content- Type': 'application/json; charset=utf-8', 'Accept-Encoding': 'identity', 'Accept': 'application/ json'} Data: None] [22413:{ }] [ :11:48,822] [hihana] [INFO] [hostservers.py] [get_serverfrus][exit] Troubleshooting Changing the Session Timeout SAP HANA only allows 10 minutes as the maximum timeout by default. Many storagerelated operations need more than 10 minutes. If you need to increase the maximum timeout value, follow the procedure below. Procedure 1. From HANA Studio, select the HANA system. 2. From system view, go to Configuration and Monitoring, choose Open Administration. Chapter 6: Logging, Troubleshooting, and Error Messages Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 94

95 Changing the Session Timeout 3. Click the Configuration tab, and expand xsengine.ini. 4. On httpserver, find or create the max_request_runtime and sessiontimeout parameters. Then change both parameters to a higher number of seconds 1800 or more. 5. Modify the icm/server_port parameter in the profile under the webdispatcher.ini section by changing the value of PROCTIMEOUT to 1800 or more if necessary. If you are using http to access SAP HANA, you only need to change icm/server_port_0. If you are also using https, you need to change icm/ server_port_1 as well. Note: Skip this step, if you use SAP HANA2.0 SPS2 which doesn't have webdispatcher.ini. Chapter 6: Logging, Troubleshooting, and Error Messages Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 95

96 Cleaning the Cache When the Delivery Unit Fails to Import Cleaning the Cache When the Delivery Unit Fails to Import Sometimes, the delivery unit fails to import to SAP HANA when you are using SAP HANA Application Lifecycle Management with your browser. To solve this problem, clean the cache of your browser, and try again. Restarting the Web Service to Solve an Error Message When registering a HANA instance, host, or storage, you may see the following error message: Error occurred while getting the host storage. 'hihanaredbeatstoragedatacollection'. To fix this, follow the procedure below. Procedure 1. Log in to the virtual appliance by using SSH with the root account. Default username/password: root/hitachi1 2. Enter service puma restart. 3. Wait 30 seconds. 4. Enter service supervisored restart. Chapter 6: Logging, Troubleshooting, and Error Messages Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 96

97 Troubleshooting Diagnostic Steps Troubleshooting Diagnostic Steps Use the flowchart below followed by the Troubleshooting tips. Troubleshooting #1: Investigate the SAP HANA environment. If SAP HANA cannot be reached or is experiencing performance problems, open the Administration editor in diagnosis mode to resolve this issue by following the SAP HANA procedure. See helpdata/en/95/fc8adf6c5a46e7bc3a0a29b63ec6bb/content.htm) Troubleshooting #2: Investigate the adapter logs. Review the log file (hihana.log) under the logs subfolder of the installation folder. Study the recommended action for resolving the issue from the error message list by checking the error message ID. When All Troubleshooting Recommendations Have Been Exhausted If you could not solve the problem using the above troubleshooting recommendations, run the collect_hihana_info.sh script to create a tar archive file containing pertinent information to assist Hitachi Vantara engineers in resolving the issue. To execute collect_hihana_info.sh, run the following command: /opt/hitachi/ hihana/collect_hihana_info.sh. Chapter 6: Logging, Troubleshooting, and Error Messages Hitachi Storage Adapter for the SAP HANA Cockpit User's Guide 97