hitachi storage adapter for the sap hana cockpit · pdf filehitachi storage adapter for the...

MK-92ADPTR111-00

Hitachi Storage Adapter for the SAP HANA Cockpit

User’s Guide

v01.0.0

Hardware and Software Requirements

Contents

Getting Help

FASTFIND LINKS

©2016 Hitachi, Ltd. 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

Data Systems 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 Data Systems Corporation at https://portal.hds.com.

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 Data Systems 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.

https://portal.hds.com/

Contents 3

Hitachi Storage Adapter for the SAP HANA Cockpit v01.0.0 User’s Guide

Contents

Contents ........................................................................................ 3

Preface .......................................................................................... 7

Intended Audience ..................................................................................... 8

Related Document ..................................................................................... 8

Release Notes ........................................................................................... 8

Document Conventions .............................................................................. 8

Getting Help ............................................................................................ 10

Comments .............................................................................................. 10

1 Hardware and Software Requirements ....................................... 11

Supported Hardware and Software ............................................................ 12

Hardware Requirements for Adapter Management Server ................................. 12

Software Requirements .................................................................................. 12

Operating Systems ................................................................................... 12

Adapter Management Server Operating Systems .............................................. 12

HANA Database Operating Systems ................................................................. 12

Storage Models ........................................................................................ 13

Replication Software ................................................................................ 13

Maximum Storage Consistency Groups ............................................................ 13

Host Interface ......................................................................................... 14

Volume Type ........................................................................................... 14

4 Hardware and Software Requirements


2 Architecture ................................................................................. 15

3 Installation .................................................................................. 17

Required Pre-installation on Management Server ........................................ 18

Hitachi Command Control Interface (CCI) ........................................................ 18

Installing the SAP HANA Windows Client .......................................................... 21

Java .............................................................................................................. 22

Distribution Package ................................................................................ 23

Installing and Uninstalling......................................................................... 24

Installation Overview ...................................................................................... 24

Installation Procedure ..................................................................................... 24

Uninstallation ................................................................................................. 39

4 Operations ................................................................................... 41

Overview of Features ............................................................................... 42

Launching the UI for Hitachi Adapter for SAP HANA Cockpit ........................ 44

Discovering a HANA Instance .................................................................... 45

Input Parameters ........................................................................................... 46

Discovering a HANA Host.......................................................................... 47


Discovering Hitachi Storage ...................................................................... 49


Creating a HANA Storage Snapshot with Hitachi Thin Image ....................... 50

Prerequisites .................................................................................................. 50


Procedure ...................................................................................................... 50

Recovering a HANA Database from a HANA Storage Snapshot ..................... 54

Procedure ...................................................................................................... 54

Cloning HANA Systems Using Hitachi Thin Image ....................................... 57

Prerequisites .................................................................................................. 59

Procedure ...................................................................................................... 59

Operations 5


Cloning HANA Systems Using Hitachi ShadowImage ................................... 62

Prerequisites .................................................................................................. 63

Procedure ...................................................................................................... 63


Backing up Hitachi OS by Using HTI/ShadowImage .................................... 66

Prerequisites .................................................................................................. 67

Procedure ...................................................................................................... 67

Splitting ShadowImage or Hitachi Thin Image Pairs .................................... 69

Resyncing ShadowImage or Hitachi Thin Image Pairs ................................. 71

Reverting Replication Pairs by Using Consistency Groups ............................ 73

Deleting Replication Pairs by Using Consistency Groups .............................. 75

5 Reporting .................................................................................... 77

Overview ................................................................................................ 78

Filtering ......................................................................................................... 78

Device-Mapping Report ............................................................................ 80

LUN Performance Report .......................................................................... 82

Port Performance Report .......................................................................... 83

Replication Report ................................................................................... 84

Storage Snapshot History Report .............................................................. 86

6 Logging, Troubleshooting and Error Messages ............................ 87

Logging .................................................................................................. 88

Log Generation and Rotation .......................................................................... 88

Sample Log Output ........................................................................................ 89

Troubleshooting ...................................................................................... 94

Changing the Session Timeout ........................................................................ 94

Cleaning the Cache When the Delivery Unit Fails to Import ............................... 98

Updating the PowerShell Console by Pressing Enter ......................................... 98



Turn on port 2022 on Windows firewall ........................................................... 99

Troubleshooting Diagnostic Steps .................................................................. 104

Error Messages .......................................................................................106

Preface 7


Preface

Intended Audience

Related Document

Release Notes

Document Conventions

Getting Help

Comments



Note Your use of the Hitachi Storage Adapter for the SAP HANA Cockpit

and all other Hitachi Data Systems products is governed by the terms of your agreements with Hitachi Data Systems.

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

Name Description

SAP HANA Administration Guide Describes the administrative tasks that SAP HANA system administrators perform regularly and on demand

Release Notes

You can find release notes on the documentation CD. Release notes contain requirements and more recent product information that this manual may not

fully describe. Be sure to review the release notes before installation.

Document Conventions

This document uses the following typographic conventions:

Convention Description

Bold Indicates text on a window, other than the window title, including menus, menu options, buttons, fields, and labels. Example: Click OK.

Italic Indicates a variable, which is a placeholder for actual text provided by the user or system.

Example: copy source-file target-file

Note: Angled brackets (<>) also indicate variables.

screen/code Indicates text on the screen or that you enter. Example: # pairdisplay -g oradb

https://help.sap.com/saphelp_hanaplatform/helpdata/en/33/0e5550b09d4f0f8b6cceb14a64cd22/content.htm?current_toc=/en/00/0ca1e3486640ef8b884cdf1a050fbb/plain.htm&show_children=true

Operations 9

Convention Description

<> angled

brackets

Indicates a variable, which is a placeholder for actual text

provided by the user or system.

Example: # pairdisplay -g <group>

Note: Italic font also indicates variables.

[ ] square brackets

Indicates optional values.

Example: [a | b] indicates that you can select a, b, or nothing.

{ } braces Indicates required or expected values.

Example: { a | b } indicates that you must select either a or

b.

| vertical bar Indicates a choice between two or more options or arguments.

Examples:

[a | b] indicates that you can select a, b, or nothing.

{ a | b } indicates that you must select either a or b.

This document uses the following icons to draw attention to information:

Icon Label Description

Note Calls attention to important and/or additional information

Tip Provides helpful information, guidelines, or suggestions for performing tasks more effectively

Caution Warns the user of adverse conditions and/or consequences (for example, disruptive operations)

WARNING Warns of severe conditions and/or consequences (for example, destructive operations)



Getting Help

The Hitachi Data Systems Support Center staff is available 24 hours a day,

seven days a week. Provisions for patches and fixes are restricted to normal business hours, 8 a.m. to 5 p.m. PST.

To reach us, visit the support website for current telephone numbers and other

contact information: http://www.hds.com/services/support/. If you purchased this product from an authorized HDS reseller, contact that reseller for support.

Before calling the Hitachi Data Systems Support Center, provide as much information about the problem as possible, including:

The circumstances surrounding the error or failure.

The exact content of any error messages displayed on the host systems.

Comments

Please send us your comments on this document: [email protected].

Include the document title, number, and revision, and refer to specific sections and paragraphs if possible. Thank you! (All comments become the property of

Hitachi Data Systems Corporation.)

http://www.hds.com/services/support/

mailto:[email protected]

Hardware and Software Requirements 11 11


Hardware and Software Requirements

Supported Hardware and Software

Operating Systems

Storage Models

Replication Software

Host Interface

Volume Type



Supported Hardware and Software

Note This release supports only the hardware and software listed in

this document.

Hardware Requirements for Adapter Management Server

Item Requirements

CPU Pentium 4 or more

Memory 2 gigabytes or more

Graphics 800x600, 16-bit color or more

HDD Capacity 1 gigabyte or more

Supported HBAs

All the HBAs certified by Microsoft on the OS are supported.

Software Requirements

Hitachi Command Control Interface (CCI) 01-36-03/04 or above

SAP HANA Windows Client 1.0.112 or above

Java Runtime Environment version 7 x64 edition installed on the same Windows host that is running the Hitachi Windows service

Note The version 7 x64 JRE edition is specifically required. The more common 32-bit JRE edition does not work.

Operating Systems

Adapter Management Server Operating Systems

OS Version Supported

Windows 2012 R2 Yes

HANA Database Operating Systems


Redhat Enterprise Linux 6.6-HANA SPS10 Scaleup-Single container

Yes

SuSE Linux 11.3-HANA SPS10 Scaleup-Single container

Yes

Operations 13


SuSE Linux 11.3-HANA SPS11 Scaleup-Single container

Yes

SuSE Linux 12.0-HANA SPS11 Scaleup-Single

container

Yes

HANA Volumes

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

Storage Models

Model Micro Version Supported

Hitachi Unified Storage VM 73-03-44-00/00 Yes

Virtual Storage Platform-G1000 80-04-01-00/00 Yes

Virtual Storage Platform VSP Gx00 (G200/G400/G600/G800)

83-03-01-40/00 Yes

Virtual Storage Platform Gx00 Unified 83-03-20-40/00 Yes

VSP Fx00 83-03-01-40/00 Yes

Replication Software

Replication Software Supported

Hitachi ShadowImage Yes

Hitachi Thin Image Yes

Maximum Storage Consistency Groups

Copy Type CTG Range

Hitachi ShadowImage 0-127 (1, 2, 3)1

*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)



Copy Type CTG Range

Hitachi Thin Image 0-255 (1, 2, 3)1

Host Interface

Interface Supported

FC Yes

Volume Type

Volume Type Supported

HDP/HDT/HRT pools Yes

Parity Group Yes

*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: “You can use consistency group numbers 00 to 7F (or 0 to 127) commonly for SI and HTI. Consistency group numbers 80 to FF (or 128 to 255) are exclusively used for HTI.” (Ref: Hitachi Unified Storage VM Block Module Hitachi ShadowImage User Guide, MK-92HM7013)

Architecture 15


Architecture

The SAP HANA Cockpit 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. You access the SAP HANA Cockpit through a web

browser. The Hitachi Storage Adapter for the SAP HANA Cockpit runs as a cockpit web application. This adapter provides storage configuration, discovery, and

additional management functionality for storage management. Specifically, the adapter does the following:

Allows users to discover 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.

Generates reports (for example, LUN performance, port performance,

replication pairs, HANA storage snapshot history).

See the next page for an illustration.

16 Architecture


Hitachi Storage Adapter for the SAP HANA Cockpit Architecture Diagram: Scale-

up configuration

SAP HANA System

HANA Cockpit

Hitachi Hana Server & Storage Adapter

HANA Database

Management Server (Windows 2012 R2)

Hitachi HANA Management Web Service

CMD DEV

Shared Volume

Data Volume

Log Volume

SQL Query

HTTP

Hitachi StorageHitachi Storage

FC

FC

Installation 17


Installation

Required Pre-installation

Distribution Package

Installing and Uninstalling

18 Installation


Required Pre-installation on Management Server

# Item Configuration

1. Hitachi CCI Hitachi CCI must be installed and running on a Windows host to allow you to use this

product.

2. SAP HANA Windows Client

The SAP HANA Windows client must be installed and running on a Windows host to allow you to access the HANA database. You

can find this on the SAP website.

3. Java Runtime Environment

Java Runtime Environment version 7 x64 edition must be installed on the management server to allow you to use this

product.

Hitachi Command Control Interface (CCI)

Before using the adapter with enterprise storage arrays, install Hitachi

Command Control Interface (CCI), and then configure the software.

CCI performs in-band array management on behalf of the adapter workflows.

Note CCI commands run “in-band,” which refers to the method of transferring commands from the server to the command device by

sharing the same data path as the disk I/O. VSP arrays are exceptions and support virtual command devices by using an out-of-

band transfer method. Refer to the sections on command execution by in-band and out-of-band methods in the CCI document for your storage system model.

CCI should exist on the same Windows host that is running the Hitachi Windows service.

CCI supports several scenarios, and its configuration can become complex. These notes may help you to get started quickly, and they should yield a configuration sufficient for many of this product’s workflows. For in-depth CCI

configuration information, refer to CCI’s documentation.

To prepare for CCI use, follow the steps below.

1. Install CCI on the Windows host running this product’s Windows service.

2. Edit the Windows TCP/IP services file to define a CCI service associated with UDP port 1000. Add this single line to

C:\Windows\system32\drivers\etc\services.

horcm 1000/udp horcm

Operations 19

3. Choose (or create) an LDEV on the enterprise storage array to act as a command device.

4. Configure the LDEV to be a command device, as shown below.

5. Present the LDEV to the Windows host where the Hitachi Windows service is running.

6. Ask the Windows host to re-scan, and then ensure that the host sees the new LDEV.

7. Create a CCI configuration file named C:\Windows\horcm0.conf that

contains these two lines. Replace \\.\PHYSICALDRIVE1 with the drive

name that corresponds to the command device.

HORCM_CMD

\\.\PHYSICALDRIVE1

Note If it is difficult to determine which PHYSICALDRIVE device name corresponds to the command device LDEV, try this command in a Windows Command Prompt window:

C:\> wmic diskdrive list brief /format:list

20 Installation


8. Start a CCI process (instance). Supplying a zero to horcmstart asks CCI

to create an instance number of zero. The CCI instance number becomes

an input to some workflows that this product includes.

C:\HORCM\etc.\horcmstart 0

9. If CCI fails to start, or to determine its status in detail, look at its log files

in this folder.

C:\HORCM\log0\curlog\

Operations 21

Installing the SAP HANA Windows Client

Install the SAP HANA Windows Client to enable communication between the HANA management server and the HANA instance. Click the SAP HANA

Windows Client installer. Then select the installation path as it appears below.

Click Next to complete the installation of the SAP Windows client.

22 Installation


Java

Before using this product with Enterprise storage arrays, you must install Hitachi CCI and a specific Java Runtime Environment.

Java Runtime Environment

Install Java Runtime Environment version 7 x64 edition on the management

server.

Note The x64 JRE edition is specifically required. The more common 32-bit JRE edition does not work.

Operations 23

Distribution Package

The distribution packages for the Hitachi Storage Adapter for the SAP HANA

Cockpit contain the following:

Installer for x64 (Hitachi-HANAStorageAdapter-setup(01.0.0)-(x64).exe).

24 Installation


Installing and Uninstalling

Installation Overview

Installation includes the following items.

Installation Item Location

Hitachi HANA Management Service Windows management server

Delivery unit of Hitachi Storage for SAP HANA Cockpit adapter

Import the delivery unit to the SAP HANA Cockpit

Installation Procedure

1. Installing the HANA Management Service on the Windows

Management Server

On a supported Windows host, install the Hitachi Storage Adapter for the SAP HANA Cockpit by running this program:

Hitachi-HANAStorageAdapter-setup(01.0.0)-(x64).exe

The installer adds two main components:

The adapter, located in C:\Program Files\Hitachi\Hitachi HANA Management Service\deliveryunit.

A Windows service named Hitachi HANA Management Service.

First, install the Hitachi HANA Management Service by running the installer as seen in the images beginning on the next page:

Operations 25

26 Installation


Operations 27

28 Installation


Operations 29

30 Installation


Then verify the installation by navigating to Control Panel>Programs and Features. If the program installed successfully, it appears in this list.

To verify that the service is running, navigate to Start>Run>mstsc, and then verify that the status of Hitachi HANA Management Service is Running.

2. Importing the delivery unit to the SAP HANA Cockpit

After you install Hitachi HANA Management Service on the Windows

management server, import the delivery unit to the SAP HANA Cockpit:

This operation requires the following roles for the on the Cockpit (client) side:

sap.hana.admin.roles::Administrator

Operations 31

sap.hana.uis.db::SITE_DESIGNER

sap.hana.xs.admin.roles::HTTPDestAdministrator

sap.hana.xs.lm.roles::Administrator

To import the delivery unit, follow these steps:

1. Log in to Cockpit.

2. Access SAP HANA Application Lifecycle Management>Manage Products and Delivery Units.

3. Click Delivery Units>Import, as you see below.

4. Select the delivery unit file (HANA_ADAPTER_DU-hds.com.tgz) from

C:\Program Files\Hitachi\Hitachi HANA Management Service\deliveryunit on the HANA management server.

5. After you install the delivery unit, the screen below appears so that you can see the tile that represents the adapter.

32 Installation


3. Configuring the SAP HANA Cockpit

Next, configure the transport service on the SAP HANA Cockpit.

1. Log in to Cockpit>XS Artifact Administration.

2. On the XS Artifact Administration screen, type HitachiHanaService to

find the httpdest file as shown below.

3. Click the Edit button if you wish to modify the httpdest file by changing

the IP address and port of the Hitachi HANA Management service.

Operations 33

If the name of the target system is not “HIT” (default name), then it is not allowed to edit the http destination directly. In this case, extend the

http destination, and then edit by following the steps below:

1. Click Extend on the bottom right of the screen.

2. If this is the first time that you are installing the adapter, click New

Package, and then provide the extension package and the extension name. Otherwise, select an existing package. Then click Create Extension.

34 Installation


3. Click Edit on the bottom of the screen that shows the new extension of the HTTP destination.

Operations 35

4. Changing the Session Timeout

By default, the SAP HANA Cockpit only allows 10 minutes as the maximum timeout value.

Many storage-related operations need more than 10 minutes. If you need to increase the maximum timeout value, follow these steps:

1. From HANA Studio, select the HANA system.

2. From system view, choose Open Administration from the

Configuration and Monitoring menu.

36 Installation


3. Click the Configuration tab, and then 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, such as 1800.

Operations 37

5. Modify the icm/server_port parameter in the webdispatcher.ini section by

changing the value of “PROCTIMEOUT” to 1800 or more if necessary. If you are using http to access the Cockpit, then you only need to change

icm/server_port_0. If you are also using https, then you need to change icm/server_port_1 as well.

38 Installation


Operations 39

Uninstallation

To uninstall the Windows service, follow these steps:

1. Go to Control Panel>Programs and Features, and then choose

Hitachi HANA Management Service.

2. Right-click and select Uninstall.

40 Installation


To uninstall the delivery unit, follow these steps:

1. Go to HANA Cockpit>SAP HANA Application Lifecycle

Management>Manage Products and Delivery Units.

2. Select HANA_Adapter_DU (hds.com), and then click Delete.

Operations 41


Operations

Overview of Features

Launching the UI for Hitachi Adapter for SAP HANA Cockpit

Discovering a HANA Instance

Discovering a HANA Host

Discovering Hitachi Storage

Creating a HANA Storage Snapshot with Hitachi Thin Image

Deleting Replication Pairs by Using Consistency Groups

Recovering a HANA Database from a Hitachi Thin Image Snapshot

Cloning HANA Systems Using Hitachi Thin Image

Cloning HANA Operating Systems Using Hitachi ShadowImage

Backing up Hitachi OS by Using HTI/ShadowImage

Splitting ShadowImage or Hitachi Thin Image Pairs

Resyncing ShadowImage or Hitachi Thin Image Pairs

Reverting Replication Pairs by Using Consistency Groups

42 Operations


Overview of Features

HANA Instance Discovery

DiscoveryHANA Host Discovery

Storage Discovery

Storage Operation

Create HANA Storage Snapshot

Create Shadow Image

Create Thin Image

Resync

Split

Revert

Online Operation

Offline Operation

Storage Reports

Storage Overview

Device Mapping

LUN Performance

Port Perforamnce

Replication

Storage Snapshot History

Hitachi Storage Adapter for the SAP HANA Cockpit

Operations 43

To use this adapter, you must first discover the HANA instance, the HANA host, and the storage. The following workflow shows the sequence of discovery.

44 Operations


Launching the UI for Hitachi Adapter for SAP HANA Cockpit

Before you perform any operations, launch the user interface for the Hitachi

Adapter for SAP HANA Cockpit by following these steps:

1. After you install the Hitachi Adapter for SAP HANA Cockpit, open the cockpit by navigating to the following link on the Windows management server:

http://172.17.37.142:8010/sap/hana/admin/cockpit (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, select Hitachi Adapter for the SAP Cockpit.

http://172.17.37.142:8010/sap/hana/admin/cockpit

Operations 45

Discovering a HANA Instance

HANA instance discovery 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 discovery feature. This operation requires a HANA database account with the following

roles:

sap.hana.admin.roles::Monitoring

sap.hana.backup.roles::Administrator

To discover a HANA instance, follow these steps:

1. After you log in to the UI, click the + sign next to HANA Instances on the

upper left of the UI.

46 Operations


2. Provide information for the parameters listed below, as shown in the following screenshot.

Input Parameters

Name Description

Master Host Name DNS name or IP of the master host

HANA Instance Number Instance number of this HANA system

HANA User Name User name of this HANA system

HANA Password Password of this HANA system

Operations 47

Discovering a HANA Host

Note The host name must be the same as it is presented on the HANA instance database.

After you discover the HANA instance, you can discover the hosts of the

specified HANA instance. This feature registers the related HANA hosts on the inventory of the management web service.

You can perform subsequent management operations by using the result of this discovery 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, click on the HANA instance that appears under “HANA

Instances” on the left. Then click Discover Host under Actions, as shown in the following screenshot.

48 Operations


Enter the correct parameters in the window that appears, as shown in the following screenshot.

Input Parameters

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.

Operations 49

Discovering Hitachi Storage

After you discover a specified HANA host, you can discover 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 discover the storage by using the adapter. Provide the user credentials that provide access to the Hitachi storage.

Also provide the IP address and HORCM instance number. The adapter scans the Hitachi storage according to your input. See the screenshot below.

Input Parameters


Storage Serial Number

String Serial number of the Hitachi storage

Storage Location (IP) String IP of the Hitachi storage

Horcm Instance Number

Integer HORCM instance number for managing the Hitachi storage

Storage User Name String User name for accessing the Hitachi storage

Storage Password String Password for accessing the Hitachi storage

50 Operations


Creating a HANA Storage Snapshot with Hitachi Thin Image

Prerequisites

Before using this feature, create a Hitachi Thin Image (HTI) pool on your

Hitachi storage system.

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.

Before you create any HANA storage snapshot, it is strongly recommended that you create a full file system backup of your HANA instance first. 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.

Input Parameters

Name Description

HTI Pool The HTI pool for the storage snapshot

LUNs Selected LUNs for the storage snapshot. Initially, all LUNs in the data volume are selected by default.

Procedure Note This operation may take a while. However, HANA Cockpit by default

allows 300 seconds as the maximum session timeout period. If you receive a timeout error, change the session timeout by following the

steps under Changing the Session Timeout.

1. To view all the LUNs and log files available for backup, click on the IP address of a storage instance.

https://help.sap.com/saphelp_hanaplatform/helpdata/en/a0/3f8f08501e44d89115db3c5aa08e3f/content.htm?frameset=/en/c5/1a3983bb571014afa0c67026e44ca0/frameset.htm&current_toc=/en/00/0ca1e3486640ef8b884cdf1a050fbb/plain.htm&node_id=591)


Operations 51

2. To create a snapshot, navigate to Actions under the Storage tab on the

left.

3. Click Create HANA Storage Snapshot. A dialog box appears, as shown

in the following screenshot.

52 Operations


4. Under Available LUNs, check the boxes next to the contents that you wish to include, and then click the right arrow to move these selections

from Available LUNs to Selected LUNs.

5. Click Confirm. A “Please wait” message may appear as in the following

screenshot.

6. Once the operation is complete, the following image appears.

Operations 53

HANA Storage Snapshot Backup Verification

After the operation, verify the backup status by using the specified backup ID and HANA Studio according to the following steps.

1. Open HANA Studio, and then select the HANA instance. Then right-click and choose Backup and Recovery >Open Backup Console.

2. Click the Backup Catalog tab, and then select the backup snapshot and

make sure that the ID that is listed under Backup Details matches the provided Backup ID.

54 Operations


Recovering a HANA Database from a HANA Storage Snapshot

Procedure

To recover your HANA database from a HANA storage snapshot, follow these steps:

1. Use HANA Studio to bring the HANA system offline.

2. Select Backup and Recovery>Recover System.

3. Select Storage Snapshot.

4. Use SSH to access your HANA system. Type

umount /hana/data

to let HANA host unmount the data volumes.

5. Open a PowerShell console on the management server. Navigate to the samplescripts folder of the HANA management web service.

Operations 55

6. Run the RevertStorageSnapshot.ps1 PowerShell script from the

PowerShell console. Then provide the required parameters (IP address, storage username and storage password, and so on).

Note The Confirm response options are as follows:

Yes (Y): Perform the action.

Yes to All (A): Perform all actions and suppress subsequent Confirm queries for this command.

No (N): Do not perform the action.

No to All (L): Do not perform any actions and suppress subsequent

Confirm queries for this command.

Suspend (S): Pause the command and create a temporary session.

Help (?): Display help for these options.

56 Operations


7. Wait a few minutes until you see the success message on the PowerShell console.

8. Use SSH to access your HANA system. Type

mount –a

to let HANA remount the recovered data volumes.

9. Return to HANA Studio, and then click the Refresh button and make sure that the selected storage snapshot displays green, as shown below.

Operations 57

10. Click Next and Finish. Wait until HANA Studio displays the success message.

Cloning HANA Systems Using Hitachi Thin Image

Notes 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.

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.

This operation can support OS backup and HANA system replication/cloning. The figure on the following page shows a scenario of support for HANA system replication/cloning.



58 Operations


SAP HANA System

HANA Cockpit

Hitachi Server Adapter for the SAP HANA Cockpit

HANA Database

Management Server(Windows 2012 R2)


CMD DEV

HTTP/SSH/SQL

http/https

Log Volume

Data Volume

Shared Volume

HITACHI Storage

Data

Source Target

Log

Shared

Data

Log

Shared

Consistency GroupP-VOL

Consistency GroupV-VOL

HTI Replication

Hitachi Storage Adapter for the SAP HANA Cockpit Architecture Diagram: Scale-up configuration

Operations 59

Prerequisites

1. Take the system offline while creating a system clone. SAP requires that

you put the system offline while cloning the system. (See

https://help.sap.com/saphelp_hanaplatform/helpdata/en/c6/22d640e47e

4c0ebca8cbe74ff9550a/content.htm.)

2. If you plan to place an HTI pair in an HTI pool, first create one on your

Hitachi storage.

3. 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.

3. Select all LDEVs, HTI pools, and host groups that you listed in the first

two steps. Examples are shown in the following screenshot.

https://help.sap.com/saphelp_hanaplatform/helpdata/en/c6/22d640e47e4c0ebca8cbe74ff9550a/content.htm


60 Operations


4. Confirm the selection by clicking Confirm.

5. Create V-VOLs and HTI pairs for each selected item.

The software places all created HTI pairs in one consistency group and returns the consistency group ID. You may see a “Please wait” screen, and then the

following image appears.

Use the following procedure to split replication pairs.

1. Wait until the status of all HTI pairs of the consistency group is PAIR.

2. (HANA Studio) Bring the HANA system offline.

3. (PowerShell Script) Run the script on the management server to split

the consistency group.

4. Mount the V-VOLs to the new HANA server, and then use the SAP HANA

utility (hdblcm) to register the new HANA system by following the official

SAP HANA system clone procedure. (See https://help.sap.com/saphelp_hanaplatform/helpdata/en/c6/22d640e47e


5. Follow the SAP HANA system clone procedure in Copy or Clone an SAP HANA System.

For offline operation, two PowerShell scripts (Resync and Split) are in the samplescripts folder under the installation folder (for example, C:\Program Files\Hitachi\Hitachi HANA

Management Service) on the management server. Use the two scripts to split or resync the replication pairs that are created by the adapter. To use the scripts, provide the

storage serial number, storage IP, storage username, storage password, HORCM instance number, and consistency group ID as shown in the following two images.





Operations 61

Input Parameters


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.

62 Operations


Cloning HANA Systems Using Hitachi ShadowImage

This operation can support OS backup and HANA system replication/cloning.

The figure below shows a scenario of support for HANA system replication/cloning.

SAP HANA System

HANA Cockpit

Hitachi Adapter for the SAP HANA Cockpit

HANA Database

Management Server(Windows 2012 R2)


CMD DEV

HTTP/SSH/SQL

Log Volume

Data Volume

Shared Volume

HITACHI Storage

Data

Source Target

Log

Share

Data

Log

Share

Consistency GroupP-VOL

Consistency GroupS-VOL

ShadowImage Replication

Operations 63

Prerequisites





2. If you plan to place the ShadowImage pair in a DP pool or parity group,

first create one on your Hitachi storage.

3. 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.



64 Operations



5. Create S-VOLs and ShadowImage pairs for each selected item.

The software places all created ShadowImage pairs in one consistency group and returns the consistency group ID. You may see a “Please wait” screen, and

then the following image appears.

Use the following procedure to split the replication pairs.

1. Wait until the status of all ShadowImage pairs of the consistency group is

PAIR.


3. (PowerShell Script) Run the script on the management server to split

the consistency group.

4. Mount the S-VOLs to the new HANA server, and then use the SAP HANA

utility (hdblcm) to register the new HANA system by following the official

SAP HANA system clone procedure. (See https://help.sap.com/saphelp_hanaplatform/helpdata/en/c6/22d640e47e


5. Follow the SAP HANA system clone procedure in Copy or Clone an SAP

HANA System.

For offline operation, two PowerShell scripts (Resync and Split) are in the samplescripts folder under the installation folder on the management server. Use the two scripts to split

or resync the replication pairs that are created by the adapter. To use the scripts, provide the storage serial number, storage IP, storage username, storage password, HORCM

instance number, and consistency group ID as shown in the following two images.





Operations 65

66 Operations


Input Parameters


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 Hitachi OS by Using HTI/ShadowImage

Creating Thin Image and ShadowImage can also support OS backup. The figure below shows a scenario of support for OS backup.

Operations 67

Prerequisites





2. If you plan to place an HTI pair in an HTI pool, first create one on your

Hitachi storage.

3. 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.



68 Operations



5. Create S-VOLs/V-VOLs and SI/HTI pairs for each selected item.

The software places all created SI/HTI pairs in one consistency group and returns the consistency group ID. You may see the following “Please wait”

screen.

Then, the following image appears.

Use the following procedure to split replication pairs.

1. Wait until the status of all SI/HTI pairs of the consistency group is PAIR.


3. (PowerShell Script) Run the script on the management server to split the consistency group.

4. To recover the OS, shut down the OS, and then use the revert script. See

Reverting Replication Pairs by Using Consistency Groups.

Operations 69

Splitting ShadowImage or Hitachi Thin Image Pairs

To use a consistency group to split ShadowImage or Hitachi Thin Image pairs, follow these steps:

1. Put your HANA system offline.

2. Open a PowerShell console on the management server, and then

navigate to the samplescripts folder of the HANA management service.

3. Run the SplitCTG.ps1 PowerShell script from the PowerShell console.

Then provide the required parameters (IP address of the management service, storage username and storage password, and so on).

70 Operations


4. Wait until the success message appears on the PowerShell console.

5. Execute the operations that you need.

Operations 71

Resyncing ShadowImage or Hitachi Thin Image Pairs

To resync ShadowImage or Hitachi Thin Image pairs, follow these steps:

1. Put your HANA system offline.

2. Open a PowerShell console on the management server, and then navigate to the samplescripts folder of the HANA management web service.

3. Run the ResyncCTG.ps1 PowerShell script from the PowerShell console. Then

provide the required parameters (IP address of the management service, storage username and storage password, and so on).

4. Wait until the success message appears on the PowerShell console.

5. Execute the operations that you need.

72 Operations


Operations 73

Reverting Replication Pairs by Using Consistency Groups

To revert is to reverse resync data from S-VOL/V-VOL to P-VOL and then automatically split replication pairs.

To revert replication pairs from S-VOL/V-VOL to P-VOL, follow these steps.

1. Open a PowerShell console on the management server. Navigate to the

samplescripts folder of the HANA management web service.

2. Run the RevertCTG.ps1 PowerShell script from the PowerShell console.

Then provide the required parameters (IP address of the management service, storage username and storage password, and so on).

74 Operations


3. Wait a few minutes until you see the success message on the PowerShell

console.

Operations 75

Deleting Replication Pairs by Using Consistency Groups

To delete all replication pairs, including the S-VOL and V-VOL of each pair, follow the steps below. (You may use this function to delete replication pairs

created by storage snapshots, Hitachi Thin Image, or Hitachi ShadowImage.)

Note This operation may take a while. However, HANA Cockpit by default allows 300 seconds as the maximum session timeout period. If you receive a timeout error, change the session timeout by following the

steps under Changing the Session Timeout.

1. Go to the storage view in the adapter.

2. Select Delete Replication Pairs by CTG Group, and then click

Confirm.

76 Operations


Operations 77

Reporting

Overview

Device-Mapping Report

LUN Performance Report

Port Performance Report

Replication Report

Storage Statistics Report

Storage Snapshot History Report

78 Reporting


Overview

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.

To generate reports, first navigate to the Storage tab.

While generating a report, you may see the following “Please wait” message.

Filtering

To filter the results of a report, click on the parameter that you wish to filter, and then 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.

Operations 79

80 Reporting


Device-Mapping Report

After the discovery 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 discovered

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 these steps:

1. Click on the Storage tab.

2. Click on Overview.

You can perform subsequent storage management operations (that is, HTI and ShadowImage) by using the result of this discovery feature. Provide the user

credential that has access permission to the Hitachi storage as well as to the IP address and HORCM instance number for this feature. The adapter uses your

inputs (see below) to scan the Hitachi storage. All the parameters are required.

Property Description

HANA Host Name of the HANA host

LUN Number Number of the logical unit

LDEV ID ID of the LDEV

Operations 81


Storage Serial Serial number of the storage device that is associated with the HANA host

WWID World Wide Identifier (WWID) of the LUN

Volume Group Name of the LVM volume group of the LUN

Physical Volume Name of the LVM physical volume

Mount Point Mount point to which the LUN belongs

HANA Volume Type

HANA volume type (DATA or LOG) to which the LUN belongs

Logical Volume Name of the LVM logical volume to which the LUN belongs

82 Reporting


LUN Performance Report

LUN performance reports show information about the performance of all LUNs

in discovered 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 these steps:


2. Click on LUN Performance.

See the following table for the details of this report.


LUN Number Logical unit number

LDEV ID ID of the LDEV

Random Read Count Number of random reads

Random Read Hit Count Number of random read hits

Random Write Count Number of random writes

Random Write Hit Count Number of random write hits

Sequencial Read Count Number of sequential reads

Sequencial Read Hit Count Number of sequential read hits

Operations 83

Port Performance Report

This report shows information for the performance of all ports in discovered storage with the HANA host that you specify. The adapter refreshes the data

each time you run the report.

To generate a port performance report, follow these steps:


2. Click on Port Performance.



Port Name Port name

Average IOPS Average IO per second

Maximum IOPS Maximum IO per second

Minimum IOPS Minimum IO per second

Average Port Transfer Average port transfer (KB per second)

Collection Date Time Timestamp of the performance data taken

84 Reporting


Replication Report

This report shows information for all replication pairs in discovered storage with

the HANA host that you specify. The adapter refreshes the data each time you run the report.

To generate a replication report, follow these steps:


2. Click on Replication Report.



Serial Number 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

ID of the consistency group for this replication pair. If it is -1, then this pair does not use any consistency group.

P-VOL LUN number of the P-VOL

S-VOL/V-VOL 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.

Operations 85


Pair Type Type of pair (SI, TI, UR, TC)

Pair Status Status of the pair (that is, SMPL(PD), COPY, PAIR, PFUL, PFUS, PSUS, RCPY, PSUE)

Pair Name Name of the pair

Mirror ID ID of the mirror unit

86 Reporting


Storage Snapshot History Report

This report shows information about the storage snapshots that the adapter

has created since installation.

To generate a storage snapshot history report, follow these steps:


2. Click on Storage Snapshot History.



Instance Host Name HANA instance name

Storage Serial Serial number of the storage

Backup ID Backup ID of this storage snapshot

Backup External ID Backup external ID of this storage snapshot

Consistency Group ID ID of the consistency group for this storage snapshot

Storage Snapshot Status Status of this storage snapshot (success or fail)

Current Status Whether the snapshot is available

Update On Timestamp of the collection

Details Thin Image pair details of the storage snapshot (that is, P-VOL or V-VOL)

Logging, Troubleshooting and Error Messages 87


Logging, Troubleshooting and Error Messages

Logging

Troubleshooting

Error Messages

88 Logging, Troubleshooting and Error Messages


Logging

Find log files in this location:

[Installed drive]\Program Files\Hitachi\ Hitachi HANA Management Service\Log

The adapter supports the following logging levels:

NORMAL

VERBOSE

MINIMAL

The default logging level is NORMAL. You can change the logging level in the

HiHanaWebService.Config file in the installation folder as shown below:

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:

Log multiple processes to the same file.

Determine the maximum number of consecutive files by using a user-

specified parameter or a system default.

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.

Log the entries that are written to a temporary file when the log file is locked at the time of the rotation. The backup file is created, and rotation stops. After the log file is unlocked, rotation continues, but the

temporary files are not deleted. The temporary file name is

hiHANA.log.tmp.

Operations 89

Specify a maximum log file size in hilogger.config by creating a key

called [MaxFileSize] in a separate line. The minimum value is 5MB, and the maximum value is 100MB.

If [MaxFileSize] is not specified in hilogger.config, the default value is

10MB.

If [MaxFileSize] is out of range, the default value is 10MB.

Specify a maximum backup log file in hilogger.config by creating a

key call [MaxBackupIndex] on a separate line. The minimum value is 1, and the maximum value is 255.

If [MaxBackupIndex] is not specified in hilogger.config, then the

default value is 5.

If the [MaxBackupIndex] value is out of range, then it defaults to 5.

Sample Log Output

The default log level is NORMAL. Here is a sample of normal log output.

[4756] [01/08/16-22:47:18] [HiHANA] DBG3 [--------] {StorageManager::ResetSession}:startTime: [1/8/2016 10:47:18 PM].

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManager::ResetSession}:

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManagerFactory::GetStorageManager}:


[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:sessionId: [22049698-89bf-4f65-b8a1-696c9d2c99a6].

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:serialNumber: [210050].

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:P-VOL: [267].

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:V-VOL: [-1].



[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:dataPool: [13].

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:ctgID: [-1].

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManagerFactory::GetStorageManager}:

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {StorageManagerFactory::GetStorageManager}:guidIdentifierString: [22049698-89bf-4f65-b8a1-696c9d2c99a6].


[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {StorageManagerFactory::GetStorageManager}:identifier: [22049698-89bf-4f65-b8a1-696c9d2c99a6].

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManager::ResetSession}:





[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManager::GetStorageDevice}:

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManagerFactory::DumpStorageDeviceRegistration}:

[4756] [01/08/16-22:47:18] [HiHANA] DBG3 [--------] {StorageManagerFactory::DumpStorageDeviceRegistration}:Session ID: [f47d3cdb-ac39-4b88-9a4a-606209fc81d2].

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManager::DumpStorageDeviceRegistration}:

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManager::DumpStorageDeviceRegistration}:

Operations 91

[4756] [01/08/16-22:47:18] [HiHANA] DBG3 [--------] {StorageManagerFactory::DumpStorageDeviceRegistration}:Session ID: [22049698-89bf-4f65-b8a1-696c9d2c99a6].

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageManager::DumpStorageDeviceRegistration}:

[4756] [01/08/16-22:47:18] [HiHANA] DBG3 [--------] {StorageManager::DumpStorageDeviceRegistration}:Serial: [210050], Storage device object: [65718035].

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManager::DumpStorageDeviceRegistration}:

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManagerFactory::DumpStorageDeviceRegistration}:

[4756] [01/08/16-22:47:18] [HiHANA] EXIT [--------] {StorageManager::GetStorageDevice}:

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageDevice::CreateSnapshotPairWithCTG}:

[4756] [01/08/16-22:47:18] [HiHANA] PARAM [--------] {StorageDevice::CreateSnapshotPairWithCTG}:P-VOL=267 V-VOL=-1 dataPool=13 ctgID=-1: [].

[4756] [01/08/16-22:47:18] [HiHANA] ENTER [--------] {StorageDevice::getFreeLUNumber}:

[4756] [01/08/16-22:47:19] [HiHANA] ENTER [--------] {StorageManager::ValidateResult}:

[4756] [01/08/16-22:47:19] [HiHANA] EXIT [--------] {StorageManager::ValidateResult}:

[4756] [01/08/16-22:47:19] [HiHANA] DBG3 [--------] {StorageDevice::getFreeLUNumber}:Generated Lun Number: 844

[4756] [01/08/16-22:47:19] [HiHANA] EXIT [--------] {StorageDevice::getFreeLUNumber}:



[4756] [01/08/16-22:47:22] [HiHANA] ENTER [--------] {StorageDevice::PresentVirtualVolume}:



[4756] [01/08/16-22:47:22] [HiHANA] PARAM [--------] {StorageDevice::PresentVirtualVolume}:V-VOL: [844].

[4756] [01/08/16-22:47:22] [HiHANA] PARAM [--------] {StorageDevice::PresentVirtualVolume}:hostGroupName: [HITACHI_HG].

[4756] [01/08/16-22:47:22] [HiHANA] PARAM [--------] {StorageDevice::PresentVirtualVolume}:port: [CL1-A].



[4756] [01/08/16-22:47:22] [HiHANA] ENTER [--------] {StorageDevice::Presentlu}:

[4756] [01/08/16-22:47:22] [HiHANA] PARAM [--------] {StorageDevice::Presentlu}:Lu=844, port=CL1-A hostGroupName=HITACHI_HG: [].



[4756] [01/08/16-22:47:37] [HiHANA] EXIT [--------] {StorageDevice::Presentlu}:

[4756] [01/08/16-22:47:37] [HiHANA] EXIT [--------] {StorageDevice::PresentVirtualVolume}:

[4756] [01/08/16-22:47:37] [HiHANA] ENTER [--------] {StorageDevice::CreateLocalConsistencyGroup}:



[4756] [01/08/16-22:47:37] [HiHANA] EXIT [--------] {StorageDevice::CreateLocalConsistencyGroup}:

[4756] [01/08/16-22:47:37] [HiHANA] ENTER [--------] {StorageDevice::GetStoragePool}:


Operations 93


[4756] [01/08/16-22:48:20] [HiHANA] EXIT [--------] {StorageDevice::GetStoragePool}:





[4756] [01/08/16-22:48:20] [HiHANA] ENTER [--------] {ReplicationPair::.ctor}:

[4756] [01/08/16-22:48:20] [HiHANA] EXIT [--------] {ReplicationPair::.ctor}:

[4756] [01/08/16-22:48:20] [HiHANA] EXIT [--------] {StorageDevice::CreateSnapshotPairWithCTG}:

[4756] [01/08/16-22:48:20] [HiHANA] DBG3 [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:Created Snapshot pair with CTG P-VOL = 267, V-VOL = 844, CTG = 13 in DataPool = -1

[4756] [01/08/16-22:48:20] [HiHANA] EXIT [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:

[4756] [01/08/16-22:48:20] [HiHANA] ENTER [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:

[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:sessionId: [22049698-89bf-4f65-b8a1-696c9d2c99a6].

[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:serialNumber: [210050].

[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:P-VOL: [268].

[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:V-VOL: [-1].

[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:dataPool: [13].



[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {SnapshotImpl::CreateSnapshotPairWithCTG}:ctgID: [27].


[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {StorageManagerFactory::GetStorageManager}:guidIdentifierString: [22049698-89bf-4f65-b8a1-696c9d2c99a6].


[4756] [01/08/16-22:48:20] [HiHANA] PARAM [--------] {StorageManagerFactory::GetStorageManager}:identifier: [22049698-89bf-4f65-b8a1-696c9d2c99a6].

[4756] [01/08/16-22:48:20] [HiHANA] ENTER [--------] {StorageManager::ResetSession}:





Troubleshooting

Changing the Session Timeout

By default, the SAP HANA Cockpit only allows 10 minutes as the maximum timeout value. Many storage-related operations need more than 10 minutes. If you need to increase the maximum timeout value, follow these steps:

1. From HANA Studio, select the HANA system.

2. From system view, choose Open Administration from the

Configuration and Monitoring menu.

Operations 95

3. Click the Configuration tab, and then 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, such as 1800.

5. Modify the icm/server_port parameter in the webdispatcher.ini section by changing the value of “PROCTIMEOUT” to 1800 or more if necessary. If you are using http to access the Cockpit, then you only need to change

icm/server_port_0. If you are also using https, then you need to change icm/server_port_1 as well.

Operations 97



Cleaning the Cache When the Delivery Unit Fails to Import

Sometimes, the delivery unit fails to import to the HANA Cockpit when

you are using SAP HANA Application Lifecycle Management with

your browser. To solve this problem, clean the cache of your browser, and then try again.

Updating the PowerShell Console by Pressing Enter

Sometimes, the powershell console stops sending output when executate

the offline script. Users need to press Enter key for getting the output. In order to solve this problem, users need to right click the powershell

console->Properties, then uncheck the QuickEdit Mode and\or Insert options as below:

Operations 99

Turn on port 2022 on Windows firewall

The error message “error: Internal Server Error HttpClient.request:

request failed: unable to establish connection to <Adapter Management Server IP>:2022 - IPcon: connection to host failed!” means that the

HANA system cannot connect to the adapter management server. To resolve this issue, check and ensure the network connectivity.

Sometimes, the Windows firewall of the adapter management server blocks the http connection on the default port (2022). Enable the connection of the port by following the steps below:

1. Open Windows Firewall by navigating to Start>Control Panel. In the

search box, type “firewall,” and then click Windows Firewall.

2. In the left pane, click Advanced settings. Administrator permission is

required. If you are prompted for an administrator password or

confirmation, type the password or provide confirmation.

3. In left pane of the Windows Firewall with Advanced Security dialog box, click Inbound Rules. Then, in the right pane, click New Rule….

4. Select “Port,” and then click Next.



5. Select “TCP,” type “2022” into the “Specific local ports” field, and then

click Next.

Operations 101

6. Select ”Allow the connection,” and then click Next.



7. Select the appropriate network types, and then click Next.

Operations 103

8. Provide a name for this rule, and then click Finish.



Troubleshooting Diagnostic Steps

Use the flowchart below and refer to the Troubleshooting tips on the next page.

Error Condition Detected

SAP HANA

Issue?

Investigate HANA

environment. See

Troubleshooting

#1.

Investigate the

adapter logs. See

Troubleshooting

#2.

Gather information and

call technical support

Adapter log

error?

No

HORCM error

Storage error

No

No

No

Investigate the

HORCM logs.

Investigate

Storage and

dump files.

Yes

Yes

Yes

Yes

Operations 105

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 that is explained here: https://help.sap.com/saphelp_hanaplatform/helpdata/en/95/fc8adf6c5a46e7bc

3a0a29b63ec6bb/content.htm)

Troubleshooting #2

Investigate the adapter logs.

Review the log file (hiHANA.log) under the log subfolder of the installation

folder. Study the recommended action for resolving the issue from the error message list by checking the error message ID.

https://help.sap.com/saphelp_hanaplatform/helpdata/en/95/fc8adf6c5a46e7bc3a0a29b63ec6bb/content.htm

https://help.sap.com/saphelp_hanaplatform/helpdata/en/95/fc8adf6c5a46e7bc3a0a29b63ec6bb/content.htm



Error Messages

E590001

Error Message

ID

E5900001

Error Message

Text Invalid username or password. Check and try again.

Explanation Error occurred while using the specified username and password.

Recommended

Action Ensure that the username and password are valid.

E5900002

Error Message

ID

E5900002

Error Message

Text Error occurred while getting the version.

Explanation Error occurred while getting the version number.

Recommended

Action

Ensure that version.txt is located on the

installation directory and that it includes the version number and build number.

E5900003

Error Message

ID

E5900003

Error Message

Text Error occurred while discovering the hana instance.

Explanation Error occurred while discovering the specified HANA instance.

Recommended

Action

Ensure that the provided parameters (instance number, IP) of this HANA instance are valid.

E5900004

Error Message

ID

E5900004

Error Message

Text

Error occurred while splitting the snapshot pair from the specified subsystem.

Explanation Error occurred while splitting the COW/HTI snapshot pair.

Recommended

Action

Ensure that the storage array is not locked. Check the input parameters and detailed error message in the HiStor API log.

Operations 107

E5900005

Error Message

ID

E5900005

Error Message

Text

Error occurred while getting HTI pools by storage serial.

Explanation Error occurred while splitting the HTI pool.

Recommended

Action


E5900006

Error Message

ID

E5900006

Error Message

Text

Error occurred while creating storage snapshot by using HTI.

Explanation Error occurred while creating the storage snapshot by using HTI.

Recommended

Action

Ensure that the storage array is not locked. Check the input parameters and detailed error message in

the HiStor API log.

E5900007

Error Message

ID

E5900007

Error Message

Text Error occurred while discovering the hana host.

Explanation Error occurred while discovering the HANA host

Recommended

Action

Ensure that the storage array is not locked. Check that the input parameters (host name, SSH username, and password) are valid.

E5900008

Error Message

ID

E5900008

Error Message

Text Error occurred while saving the HCSM config.

Explanation Error occurred while saving the HCSM config.

Recommended

Action

Make sure that the input parameters (HCSM IP, port, username, password, protocol) are valid.

E5900009

Error Message

ID

E5900009



Error Message

Text

Error occurred while creating storage replication by using ShadowImage.

Explanation Error occurred while creating storage replication by using ShadowImage.

Recommended

Action

Ensure that the storage array is not locked. Check

the input parameters and detailed error message in the HiStor API log.

E5900010

Error Message

ID

E5900010

Error Message

Text Error occurred while reverting the storage snapshot.

Explanation Error occurred while reverting the storage snapshot.

Recommended

Action


the HiStor API log.

E5900011

Error Message

ID

E5900011

Error Message

Text Error occurred while getting server by serial.

Explanation Error occurred while getting server by serial.

Recommended

Action

Check whether the server has been managed by HCSM.

E5900012

Error Message

ID

E5900012

Error Message

Text Error occurred while getting chassis by server serial.

Explanation Error occurred while getting chassis by server serial.

Recommended

Action Check whether HCSM is managing the server.

E5900013

Error Message

ID

E5900013

Error Message

Text Error occurred while getting switch by server serial.

Explanation Error occurred while getting switch by server serial.

Recommended Check whether HCSM is managing the server.

Operations 109

Action

E5900014

Error Message

ID

E5900014

Error Message

Text

Error occurred while getting power supply by server serial.

Explanation Error occurred while getting power supply by server serial.

Recommended

Action Check whether HCSM is managing the server.

E5900015

Error Message

ID

E5900015

Error Message

Text Error occurred while getting server serial.

Explanation Error occurred while getting server serial.

Recommended

Action

Ensure that the account used for discovering the host has root privileges.

E5900016

Error Message

ID

E5900016

Error Message

Text Error occurred while getting hana instances.

Explanation Error occurred while getting HANA instances.

Recommended

Action

Check the network connection/environment between the management server and the HANA instance.

Make sure that the HANA instances are up.

E5900017

Error Message

ID

E5900017

Error Message

Text Error occurred while getting hana hosts.

Explanation Error occurred while getting HANA hosts.

Recommended

Action

Check the network connection/environment between the management server and the HANA host. Make

sure that the HANA hosts are up. Ensure that the DNS name for the HANA host discovery is correct.

E5900018

Error Message E5900018



ID

Error Message

Text

Error occurred while getting the luns of a specifed hana host.

Explanation Error occurred while getting the LUNs of a specified HANA host.

Recommended

Action

Make sure that the account used for discovering the host has root privileges.

E5900019

Error Message

ID

E5900019

Error Message

Text

Error occurred while getting the storage snapshots by instance host name.

Explanation Error occurred while getting storage snapshots by instance host name.

Recommended

Action

Check the log for the HANA management web service for the details. If the data store is damaged, repair the installation.

E5900020

Error Message

ID

E5900020

Error Message

Text

Error occurred while getting the storage by hana host.

Explanation Error occurred while getting the storage by HANA host.

Recommended

Action

Make sure that the storage for the specified HANA host is first.

E5900021

Error Message

ID

E5900021

Error Message

Text Error occurred while getting the server by hana host.

Explanation Error occurred while getting the server by HANA host.

Recommended

Action

Ensure that the account used for discovering the host has root privileges and that HCSM is available.

E5900022

Error Message

ID

E5900022

Error Message

Text

Error occurred while getting the DP pools and parity group by storage.

Operations 111

Explanation Error occurred while getting the DP pools and parity group by storage.

Recommended

Action


E5900023

Error Message

ID

E5900023

Error Message

Text

Error occurred while getting the parity group by storage.

Explanation Error occurred while getting the parity group by storage.

Recommended

Action


the HiStor API log.

E5900024

Error Message

ID

E5900024

Error Message

Text

Error occurred while getting the host names by querying hana database with the instance name.

Explanation Error occurred while getting the host names by querying HANA database with the instance name.

Recommended

Action

Make sure that your HANA instance and the network connection/environment of your management server are available.

E5900025

Error Message

ID

E5900025

Error Message

Text

Error occurred while getting the workload by using

the host names to query hana database.

Explanation Error occurred while getting the workload by using the host names to query the HANA database.

Recommended

Action

Make sure that your HANA instance and the network connection/environment of your management server are available.

E5900026

Error Message

ID

E5900026

Error Message

Text

Error occurred while getting server report info by server serial.



Explanation Error occurred while getting server report info by server serial.

Recommended

Action

Make sure that HCSM and the network connection/environment of your management server

are available.

E5900027

Error Message

ID

E5900027

Error Message

Text Error occurred while getting the ports by storage.

Explanation Error occurred while getting the ports by storage.

Recommended

Action


E5900028

Error Message

ID

E5900028

Error Message

Text

Invalid HCSM IP or port. Check your input again and if that is correct then your HCSM is not available at this time.

Explanation

Invalid HCSM IP or port. Check your input again and if that is correct then your HCSM is not available at

this time.

Recommended

Action

Ensure that the storage array is not locked. Also ensure that the provided HCSM IP or port are valid

and the network connection is available.

E5900029

Error Message

ID

E5900029

Error Message

Text

Unable to connect to HCSM. Check the management server's network and proxy settings, and try again.

Explanation Unable to connect to HCSM. Check the management server network and proxy settings, and try again.

Recommended

Action

Check the network connection and/or DNS settings on your management server.

E5900030

Error Message

ID

E5900030

Error Message Invalid HCSM username, password, or wrong protocol

Operations 113

Text for hcsm configuration.

Explanation Invalid HCSM username, password, or wrong protocol for HCSM configuration.

Recommended

Action

Please make sure that the HCSM username, password, and protocol are valid.

E5900031

Error Message

ID

E5900031

Error Message

Text Invalid SSL cert.

Explanation Invalid SSL cert for HCSM connection.

Recommended

Action


the HiStor API log.

E5900032

Error Message

ID

E5900032

Error Message

Text Error occurred while getting the ports by storage.

Explanation Error occurred while getting the ports by storage.

Recommended

Action


the HiStor API log.

E5900033

Error Message

ID

E5900033

Error Message

Text

Error occurred while getting the performance data of ports by storage.

Explanation Error occurred while getting the performance data of ports by storage.

Recommended

Action


the HiStor API log.

E5900034

Error Message

ID

E5900034

Error Message

Text

Error occurred while getting replication groups by storage.

Explanation Error occurred while getting replication groups by

storage.



Recommended

Action


E5900035

Error Message

ID

E5900035

Error Message

Text The parameter is null or invalid.

Explanation Error occurred while one of the input parameter is null or invalid.

Recommended

Action

Check the input parameters and ensure that they are not null or invalid.

E5900036

Error Message

ID

E5900036

Error Message

Text

Error occurred while getting the storage information by host.

Explanation Error occurred while getting the storage information by host.

Recommended

Action


E5900037

Error Message

ID

E5900037

Error Message

Text

Error occurred while getting the hostgroup, DP pool and parity group.

Explanation Error occurred while getting the hostg roup, DP pool and parity group.

Recommended

Action

Ensure that the storage array is not locked. Check the input parameters and detailed error message in the

HiStor API log.

E5900038

Error Message

ID

E5900038

Error Message

Text

Error occurred while creating replication with CTG by Thin image.

Explanation Error occurred while creating replication with CTG via thin Image.

Recommended Ensure that the storage array is not locked. Check the

Operations 115

Action input parameters and detailed error message in the HiStor API log.

E5900039

Error Message

ID

E5900032

Error Message

Text

Error occurred while deleting the replication pairs by CTG ID.

Explanation Error occurred while deleting the replication pairs by CTG ID.

Recommended

Action


E5900040

Error Message

ID

E5900040

Error Message

Text Error occurred while this argument is invalid.

Explanation Error occurred while this argument is invalid.

Recommended

Action

Ensure that the storage array is not locked. Check the input parameters and ensure that they are valid. (That is, some parameters, such as the CTG ID, must be

integers.)

E5900041

Error Message

ID

E5900041

Error Message

Text

Error occurred while removing the replication pairs and unmapping the S/V-VOL.

Explanation Unable to remove the replication pairs and unpresent them from the hostgroups.

Recommended

Action Ensure that the storage array is not locked.

E5900042

Error Message

ID

E5900042

Error Message

Text

Invalid Pair Status. The TI pair cannot be restored. This P-VOL has a SI pair that is not PSUS/PSUE. Change the SI pair status to PSUS or PSUE first.

Explanation The P-VOL has another SI pair that is not PSUS/PSUE.

Recommended

Action Check the P-VOL and change the SI pair that is not PSUS/PSUE to PSUE or PSUE. Then re-run this



operation.

E5900043

Error Message

ID

E5900043

Error Message

Text Error occurred while resyncing the CTG.

Explanation Cannot resync this CTG.

Recommended

Action

Ensure that the storage array is not locked. Also, check if this CTG has any replication pairs and the

status of the pairs.

E5900044

Error Message

ID

E5900044

Error Message

Text Error occurred while removing the HANA instance.

Explanation Cannot delete the HANA instance.

Recommended

Action

Restart the Hitachi HANA management service if needed.

E5900045

Error Message

ID

E5900045

Error Message

Text

Error occurred while creating SnapshotPair in new CTG with auto V-VOL.

Explanation Cannot create the HTI pairs in a new CTG.

Recommended

Action

Ensure that the storage array is not locked. Also, check if it has any available CTG (CTG range: 0-255

for HTI).

E5900046

Error Message

ID

E5900046

Error Message

Text

Error occurred while creating Shadow Image pair in new CTG and HDP with auto S-VOL.

Explanation Cannot create the ShadowImage pairs in a new CTG.

Recommended

Action

Ensure that the storage array is not locked. Also, check if it has any available CTG (CTG range: 0-127

for ShadowImage). In addition, ensure that the HDP pool has enough free space.

E5900047

Error Message E5900047

Operations 117

ID

Error Message

Text

Error occurred while using a CTG. No valid CTG is available for the replication. Valid CTG range: ShadowImage (0-127) Thin Image (0-255).

Explanation No valid CTG is available.

Recommended

Action

Remove some unused CTGs from the storage array. Then re-run this operation.

E5900048

Error Message

ID

E5900048

Error Message

Text

Error occurred while creating ShadowImage pair in new CTG and Parity Group with auto S-VOL.

Explanation Cannot create the ShadowImage pairs in a new CTG.

Recommended

Action

Ensure that the storage array is not locked. Also, check if it has any available CTG (CTG range: 0-127 for ShadowImage). In addition, ensure that the parity

group has enough free space.

E5900049

Error Message

ID

E5900049

Error Message

Text Error occurred with SAPUI5 on client's browser.

Explanation Error occurred on SAPUi5 side.

Recommended

Action

Check the error message on the log. Ensure that the status of the HANA cockpit is normal.

E5900050

Error Message

ID

E5900050

Error Message

Text

Error occurred while save the JS client error message to log.

Explanation Cannot save the error message from javascript to the log.

Recommended

Action

Ensure that the adapter management server has free space.

E5900051

Error Message

ID

E5900051

Error Message

Text

Error occurred while this argument has an illegal character.



Explanation The input parameter has an illegal character.

Recommended

Action

Check the input parameter and remove the illegal character (for example, *, %)

E5900052

Error Message

ID

E5900052

Error Message

Text Error occurred while splitting the CTG.

Explanation Cannot split the CTG.

Recommended

Action

Ensure that the storage array is not locked. Also, check the status of all replication pairs of this CTG.

MK-92ADPTR113-00

Hitachi Data Systems

Corporate Headquarters

2845 Lafayette Street

Santa Clara, California 95050-2627

U.S.A.

Phone: 1 408 970 1000

www.hds.com [email protected]

Asia Pacific and Americas

2845 Lafayette Street

Santa Clara, California 95050-2627

U.S.A.

Phone: 1 408 970 1000 [email protected]

Europe Headquarters

Sefton Park

Stoke Poges

Buckinghamshire SL2 4HD

United Kingdom

Phone: + 44 (0)1753 618000 [email protected]

http://www.hds.com/




hitachi storage adapter for the sap hana cockpit · pdf filehitachi storage adapter for the...

Documents