HP XP7 User Manual

Hitachi Command Suite

Dynamic Link Manager

(for Windows®) User Guide

Document Organization

Product Version

Getting Help

Contents

MK-92DLM129-29

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 any purpose without the express written permission of Hitachi, Ltd.

Hitachi, Ltd., reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use. This document contains the most current information available at the time of publication. When new or revised information becomes available, this entire document will be updated and distributed to all registered users.

Some of the features described in this document might not be currently available. Refer to the most recent product announcement for information about feature and product availability, or contact Hitachi Data Systems Corporation at

Notice: Hitachi, Ltd., products and services can be ordered only under the terms and conditions of the applicable Hitachi Data Systems Corporation agreements. The use of Hitachi, Ltd., products is governed by the terms of your agreements with Hitachi Data Systems Corporation.

Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries. Hitachi Data Systems is a registered trademark and service mark of Hitachi, Ltd., in the United States and other countries.

Archivas, Essential NAS Platform, HiCommand, Hi-Track, ShadowImage, Tagmaserve, Tagmasoft, Tagmasolve, Tagmastore, TrueCopy, Universal Star Network, and Universal Storage Platform are registered trademarks of Hitachi Data Systems.

AIX, AS/400, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, ESCON, FICON, FlashCopy, IBM, Lotus, MVS, OS/390, RS/6000, S/390, System z9, System z10, Tivoli, VM/ESA, z/OS, z9, z10, zSeries, z/VM, and z/VSE are registered trademarks or trademarks of International Business Machines Corporation.

https://portal.hds.com.

All other trademarks, service marks, and company names in this document or web site are properties of their respective owners.

Microsoft product screen shots are reprinted with permission from Microsoft Corporation.

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.

Hitachi Dynamic Link Manager (for Windows®) User Guide

Preface.................................................................................................. xi

Intended audience....................................................................................................xii

Product version........................................................................................................ xii

Release notes...........................................................................................................xii

Document revision level............................................................................................ xii

Document organization............................................................................................ xiii

Related documents.................................................................................................. xiii

Document conventions.............................................................................................xiv

Conventions for storage capacity values.................................................................... xiv

Accessing product documentation..............................................................................xv

Getting help.............................................................................................................xv

Comments.............................................................................................................. xvi

1 Overview of HDLM................................................................................1-1

What is HDLM?.......................................................................................................1-2

HDLM Features.......................................................................................................1-2

2 HDLM Functions................................................................................... 2-1

Devices Managed by HDLM......................................................................................2-3

System Configuration.............................................................................................. 2-3

System Configuration Using an FC-SAN.............................................................. 2-3

System Configuration Using an IP-SAN...............................................................2-5

Setting Range of the iSCSI Software and iSCSI HBA...................................2-7

Storage systems Supported by HDLM....................................................... 2-7

LU Configuration.....................................................................................................2-7

Program Configuration............................................................................................ 2-9

Driver Levels of the HDLM and MPIO Drivers...........................................................2-10

Distributing a Load Using Load Balancing................................................................2-11

Paths to Which Load Balancing Is Applied.........................................................2-13

When Using the Thunder 9500V Series, or Hitachi AMS/WMS Series..........2-13

When Using Other Than the Thunder 9500V Series and Hitachi AMS/WMS

Series................................................................................................... 2-14

Load Balancing Algorithms...............................................................................2-15

Performing Failovers and Failbacks Using Path Switching......................................... 2-17

Automatic Path Switching................................................................................ 2-17

Hitachi Dynamic Link Manager (for Windows®) User Guide

iii

Automatic Failovers............................................................................... 2-17

Automatic Failbacks...............................................................................2-19

Manual Path Switching.................................................................................... 2-19

Path Status Transition..................................................................................... 2-20

The Online Path Statuses....................................................................... 2-21

The Offline Path Statuses.......................................................................2-22

Status Transitions of a Path....................................................................2-22

Monitoring Intermittent Errors (Functionality When Automatic Failback Is Used)........2-26

Checking Intermittent Errors............................................................................2-26

Setting Up Intermittent Error Monitoring...........................................................2-26

Intermittent Error Monitoring Actions............................................................... 2-27

When an Intermittent Error Occurs......................................................... 2-27

When an Intermittent Error Does Not Occur............................................ 2-28

When the Conditions for an Intermittent Error Are Changed During Error

Monitoring............................................................................................ 2-28

When a User Changes the Intermittent Error Information.................................. 2-29

Detecting Errors by Using Path Health Checking...................................................... 2-31

Distributing a Load by Using the Dynamic I/O Path Control Function.........................2-32

What is the Dynamic Load Balance Control Function..........................................2-32

Dynamic I/O Path Control Function.................................................................. 2-32

Dynamic Re-configuration......................................................................................2-33

Adding an LU Dynamically............................................................................... 2-33

Deleting an LU Dynamically............................................................................. 2-33

Error Management................................................................................................ 2-33

Types of Collected Logs...................................................................................2-34

Filtering of Error Information........................................................................... 2-36

Collecting Error Information Using the Utility for Collecting HDLM Error Information

(DLMgetras)................................................................................................... 2-37

Collecting Audit Log Data.......................................................................................2-37

Categories and Audit Events that HDLM Can Output to the Audit Log................. 2-39

Requirements for Outputting Audit Log Data.....................................................2-43

Destination and Filtering of Audit Log Data....................................................... 2-43

Audit Log Data Formats...................................................................................2-44

Integrated HDLM management using Global Link Manager.......................................2-45

Cluster Support.....................................................................................................2-46

3 Creating an HDLM Environment............................................................. 3-1

HDLM System Requirements....................................................................................3-2

OSs Supported by HDLM................................................................................... 3-2

Supported OSs........................................................................................3-2

Microsoft MPIO Drivers............................................................................ 3-3

Web Browsers Supported by HDLM.......................................................... 3-3

Storage systems Supported by HDLM.................................................................3-3

Supported Storage systems......................................................................3-3

HBAs......................................................................................................3-6

When Using Intermediate Volumes Managed by Hitachi RapidXchange to

Exchange Data........................................................................................3-6

Cluster Software Supported by HDLM.................................................................3-7

Volume Managers Supported by HDLM.............................................................3-12

Virtual Environments Supported by HDLM.........................................................3-12

Memory and Disk Capacity Requirements......................................................... 3-13

Memory Requirements...........................................................................3-13

Hitachi Dynamic Link Manager (for Windows®) User Guide

Disk Requirements.................................................................................3-13

Number of LUs and Paths That Are Supported in HDLM..................................... 3-14

Flow for Creating an HDLM Environment.................................................................3-14

HDLM Installation Types........................................................................................3-14

Notes on Creating an HDLM Environment............................................................... 3-15

Notes on HBAs and HBA Drivers.......................................................................3-15

Notes on Storage systems............................................................................... 3-15

Notes on HDLM Versions................................................................................. 3-16

Notes on Windows..........................................................................................3-17

Notes on Related Software.............................................................................. 3-20

Notes on New Installations and Upgrade Installations........................................3-23

Notes on Migration or Upgrade Installation....................................................... 3-25

Installing HDLM.................................................................................................... 3-26

Preparations for a New Installation of HDLM.....................................................3-26

Preparations for Installing HDLM by Performing an Unattended Installation.........3-28

How to Create an Installation-Information Settings File............................ 3-28

Notes on an Unattended Installation....................................................... 3-29

Performing a New Installation of HDLM on Windows Server 2003.......................3-29

In a Non-Cluster Environment................................................................ 3-29

When MSCS Is Used.............................................................................. 3-34

When VCS Is Used.................................................................................3-43

When Oracle RAC Is Used...................................................................... 3-47

Performing a New Installation of HDLM on Windows Server 2008 and Windows

Server 2012....................................................................................................3-52

In a Non-Cluster Environment................................................................ 3-52

When MSCS Is Used.............................................................................. 3-56

Upgrade Installation or Re-installation of HDLM................................................ 3-64

Migrating from HDLM 5.4 or Earlier to HDLM 5.5 or Later.................................. 3-66

Installing JRE................................................................................................. 3-67

Firewall Settings for Managing HDLM by Using Global Link Manager................... 3-68

firewall_setup command syntax..............................................................3-69

Checking the Path Configuration............................................................................ 3-70

Setting Up HDLM.................................................................................................. 3-71

Checking the Current Settings..........................................................................3-71

Setting Up the HDLM Functions........................................................................3-72

Setting Up Load Balancing..................................................................... 3-73

Setting Up Path Health Checking............................................................ 3-74

Setting Up the Automatic Failback Function.............................................3-74

Setting Up Intermittent Error Monitoring................................................. 3-75

Setting Up Dynamic I/O Path Control...................................................... 3-75

Setting Up the LU Deletion Function....................................................... 3-76

Setting the Error Log Collection Level......................................................3-77

Setting the Trace Level.......................................................................... 3-77

Setting the Error Log File Size................................................................ 3-78

Setting the Number of Error Log Files..................................................... 3-79

Setting the Trace File Size......................................................................3-79

Setting the Number of Trace Files...........................................................3-79

Setting Up Audit Log Data Collection.......................................................3-80

Checking the Updated Settings........................................................................ 3-81

Setting Up Integrated Traces................................................................................. 3-81

Removing HDLM................................................................................................... 3-84

Preparations for HDLM Removal.......................................................................3-84

Hitachi Dynamic Link Manager (for Windows®) User Guide

Notes on Removing HDLM...............................................................................3-84

Removing HDLM.............................................................................................3-86

Removal Procedures - in a Non-Cluster Environment................................3-86

Removal Procedures - MSCS or VCS Environment.................................... 3-88

Removal Procedures - Oracle RAC Environment....................................... 3-90

Removing Hitachi Network Objectplaza Trace Library (HNTRLib2)...................... 3-91

Clearing the Persistent Reservation.................................................................. 3-93

4 HDLM Operation................................................................................... 4-1

Notes on Using HDLM............................................................................................. 4-2

Using a Storage Management Program...............................................................4-2

Upgrading Windows..........................................................................................4-2

Using MSCS......................................................................................................4-2

When the Number of Displayed Paths Is Less than the Actual Number of Paths

..............................................................................................................4-2

When a System Event Occurs in an MSCS Environment..............................4-2

Using the EMC DMX series, EMC CX series, and HP EVA series............................. 4-2

Using Symantec Backup Exec for Windows and the Veritas NetBackup Intelligent

Disaster Recovery Function............................................................................... 4-3

Using Windows Server 2008 or Windows Server 2012......................................... 4-3

HDLM Operations Using the HDLM GUI.....................................................................4-4

Notes on Using the HDLM GUI...........................................................................4-4

Viewing the GUI Help........................................................................................4-4

Using Commands for HDLM Operations.................................................................... 4-4

Notes on Using Commands................................................................................4-4

Viewing Path Information..................................................................................4-5

Changing the Status of Paths.............................................................................4-5

Changing the Status of Paths to Online.....................................................4-6

Changing the Status of Paths to Offline(C)................................................ 4-6

Viewing LU Information.....................................................................................4-7

Initializing Statistical Information for Paths.........................................................4-8

Viewing and Setting Up the Operating Environment............................................ 4-8

Viewing the Operating Environment..........................................................4-8

Setting Up the Operating Environment......................................................4-9

Viewing License Information............................................................................4-10

Updating the License.......................................................................................4-10

Viewing HDLM Version Information.................................................................. 4-11

Viewing HDLM Component Information............................................................ 4-12

Using the Windows Administrative Tool (Performance) to Check Path Information..... 4-13

Starting and Stopping the HDLM Manager...............................................................4-14

Starting the HDLM Manager.............................................................................4-15

Stopping the HDLM Manager........................................................................... 4-15

HDLM Resident Processes......................................................................................4-16

Reconfiguring the HDLM Operating Environment..................................................... 4-16

Setting Up an Added LU and Path as an HDLM Management-target....................4-16

Setting Up an Added LU as an HDLM Management-target........................ 4-16

Checking an Added Path........................................................................ 4-18

Deleting an LU Dynamically............................................................................. 4-19

Requirements to Delete the LU Dynamically............................................ 4-19

Checking that the LU or Path Has Been Dynamically Deleted.................... 4-19

Recovering a Deleted LU or Path............................................................ 4-21

Hitachi Dynamic Link Manager (for Windows®) User Guide

5 Troubleshooting....................................................................................5-1

Information Collected by the DLMgetras Utility for Collecting HDLM Error Information. 5-2

Checking Error Information in Messages...................................................................5-2

What To Do for a Path Error.................................................................................... 5-4

Examining the Messages................................................................................... 5-5

Obtaining Path Information............................................................................... 5-5

Identifying the Error Path..................................................................................5-6

Narrowing Down the Hardware That Might Have Caused the Error....................... 5-6

Identifying the Error Location and Correcting any Hardware Errors.......................5-6

Placing the Path Online..................................................................................... 5-6

What To Do for a Program Error.............................................................................. 5-6

Examining the Messages................................................................................... 5-7

Obtaining Program Information......................................................................... 5-7

What To Do for the Program Error..................................................................... 5-7

Contacting your HDLM Vendor or Maintenance Company.....................................5-8

What To Do for Other Errors....................................................................................5-8

6 Command Reference.............................................................................6-1

Overview of the HDLM Command dlnkmgr................................................................6-2

clear (Returns the Path Statistics to the Initial Value)................................................ 6-3

Format.............................................................................................................6-3

To Set the Path Statistics to 0.................................................................. 6-3

To Display the Format of the clear Operation............................................ 6-3

Parameters...................................................................................................... 6-3

To Set the Path Statistics to 0.................................................................. 6-3

To Display the Format of the clear Operation............................................ 6-4

help (Displays the Operation Format)....................................................................... 6-4

Format.............................................................................................................6-4

Parameter........................................................................................................6-4

offline (Places Paths Offline)....................................................................................6-6

Format.............................................................................................................6-6

To Place Paths Offline..............................................................................6-6

To Display the Format of the offline Operation.......................................... 6-6

Parameters...................................................................................................... 6-6

To Place Paths Offline..............................................................................6-6

To Display the Format of the Offline Operation..........................................6-9

online (Places Paths Online)...................................................................................6-11

Format...........................................................................................................6-11

To Place Paths Online............................................................................ 6-11

To Display the Format of the Online Operation........................................ 6-11

Parameters.....................................................................................................6-11

To Place Paths Online............................................................................ 6-11

To Display the Format of the Online Operation........................................ 6-14

set (Sets Up the Operating Environment)................................................................6-16

Format...........................................................................................................6-16

To Set Up the HDLM Operating Environment........................................... 6-16

To Display the Format of the Set Operation.............................................6-16

Parameters.....................................................................................................6-16

To Set Up the HDLM Operating Environment........................................... 6-16

To Display the Format of the Set Operation.............................................6-31

view (Displays Information)................................................................................... 6-33

Format...........................................................................................................6-33

Hitachi Dynamic Link Manager (for Windows®) User Guide

vii

To Display Program Information............................................................. 6-33

To Display HDLM Management-target Device Information........................ 6-33

To Display Path Information...................................................................6-33

To Display LU Information......................................................................6-34

To Display the Format of the view Operation...........................................6-34

Parameters.....................................................................................................6-35

Parameters Used When Displaying Program Information.......................... 6-35

Parameters Used When Displaying HDLM Management-target Device

Information...........................................................................................6-42

Parameters Used When Displaying Path Information................................ 6-43

Parameters Used When Displaying LU Information...................................6-60

Parameter Used When Displaying the Format of the view Operation..........6-76

delete (Deletes a Path Dynamically)....................................................................... 6-77

Format...........................................................................................................6-77

To Delete a Path Dynamically.................................................................6-77

To Display the Format of the delete Operation.........................................6-77

Parameters.....................................................................................................6-77

To Delete a Path Dynamically.................................................................6-77

To Display the Format of the delete Operation.........................................6-78

7 Utility Reference................................................................................... 7-1

Overview of the Utilities.......................................................................................... 7-2

The DLMgetras Utility for Collecting HDLM Error Information......................................7-2

Format.............................................................................................................7-3

When Executing the DLMgetras Utility from the Command Prompt..............7-3

When Executing the DLMgetras Utility from the Windows Start Menu..........7-3

Parameters...................................................................................................... 7-3

List of Collected Error Information..................................................................... 7-4

The dlmpr Utility for Clearing HDLM Persistent Reservations.....................................7-10

Format...........................................................................................................7-10

Parameters.....................................................................................................7-10

Procedure for Executing the dlmpr Utility in MSCS Environments:............. 7-11

Procedure for Executing the dlmpr Utility in VCS Environments:................7-12

The dlmprsvkey Utility for Registering an HDLM Persistent Reservation Key...............7-13

Format...........................................................................................................7-13

Parameter...................................................................................................... 7-13

The dlmchkpath Utility for Checking HDLM Paths.....................................................7-14

Format...........................................................................................................7-14

Parameters.....................................................................................................7-14

The dlmhostinfo Utility for Checking HDLM Installation Information.......................... 7-16

Format...........................................................................................................7-16

Parameters.....................................................................................................7-16

The installhdlm Utility for Installing HDLM...............................................................7-17

Format...........................................................................................................7-18

Parameters.....................................................................................................7-18

Contents of an Installation-Information Settings File..........................................7-18

About the Log File...........................................................................................7-27

The removehdlm Utility for Removing HDLM........................................................... 7-28

Format...........................................................................................................7-28

Parameters.....................................................................................................7-28

viii

Hitachi Dynamic Link Manager (for Windows®) User Guide

8 Messages............................................................................................. 8-1

Before Viewing the List of Messages.........................................................................8-3

Format and Meaning of Message IDs................................................................. 8-3

Terms Used in Messages and Message Explanations............................................8-3

KAPL01001 to KAPL02000....................................................................................... 8-4

KAPL02001 to KAPL03000......................................................................................8-30

KAPL03001 to KAPL04000......................................................................................8-44

KAPL04001 to KAPL05000......................................................................................8-46

KAPL05001 to KAPL06000......................................................................................8-54

KAPL07001 to KAPL08000......................................................................................8-58

KAPL08001 to KAPL09000......................................................................................8-60

KAPL09001 to KAPL10000......................................................................................8-64

KAPL10001 to KAPL11000......................................................................................8-87

KAPL11001 to KAPL12000......................................................................................8-95

KAPL12001 to KAPL13000......................................................................................8-98

KAPL13001 to KAPL14000....................................................................................8-106

KAPL15001 to KAPL16000....................................................................................8-109

Return Codes for Hitachi Command Suite Common Agent Component.....................8-112

Events Output to Windows Event Logs by HDLM....................................................8-117

A Functional Differences Between Versions of HDLM.................................. A-1

Functional Differences Between Version 6.6 or Later and Versions Earlier Than 6.6..... A-3

Functional Differences Between Version 6.2 or Later and Versions Earlier Than 6.2..... A-3

Functional Differences Between Version 6.0.1 or Later and Versions Earlier Than 6.0.1

.............................................................................................................................A-3

Functional Differences Between Version 6.0 or Later and Versions Earlier Than 6.0..... A-3

Functional Differences Between Version 5.9.4 or Later and Versions Earlier Than 5.9.4

.............................................................................................................................A-4

Functional Differences Between Version 5.9.1 or Later and Versions Earlier Than 5.9.1

.............................................................................................................................A-4

Functional Differences Between Versions 5.9 or Later and Versions Earlier Than 5.9....A-4

Path Status Transition and Automatic Path Switching................................................ A-4

Status Transition of Paths in the Online Status....................................................A-4

Automatic Switching of Paths That Have the Online(E), Offline(C), or Offline(E)

Status..............................................................................................................A-5

Differences in the LU Dynamic Removal Function......................................................A-6

Differences in the Drive Letters Displayed in Windows...............................................A-7

Differences in Default Values...................................................................................A-7

Differences in the Load Balancing Function in an MSCS Environment..........................A-7

Acronyms and abbreviations

Glossary

Index

Hitachi Dynamic Link Manager (for Windows®) User Guide

Preface

This document describes how to use the Hitachi Dynamic Link Manager.

Intended audience

□

Product version

□

Release notes

□

Document revision level

□

Document organization

□

Intended audience

This document is intended for storage administrators who use Hitachi Dynamic Link Manager (HDLM) to operate and manage storage systems, and assumes that readers have:

• Knowledge of Windows and its management functionality

• Knowledge of Storage system management functionality

• Knowledge of Cluster software functionality

• Knowledge of Volume management software functionality

Product version

This document revision applies to HDLM for Windows version 8.0.0 or later.

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.

Document revision level

Revision Date Description

MK-92DLM129-21 November 2011 Initial Release

MK-92DLM129-22 February 2012 Revision 1, supersedes and replaces

MK-92DLM129-23 July 2012 Revision 2, supersedes and replaces

MK-92DLM129-24 August 2012 Revision 3, supersedes and replaces

MK-92DLM129-25 November 2012 Revision 4, supersedes and replaces

MK-92DLM129-26 February 2013 Revision 5, supersedes and replaces

MK-92DLM129-27 May 2013 Revision 6, supersedes and replaces

MK-92DLM129-28 October 2013 Revision 7, supersedes and replaces

MK-92DLM129-29 April 2014 Revision 8, supersedes and replaces

MK-92DLM129-21

MK-92DLM129-22

MK-92DLM129-23

MK-92DLM129-24

MK-92DLM129-25

MK-92DLM129-26

MK-92DLM129-27

MK-92DLM129-28

xii

Preface

Hitachi Dynamic Link Manager (for Windows®) User Guide

Document organization

The following table provides an overview of the contents and organization of this document. Click the chapter title in the left column to go to that chapter. The first page of each chapter provides links to the sections in that chapter.

Chapter/Appendix Description

Chapter 1, Overview of HDLM on page 1-1

Chapter 2, HDLM Functions on page 2-1

Chapter 3, Creating an HDLM Environment on page 3-1

Chapter 4, HDLM Operation on page 4-1

Chapter 5, Troubleshooting on page 5-1

Chapter 6, Command Reference on page 6-1

Chapter 7, Utility Reference on page 7-1

Describes an overview of HDLM, and its features.

Describes the system configuration of HDLM, and the basic terms and functions for HDLM.

Describes the necessary preparations for installing HDLM, and then describes how to install HDLM and set up the various functions.

Describes how to use HDLM by using both the HDLM GUI and commands, and how to manually start and stop the HDLM manager. This chapter also describes how to configure an environment to properly operate HDLM, such as changing the HDLM managementtarget devices that connect paths or replacing the hardware that makes up a path. Chapter 4 also describes how to check path information by using the Windows management tool.

Describes how to troubleshoot a path error, HDLM failure, or any other problems that you might encounter.

Describes all the HDLM commands.

Describes the HDLM utilities.

Chapter 8, Messages on page 8-1

Appendix A, Functional Differences Between Versions of HDLM on page A-1

Document conventions

This document uses the following typographic conventions:

Convention Description

Bold Indicates text on a window, other than the window title, including

menus, menu options, buttons, fields, and labels. Example: Click OK.

Italic Indicates a variable, which is a placeholder for actual text provided by

the user or system. Example: copy source-file target-file

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

Monospace

< > angled brackets

[ ] square brackets

{ } braces Indicates required or expected values. Example: { a | b } indicates

| vertical bar Indicates that you have a choice between two or more options or

underline

PROMPT>

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

Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: # pairdisplay -g <group>

Note: Italic font is also used to indicate variables.

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

that you must choose either a or b.

arguments. Examples: [ a | b ] indicates that you can choose a, b, or nothing. { a | b } indicates that you must choose either a or b.

Indicates the default value.

Example:

[ a | b ]

Indicates the prompt in the window where the command is executed.

PROMPT indicates the current directory path displayed in the window.

Conventions for storage capacity values

xiv

Physical storage capacity values (for example, disk drive capacity) are calculated based on the following values:

Preface

Hitachi Dynamic Link Manager (for Windows®) User Guide

Physical capacity unit Value

1 kilobyte (KB)

1 megabyte (MB)

1 gigabyte (GB)

1 terabyte (TB)

1 petabyte (PB)

1 exabyte (EB)

1,000 (103) bytes

1,000 KB or 1,0002 bytes

1,000 MB or 1,0003 bytes

1,000 GB or 1,0004 bytes

1,000 TB or 1,0005 bytes

1,000 PB or 1,0006 bytes

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

Logical capacity unit Value

1 block 512 bytes

1 KB

1 MB

1 GB

1 TB

1 PB

1,024 (210) bytes

1,024 KB or 1,0242 bytes

1,024 MB or 1,0243 bytes

1,024 GB or 1,0244 bytes

1,024 TB or 1,0245 bytes

1 EB

Accessing product documentation

The HDLM user documentation is available on the Hitachi Data Systems Portal: https://portal.hds.com. 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 Data Systems Support Portal is the destination for technical support of your current or previously-sold storage systems, midrange and enterprise servers, and combined solution offerings. The Hitachi Data Systems customer support staff is available 24 hours a day, seven days a week. If you need technical support, log on to the Hitachi Data Systems Support Portal for contact information:

Hitachi Data Systems Community is a new global online community for HDS customers, partners, independent software vendors, employees, and prospects. It is an open discussion among these groups about the HDS portfolio of products and services. It is the destination to get answers, discover insights, and make connections. The HDS Community complements

https://portal.hds.com.

1,024 PB or 1,0246 bytes

Preface

Hitachi Dynamic Link Manager (for Windows®) User Guide

our existing Support Portal and support services by providing an area where you can get answers to non-critical issues and questions. Join the conversation today! Go to community.hds.com, register, and complete your profile.

Comments

Please send us your comments on this document: doc.comments@hds.com. Include the document title and number, including the revision level (for example, -07), and refer to specific sections and paragraphs whenever possible. All comments become the property of Hitachi Data Systems Corporation.

Thank you!

xvi

Preface

Hitachi Dynamic Link Manager (for Windows®) User Guide

Overview of HDLM

HDLM is a software package that manages paths between a host and a storage system. HDLM is designed to distribute loads across multiple paths and will switch a given load to another path if there is a failure in the path that is currently being used, thus improving system reliability.

This chapter gives an overview of HDLM and describes its features.

What is HDLM?

□

HDLM Features

□

Overview of HDLM

Hitachi Dynamic Link Manager (for Windows®) User Guide

1-1

What is HDLM?

With the widespread use of data warehousing and increasing use of multimedia data, the need for high-speed processing of large volumes of data on networks has rapidly grown. To satisfy this need, networks dedicated to the transfer of data, such as SANs, are now being used to provide access to storage systems.

HDLM manages the access paths to these storage systems. HDLM provides the ability to distribute loads across multiple paths and switch to another path if there is a failure in the path that is currently being used, thus improving system availability and reliability.

The figure below shows the connections between hosts and storage systems. A server on which HDLM is installed is called a host.

Figure 1-1 Connections Between Hosts and Storage systems

For details about the storage systems supported by HDLM, see Storage

systems Supported by HDLM on page 3-3.

HDLM Features

HDLM features include the following:

The ability to distribute a load across multiple paths. This is also known as load balancing.

When a host is connected to a storage system via multiple paths, HDLM can distribute the load across all the paths. This prevents one, loaded down path from affecting the processing speed of the entire system.

For details on load balancing, see

Balancing on page 2-11.

1-2

Hitachi Dynamic Link Manager (for Windows®) User Guide

Distributing a Load Using Load

Overview of HDLM

The ability to continue running operations between a host and storage system, even if there is a failure. This is also known as performing a failover.

When a host is connected to a storage system via multiple paths, HDLM can automatically switch to another path if there is some sort of failure in the path that is currently being used. This allows operations to continue between a host and a storage system.

For details on performing failovers, see

Using Path Switching on page 2-17.

The ability to bring a path that has recovered from an error back online. This is also known as performing a failback.

If a path is recovered from an error, HDLM can bring that path back online. This enables the maximum possible number of paths to always be available and online, which in turn enables HDLM to better distribute the load across multiple paths.

Failbacks can be performed manually or automatically. In an automatic failback, HDLM will automatically restore the path to an active state after the user has corrected the problem that exists on the physical path.

For details on performing failbacks, see

Failbacks Using Path Switching on page 2-17.

The ability to automatically check the status of any given path at regular intervals. This is also known as path health checking.

HDLM can easily detect errors by checking the statuses of paths at userdefined time intervals. This allows you to check for any existing path errors and to resolve them promptly and efficiently.

For details on setting up and performing path health checking, see

Detecting Errors by Using Path Health Checking on page 2-31.

Performing Failovers and Failbacks

Performing Failovers and

A GUI, which allows you to operate HDLM in a visually pleasing and easy to navigate environment. This is also known as the HDLM GUI.

HDLM can utilize both configuration-diagrams and the list format to display information about all the paths that exist between hosts and Hitachi storage systems. You can use the GUI to easily change the status of any given path, and to set up a proper operating environment.

For details on the HDLM GUI, see the HDLM GUI Help.

Overview of HDLM

Hitachi Dynamic Link Manager (for Windows®) User Guide

1-3

1-4

Overview of HDLM

Hitachi Dynamic Link Manager (for Windows®) User Guide

HDLM Functions

This chapter describes the various functions that are built into HDLM. Before the function specifications are explained though, this chapter will go into detail about the HDLM management targets, system configuration, and basic terms that are necessary to know to effectively operate HDLM. After that, the rest of the chapter focuses on describing all the HDLM functions, including the main ones: load distribution across paths and path switching.

Devices Managed by HDLM

□

System Configuration

□

LU Configuration

□

Program Configuration

□

Driver Levels of the HDLM and MPIO Drivers

□

Distributing a Load Using Load Balancing

□

Performing Failovers and Failbacks Using Path Switching

□

Monitoring Intermittent Errors (Functionality When Automatic Failback Is

□

Used)

Detecting Errors by Using Path Health Checking

□

Distributing a Load by Using the Dynamic I/O Path Control Function

□

Dynamic Re-configuration

□

Error Management

□

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

2-1

Collecting Audit Log Data

□

Integrated HDLM management using Global Link Manager

□

Cluster Support

□

2-2

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

Devices Managed by HDLM

Below is a list of devices that can or cannot be managed by HDLM. The devices that can be managed by HDLM are called HDLM management-target devices.

HDLM management-target devices:

The following devices are from the storage systems listed in Section What

is HDLM? on page 1-2:

SCSI devices

Hitachi storage system command devices, such as Hitachi RAID Manager command devices

The EMC DMX series, EMC CX series, and HP EVA series Note that only the OSs below can be used to manage these devices. For the EMC DMX series, EMC CX series, and HP EVA series:

- Windows Server 2003 (x86) SP1 or later

- Windows Server 2003 (IPF) SP1 or later

- Windows Server 2003 (x64) For the EMC CX series:

- Windows Server 2008 can also be used. For the HP EVA series:

- Windows Server 2008 R2 can also be used.

Non-HDLM management-target devices:

SCSI devices other than those that are in the storage systems listed in Section

Built-in disks on a host

Non-disk devices (tape devices, etc.)

What is HDLM? on page 1-2

System Configuration

HDLM is available in two SAN environment types: FC-SAN and IP-SAN. Note that the EMC DMX series, EMC CX series, and HP EVA series can only be used in an FC-SAN environment.

System Configuration Using an FC-SAN

In an FC-SAN, fiber cables connect hosts to storage systems. The cable port on the host is called a host bus adapter (HBA). The cable port on the storage system is called a port (P) on a channel adapter (CHA).

A logical unit (LU), which lies in a storage system, is either an input target or an output target to or from a host. The areas within an LU are called Devs.

A route that connects a host to a Dev in an LU is called a path.

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

2-3

HDLM assigns a unique ID to each management-target path. This ID is called

AutoPATH_ID. Sometimes, the path is also just simply called a management target.

The following figure shows the configuration of an HDLM system using an FCSAN.

Figure 2-1 Configuration of an HDLM System When Using an FC-SAN

The following table lists the HDLM system components when using an FCSAN.

Table 2-1 HDLM System Components When Using an FC-SAN

Components Description

HBA A host bus adapter. This serves as a cable port on the

host.

FC-SAN A dedicated network that is used for the transfer of

data between hosts and storage systems

CHA A channel adapter

P A port on a CHA. This serves as a cable port on a

storage system.

LU A logical unit with which a host can perform I/O

operations. This unit can be accessed from the network.

Dev A logical area (a partition) in an LU

Path A route that connects a host to a Dev in an LU

2-4

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

System Configuration Using an IP-SAN

In an IP-SAN, LAN cables are used to connect hosts to storage systems. The cable port on the host is called an iSCSI host bus adapter (iSCSI HBA) or a network interface card (NIC). In order to use an NIC, the iSCSI software must be installed ahead of time on the host. The cable port on the storage system is called a port (P) on a channel adapter (CHA) used for iSCSI connections.

A logical unit (LU), which lies in a storage system, is either an input target or an output target to or from a host. The areas within an LU are called Devs.

A route that connects a host to a Dev in an LU is called a path.

HDLM assigns a unique ID to each management-target path. This ID is called

AutoPATH_ID. Sometimes, the path is also just simply called a management target.

Figure 2-2 Configuration of an IP-SAN System When Using an iSCSI HBA on page 2-5 shows the configuration of an IP-SAN system when using an

iSCSI HBA.

Software and an NIC on page 2-6 shows the configuration of an IP-SAN

system when using the iSCSI software and an NIC.

Figure 2-3 Configuration of an IP-SAN System When Using iSCSI

Figure 2-2 Configuration of an IP-SAN System When Using an iSCSI HBA

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

2-5

Figure 2-3 Configuration of an IP-SAN System When Using iSCSI Software

and an NIC

The following table lists the HDLM system components when using an IP-SAN.

Table 2-2 HDLM System Components When Using an IP-SAN

Components Description

iSCSI software The driver software that contains the iSCSI initiator function

iSCSI HBA A host bus adapter that contains the iSCSI initiator function.

This serves as a cable port on a host. The iSCSI HBA is referred to as the HBA in HDLM commands and the HDLM GUI. Sometimes, it is also just simply called an HBA in this manual.

NIC A network interface card that serves as a cable port on a host.

The NIC is referred to as the HBA in HDLM commands and the HDLM GUI. Sometimes, it is also just simply called an HBA in this manual.

IP-SAN A data transfer network that connects hosts and storage

systems by using the iSCSI standard.

CHA A channel adapter used for iSCSI connections

P A port on a CHA. This serves as a cable port on a storage

system.

2-6

LU A logical unit with which the host can perform I/O operations.

This unit can be accessed from the network.

Dev A logical area (a partition) in an LU

Path A route that connects a host to a Dev in an LU

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

Setting Range of the iSCSI Software and iSCSI HBA

The following describes the ranges that can be used for the iSCSI software and iSCSI HBA settings. For notes on how to set these values, see the corresponding documentation for your particular iSCSI software and iSCSI HBA.

• IP addresses Use the same network address for both an HBA and a CHA port connected

via a common path.

• Other settings

An IP-SAN can be used for multiple hosts.

A single HBA can connect to multiple CHA ports.

When using the iSCSI software together with multiple NICs, be sure to connect each NIC to a different IP network. Also, be sure to connect to the storage system by using a different CHA port for each IP network. To view an example of the configuration described above, see

an IP-SAN System When Using iSCSI Software and an NIC on page 2-6.

Storage systems Supported by HDLM

The following storage systems can be used with an IP-SAN: the Lightning 9900V series, Hitachi AMS/WMS series, Hitachi Universal Storage Platform 100, Hitachi Universal Storage Platform 600, Hitachi Universal Storage Platform 1100, Hitachi NSC 55, and Hitachi SMS series.

Figure 2-3 Configuration of

LU Configuration

After you have properly installed HDLM, the LU configuration will change as follows:

Before the installation of HDLM:

In the Windows' Disk Management window of a host, one SCSI device is displayed as multiple LUs, each of which corresponds to one path.

In other words, the number of LUs in a storage system appeared to be the same as the number of paths connected to the various SCSI devices.

After the installation of HDLM:

The MPIO driver combines what was once viewed as multiple LUs (each with one path) into one LU containing multiple paths. In the Windows' Disk Management window of a host, only the disks that have a one-toone correspondence with an LU in the storage system are displayed.

This means that each LU in the storage system is always recognized as only one LU, regardless of the number of paths that are connected to SCSI devices.

You can display all the various SCSI devices from the Windows' Device Manager window.

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

2-7

After the installation of HDLM, an LU recognized by a host is called a host LU (HLU). The areas in a host LU that correspond to the Devs in a storage system LU are called host devices (HDev).

On a system using HDLM, in order to access a target LU, a drive letter is first assigned to the disk that has been integrated by the MPIO driver. Such disks are displayed in the Windows' Disk Management window.

The following figure shows the LU configuration recognized by the host, after the installation of HDLM.

Figure 2-4 LU Configuration Recognized by the Host After the Installation

of HDLM

The following table lists and describes the components recognized by the host.

Table 2-3 Components Recognized by the Host

Components Description

HLU An LU that the host recognizes via the HDLM driver. This

type of LU is called a host LU. Regardless of how many paths are connected to it, only one host LU is recognized for each LU in the storage system.

HDev A Dev in an LU that the host recognizes via the HDLM

driver. This type of Dev is called a host device.

2-8

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

Program Configuration

HDLM is actually a combination of several programs. Because each program corresponds to a specific HDLM operation, it is important to understand the name and purpose of each program, along with how they are all interrelated.

The following figure shows the configuration of the HDLM programs.

Figure 2-5 Configuration of the HDLM Programs

The following table lists and describes the functions of these programs.

Table 2-4 Functions of HDLM Programs

Program name Functions

HDLM GUI Provides a graphical user interface (GUI), which enables

you to:

• Manage paths

• Display error information

• Set up the HDLM operating environment

HDLM command Provides the dlnkmgr command, which enables you to:

• Manage paths

• Display error information

• Set up the HDLM operating environment

HDLM utility Provides the HDLM utility, which enables you to:

• Collect error information

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

2-9

Program name Functions

• Clear persistent reservations

• Register persistent reservation keys

• Check the configuration of the paths

• Check the installation information

• Perform unattended installations of HDLM

• Perform unattended removals of HDLM

HDLM manager Provides the HDLM manager, which enables you to:

• Configure the operating environment

• Request path health checks and automatic failbacks to be performed

• Collect error log data

HDLM alert driver Reports the log information collected by the HDLM driver

to the HDLM manager.

HDLM driver Controls all the HDLM functions, manages paths, and

detects errors. The HDLM driver consists of the following:

• Core logic component

Controls the basic functionality of HDLM.

• Filter component

Sends and receives I/O data. The driver name is hdlmdsm.sys.

Note:

HDLM programs other than the HDLM GUI are referred to as the HDLM Core components.

Driver Levels of the HDLM and MPIO Drivers

The HDLM and MPIO drivers are positioned at a higher driver level than the SCSI drivers. In other words, applications that are accessing LUs in storage systems will first use the HDLM and MPIO drivers, and then use the SCSI drivers, in order to access the LUs.

The following figure shows the driver levels of the HDLM and MPIO drivers.

2-10

HDLM Functions

Hitachi Dynamic Link Manager (for Windows®) User Guide

+ 416 hidden pages