Home » HP Manuals » Storage Devices » HP XP P9500 » Manual Viewer

HP XP P9500 Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 92

Parameters, AutoPATH_ID

Add to My Manuals
Save this manual to your list of manuals

Page 92 highlights

Parameters To place paths Online -path Indicates that the target of the operation is a path managed by HDLM. This parameter is optional because online is always used for paths, so it is assumed. Specify the paths to be taken online by using the -cha, -pathid, or hbaportwwn parameter. If you do not specify any of these parameters, the command will place all the offline paths online. If there is a path that cannot be placed online, a message asks whether you would like to continue processing. To ignore the offline path that cannot be placed online and to continue processing, enter y. To stop the processing, enter n. -cha -pathid AutoPATH_ID Use this parameter to place online, at one time, all the paths that pass through a specific CHA port. The command will place online all the paths that pass through the CHA port to which the path with the specified AutoPATH_ID is connected. Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see view (Displays Information) on page 6-22. Leading zeros can be omitted (000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value. AutoPATH_IDs are re-assigned every time the host is restarted. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the online operation. Example The following example shows how to place online the paths connected to the CHA port 0A. In this example, a path whose AutoPATH_ID is 000002 is connected to the target CHA port: When the confirmation message is displayed, the user enters y to continue, or n to cancel the operation. >dlnkmgr online -cha -pathid 000002 KAPL01057-I All the paths which pass the specified CHA port will be changed to the Online status. Is this OK? [y/n]:y KAPL01061-I 2 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online > -pathid AutoPATH_ID Use this parameter to place a single path online. Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see view (Displays Information) on page 6-22. Leading zeros can be omitted 6-12 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R))

Section	Page
User Guide (for VMware(R))	1
Contents	3
Preface	9
Intended audience	10
Product version	10
Release notes	10
Document revision level	10
Document organization	10
Referenced documents	11
Document conventions	11
Convention for storage capacity values	13
Getting help	13
Comments	14
Overview of HDLM	15
What is HDLM?	16
HDLM Features	17
HDLM Functions	19
Devices Managed by HDLM	20
System Configuration	20
LU Configuration	21
Program Configuration	22
HDLM driver and NMP positions	23
Distributing a Load Using Load Balancing	24
Paths to Which Load Balancing Is Applied	26
Load Balancing Algorithms	27
Performing Failovers and Failbacks Using Path Switching	29
Automatic Path Switching	29
Manual Path Switching	31
Path Status Transition	32
Monitoring Intermittent Errors	34
Checking Intermittent Errors	34
Setting Up Intermittent Error Monitoring	34
Intermittent Error Monitoring Actions	35
When a User Changes the Intermittent Error Information	37
Detecting Errors by Using Path Health Checking	39
Error Management	39
Types of Collected Logs	40
Collecting Error Information Using the Utility for Collecting HDLM Error Information (DLMgetras)	41
Collecting Audit Log Data	41
Categories and Audit Events that HDLM Can Output to the Audit Log	43
Requirements for Outputting Audit Log Data	44
Destination and Filtering of Audit Log Data	45
Audit Log Data Formats	45
Creating an HDLM Environment	49
HDLM System Requirements	50
Hosts and OSs Supported by HDLM	50
Storage Systems Supported by HDLM	50
Memory and Disk Capacity Requirements	51
Number of Paths Supported in HDLM	51
Flow for Creating an HDLM Environment	52
HDLM Installation Types	52
Notes on Creating an HDLM Environment	52
Installing HDLM	53
Performing a New Installation of HDLM	53
Performing a Re-installation of HDLM	56
Checking the Path Configuration	56
Setting Up HDLM	57
Checking the Current Settings	57
Setting Up the HDLM Functions	58
Checking the Updated Settings	60
Setting Up Integrated Traces	61
Uninstalling HDLM	63
Preparations for HDLM Uninstallation	63
Uninstalling HDLM	64
HDLM Operation	67
HDLM Operations Using Commands	68
Notes on Using Commands	68
Viewing Path Information	68
Changing the Status of Paths	69
Viewing LU Information	70
Initializing Statistical Information for Paths	71
Viewing and Setting Up the Operating Environment	71
Viewing License Information	72
Updating the License	73
Viewing HDLM Version Information	73
Troubleshooting	75
Information Collected by the DLMgetras Utility for Collecting HDLM Error Information	76
Checking Error Information in Messages	76
What To Do for a Path Error	76
Examining the Messages	78
Obtain Path Information	78
Identifying the Error Path	78
Narrowing Down the Hardware That Might Have Caused the Error	78
Identifying the Error Location and Correcting any Hardware Error	78
Placing the Path Online	78
What To Do for a Program Error	79
Examining the Messages	79
Obtaining Program Information	79
What To Do for the Program Error	80
Contacting your HDLM Vendor or Maintenance Company	80
What To Do for Other Errors	80
Command Reference	81
Overview of the HDLM Command dlnkmgr	82
clear (Returns the Path Statistics to the Initial Value)	83
Format	83
Parameters	84
help (Displays the Operation Format)	85
Format	85
Parameter	85
offline (Places Paths Offline)	87
Format	88
Parameters	88
online (Places Paths Online)	91
Format	91
Parameters	92
set (Sets Up the Operating Environment)	95
Format	95
Parameters	96
view (Displays Information)	102
Format	102
Parameters (To display program information)	104
Utility Reference	129
The DLMgetras Utility for Collecting HDLM Error Information	130
Format	130
Parameters	130
List of Collected Error Information	131
Messages	135
Before Viewing the List of Messages	136
Format and Meaning of Message IDs	136
Terms Used in Messages and Message Explanations	136
KAPL01001 to KAPL02000	137
KAPL09001 to KAPL10000	157
KAPL10001 to KAPL11000	158
KAPL13001 to KAPL14000	163
KAPL15001 to KAPL16000	164
KAPL20001 to KAPL21000	165
KAPL21001 to KAPL22000	169
Acronyms and abbreviations	171
Glossary	177

Match case Limit results 1 per page

Parameters

To place paths Online

-path

Indicates that the target of the operation is a path managed by HDLM.

This parameter is optional because

online

is always used for paths, so it

is assumed.

Specify the paths to be taken online by using the

-cha

-pathid

, or

hbaportwwn

parameter. If you do not specify any of these parameters,

the command will place all the offline paths online. If there is a path that

cannot be placed online, a message asks whether you would like to

continue processing. To ignore the offline path that cannot be placed

online and to continue processing, enter

. To stop the processing, enter

-cha -pathid

AutoPATH_ID

Use this parameter to place online, at one time, all the paths that pass

through a specific CHA port. The command will place online all the paths

that pass through the CHA port to which the path with the specified

AutoPATH_ID

is connected.

Specify the current AutoPATH_ID of the target path, which is displayed by

using the

view

operation. For details about the

view

operation, see

view

(Displays Information) on page

. Leading zeros can be omitted

(

000001

and

indicate the same

AutoPATH_ID

); however, when the

target AutoPATH_ID is

000000

, enter

000000

for the parameter

value.

AutoPATH_IDs are re-assigned every time the host is restarted. Always

make sure that you use the

view

operation to find the current

AutoPATH_ID of the target path, before executing the

online

operation.

Example

The following example shows how to place online the paths connected

to the CHA port

. In this example, a path whose AutoPATH_ID is

000002

is connected to the target CHA port:

When the confirmation message is displayed, the user enters

continue, or

to cancel the operation.

>dlnkmgr online -cha -pathid 000002

KAPL01057-I All the paths which pass the specified CHA port

will be changed to the Online status. Is this OK? [y/n]:y

KAPL01061-I 2 path(s) were successfully placed Online; 0

path(s) were not. Operation name = online

-pathid

AutoPATH_ID

Use this parameter to place a single path online.

Specify the current AutoPATH_ID of the target path, which is displayed by

using the

view

operation. For details about the

view

operation, see

view

(Displays Information) on page

. Leading zeros can be omitted

6-12

Command Reference

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