EMC Storage Integrator for SAP NetWeaver LVM: EHAC Administrator … · 2020-03-12 · 12 EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console

EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console (EHAC)Version 2.1

Administrator GuideP/N 300-014-915REV 03

EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console (EHAC) Administrator Guide2

Copyright © 2014 EMC Corporation. All rights reserved. Published in the USA.

Published May 2014

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and other countries. All other trademarks used herein are the property of their respective owners.

For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).

http://support.emc.com

Contents

Chapter 1 EMC Storage Integrator for SAP NetWeaver LVM Overview

Executive summary ........................................................................................ 8Product overview ........................................................................................... 8

Chapter 2 Prerequisites

System prerequisites ................................................................................... 12

Chapter 3 Installing EHAC

Downloading ESI for SAP NetWeaver LVM ..................................................... 16Installing the Java Development Kit (JDK)...................................................... 16Installing the Java Cryptography Extension ................................................... 16Installing the Apache database .................................................................... 16Installing and configuring the JBoss Application Server 7.1.1 ....................... 17

Download the JBoss files....................................................................... 17Configure and install JBoss as Windows Service .................................... 17

Chapter 4 Installing and configuring virtual hosts

Installing VMware tools................................................................................ 22Configure the CD/DVD drive .................................................................. 22Enable the VMware tools installation option for the virtual machine...... 22Copy the VMware tool file to a virtual machine ...................................... 23Install VMware tools.............................................................................. 24Verify the VMware tools installation ...................................................... 24

Enabling the disk UUID in a VMware virtual environment.............................. 25Configure the VMDK so that it can respond to a SCSI inquiry ................. 25Verify that utility and library package files are installed on the SAP host 27Configure the virtual host ...................................................................... 27

Chapter 5 Deploying EHAC

Deploying EHAC ........................................................................................... 30Configuring logging...................................................................................... 31Starting the EHAC server .............................................................................. 33Configuring the EHAC web service to run in HTTPS mode .............................. 33Updating EHAC ............................................................................................ 34

Chapter 6 Logging in to EHAC

Logging in to EHAC for the first time ............................................................. 36Setting up EHAC administrative login credentials ......................................... 36Logging in to EHAC....................................................................................... 37Opening the Home page .............................................................................. 38Changing the Global Access Level ................................................................ 38

Chapter 7 Configuring the ESI database

Configuring file storage ................................................................................ 42Add file storage systems ....................................................................... 42Update file storage systems .................................................................. 43Remove file storage systems ................................................................. 43

Configuring block storage ............................................................................ 44Add block WBEM servers....................................................................... 44

EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console (EHAC) Administrator Guide 3

Contents

Update or remove block WBEM servers ................................................. 44Add block storage systems.................................................................... 46View block storage pools ...................................................................... 47View block storage pool volumes .......................................................... 48

Configuring virtual systems.......................................................................... 49Add VMware vCenter virtual storage systems......................................... 49

Chapter 8 Managing User Accounts

Adding and removing users.......................................................................... 54Add a new user ..................................................................................... 54Update a user password........................................................................ 54Update an administrator password ....................................................... 55Remove a user ...................................................................................... 56

Configuring access control ........................................................................... 56Grant access to file storage systems and pools ..................................... 56Grant access to block storage systems and pools.................................. 57Revoke access to file storage systems and pools................................... 58Revoke access to block storage systems and pools ............................... 60

Securing user data....................................................................................... 61

Chapter 9 Troubleshooting

Troubleshooting........................................................................................... 64Manually cleaning up VMAX storage after a failed clone, copy, or machine refresh......................................................................................................... 65Using logs to monitor the system ................................................................. 71

Collect logs ........................................................................................... 71

4 EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console (EHAC) Administrator Guide

PREFACE

As part of an effort to improve its product lines, EMC periodically releases revisions of its software and hardware. Therefore, some functions described in this document might not be supported by all versions of the software or hardware currently in use. The product release notes provide the most up-to-date information on product features.

Contact your EMC technical support professional if a product does not function properly or does not function as described in this document.

Note: This document was accurate at publication time. Go to EMC Online Support (https://support.emc.com) to ensure that you are using the latest version of this document.

PurposeThis document describes how storage administrators can manage user accounts, assign storage systems to users, and manage storage assigned to users by using read/write access for storage system pools.

AudienceThis document is for internal EMC personnel, partners, and customers. The intended audience is SAP NetWeaver Administrators and storage administrators whowant to manage user accounts, assign storage space to users, and manage storage space access for individual users.

ScopeThis storage administrator guide is intended to provide an overview of ESI for SAP NetWeaver LVM and includes the following information:

◆ Product overview

◆ Prerequisites

◆ Installation and deployment

◆ ESI database configuration

◆ User account management

◆ Troubleshooting

Related documentationThe following EMC publications provide additional information:

◆ EMC Storage Integrator for SAP NetWeaver LVM Storage Adapter User Guide

◆ EMC Storage Integrator for SAP NetWeaver LVM Release Notes

Preface 5


Preface

Conventions used in this documentEMC uses the following conventions for special notices:

NOTICE is used to address practices not related to personal injury.

Note: A note presents information that is important, but not hazard-related.

Typographical conventions

EMC uses the following type style conventions in this document:

Where to get helpEMC support, product, and licensing information can be obtained as follows:

Product information — For documentation, release notes, software updates, or information about EMC products, go to EMC Online Support at:

https://support.emc.com

Technical support — Go to EMC Online Support and click Service Center. You will see several options for contacting EMC Technical Support. Note that to open a service request, you must have a valid support agreement. Contact your EMC sales representative for details about obtaining a valid support agreement or with questions about your account.

Your commentsYour suggestions will help us continue to improve the accuracy, organization, and overall quality of the user publications. Send your opinions of this document to:

[email protected]

Bold Used for names of interface elements, such as names of windows, dialog boxes, buttons, fields, tab names, key names, and menu paths (what the user specifically selects or clicks).

Italic Used for full titles of publications referenced in text.

Monospace Used for:• System output, such as an error message or script• System code• Path names, filenames, prompts, and syntax• Commands and options

Monospace italic Used for variables.

Monospace bold Used for user input.

[ ] Square brackets enclose optional values.

| Vertical bar indicates alternate selections — the bar means “or.”

{ } Braces enclose content that the user must specify, such as x or y or z.

... Ellipses indicate nonessential information omitted from the example.



CHAPTER 1EMC Storage Integrator for SAP NetWeaver LVM Overview

This chapter presents the following topics:

◆ Executive summary ................................................................................................... 8◆ Product overview ...................................................................................................... 8

EMC Storage Integrator for SAP NetWeaver LVM Overview 7

EMC Storage Integrator for SAP NetWeaver LVM Overview

Executive summary

EMC® Storage Integrator (ESI) for SAP NetWeaver Landscape Virtualization Manager (LVM) is an adapter for SAP NetWeaver LVM. ESI for SAP NetWeaver LVM has two main components: an ESI adapter and a web service called the EMC High Level Storage (HLS) Library Administration Console (EHAC). EHAC provides a deployment utility and a single point of management for storage administrators to:

◆ Manage vCenter servers

◆ Assign storage systems and their pools to users

◆ Provide a gateway for the ESI adapter for SAP LVM to access storage systems

With EHAC, administrators can manage storage space assigned to individual users by controlling read/write access to the storage pools for each storage system. The adapter supports physical and virtual machines with support for EMC VNX® and EMC Symmetrix® VMAX®, VCE Vblock converged storage using either VMAX or VNX storage, and a VMware hypervisor that uses virtual machine disks (VMDK) and raw device mapping (RDM).

The ESI for SAP NetWeaver LVM Adapter provides storage management capabilities within SAP NetWeaver LVM and enables SAP administrators to manage cloning and snapshots of an SAP system that is managed by NetWeaver LVM and is running on EMC storage.

Product overviewThe ESI adapter is distributed as a Java Enterprise Archive (EAR) file that complies with SAP NetWeaver LVM specifications. The adapter, which is shown in Figure 1, runs in the SAP NetWeaver Java server with the LVM add-on installed. The ESI for SAP NetWeaver LVM Adapter integrates with EMC file and block storage systems.

You can use EHAC to manage one or more EMC file or block storage systems. In SAP NetWeaver LVM, the adapter uses the same Java Application Server to query the storage systems, so storage can be provisioned as part of system cloning.

8 EMC Storage Integrator for SAP NetWeaver LVM: EMC HLS Administration Console (EHAC) Administrator Guide


Figure 1 ESI for SAP NetWeaver LVM Adapter

Product overview 9


10 EMC Storage Integrator for SAP NetWeaver LVM: EMC HLS Administration Console (EHAC) Administrator Guide

CHAPTER 2Prerequisites

This chapter presents the following topic:

◆ System prerequisites .............................................................................................. 12

Prerequisites 11

Prerequisites

System prerequisites

Note: The EMC Storage Integrator for SAP NetWeaver LVM Release Notes provides detailed environment and system requirements and a complete list of operating systems that you can use for different types of storage.

Before you install the EMC HLS Administration Console (EHAC) and the ESI for SAP NetWeaver LVM adapter, follow these steps:

1. Install and set up the software listed in Table 1.

Note: Storage administrators must configure an ECOM account with the Administrator role to allow full access. Zoning and masking should also be completed before configuration. For detailed information about ECOM, see the ECOM Deployment and Configuration Guide.

Table 1 Prerequisite software

Software Minimum software version Installed on

Microsoft Windows Server 2008 R2 x64 EMC EHAC server

SAP NetWeaver Java Server 7.30 SP08 , 7.31 SP04 SAP NetWeaver LVM server

SAP NetWeaver LVM 2.00, SP04 (with a minimal display resolution of 1280 x 960)

SAP NetWeaver LVM server

Browser IE 9, if using Internet Explorer (other browsers will also work)

User desktop

EMC SMI-S Provider® 4.6.1.6 EMC EHAC server

EMC Solutions Enabler® 7.6.2.9 All SAP NW LVM managed hosts

Java Development Kit (JDK) 1.7 EMC EHAC server

Java Cryptography Extension (JCE) JCE-7 for Java 1.7 with Unlimited Strength Jurisdiction Policy Files 7

EMC EHAC server

JBoss Application Server 7.1.1 EMC EHAC server

Apache Derby database 10.8 EMC EHAC server

SAP Host Agent 7.20 or the latest patch All SAP NetWeaver LVM managed hosts


Prerequisites

Notes: • For information on how to install EMC Solutions Enabler, refer to

https://support.emc.com/products/2071_Solutions-Enabler/Documentation/

• SMI-S Provider 4.6.1.6, which is installed on the EHAC server, uses an ECOM account. This WBEM infrastructure is used for both proxy and embedded environments across all EMC hardware and software platforms to ensure consistent implementation and experience across EMC products. For information about how to install EMC SMI-S Provider, refer to https://support.emc.com/products/5587_SMI-S-Provider.

2. Complete the following prerequisites for the SAP NetWeaver LVM management system:Install and configure the SAP NetWeaver Java Server with the releases described in Table 1.

• Install and configure the SAP NeWeaver LVM 2.0 add-on to run on the SAP NetWeaver Java server 7.3x.

• Complete the configuration steps for the SAP NetWeaver LVM 2.0 Setup before you configure the infrastructure and the storage managers.

• Store the SAP file systems (/sapmnt, /usr/sap/SID, and /usr/sap/trans) and the SAP Database file systems (/oracle/SID, oracle/SID/sapdata1, for example) in separate datastores from the operating system of the source and target virtual machines.

• To facilitate SAP, EMC, and VMware support, list which SAP virtual machines are used and which SAP file systems are stored in which datastores.

Note: As a best practice, to facilitate and speed up any troubleshooting, document in high level detail the SAP, VMware, and EMC environments for each virtual machine. Include the masking views being used, physical storage device IDs, datastores names, virtual machine settings, SCSI controller number, and ports used by each hard disk. Include also the guest OS device IDs, VGs, LVs, and file systems being used for each datastore.

• For SAP managed environments based on VMAX storage systems, add a minimum of one GateKeeper configured as phyiscal RDMs to each virtual machine to be involved in SAP NetWeaver LVM storage-based operations like Instance prepare/unprepare, relocation, system rename, system copy and system refresh processes.

• When working with SAP LVM 2.0 and ESI 2.1, only the SAP and SAP database filesystems (/sapmnt, /usr/sap/SID, /oracle/SID/sapdata, for example) are cloned using ESI cloning technologies. Both the source and target virtual machine must have their operating systems installed in advance in their own hard disks in separate datastores to avoid delaying the cloning process.

• The SAP source and target systems instances must already be installed or configured according to the SAP Adaptive Enable concept, with independent virtual IPs, virtual hostnames, and file systems.

• Install the latest SAP Host Agent patch level on the SAP systems to be cloned by SAP NetWeaver LVM 2.0 with ESI 2.1.

System prerequisites 13



https://support.emc.com/products/5587_SMI-S-Provider

https://support.emc.com/products/5587_SMI-S-Provider

Prerequisites

3. If you use block storage, install and set up the following required software in Table 2.

4. If you use virtual machine (VMDK) disks or raw device mapping (RDM) disks, you must also install and set up the software in Table 3.

Note: Chapter 4, “Installing and configuring virtual hosts,”provides details for installing and configuring virtual hosts.

Other considerations when using virtual storage:

– Multiple paravirtual SCSI (PVSCSI) controllers are supported, which conforms to the minimum SAP and VMware best practices. Configuring disks to use VMware Paravirtual SCSI (PVSCSI) adapters (1010398) in the VMware Knowledge Base provides details.

– If you use VMware vSphere in a Linux operating system, see the SAP 1122388 - Linux: VMware vSphere configuration guidelines.

Table 2 Prerequisite software for block storage

Software Minimum software version

EMC Solutions Enabler® 7.6.2.9

EMC SMI-S Provider® 4.6.1.6

EMC Enginuity for VMAX® systems 5876

EMC Flare® for VNX storage 29 (32 for new snapshots)

Table 3 Prerequisite software for virtual storage

Software Software version

VMware vCenter Server (virtual environments)

5.1 or 5.5

VMware Tools On all SAP managed hosts


http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1010398




CHAPTER 3Installing EHAC


◆ Downloading ESI for SAP NetWeaver LVM ................................................................ 16◆ Installing the Java Development Kit (JDK)................................................................. 16◆ Installing the Java Cryptography Extension .............................................................. 16◆ Installing and configuring the JBoss Application Server 7.1.1 .................................. 17

Installing EHAC 15

Installing EHAC

Downloading ESI for SAP NetWeaver LVMESI for SAP NetWeaver LVM is distributed as a Java EAR file and can be downloaded from EMC Online Support at http://support.emc.com.

You can download and use the ESI Adapter and EHAC separately. This could commonly occur if the user is not also the storage administrator.

To download ESI for SAP NetWeaver LVM:

1. Go to the EMC Online Support product page at https://support.emc.com/products/28468_ESI-for-SAP-LVM

2. Click the Downloads link and download the following files:

• Storage Integrator for SAP NetWeaver LVM Web Service

• Storage Integrator for SAP NetWeaver LVM Deployment Console

• Storage Integrator for SAP NetWeaver LVM Plug-in

Installing the Java Development Kit (JDK)To install the JDK:

1. Download and install JDK version 1.7 from

http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html.

2. Set the JAVA_HOME directory to the JDK1.7 installation directory. For example:

C:\Program Files\Java\jdk1.7.0_55\

Installing the Java Cryptography ExtensionTo install the Java Cryptography Extension:

1. Download the software and follow the installation instructions at: http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html

2. Unzip the UnlimitedJCEPolicyJDK7.zip file to the applicable temporary folder or directory.

3. Copy the local_policy.jar and the US_export_policy.jar files to the %JAVA_HOME%\jre\lib\security folder

Installing the Apache databaseTo install the Apache database:

1. Download derby.jar from the following location:

https://db.apache.org/derby/derby_downloads.html

2. Go to the latest 10.8.* version link and download the db-derby-10.8*-lib.zip file.


http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html




https://support.emc.com/products/28468_ESI-for-SAP-LVM



http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

Installing EHAC

3. Extract the derby.jar file and copy it to a location on the EHAC server.

Installing and configuring the JBoss Application Server 7.1.1Use the following procedures to download, install, and configure JBoss Application Server 7.1.1.

Download the JBoss files

To install JBoss Application Server version 7.1.1 or later:

1. Download the JBoss AS 7.1.1.Final software from: http://www.jboss.org/jbossas/downloads/

2. Create the c:\jboss directory and extract all the contents of the jboss-as-7.1.1.Final.zip file that was downloaded there.

3. To install JBOSS as a service, download the JBoss native library from

https://www.jboss.org/jbossweb/downloads/jboss-native-2-0-10.html.

4. From the esi-jboss-native-2.0.10-windows-x64-ssl.zip file, that was downloaded and extracted in a temporary directory, copy all the files in the bin directory tothe esi-jboss-native-2.0.10-windows-x64-ssl bin directory to the jboss-as-7.1.1.Final bin directory.

Configure and install JBoss as Windows Service

To configure and install JBoss as a Windows service:

1. Open the service.bat file and confirm if the following modifications are done and saved:

a. Replace all occurrences of run.bat with standalone.bat

b. Replace all occurrences of call shutdown -S < .s.lock >> shutdown.log 2>&1 with jboss-cli.bat --connect command=:shutdown >> shutdown.log 2>&1

c. Replace set JAVA_OPTS=-Xrs with REM set JAVA_OPTS=-Xrs

2. Open a command line window as Administrator.

a. Select Run, type cmd, and press Enter.

b. Change the location to the bin directory of JBoss.

For example: C:\Program Files\jboss-as-7.1.1.Final\bin

3. Run the service.bat install command in the command prompt.

Installing and configuring the JBoss Application Server 7.1.1 17

http://www.jboss.org/jbossas




https://www.jboss.org/jbossweb/downloads/jboss-native-2-0-10.html

Installing EHAC

The expected results are shown in Figure 2.

Figure 2 Run the service.bat install command in the command prompt

4. After the JBoss service is installed, select Services and Application > Computer Management > JBoss Application Server 7.1.1.

5. Right-click JBoss Application Server 7.1.1, and then select Properties.

6. Select a Startup Type of Automatic.

7. Start the service, and then click OK.

Figure 3 Start the JBoss service


Installing EHAC

JBoss troubleshooting tipsUse the following tips to troubleshoot JBoss:

1. If you see a Failed installing JBoss, Access is denied error, you have not opened the command line prompt as an administrator.

a. To open the command line prompt as an administrator, select Run.

b. Type cmd, and then press CTRL+SHIFT+ENTER.

2. If an Out of Memory error occurs, increase the memory allocated by editing the standalone.conf file in bin directory in JBoss.

For example, C:\Program Files\jboss-as-7.1.1.Final\bin:

if [ "x$JAVA_OPTS" = "x" ]; then JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000" JAVA_OPTS="$JAVA_OPTS -Djboss.modules.system.pkgs=$JBOSS_MODULES_SYSTEM_PKGS -Djava.awt.headless=true" JAVA_OPTS="$JAVA_OPTS -Djboss.server.default.config=standalone.xml"

Installing and configuring the JBoss Application Server 7.1.1 19

Installing EHAC


CHAPTER 4Installing and configuring virtual hosts


◆ Installing VMware tools ........................................................................................... 22◆ Character tags......................................................................................................... 28◆ Cross-reference formats .......................................................................................... 29

Installing and configuring virtual hosts 21

Installing and configuring virtual hosts

Installing VMware toolsUse the procedures in this chapter to:

◆ Install VMware tools

◆ Enable the disk universally unique identifier (UUID) in a VMware virtual environment

Configure the CD/DVD drive

To configure the CD/DVD drive:

1. Log in to the ESXi server with the vSphere client, or log in to the vCenter client where the ESXi server was added.

2. Ensure that the VMware ESXi installation .iso image file is present in the data store of the ESXi server.

3. Select the virtual machine where the VMware tools will be installed.

4. Right-click Edit Settings for the virtual machine, select the CD/DVD drive, and then select the data store .iso image file.

5. Browse to select the ESXi .iso image file on the datastore.

Figure 4 Select the ESXi .iso image file

Enable the VMware tools installation option for the virtual machine

To enable Vmware tools to be installed on a specied virtual machine:

1. Select a virtual machine to install the VMware tools.

2. Click Guest > Install Upgrade VMWare Tools.



Figure 5 Click Install Upgrade VMWare Tools

Copy the VMware tool file to a virtual machine

After you install the VMware tools installation option , the guest operating system will automatically mount the ISO:

1. Run the following command if the tools are not automatically installed:

mount /dev/cdrom /mnt/cdrom

This command displays the VMwareTools-5.x.0-<xxxx>.tar.gz tar file.

2. Run the following command to copy the tar file to the virtual machine:

cp /mnt/cdrom /root/temp

3. Run the following command to uncompress the tar file:

tar -xvf /root/temp/VMwareTools-5.1.0<xxxx>.tar.gz

Figure 6 Locate the VMwareTools-5.1.0-<xxxx>.tar.gz tar file

Installing VMware tools 23


Install VMware tools

To install VMWare tools:

1. Navigate to the folder where the installer was uncompressed:

cd vmware-tools-distrib

2. Start the installation by running the perl installer:

./vmware-install.pl

3. Press Enter to accept all of the default values.

Verify the VMware tools installation

To verify that VMware tools have been successfully installed:

1. Log in to the ESXi server with the vSphere or vCenter credentials.

2. Select VM > Summary.

3. Click the Summary General tab and check that VMware tools are running.

Figure 7 Check that VMware tools are running



Enabling the disk UUID in a VMware virtual environmentVMware ESXi creates a virtual disk on the virtual machine file system (VMFS) and generates a unique UUID that is associated with the virtual disk and keeps it in the .vmdk configuration file.

The following procedures configure the VMDK so that it can respond to a SCSI inquiry and then verify that utility and library files are installed on the SAP host.

◆ The procedure uses the following file example:

vmfs/volumes/5200af41-812305ce-8c2c-60735c68a5da/SAPSource/SAPSource_2.vmdk 1

◆ The unique ID associated with the virtual disk is shown as a line in this configuration file:

ddb.uuid = "60 00 C2 91 f0 3d 87 83-33 72 4a 1a 7b ea 0a 66"

◆ By default, the VMware ESXi server will not respond to a SCSI inquiry from the guest OS to read the VPD that is associated with the virtual disk. We need VPD information associated with virtual disk and that should be readable from the guest OS using SCSI inquiry.

◆ To make VMDK respond to SCSI inquiry to read VPD page, the vmware guest OS must be configured to have a "disk.enableUUID = "TRUE" entry in the guest OS .vmx configuration file.

Configure the VMDK so that it can respond to a SCSI inquiry

To configure the VMDK:

1. Log in to the VMware ESXi server, or log in to vCenter, which manages the SAP host.

2. Select the host, and then select Edit virtual machine settings.

Figure 8 Select the host, and then select Edit virtual machine settings

Enabling the disk UUID in a VMware virtual environment 25


3. From the Virtual Machine Properties dialog box, select Options > General > Configuration Parameters.

Figure 9 Select Configuration Parameters.

4. Select Add Row.

5. Type the following details for the new row:

• Name = disk.enableUUID

• Value = TRUE

6. Click OK to save the new configuration parameters.

Figure 10 Add a new row



Verify that utility and library package files are installed on the SAP host

To verify that SG utility and library package files are installed:

1. Log in to the SAP host.

2. Run the following command: rpm -qa | grep sg3*

The SG utility and library package files are installed on the host if sg3_utils and sg3_utils-libs are displayed.

3. If sg3_utils and sg3_utils-libs are not installed, locate the rpm in the ISO of the Linux installer or download the binaries and install them on the host.

Note: You can run the rpm -qa > Lists command to find all rpm packages that are installed on the host.

Configure the virtual host

How to run the script

1. Copy the Configure_VirtualHost.sh script to the source virtual machine and to the target virtual machine of the SAP instance.

The script can be downloaded from https://support.emc.com/products/28468_ESI-for-SAP-LVM

2. Grant execute permission to the script:

chmod 755 Configure_VirtualHost.sh

3. Run the following script:

./Configure_VirtualHost.sh

4. Accept all of the default values:

• Enter ESXi IP address on which Virtual machine resides.

• Enable SSH on the ESXi server on which the virtual machine resides.

• ESXi Username which has the administrative permission and password.

Functionalities of the script

The script can be used for the following three functionalities:

◆ Adding an ESXi entry to the Solutions Enabler (SE) database.

◆ Deleting the ESXi entry that was previously added to the SE database.

◆ Listing all of the ESXi details in the SE database.

Add an ESXi entry to the SE database

Solution Enabler (SE) needs details about the ESXi host to get the underlying storage array information. The ConfigureVirtualHost.sh script helps SE to get this information by updating the ESXi IP address, username , and password in the SE database. The script runs the following commands:

Enabling the disk UUID in a VMware virtual environment 27




Command : symcfg auth add -vmware -host <IP_Address> -username <UserName> -password <Password> -vmport 5988 -namespace vmware/esxv2

1. To enable secure communication between ESX server and Solution Enabler , SE needs ESX server certificates for HTTPS communication:

• The ESXi certificate is available on the ESXi server at /etc/vmware/ssl.

• The ESXi certificate file name is rui.crt.

2. Copy the virtual machine certificate to the following location:

/var/symapi/config/viclient_cert.pem

3. Run the discover command for SE to connect to the ESXi server and get details of the underlying storage array:

symcfg discover -all ( VNX & VMAX)

Useful commands

You can run the following commands to do the following:

◆ To check which ESXi server is currently configured:

symcfg auth list -vmware

◆ To remove the entry of the ESXi server where the virtual machine is no longer running:

symcfg auth delete -host <IP Address> -user -namspace vmware/esxv2 -vmware

◆ To add a new ESXi server entry where the virtual machine is now running:

symcfg auth add -vmware -host <IP_Address> -username <UserName> -password <Password> -vmport 5988 -namespace vmware/esxv2

Notes: ◆ The Configure_VirtualHost.sh script must be run on every SAP virtual machine to be

used with EMC ESI 2.1.

◆ This script adds an entry for the ESXi server where it is currently running in the symcfg database of the virtual machine. If the virtual machine is moved by vMotion or restarted by vSphere HA to another ESXi server, the entry must be removed and a new one added with the new ESXi server where the VM is running now.


CHAPTER 5Deploying EHAC


◆ Deploying EHAC ...................................................................................................... 30◆ Updating EHAC........................................................................................................ 31◆ Configuring logging ................................................................................................. 31◆ Starting the EHAC server ......................................................................................... 33◆ Configuring the EHAC web service to run in HTTPS mode ......................................... 33

Deploying EHAC 29

Deploying EHAC

Deploying EHACEHAC includes the EHAC_DeploymentConsole_2.1.0.7 jar file and the esi_sap_lvm_saconfig.2.1.0.7.ear file for the web service.

To configure the database and update the JBoss configuration files:

1. Download EHAC_Deployment.jar from https://support.emc.com/products/28468_ESI-for-SAP-LVM

2. Double-click EHAC_Deployment.jar.

3. In the Configuration Utility, click the Configure Server tab.

4. Click Download to download the JCE files from the Oracle website.

5. In the Downloaded (Unzipped) Location of the JCE files field, click Select to select the downloaded JCE files in the displayed location.

Note: If you are deploying EHAC for the first time, select the downloaded JCE files and also click Configure JCE Files. This replaces the local_policy.jar and the US_export_policy.jar files in the %JAVA_HOME%\jre\lib\security folder. You will receive a “Configured JCE Files Successfully” message to confirm the JCE configuration.

6. In the JBOSS Location field, type the location where JBoss is installed or click Select and browse to find the location.

Note: You can click Check Whether Configured to confirm whether JBOSS is already configured. You will receive a “JBOSS is already configured” message if JBoss is configured.

7. Type the applicable database name in the Database Name field.

8. In the Derby Client Jar field, type the path to the derby.jar file or click Select and browse to find the file.

9. In the Path Where Database needs to be created field, type the applicable path or click Select to choose a path.

10. Copy the Java EAR file named esi_sap_lvm_saconfig.2.1.0.7.ear into the <Jboss Installation path>/standalone/deployments folder.

11. Click Configure.



Deploying EHAC

After the configuration is complete, esi_sap_lvm_saconfig.2.1.0.7.ear is ready to be deployed.

Figure 11 Deploy EHAC

Configuring loggingYou can configure logging to monitor the operation of the system. This enables system administrators and EMC support engineers to troubleshoot issues that users may encounter. “Using logs to monitor the system” on page 71 provides more information about using logs.

To configure logging:

1. In the Configuration Utility, click the Configure LOGS tab.

2. In the Directory Where Logs need to be Created field, enter the full path of the folder to which logs should be saved.

3. Click Select to select the directory path that you entered.

4. Select a Logging Level to create logs that contain the following data:

• INFO: Informational data only, that does not include errors

• DEBUG: INFO data and debugging information

• TRACE: INFO, DEBUG, and stack trace data that will generate more logs

• ERROR: INFO and error messages

Configuring logging 31

Deploying EHAC

5. Click Configure.

A “Log Folder and Log level configured successfully” confirmation message appears.

Figure 12 Click Configure

Note: You can click Collect Logs to create a Zip file that contains logs that are generated by ESI. EMC support may request these logs to troubleshoot issues.

Figure 13 Click Collect Logs to create a Zip file containing the generated logs


Deploying EHAC

Starting the EHAC serverTo start the EHAC server:

1. Navigate to the Start Server tab.

2. Use the default 8080 server port.

3. Enter the IP address of the host where the JBoss is configured.

4. Click Start Server to start the EHAC server.

Figure 14 Start EHAC

Configuring the EHAC web service to run in HTTPS modeConfiguring the EHAC web service to communicate through HTTPS is optional but is highly recommended.

To configure the EHAC web service to run in HTTPS mode:

1. Double-click EHAC_Deployment.2.1*.jar to start the EHAC Configuration Utility.

2. In the Configuration Utility field, click the Configure Https tab.

3. In the Configured Database on JBoss Server Path field, type the path to the JBoss installation folder.

4. Click Check Whether Configured. If EHAC is not configured, configure it before going to the next step. “Deploying EHAC” on page 30 provides details.

5. For Generate a Self Signed Certificate, do the following:

a. In the Path Where Self Signed Certificate Needs to be Stored field, click Select and then browse to find the path in which a certificate can be generated.

b. Type the Name of the Keystore and the Keystore alias.

c. Click Generate.

6. For Configure Server to Use Self Signed Certificate, do the following:

a. In the Keystore alias field, click Select and then browse to find the path to the certificate that should be used.

Starting the EHAC server 33

Deploying EHAC

b. Type the applicable password and alias in the Keystore Password and the Keystore alias fields.

c. Click Configure.

Figure 15 Configure the web service to run in HTTPS mode

Updating EHACTo update EHAC with patches:

1. Stop the running EHAC server.

2. Remove the old EHAC_Deployment.jar file and replace it with the latest version of the file.

3. Delete the older version of esi_sap_lvm_saconfig.2.1.ear.

4. Copy the newer Java EAR file named esi_sap_lvm_saconfig.2.1.0.7.ear into the <Jboss Installation path>/standalone/deployments folder.

Restart the EHAC server.


CHAPTER 6Logging in to EHAC


◆ Logging in to EHAC for the first time......................................................................... 36◆ Setting up EHAC administrative login credentials .................................................... 36◆ Logging in to EHAC .................................................................................................. 37◆ Opening the Home page ......................................................................................... 38◆ Changing the Global Access Level ........................................................................... 38

Logging in to EHAC 35

Logging in to EHAC

Logging in to EHAC for the first timeThe first time that you log in to EHAC, read the EMC Software License Agreement, and then click I Accept.

Figure 16 Accept the EMC Software License Agreement

Setting up EHAC administrative login credentialsTo set up administrative credentials the first time that you log in to EHAC:

1. Open EHAC in your web browser.

2. Type a username and name in the Username and User Full Name fields.

3. Type a strong Password and retype it for confirmation.

4. Type an Encryption Key and retype it for confirmation.

5. From the Security Question field, select a question.

Note: You can use the security question to retrieve the password if you lose it.

6. Type a Secret Answer and retype it for confirmation.

7. Click Create.


Logging in to EHAC

Figure 17 Select a security question and type a secret answer

Logging in to EHAC To log in to EHAC after you set up administrative credentials:

1. Open EHAC in your web browser: http://<IPAddress>:<Port>/ehac

2. Enter your Username.

3. Enter your Password.

Note: If you forget your password, click Forgot Password. You can retrieve it by answering the security question set up during your first log in. “Setting up EHAC administrative login credentials” on page 36 provides details.

4. Click Login.

Figure 18 Log in to EHAC

Logging in to EHAC 37

Logging in to EHAC

Opening the Home pageThe Home page appears when you log in to EHAC, or when you click Home. The page includes two panes:

◆ The left pane displays file storage systems and the pools that are assigned to specific users.

◆ The right pane displays block storage and the pools that are assigned to specific users.

Figure 19 View the Home page

Changing the Global Access LevelChange a global access level to enable or disable read/write access to storage systems for all users. When you enable Global Access Level overrides, they override all other settings. If the Global Access Level is set to read only, all write access is also disabled.

Note: You can also enable or disable access for individual users. When you add a new array, the default global access level is the read/write mode. “Configuring file storage” on page 42 provides more information.

To change the Global Access Level:

1. From the Administrator Menu, click Global Access Level.

2. Select a storage system from the list.


Logging in to EHAC

3. Click Change Access Type. An “Access Level Changed” confirmation message appears to confirm the change.

Figure 20 Change the Global Access Level

Changing the Global Access Level 39

Logging in to EHAC


CHAPTER 7Configuring the ESI database


◆ Configuring file storage ........................................................................................... 42◆ Configuring block storage........................................................................................ 44◆ Configuring virtual systems ..................................................................................... 49

Configuring the ESI database 41

Configuring the ESI database

Configuring file storageUse the following procedures to configure file storage systems.

Note: Status messages for completing operations in EHAC are displayed in the top left of the window, above the Name field in Figure 21.

Add file storage systems

To add file storage systems:

1. From the File section of the Administrator Menu, click Add.

2. Type a Name for the new storage system.

3. Type the Control Station IP Address and the Model number (for example, VNX5300) for the storage system.

4. Type the User Name and Password for the control station, and then retype the password for confirmation.

5. Click Retrieve Data Movers.

6. Select one or more data movers from the right pane.

7. Click Add Storage System. A “Storage system added successfully” message appears when the process is complete.

Figure 21 Add a file storage system



Update file storage systems

To update file storage systems:

1. From the File section of the Administrator Menu, click Update.

2. Select the storage system to update and click Update Storage Array.

3. To update the Mover IP Address, click the Update Mover IP Address tab, and type the new information.

4. To update the username or password, click the Update UserName/Password tab and type the new updates.

5. To update the model, click the Update Model tab and type the new information.

6. Click Update the Storage System.

Figure 22 Update a file storage system

Remove file storage systems

To remove file storage systems:

1. From the File section of the Administrator Menu, click Remove.

2. Select the storage system that is to be removed.

3. Click Yes to confirm the action.

Configuring file storage 43


Configuring block storageUse the following procedures to configure block storage systems.

Add block WBEM servers

To add Web-Based Enterprise Management (WBEM) block servers:

1. From the Block section of the Administrator Menu, click Server.

2. Select a Connection Schema of either Http or Https.

3. Type the IP Address, Server Name, and Port number.

Note: The IP address is usually the same as the IP address of the EHAC server.

4. Enter a username and password for the ECOM server.

5. Click Add. If the server details are correct, an “Adding Server Details Successful” message appears.

Figure 23 Add a block WBEM server

Update or remove block WBEM servers

Note: Before you can remove a block server, you must first remove users who have access to the storrage arrays and storage pools.

To update or remove block servers:

1. From the Block section of the Administrator Menu, click Server.

2. Select a server from the right pane.



3. Click Remove/Update Server. Use the Remove/Update the WBEM Server dialog box for the following actions:

a. To change the username or password:

1. Click the Update User Name/Password tab.

2. Type the new updates.

3. Click Update User Name/Password.

Figure 24 Update a username and password

b. To update the connection type or protocol:

1. Click the Update Connection Schema/Port tab.

2. Update information in the Connection Schema and Port fields.

3. Click Update Connection Schema/Port/Protocol.

Figure 25 Update the connection schema, port, and protocol

c. To remove a WBEM server:

1. Click the Remove the WBEM Server tab.

2. Click Remove Server.

Configuring block storage 45


Figure 26 Remove a WBEM server

Figure 27 Update or remove a block server

Add block storage systems

Note: Before you add block storage ensure that EMC SMI-S Provider with Solutions Enabler is aready installed on the EHAC server.

To add block storage systems:

1. From the Block section of the Administrator Menu, click Storage System.

2. In the WBEM Server pane, from the Select Server field, select the WBEM server on which you want to add the storage system. You can view details for the selected server in the other fields.

3. Type the WBEM server User Name and Password, and then click Retrieve.

4. Storage systems are listed in the right pane in the List of Storage Systems Managed by the Server section.



5. For EMC CLARiiON CX4 and VNX storage systems, type the following storage system values in the Add a New Storage System pane at lower left:

Note: Omit step 5 for VMAX storage systems, because the storage systems are discovered when you click Retrieve.

a. In the Select Type field, select the type of storage system (CLARiiON, for example).

b. Type the applicable storage processor addresses for the SP-A IP Address and the SP-B IP Address.

c. Type the applicable values for the Array User Name and Array Password fields.

d. Click Add.

6. A “Storage System Added Successful” message appears.

Figure 28 Add a block storage system

View block storage pools

To view block storage pools:

1. From the Block section of the Administrator Menu, click Storage Pools.

2. In the left WBEM Server pane, select a server and type the user name and password.

3. Click Retrieve.

Configuring block storage 47


4. Select a storage system from the Component Name list and click Retrieve Pools.

Figure 29 View block storage pools

View block storage pool volumes

To view block storage pool volumes:

1. From the Block section of the Administrator Menu, click Storage Pools.

2. In the left WBEM Server pane, select a server and type the user name and password.

3. Click Retrieve Pools, and then select a pool from the list.

4. Click Retrieve Volumes.

Figure 30 View block storage pool volumes



Configuring virtual systemsAdd and configure virtual storage systems.

Add VMware vCenter virtual storage systems

To add VMware vCenter virtual storage systems:

1. From the Virtual System section of the Administrator Menu, click vCenter.

Note: The default Connection Schema is https.

2. Type the IP Address.

3. Type a Friendly Name, which is a short name that is unique among vCenter storage systems.

4. Enter the vCenter User Name and Password. This user must have administrator permission.

5. Click Add vCenter.

If the server details are correct, a “Successfully Added” message appears.

Note: You can click Test Connection to check the connection after adding a vCenter system. A “Successfully Added” message will confirm a successful connection...

Figure 31 Click Add vCenter

6. From the lower left pane, select a system from the List of Available vCenter Systems.

Configuring virtual systems 49


7. Click Retrieve DataCenter.

Figure 32 Click Retrieve DataCenter.

8. From the List of DataCenter in selected vCenter in the upper right pane, select a data center.

9. Click Retrieve ESX.

Figure 33 Click Retrieve ESX

10. From the List of ESXs in the selected vCenter in the middle right pane, select an ESX server.



11. Click Retrieve VMs.

12. From the lower right Virtual Machines pane, select a virtual machine to add to the database.

13. Click Add to DB.

Figure 34 Select a virtual machine to add to the database

Note: Before you can use the prepare, unprepare, relocation, system clone, or system clone processes, you must add all of the SAP source and target virtual machines to the EHAC database.

Configuring virtual systems 51



CHAPTER 8Managing User Accounts


◆ Adding and removing users..................................................................................... 54◆ Configuring access control ...................................................................................... 56◆ Securing user data .................................................................................................. 61

Managing User Accounts 53

Managing User Accounts

Adding and removing usersUse the following procedures to add or remove users.

Add a new user

To add a new user:

1. From the User section of the Administrator Menu, click User Operation.

2. At the top of the pane, click New User.

3. In the Add a New LVM User dialog box, type the User Name and User Full Name.

4. Type a strong Password and then type it again for confirmation.

5. Click Create User.

Note: This is the user that will be used in the SAP NetWeaver LVM Storage Manager configuration to communicate with the EMC storage arrays where the SAP systems are running.

Figure 35 Add a new user

Update a user password

To update a user password:


2. At the top of the pane, click Update User.

3. From the Update LVM User dialog box, in the User Name field, select a user to be updated.

4. Type the Old Password.

5. Type a new strong Password and then type it again for confirmation.



6. Click Update.

Figure 36 Update a user password

Update an administrator password

To update an administrator password:


2. At the top of the pane, click Update Administrator.

This opens the Update Administrator Password dialog box.

3. Type the Old Password.

4. Type a new strong Password and then type it again for confirmation.

5. Click Update.

Figure 37 Update an administrator password

Adding and removing users 55


Remove a user

To remove a user:


2. At the top of the pane, click Remove User.

3. From the User Name field, select the user to be removed.

4. Click Yes to confirm the action.

Figure 38 Remove a user

Configuring access controlUse the following procedures to grant access for users to file, block, and virtual storage systems and pools.

Grant access to file storage systems and pools

To grant access to file storage systems and pools:

1. From the Access Control > File section of the Administrator Menu, click Grant.

2. Select a storage system from the Select the Storage System to Grant the Access Level pane.

3. To grant access to users:

a. Click User Level.

The Select the Users to Grant the Storage System Access Level dialog box appears.

b. Select one or more users from the left pane of the dialog box.

c. Click the right arrow to move the user or users into the right pane.

Note: The selection list does not include users who were granted access to a selected storage system in the past.

d. Click Grant.



4. To grant access to storage pools:

a. Click Pool Level. File storage pools will be retrieved and appear in the Pools table.

b. Select a storage pool and click Grant Pool.

The Select the User to Grant the Storage Pool Access dialog box appears.

Note: You can only grant access to storage pools that correspond to a storage system where the user already has been granted access.


Note: The selection list does not include users who were granted access to a selected storage pool in the past.

d. Click Grant.

Figure 39 Grant user level or pool access

Grant access to block storage systems and pools

To grant access to block storage systems and pools:

1. From the Access Control > Block section of the Administrator Menu, click Grant.

2. In the left WBEM Server pane, select a server from the Select Server field.

3. Enter the server username and password and click Retrieve.

4. From the right List of Storage Systems Available for Granting Read-Write Access pane, select a storage system.

5. Click Grant Read/Write Access.

6. To grant access to users:

a. Click Grant to Users.

The Select the Users to Grant the Storage System Access Level dialog box appears.


Configuring access control 57



Note: The selection list also includes users who were granted access to a selected storage system in the past.

d. Click Grant. Access is granted to the selected user or users.

7. To grant access to storage pools:

a. Click Grant Pools.

The Select the Users to Grant the Storage System Pool Access Level dialog box appears.



Note: This selection list will not include users who were granted access to a selected storage pool in the past.

d. Click Grant. Access is granted to the selected user or users.

Figure 40 Grant user access to storage pools

Revoke access to file storage systems and pools

To revoke access to file storage systems and pools:

1. From the Access Control > File section of the Administrator Menu, click Revoke.

2. Select a storage system from the Select the Storage System from which the Access rights need to be revoked pane.



3. To revoke user access to file storage:

a. Click User Level.

The Select the Users to Revoke the Access Level dialog box appears.


c. Click the right arrow to move a user or users into the right pane.

Note: This selection list also includes users whose access to a selected storage system was revoked in the past.

d. Click Revoke. Access is revoked for the selected user or users.

Note: When you revoke user access to a storage system, this also revokes access to all storage pools that are related to that storage system.

4. To revoke user access to file storage pools:

a. Click Pool Level. File storage pools are retrieved and appear in the Pools table.

b. Select a storage pool and click Revoke Pool.

The Select the Pools to Revoke Access Level dialog box appears.



Figure 41 Revoke access to file storage systems and pools

Configuring access control 59


Revoke access to block storage systems and pools

To revoke access to block storage systems and pools:

1. From the Access Control > Block section of the Administrator Menu, click Revoke.

2. From the WBEM Server pane, select a server.

3. Click Retrieve.

4. Select a storage system from the Select the Storage System from which the Access rights need to be revoked pane.

5. To revoke user access:

a. Click Revoke From Users.

The Select the Users to Revoke the Access Level dialog box appears.




6. To revoke user access to storage pools:

a. Click Pool Level. File storage pools are retrieved and appear in the Pools table.

b. Select a storage pool and click Revoke Pools.

The Select the Pools to Revoke Access Level dialog box appears.



Figure 42 Revoke access to block storage systems and pools



Securing user dataEHAC safeguards sensitive information by requiring WBEM server passwords and control station passwords for Network Attached Storage (NAS) arrays. However, to further reduce the risk of attacks, do the following:

◆ Close your browser when the administration console is not in use to prevent access by unauthorized users.

◆ Lock the server if you leave it unattended. Secure the EHAC server in the same way as any other server with sensitive information.

◆ Set up a strong password when you log in to EHAC for the first time. This password must be used each time you log in to EHAC.

Securing user data 61



CHAPTER 9Troubleshooting


◆ Troubleshooting...................................................................................................... 64◆ Manually cleaning up VMAX storage after a failed clone, copy, or machine refresh... 65◆ Configure EMC SMI-S timeout values to prevent a cloning failure ............................. 70◆ Using logs to monitor the system ............................................................................ 71

Troubleshooting 63

Troubleshooting

TroubleshootingTable 4 provides troubleshooting information for SI for SAP NetWeaver LVM.

Table 4 Troubleshooting ESI for SAP NetWeaver LVM

Symptom Prevention, resolution, or workaround

EHAC Configuration Utility fails to start correctly or there are errors in the JBoss console.

• Ensure that EHAC is configured. “Deploying EHAC” on page 30 provides details.

• Ensure that the user has full read/write control to the JBoss directory.

• Ensure that the user has permission to create the database in the specified directory.

• Ensure that the user has permission to start and stop JBoss.

404 “not found” error appears when you try to access the EHAC URL.

• Ensure that the EHAC web service is configured. “Deploying EHAC” on page 30 provides details.

• Ensure that the JBoss is running.• Ensure that the JBoss port is not used by any other

service.

Unable to access EHAC from another server.

Ensure that both the outbound and inbound ports of JBoss are open in the firewall.

Unable to add a WBEM server. • Ensure that the WBEM server host name, port number, connection schema, and user credentials are all valid.

• Ensure that the WBEM server is accessible from EHAC.• Ensure that the WBEM server is running.

Note: EMC SMI_S Provider documentation provides more information.

Unable to remove a WBEM server.

• Ensure that the WBEM server is accessible from the EHAC web service.

• Ensure that the WBEM server is running.

Unable to add a storage system.

• Ensure that the storage system credentials are valid. • For file storage systems:

Ensure that the storage system is accessible from the EHAC server.

• For block storage systems:Ensure that the storage system is managed by a WBEM server.Ensure that the WBEM server is added to EHAC.Ensure that SP_A and SP_B information is valid.

Storage system is not available.

Check to see whether the storage system has been removed from the WBEM server.

Users are suddenly unable to access EHAC.

• Ensure that JBoss is still responsive. JBoss can become unresponsive during periods of inactivity.

• Restart JBoss.


Troubleshooting

Manually cleaning up VMAX storage after a failed clone, copy, or machine refresh

Use the following procedure to manually clean-up VMAX storage after a clone, copy, or refresh operation fails in the post-process clone volumes step when you select Full Clones.

Figure 43 Failed system clone in SAP Landscape Virtualization Management

To manually clean-up VMAX storage:

1. Create the cleanup_clone.sh script as follows:

ecc-db-tgt:/usr/scripts # cat cleanup_clone.sh/opt/emc/SYMCLI/bin/symclone -f pair -sid 6351 query/opt/emc/SYMCLI/bin/symclone -f pair -sid 6351 terminate -nop

Unable to create an admin user.

Ensure that latest derby.jar file was used in the deployment utility. Download the latest file if an older one was used in the deployment utility.

After creating an offline cloned target system, the system becomes isolated from outgoing network connectivity. Without connectivity, HBAs cannot be updated with the current ESXi HBAs from the online target virtual machine.

Before performing a SAP NW LVM System Clone process, review the isolation configuration for the SAP source system to maintain all of the communication from the source and target virtual machines with the ESXi servers. Also review the SAP NetWeaver LVM host configuration of the SAP source and target systems involved in the cloning process, to guarantee the HBAs and network can be accessed without limitations. If a target SAP system is isolated by SAP NetWeaver LVM, then it cannot access the ESXi server and will not be able to retrieve the configured HBAs and will fail in the unprepare and prepare processes.

Issue 443878: The system destroy failed due to storage hanging locks.

Verify with the storage administration team that the locks are cleared and restart the system.

Table 4 Troubleshooting ESI for SAP NetWeaver LVM

Symptom Prevention, resolution, or workaround

Manually cleaning up VMAX storage after a failed clone, copy, or machine refresh 65

Troubleshooting

/opt/emc/SYMCLI/bin/symclone -f pair -sid 6351 query

ecc-db-tgt:/usr/scripts # ll-rw-r--r-- 1 root root 168 Apr 8 16:18 cleanup_clone.sh

2. Run the EMC Symcli symclone command to identify the stage when the clone process failed:

ecc-db-tgt:/usr/scripts # /opt/emc/SYMCLI/bin/symclone listDevice's Symmetrix ID : 000192606351 Source Device Target Device State Copy------------------------------------------------------------ Protected Modified ModifiedLogical Sym Tracks Tracks Logical Sym Tracks CGDP SRC <=> TGT (%)------------------------------------------------------------N/A 0CB5 0 0 N/A 0D01 0 X... Copied 100N/A 0C9C 0 0 N/A 0D10 0 X... Copied 100N/A 0C9B 0 0 N/A 0D11 0 X... Copied 100Total -------- -------- -------- Track(s) 0 0 0 MB(s) 0.0 0.0 0.0Legend:(C): X = The background copy setting is active for this pair. V = The VP Snap setting is active for this pair. . = Neither setting is active for this pair.(G): X = The Target device is associated with this group. . = The Target device is not associated with this group.(D): X = The Clone session is a differential copy session. . = The Clone session is not a differential copy session.(P): X = The pre-copy operation has completed one cycle. . = The pre-copy operation has not completed one cycle.

3. Create a file named pair executing a Linux command to identify the VMAX devices that were involved in the failed post-clone volumes process:

ecc-db-tgt:/usr/scripts # /opt/emc/SYMCLI/bin/symclone list | grep 0C | awk '{print $1 " " $3}'0CB5 0D010C9C 0D100C9B 0D11ecc-db-tgt:/usr/scripts # /opt/emc/SYMCLI/bin/symclone list | grep Copied | awk '{print $1 " " $3}' >pairecc-db-tgt:/usr/scripts # cat pair0CB5 0D010C9C 0D100C9B 0D11

4. Change the authorizations of the cleanup_clone.sh shell script to allow it to be run:

ecc-db-tgt:/usr/scripts # ll-rw-r--r-- 1 root root 168 Apr 8 16:18 cleanup_clone.sh-rw-r--r-- 1 root root 30 Apr 8 16:15 pair

ecc-db-tgt:/usr/scripts # chmod 777 cleanup_clone.shecc-db-tgt:/usr/scripts # ll-rwxrwxrwx 1 root root 168 Apr 8 16:18 cleanup_clone.sh


Troubleshooting

-rw-r--r-- 1 root root 30 Apr 8 16:15 pair

5. Run the cleanup clone script to release the dependency between the source and target devices that was created in the clone process attempt:

ecc-db-tgt:/usr/scripts # ./cleanup_clone.shDevice file : pairDevice's Symmetrix ID : 000192606351 Source Device Target Device State Copy--------------------------------- ------------------------------- Protected Modified ModifiedLogical Sym Tracks Tracks Logical Sym Tracks CGDP SRC <=> TGT (%)--------------------------------- ---------------------------- ---N/A 0CB5 0 0 N/A 0D01 0 X... Copied 100N/A 0C9C 0 0 N/A 0D10 0 X... Copied 100N/A 0C9B 0 0 N/A 0D11 0 X... Copied 100

Total -------- -------- -------- Track(s) 0 0 0 MB(s) 0.0 0.0 0.0Legend:

(C): X = The background copy setting is active for this pair. V = The VP Snap setting is active for this pair. . = Neither setting is active for this pair.(G): X = The Target device is associated with this group. . = The Target device is not associated with this group.(D): X = The Clone session is a differential copy session. . = The Clone session is not a differential copy session.(P): X = The pre-copy operation has completed one cycle. . = The pre-copy operation has not completed one cycle.

'Terminate' operation execution is in progress for the device list indevice file 'pair'. Please wait...

'Terminate' operation successfully executed for the device listin device file 'pair'.

The Source device and the Target device do not form a Copy session

Device file 'pair' does not have any devices that are Clone source devices

6. Run the EMC Symcli symclone command again to verify whether any devices are still not detached from the source devices.

ecc-db-tgt:/usr/scripts # /opt/emc/SYMCLI/bin/symclone list

Symmetrix ID: 000192606351

No Copy sessions found

7. Open EMC Unisphere for VMAX, identify the target devices that were created, remove them from the masking view, and unbind them from the SAP_LVM pool.


Troubleshooting

Note: A storage administrator should perform this step.

Figure 44 Target devices in EMC Unisphere for VMAX

8. In SAP Landscape Virtualization Management, select Configuration > Systems.

9. Select Remove Instance and Systems > Remove Selected Instances and Systems, and then select the cloned system to be removed.

Figure 45 Select the cloned system to be removed

10. Select Operations > Hosts, and then select the target host virtual machine.


Troubleshooting

11. From the Details tab, click Cleanup of system provisioning changes.

Figure 46 Select the target host virtual machine and click Cleanup of system provisioning changes

12. Select Settings > Engine, and then click Advanced mode.

13. At lower right, in Timeout for All Operations Related To, change the setting in the AS Instances and Central Instance [min] field. You can type a minimum value of 0 to wait indefinitely, or type a maximum value of 120 for a 120 minute wait.

Figure 47 Configure timeout values to prevent a cloning failure

14. In the EHAC server, select Program Files > EMC > ECIM > ECOM > Providers, and then select the provider file.


Troubleshooting

15. At lower right, set the EMC SMI-S timeout value to 86400000 seconds (24 hours) to wait for the source and target devices to synchronize all contents. .

Figure 48 Configure EMC SMI-S timeout values to prevent a cloning failure


Troubleshooting

Using logs to monitor the systemESI uses logs to monitor the operation of the system. This enables system administrators and EMC support engineers to troubleshoot issues that users may encounter.

While configuring and deploying EHAC, you can also configure logging to monitor the operation of the system. Because no logs can be kept on the SAP NetWeaver LVM servers, both EHAC and the ESI NetWeaver LVM adapter store logs on the EHAC server using the same logging facility.

The following information is collected:

◆ Java Thread Dump Collector logs

◆ JBOSS and EHAC Web Service logs

◆ EMC SMI-S Provider logs

In case of error, review the logs in the log folder specified while configuring EHAC. If users encounter issues, the storage administrator can retrieve the logs from EHAC server to which the user may not have access.

Note: From the EHAC Configuration Utility, you can click Collect Logs to create a Zip file that contains logs that are generated by ESI. EMC support may request these logs to troubleshoot issues.“Configuring logging” on page 31 provides details.

Collect logs

To collect log files:

1. From the Administrator tab on the right side of the page, select Collect All Logs.

2. Open or save the ESI_LOGS.zip file.

Figure 49 Collect logs

Using logs to monitor the system 71

Documents

EMC Storage Integrator for SAP NetWeaver LVM: EHAC Administrator … · 2020-03-12 · 12 EMC Storage Integrator for SAP NetWeaver LVM: EMC High Level Storage Administration Console