Page 1 Hitachi Command Suite Dynamic Link Manager Software User Guide (for VMware(R)) Document Organization Product Version Getting Help Contents MK-92DLM130-00...
Page 2 © 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.
Page 3: Table Of Contents
Contents Preface....................ix Intended audience.....................x Product version......................x Release 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 HDLM..................2-2 System Configuration....................2-2 LU Configuration.....................2-3 Program Configuration....................2-4...
Page 4 The Offline Path Statuses...............2-14 Correspondence between VMware vSphere and HDLM path statuses..2-15 Status Transitions of a Path..............2-15 Monitoring Intermittent Errors................2-16 Checking Intermittent Errors................2-16 Setting Up Intermittent Error Monitoring............2-16 Intermittent Error Monitoring Actions...............2-17 When an Intermittent Error Occurs............2-17 When an Intermittent Error Does Not Occur..........2-18 When the Conditions for an Intermittent Error Are Changed During Error Monitoring....................2-18 When a User Changes the Intermittent Error Information........2-19...
Page 5 Preparations for HDLM Uninstallation...............3-15 Uninstalling HDLM...................3-16 Uninstalling HDLM from a host...............3-16 Uninstalling HDLM from a remote management client......3-17 Performing an unattended uninstallation of HDLM on a remote management client....................3-17 4 HDLM Operation...................4-1 HDLM Operations Using Commands.................4-2 Notes on Using Commands................4-2 Viewing Path Information..................4-2 Changing the Status of Paths................4-3 Changing the Status of Paths to Online.............4-3...
Page 6 Format......................6-5 Parameter......................6-5 offline (Places Paths Offline)..................6-7 Format......................6-8 To place paths offline................6-8 To Display the Format of the offline Operation.......... 6-8 Parameters......................6-8 To place paths Offline................6-8 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-11 Parameters.....................6-12...
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 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 8 viii Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 9 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 □...
Page 10: Overview Of Hdlm
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: • VMware vSphere and its management functionality •...
Page 11: Referenced Documents
Chapter Description 6 Command Reference on page Describes all the HDLM commands. 7 Utility Reference on page 7-1 Describes the HDLM utilities. 8 Messages on page 8-1 Provides information for all the possible messages that could be output by HDLM. It also lists and explains the HDLM messages and shows the actions to be taken in response to each message.
Page 12 Font Convention copy source-file target-file • Do not delete the configuration file. A code font indicates text that the user enters without change, or text Code font (such as messages) output by the system. For example: • At the prompt, enter dir. •...
Page 13: Getting Help
Example font or Convention symbol A prompt in a window where a command can be entered. > Convention for storage capacity values Physical storage capacity values (e.g., drive capacity) are calculated based on the following values: Physical capacity unit Value 1 kilobyte (KB) 1,000 (10 ) bytes...
Page 14 Comments Please send us your comments on this document: doc.comments@hds.com. 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! Preface Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 15: Overview Of Hdlm
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.
Page 16: What Is Hdlm
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.
Page 17: Hdlm Features
HDLM Features HDLM features include the following: The ability to distribute a load across multiple paths. This is also known as load balancing. When a host is connected to a storage system via multiple paths, HDLM can distribute the load across all the paths. This prevents one, loaded down path from affecting the processing speed of the entire system.
Page 18 Overview of HDLM Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 19: Hdlm Functions
HDLM Functions This chapter describes the various functions that are built into HDLM. Before the function specifications are explained though, this chapter will go into detail about the HDLM management targets, system configuration, and basic terms that are necessary to know to effectively operate HDLM. After that, the rest of the chapter focuses on describing all the HDLM functions, including the main ones: load distribution across paths and path switching.
Page 20: Devices Managed By Hdlm
Devices Managed by HDLM Below is a list of devices that can or cannot be managed by HDLM. The devices that can be managed by HDLM are called HDLM management-target devices. HDLM management-target devices: The following devices are from the storage systems listed in Section What is HDLM? on page 1-2:...
Page 21: Lu Configuration
Figure 2-1 HDLM System Configuration Table 2-1 HDLM System Components on page 2-3 lists the HDLM system components. Table 2-1 HDLM System Components Components Description A host bus adapter. This serves as a cable port on the host. A dedicated network that is used for data transfer between the host machine and storage subsystems.
Page 22: Program Configuration
Figure 2-2 LU Configuration Recognized by the Host After the Installation of HDLM Table 2-2 Components Recognized by the Host on page 2-4 lists the components recognized by the host. Table 2-2 Components Recognized by the Host Components Description An LU that the host recognizes via the HDLM driver. This type of LU is called a host LU.
Page 23 Figure 2-3 Configuration of the HDLM Programs Table 2-3 Functions of HDLM Programs on page 2-5 lists and describes the functions of these programs. Table 2-3 Functions of HDLM Programs Program name Functions HDLM command Provides the dlnkmgr command, which enables you to: •...
Page 24: Distributing A Load Using Load Balancing
Figure 2-4 Positioning of HDLM Driver and NMP Distributing a Load Using Load Balancing When the system contains multiple paths to a single LU, HDLM can distribute the load across the paths by using multiple paths to transfer the I/O data. This function is called load balancing, and it prevents a single, heavily loaded path from affecting the performance of the entire system.
Page 25 Figure 2-5 Flow of I/O Data When the Load Balancing Function Is Not Used 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.
Page 26: Paths To Which Load Balancing Is Applied
Figure 2-6 Flow of I/O Data When the Load Balancing Function Is Used When the load balancing function is used, I/O operations are distributed via multiple paths (A, B, C, and D). This helps to prevent problems with system performance and helps prevent bottlenecks from occurring. Paths to Which Load Balancing Is Applied This subsection describes, for each type of storage system, the paths to which the load balancing function is applied.
Page 27: When Using The Universal Storage Platform V/Vm, Virtual Storage Platform Hitachi Ams2000 Series, Or Hitachi Sms
load balancing will be performed among the remaining, usable owner paths. It is only when absolutely no owner paths are available, that load balancing is then performed among the non-owner paths. For the example in Figure 2-7 Overview of Load Balancing on page 2-9, suppose that in the owner controller of LU0 is CHA0.
Page 28 Table 2-4 Load Balancing Algorithms Algorithm name PSP name Extended Round Robin HTI_PSP_HDLM_EXRR Extended Least I/Os HTI_PSP_HDLM_EXLIO Extended Least Blocks HTI_PSP_HDLM_EXLBK Most Recently Used (VMware) VMW_PSP_MRU Round Robin (VMware) VMW_PSP_RR PSPs for the Extended Round Robin, Extended Least I/Os, and Extended Least Blocks algorithms are installed together with HDLM.
Page 29: Performing Failovers And Failbacks Using Path Switching
Performing Failovers and Failbacks Using Path Switching When the system contains multiple paths to an LU and an error occurs on the path that is currently being used, HDLM can switch to another functional path, so that the system can continue operating. This is called a failover. If a path in which an error has occurred recovers from the error, HDLM can then switch back to that path.
Page 30 When the Hitachi AMS/WMS series is being used, HDLM will select the path to be used next from among the various paths that access the same LU, starting with owner paths, and then non-owner paths. For example, in Figure 2-8 Path Switching on page 2-12, the owner controller of an LU is CHA0, and access to the LU is made via only one path (A).
Page 31: Manual Path Switching
Automatic Failbacks When a path recovers from an error, HDLM can automatically place the recovered path back online. This function is called the automatic failback function. When using the Hitachi AMS/WMS series, HDLM will select the next path to be used first from among the online owner paths, and then from the online non- owner paths.
Page 32: Path Status Transition
HDLM uses the same algorithms to select the path that will be used next, regardless of whether automatic or manual path switching is used. When using the Hitachi AMS/WMS series, HDLM will select the next path to be used first from among the online owner paths, and then from the online non- owner paths.
Page 33: Correspondence Between Vmware Vsphere And Hdlm Path Statuses
Correspondence between VMware vSphere and HDLM path statuses Table 2-5 Correspondence Between VMware vSphere and HDLM Path Statuses on page 2-15 shows the correspondence between the path statuses displayed by VMware vSphere and the path statuses in the output of the HDLM command's view operation.
Page 34: Monitoring Intermittent Errors
The last available 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) on page 6-7. A path that is recovered from an error by the automatic failback function is automatically placed in online status.
Page 35: Intermittent Error Monitoring Actions
You can set up intermittent error monitoring by executing the dlnkmgr command's set operation. For details on how to configure intermittent error monitoring, see set (Sets Up the Operating Environment) on page 6-15. Intermittent Error Monitoring Actions Intermittent error monitoring is performed on each path, and it automatically starts as soon as a path is recovered from an error by using the automatic failback function.
Page 36: When An Intermittent Error Does Not Occur
When an Intermittent Error Does Not Occur If an error does not occur on a path a specified number of times within a specified interval, an intermittent error will not occur. In such a case, the error monitoring will finish when the specified error-monitoring interval finishes, upon which the number of errors is reset to 0.
Page 37: When A User Changes The Intermittent Error Information
since the error monitoring started are both reset to 0. As such, the error monitoring will not finish, and it will start over by using the new conditions. If the conditions are changed while error monitoring is not being performed, error monitoring will start up again and use the updated conditions after any given path is recovered from an error by performing an automatic failback.
Page 38 Table 2-6 When Effects of a User Changing the Intermittent Error Information Number of Information errors and time about paths passed since User operation not subject to error automatic monitoring failback started Changing the Turning off Reset Reset intermittent error Changing the conditions for Inherited Reset...
Page 39: Detecting Errors By Using Path Health Checking
The number of errors and the time since monitoring started is reset to 0, and then monitoring restarts in accordance with the changed monitoring conditions. Detecting Errors by Using Path Health Checking HDLM can check the status of paths for which I/O operations are not being performed and detect errors.
Page 40: Types Of Collected Logs
Figure 2-13 Flow of Data When Collecting Error Information Logs might be collected in layers below 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 syslog. You can use the error information to examine the status of an error and analyze the cause of the error.
Page 41: Collecting Audit Log Data
Log name Description Output destination For details on how to set the syslog file path, refer to the VMware vSphere documentation. For details on how to change the collection level, see Table 8-1 Format and Meaning of the Message ID KAPLnnnnn-l on page 8-2 Format and Meaning of Message IDs on page 8-2.
Page 42 Category Explanation An event indicating the result of communication between a ExternalService Hitachi storage-related product and an external service, including: • Communication with a RADIUS server, LDAP server, NTP server, or DNS server, • Communication with the management server (SNMP) An event indicating that a connection or authentication Authentication attempt made by a device, administrator, or end-user has...
Page 43: Categories And Audit Events That Hdlm Can Output To The Audit Log
Category Explanation • A SYN flood attack or protocol violation for a normally used port • Access to an unused port (such as port scanning) The categories of audit log data that can be collected differ depending on the product. The following sections explain only the categories of audit log data that can be collected by HDLM.
Page 44: Requirements For Outputting Audit Log Data
Severity Category Explanation Audit event Message ID Setup of the KAPL15106-W operating environment failed. An attempt to KAPL15107-I display program information was successful. An attempt to KAPL15108-W display program information failed. An attempt to KAPL15109-I display HDLM management- target information was successful.
Page 45: Destination And Filtering Of Audit Log Data
Notes: You might need to perform operations such as changing the log size ¢ and backing up and saving collected log data, because the amount of audit log data might be quite large. Destination and Filtering of Audit Log Data Audit log data is output to event logs of the remote management client.
Page 46 program-name [process-ID]: message-section The following shows the format of message-section and explains its contents. The format of message-section: common-identifier,common-specification-revision-number,serial- number,message-ID,date-and-time,entity-affected,location- affected,audit-event-type,audit-event-result,subject-ID-for-audit-event- result,hardware-identification-information,location-information,location- identification-information,FQDN,redundancy-identification- information,agent-information,host-sending-request,port-number- sending-request,host-receiving-request,port-number-receiving- request,common-operation-ID,log-type-information,application- identification-information,reserved-area,message-text Up to 950 bytes of text can be displayed for each message-section. Table 2-11 Items Output in the Message Section Explanation Item Common identifier...
Page 47 Explanation Item Host sending request Name of the host sending a request Port number sending Number of the port sending a request request Host receiving request Name of the host receiving a request Port number receiving Number of the port receiving a request request Common operation ID Operation serial number in the program...
Page 48 2-30 HDLM Functions Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 49: Creating An Hdlm Environment
Creating an HDLM Environment This chapter explains how to set up an HDLM environment and also how to erase environment settings. Make sure that you have already installed HDLM and configured the function settings. □ HDLM System Requirements □ Flow for Creating an HDLM Environment □...
Page 50: Hdlm System Requirements
HDLM System Requirements Check the following before installing HDLM: Hosts and OSs Supported by HDLM HDLM can be installed on computers running the following operating systems: Host OS support VMware vSphere ESXi 5.0 is supported as an OS for host computers. Remote management client OS support Table 3-1 OS Support for Remote Management Clients on page 3-2 shows...
Page 51: Memory And Disk Capacity Requirements
The supported storage systems require a dual controller configuration. If you use the system in a HUB environment, you must set a unique loop ID for every connected host and storage system. For details about the micro- program versions for using HDLM, see the HDLM Release Notes. For details about storage system settings required for using HDLM, see the maintenance documentation for storage systems.
Page 52: Flow For Creating An Hdlm Environment
Flow for Creating an HDLM Environment Set up the environment to use HDLM as follows. Figure 3-1 Flow of HDLM Environment Setup HDLM Installation Types This subsection describes the following types of HDLM installation: new installation, upgrade installation, and re-installation. New installation of HDLM: Installing HDLM on a server on which HDLM has not been installed is called a new installation of HDLM.
Page 53: Performing A New Installation Of Hdlm
information on license key types, see set (Sets Up the Operating Environment) on page 6-15 • Terminate all programs that are running before installing HDLM. • HDLM uses the Windows Installer service. Therefore, when you install HDLM, take the following precautions: In the Startup Type setting for the Windows Installer service, specify ¢...
Page 54: New Installation On Remote Management Client
To manually perform an installation on the remote management client, follow the procedure in New installation on remote management client on page 3-6. To perform an unattended installation, follow the procedure in Unattended installation on remote management client on page 3-7.
Page 55: Unattended Installation On Remote Management Client
Having installed HDLM on the remote management client, go to installation on host on page 3-7. Unattended installation on remote management client Log on to Windows on the remote management client as a member of the Administrators group. Insert the HDLM installation DVD-ROM. Launch the Administrator: Command Prompt window.
Page 56: Performing A Re-Installation Of Hdlm
>esxcli --server=host-name --username=user-name -- password=password software acceptance set -- level=PartnerSupported Install HDLM on the host. Execute the following command. In the -d parameter, specify the name of an offline bundle file you copied in step 1. Repeat this command for each offline bundle file you copied in step 1. >esxcli --server=host-name --username=user-name -- password=password software vib install -d /any-directory-on-the- host/online-bundle-file-name...
Page 57: Setting Up Hdlm
you install HDLM or change the hardware configuration, check the structure and statuses of the paths. You can use the HDLM command's view operation from the remote management client to check path information. The following describes how to check path information by using the dlnkmgr command's view operation.
Page 58: Setting Up The Hdlm Functions
> To check the current audit log settings, execute the following command: >dlnkmgr -l view -sys -audlog Audit Log : off Audit Log Category KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > Setting Up the HDLM Functions The recommended and default values for setting up each HDLM function is shown below in...
Page 59: Setting Up Intermittent Error Monitoring
Setting Up Intermittent Error Monitoring To prevent I/O performance from dropping when an intermittent error occurs, we recommend that you enable intermittent error monitoring. When intermittent error monitoring is enabled, you can specify intermittent error conditions. The default value for the intermittent error-monitoring interval is 30.
Page 60: Checking The Updated Settings
Value (severity) Explanation Error-level and Warning-level audit log data is collected. Error-level, Warning-level, and Information-level audit log data is collected. Table 3-5 Values Indicating Audit Log Data Categories on page 3-12 describes the values that indicate audit log data categories. The default is all.
Page 61: Setting Up Integrated Traces
After you have set up the collection of audit log data, use the following command to make sure that the setting has been specified correctly: >dlnkmgr -l view -sys -audlog Audit Log : on(6) Audit Log Category : all KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss >...
Page 62 Recommended Setting Default value value monitoring Number of messages interval to be output If Hitachi Network Objectplaza Trace Library (HNTRLib2) is already installed, the existing settings will be inherited. If you change these settings, keep in mind that programs other than HDLM also use them. If an earlier Hitachi Network Objectplaza Trace Library (HNTRLib) is already installed, the settings will not be inherited.
Page 63: Preparations For Hdlm Uninstallation
The value you specify here will apply to n in program-installation- destination-drive:\Program Files\HITACHI\HNTRLib2\spool \Hntr2n.log (n indicates a file number). In File Size(KB), change the size of an integrated trace file. The default is 256 (kilobytes). You can specify a value from 8 to 8192. Specify a value greater than or equal to the setting of Buffer Size(KB).
Page 64: Uninstalling Hdlm
Uninstalling HDLM The procedure for uninstalling HDLM is described below. Perform the uninstallation process on the host and the remote management client. You can uninstall HDLM on the remote management client by using an unattended uninstallation. An unattended uninstallation enables a user to uninstall HDLM without entering information.
Page 65: Uninstalling Hdlm From A Remote Management Client
>esxcli --server=host-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 Selection Policy: VMW_PSP_MRU Path Selection Policy Device Config: Path Selection Policy Device Custom Config: Working Paths: vmhba2:C0:T0:L3 In the command output, search for items for which HITACHI Fibre...
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))
Page 67: Hdlm Operation
HDLM Operation This chapter describes the procedures for operating HDLM. This 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 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 68: Hdlm Operations Using Commands
HDLM Operations Using Commands This section explains how to use the HDLM command. For details on the various command operations, see 6 Command Reference on page 6-1. Notes on Using Commands • Execute the HDLM command from the VMware vSphere CLI on the remote management client.
Page 69: Changing The Status Of Paths
For details on the displayed items and their descriptions, see view (Displays Information) on page 6-22. Changing the Status of Paths This section explains how to change path statuses. Changing the Status of Paths to Online To change the status of paths to online: Check the current status of the paths.
Page 70: Viewing Lu Information
To change the status of paths to Offline(C), execute the dlnkmgr command's offline operation. The paths to be placed Offline(C) can be specified by using a CHA port, single path, or HBA port WWN. For details on how to specify paths, see offline (Places Paths Offline) on page 6-7.
Page 71: Viewing And Setting Up The Operating Environment
Initializing Statistical Information for Paths This section explains how to initialize statistical information (I/O counts and I/ O errors) for all the paths managed by HDLM. This procedure is useful when you want to check the number of I/O operations and I/O errors that have occurred since the last time the I/O counts and I/O errors were initialized to 0.
Page 72: Setting Up The Operating Environment
To display the operating environment of the audit log, execute the HDLM command's view operation with the -sys and -audlog parameters specified. The following example shows how to execute the command: >dlnkmgr -l view -sys -audlog Audit Log : off Audit Log Category KAPL01001-I The HDLM command completed normally.
Page 73: Updating The License
>dlnkmgr -l view -sys -lic License Type Expiration Permanent KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > For details on the displayed items and their descriptions, see view (Displays Information) on page 6-22.
Page 74 To check the version of HDLM installed on a host: >dlnkmgr -s host-name -u user-name -p password view -sys HDLM Version : x.x.x-xx Service Pack Version Load Balance : on(extended lio) Intermittent Error Monitor : off SATP : HTI_SATP_HDLM Default PSP : HTI_PSP_HDLM_EXLIO KAPL01001-I The HDLM command completed normally.
Page 75: Troubleshooting
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 resolutions for path errors, HDLM program errors, and other types of errors are all described separately.
Page 76: Information Collected By The Dlmgetras Utility For Collecting Hdlm Error Information
Information Collected by the DLMgetras Utility for Collecting HDLM Error Information Immediately after an error occurs, execute the DLMgetras utility for collecting HDLM error information, since restarting the machine might delete error information before the information is collected by DLMgetras. For details about the DLMgetras utility and the error information it collects, The DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Page 77 Figure 5-1 Error Location When the KAPL20023-E Message Is Output Figure 5-2 Troubleshooting Procedure When a Path Error Occurs on page shows 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.
Page 78: Examining The Messages
Examining the Messages Examine the message that is output to syslog in the host by using applications or tools for monitoring messages. If the KAPL20023-E message is output, view the message to check the path in which the error has occurred.
Page 79: What To Do For A Program Error
Executing this command places all the offline paths online. If any path cannot be placed online due to an error, the KAPL01039-W message will appear. To ignore such paths and to continue processing, type y. Type n to cancel processing. Check the statuses of the paths that cannot be placed online, and resolve the problem.
Page 80: What To Do For The Program Error
Some of the information collected by the DLMgetras utility might be cleared when the host is restarted. Because of this, whenever an error occurs, execute the DLMgetras utility as soon as possible. What To Do for the Program Error Follow the recommended actions for messages in 8 Messages on page 8-1.
Page 81: Command Reference
Command Reference This chapter describes the HDLM command (dlnkmgr) and its operations. □ Overview of the HDLM Command dlnkmgr □ clear (Returns the Path Statistics to the Initial Value) □ help (Displays the Operation Format) □ offline (Places Paths Offline) □...
Page 82: Overview Of The Hdlm Command Dlnkmgr
Overview of the HDLM Command dlnkmgr This section describes how to specify the HDLM command dlnkmgr and its subcommands (called operations in HDLM). Command format Enter the command using the following format: dlnkmgr [connection-options] operation [parameter [parameter- value]] dlnkmgr The command name. connection-options The information required to log in to the target host.
Page 83: To Set The Path Statistics To 0
Table 6-1 Operations of the dlnkmgr Command Operation Functions Initializes(0) the statistics (I/O count and I/O errors) of all paths clear managed by the HDLM system. For details, see clear (Returns the Path Statistics to the Initial Value) on page 6-3.
Page 84: Parameters
Parameters To Set the Path Statistics to 0 -pdst Clears statistics (I/O count and I/O errors) of all paths managed by HDLM to the initial value (0). Example >dlnkmgr clear -pdst KAPL01049-I Would you like to execute the operation? Operation name = clear [y/n]:y KAPL01001-I The HDLM command completed normally.
Page 85: Help (Displays The Operation Format)
[ --portnumber=PORTNUMBER ] [ --protocol=PROTOCOL ] [ --savesessionfile=SAVESESSIONFILE ] [ --servicepath=SERVICEPATH ] KAPL01001-I The HDLM command completed normally. Operation name = clear, completion time = yyyy/mm/dd hh:mm:ss > help (Displays the Operation Format) The dlnkmgr command's help operation displays the list of operations available for the HDLM command, or the format of individual operations.
Page 86 [ -h VIHOST | --vihost=VIHOST ] [ -p PASSWORD | --password=PASSWORD ] [ -r URL | --url=URL ] [ -s SERVER | --server=SERVER ] [ -t CACERTSFILE | --cacertsfile=CACERTSFILE ] [ -u USERNAME | --username=USERNAME ] [ --credstore=CREDSTORE ] [ --passthroughauthpackage=PASSTHROUGHAUTHPACKAGE ] [ --portnumber=PORTNUMBER ] [ --protocol=PROTOCOL ] [ --savesessionfile=SAVESESSIONFILE ]...
Page 87 Host-Connection-Options: [ -a | --passthroughauth ] [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --sessionfile=SESSIONFILE ] [ -h VIHOST | --vihost=VIHOST ] [ -p PASSWORD | --password=PASSWORD ] [ -r URL | --url=URL ] [ -s SERVER | --server=SERVER ] [ -t CACERTSFILE | --cacertsfile=CACERTSFILE ] [ -u USERNAME | --username=USERNAME ]...
Page 88: To Display The Format Of The Offline Operation
Format To place paths offline dlnkmgr [-s host-name -u user-name -p password] offline [-path] |-cha -pathid AutoPATH_ID |-pathid AutoPATH_ID |-hbaportwwn HBA-port-WWN} [-s] 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 Indicates that the target of the operation is a path managed by HDLM.
Page 89 >dlnkmgr offline -cha -pathid 000001 KAPL01055-I All the paths which pass the specified CHA port will be changed to the Offline(C) status. Is this OK? [y/n]:y KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified CHA are placed in the Offline(C) status, enter y.
Page 90: To Display The Format Of The Offline Operation
> Executes the command without displaying the message asking for confirmation of command execution from the user. Specify this parameter if you want to skip the response to the confirmation message: for example, when you want to execute the command in a shell script or batch file.
Page 91: Online (Places Paths Online)
Valid value AutoPATH_ID { 000000 - 999999 }(Decimal) KAPL01001-I The HDLM command completed normally. Operation name = offline, completion time = yyyy/mm/dd hh:mm:ss > Reference Using the view operation together with standard OS commands enables you to filter the path information listed for a specific CHA port. For details about the view operation, see view (Displays Information) on page 6-22.
Page 92: To Place Paths Online
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.
Page 93 (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.
Page 94: To Display The Format Of The Online Operation
To Display the Format of the Online Operation -help Displays the format of the online operation. Example The following example shows how to display the format of the online operation: >dlnkmgr online -help online: Format dlnkmgr [Host-Connection-Options] online [-path] [-s] dlnkmgr [Host-Connection-Options] online [-path] -cha -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] online [-path] -pathid...
Page 95: To Set The Host Operating Environment
>dlnkmgr view -path -stname | find "AMS" | find "0A" The above command will display information pertaining to only those paths that pass through the specified CHA port. set (Sets Up the Operating Environment) The dlnkmgr command's set operation sets the HDLM operating environment.
Page 96: Parameters
Parameters To Set the Host Operating Environment Table 6-2 Default and Recommended Values on page 6-16 shows the defaults and recommended values for each setting. If you change the value of the set operation, the new value takes effect immediately. Table 6-2 Default and Recommended Values Item name Default value...
Page 97 The values specified from the last time are used. The following shows the sub-parameters that should be specified: the error monitoring interval and the number of times that the error is to occur: -intvl error-monitoring-interval Specify the monitoring interval for an intermittent error. Use a value from 1 to 1440 minutes.
Page 98: To Set The Remote Management Client Operating Environment
error monitoring has started are reset to 0. Intermittent error monitoring will then resume with the changed settings. Executes the command without displaying the message asking for confirmation of command execution from the user. Specify this parameter if you want to skip the response to the confirmation message: for example, when you want to execute the command in a shell script or batch file.
Page 99 A temporary license key cannot be installed by using the dlnkmgr command's set operation. Example 1 The following example shows how to update the license key when the license key file exists: >dlnkmgr -l set -lic KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: y KAPL01071-I A permanent license was installed.
Page 100: To Display The Format Of The Set Operation
Value (severity) Explanation Error-level, Warning-level, and Information-level audit log data is collected. -category [[ss] [a] [ca]|all] Specifies the categories of audit log data to be collected. Table 6-5 Values Indicating Audit Log Data Categories on page 6-20 describes the values that indicate categories of audit log data. The default is all.
Page 101 [ -category Category-Value ] | -audlog off [-s] Host-Connection-Options: [ -a | --passthroughauth ] [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --sessionfile=SESSIONFILE ] [ -h VIHOST | --vihost=VIHOST ] [ -p PASSWORD | --password=PASSWORD ] [ -r URL | --url=URL ] [ -s SERVER | --server=SERVER ]...
Page 102: To Display Program Information For A Host
[ --passthroughauthpackage=PASSTHROUGHAUTHPACKAGE ] [ --portnumber=PORTNUMBER ] [ --protocol=PROTOCOL ] [ --savesessionfile=SAVESESSIONFILE ] [ --servicepath=SERVICEPATH ] Valid value Error-Monitor-Interval { 1 - 1440 }(Minutes) (Default Value 30) Number-Of-Times { 1 - 99 }(Times) (Default Value 3) KAPL01001-I The HDLM command completed normally. Operation name = set, completion time = yyyy/mm/dd hh:mm:ss >...
Page 103: To Display Path Information
[-lic|-audlog] [-t] To Display Path Information To display path information dlnkmgr [-s host-name -u user-name -p password] view -path [-hdev host-device-name] [-stname] [-iem] [-srt {pn|lu|cp}] [-hbaportwwn] [-vmruntimename] [-vmstate] [-t] To display path information (by selecting a display item) dlnkmgr [-s host-name -u user-name -p password] view -path -item [pn] [hbaportwwn] [dn] [lu] [cp] [type] [ic] [ie] [dnu] [hd] [iep] [vmruntimename] [vmstate] [vmpathuid]...
Page 104: To Display The Format Of The View Operation
[lb] [vmpsp] [vmruntimename] [vmstate]|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 view -help...
Page 105 Does not display the title for each information item. Table 6-6 Items of program information (for hosts) Parameter and program Item Description information to be displayed HDLM version number -sfunc HDLM Version Information HDLM SP version number. This item is blank if Service Pack about the HDLM no SP is present.
Page 106 Parameter and program Item Description information to be displayed • HTI_PSP_HDLM_EXLIO: The Extended Least I/Os algorithm • HTI_PSP_HDLM_EXLBK: The Extended Least Blocks algorithm • VMW_PSP_MRU: The Most Recently Used algorithm (VMware) • VMW_PSP_RR: The Round Robin algorithm The storage system vendor ID in the SATP -rule Vendor claim rule registered in HTI_SATP_HDLM.
Page 107: To Display Program Information For A Remote Management Client
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > To Display Program Information for a Remote Management Client -sys [-lic|-audlog] Displays program information for HDLM installed on a remote management client. Use one of the sub-parameters (following -sys) to specify the program information that you want to display.
Page 108 Parameter and program Item Description information to be displayed within the parentheses following on. The collection level indicates a severity level. A value from 0 to 7 is displayed as the collection value. The categories of audit log data to be output are Audit Log displayed.
Page 109: To Display Path Information
Audit Log : off Audit Log Category KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > To display path information When displaying path information, if you specify either the -item or -c parameter and also specify the -path parameter, you can select the items to display and display a summary of path information.
Page 110 The sorting keys are as follows: the first sorting key is the name of the storage system (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID. The available parameter values to specify the second sorting key are: •...
Page 111 When you specify the -path parameter together with the -item parameter, the command only displays the items specified by the value of the -item parameter. When the value of the -item parameter is omitted, only the PathID and the Status fields are displayed. Table 6-8 Correspondence between the items displayed by the dlnkmgr view -path -item command and the values of the -item parameter on page 6-31...
Page 112 -hdev host-device-name Displays information only 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 the product ID element of the DskName field.
Page 113 PathID VmRuntimeName Status VmState VmPathUID 000000 vmhba2:C0:T0:L0 Online active fc.200000e08b90c61c: 210000e08b90c61c-fc.50060e8010027a85:50060e8010027a85- t10.HITACHI_770101520191 000001 vmhba5:C0:T0:L0 Online active 20000024ff293611:21000024ff293611-fc. 50060e8010027a81:50060e8010027a81-t10.HITACHI_770101520191 KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > To display path information, by abbreviating the list items -path -c When you specify the -path parameter together with the -c parameter, the command selects certain items to be displayed, and shortens the...
Page 114 When the -srt parameter is omitted, the path information is listed in ascending order of AutoPATH_IDs. Omits the title for each information item. Example The following example shows how to abbreviate the display of information about the paths, ordered by iLU. >dlnkmgr view -path -c -srt lu Paths:000012 OnlinePaths:000012 PathStatus...
Page 115 Displayed Item Description Summary summary displayed displayed Number of online paths from within the displayed paths, OnlinePaths indicated by a decimal number. When the value of Paths equals the value of OnlinePaths, all paths are online. If the value of OnlinePaths is less than that of Paths, some paths are offline.
Page 116 Displayed Item Description Summary summary displayed displayed • Product ID: Indicates the storage system product ID, emulation type, or model ID (for example, DF600F). For more details, see Table 6-11 Product ID displayed by the view -path operation on page 6-39.
Page 117 Displayed Item Description Summary summary displayed displayed 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 count for the path, indicated by a decimal IO-Count number. The maximum value that can be displayed is 2 1 (4294967295).
Page 118 Displayed Item Description Summary summary displayed displayed hbaportwwn parameter or when you specify hbaportwwn for the -item parameter. Displays the runtime information for paths managed by VmRuntimeN VMware vSphere in path information fields. If you specify the -vmruntimename parameter together with the -path parameter, this information is displayed instead of the PathName item.
Page 119: To Display Lu Information
Table 6-11 Product ID displayed by the view -path operation Product ID With the -stname Model names of storage Without the -stname parameter systems parameter (Displays the following for the model name) Hitachi AMS2000 series product identifier Hitachi AMS Hitachi SMS Hitachi WMS •...
Page 120 -hdev host-device-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 parameter to display only the information about the LU that is connected to the path with that specified AutoPATH_ID. Omits the title for each information item.
Page 121 Items displayed by the dlnkmgr view Values specified after the -item -lu -item command parameter ChaPort CLPR clpr Type type IO-Count IO-Errors DNum VmPSP vmpsp VmRuntimeName vmruntimename VmState vmstate All items are displayed In the sub-parameters, -hdev or -pathid, you can filter the LU information to be displayed.
Page 122 0191 t10.HITACHI_770101520191 exlio HTI_PSP_HDLM_EXLIO 000000 vmhba2:C0:T0:L0 1B Online active 000001 vmhba5:C0:T0:L0 0B Online active KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss > To display a summary of LU information -lu -c When the -c parameter is specified with the -lu parameter, a summary of LU configuration information is displayed on one line.
Page 123 Displayed item Description No summary Summary displayed displayed Serial number of the storage system SerialNumber Total number of LUs managed by HDLM among the LUs in the storage system LU number in the storage system. This number combined with the storage system name (shown in DskName) identifies the LU that is accessed by a path.
Page 124 Displayed item Description No summary Summary displayed displayed For details about each element of the path name and its representation in VMware vSphere, see Table 6-10 Elements of a path name on page 6-38. Port number of the CHA, which identifies the ChaPort CHA port that is mounted on the storage system.
Page 125 Displayed item Description No summary Summary displayed displayed (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0. To reset the IO- Errors value to 0, execute the dlnkmgr command's clear operation.
Page 126: To Display The Format Of The View Operation
Displayed item Description No summary Summary displayed displayed • dead: Offline due to an error (Offline(E)) • unavailable: Offline due to an error (Offline(E)) • perm_loss: Offline due to an error (Offline(E)) Paths that are dead, unavailable, or perm_loss require corrective action. The appropriate action can be determined by referring to What To Do for a Path Error on page...
Page 127 [ -sfunc | -satp | -rule ] [-t] dlnkmgr [Host-Connection-Options] view -path [-iem] [-hbaportwwn] [-vmruntimename] [-vmstate] [ -hdev HostDeviceName ] [-stname] [-srt {pn | lu | cp}] [-t] dlnkmgr [Host-Connection-Options] view -path -item [pn] [dn] [lu] [cp] [type] [ic] [ie] [dnu] [hd] [iep] [hbaportwwn] [vmruntimename] [vmstate] [vmpathuid] [ -hdev HostDeviceName ] [-stname] [-srt {pn | lu | cp}] [-t] dlnkmgr [Host-Connection-Options] view -path -c...
Page 128 dlnkmgr [Host-Connection-Options] view -lu -item [ [slpr] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] [lb] [vmpsp] [vmruntimename] [vmstate] | all ] [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -c [-t] Host-Connection-Options: [ -a | --passthroughauth ] [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --sessionfile=SESSIONFILE ]...
Page 129: Utility Reference
Utility Reference This chapter explains the utilities used by HDLM. □ The DLMgetras Utility for Collecting HDLM Error Information Utility Reference Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 130: The Dlmgetras Utility For Collecting Hdlm Error Information
The DLMgetras Utility for Collecting HDLM Error Information This utility collects information that is needed to analyze HDLM errors that have occurred: information such as integrated trace files, trace files, definition files, and OS information. Whenever the host is restarted, some of the information that is collected by the DLMgetras utility will be cleared.
Page 131: List Of Collected Error Information
Logs from all applications, systems, and security event logs are obtained. maximum-file-length The utility obtains logs from each application, system, and security event log. The logs are obtained, starting from the most recent log, until the log size reaches maximum-file-length. Specify the log size in MB.
Page 132 Directory that stores Files Explanation collected files All files under log HDLM log folder-to-which-collected- information-is-output\HDLM- installation-destination- drive-name_\Program Files \HITACHI\DynamicLinkManager \log Integrated trace file output Integrated trace file hntrn.log folder specified in the Hitachi (HNTRLib2) Network Objectplaza Trace Library utility (Default: folder-to-which- collected-information-is- output\installation- destination-drive-name_...
Page 133 Directory that stores Files Explanation collected files Contents of the HNTRLib hntrlib-reg.txt registry Environment variable Path path_environ.log information Version information, sysdllexe.txt timestamps for PE format files, last modification dates, and file size information for executable files installed in the HDLM directory, HNTRLib2 directory, Hitachi common directory, and system directory.
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 then adding a file number onto the end of that. The default file names range from hntr21.log to hntr216.log. Note that 2 is part of the integrated trace file name and does not represent part of the file number.
Page 135: Messages
Messages This chapter describes the format and meaning of the message IDs, and also the terms used in the messages and message explanations. □ Before Viewing the List of Messages □ KAPL01001 to KAPL02000 □ KAPL09001 to KAPL10000 □ KAPL10001 to KAPL11000 □...
Page 136: Before Viewing The List Of Messages
Before Viewing the List of Messages This section explains the following information that is needed to locate messages and understand the explanations in the sections from KAPL01001 to KAPL02000 on page 8-3. • Format and meaning of the message IDs •...
Page 137: Kapl01001 To Kapl02000
KAPL01001 to KAPL02000 Message ID Message Text Explanation KAPL01001-I The HDLM command completed Details normally. Operation name = The HDLM command completed aa...aa, completion time = successfully. bb...bb aa...aa: clear, help, offline, online, set, or view bb...bb: Year/month/day hour:minute:second Action None.
Page 138 Message ID Message Text Explanation aa...aa: clear, set, offline, or view Action Execute help operation-name of the HDLM command (dlnkmgr) to check the parameter. Specify the correct parameter, and then retry. For details on the help operation, help (Displays the Operation Format) on page 6-5.
Page 139 Message ID Message Text Explanation Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. For details on the DLMgetras utility, see DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Page 140 Message ID Message Text Explanation KAPL01019-W The target path was not found. Details Operation name = aa...aa aa...aa: offline, online, or view offline/online operation ¢ The specified path does not exist. view operation ¢ The paths have not been configured because creation of the HDLM environment or configuration changes to the HDLM operating environment...
Page 141 Message ID Message Text Explanation KAPL01024-W The specified parameters cannot Details be specified at the same time. aa...aa: clear, offline, online, Operation name = aa...aa, set, or view parameters = bb...bb bb...bb: Parameters that cannot be specified at the same time Action Execute help operation of the HDLM command (dlnkmgr) to...
Page 142 Message ID Message Text Explanation value was entered three times in a row for a request. aa...aa: clear, offline, online, or set Action Check the correct value, and then re-execute the HDLM command. KAPL01044-W A duplicate parameter value is Details specified.
Page 143 Message ID Message Text Explanation If you want to execute the operation, enter y. If you want to terminate processing, enter n. For details on the clear operation, clear (Returns the Path Statistics to the Initial Value) on page 6-3. For details on the set operation, see set (Sets Up the Operating Environment) on page...
Page 144 Message ID Message Text Explanation was detected. PathID = aa...aa multi-path offline processing. To Would you like to continue the ignore this path and perform processing of the offline offline processing for the next operation? [y/n]: path, enter y. To cancel offline processing, enter n.
Page 145 Message ID Message Text Explanation aa...aa: CHA port Action If you want to execute online processing for the paths that meet the specified requirements, enter y. If you want to terminate processing, enter n. KAPL01058-W The specified parameter value is Details not needed.
Page 146 Message ID Message Text Explanation KAPL01061-I aa...aa path(s) were successfully Details placed bb...bb; cc...cc path(s) This message indicates the were not. Operation name = number of the paths processed in dd...dd an 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)
Page 147 Message ID Message Text Explanation path has already been set to Online/Offline(C). aa...aa: Online or Offline(C) Action Use the view operation of the HDLM command (dlnkmgr) to check the status of the path. For details on the view operation, see view (Displays Information) on page 6-22.
Page 148 Message ID Message Text Explanation KAPL01073-E The temporary license expired. Details The temporary license has expired. Register a permanent license. Action Register a permanent license. KAPL01074-E The emergency license expired. Details The emergency license has expired. Register a permanent license. Action Register a permanent license.
Page 149 Message ID Message Text Explanation aa...aa: Windows-installation- destination-drive-name \hdlm_license Action When the message that prompts you to enter the license key is displayed, enter the license key. Alternatively, cancel the HDLM command, store the license key file directly under the Windows installation-destination drive, and then re-execute HDLM command.
Page 150 Message ID Message Text Explanation Execute the HDLM ¢ command's set -lic operation while the license for a re-installation is being updated. KAPL01095-E An attempt to acquire the HDLM Details version information has failed. aa...aa: Code showing the reason details = aa...aa for the error Action Re-execute the command.
Page 151 Message ID Message Text Explanation KAPL01102-I All the paths which pass the Details specified aa...aa port will be Multiple paths will be collectively changed to the Offline(C) status. placed Offline(C) because the - Is this OK? [y/n]: hbaportwwn parameter was specified.
Page 152 Message ID Message Text Explanation anyway? Operation name = set [y/n]: KAPL01117-W An error occurred during Details processing to read the audit log An internal error occurred while configuration file. reading the audit log configuration file. Action Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM.
Page 153 Message ID Message Text Explanation options, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01136-W The specified host connection Details options cannot be specified at aa...aa: Host connection options the same time. Options = that cannot be specified at the aa...aa same time...
Page 154 Message ID Message Text Explanation KAPL01142-W The parameter aa...aa cannot be Details specified if you omitted the host aa...aa: Parameter that cannot be connection option. specified Action Execute the operation-name - help operation of the HDLM command (dlnkmgr) to check the format of the operation, and then retry.
Page 155 Message ID Message Text Explanation cc...cc: Number of paths where the online/offline operation was unsuccessful(decimal (base-10) number) dd...dd: Number of target paths for online or offline operation (decimal (base-10) number) ee...ee: online or offline Action None. For details on the online operation, see online (Places Paths Online) on page...
Page 156 Message ID Message Text Explanation KAPL01150-E The HDLM command cannot be Details executed because the VMware The HDLM command was not vSphere CLI is not installed. executed in the command prompt of VMware vSphere CLI. Action Execute the HDLM command in the command prompt of the VMware vSphere CLI.
Page 157: Kapl09001 To Kapl10000
KAPL09001 to KAPL10000 Message ID Message Text Explanation KAPL09605-I There is no license key file. File Details name = aa...aa There is no license key file in the designated folder. aa...aa: Windows-installation- destination-drive-name \hdlm_license or the-file- that-the-user-specified Action Enter a license key when prompted by a message to do so.
Page 158: Kapl10001 To Kapl11000
Message ID Message Text Explanation Re-enter the license key because an entered license key is invalid. Action Enter a valid license key. KAPL09611-E The entered license key is Details invalid. The HDLM installation The entered license key is invalid. will now terminate. Obtain a Installation is aborted.
Page 159 Message ID Message Text Explanation HDLM Error Information on page 7-2. KAPL10004-W The parameter contains an Details incorrect value. Value = aa...aa The first parameter must be a folder. aa...aa: Invalid parameter Action Check the parameters of the DLMgetras utility for collecting HDLM error information, and then retry.
Page 160 Message ID Message Text Explanation bb...bb: Year/month/day hour:minute:second Action None. KAPL10022-I The utility for collecting HDLM Details error information completed Error information has been normally. collected. Action None. For details on the DLMgetras utility, see DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Page 161 Message ID Message Text Explanation Action None. KAPL10034-E The file could not be copied. Details Filename = aa...aa, Details = Execution of the cp command bb...bb failed. aa...aa: File name you tried to copy bb...bb: cp command output message Action An error occurred while the information collection file was being copied.
Page 162 Message ID Message Text Explanation Make sure that the parameters for the DLMgetras utility for collecting HDLM error information are appropriate, and then try again. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Page 163: Kapl13001 To Kapl14000
Message ID Message Text Explanation retry. For details on the DLMgetras utility, see DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL10957-W The utility for collecting HDLM Details error information cannot be The DLMgetras utility for executed because the VMware collecting HDLM error information vSphere CLI is not installed.
Page 164: Kapl15001 To Kapl16000
KAPL15001 to KAPL16000 Message ID Message Text Explanation KAPL15060-I DLMgetras was invoked. Details Command Line = aa...aa aa...aa: Name of the utility that the user executed KAPL15061-I DLMgetras successfully Details executed. Command Line = aa...aa: Name of the utility that aa...aa the user executed KAPL15101-I...
Page 165: Kapl20001 To Kapl21000
Message ID Message Text Explanation KAPL15110-W An attempt to display Details information about HDLM- aa...aa: Command that the user management targets has failed. executed Command Line = aa...aa KAPL15111-W The HDLM command was Details started or stopped by the user aa...aa: Command that the user who does not have the executed...
Page 166 Message ID Message Text Explanation KAPL20023-E The state of path (aa...aa) was Details changed from bb...bb to cc...cc. The path state changed to a state where I/Os cannot be issued. aa...aa: Name of Path that changed state bb...bb: Path state before change cc...cc: Path state after change Action Check the status of the path...
Page 167 Message ID Message Text Explanation Action Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. For details on the DLMgetras utility, see DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Page 168 Message ID Message Text Explanation vendor or the maintenance company if there is a maintenance contract for HDLM. For details on the DLMgetras utility, see DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL20043-W The state of path (aa...aa) was Details not able to be updated.
Page 169: Kapl21001 To Kapl22000
KAPL21001 to KAPL22000 Message ID Message Text Explanation KAPL21001-I The initialization of the Details pspPlugin (aa...aa) was The initialization of the successful. HTI_PSP_HDLM plugin has successful. aa...aa: HTI_PSP_HDLM_EXLBK, HTI_PSP_HDLM_EXLIO, or HTI_PSP_HDLM_EXRR Action None. KAPL21009-I The termination of the pspPlugin Details (aa...aa) was successful.
Page 170 8-36 Messages Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 171: Acronyms And Abbreviations
Acronyms and abbreviations The following acronyms and abbreviations might be used in this guide. Arbitrated Loop Application Programming Interface Addtional Sense Code ASCQ Addtional Sense Code Qualifier BIOS Basic Input / Output System Channel Adapter CLPR Cache Logical Partition Acronyms-1 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 172 Central Processing Unit Control Unit DBMS Database Management System Device Domain Name Server Fibre Channel FC-SP Fibre Channel Security Protocol Failover FQDN Fully Qualified Domain Name Greenwich Mean Time Host Bus Adapter Acronyms-2 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 173 HDev Host Device Host Logical Unit HTTP Hypertext Transfer Protocol Input/Output Internet Protocol iSCSI Internet Small Computer System Interface Local Area Network LDAP Lightweight Directory Access Protocol LDEV Logical Device Logical Unit Logical Unit Number Network Attached Storage Acronyms-3 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 174 Native Multipathing Plugin Network Time Protocol Operating System Port Path Selection Plugin RADIUS Remote Authentication Dial in User Service Storage Area Network SATP Storage Array Type Plugin SCSI Small Computer System Interface SLPR Storage Logical Partition SNMP Simple Network Management Protocol Acronyms-4 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 175 Service Pack Secure Sockets Layer Service Processor User Identifier World Wide Name Acronyms-5 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 176 Acronyms-6 Hitachi Dynamic Link Manager User Guide (for VMware(R))
Page 177 Glossary This glossary explains the terms used in this manual. automatic failback A function for checking the status of paths at regular intervals, and automatically placing the status of a path recovered from an error into the Online status. If a path with an Offline(E) status recovers from an error, an automatic failback will place the path Online.
Page 178 CLPR(Cache Logical Partition) A function supported by the Universal Storage Platform V/VM, Virtual Storage Platform, and Hitachi AMS2000/AMS/WMS/SMS series for logically splitting up a cache. This function can split up a cache into parity groups in the storage system, so that other parity groups do not affect the cache performance.
Page 179: Load Balancing
HBA (Host Bus Adapter) Device that functions as an interface connecting a host with external devices. In this manual, the term HBA refers to an interface card installed in a host, in configurations where the host and storage units are connected via a FC connection. HDLM driver A program that controls all the HDLM functions, manages paths, and detects errors.
Page 180 Load balancing uses VMware vSphere PSPs. HDLM can use the following load balancing algorithms: - The Extended Round Robin algorithm - The Extended Least I/Os algorithm - The Extended Least Blocks algorithm - The Most Recently Used algorithm (VMware) - The Round Robin algorithm (VMware) LU (Logical Unit) A logical unit that is a logical volume defined in the storage system, and with which the host can perform input or output operations.
Page 181 path An access path from a host to a storage system. Access to an area within an LU in a storage system is made via a cable connecting the HBA on the host and the CHA on the storage system. This cable is a path. Each path has an AutoPATH_ID. (See also: AutoPATH_ID) path health checking A function for checking the status of paths at regular intervals.
Page 182 SCSI device 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 manage each resource independently.
Page 183 Index command of HDLM (dlnkmgr) clear audit log help categories and audit events that HDLM can offline output 2-25 online 6-11 collecting data 2-23 6-15 data format 2-27 view 6-22 automatic failback 2-13, Glossary-1 components automatic failover 2-11 HDLM system components automatic path switching 2-11 Critical...
Page 184 overview re-installation Elements of a path name 6-38 setup emulation type Glossary-2 system configuration Error uninstalling 3-15 error information 2-22 HDLM command checking in messages HDLM driver 2-5, Glossary-3 collecting with DLMgetras HDLM environment list of error info. collected by the DLMgetras creating utility for collecting error info.
Page 185 Intermittent Error Monitoring 3-11 operating environment 6-15 setting 6-15 viewing [view operation] 6-26, 6-28 Operation name operations 6-2, 6-3 LDEV (Logical Device) Glossary-3 displaying format load balancing 1-3, 2-6, 3-10, 6-16, Glossary-3 of the HDLM command load balancing algorithms logical unit overview command configuration...
Page 186 remote management client 6-27 Viewing Path Information remote management client 1-2, Glossary-5 Warning reservation Glossary-5 what is HDLM? what to do for program error 5-5, 5-6 SAN (Storage Area Network) Glossary-5 SCSI device Glossary-6 6-15 setup HDLM integrated traces 3-13 SLPR(Storage Logical Partition) Glossary-6 statistics...
Page 187 Hitachi Dynamic Link Manager User Guide (for VMware(R))
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 info@hds.com Asia Pacific and Americas 750 Central Expressway Santa Clara, California 95050-2627 U.S.A. Phone: 1 408 970 1000 info@hds.com Europe Headquarters Sefton Park Stoke Poges Buckinghamshire SL2 4HD...

This manual is also suitable for:

Dynamic link manager

Hitachi XP P9500 User Manual

1 Overview of Hdlm

2 HDLM Functions

3 Creating an HDLM Environment

4 HDLM Operation

5 Troubleshooting

6 Command Reference

7 Utility Reference

8 Messages

Quick Links

Related Manuals for Hitachi XP P9500

Summary of Contents for Hitachi XP P9500

This manual is also suitable for:

Table of Contents