Hitachi Dynamic Link Manager User manual

Hitachi Command Suite

Dynamic Link Manager Software

User Guide (for Solaris(R))

MK-92DLM114-21

Document Organization

Product Version

Getting Help

Contents

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. (hereinafter referred

to as "Hitachi") and Hitachi Data Systems Corporation (hereinafter referred to as "Hitachi Data

Systems").

Hitachi and Hitachi Data Systems reserve the right to make changes to this document at any time

without notice and assume 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.

All of the features described in this document may not be currently available. Refer to the most

recent product announcement or contact your local Hitachi Data Systems sales office for information

on feature and product availability.

Notice:

Hitachi Data Systems products and services can be ordered only under the terms and

conditions of Hitachi Data Systems' applicable agreements. The use of Hitachi Data Systems

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

By using this software, you agree that you are responsible for:

a) Acquiring the relevant consents as may be required under local privacy laws or otherwise from

employees and other individuals to access relevant data; and

b) Ensuring that data continues to be held, retrieved, deleted or otherwise processed in accordance

with relevant laws.

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 in the United States and other

countries.

ShadowImage is a registered trademark of Hitachi Data Systems.

Microsoft product screen shots reprinted with permission from Microsoft Corporation.

All other trademarks, service marks, and company names are properties of their respective owners.

ii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Contents

Preface.................................................................................................xiii

Intended audience...................................................................................................xiv

Product version.......................................................................................................xiv

Release notes..........................................................................................................xiv

Document revision level...........................................................................................xiv

Document organization............................................................................................xiv

Referenced documents.............................................................................................xv

Document conventions.............................................................................................xv

Convention for storage capacity values.....................................................................xvii

Getting help...........................................................................................................xviii

Comments.............................................................................................................xviii

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

1

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

HDLM Features.......................................................................................................1-3

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

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

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

LU Configuration.....................................................................................................2-5

Program Configuration............................................................................................2-6

Position of the HDLM Driver and HDLM Device..........................................................2-8

Logical Device Files for HDLM Devices......................................................................2-9

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

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

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

When Using the Lightning 9900 Series, Lightning 9900V Series, Hitachi USP,

Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000

Series, or Hitachi SMS............................................................................2-13

Load Balancing Algorithms...............................................................................2-13

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

Automatic Path Switching................................................................................2-16

Automatic Failovers...............................................................................2-16

Automatic Failbacks...............................................................................2-17

Manual Path Switching....................................................................................2-18

iii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Path Status Transition.....................................................................................2-19

The Online Path Status..........................................................................2-19

The Offline Path Status..........................................................................2-19

Status Transitions of a Path

....................................................................2-20

Intermittent Error Monitoring (Functionality When Automatic Failback Is Used).........2-21

Checking Intermittent Errors............................................................................2-22

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

Intermittent Error Monitoring Actions...............................................................2-22

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

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

When the Conditions for an Intermittent Error Are Changed During Error

Monitoring............................................................................................2-24

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

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

Error Management................................................................................................2-27

Types of Collected Logs...................................................................................2-28

Filtering of Error Information...........................................................................2-30

Collecting Error Information Using the Utility for Collecting HDLM Error Information

(DLMgetras)...................................................................................................2-31

Collecting Audit Log Data.......................................................................................2-31

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

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

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

Audit Log Data Formats...................................................................................2-37

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

Cluster Support.....................................................................................................2-40

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

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

Hosts and OSs Supported by HDLM...................................................................3-3

Storage Systems Supported by HDLM................................................................3-3

Storage Systems.....................................................................................3-3

HBAs......................................................................................................3-4

When Handling Intermediate Volumes Managed by Hitachi RapidXchange...3-5

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

Volume Manager Supported by HDLM................................................................3-6

Combinations of Cluster Software and Volume Managers Supported by HDLM.......3-7

For the Sun Cluster or VCS Environment...................................................3-7

When Creating an Oracle9i RAC Environment..........................................3-10

When Creating an Oracle RAC 10g Environment......................................3-11

When Creating an Oracle RAC 11g Environment......................................3-24

Virtualization Environments Supported by HDLM...............................................3-30

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

Memory Requirements...........................................................................3-32

Disk Capacity Requirements...................................................................3-32

The Number of Paths Supported in HDLM.........................................................3-32

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

HDLM Installation Types........................................................................................3-34

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

Notes on Hardware Settings............................................................................3-35

Notes on Installation.......................................................................................3-36

Notes on Related Software..............................................................................3-40

iv

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Notes on Command Execution.........................................................................3-41

Notes on the Disk Label

...................................................................................3-41

Installing HDLM....................................................................................................3-41

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

Performing Operations on Devices to Be Managed by HDLM.....................3-41

Apply Solaris Patches.............................................................................3-43

Set Up the Hardware.............................................................................3-43

Set Up the /kernel/drv/sd.conf File.........................................................3-44

Switch the Kernel Mode ........................................................................3-44

Set Up the /etc/system File....................................................................3-45

Set Up the /etc/syslog.conf File..............................................................3-45

Set Up VxVM.........................................................................................3-46

Set Up SDS and SVM.............................................................................3-46

Set Up Sun Cluster................................................................................3-47

Preparation for Performing an Unattended Installation of HDLM.........................3-49

Performing a New Installation of HDLM (When Sun Cluster Is Not Being Used)...3-49

Performing a New Installation of HDLM (When Sun Cluster Is Being Used).........3-56

Using the HDLM Device Unconfiguration Function When Performing a New

Installation of HDLM.......................................................................................3-66

Preparations for an Upgrade Installation or Re-installation of HDLM...................3-67

Performing an Upgrade Installation or Re-installation of HDLM...........................3-67

Installing HDLM in an LDoms Environment.......................................................3-71

Configuring a Boot Disk Environment......................................................................3-76

Overview of Configuring a Boot Disk Environment.............................................3-76

Procedure for Configuring a Boot Disk Environment...........................................3-77

Migration from an Existing HDLM Environment........................................3-77

Migration by Installing HDLM in the Existing Local Boot Disk Environment. 3-79

Migration by Installing HDLM in the Existing Boot Disk Environment..........3-81

Migration by Building a New Pre-Migration Environment...........................3-83

Setting Up the Post-Migration Environment.............................................3-85

Configuring a Boot Disk Environment for a ZFS File System......................................3-90

Boot Disk Environment that uses a ZFS File System...........................................3-90

Creating a ZFS Boot Disk Environment.............................................................3-91

Copying the local boot disk environment to the LUs (SCSI device) in the

storage system......................................................................................3-91

Replacing the ZFS boot disk environment on the SCSI device with the ZFS

boot disk environment on the HDLM device.............................................3-94

Migrating from a ZFS Boot Disk Environment to the Local Boot Disk Environment3-95

Migrating from a Boot Disk Environment to the Local Boot Disk Environment.............3-96

Configuring a Mirrored Boot Disk Environment Incorporating SVM..........................3-101

Precautions..................................................................................................3-101

Configuring a Boot Disk Environment in Which HDLM Manages the Boot Disk and

Mirroring the Environment by Using SVM........................................................3-102

Configuring a Boot Disk Environment in Which HDLM Manages the Boot Disk,

from the Local Boot Disk Environment...................................................3-102

Mirroring a Boot Disk Environment in Which HDLM Manages the Boot Disk by

Using SVM..........................................................................................3-103

Placing the Boot Disks Under HDLM Management by Installing HDLM to a Mirrored

Boot Disk Environment Incorporating SVM......................................................3-106

Installing HDLM and then Configuring the Environment..........................3-107

Placing the Boot Disks Under HDLM Management..................................3-107

Uninstalling HDLM.........................................................................................3-113

v

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Excluding the Prepared LUs from HDLM Management............................3-113

Configuring an Environment and then Uninstalling HDLM........................3-113

Checking the Path Configuration

...........................................................................3-119

Setting Up HDLM Functions..................................................................................3-120

Checking the Current Settings........................................................................3-120

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

Setting Up Load Balancing....................................................................3-121

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

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

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

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

Setting the Trace Level........................................................................3-124

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

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

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

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

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

Setting the Audit Log Facility................................................................3-127

Checking the Updated Settings......................................................................3-128

Setting up Integrated Traces................................................................................3-129

Notes on Using the Hitachi Network Objectplaza Trace Library.........................3-130

Displaying the Hitachi Network Objectplaza Trace Library setup Menu..............3-130

Changing the Size of Integrated Trace Files....................................................3-131

Changing the Number of Integrated Trace Files..............................................3-131

Changing the Buffer Size Per Monitoring Interval Duration...............................3-132

Adjusting the Number of Messages to Be Output Per Monitoring Interval..........3-133

Finishing the Hitachi Network Objectplaza Trace Library Settings......................3-134

Applying the Hitachi Network Objectplaza Trace Library Settings......................3-134

Creating File Systems for HDLM (When Volume Management Software Is Not Used)3-135

Setting Up VxVM.................................................................................................3-136

Creating a Disk Group...................................................................................3-137

Creating VxVM Volumes.................................................................................3-139

Removing Devices from VxVM........................................................................3-140

Devices to Be Removed from VxVM.......................................................3-140

Removing Devices from VxVM on a Controller Basis...............................3-142

Removing Devices From VxVM on a Path Basis......................................3-146

Actions To Be Taken if an sd or ssd Device Has Not Been Suppressed from

VxVM..................................................................................................3-150

Introducing VxVM while Using HDLM..............................................................3-154

Linking VxVM and Sun Cluster........................................................................3-154

Setting Up SDS...................................................................................................3-156

Notes...........................................................................................................3-156

Registering HDLM Devices.............................................................................3-157

To Use a Local Metadevice...................................................................3-157

To Use a Shared Diskset......................................................................3-158

Setting Up SVM...................................................................................................3-160

Notes...........................................................................................................3-160

Registering HDLM Devices.............................................................................3-161

To Use a Local Volume.........................................................................3-161

To Use a Shared Diskset......................................................................3-161

Setting Up VCS...................................................................................................3-163

Uninstalling HDLM...............................................................................................3-164

vi

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Overview of HDLM Uninstallation....................................................................3-164

Preparations for HDLM Uninstallation..............................................................3-165

Performing Operations on HDLM-Managed Devices................................3-165

Remove Sun Cluster Settings................................................................3-166

Remove VCS Settings...........................................................................3-169

Remove VxVM Settings........................................................................3-169

Remove SDS Settings...........................................................................

3-169

Remove SVM Settings..........................................................................3-170

Uninstalling HDLM.........................................................................................3-171

Uninstalling HDLM from the Local Boot Disk Environment.......................3-171

Uninstalling HDLM from the Boot Disk Environment................................3-173

Uninstalling HDLM from an LDoms Environment.....................................3-173

Settings Needed After HDLM Uninstallation.....................................................3-178

VxVM Settings.....................................................................................3-178

SDS Settings.......................................................................................3-178

SVM Settings.......................................................................................3-178

Sun Cluster Settings.............................................................................3-178

File System Settings.............................................................................3-180

Application Program Settings................................................................3-180

Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib2)..................3-180

Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib)....................3-181

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

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

Displaying Path Information..............................................................................4-2

When a Path Error is Detected...........................................................................4-2

iostat Command...............................................................................................4-2

Storage System................................................................................................4-3

Command Execution.........................................................................................4-3

Using a Sun HBA..............................................................................................4-3

Starting the Host, System, and HDLM in a Solaris 10 Environment.......................4-3

Upgrading Solaris.............................................................................................4-4

Operation in Single-User Mode..........................................................................4-4

Initializing HDLM When the Host Is Started in Single-User Mode.................4-4

Tasks that Can Be Performed in Single-User Mode.....................................4-5

Maintenance Tasks on Devices Connected by Paths in the Boot Disk Environment.4-6

HDLM Operations Using Commands.........................................................................4-6

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

Viewing Path Information..................................................................................4-6

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

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

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

Viewing LU Information.....................................................................................4-9

Displaying Corresponding Information About an HDLM Device, sd or ssd Device, and

LDEV...............................................................................................................4-9

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

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

Viewing the Operating Environment........................................................4-11

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

Viewing License Information............................................................................4-12

Updating the License.......................................................................................4-13

Viewing HDLM Version Information..................................................................4-13

vii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Viewing HDLM Component Information............................................................4-14

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

Starting the HDLM Manager

.............................................................................4-15

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

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

Changing the Configuration of the HDLM Operating Environment.............................4-16

Precautions Regarding Changes to the Configuration of an HDLM Operating

Environment...................................................................................................4-17

Changing the Configuration of a System that Uses HDLM.........................4-17

When the Path Configuration Is Changed................................................4-17

Switching the Kernel Mode.....................................................................4-19

When the Path Configuration Is Changed in a Boot Disk Environment.......4-19

Dynamic Reconfiguration (DR) for Solaris................................................4-20

Overview of Reconfiguring the HDLM Device.....................................................4-20

Reconfiguring the HDLM Device..............................................................4-20

Notes on Reconfiguring the HDLM Device................................................4-21

Adding a New Logical Unit...............................................................................4-22

Notes...................................................................................................4-22

Adding a New LU (When Not Using Sun Cluster)......................................4-23

Adding a New LU By Restarting the Nodes (When Using Sun Cluster)........4-25

Adding a New LU Via Dynamic Reconfiguration (When Using Sun Cluster). 4-31

Configuration Changes Such as Deleting a Logical Unit......................................4-36

Changing the Configuration by Restarting the Host..................................4-37

Deleting an LU via Dynamic Reconfiguration............................................4-42

Specifying Whether a Logical Unit Is To Be Managed by HDLM (When Not Using Sun

Cluster)..........................................................................................................4-43

Changing an HDLM-managed Device to a Non-HDLM-Managed Device......4-44

Changing a Non-HDLM-Managed Device to an HDLM-Managed Device......4-44

Specifying Whether a Logical Unit Is To Be Managed by HDLM (When Using Sun

Cluster)..........................................................................................................4-47

Changing an HDLM-Managed Device to a Non-HDLM-Managed Device......4-47

Changing a Non-HDLM-Managed Device to an HDLM-Managed Device (When

the Node Must Be Restarted).................................................................4-52

Changing a Non-HDLM-Managed Device to an HDLM-Managed Device (For

Dynamic Reconfiguration)......................................................................4-58

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

Information collected by using 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-3

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

Obtain Path Information....................................................................................5-5

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

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

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

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

Actions to Take for a Path Error in a Boot Disk Environment......................................5-6

Path Errors During Boot Processing....................................................................5-6

When a Path Error Occurs at the Initial Stage of Boot Processing................5-6

When a Path Error Occurs After the HDLM Driver Starts Path Processing.....5-6

Path Errors After Boot Processing Completes......................................................5-7

viii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

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

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

Obtaining Program Information.........................................................................5-8

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

Contacting Your HDLM Vendor or Maintenance Company....................................5-9

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

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

To place paths offline..............................................................................6-7

To display the format of the offline operation..........................................6-10

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

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

To place paths online.............................................................................6-11

To display the format of the online operation..........................................6-12

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

To place paths online.............................................................................6-12

To display the format of the online operation..........................................6-15

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-17

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

To set up the HDLM operating environment............................................6-17

To display the format of the set operation...............................................6-29

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

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

To display program information..............................................................6-31

To display path information....................................................................6-31

To display LU information......................................................................6-31

To display HBA port information.............................................................6-32

To display CHA port information.............................................................6-32

To display corresponding information about an HDLM device, sd or ssd device,

and LDEV..............................................................................................6-32

To display the format of the view operation.............................................6-32

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

To display program information..............................................................6-33

ix

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

To display path information....................................................................6-

38

To display LU information......................................................................6-50

To display HBA port information.............................................................6-58

To display CHA port information.............................................................6-60

To display corresponding information about an HDLM device, sd or ssd device,

and LDEV..............................................................................................6-61

To display view operation format............................................................6-62

monitor (Displays I/O Information at a Specified Interval)........................................6-63

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

To display I/O information for each HBA port..........................................6-63

To display I/O information for each CHA port..........................................6-63

To display the monitor operation format.................................................6-63

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

To display I/O information for each HBA port..........................................6-64

To display I/O information for each CHA port..........................................6-66

To display monitor operation format.......................................................6-67

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

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

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

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

Parameters......................................................................................................7-4

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

The dlmcfgmgr Utility for Managing the HDLM Configuration....................................7-15

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

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

The dlminstcomp HDLM Component Installation Utility............................................7-18

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

Parameter......................................................................................................7-18

The dlmlisthdev Utility for Assisting HDLM Transitions..............................................7-18

Format...........................................................................................................7-19

Parameters.....................................................................................................7-19

The dlmsetboot Utility for Assisting Configuration of an HDLM Boot Disk Environment7-21

Format...........................................................................................................7-21

Parameters.....................................................................................................7-21

The dlmsetconf Utility for Creating the HDLM Driver Configuration Definition File.......7-21

Format...........................................................................................................7-22

Parameters.....................................................................................................7-23

The dlmvxexclude Utility for Assisting Creation of the VxVM Configuration File...........7-26

Format...........................................................................................................7-27

Parameters.....................................................................................................7-27

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

Format...........................................................................................................7-29

Parameters.....................................................................................................7-29

Contents of the Installation-Information Settings File........................................7-29

About the Log File...........................................................................................7-35

installux.sh Utility for HDLM Common Installer........................................................7-36

Format...........................................................................................................7-36

Parameters.....................................................................................................7-36

Log file...........................................................................................................7-36

x

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

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

Components That Output Messages to Syslog.....................................................8-3

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

KAPL03001 to KAPL04000......................................................................................8-25

KAPL04001 to KAPL05000......................................................................................8-28

KAPL05001 to KAPL06000......................................................................................8-35

KAPL06001 to KAPL07000......................................................................................8-42

KAPL07001 to KAPL08000......................................................................................8-45

KAPL08001 to KAPL09000......................................................................................8-46

KAPL09001 to KAPL10000......................................................................................8-48

KAPL10001 to KAPL11000......................................................................................8-74

KAPL11001 to KAPL12000....................................................................................8-109

KAPL13001 to KAPL14000....................................................................................8-112

KAPL15001 to KAPL16000....................................................................................8-113

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

A Sun Cluster 3.2 Commands...................................................................A-1

Sun Cluster 3.2 Commands.....................................................................................A-2

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

Functional Differences Between Version 6.1 or Later and Versions Earlier Than 6.1.....B-2

Functional Differences Between Version 6.0 or Later and Versions Earlier Than 6.0.....B-2

Precautions on Differences in Functionality Between HDLM 5.6.1 or Earlier and HDLM

5.6.2 or Later.........................................................................................................B-2

Acronyms and abbreviations

Glossary

Index

xi

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

xii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Preface

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

□

Intended audience

□

Product version

□

Release notes

□

Document revision level

□

Document organization

□

Referenced documents

□

Document conventions

□

Convention for storage capacity values

□

Getting help

□

Comments

Preface

xiii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Intended audience

This manual is intended for system administrators who use Hitachi Dynamic

Link Manager (HDLM) to operate and manage storage systems. The readers

of this manual must have a basic knowledge of the following areas:

•

Solaris and its management functionality

• Storage system management functionality

• Cluster software functionality

• Volume management software functionality

Product version

This document revision applies to HDLM for Solaris version 7.2 or later.

Release notes

Release notes contain requirements and more recent product information that

may not be fully described in this manual. Be sure to review the release notes

before installation.

Document revision level

Revision Date Description

MK-92DLM114-21 November 2011 Initial Release

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 Description

1 Overview of HDLM on page

1-1

Gives an overview of HDLM, and describes its features.

2 HDLM Functions on page

2-1

Describes management targets and the system

configuration of HDLM, and the basic terms and

functions for HDLM.

3 Creating an HDLM

Environment on page 3-1

Describes the procedures for setting up an HDLM

environment and the procedure for canceling those

settings.

4 HDLM Operation on page

4-1

Describes how to use HDLM by using both the HDLM

GUI and commands, and how to manually start and

xiv

Preface

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Chapter Description

stop the HDLM manager. This chapter also describes

how to configure an environment to properly operate

HDLM, such as changing the HDLM management-target

devices that connect paths or replacing the hardware

that makes up a path. describes how to check path

information by using the Windows management tool.

5 Troubleshooting on page 5-1 Explains how to troubleshoot a path error, HDLM

failure, or any other problems that you might

encounter.

6 Command Reference on page

6-1

Describes all the HDLM commands.

7 Utility Reference on page

7-1

Describes the HDLM utilities.

8 Messages on page 8-1 Provides information about viewing messages output by

HDLM. It also lists and explains the HDLM messages

and shows the actions to be taken in response to each

message.

A Sun Cluster 3.2 Commands

on page A-1

Describes the Sun Cluster 3.2 commands.

B Functional Differences

Between Versions of HDLM on

page B-1

Gives precautions on differences in functionality

between HDLM versions.

Referenced documents

The following Hitachi referenced documents can be found on the applicable

Hitachi documentation CD:

• Hitachi Command Suite Global Link Manager Installation and

Configuration Guide, MK-95HC107

• Hitachi Command Suite Global Link Manager Messages, MK-95HC108

• Hitachi Adaptable Modular Storage Series User's Guide

• Hitachi Simple Modular Storage Series User's Guide

• Hitachi USP Series User's Guide

• Hitachi Workgroup Modular Storage Series User's Guide

• Thunder9580V Series Disk Array Subsystem User's Guide

• Hitachi Universal Storage Platform V Hitachi Universal Storage Platform

VM User and Reference Guide

• Hitachi Virtual Storage Platform Series User's Guide

• Reference Manual / File Conversion Utility & File Access Library

Document conventions

Font and symbol conventions are classified as:

Preface

xv

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

• General font conventions

•

Conventions in syntax explanations

These conventions are described below.

General font conventions

The following table lists the general font conventions:

Font Convention

Bold Bold type indicates text on a window, other than the window title. Such

text includes menus, menu options, buttons, radio box options, or

explanatory labels. For example, bold is used in sentences such as the

following:

•

From the File menu, choose Open.

• Click the Cancel button.

• In the Enter name entry box, type your name.

Italics Italics are used to indicate a placeholder for some actual text provided by

the user or system. Italics are also used for emphasis. For example:

• Write the command as follows:

copy source-file target-file

• Do not delete the configuration file.

Code font

A code font indicates text that the user enters without change, or text

(such as messages) output by the system. For example:

•

At the prompt, enter dir.

• Use the send command to send mail.

• The following message is displayed:

The password is incorrect.

Code examples and messages appear as follows (though there may be some

exceptions, such as when the code is part of a diagram):

MakeDatabase

...

StoreDatabase temp DB32

In examples of coding, an ellipsis (...) indicates that one or more lines of

coding are not shown for purposes of brevity.

Conventions in syntax explanations

Syntax

definitions appear as follows:

StoreDatabase [temp|

perm] (database-name ...)

The following table lists the conventions used in syntax explanations:

Example font or

symbol

Convention

StoreDatabase

Code-font characters must be entered exactly as shown.

xvi

Preface

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Example font or

symbol

Convention

database-name This font style marks a placeholder that indicates where

appropriate characters are to be entered in an actual

command.

SD Bold code-font characters indicate the abbreviation for a

command.

perm

Underlined characters indicate the default value.

[ ]

Square brackets enclose an item or set of items whose

specification is optional. An item that is underlined is specified

when other items are omitted.

{ }

One of the options enclosed in { } must be specified.

| Only one of the options separated by a vertical bar can be

specified at the same time.

...

An ellipsis (...) indicates that the item or items enclosed in ( )

or [ ] immediately preceding the ellipsis may be specified as

many times as necessary.

()

Parentheses indicate the range of items to which the vertical

bar (|) or ellipsis (...) is applicable.

#

A prompt on a command-execution window.

Convention for storage capacity values

Physical storage capacity values (e.g., drive capacity) are calculated based on

the following values:

Physical capacity unit Value

1 kilobyte (KB)

1,000 (10

3

) bytes

1 megabyte (MB)

1,000 KB or 1,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 storage capacity values (e.g., logical device capacity) are calculated

based on the following values:

Logical capacity unit Value

1 block 512 bytes

1 KB

1,024 (2

10

) bytes

Preface

xvii

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Logical capacity unit Value

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

Getting help

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 Portal for contact information: https://hdssupport.hds.com

Comments

Please send us your comments on this document:

[email protected].

Include the document title, number, and revision, and refer to specific

sections and paragraphs whenever possible. All comments become the

property of Hitachi Data Systems Corporation.

Thank you!

xviii

Preface

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

1

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

1-1

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

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.

Figure 1-1 Connections between hosts and storage systems on page 1-2

illustrates the connections between various hosts and storage systems. A

server on which HDLM is installed is called a host.

Figure 1-1 Connections between hosts and storage systems

HDLM supports the following storage systems.

•

Hitachi AMS2000/AMS/WMS/SMS series

• Hitachi USP

• Lightning 9900 Series

• Lightning 9900V Series

• Thunder 9500V Series

• Universal Storage Platform V/VM

• Virtual Storage Platform

1-2

Overview of HDLM

Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Hitachi Dynamic Link Manager, HPE XP P9500 User manual

Related papers

Other documents