Hitachi HPE XP P9500 User manual

Hitachi Command Suite
Dynamic Link Manager Software
User Guide (for Solaris(R))
MK-92DLM114-21
Document Organization
Product Version
Getting Help
Contents

© 2011 Hitachi, Ltd., Hitachi Data Systems Corporation. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or by any means,
electronic or mechanical, including photocopying and recording, or stored in a database or retrieval
system for 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 (103) bytes
1 megabyte (MB) 1,000 KB or 1,0002 bytes
1 gigabyte (GB) 1,000 MB or 1,0003 bytes
1 terabyte (TB) 1,000 GB or 1,0004 bytes
1 petabyte (PB) 1,000 TB or 1,0005 bytes
1 exabyte (EB) 1,000 PB or 1,0006 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 (210) bytes
Preface xvii
Hitachi Dynamic Link Manager User Guide (for Solaris(R))

Logical capacity unit Value
1 MB 1,024 KB or 1,0242 bytes
1 GB 1,024 MB or 1,0243 bytes
1 TB 1,024 GB or 1,0244 bytes
1 PB 1,024 TB or 1,0245 bytes
1 EB 1,024 PB or 1,0246 bytes
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))