Hitachi Storage Plug-in for VMware vcenter User's Guide Release v3.7.1

Transcription

1 Hitachi Storage Plug-in for VMware vcenter User's Guide Release v3.7.1 This guide explains how to install, configure and use Hitachi Storage Plug-in for VMware vcenter with supported Hitachi storage array models: Hitachi Virtual Storage Platform, Hitachi Unified Storage VM, Hitachi VSP G1000, VSP G1500, VSP F1500, VSP Gx00, Fx00 and HNAS 4000 systems. MK-92ADPTR October 2017

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

3 Contents Preface... 9 Intended audience Release notes Referenced documents Document conventions Conventions for storage capacity values...11 Accessing product documentation Getting help...12 Comments Overview of Hitachi Storage Plug-in for VMware vcenter...15 Overview of Hitachi Storage Plug-in for VMware vcenter's functions...16 Key terms and concepts System Requirements...19 System configuration for Hitachi Storage Plug-in for VMware vcenter...20 Hardware requirements Software requirements Supported operating systems...23 Storage system requirements...23 Restrictions and considerations Setting up Hitachi Storage Plug-in for VMware vcenter Installing the Hitachi Storage Plug-in Installation prerequisites Installing the Windows version Installing the vcenter Server Appliance version...29 Uninstalling the Hitachi Storage Plug-in...30 Uninstalling the Windows version...30 Uninstalling Hitachi Storage Plug-in from the Control Panel Uninstalling Hitachi Storage Plug-in vcenter Server Appliance version...31 Repairing the Hitachi Storage Plug-in

4 Repairing the Windows installation...32 Repairing the vcenter Server Appliance version installation...33 Changing the maintenance configuration file Log file size Number of log generations Using Hitachi Storage Plug-in for VMware vcenter...35 Accessing the Hitachi Storage Plug-in Adding a storage system...36 Adding VSP Gx00/Fx00 NAS or HNAS module as a file storage system Adding a HUS VM or VSP family storage system...36 Removing a storage system Refreshing storage system information Refreshing all storage systems...38 Refreshing selected storage systems Provisioning datastores...39 Overview of Provision Datastore Creating a datastore Creating VMFS datastores Creating LUs for Raw Device Mapping (RDM) Creating NFS datastores Cancelling Provision Datastore Deleting datastores Verifying before deleting a datastore or LU Deleting a VMFS datastore or LU...46 Deleting an NFS datastore Information Display...49 Datastores information Host information Virtual Machines information Troubleshooting...51 Troubleshooting the Hitachi Storage Plug-in installation...52 Troubleshooting Hitachi Storage Plug-in operational errors Troubleshooting Storage Systems errors Troubleshooting HDvM server errors Troubleshooting Provision Datastore function errors...54 Retry of Provision Datastore Rollback of Provision Datastore...55 Provision Datastore task stops before completing...55 Stops while retrying NFS Export Creation...55 Stops while creating an NFS datastore...56 Troubleshooting datastore deletion errors Retry of Delete Datastore...56 Delete Datastore stops before it has completed

5 7 Log files HiAppServerModule.log...60 Information Collected During Problem Occurrence Collect Windows Event Log information Collect Windows system information Confirm vsphere Web Client version...61 Collect vsphere Web Client/vCenter Server logs Collect log files from the Hitachi Storage Plug-in Collect vcenter and ESXi information Collect Windows Event Log information Collect Windows system information Confirm the vcenter Server version...62 Collect ESXi information Collect storage system information...63 HDvM information Collect Windows Event Log information Collect Windows system information Collect Device Manager, HDvM maintenance information Collect vcenter Server Appliance information

6 8

7 Preface This guide explains how to install, configure and use Hitachi Storage Plug-in for VMware vcenter with supported storage systems. See Storage system requirements on page 23 for the list of supported storage systems. Intended audience Release notes Referenced documents Document conventions Conventions for storage capacity values Accessing product documentation Getting help Comments Preface 9

8 Intended audience This document is intended for operators (also called VM manager) of VMware management console (vsphere Web Client) to verify the configurations of the storage system and perform setting operations (creation of a datastore) using the storage system. Readers of this document should be familiar with the following: Using Microsoft Windows Server family operating systems. Using the VMware vsphere Web Client. Release notes Read the release notes before installing and using this product. They may contain requirements or restrictions that are not fully described in this document or updates or corrections to this document. Release notes are available on Hitachi Vantara Support Connect: knowledge.hitachivantara.com/documents. Referenced documents The documents below are either referenced by this document, or supply more information related to this product's features. Hitachi documents: Hitachi Command Suite User Guide, MK-90HC172 Metro REST API Specification VMware documents: VMware vsphere ESXi and vcenter Server 5.5/6.0/6.5 Document conventions This 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. 10 Preface

9 Convention Description Indicates a variable, which is a placeholder for actual text provided by the user or for output by the system. Example: pairdisplay -g group Monospace (For exceptions to this convention for variables, see the entry for angle brackets.) 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 you must choose either a or b. vertical bar Indicates that you have a choice between two or more options or arguments. Examples: [ a b ] indicates that you can choose a, b, or nothing. { a b } indicates that you must choose either a or b. This document uses the following icons to draw attention to information: Icon Label Description Note Calls attention to important or additional information. Tip Provides helpful information, guidelines, or suggestions for performing tasks more effectively. Caution Warns the user of adverse conditions and/or consequences (for example, disruptive operations, data loss, or a system crash). WARNING Warns the user of a hazardous situation which, if not avoided, could result in death or serious injury. Conventions for storage capacity values Physical storage capacity values (for example, disk drive capacity) are calculated based on the following values: Preface 11

10 Physical capacity unit Value 1 kilobyte (KB) 1,000 (10 3 ) bytes 1 megabyte (MB) 1,000 KB or 1,000 2 bytes 1 gigabyte (GB) 1,000 MB or 1,000 3 bytes 1 terabyte (TB) 1,000 GB or 1,000 4 bytes 1 petabyte (PB) 1,000 TB or 1,000 5 bytes 1 exabyte (EB) 1,000 PB or 1,000 6 bytes Logical capacity values (for example, logical device capacity, cache memory capacity) are calculated based on the following values: Logical capacity unit Value 1 block 512 bytes 1 cylinder Mainframe: 870 KB Open-systems: OPEN-V: 960 KB Others: 720 KB 1 KB 1,024 (2 10 ) bytes 1 MB 1,024 KB or 1,024 2 bytes 1 GB 1,024 MB or 1,024 3 bytes 1 TB 1,024 GB or 1,024 4 bytes 1 PB 1,024 TB or 1,024 5 bytes 1 EB 1,024 PB or 1,024 6 bytes Accessing product documentation Product user documentation is available on Hitachi Vantara Support Connect: Check this site for the most current documentation, including important updates that may have been made after the release of the product. Getting help Hitachi Vantara Support Connect is the destination for technical support of products and solutions sold by Hitachi Vantara. To contact technical support, log on to Hitachi Vantara Support Connect for contact information: support.hitachivantara.com/en_us/contact-us.html. Hitachi Vantara Community is a global online community for Hitachi Vantara customers, partners, independent software vendors, employees, and prospects. It is the destination to get answers, discover insights, and make 12 Preface

11 connections. Join the conversation today! Go to community.hitachivantara.com, register, and complete your profile. Comments Please send us your comments on this document to Include the document title and number, including the revision level (for example, -07), and refer to specific sections and paragraphs whenever possible. All comments become the property of Hitachi Vantara Corporation. Thank you! Preface 13

12 14 Preface

13 1 Overview of Hitachi Storage Plug-in for VMware vcenter Hitachi Storage Plug-in for VMware vcenter integrates Hitachi storage system information and provisioning operations in to VMware vsphere Web Client. This integration allows VMware product administrators to perform storage provisioning operations from within the VMware user interface, which offers greater convenience than having to switch between VMware and Hitachi management software to perform common operations involving both. Overview of Hitachi Storage Plug-in for VMware vcenter's functions Key terms and concepts Overview of Hitachi Storage Plug-in for VMware vcenter 15

14 Overview of Hitachi Storage Plug-in for VMware vcenter's functions Hitachi Storage Plug-in for VMware vcenter provides functions to view storage information, provision datastores, and delete datastores. View: The View displays the storage system information registered in the storage plug-in, the datastore on the ESXi host using the storage system, and virtual machine information. Provision Datastore: The Provision Datastore creates an LU used as a datastore for a Virtual Machine File System (VMFS), a Network File System (NFS), and also for Raw Device Mapping objects (RDMs) by a storage system registered in the Hitachi Storage Plug-in. Delete Datastore/LU: The Delete Datastore is a one-step operation that removes datastores or LUs from storage systems registered with the storage plug-in. It does not remove datastores or LUs that were created without using the storage plug-in. Key terms and concepts This topic describes key terms and VMware environment objects relevant to the Hitachi Storage Plug-in. The term vsphere is a collective name for the VMware-based virtual environment, which includes the VMware vsphere software, VMware vcenter Server software, VMware ESXi clusters and hosts managed by the vcenter Server, and the virtual machines (VMs) and vapps hosted on those ESXi clusters. For details about these concepts, see the Hitachi Command Suite User Guide and the VMware documentation provided by VMware Inc. Term Datastore Description Virtual area used to store a virtual machine image on ESXi. The actual area is created on a local disk or external storage system. 16 Overview of Hitachi Storage Plug-in for VMware vcenter

15 Term HDP HDvM Hitachi Command Suite HNAS Host Group Metro RDM Description Hitachi Dynamic Provisioning. An optional function of the storage system to reduce complicated design. Large volume of virtual capacity eliminates reliance on device capacity. Hitachi Device Manager. One of the software included in Hitachi Command Suite User Guide, consolidating multiple Hitachi manufactured software managements. Storage management software suite, supporting storage resource operation in Enterprise environments. Hitachi NAS Platform is a network attached storage system which allows storage capacity from back-end arrays to be accessed over TCP/IP, using SMB, NFS, iscsi and FTP. Host Groups represent storage array LU masking configurations which allow a set of HBA ports to access a set of LUs. Metro is a REST API which allows REST client applications to configure and collect information from Hitachi storage systems. Raw Device Mappings are VMware configuration objects which allow VMs to directly access LUs. Overview of Hitachi Storage Plug-in for VMware vcenter 17

16 18 Overview of Hitachi Storage Plug-in for VMware vcenter

17 2 System Requirements This chapter provides information about the necessary system requirements. System configuration for Hitachi Storage Plug-in for VMware vcenter Hardware requirements Software requirements Supported operating systems Storage system requirements Restrictions and considerations System Requirements 19

18 System configuration for Hitachi Storage Plug-in for VMware vcenter Hitachi Storage Plug-in requires the following system configuration: VMware software components require access to Hitachi storage systems using TCP/IP. ESXi must have Fibre Channel or TCP/IP connectivity to VSP G series storage systems, and Fibre Channel access to HUS VM and VSP family storage systems. User accounts must have administrator role privileges to use vsphere Web Client. IPv4 TCP/IP connectivity (IPv6 is not supported). Installation requires 110MB or more of free space. HDvM is required for HUS VM and VSP family storage systems. Metro is required for creating NFS datastores backed by HNAS storage systems. The next image is an example of a system configuration for the Storage plugin for Windows version. This type of configuration is required for the NAS option for VSP Gx00 and VSP Fx System Requirements

19 System configuration for Windows System configuration for vcenter Server Appliance Hardware requirements Item Description Notes CPU Memory HDD free space 2.00 GHz or faster processor with four cores or more 4 GB or more RAM (Use 8 GB or more for vcenter Server 6.0/6.5) Varies according to the requirements of the maintenance setup file (the log file size and the number of log generations can be modified) GB or more if the log file size is set to the default value (10 MB) and the number of log generations is also set to the default value (19 generations) when installed 75 GB or more if the log file size is set to the maximum (100 MB) and the number of log generations of the backup file is also set to the maximum (255 generations) Recommended for vsphere Web Client Server Recommended for vsphere Web Client Server 110 MB or more required for installation System Requirements 21

20 Item Description Notes Formula for calculating the required disk size: Required disk size [GB] = (specified log file size [MB]) x (number of log generations + 1) x 3 (HiAppServerModule.log) [MB]) 1024 LAN Gigabit Ethernet or faster is recommended Recommended for vsphere Web Client Server Software requirements Caution: If the vsphere Web Client is not installed before the storage plug-in is installed, the storage plug-in will fail to install. Software One of the following is required: Required by vsphere Web Client VMware vsphere Web Client 5.5 (Update 3) VMware vcenter Server 6.0 (Update 3) - The vsphere Web Client is included in VMware vcenter Server 6.0 VMware vcenter Server 6.5 (Update 1) - The vsphere Web Client is included in VMware vcenter Server 6.5 One of the following is required: vsphere Web Client Windows version VMware vcenter Server 5.5 (Update 3) VMware vcenter Server 6.0 (Update 3) VMware vcenter Server 6.5 (Update 1) 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 (Update 1) One of the following is required: ESXi VMware ESXi 5.5 (Update 3) VMware ESXi 6.0 (Update 3) VMware ESXi 6.5 (Update 1) Hitachi Device Manager (Hitachi Command Suite Component) HUS VM and VSP family. Compatible versions: VSP: 7.0 or later HUS VM: or later VSP G1000: or later VSP G1500: or later VSP F1500: or later VSP Gx00 models: or later 22 System Requirements

21 Software Required by VSP Fx00 models: or later Metro Server Version or later Microsoft Internet Explorer Mozilla Firefox Required for managing NFS datastore with the HNAS and Hitachi Storage Plug-in. Installed on the VMware Management client. Google Chrome Supported operating systems Operating 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 Microsoft Windows Server 2016 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 Microsoft Windows Server 2016 Standard/Datacenter Edition Mac OS X Storage system requirements Item Description Supported storage systems VSP HNAS 4000 HUS VM VSP G1000 VSP G1500 VSP F1500 VSP Gx00 models VSP Fx00 models Firmware version VSP or later System Requirements 23

22 Item Description HUS VM VSP G or later or later or later Interface/Host port VSP F1500 VSP G1000 VSP Gx00 models VSP Fx00 models VSP HUS VM VSP G1000 VSP G1500 VSP F1500 VSP Gx00 models VSP Fx00 models or later or later Fibre Channel Fibre Channel, iscsi, FCoE Fibre Channel, iscsi (1 Gbps, 10 Gbps), NFS Restrictions and considerations The following restrictions and considerations apply when using the Hitachi Storage Plug-in for VMware vcenter. Account authentication The administrator must have privileges to install and use the storage plug-in. Communication port for the HDvM server The storage plug-in uses TCP port number 2001 to communicate with the HDvM server by default. Confirm that TCP port number 2001 is not being used by other software. If the port number is used by other software, change the port number in the HDvM setting using Add Storage System. After installing the storage plugin, the port number that you want to use must be enabled to communicate with the HDvM server. Confirmation at installation Prior to installing the Hitachi Storage Plug-in for VMware vcenter software, confirm that all monitoring, and virus monitoring services (such as daemon processes) are not activated. If such monitoring services are active, installation may fail. 24 System Requirements

23 Installation folder The installation folder of the storage plug-in differs according to the version of the 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\pluginpackages\HitachiStoragePlugin vsphere Web Client 6.5 C:\ProgramData\VMware\vCenterServer\runtime\vsphere-client\pluginpackages\HitachiStoragePlugin vcenter Server Appliance 6.0 and 6.5 /usr/lib/vmware-vsphere-client/plugin-packages/hitachistorageplugin First confirm that sufficient free space to install the storage plug-in is available 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. Note: do not use RAID0 in the storage system because 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 Hitachi Storage Plug-in does not support resource group management. If you use the Hitachi Storage Plug-in, please verify the following: HDvM users registered with the Hitachi Storage Plug-in can view all resource groups. If the user's view of resource groups is limited, the Hitachi Storage Plug-in will not operate correctly. The Hitachi Storage Plug-in does not support LUs with designated resource groups and datastore creation. SSL Communication with the HDvM server Not supported. Update installation, repair installation, and uninstallation of the Storage Plugin Stop the vsphere Web Client application before updating, repairing, or uninstalling the Hitachi Storage Plug-in. System Requirements 25

24 Upgrading the vsphere Web Client Uninstall the Hitachi Storage Plug-in before upgrading the vsphere Web Client. Then reinstall or update installation of the Hitachi Storage Plug-in. WARNING: When upgrading the storage plug-in software, information registered in the current version of the vsphere Web Client is not transferred to the upgraded version. 26 System Requirements

25 3 Setting up Hitachi Storage Plug-in for VMware vcenter The procedures in this chapter guide you through the Hitachi Storage Plug-in installation and configuration processes. They also describe how to uninstall, update, and repair an installation and how to modify the maintenance configuration file. Installing the Hitachi Storage Plug-in Uninstalling the Hitachi Storage Plug-in Repairing the Hitachi Storage Plug-in Changing the maintenance configuration file Log file size Number of log generations Setting up Hitachi Storage Plug-in for VMware vcenter 27

26 Installing the Hitachi Storage Plug-in Verify that your environment and storage systems meet the prerequisites described below, then follow the appropriate procedure below to install your selected version of the storage plug-in. Installation prerequisites Setting up the vsphere environment and confirming the storage system are required to use Hitachi Storage Plug-in. The vsphere environment is configured. The storage system satisfies the requirements. Metro Server is required to use HNAS (Gateway model). Confirming the Storage System Requirements Installing the Windows version This procedure describes how to install the Hitachi Storage Plug-in for Windows. The Hitachi Storage Plug-in will renew if you have an older version. The installation process remains the same. Procedure 1. Run installer file, Hitachi-StoragePlugin-setup(03.7.1)-01.exe, double-click the installer setup icon. 2. Click Next. 3. Confirm the license, then select I accept the terms of the license agreement. Click Next. 4. Click Next to start the installation process. 5. Click Finish to complete. 6. Restart the VMware vsphere Web Client (vsphere 5.5/6.0) or VMware service Lifecycle Manager (vsphere 6.5) Note: How to Stop or Start the VMware vsphere Web Client service, follow the steps below. Replace Stop with Start for restarting the service. 1. Log in to Windows 2. Open Server Manager 3. Click Tools > Services 4. Right click on the VMware vsphere Web Client 5. Click Stop 28 Setting up Hitachi Storage Plug-in for VMware vcenter

27 Installing the vcenter Server Appliance version This procedure describes how to install the Hitachi Storage Plug-in for vcenter Server Appliance version. The Hitachi Storage Plug-in will renew the 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 Hitachi 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-setup bin 3. On the Welcome screen, press Enter. Note: Warnings may be displayed if there is insufficient free space on the install destination drive. Installation requires 100MB or more of free space. Confirm there is sufficient free space, then reinstall the product. 4. Press Enter from keyboard to scroll the license agreement. Read the agreement. Enter Y (yes). 5. The default fixed installation path is displayed. /usr/lib/vmwarevsphere-client/plugin-packages 6. Press Enter from keyboard to complete the installation. 7. Restart the vsphere Web Client service. Note: SDK 6.0 will be installed. For details on accessing the vcenter Server Appliance using ssh, see documentation provided by VMware. Verify configuration files. The configuration file (hilogger.config) is created in the Hitachi Storage Plug-in installation folder, when the Hitachi Storage Plug-in is installed. Note: How to Stop or Start the VMware vsphere Web Client service, see the steps below. Replace Stop with Start for restarting the service. 1. Log in as a root user to the vcenter Server Appliance 2. Enter following commands: Setting up Hitachi Storage Plug-in for VMware vcenter 29

28 (For vsphere 6.5) # service-control --stop vsphere-client (For vsphere 6.0) # service vsphere-client stop Uninstalling the Hitachi Storage Plug-in Use one of the procedures listed below to uninstall your version of the Hitachi Storage Plug-in. Uninstalling the Windows version This procedure describes how to uninstall the Hitachi Storage Plug-in for Windows. Procedure 1. Stop the VMware vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5) Note: How to Stop or Start the VMware vsphere Web Client service, follow the steps below. Replace Stop with Start for restarting the service. 1. Log in to Windows 2. Open Server Manager 3. Click Tools > Services 4. Right click on the VMware vsphere Web Client 5. Click Stop 2. Run the installer file: Hitachi-StoragePlugin-setup(03.7.1)-01.exe 3. On the Welcome screen, choose Remove, then click Next. 4. Click Yes. 5. The Uninstall Complete message informs you when Hitachi Storage Plug-in is uninstalled. Click Finish. 6. Confirm that Hitachi Storage Plug-in for VMware vcenter is removed from the Programs and Features window. Note: files that are generated at installation and files you created in the installed folders remain even after the uninstallation is completed. Manually remove the folder and files if required. 7. Start the VMware vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5), if necessary. 30 Setting up Hitachi Storage Plug-in for VMware vcenter

29 Uninstalling Hitachi Storage Plug-in from the Control Panel Use the procedure listed below to uninstall the Hitachi Storage Plug-in from the Control Panel. Note: Programs and Features - Click Uninstall in Hitachi Storage Plug-in for VMware vcenter window to uninstall the program. Procedure 1. Stop the VMware vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5). 2. In the Programs and Features list in the Control Panel, select Hitachi Storage Plug-in for VMware vcenter. Click Uninstall. 3. Click Yes. 4. Click Finish. 5. From the Program and Features window, confirm the removal of the Hitachi Storage Plug-in for VMware vcenter. Even if the uninstallation is complete, some files are automatically created during installation. The files that the user created in the installation folder are not removed. Manually remove the folder and files if necessary. 6. Start the vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5) after completing the uninstallation of the Hitachi Storage Plug-in. Uninstalling Hitachi Storage Plug-in vcenter Server Appliance version Use the procedure listed below to uninstall the Hitachi Storage Plug-in (vcenter Server Appliance version). For details on the SSH/Bash shell connection to vcenter Server Appliance and file forwarding, see VMware documentation provided by VMware Inc. Procedure 1. Log in as a root user to the vcenter Server Appliance with SSH. 2. Stop the VMware vsphere Web Client service. 3. Enter these commands:# cd /usr/lib/vmware-vsphere-client/ pluginpackages/hitachistorageplugin/plugins and #./ Uninstall.sh 4. Choose option Yes. Enter 1, then press Enter. 5. Start the VMware vsphere Web Client service. See the note of step 2. Setting up Hitachi Storage Plug-in for VMware vcenter 31

30 Note: How to Stop or Start the VMware vsphere Web Client service, see the steps below. Replace Stop with Start for restarting the service. 1. Log in as a root user to the vcenter Server Appliance 2. Enter following commands: (For vsphere 6.5) # service-control --stop vsphere-client (For vsphere 6.0) # service vsphere-client stop Repairing the Hitachi Storage Plug-in Use the appropriate procedure below to repair the Hitachi Storage Plug-in. Repairing the Windows installation If you delete a file from the installation destination folder by mistake, you can restore it by repair installation. There are two ways you can repair the installation. 1. Hitachi Storage Plug-in Installer. 2. Control Panel Important: Whenever you repair an installation, registered storage system information may be removed. If this happens, re-register the storage system information using the Adding a storage system on page 36. Procedure 1. Stop the VMware vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5). 2. Run installer file, Hitachi-StoragePlugin-setup(03.7.1)-01.exe, double-click the installer setup icon. 3. On the Welcome screen, choose Repair, then click Next. 4. If the vsphere Web Client service is running, a dialog box appears to show that the service is running. Stop the vsphere Web Client service, then click Next. Note: The message indicating that the service is running does not appear if the service has already stopped. 5. Click Finish. 6. Start the VMware vsphere Web Client service (vsphere 5.5/6.0) or VMware Service Lifecycle Manager (vsphere 6.5). 32 Setting up Hitachi Storage Plug-in for VMware vcenter

31 Repairing the vcenter Server Appliance version installation If you have mistakenly deleted a file from the install folder, you can restore the file by repairing the installation. If you run the repair install, any registered storage device information may be deleted. If deleted, use Adding a Storage System to re-register the storage system information. Procedure 1. Log in with root user credentials. 2. Stop the VMware vsphere Web Client service 3. Run #./RepairInstall.sh Note: For details on accessing the vcenter Server Appliance using ssh, see documentation provided by VMware. 4. On the Manage Instances screen, press Enter. 5. Select option 1, press Enter. Note: If you have not logged in with root credentials, an error message may be displayed: verify the prerequisites have been met, then retry the repair installation procedure. 6. Press Enter to exit the installer. 7. Start the VMware vsphere Web Client service. Changing the maintenance configuration file When the Hitachi Storage Plug-in is installed, a maintenance configuration file (hilogger.config) is created in the Hitachi Storage Plug-in installation folder. Use the maintenance configuration file to set the log output formats generated by Hitachi Storage Plug-in. Descriptions of the maintenance configuration file are listed below. Note: Edit the file with a text editor using alphanumeric characters. While editing this file, be sure to press <Enter> at the end of each line, including the file's final line (the file should end with a blank line). Log file size You can specify the log file size. MaxFileSize=<size> You can specify the size of an output log file in megabytes using the <size> value. Specify between 1 and 100. Setting up Hitachi Storage Plug-in for VMware vcenter 33

32 Specify <size> in single-byte decimal numbers. Put MaxFileSize=<size> in single-byte brackets. Insert a line feed after MaxFileSize=<size>. If the omitted or non-allowed values (outside the maximum and minimum values or other than single byte values) are used, the default value of 10 MB is used. Number of log generations MaxBackupIndex=<number-of- generations> When a log file's size exceeds the specified maximum size, the log files will rotate (i.e. log.0.txt will become log.1.txt). 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 single-byte brackets. Insert a line feed after MaxBackupIndex=<number-of-generations>. If the omitted or non-allowed values (outside the maximum and minimum values or other than one-byte values) are used, the default value of 19 generations is used. Notation examples for a maintenance configuration file 34 Setting up Hitachi Storage Plug-in for VMware vcenter

33 4 Using Hitachi Storage Plug-in for VMware vcenter This chapter explains how to access the plug-in, add and remove storage systems, and perform storage provisioning operations from within the VMware vsphere Web Client. Accessing the Hitachi Storage Plug-in Adding a storage system Removing a storage system Refreshing storage system information Provisioning datastores Deleting datastores Using Hitachi Storage Plug-in for VMware vcenter 35

34 Accessing the Hitachi Storage Plug-in When the storage plug-in is installed, the Hitachi Storage Plug-in icon is added to vsphere Web Client window. Procedure 1. Log in to the vsphere Web Client from a browser. 2. Click the Hitachi Storage Plug-in icon. Adding a storage system Use Add Storage System to register storage systems to be monitored by the storage plug-in. The registration procedure differs slightly according to the type of storage system you want to add. Adding VSP Gx00/Fx00 NAS or HNAS module as a file storage system Procedure 1. In the Hitachi Storage Plug-in Navigator, click Storage Systems. 2. Click Add Storage System icon. 3. On the Model screen, select the type of storage system you want to add; click Next. 4. On the Management Server Information screen, enter the IP address and port number for the Metro server or for one of the storage controllers; click Next. 5. On the Admin EVS information screen, enter the IP address, user ID, and password for the EVS server. If you entered the IP address of one of the storage controllers on the Management Server Information screen, enter that same IP address here; click Next. 6. On the Summary screen, verify the settings. Use the Back button to modify any of the settings. 7. Click Finish. 8. Refresh the storage system, see Refreshing storage system information on page 37 Adding a HUS VM or VSP family storage system Procedure 1. In the Hitachi Storage Plug-in Navigator, click Storage Systems. 2. On the Storage Systems list screen, click Add Storage System. 3. On the Model screen, select a storage system model option; click Next. 4. On the Information screen, enter the following information for the HDvM server: 36 Using Hitachi Storage Plug-in for VMware vcenter

35 IP Address Port Number User ID Password 5. Click Next. If connection fails (for example, a communication error occurs, the required storage systems are not displayed, or the user ID or password is incorrect), troubleshoot the issue or contact your storage system administrator to verify that your user account settings are correct. 6. Select a storage system that you want to register from the list. You can add only one storage system at a time. Click Next. 7. On the Summary screen, confirm the model and other information for the storage system you selected. 8. Click Finish. 9. Refresh the storage system, see Refreshing storage system information on page 37 If a problem occurs, remove any registered virtual storage systems, refresh the storage system information (verify the virtual storage systems are no longer displayed), then re-add them using Adding a storage system on page 36. Removing a storage system Use Remove Storage System to remove a storage system from being monitored by the storage plug-in. Run Remove Storage System by either of the two methods listed below. Note: Even if you remove storage systems using Remove Storage System, datastores or LUs created by using the Hitachi Storage Plug-in remain. If you want to remove those datastores or LUs, usedeleting datastores on page 45. Procedure 1. In the Navigator pane, click Storage Systems. 2. Select the storage system you want to remove from the Storage Systems list. 3. Click Remove Storage System. 4. Click Yes. 5. Click Refresh Storage System. Refreshing storage system information Use Refresh Storage System to update the information for all or selected storage systems. Refreshing the storage systems from the Home screen Using Hitachi Storage Plug-in for VMware vcenter 37

36 updates the information for all storage systems while refreshing from the Storage Systems list screen updates the information for selected storage systems only. Note: Always refresh the storage system information after adding or removing a storage system, or after provisioning or deleting a datastore. You can run Refresh Storage System from the Objects screen or under Actions. Refreshing all storage systems When all registered storage systems have not been refreshed recently, a screen prompting to begin a refresh may appear on the Home window. Refreshing storage systems from the Home window refreshes the information for all registered storage systems. To refresh information for a single storage system, run Refresh from the Storage Systems list screen. Procedure 1. Go to the Home screen of the Hitachi Storage Plug-in. 2. In the message, click Yes. 3. Click OK. All registered storage systems information will be refreshed. If you like to select individual storage systems, run refresh from the Storage Systems screen. 4. The progress of the refresh is shown in the Recent Tasks pane. 5. Refreshing the storage task completes. 6. Click the Refresh icon in the vsphere Web Client title bar to display the refreshed information. Refreshing selected storage systems Refreshing storage systems from the Storage Systems list screen refreshes the information for only the storage systems selected in the Storage Systems list. Before you begin You must refresh storage systems before the following actions to avoid error displays and un-registration of the storages systems occur. If any of the following settings for the selected storage system have been changed before refreshing any storage systems, an error appears, then selected storage system is removed from the window. Related reference:adding a storage system on page 36 Changed the password. Removed the account. The Account Authentication is changed from Disabled to Enabled. 38 Using Hitachi Storage Plug-in for VMware vcenter

37 The View authority of the target storage system is removed from the account. Note: To display the correct information, register the storage systems again. Procedure 1. On the Hitachi Storage Plug-in screen, click the Storage Systems. 2. Select the Storage Systems. 3. In the Actions drop down, choose Refresh Storage System. 4. In the verifying message, click Yes. 5. If a second confirmation message appears, click OK. 6. The progress of the refresh is shown in the Recent Tasks pane. 7. The Refresh Storage task completes. 8. Click the Refresh icon in the vsphere Web Client title bar to display the refreshed information. Provisioning datastores The Provision Datastore command enables you to create LUs for use as VMFS datastores/rdms and enables you to create an export for use as NFS datastores by a storage system registered in the Hitachi Storage Plug-in. Overview of Provision Datastore Before you begin Create the host group or iscsi target in which WWN for HBA of ESXi is registered. Otherwise the host group or iscsi target will not appear on the selection screen. An example of the host group used to assign the LU: Using Hitachi Storage Plug-in for VMware vcenter 39

38 Example of host group: *1 Logical unit and datastore are created in the Provision Datastore. Host group 1 Name BL360-B0-9 Port 0A WWN Storage adapter 1 Logical unit Logical unit 1 *1 The capacity of the datastore varies depending on the ESXi version and the storage system. See, System Requirements on page 19 Block size is dependent on the VMFS of the datastore. The Provision Datastore is available in the following screens: Storage Devices list screen (Provision Datastore icon) Datastores list screen (Provision Datastore icon) Datastores list screen (Actions menu) Creating a datastore This feature allows VMware datastores to be created, including the storage objects necessary to support them. Both VMFS and NFS datastores and Raw Device Mappings are supported. Creating VMFS datastores Before you begin The Hitachi Storage Plug-in must be installed, and must have sufficiently current information about the storage system being used, to complete the 40 Using Hitachi Storage Plug-in for VMware vcenter

39 operation. Depending on the operation's specifics, it may be necessary to refresh the storage array information before continuing. Verify that all involved ESXi hosts have Fibre Channel connectivity to the storage system. Choose a storage system upon which to create an LU. Verify RAID group or DP pool that creates the LU used in the VMFS datastore. Verify the Host group or iscsi target of the storage system in which the WWN or iscsi name of the storage adapter (HBA ESXi host) is set. Note: Before you start the Provision Datastore, run Refresh Storage System in advance and retrieve the latest information of storage system. Procedure 1. In the Hitachi Storage Plug-in navigator, click Storage Devices. 2. Click the Provision Datastore icon to start the Provision Datastore. 3. On the Type screen, choose VMFS datastore, click Next. 4. On the VMFS version screen, choose the VMFS version. If you select VMFS3, specify the block size: 1MB, 2MB, 4MB or 8MB. 5. Click Next. 6. On the Name and Capacity screen, determine how many datastores you want to create (single or multiple). To create a single datastore To create multiple datastores 1. Select Single datastore Creation. 1. Choose Multiple datastore Creation. 2. Enter a name (3-42 characters) for the datastore. Acceptable characters: alphanumeric, space,! # ( ) + -,. _ 3. Enter a value for the datastore capacity as allowed by the ESXi server you are using ( GB). The total capacity of the datastore is displayed on the Total column. 2. Enter a name (3-42 characters) for the datastore. Acceptable characters: alphanumeric, space,! # ( ) + -,. _ 3. In Number of datastores, enter the number of the datastores you want to create. You can create up to 256 datastores. 4. On the Starting Number, enter a starting number (0-999) for the datastores. The datastore name is displayed on the datastore Name column. 5. In Datastore Capacity, enter a capacity value for each datastore (2GB-65535GB). The total capacity of the datastore is displayed on the Total column. 7. Click Next. 8. On the Storage Adapter screen, select the storage adapter for the datastores. a. From Select Cluster or Host, click Cluster name or ESXi host. b. Select the storage adapter. c. Click Next. Using Hitachi Storage Plug-in for VMware vcenter 41

40 9. On the Storage Configuration screen, configure the storage system for the datastore(s). a. Select a Storage System. b. Select a Storage Pool/RAID group. c. Select a Host Group/Target Select Host group Caution: The total datastore size is displayed in Storage Pool/RAID Group. For virtual storage systems, the serial numbers for the virtual storage and physical storage systems are displayed together in Storage System. <Storage model>_<virtual storage serial number>(<physical storage serial number>) d. Click Next. 10. On the Summary screen, confirm the settings for the datastore. Click a screen name to modify any settings. 11. Click Finish. The datastore creation progress and results can be viewed in the Recent Tasks of the vsphere Web Client. After the datastore is created, it appears in the Storage Devices list. Click Refresh Storage System to update the storage system information. Note: You can cancel the Provision Datastore after the datastore creation process is started; however, rollback is not enabled. Any LUs already created will remain on the storage system and must be deleted manually. Creating LUs for Raw Device Mapping (RDM) Before you begin The Hitachi Storage Plug-in must be installed and refreshed the storage system. Verify that the storage adapter is connected to the storage system (HBA ESXi host) Choose the storage system for creating the LU used for RDM. Verify RAID group or DP pool that creates the LU used for RDM. Verify the Host group or iscsi target of the storage system in which the WWN or iscsi name of the storage adapter (HBA ESXi host) is set. Note: Click Refresh Storage System to update the window with the latest storage system and vsphere environment information. 42 Using Hitachi Storage Plug-in for VMware vcenter

41 Procedure 1. From the Inventory list in the Navigator, click Storage Devices. 2. To start the Provision Datastore wizard, click the Provision Datastore icon. 3. On the Type screen, select LUN for Raw Device Mapping, click Next. 4. On the Capacity screen, choose Single LUN creation or Multiple LUN creation. For Single LUN creation For Multiple LUN creation 1. Choose Single LUN Creation. 1. Choose Multiple LUN Creation. 2. Enter a value for the LUN capacity (2GB-65535GB). 2. Enter the number of LUs (256 maximum) you want to create. 3. Click Next. 3. Enter a capacity value for each LU ( GB). The total capacity for the multiple LUs is displayed on the Total. 4. Click Next. 5. On the Storage Adapter screen, select the storage adapter for the datastores. a. Select the cluster or ESXi host of the virtual machine where the LUs will be created. b. Select the storage adapter for the LUs. c. Click Next. 6. On the Storage Configuration screen, configure the storage system for the LUs. a. Choose a storage system. Choose the physical storage for the LUs to create the virtual datastore. The virtual storage system name is displayed first, followed by the physical storage name. b. Choose the storage pool group or RAID group for the LUs. c. Select the host group or target. d. Click Next. 7. On the Summary screen, confirm the settings for the LUs. Click a screen name to modify any settings. 8. Click Finish. The datastore creation progress and results can be viewed in the Recent Tasks pane of the vsphere Web Client. After the LU is created, it appears in the Storage Devices list. Click Refresh Storage System to update the storage system information. Note: You can cancel the LU creation process after the datastore creation process is started; however, any LUs already created will remain on the storage system and must be deleted manually. Delete them manually using Delete Datastore. Contact your storage system administrator for additional assistance. Using Hitachi Storage Plug-in for VMware vcenter 43

42 Creating NFS datastores Use the Provision Datastore wizard to create an NFS Datastore. The Metro Server Information page is accessible only at the time of NFS Datastore creation. Apply Metro Server information to the Metro Server Information page. Note: Only the storage manager can view a LDEV-labeled creation. Click Refresh Storage System to update the window with the latest storage system and vsphere environment information. Before you begin If a file system is not created on the HNAS storage system prior to datastore creation, the file system is not displayed at the time of selection in the Provision Datastore procedure. You need to set the following; The NFS export and the storage system for the connection The NAS storage system for NFS datastore File systems and folders for NFS datastore The ESXi for datastore creation Verify the created file system and availability on the HNAS storage system Procedure 1. On the Hitachi Storage Plug-in screen, click Storage Devices. 2. Click Provision Datastore to start the Provision Datastore wizard. 3. On the Type screen, select NFS datastore, click Next. 4. On the Storage Information screen, select Storage System from the drop-down menu. Click Next. 5. On the File System screen, select File System. Click Next. Caution: Only file systems from Admin EVS-targeted user accounts are displayed in the list. If no file systems are displayed, ask your storage system administrator to verify your user account settings. 6. On the NFS Export Configuration, choose NFS export or check Create New Export box. To create an NFS Export: Select NFS Export, click Next. To create new export: a. Check Create New Export box. b. Enter the NFS Export Name. c. Enter the Directory Path to the ESXi host. d. Enter the host IP address. e. Select a Snapshot option. 44 Using Hitachi Storage Plug-in for VMware vcenter

43 f. Select a Local Read Cache. g. Select a Transfer to Replication Target. h. Click Next. 7. On the Datastore Configuration, enter a name for the datastore. The export path will be displayed after entering a name. Acceptable characters (3-42 characters) are alphanumeric, space,! # ( ) + -,. _ If you do not want to edit the datastore, check the Mount NFS as Read Only. 8. Click Next. 9. On the Host Configuration screen, select NFS datastore host. Click Next. 10. On the Summary screen, confirm the settings. Click a screen name to go back and modify settings. 11. Click Finish. The datastore creation progress and results can be viewed in the Recent Tasks pane of the vsphere Web Client. After the datastore is created, it appears in the Storage Devices list. Click Refresh Storage System to update the storage system information. Note: You can cancel the Provision Datastore; however, the NFS export already created will remain in the HNAS. To delete an NFS export, contact your storage system administrator for assistance. Cancelling Provision Datastore You can cancel Provision Datastore after the datastore creation process is started; however, rollback is not enabled. Any LUs already created remain on the storage system and must be deleted manually. When you cancel Provision Datastore, rollback is disabled. Created LUs on the storage system remain. Delete LUs accordingly. Procedure 1. Click Refresh Storage System. 2. Click Delete datastore, then manually delete any LUs remaining on the storage system. See, Deleting datastores on page 45 or ask storage administrator for deletion of Storage LUN output in the message. 3. Click Refresh Storage System, then verify all LUs are deleted. Deleting datastores Use Delete datastore to delete datastores or LUs on storage systems that are registered with the Hitachi Storage Plug-in. Prior to deleting a datastore, Using Hitachi Storage Plug-in for VMware vcenter 45

44 refresh the storage information to be sure the datastore or LU you want to delete is displayed and to reduce possible deletion errors. Verifying before deleting a datastore or LU Before you begin Run Refresh Storage System to retrieve the latest storage system and vsphere environment information before performing the Delete Datastore. If the Refresh Storage System is not performed, the following events may occur. The datastore or LU to be deleted is not displayed. The deletion may lead to an error after the Delete Datastore starts. Caution: Be careful when deleting datastores or LUs. They cannot be recovered. Delete Datastore deletes datastores or LUs on storage systems that are registered with the Hitachi Storage Plug-in. Some datastores cannot be deleted using the Delete Datastore command. Use vsphere Web Client to delete the following: Datastores or LUs not created from the Hitachi Storage Plug-in VVol Datastore Datastores with a virtual machine or virtual machine template Datastores with multiple LUs Datastores with pair-configured LUs Datastores with LUs used in a Raw Data Mapping (RDM) If you are still unable to delete a datastore, ask your storage administrator to delete it for you. If you want to delete a datastore with multiple LUs or delete an LU being used by a datastore, follow the procedure listed below to verify the LUs. Procedure 1. On the Hitachi Storage Plug-in screen, click Storage Devices. 2. Verify the name, datastore and device information displayed on the Storage Devices screen. Deleting a VMFS datastore or LU Use Delete Datastore to delete VMFS datastores. The Delete Datastore command is available as an icon on the Storage Devices list screen and as an action on the Storage Device List and datastores list screen. How to delete VMFS datastore or LU: 46 Using Hitachi Storage Plug-in for VMware vcenter

45 Procedure 1. On the Hitachi Storage Plug-in screen, click Storage Devices. 2. Under Datastore, on the Storage Devices screen, select the datastore or LU you want to delete. You can delete only one datastore at a time. 3. Click Delete Datastore icon. 4. Click Yes to confirm deletion. Note: You can cancel the task execution by clicking the Cancel. When you cancel Delete Datastore, the LUN that is not deleted remains. Delete unnecessary LUN. The results of the Delete Datastore appear in the vsphere Web Client task. When you click Refresh icon, Recent Tasks pane displays the Delete Datastore task. 5. Run Refresh Storage System to retrieve the latest storage system and vsphere environment information. Deleting an NFS datastore Procedure 1. On the Storage Plug-in screen, Click the Storage Devices. 2. Select the NFS datastore you want to delete. 3. Click Actions menu. 4. Select All Hitachi Storage Plug-in Actions. 5. Click Delete Datastore. 6. Click Yes. The results of the Delete Datastore appear in the vsphere Web Client task. 7. Run Refresh Storage System to retrieve the latest storage system and vsphere environment information. Using Hitachi Storage Plug-in for VMware vcenter 47

46 48 Using Hitachi Storage Plug-in for VMware vcenter

47 5 Information Display Hitachi Storage Plug-in for VMware vcenter displays Hitachi storage system information in VMware vsphere Web Client. This information includes views of storage system properties and related objects, and lists of storage devices, ESXi hosts, datastores and virtual machines. Datastores information Host information Virtual Machines information Information Display 49

48 Datastores information Once a Hitachi storage system has been registered with the Hitachi Storage Plug-in, datastores backed by that storage system will appear on this screen. Only datastores created by using the Hitachi Storage Plug-in will appear. If you select a datastore from the list, a Hitachi Storage Information area will appear on the Summary tab. This area displays Hitachi storage system configuration objects associated with the datastore. For example, if a datastore is backed by a LU, information identifying the LU's storage system and LUN will appear in this area. To display this information, first select a datastore, then click Summary. Host information The host list screen displays the ESXi hosted registered storage system in Hitachi Storage Plug-in. Once a storage system has been registered with the Hitachi Storage Plug-in, ESXi hosts which consume resources from that storage system will appear on the Hosts screen. When an ESXi host is selected from this screen, a Hitachi Storage Information area will appear under Summary. This area displays information about the storage systems associated with the selected ESXi host. To display this information, first select an ESXi host, then click Summary. Virtual Machines information Virtual Machines list displays the virtual machines list of the registered datastores in the Hitachi Storage Plug-in. Once a Hitachi storage system is registered with the Hitachi Storage Plug-in, virtual machines which consume resources from that storage system will appear on this screen. If you select a virtual machine from the list, a Hitachi Storage Information area will appear on the Summary. This area displays Hitachi storage system configuration objects associated with the virtual machine. For example, if a virtual machine resides on a VMFS filesystem backed by a Hitachi LU, information identifying the LU's storage system and LUN will appear in this area. To display this information, first select a virtual machine, then click Summary. 50 Information Display

49 6 Troubleshooting This chapter includes troubleshooting information. Troubleshooting the Hitachi Storage Plug-in installation Troubleshooting Hitachi Storage Plug-in operational errors Troubleshooting Storage Systems errors Troubleshooting HDvM server errors Troubleshooting Provision Datastore function errors Troubleshooting datastore deletion errors Troubleshooting 51

50 Troubleshooting the Hitachi Storage Plug-in installation If problems occur when you use the installer of the storage plug-in, an error message is displayed. Follow the error message for further directions. If you cannot 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 the above solves the problem, contact Support. Troubleshooting Hitachi Storage Plug-in operational errors If problems occur while using the Hitachi Storage Plug-in, error information is displayed and output to a log file. Follow the error message for further directions. If you cannot identify the problem, verify the following: All requirements are met. Review the operating environment and Errors Occurring in Storage Systems topic. If none of the above solves the problem, contact Support. Troubleshooting Storage Systems errors When errors occur within a storage system, thehitachi Storage Plug-in may propagate up through the and/or ESXi, and appear in the corresponding component's logs. The following procedures explain how to investigate storage system errors. Check the storage system environment: Confirm that the storage system is online and healthy. Also, confirm that the storage system requirements are fulfilled, and that the storage system's configuration complies with what's described in Restrictions and considerations on page 24. Even if these requirements were met at the time Hitachi Storage Plug-in for VMware vcenter was installed, changes to the storage system made thereafter may have yielded an unsupported configuration. Confirm Ethernet connections: Confirm that the storage system is attached to the LAN with a network cable. Confirm the IP address: 52 Troubleshooting

51 Confirm that the IP address being used to access the storage system matches the IP address displayed in its management interface. Confirm the TCP port number: Verify that the TCP port number used to access the storage system has not changed. If the TCP port number has changed, add df-damp-snm <storage system port number>/tcp to the VMware management client's Services file. Confirm firewall settings: Verify that the storage system's accessible using TCP/IP. Depending on specifics which will vary between environments, it may be necessary to adjust firewall settings to allow this access. Confirm ESXi connectivity: Verify the following: 1. Whether Fibre Channel and TCP/IP connectivity between the ESXi host and the storage system is healthy. 2. Whether LU masking is configured correctly on the storage system. For Fibre Channel access, LU masking's represented by hostgroup objects. For iscsi access, it's represented by iscsi target objects. Troubleshooting HDvM server errors If a problem occurs while you are using the storage plug-in, a failure may have occurred on the HDvM server. Verify the following: Confirmation items of the HDvM server environment: Verify that the HDvM server started without problems. Also, verify that HDvM's Windows service has not stopped. Confirm TCP/IP connectivity: Verify that the HDvM server is attached to the LAN with a network cable. Confirm the IP address: Verify that the IP address used to access HDvM matches the IP address it's configured to use. Confirm the TCP port number: Verify that the TCP port number used for the HDvM server is correct. Register the new number if the TCP port number is different. Confirm firewall settings: Verify that HDvM is accessible using TCP/IP. Troubleshooting 53

52 If it's inaccessible, a firewall configuration change may be required to allow access. Resources managed by HDvM (1) Ensure that the desired storage system is registered with HDvM. (2) If a resource group lock is preventing HDvM from collecting information from the storage system, it may be necessary to remove the lock. (3) Verify that HDvM is able to retrieve information from and configure the storage system. (4) Verify that the storage system information displayed in HDvM is consistent with the information displayed using more low-level Hitachi management interfaces, such as Storage Navigator or CCI. Confirm the HDvM user account (1) Verify that the HDvM account is valid and enabled. (2) Verify that the HDvM account password is correct. (3) Verify that the HDvM account is configured with view and modify privileges. Troubleshooting Provision Datastore function errors This section describes troubleshooting operations pertaining to the Provision Datastore. Retry of Provision Datastore LUs created by the Provision Datastore may not appear immediately in vsphere Web Client. If this occurs, either retry the operation, or use the rollback feature (described below) to revert storage objects created by this to their state prior to its use. It may also be necessary to run Refresh Storage System after using the Provision Datastore, before newly created storage objects will appear in vsphere Web Client's Storage Devices list. Perform the following procedure for retry: Procedure 1. Verify the failure message shown in the Recent Tasks. 2. Click the Provision Datastore icon. 3. Click Yes on the warning message. 4. Try the Provision Datastore again. The Provision Datastore task on the Recent Tasks pane will be marked complete when the retry is finished. 54 Troubleshooting

53 5. Refresh the storage system. Rollback of Provision Datastore Procedure 1. Verify the failure message shown in Recent Tasks when Provision Datastore fails. 2. Click the Provision Datastore icon. 3. Click No on the warning. 4. Click Yes on the next warning message to continue the rollback of Provision Datastore. 5. Click the Refresh icon to display the rollback progress status on the Recent tasks. Once Recent Tasks has been refreshed, the task should appear to have been completed. Note: The information displayed in Recent Tasks may not update itself automatically. To update Recent Tasks, click the Refresh icon. Provision Datastore task stops before completing If you did not run the Retry or Rollback, the task remains in-process and the created LUs remain on the server. Verify the following: If the task stops while creating storage system LUs: 1. Display the event of the task. 2. Delete the storage array LU created by the partially completed task. 3. Run Refresh Storage System to retrieve the latest information. If the task stops after creating an LU, yet before performing target LU masking (the hostgroup operation), or if the task stops after LU masking and before ESXi has detected the LU: 1. Display the event task. 2. Remove the LU created by the task which did not complete from the hostgroup object, if applicable. 3. Delete the LU created by the incomplete task. 4. Run Refresh Storage System to retrieve the latest information. If the task stops during datastore creation: 1. Run Refresh Storage System to retrieve the latest information. 2. Delete LU using the Delete Datastore. 3. Run Refresh Storage System a second time, to ensure that the latest information is displayed. Stops while retrying NFS Export Creation Troubleshooting 55

54 Procedure 1. Vies the task event. 2. Report the error message to Support. 3. Run Refresh Storage System. Stops while creating an NFS datastore Procedure 1. Refresh the storage system. 2. Report the error message for Support. 3. Run Refresh Storage System again. Troubleshooting datastore deletion errors This section describes how to retry Delete Datastore operations, how to recover from problems which may occur during NFS datastore tasks, and how to recover when Delete Datastore stops prematurely. Retry of Delete Datastore This procedure describes the Retry procedure for Delete Datastore errors. Procedure 1. View the error message shown in the Recent Tasks pane. 2. Click the Delete Datastore icon when a related failure message appears in Recent Tasks. 3. Click Yes on the warning message. 4. Watch Recent Tasks to observe the Delete Datastore task. If the Delete Datastore operation is successful, it will display in Recent Tasks as complete. 5. Run the Refresh Storage System after using Delete Datastore. Delete Datastore stops before it has completed If the vsphere Web Client service stops while a Delete Datastore task is running, it may leave a partial storage configuration in place. These procedures describe how to recover from this situation. If the task stops during the confirmation of LU usage status or datastore deletion: 1. Run Refresh Storage System to retrieve the latest information. 2. Observe the Datastores list to determine whether the LU being deleted remains in the list. If it remains, try Delete Datastore again. 3. Delete the LU. 4. Run Refresh Storage System to retrieve the latest information. 56 Troubleshooting

55 If the task stops while unmapping or deleting the LU. 1. Verify that the LU has been deleted from the storage system. 2. Run Refresh Storage System to retrieve the latest information. Troubleshooting 57

56 58 Troubleshooting

57 7 Log files Hitachi Storage Plug-in for VMware vcenter logs messages to several different log files. This chapter explains which log file(s) correspond to each component included with and related to this product, and how to collect them while receiving technical support. HiAppServerModule.log Information Collected During Problem Occurrence Collect vcenter and ESXi information HDvM information Collect vcenter Server Appliance information Log files 59

58 HiAppServerModule.log Hitachi Storage Plug-in for VMware vcenter's plug-in component logs messages to this file. An example log message is shown below. An output example of a log file error message is shown below. Search that the log type is ERROR (1), and then confirm the content of the message (2) with the Error Message list. A severity level's associated with each log message, and those with severity level "ERROR" (1) tend to be of greatest value for debugging. By cross-referencing an "ERROR" severity log message's value (2) against the Error Message list, additional insight in to symptom's cause may be found. Information Collected During Problem Occurrence When a problem cannot be solved by troubleshooting, provide the following to Support. Collect Windows Event Log information Procedure 1. Open Windows Event Viewer. 2. In Event Viewer, right click on the event log category (at least Application and System), and click Save All Events As Input a file name for the export file in the File name box. 4. Click the appropriate file format in the File type box, click Save. Collect Windows system information Collect information using the following steps: Procedure 1. Open Microsoft System Information. 60 Log files

59 If an icon for this does not appear in Administrative Tools, it can be started from a cmd or PowerShell command prompt by entering msinfo Click Export from the File menu. 3. Input the file name in the File name field. 4. Click Save. Confirm vsphere Web Client version Confirm the vsphere Web Client version using following the steps: Procedure 1. From the Menu in vsphere Web Client, select Help -> About VMware vsphere. 2. Confirm the vsphere Web Client version displayed in the dialog box. Collect vsphere Web Client/vCenter Server logs Create a ZIP file containing everything under the pathname (shown below) which corresponds to the VMware version being used. 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-in Create a ZIP file containing the folders and files listed below. 1. Intermediate file: These files reside in the plug-in's installation folder. multiaccount.xml modelname.config This file resides in Hitachi Storage Plug-in for VMware vcenter's installation folder. version.txt Confirm the vsphere Web Client version by following the steps below: 1. From the Menu in vsphere Web Client, select Help -> About VMware vsphere 2. Confirm the vsphere Web Client version displayed in the dialog box Note: Log files are located in the following log folder of the Hitachi Storage Plug-in. vsphere Web Client 5.5 (Windows version) Log files 61