Hitachi Storage Plug-in for VMware vCenter User's Guide ...• Hitachi VSP G1000 Open System Configuration Guide/Main Frame Configuration • Hitachi VSP G1000 Hitachi Device Manager

Hitachi Storage Plug-in for VMwarevCenter

User's GuideRelease 3.7.0

MK-92ADPTR047-12

© 2014-2017, Hitachi, Ltd. All rights reserved.

No part of this publication may be reproduced or transmitted in any form orby any means, electronic or mechanical, including copying and recording, orstored in a database or retrieval system for commercial purposes without theexpress written permission of Hitachi, Ltd., or Hitachi Data SystemsCorporation (collectively “Hitachi”). Licensee may make copies of theMaterials provided that any such copy is: (i) created as an essential step inutilization 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 theMaterials. “Materials” mean text, data, photographs, graphics, audio, videoand documents.

Hitachi reserves the right to make changes to this Material at any timewithout notice and assumes no responsibility for its use. The Materialscontain the most current information available at the time of publication.

Some of the features described in the Materials might not be currentlyavailable. Refer to the most recent product announcement for informationabout feature and product availability, or contact Hitachi Data SystemsCorporation at https://support.hds.com/en_us/contact-us.html.

Notice: Hitachi products and services can be ordered only under the termsand conditions of the applicable Hitachi agreements. The use of Hitachiproducts is governed by the terms of your agreements with Hitachi DataSystems Corporation.

By using this software, you agree that you are responsible for:1. Acquiring the relevant consents as may be required under local privacy

laws or otherwise from authorized employees and other individuals toaccess relevant data; and

2. Verifying that data continues to be held, retrieved, deleted, or otherwiseprocessed in accordance with relevant laws.

Notice on Export Controls. The technical data and technology inherent inthis Document may be subject to U.S. export control laws, including the U.S.Export Administration Act and its associated regulations, and may be subjectto export or import regulations in other countries. Reader agrees to complystrictly with all such regulations and acknowledges that Reader has theresponsibility to obtain licenses to export, re-export, or import the Documentand any Compliant Products.

Trademarks of Other Companies

Microsoft is a registered trademark or trademark of Microsoft Corp. in theUnited States and other countries.

Windows Server is a registered trademark or trademark of Microsoft Corp. inthe United States and other countries.

2Hitachi Storage Plug-in for VMware vCenter User's Guide

https://support.hds.com/en_us/contact-us.html

Windows is a registered trademark or trademark of Microsoft Corp. in the UnitedStates and other countries.

VMware vSphere is a registered trademark or trademark of VMware, Inc. in theUnited States and other countries.

VMware and ESXi are registered trademarks or trademarks of VMware, Inc. in theUnited States and other countries.

All other brand names and product names are registered trademarks or trademarksof the individual owners. In addition, ® and ™ are not marked in the text.



Contents

Preface................................................................................................. 9Audience............................................................................................................... 10Prerequisite Knowledge.......................................................................................... 10Product Version......................................................................................................10Referenced documents........................................................................................... 10Release notes........................................................................................................ 11Document conventions........................................................................................... 11Conventions for storage capacity values...................................................................12Accessing product documentation........................................................................... 13Getting help...........................................................................................................13Comments.............................................................................................................14

1 Overview.............................................................................................15Introduction...........................................................................................................16Key terms and concepts..........................................................................................17

2 System Requirements...........................................................................19System Configuration............................................................................................. 20Hardware requirements for the vSphere Web Client..................................................22Operating system prerequisites............................................................................... 23Software requirements........................................................................................... 23Storage system requirements..................................................................................25Restrictions and Considerations...............................................................................25Units of Capacity....................................................................................................27

3 Installation..........................................................................................29Installation prerequisites.........................................................................................30For Windows..........................................................................................................30

Installation for Windows....................................................................................30Uninstallation for Windows................................................................................ 31Uninstallation Procedure from the Control Panel..................................................31Update installation for Windows.........................................................................31


Repair installation for Windows..........................................................................32For vCenter Server Appliance Version.......................................................................33

Installation for vCenter Server Appliance version.................................................33Uninstallation for vCenter Server Appliance version............................................. 34Update installation for vCenter Server Appliance................................................. 34Repair Installation for vCenter Server Appliance version...................................... 35

Change the Maintenance Configuration file...............................................................35Log file size......................................................................................................36Number of log generations ............................................................................... 36

4 Operations.......................................................................................... 37Access to Hitachi Storage Plug-in.............................................................................38Add a Storage System............................................................................................ 38

Add VSP Gx00/Fx00 NAS module or HNAS as a File Storage System..................... 38Add HUS VM and VSP family Storage System......................................................39Summary tab................................................................................................... 39

Remove Storage System......................................................................................... 40Refresh Storage System information........................................................................ 40

Refreshing from the Home window.................................................................... 41Refresh from the Storage Systems List window................................................... 41

Create Host Group or iSCSI target (example)........................................................... 42

5 Provision Datastore..............................................................................45Overview of Provision Datastore..............................................................................46Create Detastore....................................................................................................46

Create VMFS Datastore..................................................................................... 46Create LU for Raw Device Mapping (RDM)..........................................................48Creating an NFS Datastore................................................................................ 50

Cancel creating Provision Datastore.........................................................................51Delete Datastore....................................................................................................52

Delete VMFS Datastore and LU.......................................................................... 53Delete Datastore with Multiple LUs.....................................................................54Delete NFS Datastore........................................................................................54

6 Information Display..............................................................................55Storage System List window....................................................................................56Storage Systems Detailed window and Property List................................................. 56Summary tab.........................................................................................................57Objects related to Storage System...........................................................................57Storage Devices List window...................................................................................57

Storage Systems Detailed window and Property List............................................ 58Objects Related to Devices................................................................................ 58

Host List Window................................................................................................... 59Hosts Detailed window......................................................................................59Objects Related to Hosts................................................................................... 59

Datastores List window for the datastores................................................................59Datastore Detailed window................................................................................59

Virtual Machines List window.................................................................................. 60Virtual Machines Detailed window...................................................................... 60


7 Troubleshooting...................................................................................61Troubleshooting during installation of the Hitachi Storage Plug-in.............................. 62Troubleshooting while using Hitachi Storage Plug-in..................................................62Errors occurred in Storage Systems......................................................................... 62Problems Occurring on the HDvM Server..................................................................63Problems Occurring in the vSphere environment.......................................................64Troubleshooting During the Execution of Provision Datastore Function....................... 65

Retry of Provision Datastore.............................................................................. 65Roll back of Provision Datastore.........................................................................65Action steps when the Provision Datastore task stops while executing ProvisionDatastore.........................................................................................................66

Troubleshooting while deleting Datastore.................................................................67Retry of Delete Datastore..................................................................................67Stops during the retrying NFS Export Creation.................................................... 67Stops during the Creation of NFS datastore........................................................ 67Action steps when the Delete Datastore task stops while running Delete Datastore.......................................................................................................................67

8 Log files.............................................................................................. 69HiAppServerModule.log...........................................................................................70Information Collected During Problem Occurrence.................................................... 70

Collect information from Windows application/system event logs..........................70Collect Windows system information.................................................................. 70Confirm vSphere Web Client version...................................................................71Collect subordinate files for vSphere Web Client/vCenter Server log......................71Collect log files from the Hitachi Storage Plug-in................................................. 71

Information Collected in VMware or vCenter management server (vCenter Server)..... 72Collect information from Windows application/system event logs..........................72Collect information from Windows system information.........................................72Confirm the vCenter Server version....................................................................72Collect Information in the ESXi.......................................................................... 72Collect Information in storage system.................................................................73

Information Collected in HDvM server......................................................................73Collect information from Windows application/system event logs..........................73Collect information from Windows system information.........................................73Collect maintenance information of the Device Manager...................................... 73

Log in the VMware managements for vCenter server appliance..................................73



PrefaceThis guide describes how to use the Hitachi Storage Plug-in for VMwarevCenter software (hereinafter referred to as the storage plug-in). The HitachiVirtual Storage Platform is shortened to VSP.This Hitachi Storage Plug-in forVMware vCenter User's guide applies to VSP, Hitachi Unified Storage VM,Hitachi VSP G1000, VSP G1500, VSP F1500, VSP Gx00, and Fx00 systems.

□ Audience

□ Prerequisite Knowledge

□ Product Version

□ Referenced documents

□ Release notes

□ Document conventions

□ Conventions for storage capacity values

□ Accessing product documentation

□ Getting help

□ Comments

Preface 9Hitachi Storage Plug-in for VMware vCenter User's Guide

AudienceThe document describes the following:

• Main functions.

• Environmental requirements of the system.

• Environmental configuration procedures.

This document provides only the information VM managers require to installand operate Hitachi Storage Plug-in Storage Plug-in. Therefore it does notinclude information on the vSphere environment and on how to set up thestorage system. Contact the vSphere environment administrator and storagesystem administrator for the information required to complete the systemconfiguration in advance.

Prerequisite Knowledge

This document is for users who are familiar with:

• The basic operations of the Microsoft Windows Server and MicrosoftWindows.

• The basic operation of the VMware vSphere Web Client.

This document uses screenshots or partial screenshots from Windowscomputers in some

illustrations.

Product VersionThis document revision applies to Hitachi Storage Plug-in VMware vCenterVersion 3.7.0

Referenced documentsThe following are the related documents:

• Hitachi Virtual Storage Platform Open System Configuration Guide

• Hitachi Virtual Storage Platform Open Storage Navigator User’s Guide

• Hitachi Unified Storage VM System Configuration Guide

10 PrefaceHitachi Storage Plug-in for VMware vCenter User's Guide

• Hitachi Unified Storage VM Storage Navigator User’s Guide

• Hitachi VSP G Series, F Series System Configuration Guide

• Hitachi VSP G Series, F Series System Hitachi Device Manager -Storage Navigator User’s Guide

• Hitachi VSP G1000 Open System Configuration Guide/Main FrameConfiguration

• Hitachi VSP G1000 Hitachi Device Manager - Storage Navigator User’sGuide

• Hitachi Command Suite User Guide

• Hitachi NAS Platform Guides

• Metro REST API Specification

VMware Document:• VMware vSphere ESXi and vCenter Server 5.5/6.0/6.5

Release notesRead the release notes before installing and using this product. They maycontain requirements or restrictions that are not fully described in thisdocument or updates or corrections to this document. Release notes areavailable on Hitachi Data Systems Support Connect: https://knowledge.hds.com/Documents.

Document conventionsThis document uses the following typographic conventions:

Convention Description

Bold • Indicates text in a window, including window titles, menus, menu options,buttons, fields, and labels. Example:Click OK.

• Indicates emphasized words in list items.

Italic • Indicates a document title or emphasized words in text.• Indicates a variable, which is a placeholder for actual text provided by the

user or for output by the system. Example:

pairdisplay -g group

(For exceptions to this convention for variables, see the entry for anglebrackets.)


https://knowledge.hds.com/Documents


Convention Description

Monospace Indicates text that is displayed on screen or entered by the user. Example:pairdisplay -g oradb

< > angle brackets Indicates variables in the following scenarios:• Variables are not clearly separated from the surrounding text or from

other variables. Example:

Status-<report-name><file-version>.csv

• Variables in headings.

[ ] square brackets Indicates optional values. Example: [ a | b ] indicates that you can choose a,b, or nothing.

{ } braces Indicates required or expected values. Example: { a | b } indicates that youmust choose either a or b.

| vertical bar Indicates that you have a choice between two or more options or arguments.Examples:

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

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

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

Icon Label Description

Note Calls attention to important or additional information.

Tip Provides helpful information, guidelines, or suggestions for performingtasks more effectively.

Caution Warns the user of adverse conditions and/or consequences (forexample, disruptive operations, data loss, or a system crash).

WARNING Warns the user of a hazardous situation which, if not avoided, couldresult in death or serious injury.

Conventions for storage capacity valuesPhysical storage capacity values (for example, disk drive capacity) arecalculated based on the following values:

Physical capacity unit Value

1 kilobyte (KB) 1,000 (10 3) bytes

1 megabyte (MB) 1,000 KB or 1,0002 bytes

1 gigabyte (GB) 1,000 MB or 1,0003 bytes

1 terabyte (TB) 1,000 GB or 1,0004 bytes


Physical capacity unit Value

1 petabyte (PB) 1,000 TB or 1,0005 bytes

1 exabyte (EB) 1,000 PB or 1,0006 bytes

Logical capacity values (for example, logical device capacity, cache memorycapacity) are calculated based on the following values:

Logical capacity unit Value

1 block 512 bytes

1 cylinder Mainframe: 870 KB

Open-systems:• OPEN-V: 960 KB• Others: 720 KB

1 KB 1,024 (210) bytes

1 MB 1,024 KB or 1,0242 bytes

1 GB 1,024 MB or 1,0243 bytes

1 TB 1,024 GB or 1,0244 bytes

1 PB 1,024 TB or 1,0245 bytes

1 EB 1,024 PB or 1,0246 bytes

Accessing product documentationProduct user documentation is available on Hitachi Data Systems SupportConnect: https://knowledge.hds.com/Documents. Check this site for themost current documentation, including important updates that may havebeen made after the release of the product.

Getting helpHitachi Data Systems Support Connect is the destination for technical supportof products and solutions sold by Hitachi Data Systems. To contact technicalsupport, log on to Hitachi Data Systems Support Connect for contactinformation: https://support.hds.com/en_us/contact-us.html.

Hitachi Data Systems Community is a global online community for HDScustomers, partners, independent software vendors, employees, andprospects. It is the destination to get answers, discover insights, and makeconnections. Join the conversation today! Go to community.hds.com,register, and complete your profile.



https://knowledge.hds.com/

https://support.hds.com/en_us/contact-us.html

https://community.hds.com/welcome

https://community.hds.com/welcome

CommentsPlease send us your comments on this document to [email protected] the document title and number, including the revision level (forexample, -07), and refer to specific sections and paragraphs wheneverpossible. All comments become the property of Hitachi Data SystemsCorporation.

Thank you!


mailto:[email protected]

1Overview

This chapter provides an overview of Hitachi Storage Plug-in for VMwarevCenter User's Guide.

□ Introduction

□ Key terms and concepts

Overview 15Hitachi Storage Plug-in for VMware vCenter User's Guide

IntroductionThe Hitachi Storage Plug-in operates as a plug-in for the vSphere Web Clientand displays the configuration information of the Hitachi storage systems(VSP, HUS VM, VSP G1000, VSP G1500 , VSP F1500, VSP Gx00, or VSP Fx00)attached to the vSphere environment. There are two versions: vCenterServer (Windows version) and vCenter Server Appliance (vCenter ServerAppliance version).

• View Function

• Provision Datastore Function

• Delete Datastore Function

View function

The View function displays the storage system information registered in thestorage plug-in, the datastore on the ESXi host using the storage system,and virtual machine information.

The View function displays the following:

• The ESXi Host connected to the storage system and an LU available to theESXi Host.

• The storage system used with the datastore and virtual machines.

Creating a Datastore

The Provision Datastore function creates an LU that can be used as adatastore for a virtual machine file system (VMFS), a network file system(NFS) , or for Raw Device Mapping (RDM) by using a storage system thathas been registered in the storage plug-in.

Deleting a Datastore or LU

The Delete Datastore function is a one-step operation that removesdatastores or LUs from storage systems registered with the storage plug-in.It does not remove datastores or LUs that were created without using thestorage plug-in.

The Delete Datastore function is available in the following windows.

• Storage Devices list window (Delete Datastore icon)• Storage Devices list window (Actions menu)• Datastores list window (Actions menu)

16 OverviewHitachi Storage Plug-in for VMware vCenter User's Guide

Key terms and conceptsThis topic describes key terms and VMware environment objects relevant tothe Hitachi Storage Plug-in.

The term vSphere is a collective name for the VMware-based virtualenvironment, which includes the VMware vSphere software, VMware vCenterServer software, VMware ESXi clusters and hosts managed by the vCenterServer, and the virtual machines (VMs) and vApps hosted on those ESXiclusters.

For details about these concepts, see the Hitachi Command Suite User Guide and the VMware documentation at

https://www.vmware.com/support/pubs/

The following table describes key terms and objects.

Term Description

Datastore Virtual area used to store a virtual machine image on ESXi. The actual area is

created on a local disk or external storage system.

HDP Hitachi Dynamic Provisioning. An optional function of the storage system to

reduce complicated design. Large volume of virtual capacity eliminates reliance

on device capacity.

HDvM Hitachi Device Manager. One of the software included in Hitachi Command

Suite, consolidating multiple Hitachi manufactured software managements.

Hitachi Command

Suite

Storage management software suite, supporting storage resource operation in

Enterprise environments.

HNAS Hitachi NAS Platform. One of the Enterprise-level network storage servers that

provides high-quality editing through CIFS, NFS, iSCSI, and FTP.

Host Group Host Group associates a LUN(Logical Unit Number) with a HBA. Part of the LUN

Manager function.

Metro A software to manage storage systems including HNAS through HTTP protocol

by REST client.

RDM Abbreviation for Raw Device Mapping. vSphere function that directly maps an

LUN on the storage to the virtual machine.

Overview 17Hitachi Storage Plug-in for VMware vCenter User's Guide


18 OverviewHitachi Storage Plug-in for VMware vCenter User's Guide

2System Requirements

This chapter provides information about the necessary system requirements.

□ System Configuration

□ Hardware requirements for the vSphere Web Client

□ Operating system prerequisites

□ Software requirements

□ Storage system requirements

□ Restrictions and Considerations

□ Units of Capacity

System Requirements 19Hitachi Storage Plug-in for VMware vCenter User's Guide

System ConfigurationHitachi Storage Plug-in requires the following system configuration:

• Communication among VMware Management Client , vSphere Web ClientServer , VMware Management Server(vCenter Server ) , ESXi, and thestorage system must be carried out through a LAN (Ethernet).

• ESXi and the storage system (VSP Gx00) must be connected through aFibre Channel cable or Ethernet (iSCSI) cable. In addition, ESXi and thestorage system (VSP family, HUS VM, VSP G1500, VSP F1500, VSP G1000)must be connected through a Fibre Channel cable.

• User accounts must have administrator role privileges to use vSphere WebClient.

• The storage system must be a dual controller.• Use IPv4(IPv6 is not supported).• Installation requires 110MB or more of free space.• HDvM is required for HUS VM and VSP family storage systems.• Metro server is required for creating NFS datastores with HNAS 4000

Series with the storage plug-in.

The next image is an example of a system configuration for the Storage plug-in for Windows version. This type of configuration is required for the NASoption for VSP Gx00 and VSP Fx00.

20 System RequirementsHitachi Storage Plug-in for VMware vCenter User's Guide

System configuration for Windows


System configuration for vCenter Server Appliance

Hardware requirements for the vSphere Web ClientThe following table lists the supported models and storage systemrequirements.

Item Condition Remarks

CPU 2.00 GHz or faster processorwith four cores or more

Recommended for vSphere WebClient Server

Memory 4 GB or more RAM

(Use 8 GB or more for vCenterServer 6.0/6.5)


HDD free space Varies depending on the needsof the maintenance setup file(the log file size and thenumber of log generations canbe modified).

• 0.82 GB or more if the log filesize is set to the default value(10 MB) and the number of log

110 MB or more required forinstallation


Item Condition Remarks

generations is also set to thedefault value (19 generations)when installed

• 75 GB or more if the log filesize is set to the maximum(100 MB) and the number of loggenerations of the backup file isalso set to the maximum (255generations)

Formula for calculating therequired disk size:

Required disk size [GB]

= (specified log file size [MB]) x(number of log generations +1) x3(HiAppServerModule.log) +110 [MB]) ÷ 1024

LAN Above 1 Gbps connection isrecommended


Operating system prerequisitesOperating system for Windows vSphere Web Client Server• Microsoft Windows Server 2008 R2 Standard/Enterprise/Datacenter Edition

SP1• Microsoft Windows Server 2012 Standard/Datacenter Edition• Microsoft Windows Server 2012 R2 Standard/Datacenter Edition

The following VMware Management Client operating systems are supported:• Microsoft Windows 7 Home Premium/Professional/Ultimate/Enterprise SPI• Microsoft Windows 8 Core/Pro/Enterprise• Microsoft Windows 8.1 Core/Pro/Enterprise• Microsoft Windows 10• Microsoft Windows Server 2008 R2 Standard/Enterprise/Datacenter Edition

SP1• Microsoft Windows Server 2012 Standard/Datacenter Edition• Microsoft Windows Server 2012 R2 Standard/Datacenter Edition• Mac OS X

Software requirementsThis section describes the software required to install Hitachi Storage Plug-in.

If the vSphere Web Client is not installed before the storage plug-in isinstalled, the storage plug-in will fail to install.


Software Requirements

One of the following is required: If you do not install thevSphere Web Client before the Storage Plug-in installation,the installation of the Storage Plug-in might fail.

• VMware vSphere Web Client 5.5 (Update 3)• VMware vCenter Server 6.0 (The vSphere Web Client is

included in VMware vCenter Server 6.0)• VMware vCenter Server 6.5(The vSphere Web Client is

included in VMware vCenter Server 6.5.)

For vSphere Web Client

One of the following is required:

Windows version

• VMware vCenter Server 5.5 (Update 3)• VMware vCenter Server 6.0 (Update 3)• VMware vCenter Server 6.5

vCenter Server Appliance version

• VMware vCenter Server Appliance 5.5 (Update 3)• VMware vCenter Server Appliance 6.0 (Update 3)• VMware vCenter Server Appliance 6.5

For vSphere Web Client

One of the following is required:

• VMware ESXi 5.5 (Update 3)• VMware ESXi 6.0 (Update 2)• VMware ESXi 6.5

For ESXi

Hitachi Device Manager (Part of Hitachi Command Suite) Required for managing HUS VM andVSP family storage systems with theStorage Plug-in.

Compatible versions:• VSP: 7.0 or later HUS VM: 7.3.1 or

later• VSP G1000: 8.0.0 or later VSP

G1500: 8.5.0 or later VSP F1500:8.5.0 or later VSP Gx00 models:8.1.4 or later VSP Fx00 models:8.4.0 or later

Metro Server Version 3.0.0 or later Required for managing NFS Datastorewith the HNAS and Hitachi StoragePlug-in.

Microsoft Internet Explorer

Mozilla Firefox

Google Chrome

Installed in VMware Managementclient. The supported version of thesesoftwares complies with the vSphereWeb Client supported version.

NFS Required for Metro Server


Storage system requirementsItem Description

Supported systems • VSP• HNAS 4000• HUS VM• VSP G1000• VSP G1500• VSP F1500• VSP Gx00 models• VSP Fx00 models

Firmware revision VSP 70-03-01 or later

HUS VM 73-03-01 or later

VSP G1500

VSP F1500

80-05 or later 80-01 or later

VSP G1000

VSP Gx00 models 83-01 or later

VSP Fx00 models 83-02 or later

Interface/Hostport

VSP Fibre Channel

HUS VM

VSP G1000

VSP G1500

VSP F1500

Fibre Channel, iSCSI, FCoE

VSP Gx00 models

VSP Fx00 models

Fibre Channel, iSCSI (1 Gbps, 10 Gbps), NFS

Controller Dual controller is required

Restrictions and ConsiderationsThe following restrictions apply when using the Storage Plug-in for VMwarevCenter.

Account Authentication

The administrator account must have privileges to install and use the storageplug-in (login account in Windows).

Communication Port for the HDvM server

By default, the storage plug-in uses TCP port number 2001 to communicatewith the HDvM server. Confirm that TCP port number 2001 is not being usedby other software. If the port number is currently being used by othersoftware, change the port number in the HDvM setting using the Add Storage


System function. After installing the storage plug-in, the port number to beused must be enabled so as to communicate with the HDvM server.

Confirming when installing

Confirm that any monitoring and virus monitoring services (such as daemonprocesses) are not activated. If such monitoring services are active,installation may fail.

Installation Folder

The installation folder of the storage plug-in differs according to the versionof vSphere Web Client.• vSphere Web Client 5.5

<Installation folder of vSphere Web Client>\plugin-packages\HitachiStoragePlugin

• vSphere Web Client 6.0<Installation folder of vCenter Server>\vCenter Server\WebClient\plugin-packages\HitachiStoragePlugin

• vSphere Web Client 6.5C:\ProgramData\VMware\vCenterServer\runtime\vsphere-client\plugin-packages\HitachiStoragePlugin

• vCenter Server Appliance 6.0 and 6.5/usr/lib/vmware-vsphere-client/plugin-packages/HitachiStoragePluginFirst confirm that sufficient free space to install the storage plug-in isavailable on the drive where vSphere Web Client is installed.

RAID Level

RAID0/1+0/1/5/6 are supported. VSP Gx00 and VSP Fx00 support RAID1,RAID5, and RAID6; however, do not use RAID0 in the storage systembecause it does not have data redundancy.

Restrictions of the host group name or iSCSI target name

Host group names or iSCSI target names may not include brackets ([]).

Resource group

The Storage Plug-in does not support resource group management. If youuse the Storage Plug-in, please verify the following:• HDvM users registered with the Storage Plug-in can view all resource

groups. If users’ view of resource groups is limited, the Storage Plug-in willnot operate correctly.

• The Storage Plug-in does not support LUs designated as resource groupsnor does it support Datastore creation.


SSL Communication with the HDvM server

SSL communication with the HDvM server is not supported.

Update installation, repair installation, and uninstallation of Storage Plug-in

Stop the vSphere Web Client application before updating, repairing, oruninstalling the storage plug-in.

Upgrading vSphere Web Client

Uninstall the Storage Plug-in before upgrading the vSphere Web Client. Thenreinstall or update installation of the Storage Plug-in. The previouslyregistered information will not remain in the upgrade.

Units of CapacityThis section describes the definitions of capacity units and the formatdisplayed in Hitachi Storage Plug-in

Table 1 Definitions of Capacity Units and the Format

Capacity Display

Less than 1024 MB The capacity unit is shown as MB. The capacity value is displayed

with up to second decimal place. For example, 10.00 MB, 200.10

MB, and 1023.99 MB.

More than or Equal to 1024

MB and less than 1024 GB

The capacity unit is shown as GB. The capacity value is displayed

with up to second decimal place. For example, 2.00 GB, 200.10 GB,

and 1023.99 GB.

More than or Equal to 1024

GB

The capacity unit is displayed as TB. The capacity value is displayed

with up to second decimal place. For example, 2.00 TB, 200.10 TB,

and 222.99 TB.



3Installation

This chapter includes the installation prerequisites and installationinformation.

□ Installation prerequisites

□ For Windows

□ For vCenter Server Appliance Version

□ Change the Maintenance Configuration file

Installation 29Hitachi Storage Plug-in for VMware vCenter User's Guide

Installation prerequisites• The vSphere environment is configured.• The storage system satisfies the requirements.• Metro Server is required to use HNAS (Gateway model).

Configuring the vSphere Environment

You have to configure vSphere environment before using Hitachi StoragePlug-in. For information about the configuration procedure for the vSphereenvironment, visit the following VMware Inc. website and view the relevantdocuments:


Confirming the Storage System Requirements

Confirm the storage system requirements. If the relevant storage systemrequirements are not met, you must ensure that they are met beforeproceeding to the installation procedure.

Metro Server is required to use HNAS for Hitachi Storage Plug-in.

For WindowsThis chapter includes installation, uninstallation, update, repair installation forWindows.

Installation for WindowsThis section describes the installation procedure for the Storage Plug-in.

Procedure

1. Run installer file: Hitachi-StoragePlugin-setup(03.7.0)-01.exe

Double-click the installer setup icon.2. Click Next.3. After you confirm the license, select I accept the terms of the license

agreement and click Next to go to the installation location.4. Click Next in the setup window to start the installation process. The

installation process is running.5. A message appears to inform you about the completion of Hitachi

Storage Plug-in installation. Click Finish to complete. The installationprocedure is complete.

6. Restart the VMware vSphere Web Client(vSphere 5.5/6.0) or VMwareservice Lifecycle Manager(vSphere 6.5)

30 InstallationHitachi Storage Plug-in for VMware vCenter User's Guide


Uninstallation for WindowsThe section describes the uninstallation procedure using the Storage Plug-inInstaller.

Procedure

1. Stop the VMware vSphere Web Client service(vSphere 5.5/6.0) orVMware Service Lifecycle Manager(vSphere 6.5)

2. Run the installer file by double-clicking the installer setup icon: Hitachi-StoragePlugin-setup(03.7.0)-01.exe

3. After you select Remove in the displayed setup wizard, click Next.4. A confirmation popup window for uninstallation appears. Click Yes and

go to next step.5. The Uninstall Complete message informs you when Hitachi Storage

Plug-in is uninstalled. Click Finish to complete.6. Confirm that Hitachi Storage Plug-in for VMware vCenter is removed

from the Programs and Features window. Manually remove the folderand files as required. The uninstallation procedure is complete.

7. Start the VMware vSphere Web Client service(vSphere 5.5/6.0) orVMware Service Lifecycle Manager(vSphere 6.5) if necessary.

Uninstallation Procedure from the Control PanelThis procedure describes procedure to uninstall from the Control Panel.

Procedure

1. Stop the VMware vSphere Web Client service(vSphere 5.5/6.0) orVMware Service Lifecycle Manager(vSphere 6.5)

2. Select Hitachi Storage Plug-in for VMware vCenter from Programs andFeatures in Control Panel, and then click Uninstall.

3. Click Yes in the confirmation window.4. Click Finish to complete.5. Manually remove the folder and files as required.6. Start the vSphere Web Client service(vSphere 5.5/6.0) or VMware

Service Lifecycle Manager(vSphere 6.5)

Update installation for WindowsIf you upgrade the vSphere Web Client from a previous version to a laterversion, the currently installed plugin will no longer function. You must eitherupgrade or reinstall the storage plugin.

Procedure

1. Stop the VMware v Sphere Web Client service(vSphere 5.5/6.0) orVMware Service Lifecycle Manager(vSphere 6.5)


2. Run installer file: Hitachi-StoragePlugin-setup03.7.0-01.exe.

Double-click the installer setup icon.3. Click Next in the displayed setup wizard.4. After you confirm the license, select I accept the terms of the license

agreement and click Next to go to the installation location.5. Click Next to start the installation.6. If vSphere Web Client is running, Stop the vSphere Web Client, then click

Next.7. Click Finish to complete. The Update installation procedure is complete.8. Restart the VMware v Sphere Web Client service (vSphere 5.5/6.0)

or VMware Service Lifecycle Manager(vSphere 6.5) after youcomplete the update installation of the Storage Plug-in.

Repair installation for WindowsIf you delete a file from the installation destination folder by mistake, you canrestore it by repair installation.

The following repair installations are available:• Repair installation using the Hitachi Storage Plug-in Installer.• Repair installation from the Control Panel.

When repair installation is executed, registered storage system informationmay be removed. In this case, register a storage system again using the Adda Storage System on page 38

Procedure

1. Stop the VMware v Sphere Web Client service(vSphere 5.5/6.0) orVMware Service Lifecycle Manager(vSphere 6.5).

2. Run installer file: Hitachi-StoragePlugin-setup(03.7.0)-01.exe

Double-click the installer setup icon.3. After you select Repair in the setup wizard, click Next.4. If the vSphere Web Client service is running, a dialog box appears to

show that the service is running. Click Next after you stop the vSphereWeb Client service.

Note: The dialog box to display that the service is running doesnot appear if the service has already stopped.

5. The repair installation complete message informs you the completion ofthe Storage Plug-in repair. Click Finish to complete. The repairprocedure is complete.


6. Start the the VMware v Sphere Web Client service(vSphere 5.5/6.0)or VMware Service Lifecycle Manager(vSphere 6.5) after youcomplete the repair installation of the Storage Plug-in.

For vCenter Server Appliance VersionThis chapter includes Installation, uninstallation, update, and repairinstallation for vCenter Server Appliance Version.

Installation for vCenter Server Appliance versionThis section describes the installation procedure for the Storage Plug-in(vCenterServer Application version). The Storage Plug-in will renew if youhave an older version. The installation process remains the same.

Installation prerequisites• Log in with root user credentials.• A major version of the vSphere Web Client that supports the storage plug-

in is installed.• Free disk space of 110MB or more

Procedure

1. Log in with root user credentials.2. Run installer file: # ./Hitachi-StoragePlugin-setup03.7.0-01.bin3. Press Enter in the welcome screen.

Note: The warnings may be displayed if there is insufficient freespace on the install destination drive. Installation requires 100MBor more of free space. Confirm there is sufficient free space, thenreinstall the product.

4. Press Enter to scroll the license agreement. Read the agreement. EnterY (yes).

5. The default installation path is a fixed path as displayed. Press Enter tocomplete the installation.

6. Press Enter to complete the installation.7. Restart the vSphere Web Client service.

Note:• SDK 6.0 will be installed.• For details on SSH/Bash shell connection to vCenter Server

Appliance, file forwarding, or restarting VMware Web Client, seeVMware documentation available at: https://www.vmware.com/support/pubs/




• For updates to older build versions, uninstall the older buildbefore installation.

• Verify configuration files.

Uninstallation for vCenter Server Appliance versionUninstallation procedure using Storage Plug-in is followed. For details onSSH/Bash shell connection to vCenter Server Appliance, file forwarding, orrestarting VMware vSphere Web Client service, see the VMwaredocumentation.

Procedure

1. Stop the VMware vSphere Web Client Service.2. Log in as a user with root user credentials . Change the current directory

to the plugins directory under the installation folder, then run the uninstaller. # ./Uninstall.sh

3. Choose No.1 - Yes. Enter 1, and then press Enter. The productuninstalls.

4. Start the VMware vSphere Web Client service.

Update installation for vCenter Server Appliance

Before you begin

Before you begin, make sure supported version of vSphere Web Client isinstalled and grater than 110MB space is available.

Procedure

1. Login as a user with root user credentials.2. Run installer file:# ./Hitachi-StoragePlugin-setup03.7.0-01.bin3. Press Enter in the Welcome screen. To quit installation, input quit.4. Installation path is displayed. Press Enter.5. The default installation path is a fixed path as displayed. Install

to: /usr/lib/vmware-vsphere-client/plugin-packages/HitachiStoragePluginInput back to go back, quit to stop installation.

6. Installation completion message will display. Press Enter to complete theinstallation.

7. Restart the VMware vSphere Web Client Service.

Note: For details on SSH/Bash shell connection to vCenter ServerAppliance, file forwarding, or restarting the VMware vSphere


Web Client service, see VMware documentation available at: https://www.vmware.com/support/pubs/

Repair Installation for vCenter Server Appliance versionIf you have mistakenly deleted a file from the install folder, you can restorethe file by repairing the installation. If you run the repair install, registeredstorage device information may be deleted. If deleted, use Add StorageSystem to re-register the storage system information.

Before you begin: check prerequisites using InstallAnyware before repairinstallation. Verify that the prerequisites have been met in case of failure,and then try the installation procedure. Use InstallAnywhere’s custom codefor message details.

Procedure

1. Log in as with root user credentials.2. Stop the VMware vSphere Web Client service.3. Run # ./RepairInstall.sh

Note: For details on SSH/Bash shell connection to vCenter ServerAppliance, file forwarding, or restarting the VMware vSphere WebClient service, see VMware documentation available at: https://www.vmware.com/support/pubs/.

4. The Manage Instances screen appears. Press Enter in the ManageInstances screen.

5. Select option 1, press Enter.The Repairing Screen showing the progress appears.

Note: If you have not logged in with root credentials, you may getthe error message on your screen: Verify the prerequisites havebeen met, then retry the installation procedure. Once theinstallation has been repaired, the Install Anywhere ConsoleComplete screen appears.

6. Press Enter to exit the installer. This ends the repair installationprocedure.

7. After completing the Hitachi Storage Plug-in repair installation, restartthe VMware vSphere Web Client service.

Change the Maintenance Configuration fileWhen you install the Hitachi Storage Plug-in, a maintenance configuration file(hilogger.config) is created in Hitachi Storage Plug-in installation folder.





The maintenance configuration file can set the log output formats generatedby Hitachi Storage Plug-in. Descriptions of the maintenance configuration fileare listed below. Edit the file with a text editor using alphanumeric. End eachline with a line feed.

Log file sizeYou can specify the log file size. [MaxFileSize=<size>]

• You can specify the size of an output log file in megabytes depending onthe <size> value. Specify between 1 and 100.

• Specify <size> in single-byte decimal numbers.• Put [MaxFileSize=<size>] in one-byte brackets.• Insert a line feed after [MaxFileSize=<size>].• If this value is omitted or non-allowed values (outside the maximum and

minimum values or other than one-byte values) are used, the defaultvalue of 10 MB is used.

Number of log generations[MaxBackupIndex=< number-of- generations>]

When a log file exceeds the size specified in the log file size, rotate andspecify the number of generations of the backup file to be created.• You can specify the number of backup file generations with the value in

<number-of- generations>. Specify between 1 and 255.• Specify <number-of- generations> in single-byte decimal numbers.• Put [MaxBackupIndex=<number-of- generations>] in one-byte brackets.• Insert a line feed after [MaxBackupIndex=<number-of- generations>].• If this value is omitted or non-allowed values (outside the maximum and

minimum values or other than one-byte values) are used, the defaultvalue of 5 generations is used.[Default value: 19]

Notation Examples for a Maintenance Configuration File


4Operations

This chapter includes how to operate a Storage System.

□ Access to Hitachi Storage Plug-in

□ Add a Storage System

□ Remove Storage System

□ Refresh Storage System information

□ Create Host Group or iSCSI target (example)

Operations 37Hitachi Storage Plug-in for VMware vCenter User's Guide

Access to Hitachi Storage Plug-inWhen the storage plug-in is installed, the Storage Plug-in icon is added tovSphere Web Client window. Follow the procedure to access the StoragePlug-in.

The following steps describes procedures to use the functions provided by thePlug-in:

Procedure

1. Log in to the vSphere Web Client from the browser.2. After you install Hitachi Storage Plug-in, the Storage Plug-in icon is

added to the Home window of the vSphere Web Client.3. Click the Storage Plug-in icon.

Add a Storage SystemThe Add Storage System function is used to register storage systems to bemonitored by the storage plug-in.

Add VSP Gx00/Fx00 NAS module or HNAS as a File Storage SystemThe Add Storage System function is used to register storage systems to bemonitored by the storage plug-in.

Follow the procedure to add a VSP Gx00/Fx00 NAS module or HNAS as a FileStorage System.

Procedure

1. Click Storage Systems in the Hitachi Storage Plug-in navigator.2. Click the Add Storage System icon.3. On the Model screen, select VSP Gx00 Fx00 NAS module or HNAS.4. Click Next.5. On the Management Server Information screen, enter the IP address

and port number for the Metro server or for one of the storagecontrollers.

6. Click Next.7. On the Admin EVS screen, enter the IP address, user ID, and password

for the EVS server. If you entered the IP address of one of the storagecontrollers on the Management Server Information screen, enterthat same IP address here.

8. Click Next.9. On the Summary screen, verify the setting. Use the Back button to

modify any of the settings.10. Click Finish.

38 OperationsHitachi Storage Plug-in for VMware vCenter User's Guide

11. Refresh the storage system information in the Storage Systems window.

Add HUS VM and VSP family Storage SystemThe Add Storage System function is used to register storage systems to bemonitored by the storage plug-in.

Follow the procedure to add HUS VM and VSP family Storage System.

Procedure

1. Click Hitachi Storage Plug-in in the Hitachi Storage Plug-in navigator.2. Click the Add Storage System icon in the Storage Systems List window.

Add Storage System will display.3. On the Model screen, select a storage system model option; click Next.4. On the Information screen, enter the followings:

• IP address for the HDvM server that includes the target storagesystem.

• Port number• User ID and password. For the user ID and password for the HDvM

server, contact your storage system administrator.5. Click Next.6. Obtain the IP address while you are on the Discovery screen.7. Login to the HDvM server.

• If login succeeds, storage systems that are registered in HDvM aredisplayed.

• If login fails (for example, a communication error occurs, the requiredstorage systems are not displayed, or the user ID or password isincorrect), troubleshoot the issue or contact your storage systemmanager to verify your user account settings are correct.

8. Select a storage system to be registered from the list. Only one storagesystem can be registered at a time. Click Next.

9. On the Summary screen, confirm the model, information for theselected storage system.

10. Click Finish.11. Run Refresh Storage System function after you register the storage

systems.Remove registered virtual storage if you encounter a problem. Then Re-register a virtual storage with Add Storage function when the virtualstorage is not displayed.

Summary tabIn Summary, the detailed information of the storage selected in theStorage Devices list window is output.

To display the summary, click Summary tab in the Storage Devicesdetailed window.


Remove Storage SystemThe Remove Storage System function is used to remove storage systemsthat have previously been registered by the storage plug-in using the AddStorage System function.

Run Remove Storage System by either of the two methods listed below.• Using the icon in the Storage Systems List window.• From the Actions list in the Storage Systems List window.

Note: Even if you remove the storage system using Remove StorageSystem function, the datastore or LU created using Hitachi Storage Plug-in isnot deleted. If you require the deletion of datastore or LU, use the DeleteDatastore function.

Follow the procedure to remove the Storage System.

Procedure

1. Click the Storage Systems tab in the Hitachi Storage Plug-in navigator.2. Select the storage system to remove from the Storage Systems list.3. Click the Remove Storage System icon.4. Click Yes in the confirmation window.

Note: If you select multiple storage systems, a message dialogbox appears when you remove these arrays.

5. After Removing Storage System, run Refresh Storage Systemfunction.

Refresh Storage System informationThe Refresh Storage System function updates the information on a storagesystem. It is always recommended to run Refresh Storage System afteradding or removing a storage system, or provisioning or deleting a datastore.

You can run Refresh Storage System function using the following methods:

Run Refresh Storage System in any of the following ways:• Run from the pop-up message displayed when the Home window appears.• Using the Refresh icon in the Storage Systems List window.• From the Actions in the Storage Systems List window.

You must perform Refresh Storage System function after you run AddStorage System, Remove Storage System, Provision Datastore, andDelete Datastore functions.


The following sections displays operation procedures as an example of theRefresh Storage System function from Storage Systems List window.

Refreshing from the Home windowRefreshing from the Home window refreshes the information for all registeredstorage systems. To refresh information for a single storage system, runRefresh from the Storage Systems List window.

Follow this procedure to run the Refresh operation from the Home window.

Procedure

1. Go the Home window of the Hitachi Storage Plug-in.2. Click Yes to refresh. A confirmation dialog box may appears, click Yes.

Note: All the registered storage information refreshes. If you wantto refresh individual storage information, execute from theStorage Systems List window.

3. When the refresh information process starts, Recent Tasks panedisplays this task.The Refresh Storage System function completes when Refresh Storagetask shown on Recent Tasks pane finishes.

4. To display the information of the storage system, click the Refresh icon.

Refresh from the Storage Systems List windowRefreshing from the Storage Systems List window refreshes theinformation for the storage systems selected in the Storage Systems list. Torefresh information for all registered storage systems, run Refresh from theHome window.

Follow this procedure to run the Refresh operation from the StorageSystems List window.

Procedure

1. Click the Storage Systems in the Hitachi Storage Plug-in navigator.2. Click the Refresh Storage Systems icon on the Object tab.3. Click Yes in the confirmation window to start the refresh process. If a

second confirmation message appears, click OK.4. When the refresh information process begins, the progress of the refresh

is displayed in the Recent Tasks pane. If it is not displayed, click theRefresh icon in the vSphere Web Client title bar.

5. After the refresh processes finishes, click Refresh icon to display atheupdated storage system information in the window.


Note: If any of the following settings for the target storage systemhave been changed before the above operations are run, an erroris displayed, and the target storage system is removed from thewindow.• Changed the password used for Add Storage System function.• Removed the account used for Add Storage System function.• The Account Authentication function is changed from Disabled

to Enabled.• The View authority of the target storage system is removed

from the account used for Add Storage System function.• To display the correct information, register the storage system

again using Add Storage System.

Create Host Group or iSCSI target (example)Create the host group or iSCSI target in which WWN for HBA of ESXi isregistered prior to the above operations. If those have not been created, thehost group or iSCSI target is not displayed in the host group or iSCSI targetselection window shown in the Provision Datastore Wizard. An example of thehost group used to assign the LU is shown.

• Execute the Refresh Storage System function to retrieve the latest storagesystem and vSphere environment information before executing theProvision Datastore. If Refresh Storage System has not been executed, theinformation that has been set in the storage system and vSphereenvironment may not be displayed.

• The capacity of the datastore varies depending on the ESXi version andthe storage system.


• Block size is dependent on the VMFS of the datastore.



5Provision Datastore

This function creates LU which can be used as a VMFS datastore or RDM byusing the storage system which is registered in the Storage Plug-in.

□ Overview of Provision Datastore

□ Create Detastore

□ Cancel creating Provision Datastore

□ Delete Datastore

Provision Datastore 45Hitachi Storage Plug-in for VMware vCenter User's Guide

Overview of Provision DatastoreOverview image of a datastore created by Provision Datastore

The Provision Datastore function is available in the following windows.

• Storage Devices list window (Provision Datastore icon)• Datastores list window (Provision Datastore icon)• Datastores list window (Actions menu)

Create Detastore

Create VMFS DatastoreBefore you begin - make sure the following:• Storage adapter to be connected to the storage system (HBA’s ESXi)• Storage system for creating the LU used in the VMFS datastore.• RAID group or DP pool that creates the LU used in the VMFS datastore.• Capacity of VMFS datastore (2GB minimum, maximum can vary by ESXi

type).• Host group or iSCSI target of the storage system in which the WWN or

iSCSI name of the storage adapter (HBA’s ESXi Host) has been set.• VMFS datastore name in using between 3-42 alphanumeric and special

characters.• Block size of the virtual disk (virtual machine image) created in the VMFS

datastore.

46 Provision DatastoreHitachi Storage Plug-in for VMware vCenter User's Guide

Procedure

1. Click Storage Devices in the Run installer file: Hitachi-StoragePlugin-setup(03.7.0)-01.exe Double-click the installer setup

icon. navigator.2. Click Refresh Storage System to update the window with the latest

storage system and vSphere environment information.3. Click the Provision Datastore icon to start the Provision Datastore

wizard.4. On the Type screen, select VMFS Datastore, and click Next.5. On the VMFS Version screen, select the VMFS version.

a. If you select VMFS3, specify the block size: 1MB, 2MB, 4MB or 8MB.b. When creating a datastore, use a version prior to ESXi 6.5.c. Click Next and move to the next step.

6. On the Name and Capacity screen, determine how many datastoresyou want to create (single or multiple).To create a single datastore:a. Select Single Datastore Creation.b. Enter a name for the datastore.

The datastore name is between 3 and 42 characters. You can input thefollowing characters: alphanumeric, space, ! # ( ) + - , . = @ _

c. Enter a value for the datastore capacity (2-65535GB).Display the total capacity of datastore in the Total tab.

d. Click Next.To create multiple datastores:a. Select Multiple Datastore Creation.b. Enter a name for the datastore.

Datastore name is between 3 and 42 characters. You can input thefollowing characters: alphanumeric, space, ! # ( ) + - , . = @ _Display the datastore name to create in the Datastore Name tab.

c. Input the number of the datastores to create in Number ofDatastores. Between 1 and 256. datastores.

d. Set the starting number of datastores to create. Input the startingnumber of datastores to create in Starting Number tab.Input the starting number to be create between 0 and 999.

e. Enter a capacity value for each datastore (2-65535GB) in DatastoreCapacity.Display the total capacity of datastore in the Total tab.

f. Click Next.7. On the Storage Adapter screen, select the storage adapter for the

datastores.a. From the tree view of Select Cluster or Host, click Cluster name or

ESXi host to which virtual machine which creates the datastorebelongs.

b. Select the storage adapter which creates the datastore.


c. Click Next and go to the next step.8. On the Storage Configuration screen, configure the storage system for

the datastore(s).a. Selecting Storage system

Select a storage system for creating datastores.b. Selecting Storage Pool/RAID Group

Select a pool for creating datastores.c. Selecting Host Group/Target Select Host group

Note: [1] Display the total capacity of datastore to be createdis in the Total Used Capacity tab. [2] In case of the virtualstorage, select the physical storage which creates datastore.This is displayed in the following format in Storage Systemtab: <Virtual storage system name>(<Physical storage systemname>).

d. Click Next and go to the next step.9. On the Summary screen, confirm the settings for the datastore(s). Click

a screen name to modify any settings, if necessary.10. Displays all items defined so far. Click Finish to start creating the

datastore. The datastore creation progress and results can be viewed inthe Recent Tasks pane of the vSphere Web Client.Once the datastore(s) is created, it will appear in the Storage Deviceslist. Click Refresh Storage System to update the storage systeminformation.Procedure1. View the content in the Summary.2. You can return to a previous page and correct items by clicking each

link.3. After you confirm that all configurations are correct, click Finish to

start datastore creation.4. Displays the execution results of Provision Datastore in the vSphere

Web Client task. Displays the Provision Datastore task in RecentTasks pane when you click Refresh icon of vSphere Web Client.

5. Click the Cancel button(icon of white cross in a dark circle) to cancelthe task execution.

Note: When you cancel Provision Datastore, rollback cannot beused and LUs created on the storage system remain. LUs must bedeleted using the Delete Datastore function. Contact yourstorage system administrator for additional assistance.

Create LU for Raw Device Mapping (RDM)Before you begin - make sure the following:


• Storage adapter to be connected to the storage system (HBA’s ESXi)• Storage system that creates LU used in the VMFS datastore.• RAID group or DP pool that creates LU used in the VMFS datastore.• Capacity of VMFS datastore (Lower limit of capacity is 2 GB. Upper limit of

capacity varies depending on the type of ESXi.)• Host group or iSCSI target of the storage system in which the WWN or

iSCSI name of the storage adapter (HBA’s ESXi Host) has been set.

Procedure

1. Click Storage Devices in the Storage Plug-in navigator.2. Click Refresh Storage System to update the window with the latest


wizard.4. On the Type screen, select LUN for Raw Device Mapping, and click

Next.5. On the Capacity screen, determine how many LUNs you want to create

(single or multiple).To create a single LUN:a. Choose Single LUN Creation.b. Enter a value for the LUN capacity (2-65535GB).c. Click Next.To create multiple LUNs:a. Select Multiple LUN Creation.b. Enter the number of LUs you want to create. You can create up to 256

LUs.c. Enter a capacity value for each LU (2-65535GB). The total capacity for

the multiple LUs is displayed.d. Click Next to go to the next step.

6. On the Storage Adapter screen, select the storage adapter for thedatastores.a. Select the cluster or ESXi host of the virtual machine where the LU(s)

will be created.

Note: If you launched the Provision Datastore wizard from theDatastores list window, you do not need to select a cluster orESXi host.

b. Select the storage adapter that is to create the LU(s).c. Click Next.

7. On the Storage Configuration screen, configure the storage system forthe LU(s).a. Choose a storage system. Choose the physical storage that creates

the LU(s) for creating a virtual datastore,. The virtual storage systemname is displayed first, then the physical storage name.


b. Choose the storage pool/RAID group that creates the LUs.c. Select the hostgroup/target.d. Click Next.

8. On the Summary screen, confirm the settings for the LU(s). Click ascreen name to modify any settings, if necessary.

9. Click Finish to create the LU(s). The LU creation progress and resultscan be viewed in the Recent Tasks pane of the vSphere Web Client.

Once the LU(s) is created, it will appear in the Storage Devices list.Click Refresh Storage System to update the storage systeminformation.

If you cancel the LU creation process, you will not be able to use therollback function. Any LUs that were actually created before you canceledthe process will remain on the storage system. They must be deletedusing the Delete Datastore function. Contact your storage systemadministrator for additional assistance.

Creating an NFS Datastore

Note:• If a file system is not created on the HNAS storage system prior to

datastore creation, the file system will not be displayed at the time ofselection in the Provision Datastore procedure.

• When you create an NFS datastore using the Provision Datastore function,input the necessary information and create the datastore by using theselected NFS export. The Metro Server Information page is accessible onlyat the time of NFS datastore creation. Apply Metro Server information tothe Metro Server Information page.

• Only the storage manager can view a LDEV-labeled creation.

Before you begin - make sure the following:• NFS export that connects to the storage system• NAS storage system for NFS datastore• File system and/or folder for NFS datastore• ESXi for datastore creation• NFS datastore name• File system created and available on the HNAS storage system

Procedure

1. Click Storage Devices in the Storage Plug-in navigator.2. Click Refresh Storage System to update the window with the latest


wizard.4. On the Type screen, select NFS Datastore; click Next.


5. Select Storage System from the dropdown menu in the StorageInformation. Click Next.

6. Select File System for the datastore creation.A list of available and exportable file systems for NFS3 appears uponsuccessful login to the Metro Server. Only file systems from Admin EVS-targeted user accounts are displayed in the list. If all file systems are notdisplayed, ask your storage system administrator to verify your useraccount settings.

7. On the NFS Export Configuration screen, select either NFS export orCreate New Export.For NFS Export:a. Select NFS Export, then click Next.For Create New Export:a. Select Create New Export.b. Enter the NFS Export Name.c. Enter the Directory Path to the ESXi host.d. Enter the IP address of the host.e. Select the Snapshot option.f. Select the Local Read Cache option.g. Select the Transfer to Replication Target option.h. Click Next.

8. On the Datastore Configuration screen, enter a name for thedatastore.a. Enter the export folder. The export path will be displayed .b. If you do not want to edit the datastore, check the Mount NFS as

Read Only option.c. Click Next.

9. On the Host Configuration screen, select the host for NFS datastore.Click Next.

10. On the Summary screen, confirm the settings. Click a screen name togo back and modify settings.

11. Click Finish to create the datastore. The datastore creation progress andresults can be viewed in the Recent Tasks pane of the vSphere WebClient.Once the datastore is created, it will appear in the Storage Devices list.Click Refresh Storage System to update the storage systeminformation.

If you cancel the Provision Datastore process, the NFS export remains inHNAS. To delete an NFS export, contact your storage systemadministrator for assistance.

Cancel creating Provision DatastoreDuring the creation of Provision Datastore, you can cancel the task execution.


When you cancel Provision Datastore, rollback cannot be used and LUscreated on the storage system remain. Delete LU accordingly.

Procedure

1. Confirm a message displayed in the canceled task.2. Run the Refresh Storage System function and update the information.3. Delete the LU using the Delete Datastore function.4. Ask storage administrator for deletion of Storage LUN output in the

message.5. Run the Refresh Storage System function again and update the

information.

Delete DatastoreThe Delete Datastore deletes a datastore or LU that uses the registeredstorage system in the Hitachi Storage Plug-in.

The Delete Datastore function is available in the following windows.• Using the icon in the Storage Devices list window.• From Actions list in the Storage Devices list window.• From Actions list in the Datastores list window.

Note: Unable to recover deleted datastores or LUs. Be careful not to removedatastores or LUs by mistake.

Note: Run Refresh Storage System to retrieve the latest storage system andvSphere environment information before performing the Delete Datastorefunction. If the Refresh Storage System function is not performed, thefollowing events may occur.• The datastore or LU to be deleted is not displayed.• The deletion may lead to an error after the Delete Datastore function

starts.

Note: In the example below, use vSphere Web Client to delete datastoresand LUs instead of using the Delete Datastore function. If you are unable touse vSphere Web Client to perform the deletion, contact your storageadministrator for assistance. Provide the storage name and LUN to bedeleted.• Datastores or LUs not created from the Hitachi Storage Plug-in• VVol Datastore• PE• Datastores having a virtual machine or virtual machine template• Datastores with multiple LUs• Datastores with pair-configured LUs• LUs used in RDM


• LUs used in a datastore

Procedure to verify LUs used in the datastore.

Check an LU which is used in the datastore by following the given steps:1. From the Home window of vSphere Web Client, click vCenter.2. Click the Datastore category in the inventory list.3. Click the datastore you want to delete in the Datastore panel in the

center.4. Select the Management tab and click the Setting tab.5. From the tree view of the Setting window on the left, select Device

backing.6. Confirm the name of LU which is used in the Extent column.

Delete VMFS Datastore and LUOperation Procedure• Using the icon in the Storage Devices list window.• From Actions list in the Storage Devices list window.• From Actions list in the Datastores list window.

Note: When you run the Delete Datastore function from the Actions list,select Delete Datastore in All Hitachi Storage Plug-in Actions.

Procedure

1. Click Storage Devices tab in the Hitachi Storage Plug-in navigator.2. Select the datastore to be removed from the Storage Devices List

window. You can find the datastore name under the Datastore. Youcannot remove multiple datastores at one time.

3. Click the Delete Datastore icon.4. A confirmation dialog box for the removal of datastore appears. Click Yes

to remove the storage Device registration.5. The results of the Delete Datastore function appear in the vSphere Web

Client task. When you click Refresh icon of vSphere Web Client, RecentTasks pane displays the Delete Datastore task.

6. You can cancel the task execution by clicking the Cancel button of thetask.

Note: When you cancel Delete Datastore, the LUN that is notdeleted remains. Delete unnecessary LUN.

7. Once the datastore(s) have been deleted, click Refresh StorageSystem in the Storage Devices list to update the storage system.


Delete Datastore with Multiple LUsUse vSphere Web Client to delete a datastore with multiple LUs instead ofusing the Delete Datastore function.

Run the following procedure to delete a datastore with multiple LUs and theLU used in the datastore:

Procedure

1. Check an LU which is used in the datastore by following the given steps:a. From the Home window of vSphere Web Client, click vCenter.b. Click the Datastore category in the inventory list.c. Click the datastore that you want to delete in the Datastore panel.d. Select the Management tab, then click the Settings tab.e. From the tree view of the Settings window, select Device Backing.f. Confirm the name of the LU that is used in the Extent column.

2. Delete a datastore using the function of vSphere Web Client.3. Run the Refresh Storage System function and retrieve the latest

information.4. Delete an LU which accords with the name confirmed by an identifier in

step 1 by using the Delete Datastore function.

Delete NFS Datastore

Procedure

1. Click Storage Devices tab in the Storage Plug-in navigator.2. Select the NFS Datastore you want to delete.3. Click Actions menu, select All Hitachi Storage Plug-in Actions >

Delete Datastore.4. In the pop up message, click Yes. You can cancel the deletion by clicking

X icon next to the progress bar of the deletion.5. The result of deleting the Datastore is displayed in the vSphere Web

Client task window.6. Refresh the storage system information.


6Information Display

This chapter includes storage system list window, devices list window, hostlist window, datastore list window, and virtual machines list window.

□ Storage System List window

□ Storage Systems Detailed window and Property List

□ Summary tab

□ Objects related to Storage System

□ Storage Devices List window

□ Host List Window

□ Datastores List window for the datastores

□ Virtual Machines List window

Information Display 55Hitachi Storage Plug-in for VMware vCenter User's Guide

Storage System List windowStorage Systems list displays information for the storage systems registeredin the Hitachi Storage Plug-in. Also, if the storage system displayed in theStorage Systems list window is selected, storage summary information canbe seen as the detailed information of the storage system, and the storagedevice list, host list, datastore list, and virtual machine list can be seen as therelated objects pertinent to the storage systems.

To display the Storage Systems list window, click Storage Systems in theHitachi Storage Plug-in navigator.

Storage Systems Detailed window and Property ListStorage Devices Detailed window displays the detailed information ofstorage devices of the storage system registered in the Hitachi Storage Plug-in. if you click the Related Objects tab, storage device list, host list,datastore list, and virtual machine list can be seen as the objects related tothe storage systems.

To display the Storage Devices detailed window, click Storage Devices inthe Storage Devices list window or the navigator window.

Summary

In Summary, the detailed information of the storage that you select in theStorage Devices list window is output. To display the summary, clickSummary tab in the Storage Devices detailed window.

Table 2 Property List of Storages Devices (Summary)

PropertyName

Description

Device Displays the device ID (UUID) of LU.

Type • Displays the LU type used as the Datastore.• VMFS3 – Datastore for VMFS3• VMFS5 – Datastore for VMFS5• VMFS6 - Datastore for VMFS6• RDM – Virtual Drive (Raw Device Mapping mode)• Extent – Extent has been set• N/A – Not used• VVol(Config) – Metadata• VVol(Data) – VMDK Files• VVol(Memory) – Snapshots or Suspend• VVol(Swap) – Swap Files• VVol(Other) – Vendor solution specific• VVol – Virtual Volume• PE – Protocol Endpoint

56 Information DisplayHitachi Storage Plug-in for VMware vCenter User's Guide

Portlets are Java-based user-interface components that enable requests to generatedynamic content.

Summary tabIn Summary, the detailed information of the storage selected in theStorage Devices list window is output.

To display the summary, click Summary tab in the Storage Devicesdetailed window.

Objects related to Storage SystemTheRelated Objects tab displays information for the selected storagesystems in the Storage Systems List window .

The display includes storage devices registered in the HBA storage plug-inand in the VVol Datastore with the ESX/ESXi host. This Storage Device listrelated to Storage System will not be displayed in for HNAS storage systems.

The Related Objects tab displays the following information for the storagedevices selected in the Storage Device list window.1. Hosts List related to Storage System

Display the Hosts list related to Storage system.In the Storage Systems Detailed window, click Hosts in the RelatedObjects tab.

2. Datastores List related to Storage SystemDisplay the datastore list related to the storage system.In the Storage Systems Detailed window, click Datastores in theRelated Objects tab.

3. Virtual Machine List Related to Storage SystemDisplay the Virtual Machine list related to Storage Devices.In the Storage Systems Detailed window, click Virtual Machines underthe Related Objects tab.

Storage Devices List windowStorage Devices list window displays the storage devices list which uses thestorage system that you register in the Hitachi Storage Plug-in. Also, if youselect the storage device displayed in the list window, you can see storagesummary details as the information of the storage device.

To display the Storage Devices list window, click Storage Devices in theHitachi Storage Plug-in navigator.


Storage Systems Detailed window and Property ListStorage Devices Detailed window displays the detailed information ofstorage devices of the storage system registered in the Hitachi Storage Plug-in. if you click the Related Objects tab, storage device list, host list,datastore list, and virtual machine list can be seen as the objects related tothe storage systems.

To display the Storage Devices detailed window, click Storage Devices inthe Storage Devices list window or the navigator window.

Summary

In Summary, the detailed information of the storage that you select in theStorage Devices list window is output. To display the summary, clickSummary tab in the Storage Devices detailed window.

Table 3 Property List of Storages Devices (Summary)

PropertyName

Description

Device Displays the device ID (UUID) of LU.

Type • Displays the LU type used as the Datastore.• VMFS3 – Datastore for VMFS3• VMFS5 – Datastore for VMFS5• VMFS6 - Datastore for VMFS6• RDM – Virtual Drive (Raw Device Mapping mode)• Extent – Extent has been set• N/A – Not used• VVol(Config) – Metadata• VVol(Data) – VMDK Files• VVol(Memory) – Snapshots or Suspend• VVol(Swap) – Swap Files• VVol(Other) – Vendor solution specific• VVol – Virtual Volume• PE – Protocol Endpoint

Portlets are Java-based user-interface components that enable requests to generatedynamic content.

Objects Related to DevicesTheRelated Objects tab displays the following information for the storagedevices selected in the Storage Device list window .

1. Host list related to Storage Device

Display the host list related to the storage system. In the Storage DevicesDetailed window, click Hosts in the Related Objects tab.

2. Datastores List related to Storage system

Display the datastores list related to the storage system. In the StorageDevices Detailed window, click Hosts under the Related Objects tab.


3. Virtual Machine List related to Storage Device

Display the virtual machine list related to the storage system. In the StorageDevices Detailed window, click Virtual Machines in the Related Objectstab.

Host List WindowHosts list window displays the ESXi hosts list which uses the storage systemregistered in Hitachi Storage Plug-in. Also, if the hosts displayed in the listwindow are selected, the Hitachi Storage Plug-in detailed information isdisplayed on the hosts detailed window.

To display the host list window, click Hosts in the Hitachi Storage Plug-innavigator.

Hosts Detailed windowHosts Detailed window displays the storage devices created in the hosts byusing storage systems registered in the Hitachi Storage Plug-in.

To display detailed information for the hosts, click Hosts in the Hosts listwindow or navigator.

To display summary information, click the Summary tab in the HostsDetailed window.

Objects Related to HostsDisplays the detailed information of the Hitachi Storage Plug-in StorageDevices in the Related Objects tab.

Datastores List window for the datastoresDatastores list window displays the datastore list which uses the storagesystem registered in the Hitachi Storage Plug-in. Also, if the datastoresdisplayed in the list window are selected, the Hitachi Storage Plug-in detailedinformation is displayed in the summary of the datastore detailed window.

To display the datastores list window, click Datastores in the Hitachi StoragePlug-in navigator.

Datastore Detailed windowThe Datastores Detailed window displays detailed information of thedatastore created by the storage system that was registered in the HitachiStorage Plug-in.

To display detailed information for a datastore, click Datastores in theDatastores list window or in the navigator.


To display summary information, click the Summary tab in theDatastoresDetailed window.

Virtual Machines List windowVirtual Machines List window displays the virtual machines list which uses thedatastores registered in the Hitachi Storage Plug-in.

If you select the virtual machines displayed in the list window, the Summarytab of the Virtual Machines detailed window displays detailed informationabout the Hitachi Storage Plug-in.

To display the Virtual Machines List window, click Virtual Machines in thestorage plug-in navigator.

Virtual Machines Detailed windowVirtual Machines Detailed window displays the information of a virtualmachines. The storage systems registered in the Hitachi Storage Plug-increates this virtual machine.

To display the details about Virtual Machines, click Virtual Machines in thevirtual machines list window or navigator window.

To display summary information, click the Summary tab in theHitachiStorage Information.


7Troubleshooting

This chapter includes troubleshooting information.

□ Troubleshooting during installation of the Hitachi Storage Plug-in

□ Troubleshooting while using Hitachi Storage Plug-in

□ Errors occurred in Storage Systems

□ Problems Occurring on the HDvM Server

□ Problems Occurring in the vSphere environment

□ Troubleshooting During the Execution of Provision Datastore Function

□ Troubleshooting while deleting Datastore

Troubleshooting 61Hitachi Storage Plug-in for VMware vCenter User's Guide

Troubleshooting during installation of the Hitachi StoragePlug-in

If problems occur when you use the installer of the storage plug-in, an errormessage is displayed. Follow the error message for further directions.

If you could not identify the problem, verify the following:• All requirements are met.• Compare settings against restrictions and considerations.• View the Log Files chapter and Collecting information topics.

If none of above solve the problem, contact your technical support.

Troubleshooting while using Hitachi Storage Plug-inIf problems occur while using the Hitachi Storage Plug-in, error information isdisplayed and output to a log file. Follow the error message for furtherdirections.

If you could not identify the problem, verify the following:• All requirements are met.• Review the operating environment and Errors Occurring in Storage

Systems topic.

If none of above solve the problem, contact your technical support.

Errors occurred in Storage SystemsIf any problem or error occurs when use the Hitachi Storage Plug-in, an errormight have occurred in the storage system environment. Reconfirm thefollowing:

Checking the storage system environment:

Confirm that the storage system has started up without a problem.

Also, confirm whether the storage system requirements are fulfilled even ifthe storage system configuration have changed, and then confirm that thestorage system environment does not conflict with the restrictions andlimitations.

Confirming the connections of LAN cable:

Confirm that a LAN cable is connected to the storage system controller (forboth systems) and that the two of them are linked up.

Confirming the IP address:

62 TroubleshootingHitachi Storage Plug-in for VMware vCenter User's Guide

Confirm that the IP address is same as the IP address displayed in thestorage system.

Confirming the TCP port number:

Confirm that the TCP port number used for communication with the storagesystem has not been changed.

If the TCP port number has been changed, add df-damp-snm <storagesystem port number>/tcp to the Services file in VMware management client.

Confirming the Firewall settings:

Confirm that communication with the storage system has not been blocked.If communication has been blocked, set the firewall to allow communicationwith the storage system.

Confirming the connection with ESXi:

Verify the following. If a problem is found, run recovery (restart the ESXiserver).1. Whether any problem has occurred in the Fibre Channel port used for the

host group or the iSCSI port used for the iSCSI target.2. Whether the WWN of the storage adapter (HBA of ESXi) registered in the

host group or the iSCSI name of the storage adapter (HBA of ESXi)registered in the iSCSI target are enabled.

Problems Occurring on the HDvM ServerIf a problem occurs while you are using the storage plug-in, a failure mayhave occurred on the HDvM server. Confirm the following:

Confirmation items of the HDvM server environment:

Confirm that the HDvM server has started without problems. Also, check thatthe service of the HDvM does not stop.

Confirming the connections of LAN cable:

Confirm that the LAN cable is connected to NIC of the HDvM server and twoof them are linked up.

Confirming of the IP address:

Confirm that the IP address used for the HDvM server does not change.

Confirming the TCP port number:

Verify that the TCP port number used for the HDvM server is correct. Registerthe new number if the TCP port number is different.

Confirming the Firewall settings:

Confirm that communication with theHDvM server is correct.


If there is a communication block, set the Firewall to allow communicationwith the HDvM server.

Management resource of the HDvM

(1) Register the storage system used for the management resource for theHDvM server.

(2) Unlocked the resource of the storage system.

(3) Verify you can retrieve and configure the storage system informationusing HDvM.

(4) VerifyHDvM and the storage system information is consistent.

Confirming the HDvM user account

(1) Verify the valid user account.

(2) Enable the existing user account.

(3) Use correct password.

(4) Confirm to have view and modify privileges to your account and re-execute.

Problems Occurring in the vSphere environmentIf a problem occurs while you use the Hitachi Storage Plug-in, a failure mighthave occurred in the vSphere environment. Confirm the following and takeappropriate action.

Confirming the event:

Check the Event in vSphere Web Client and confirm whether an error occurs.If an error occurs, either take the appropriate action to address the error orask the administrator of the vSphere environment to resolve the error.

Checking vCenter Server:

Confirm the vCenter Server

Checking ESXi:

From vSphere Web Client, confirm the ESXi start and connects to vCenterServer.

Check the connection between ESXi and the storage system:

Verify whether the storage adapter (HBA of ESXi) operates without a problemand is connected to the storage system.

Confirming the operating status of each machine:


Verify the following for vSphere Web Client, vCenter Server, and ESXi,respectively. If any problem occurs, run recovery.

(1) Whether the machine is activated.

(2) Whether a lack of memory capacity, CPU high-load, and accessconcentration does not occur.

(3) Whether TCP and IP communications between machines are enabled.

(4) If you change the user password, enter the correct password and re-execute.

In addition, restart vSphere Web Client under the following situations:

(1) When vSphere Web Client runs continuously for a long time.

(2) When network communication problem occurrs between vSphere WebClient and vCenter Server while using the Hitachi Storage Plug-in.

Troubleshooting During the Execution of ProvisionDatastore Function

This section describes troubleshooting operations during the execution ofProvision Datastore function.

Retry of Provision DatastoreWhen Provision Datastore is running, you cannot fid the created LUimmediately which might lead to a failure of Provision Datastore. Either re-execute from the point where retry of Provision Datastore fails or get back tothe state prior to the execution of Provision Datastore by rollback asnecessary. After you create the datastore with the Provision Datastorefunction, execute Refresh Storage System. Also you can confirm thecreated datastore in Storage Devices List Window.

Perform the following procedure for Retry:

Procedure

1. Observe the failure message shown in the Recent Tasks pane.2. Click the Provision Datastore icon.3. Click Yes on the warning message.4. Start to retry the Provision Datastore function.5. When Provision Datastore task on the Recent Tasks pane completes,

retry of Provision Datastore becomes successful.6. Refresh the storage system information.

Roll back of Provision DatastorePerform Datastore Rollback procedure


Procedure

1. Verify the failure message shown in Recent Tasks pane when ProvisionDatastore fails.

2. Click the Provision Datastore icon.3. Click No on the warning message to roll back.4. Click Yes on the warning message to continue rollback of Provision

Datastore.5. Click Refresh icon on vSphere Web Client to display the rollback

progress status on the Recent tasks pane.

Note: You cannot update Recent Tasks pane automatically. Toupdate Recent Tasks pane, click Refresh icon on vSphere WebClient.

6. You can update Recent Tasks pane and displays the rollback progressstatus of Provision Datastore.

7. Displays a message to indicate the completion of rollback operation inthe Recent Tasks pane.

Action steps when the Provision Datastore task stops whileexecuting Provision Datastore

If you have not yet run the Retry or Rollback commands, the task will remainin-process and the created LUs remain on the server. Verify the tasks andaction steps in the following:

Stops during the creating LUs on storage system:1. Display the event of the task.2. Delete the Storage LUN output when error message display.3. Run the Refresh Storage System function, and retrieve the latest

information.

Stops during the mapping to the host group of the created LU orCreation of LU and mapping are completed, and detection of LUN isbeing executed by ESX:1. Display the event of the task.2. Perform mapping cancellation of Storage LUN output if any error

messages appear.3. Perform deletion of Storage LUN output if any error messages appear.4. Run the Refresh Storage System function, and retrieve the latest

information.

Stops during the creation of datastores using the detected LUN:1. Run the Refresh Storage System function, and retrieve the latest

information.2. Delete LU using the Delete Datastore function.


3. Re-execute the Refresh, retrieve the latest information.

Troubleshooting while deleting DatastoreThis section describes retry of delete datastore, problems during retrying NFSexport creation, during the creation of NFS datastore, and actions steps whenthe Delete Datastore task stops while running delete datastore.

Retry of Delete DatastoreThis procedure describes the Retry procedure to follow when the DeleteDatastore function fails.

Procedure

1. Observe the failure message shown in the Recent Tasks pane.2. Click Delete Datastore icon when the failure message appear in the

Recent Tasks pane.3. Click Yes on the warning message.4. When the Delete Datastore task on the Recent Tasks pane completes,

retry of Delete Datastore is successful.5. Run the Refresh Storage System operation after deletion of datastore

with Delete Datastore function.

Stops during the retrying NFS Export Creation

Procedure

1. Display task event.2. Report the error message to your storage manager for further support.3. Refresh the storage system information.

Stops during the Creation of NFS datastore

Procedure

1. Refresh the storage system information.2. Report the error message to your storage manager for further support.3. Try refreshing the storage system information again.

Action steps when the Delete Datastore task stops while runningDelete Datastore

Unable to execute Delete Datastore again and created LUs on the storagesystem remain when vSphere Web Client service stops while executing theDelete Datastore task.

During the confirmation of LUN usage status and deletion ofdatastore in the vSphere environment:


1. Run the Refresh Storage System function, retrieve the latestinformation.

2. Confirm whether the datastore for deletion remains in Datastores Listwindow. If it remains, re-execute the Delete Datastore function.

3. Delete the storage LUN that were addressed before Delete Datastorebegan.

4. Run the Refresh Storage System function, retrieve the latestinformation.

During the unmapping or deletion of LU.1. Verify the deletion of storage LUN that were addressed before Delete

Datastore began.2. Run the Refresh Storage System function and retrieve the latest

information.


8Log files

The Hitachi Storage Plug-in outputs error messages to several log files. Thelog files output are different depending on the function. Therefore, confirmthe information in the log file corresponding to the problem that occurs withthe function.

□ HiAppServerModule.log

□ Information Collected During Problem Occurrence

□ Information Collected in VMware or vCenter management server (vCenterServer)

□ Information Collected in HDvM server

□ Log in the VMware managements for vCenter server appliance

Log files 69Hitachi Storage Plug-in for VMware vCenter User's Guide

HiAppServerModule.logThe service processing log data from the Hitachi Storage Plug-in is output tothis log file.

An output example of a log file error message is shown below. Search thatthe log type is ERROR(1), and then confirm the content of the message(2)with the Error Message List.

Information Collected During Problem OccurrenceWhen you cannot solve a problem by troubleshooting, provide the followingto the customer service for this software.

Collect information from Windows application/system event logs

Procedure

1. Open Event viewer2. From the console tree, right click on the log to be saved and click Save

All event As...3. Input the archive log fine name in the File name box.4. Click the appropriate file format in the File type box, and then click

Save.

Collect Windows system informationCollect information using the following steps:

Procedure

1. Open System information.2. Click Export from the Filemenu.3. Click Export As to select the save location for the file.4. Input the file name in the File name field.5. Click Save.

70 Log filesHitachi Storage Plug-in for VMware vCenter User's Guide

Confirm vSphere Web Client versionConfirm the vSphere Web Client version using following the steps:

Procedure

1. From the Menu in vSphere Web Client, select Help -> About VMwarevSphere.

2. Confirm the vSphere Web Client version displayed in the dialog box.

Collect subordinate files for vSphere Web Client/vCenter Server logCollect all subordinate files using the Explorer function. After zipping each logfile, the logs folder is created. Files are located:

For v5.5

C:\ProgramData\VMware\vSphereWebClient\serviceability\logs

For v6.0/6.5

C:\ProgramData\VMware\vCenterServer\logs\vsphere-client\logs

Collect log files from the Hitachi Storage Plug-inLog files are large files. When you collect log files, compress log folders.Collect the log files using Explorer by the following steps.

1. Intermediate file: Following files under the installation folder of thestorage plug-in.• multiaccount.xml• modelname.config

The Hitachi Storage Plug-in version:1. Collect the files shown using Internet Explorer.

– version.txt2. Confirm the vSphere Web Client version by following the steps below:

a. From the Menu in vSphere Web Client, select Help -> AboutVMware vSphere

b. Confirm the vSphere Web Client version displayed in the dialog box

Note: Log files are located in the following log folder of the Hitachi StoragePlug-in.• vSphere Web Client 5.5 <Installation folder of vSphere Web Client>

\plugin-packages\HitachiStoragePlugin• vSphere Web Client 6.0<Installation folder of vCenter Server>

\vCenterServer\WebClient\plugin-packages\HitachiStoragePlugin• vSphere Web Client 6.5


C:\ProgramData\VMware\vCenterServer\runtime\vsphereclient\plugin-packages\HitachiStoragePlugin

Information Collected in VMware or vCenter managementserver (vCenter Server)

Procedures to collect information in the VMware or vCenter managementserver.


Procedure



Save.

Collect information from Windows system informationCollect information using the following steps:

Procedure

1. Open System information.2. Click Export from the File menu.3. Click Export As to select the save location for the file.4. Input the file name in the File name field.5. Click Save.

Confirm the vCenter Server versionConfirm the version using following the steps:

Procedure

1. From the home window of vSphere Web Client, select vCenter >vCenter Servers.

2. From the tree view, select vCenter Server, and then confirm the versiondisplayed in Summary window.

Collect Information in the ESXiConfirm the version using following the steps:


Procedure

1. Go to the Home window of vSphere Web Client.2. Select vCenter > Host.3. Select ESXi to see the version in Summary.

Collect Information in storage systemCollect log files and trace files from the Storage Navigator for HUS VM andVSP family storage systems.

Information Collected in HDvM serverThis section describes how to collect information.


Procedure



Save.

Collect information from Windows system informationCollect information using the following steps:

Procedure

1. Open System information.2. Click Export from the File menu.3. Click Export As to select the save location for the file.4. Input the file name in the File name field.5. Click Save.

Collect maintenance information of the Device ManagerYou can collect the maintenance information of the Device Manager using theHDvM function.

Log in the VMware managements for vCenter serverappliance

Procedure to collect Support Bundle information in the VMware managementsfor vCenter server appliance.


See, VMware vCenter Server documentation. Collect the Support Bundle. Forexample, from the vCenter Server Appliance Management Interface, runSummary > Create Support Bundle.


Hitachi Storage Plug-in for VMware vCenter User's Guide

Hitachi Data Systems

Corporate Headquarters2845 Lafayette StreetSanta Clara, California 95050-2639U.S.A.www.hds.com

Regional Contact Information

Americas+1 408 970 [email protected]

Europe, Middle East, and Africa+44 (0) 1753 [email protected]

Asia Pacific+852 3189 [email protected]

Contact Uswww.hds.com/en-us/contact.html

MK-92ADPTR047-12

http://www.hds.com

MAILTO:[email protected]

