HP XP P9500 Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52
HP XP P9500 Manual
View all HP XP P9500 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP XP P9500 manual content summary:
- HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 1
Hitachi Command Suite Dynamic Link Manager Software User Guide (for VMware(R)) Document Organization Product Version Getting Help Contents MK-92DLM130-00 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 2
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 VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 3
notes...x Document revision level x Document organization x Referenced documents xi Document conventions xi Convention for storage capacity values xiii Getting help...xiii Comments...xiv 1 Overview of HDLM 1-1 What is HDLM?...1-2 HDLM Features...1-3 2 HDLM Functions 2-1 Devices Managed by - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 4
Supported by HDLM 3-2 Host OS support 3-2 Remote management client OS support 3-2 Storage Systems Supported by HDLM 3-2 Memory and Disk Capacity Requirements 3-3 Memory Requirements 3-3 Disk Requirements 3-3 Number of Paths Supported iv Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 5
from a remote management client 3-17 Performing an unattended uninstallation of HDLM on a remote management client Viewing HDLM Version Information 4-7 5 Troubleshooting 5-1 Information Collected by the DLMgetras the Operation Format 6-5 v Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 6
6-15 Format...6-15 To Set the Host Operating Environment 6-15 To Set the Remote Management Client Operating Environment 6-15 To Display the Format of the Set Operation 6- 8-2 KAPL01001 to KAPL02000 8-3 KAPL09001 to KAPL10000 8-23 vi Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 7
KAPL10001 to KAPL11000 8-24 KAPL13001 to KAPL14000 8-29 KAPL15001 to KAPL16000 8-30 KAPL20001 to KAPL21000 8-31 KAPL21001 to KAPL22000 8-35 Acronyms and abbreviations Glossary Index vii Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 8
viii Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 9
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 ix Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 10
settings. 4 HDLM Operation on page 4-1 Explains how to operate HDLM using the HDLM command. 5 Troubleshooting on page 5-1 Explains how to troubleshoot a path error, HDLM failure, or any other problems that you might encounter. x Preface Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 11
Storage Series User's Guide • Hitachi Simple Modular Storage Series User's Guide • Hitachi Workgroup Modular Storage Series User's Guide • Universal Storage Platform V Series User's Guide • Universal Storage Platform VM Series User's Guide • Virtual Storage Platform Series User's Guide Document - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 12
-file target-file • Do not delete the configuration file. A code font indicates text that the user enters without change, or text (such as messages) output by the system. For example: • bar (|) or ellipsis (...) is applicable. xii Preface Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 13
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 Preface xiii Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 14
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! xiv Preface Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 15
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 describes its features. □ What is HDLM? □ HDLM Features Overview of HDLM 1-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 16
a remote management client. Figure 1-1 Connections Between Hosts and Storage systems HDLM supports the following storage systems. • Hitachi AMS2000/AMS/WMS/SMS series • Universal Storage Platform V/VM • Virtual Storage Platform 1-2 Overview of HDLM Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 17
that is currently being used. This allows operations to continue between a host and a storage system. For details on performing failovers, see Performing Failovers and Failbacks Using Path Switching on vSphere ESXi. Overview of HDLM 1-3 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 18
1-4 Overview of HDLM Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 19
including the main ones: load distribution across paths and path switching. □ Devices Managed by HDLM □ System Configuration □ LU Configuration □ Program Configuration □ HDLM □ Error Management □ Collecting Audit Log Data HDLM Functions 2-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 20
devices ¢ Hitachi storage system command devices, such as Hitachi RAID Manager command devices Non-HDLM management-target devices: ¢ SCSI devices other than those that are in the storage systems listed in Section What is HDLM? on page 1-2 ¢ Built-in disks on a host ¢ Non-disk devices (tape devices - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 21
a channel adapter. This serves as a cable port on a storage subsystem. A logical unit (a logical volume defined on the storage subsystem). This serves as the target of input or output operations the installation of HDLM. HDLM Functions 2-3 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 22
for each LU in the storage system. A Dev in an LU that the host recognizes via the HDLM driver. This type of Dev is called a host device. Program Configuration HDLM is actually the configuration of the HDLM programs. 2-4 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 23
driver, causing each application on a guest OS to access LUs in the storage system via the HDLM driver and NMP. Figure 2-4 Positioning of HDLM Driver and NMP on page 2-6 shows the positioning of the HDLM driver and NMP HDLM Functions 2-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 24
not necessarily allocate data to every available path. RAID Manager issuing IOCTL to a command device is an example of an I/O operation that cannot allocate data to every path. Figure the same LU by multiple applications. 2-6 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 25
When the load balancing function is not used, I/O operations converge onto a single path (A). The load on that one path (A) will cause a bottleneck, which might cause problems with system performance. HDLM Functions 2-7 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 26
in preference to a non-owner path. In order to prevent system performance from slowing down, HDLM does not perform load balancing between owner paths and non-owner paths. If failures occur across some of the owner paths, 2-8 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 27
accessed from the only other owner path (B). When both of the owner paths (A and B) cannot be used, the load is then balanced between two other, nonowner paths (C and D). Figure 2-7 Overview of Load Balancing When Using the Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 28
balancing algorithm most suitable for the data access patterns of your system environment. However, if there are no recognizable data access patterns, we recommend using the default algorithm Environment) on page 6-15. 2-10 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 29
. Two types of failovers and failbacks are available: • Automatic failovers and failbacks • Manual failovers and failbacks Failovers and failbacks switch which path is being used and also change of Message IDs on page 8-2.. HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-11 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 30
two paths (C or D) connected to CHA1. When the Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS is being used, all the paths are owner paths. This means that all the paths that are accessing the same LU are possible switching destinations. For example - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 31
will be automatically switched over from the non-owner path to the owner path that just recovered from the error. When the Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS is being used, all the paths are owner paths. As a result, if the path that was - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 32
owner paths, and then from the online nonowner paths. When the Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS is being used, all the paths that access occurred in the path. 2-14 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 33
operation: Online operation performed by executing the dlnkmgr command's online operation. Offline operation: Offline operation performed by executing the dlnkmgr command's offline operation. HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-15 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 34
online path for each LU cannot be placed offline by executing the offline operation. This ensures access to the LU. For details on the offline operation, see offline (Places Paths Offline) 3 or more times in 30 minutes. 2-16 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 35
events that occur are described by using the time arrows. Figure 2-10 Action What Will Happen When an Intermittent Error Occurs on a Path HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-17 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 36
an intermittent error. In such a case, remove the cause of the error, and then manually place the path online. When the Conditions for an Intermittent Error Are Changed During Error Monitoring of time that has passed 2-18 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 37
about whether an intermittent error has occurred. Table 2-6 When Effects of a User Changing the Intermittent Error Information on page 2-20 lists whether the above items intermittent error monitoring is being performed. HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-19 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 38
2-20 Table 2-6 When Effects of a User Changing the Intermittent Error Information User operation Number of errors and time passed since error monitoring monitoring function off, change the target paths to Offline(C). #2 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 39
Error Management For troubleshooting purposes, HDLM collects information and stores it into log files. Figure 2-13 Flow of Data When Collecting Error Information on page 2-22 shows the flow of data when collecting error information. HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 40
HDLM, such as for the SCSI driver. For more details, see the VMware vSphere documentation. Types of Collected Logs HDLM collects information on detected error and stores it into the file path is /var/ log/vmkernel.log. 2-22 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 41
(service processors), and Hitachi Command Suite products An abnormal hardware or software event, including: • Hardware errors • Software errors (such as memory errors) An event indicating the linkage status between devices: • Link up or link down HDLM Functions Hitachi Dynamic Link Manager User - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 42
succeeded or failed, including: • Device access control • Administrator or end-user access control An event indicating that an attempt to access critical data has succeeded or failed, including: • Access to a critical file on a NAS or content access when HTTP is supported • Access to the audit log - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 43
flood attack or protocol violation for a normally used port • Access to an unused port (such as port scanning) The categories 4 KAPL15111-W 6 KAPL15101-I 4 KAPL15102-W 6 KAPL15103-I 4 KAPL15104-W 6 KAPL15105-I HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-25 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 44
data when all of the following conditions are satisfied: • The Event Log service is running on the remote management client. • The output of audit log data has been enabled by ¢ Severity: 6 (Error, Warning, or Information) 2-26 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 45
Filtering of Audit Log Data Audit log data is output to event logs of the remote management client. You can also filter the audit log output by specifying a severity level tool on the remote management client: HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-27 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 46
Location identification Location identification information information FQDN Fully qualified domain name Redundancy identification information Redundancy identification information Agent information Agent information 2-28 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 47
.6+09:00,HDLMCommand,hostname=moon,Configur ationAccess,Success,uid=root Information about HDLM-management targets was successfully displayed. Command Line = dlnkmgr view -path " HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) 2-29 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 48
2-30 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 49
□ Notes on Creating an HDLM Environment □ Installing HDLM □ Checking the Path Configuration □ Setting Up HDLM □ Setting Up Integrated Traces □ Uninstalling HDLM Creating an HDLM Environment 3-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 50
systems: • Hitachi AMS2000/AMS/WMS/SMS series • Hitachi Universal Storage Platform V • Hitachi Universal Storage Platform VM • Hitachi Virtual Storage Platform • HP StorageWorks P9500 Disk Array • HP XP20000/HP XP24000 3-2 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 51
settings required for using HDLM, see the maintenance documentation for storage systems. Memory and Disk Capacity Requirements This section describes memory and disk capacity requirements. Memory Requirements A host requires 10 MB of memory. A remote management client requires 20 MB of memory - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 52
all HBAs that are on a single host and connected to HDLMmanaged disks are of the same type and have the same microprogram version. If and Windows versions of HDLM cannot coexist on the same remote management client. • If you install HDLM for the Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 53
been installed on the host, and the host and the storage system are connected in a multi-path configuration. You can install HDLM on the remote management client by using an unattended installation. An unattended installation enables a user to install HDLM without entering information. To perform an - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 54
and Windows Vista support User Account Control (UAC). Therefore, if you execute the installer as a user other than Administrator, you might be asked for administrator permissions. If you are asked for administrator permissions, respond to the displayed dialog box. 5. Follow the instructions shown in - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 55
used to install HDLM on a host. If the VMware vSphere CLI is not installed on the remote management client, install it and confirm that it can be used to connect to the host before the host acceptance level: Creating an HDLM Environment 3-7 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 56
esxcli --server=host-name --username=user-name -password=password storage nmp satp rule list | HDLM from the host and remote management client by following the directions in devices that have more than one active path. After 3-8 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 57
are accessing remote Service Pack Version : Load Balance : on(extended lio) Intermittent Error Monitor : off KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss Creating an HDLM Environment 3-9 Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 58
following is an example of using a command to set load balancing. >dlnkmgr -s host-name -u user-name -p password set -lb on -lbtype exlio If you want to change the load balancing Robin algorithm (VMware) 3-10 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 59
of using a command to enable intermittent error monitoring: >dlnkmgr -s host-name -u user-name -p password set -iem on -intvl 20 -iemnum 2 To enable intermittent error level audit log data is collected. 1 2 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for VMware(R)) 3-11 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 60
xx Service Pack Version : Load Balance : on(extended lio) Intermittent Error Monitor : on(2/20) KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > 3-12 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 61
# \HITACHI\HNTRLib2\spool\hntr2n.log(where n indicates a file number)) of the Hitachi Network Objectplaza Trace Library (HNTRLib2) installed on the remote management (KB) 8 5 (seconds) 256 (KB) 0 (seconds) Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for VMware(R)) 3-13 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 62
. 3-14 Figure 3-2 Hitachi Network Objectplaza Trace Utility 2 Release 2.0 Dialog Box. 2. In Number of Files, change the number of integrated trace files. The default is 4. You can specify a value from 1 to 16. Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 63
every Hitachi program product that uses the Hitachi Network Objectplaza Trace Library, or restart the remote management device. • Shut down any application processes and services, such as DBMS, that use a path managed by HDLM. Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 64
a remote management user-name -password=password software acceptance set --level=acceptancelevel 6. Restart the host. 7. Execute the following command to check the list of devices. Check the management-target devices of HDLM. 3-16 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 65
-name --username=user-name -password=password storage nmp device list : : naa.60060e8006cf2e000000cf2e00000039 Device Display Name: HITACHI Fibre Channel Disk (naa. 60060e8006cf2e000000cf2e00000039) Storage Array Type: VMW_SATP_LOCAL Storage Array Type Device Config: {device config options } Path - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 66
From Control Panel, choose Programs and Features, and then make sure that Dynamic Link Manager for VMware is not displayed in the list of programs. 3-18 Creating an HDLM Environment Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 67
includes how to operate HDLM and the HDLM manager, and how to change the configuration of the operating environment. □ HDLM Operations Using Commands HDLM Operation 4-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 68
specified. The following example shows how to execute the command: >dlnkmgr -s host-name -u user-name -p password view -path To display information only for the paths accessing the specified host device, execute the dlnkmgr command's view operation with the -path and -hdev parameters specified. The - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 69
. The following is an example of executing the command: >dlnkmgr -s host-name -u user-name -p password view -path Changing the Status of Paths to Offline(C) 1. Check the -s host-name -u user-name -p password view -path HDLM Operation 4-3 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 70
status. Is this OK? [y/n]:y KAPL01053-I If you are sure that there would be no problem when the path is placed in the Offline(C) status, enter y. Otherwise, enter n. [y/n]:y view (Displays Information) on page 6-22. 4-4 HDLM Operation Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 71
: x.x.x-xx Service Pack Version : Load Balance : on(extended lio) Intermittent Error Monitor : off KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > HDLM Operation 4-5 Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 72
the command. The following is an example of executing the command: >dlnkmgr -s host-name -u user-name -p password set -lb on -lbtype exrr KAPL01049-I Would you like to execute the operation? of executing the command: 4-6 HDLM Operation Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 73
HDLM version information, execute the dlnkmgr command's view operation with the -sys parameter specified. The following is an example of executing the command: HDLM Operation 4-7 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 74
Service Pack Version : License Type Expiration Permanent - KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > The value displayed in HDLM version indicates the HDLM version. 4-8 HDLM Operation Hitachi Dynamic Link Manager User - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 75
5 Troubleshooting This chapter describes how to properly use HDLM error information, and then how to resolve the problem, if an error has occurred in HDLM. The Do for a Program Error □ What To Do for Other Errors Troubleshooting 5-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 76
error has occurred in the components that make up the path. Figure 5-1 Error Location When the KAPL20023-E Message Is Output on page 5-3 indicates these components. 5-2 Troubleshooting Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 77
the troubleshooting procedure when the KAPL20023-E message is output. Figure 5-2 Troubleshooting Procedure When a Path Error Occurs The following shows the procedure for using the HDLM command (dlnkmgr) to handle a path error. Troubleshooting 5-3 Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 78
the information provided by the storage-system management program. Identifying location, and then resolve the problem. For hardware maintenance, contact your remote management client: >dlnkmgr -s host-name -u user-name -p password online 5-4 Troubleshooting Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 79
and resolve the problem. What To Do for a Program Error The following describes what to do to handle errors that occur in an HDLM program. Figure 5-3 Troubleshooting Procedure When a HDLM Error Information on page 7-2. Troubleshooting 5-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 80
problem. For details on the view operation, see view (Displays Information) on page 6-22. Execute the following command from the remote management client: >dlnkmgr -s host-name -u user- HDLM Error Information on page 7-2. 5-6 Troubleshooting Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 81
Value) □ help (Displays the Operation Format) □ offline (Places Paths Offline) □ online (Places Paths Online) □ set (Sets Up the Operating Environment) □ view (Displays Information) Command Reference 6-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 82
: ¢ VI_SERVER: Host name ¢ VI_USERNAME: User name ¢ VI_PASSWORD: Password Operations of the dlnkmgr command Table 6-1 Operations of the dlnkmgr Command on page 6-3 shows the operations of dlnkmgr and their functions. 6-2 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 83
command from the VMware vSphere CLI on the remote management client. ¢ To specify a value user-name -p password] clear -pdst [-s] To display the format of the clear operation dlnkmgr [-s host-name -u user-name -p password] clear -help Command Reference 6-3 Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 84
URL | --url=URL ] [ -s SERVER | --server=SERVER ] [ -t CACERTSFILE | --cacertsfile=CACERTSFILE ] [ -u USERNAME | --username=USERNAME ] [ --credstore=CREDSTORE ] [ --passthroughauthpackage=PASSTHROUGHAUTHPACKAGE ] 6-4 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 85
the format of individual operations. Format dlnkmgr [-s host-name -u user-name -p password] help [operation] [operation] ... Parameter [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --sessionfile=SESSIONFILE ] Command Reference 6-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 86
-Options] offline [-path] -cha -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] offline [-path] -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] offline [-path] -hbaportwwn HBA_Port_WWN [-s] 6-6 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 87
port, single path, or HBA port WWN. There must always be at least one online path accessing each LU. Placing too many paths offline might prevent paths from being able to switch if an Displays Information) on page 6-22. Command Reference 6-7 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 88
To Display the Format of the offline Operation dlnkmgr [-s host-name -u user-name -p password] offline -help Parameters To place paths Offline -path , the user enters y to continue, or n to cancel the operation. 6-8 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 89
there would be no problem when the path is placed in the Offline(C) status, enter y. Otherwise, enter n. [y/n]: y KAPL01061-I 1 path(s) were successfully placed Offline(C); 0 path(s) were not. Operation name = offline Command Reference 6-9 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 90
AutoPATH_ID is 000001, offline without asking for confirmation of command execution from the user: >dlnkmgr offline -pathid 1 -s KAPL01061-I 1 path(s) were successfully placed ] [ --servicepath=SERVICEPATH ] 6-10 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 91
-name -p password] online [-path] |-cha -pathid AutoPATH_ID |-pathid AutoPATH_ID |-hbaportwwn HBA-port-WWN] [-s] To Display the Format of the Online Operation dlnkmgr [-s host-name -u user-name -p password] online -help Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-11 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 92
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 Leading zeros can be omitted 6-12 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 93
is 000002, online without asking for confirmation of command execution from the user: >dlnkmgr online -pathid 2 -s KAPL01061-I 1 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online > Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-13 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 94
port. Example The following example shows how to filter and display the information on all paths that pass through the CHA port 0A of the Hitachi AMS: 6-14 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 95
: dlnkmgr set -help To display the format of the operation for a host: dlnkmgr -s host-name -u user-name -p password set -help To display the format of the operation for a remote management client: dlnkmgr -l set -help Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-15 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 96
to 3. ¢ When the intermittent error monitoring interval or the number of times that the error is to occur has been specified before: 6-16 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 97
though you do not change the conditions for intermittent error monitoring,the number of errors and the time that has passed since the Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-17 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 98
you want to execute the command in a shell script or batch file. To Set the Remote Management Client Operating Environment -lic Specify this option for when a license is updated. The HDLM an emergency license key. # 6-18 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 99
Data Collection Levels Value (severity) Explanation 0 Error-level audit log data is collected. 1 2 3 4 Error-level and Warning-level audit log data is collected. 5 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-19 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 100
The following example displays the format of the operation for both a host and remote management client: >dlnkmgr set -help set: Format dlnkmgr [Host-Connection-Options] -l set { -lic | -audlog on [ -audlv AudlogLevel ] 6-20 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 101
the format of the operation for a host: >dlnkmgr -s host-name -u user-name -p password set -help set: Format dlnkmgr [Host-Connection-Options] set USERNAME | --username=USERNAME ] [ --credstore=CREDSTORE ] Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-21 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 102
. Format To Display Program Information for a Host dlnkmgr [-s host-name -u user-name -p password] view -sys [-sfunc|-satp|-rule] [-t] To Display Program Information for a Remote Management Client dlnkmgr -l view -sys 6-22 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 103
hdev host-device-name|-pathid AutoPATH_ID] [-t] To display LU information (by selecting items to be displayed) dlnkmgr [-s host-name -u user-name -p password] view -lu -item [ [slpr] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] Command Reference Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 104
]|all] [-hdev host-device-name|-pathid AutoPATH_ID] [-t] To display a summary of LU information dlnkmgr [-s host-name -u user-name -p password] view -lu -c [-t] To Display the Format of the view Operation To display the format of the operation for both a host and remote management client: dlnkmgr - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 105
Description -sfunc HDLM Version Information about the HDLM function settings Service Pack Version Load Balance Intermittent Error Monitor -satp Information about : The Extended Round Robin algorithm Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-25 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 106
. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > Example 3 The following example displays SATP claim rules: >dlnkmgr view -sys -rule Vendor Model HITACHI DF600F HITACHI ^OPEN-* HP ^OPEN-* Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 107
the version and license information for HDLM on the remote management client. Table 6-7 Items of program information (for remote management clients) on page 6-27 shows the parameters level that has been set is displayed Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-27 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 108
information for HDLM functions on a remote management client: >dlnkmgr -l view -sys HDLM Version : x.x.x-xx Service Pack Version : License Type Expiration the audit log settings: >dlnkmgr -l view -sys -audlog Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 109
device-name Displays information only for the paths accessing the specified host device. The host-device-name string is case-sensitive. -stname Use this parameter to display the model ID of the storage sorting keys. Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-29 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 110
specify the second sorting key are: • pn: Path name • lu: LU number of the storage system • cp: Port number of the CHA When the -srt parameter is omitted, the path path information, by selecting a display item -path -item Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 111
IEP VmRuntimeName VmState VmPathUID None pn hbaportwwn dn lu cp None type ic ie dnu hd iep vmruntimename vmstate vmpathuid # Because both PathID and Status are always displayed, you do . These sub-parameters are: Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-31 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 112
for the paths accessing the specified host device. The host-device-name string is case-sensitive. When you specify this parameter, HDevName is displayed by default. It is not necessary to specify hd for the -item parameter. -stname Use this parameter to display the model ID of the storage system in - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 113
is omitted, the command displays the product ID or emulation type of the storage system instead. For details about the information about product IDs, see Table 6- of the storage system • cp: Port number of the CHA Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-33 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 114
displayed: The user specifies the -path -c parameter. Table 6-9 Path Information Displayed Item No summary displayed Summary displayed Description Paths Total number of displayed paths, indicated by a decimal number. 6-34 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 115
and resolve the problem for any paths storage system that is accessed by a path. A storage system name consists of the following three elements, separated by periods: • Vendor ID: The name of the storage system vendor (for example, HITACHI). Command Reference Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 116
require corrective action. The appropriate action can be determined by referring to What To Do for a Path Error on page 5-2. Attribute of the path • Own: Owner path • Non: Non-owner path 6-36 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 117
Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS, all paths are owner 0 is displayed. Host device name. Information about the storage system. This item is displayed only when you specify the - Command Reference Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 118
(example: 000000000000003A) Host LU number(example: 0005) Host ID (host port number) Channel number (bus number) Target ID Lun (host LU number) 6-38 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 119
model name) Hitachi AMS2000 series Hitachi AMS Hitachi SMS Hitachi WMS • Hitachi Universal Storage Platform V • Hitachi Universal Storage Platform VM Hitachi Virtual Storage Platform P9500 HP XP20000 HP XP24000 product identifier# Emulation type# AMS AMS SMS WMS USP_V VSP P9500 XP20000 XP24000 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 120
-name Displays information only for the paths accessing the specified host device. The host-device-name string is case-sensitive. -pathid AutoPATH_ID Use this specified after the -item parameter SLPR PathName slpr pn Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 121
sub-parameters are: -hdev host-device-name Displays information only for the paths accessing the specified host device. The host-device-name string is case-sensitive. VmPSP VmRuntimeName ChaPort Status VmState PathID Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-41 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 122
the -lu parameter. • Summary displayed: The user specifies the -lu -c parameter. Table 6-13 LU Information Displayed item No summary displayed Summary displayed Description Product Model ID of the storage system Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 123
to which an LU belongs, indicated by a number from 0 to 31. A hyphen (-) is displayed if the storage logical partition functionality for the storage system for the target LU is not supported. Host device name. The AutoPATH_ID. AutoPATH_ID is assigned every time the host is restarted. The path name - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 124
path • Own: Owner path • Non: Non-owner path When connecting to Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS, all paths are owner paths. Total I/O be displayed is 232 - 1 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 125
managed by VMware vSphere. The path status managed by VMware vSphere. • active: Online • standby: Online • off: Offline status caused by a command operation (Offline(C)) Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-45 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 126
operation format. Examples Example 1 The following example displays the format of the operation for both a host and remote management client: >dlnkmgr view -help view: Format dlnkmgr [Host-Connection-Options] view -sys 6-46 Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 127
-path -item [pn] [dn] [lu] [cp] [type] [ic] [ie] [dnu] [hd] [iep] [hbaportwwn] [vmruntimename] [vmstate] [vmpathuid] [ -hdev HostDeviceName ] [-stname] [-srt { view -lu [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t] Command Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) 6-47 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 128
for a remote management client: >dlnkmgr -l view -help view: Format dlnkmgr -l view -sys [ -lic | -audlog ] [-t] KAPL01001-I The HDLM command completed normally. Operation name = help, completion time = yyyy/mm/dd hh:mm:ss > 6-48 Command Reference Hitachi Dynamic Link Manager User Guide (for - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 129
7 Utility Reference This chapter explains the utilities used by HDLM. □ The DLMgetras Utility for Collecting HDLM Error Information Utility Reference 7-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 130
. Format Execute this utility from the remote management client, in the following format: DLMgetras {-s host-name -u user-name -p password [folder-to-whichcollected- eventlogsize {all | maximum-file-length} all 7-2 Utility Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 131
than y) instructs the utility to terminate without executing. In the latter case, you can either rename the existing folder before reexecuting the utility, or you can execute the utility with a different folder name specified. ¢ Windows 7, Windows Server 2008, and Windows Vista support User Account - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 132
Result of the dlnkmgr view path -item pn dn lu cp type ic ie dnu hd iep hbaportwwn vmruntimename vmstate vmpathuid command Result of the dlnkmgr -l view -sys command Contents of the HDLM registry Host information 7-4 Utility Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 133
information for executable files installed in the HDLM directory, HNTRLib2 directory, Hitachi common directory, and system directory. System information Event log for x64), Program Files is Program Files (x86). #4 Utility Reference 7-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 134
File names are created by using the value in the Hitachi Network Objectplaza Trace Library utility's Output (folder and prefix), adding 2 onto the end, and trace file name and does not represent part of the file number. 7-6 Utility Reference Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 135
List of Messages □ KAPL01001 to KAPL02000 □ KAPL09001 to KAPL10000 □ KAPL10001 to KAPL11000 □ KAPL13001 to KAPL14000 □ KAPL15001 to KAPL16000 □ KAPL20001 to KAPL21000 □ KAPL21001 to KAPL22000 Messages 8-1 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 136
more variables, they are displayed as bb...bb, cc...cc, and so on.) The operation name that is input after dlnkmgr in the command. 8-2 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 137
Operation Format) on page 6-5. KAPL01006-W A necessary parameter is not specified. Operation name = aa...aa Details The specified operation does not contain the necessary parameter. Messages 8-3 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 138
KAPL01013-E An error occurred in internal processing of the HDLM command. Operation name = aa...aa details = bb...bb Details An error unrelated to a user operation occurred during command processing. aa...aa: clear, offline, online, set, or view bb...bb: The name of the function and processing on - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 139
of the HDLM command (dlnkmgr view path) to check the value displayed in HDevName. Specify a host device for the value of HDevName, and then retry. For details on the view operation, see view (Displays Information) on page 6-22. Messages 8-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 140
information, and then contact your HDLM vendor or the company for which you have a service contract. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM amount of free memory, and then try again. 8-6 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 141
Enter y or n. KAPL01041-E The entered value is invalid. The Details operation stops. Operation name = aa...aa Command processing will be aborted because an incorrect Messages 8-7 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 142
[y/n]: Details The clear/set operation will be started. To continue the operation, enter y. To cancel the operation, enter n. aa...aa: clear or set Action 8-8 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 143
(Places Paths Offline) on page 6-7. KAPL01053-I If you are sure that there would be no problem when the path is placed in the Offline(C) status, enter y. Otherwise, enter n. [y/ n]: be set to Offline(C) was detected during Messages 8-9 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 144
to terminate processing, enter n. KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified aa...aa are placed in the Offline(C) status processing, enter y. To cancel processing, enter n. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 145
parameter value, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01060-I The user terminated the operation. Operation name = aa...aa Details Command processing will be aborted because n was entered for a required confirmation. aa...aa - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 146
, see view (Displays Information) on page 6-22. The target path(s) are already aa...aa. Details As a result of a previous online/ offline operation, the specified Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 147
is registered as an emergency license. aa...aa: Year (4 digits)/month (01-12)/day (01-31) Action Install a permanent license by the expiration day. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-13 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 148
re-execute. KAPL01083-I There is no license key file. File name = aa...aa Details There is no license key file in the designated folder: Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 149
a maintenance contract for HDLM. Do not perform the following operations: ¢ Simultaneously execute the HDLM command's set -lic operation with the view -sys -lic operation. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-15 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 150
, and then contact your HDLM vendor or the company for which you have a service contract. KAPL01100-I aa...aa Details This message indicates the executed command line. aa...aa the appropriate HBA port WWN, and then retry. 8-16 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 151
you want to terminate the processing, enter n. If you are sure that there would be no problem when all the paths which pass the specified aa...aa port are placed in the Offline(C) status want to terminate processing, enter n. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-17 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 152
be displayed. Details = aa...aa, bb...bb A storage system model ID could not be displayed. aa...aa: Storage recognition information bb...bb: Error code Action Execute the HDLM command (dlnkmgr) to check the host connection Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 153
no value specified for the host connection option. Option = aa...aa Details aa...aa: Option name Action Specify the option value, and then retry. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-19 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 154
online/offline operation. aa...aa: Number of paths where the online/offline operation was successful(decimal (base-10) number) bb...bb: Online or Offline(C) Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 155
HDLM command cannot manage HDLM on an ESXi server because the HDLM driver (HTI_HDLM_SATP) cannot be accessed. aa...aa: clear, offline, online, set, or view Action This message is output HDLM Error Information on page 7-2. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-21 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 156
operation the HDLM command (dlnkmgr) to check the path status. For details on the view operation, see view (Displays Information) on page 6-22. 8-22 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 157
-name \hdlm_license or the-filethat-the-user-specified Action Enter a license key when supported OS. HDLM cannot be installed on this system. Action Install HDLM on a supported OS. For information on which OSs are supported, see Hosts and OSs Supported HDLM. The current user does not have the - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 158
key file. aa...aa: Windows-installationdestination-drive-name \hdlm_license or the-filethat-the-user-specified Action Make sure that the license key file is correct, and then re- utility, see The DLMgetras Utility for Collecting 8-24 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 159
. File = aa...aa, Collection time = bb...bb(GMT:bb...bb) Details The file to be collected has been obtained. aa...aa: Collected file name Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-25 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 160
the DLMgetras utility for collecting HDLM error information has been terminated because the user replied to the confirmation with an n response. Action None. For collect information exists. aa...aa: Information collection file Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 161
an unstable user environment. disk capacity has decreased to less than 50 MB. Action Re-execute in an environment that has at least 50 MB of free disk capacity. KAPL10045-W A parameter is invalid. Details The specified parameter is invalid. Action Messages Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 162
contract for HDLM. Details An attempt to connect to the specified host has failed. Action Check the host name, user name or password that was specified in the DLMgetras utility for collecting HDLM error information, and then Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 163
error occurred during output of the audit log data. Action Contact your HDLM vendor or maintenance company if there is a maintenance contract for HDLM. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-29 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 164
. Command Line = aa...aa Details aa...aa: Command that the user executed KAPL15109-I Information about HDLMmanagement targets was successfully displayed. Command Line = aa...aa Details aa...aa: Command that the user executed 8-30 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 165
Line = aa...aa Details aa...aa: Command that the user executed KAPL15111-W The HDLM command was started or stopped by the user who does not have the authority. Command Line = aa... of the path where the error was detected. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-31 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 166
. Host status=cc...cc Details An I/O error occurred. aa...aa: SCSI command bb...bb: Name of Path that had I/ O error cc...cc: Host status Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 167
...aa: SCSI command bb...bb: Name of Path that had I/ O error cc...cc: Device status Action Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM information, and then contact your HDLM Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-33 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 168
aa: Name of Path that was not able to be updated. bb...bb: Device status Action Execute the DLMgetras utility for collecting HDLM error information, and then contact explanation of Sense Code, check the status of the storage. 8-34 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 169
termination of the pspPlugin Details (aa...aa) was successful. The termination of the HTI_PSP_HDLM plugin successful. aa...aa: HTI_PSP_HDLM_EXLBK, HTI_PSP_HDLM_EXLIO, or HTI_PSP_HDLM_EXRR Action None. Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) 8-35 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 170
8-36 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 171
ASC Addtional Sense Code ASCQ Addtional Sense Code Qualifier B BIOS Basic Input / Output System C CHA Channel Adapter CLPR Cache Logical Partition # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide (for VMware(R)) Acronyms-1 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 172
System Dev Device DNS Domain Name Server F FC Fibre Channel FC-SP Fibre Channel Security Protocol FO Failover FQDN Fully Qualified Domain Name G GMT Greenwich Mean Time H HBA Host Bus Adapter # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Acronyms-2 Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 173
Computer System Interface L LAN Local Area Network LDAP Lightweight Directory Access Protocol LDEV Logical Device LU Logical Unit LUN Logical Unit Number N NAS Network Attached Storage # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide (for VMware(R)) Acronyms-3 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 174
Remote Authentication Dial in User Service S SAN Storage Area Network SATP Storage Array Type Plugin SCSI Small Computer System Interface SLPR Storage Logical Partition SNMP Simple Network Management Protocol # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Acronyms-4 Hitachi Dynamic Link Manager User - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 175
SP Service Pack SSL Secure Sockets Layer SVP Service Processor U UID User Identifier W WWN World Wide Name # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide (for VMware(R)) Acronyms-5 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 176
# ABCD E F GH I J K LMNOPQR S T U VWX Y Z Acronyms-6 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 177
: path) B boot disk environment An environment in which the startup disk is in a storage system instead of in the host. C CHA (Channel Adapter) An adapter for controlling the channels of a storage system. # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide (for VMware - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 178
such as a PC or a UNIX computer, the HDLM host can access only the LUs that have open-system emulation types. For details on emulation types supported by a storage system, see the maintenance manual for that particular storage system. F failback A function for placing the status of a path recovered - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 179
cable connection. L LDEV (Logical Device) A combination of the storage system's product name, serial access each area within an LU. To distribute loads, load balancing uses multiple paths to perform I/O operations. # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 180
. When using the Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS, all paths are owner paths. (See also: owner controller, non-owner path) # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Glossary-4 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 181
a path. (See also: host LU number) R remote management client A machine that connects to a host via access to storage systems, and prevents the transfer of high-volumes of data from deteriorating LAN performance. # ABCD E F GH I J K LMNOPQR S T U VWX Y Z Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 182
A SCSI disk device. SLPR (Storage Logical Partition) A function supported by Universal Storage Platform V/VM and Virtual Storage Platform for logically splitting up a storage system. This function splits up the resources, such as ports, CLPR, and volumes, in the storage system, so that the user can - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 183
command format 6-2 overview 6-2 command device 2-2 2-23 command of HDLM -2 Dev number Glossary-2 Disk Requirements 3-3 displaying information remote management client 6-22 Distributing a Load Using Load Balancing 2-6 DLMgetras 5-5, 5-6, 7-2 dlnkmgr 6-1 Hitachi Dynamic Link Manager User Guide - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 184
-installation of HDLM 3-4 HDLM management-target devices 2-2 HDLM program function 2-5 HDLM program information host 6-24 remote management client 6-27 HDLM utility 2-5 help setup 3-13 intermittent error Glossary-3 definition 2-13 Index-2 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 185
5-4 NMP 2-5 non-owner controller 2-8, Glossary-4 non-owner path 2-8, Glossary-4 Number of LUs Supported in HDLM 3-3 Number of Paths Supported in HDLM 3-3 O obtaining what to do for 5-5, 5-6 program information host 6-25 obtaining 5-5 Hitachi Dynamic Link Manager User Guide (for VMware(R)) Index-3 - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 186
remote management client 1-2, Glossary-5 reservation Glossary-5 S SAN 2-3 SAN (Storage Area Network) Glossary-5 SCSI device Glossary-6 set 6-15 setup HDLM 3-9 integrated traces 3-13 SLPR(Storage Setting Up the Operating Environment 4-5 Index-4 Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 187
Hitachi Dynamic Link Manager User Guide (for VMware(R)) - HP XP P9500 | Hitachi Dynamic Link Manager Software User Guide for VMWare (HIT52 - Page 188
Hitachi Data Systems Corporate Headquarters 750 Central Expressway Santa Clara, California 95050-2627 U.S.A. Phone: 1 408 970 1000 www.hds.com [email protected] Asia Pacific and Americas 750 Central Expressway Santa Clara, California 95050-2627 U.S.A. Phone: 1 408 970 1000 [email protected] Europe
Hitachi Command Suite
Dynamic Link Manager Software
User Guide (for VMware(R))
MK-92DLM130-00
Document Organization
Product Version
Getting Help
Contents