Hitachi Command Suite Dynamic Link Manager (for VMware®) User Guide Document Organization Product Version Getting Help Contents MK-92DLM130-07
© 2014 Hitachi, Ltd. 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. Hitachi, Ltd., reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use.
Contents Preface.................................................................................................. ix Intended audience..................................................................................................... x Product version..........................................................................................................x Release notes............................................................................................................ x Document revision level..
Automatic Failbacks............................................................................... 2-15 Manual Path Switching.................................................................................... 2-16 Path Status Transition..................................................................................... 2-17 The Online Path Statuses....................................................................... 2-17 The Offline Path Statuses..........................................................
Setting Up HDLM.................................................................................................. 3-15 Checking the Current Settings..........................................................................3-16 Setting Up the HDLM Functions........................................................................3-16 Setting Up Load Balancing..................................................................... 3-17 Setting Up Intermittent Error Monitoring.......................................
What To Do for Other Errors....................................................................................5-6 6 Command Reference.............................................................................6-1 Overview of the HDLM Command dlnkmgr................................................................6-2 clear (Returns the Path Statistics to the Initial Value)................................................ 6-3 Format............................................................................
Utility Reference................................................................................... 7-1 Overview of the Utilities.......................................................................................... 7-2 The DLMgetras Utility for Collecting HDLM Error Information......................................7-2 Format.............................................................................................................7-2 Parameters......................................................
viii Hitachi Dynamic Link Manager (for VMware®) User Guide
Preface This document describes how to use the Hitachi Dynamic Link Manager.
Intended audience This document is intended for storage administrators who use Hitachi Dynamic Link Manager (HDLM) to operate and manage storage systems, and assumes that readers have: • Knowledge of VMware vSphere and its management functionality • Knowledge of Storage system management functionality Product version This document revision applies to HDLM for VMware version 8.0.0 or later. Release notes Read the release notes before installing and using this product.
Chapter/Appendix Description Chapter 1, Overview of HDLM on page 1-1 Gives an overview of HDLM, and describes its features. Chapter 2, HDLM Functions on page 2-1 Describes management targets and the system configuration of HDLM, and the basic terms and functions for HDLM. Chapter 3, Creating an HDLM Environment on page 3-1 Describes the procedures for building an HDLM environment (including installing and setting up HDLM), and describes for canceling the settings.
Convention Italic Description Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: copy source-file target-file Note: Angled brackets (< >) are also used to indicate variables. Monospace Indicates text that is displayed on screen or entered by the user. Example: # pairdisplay -g oradb < > angled brackets Indicates a variable, which is a placeholder for actual text provided by the user or system.
Logical capacity unit Value 1 KB 1,024 (210) bytes 1 MB 1,024 KB or 1,0242 bytes 1 GB 1,024 MB or 1,0243 bytes 1 TB 1,024 GB or 1,0244 bytes 1 PB 1,024 TB or 1,0245 bytes 1 EB 1,024 PB or 1,0246 bytes Accessing product documentation The HDLM user documentation is available on the Hitachi Data Systems Portal: https://portal.hds.com. Check this site for the most current documentation, including important updates that may have been made after the release of the product.
xiv Preface Hitachi Dynamic Link Manager (for VMware®) User Guide
1 Overview of HDLM HDLM is a software package that manages paths between a host and a storage system. HDLM is designed to distribute loads across multiple paths and will switch a given load to another path if there is a failure in the path that is currently being used, thus improving system reliability. This chapter gives an overview of HDLM and describes its features.
What is HDLM? With the widespread use of data warehousing and increasing use of multimedia data, the need for high-speed processing of large volumes of data on networks has rapidly grown. To satisfy this need, networks dedicated to the transfer of data, such as SANs, are now being used to provide access to storage systems. HDLM manages the access paths to these storage systems.
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. For details on load balancing, see Distributing a Load Using Load Balancing on page 2-8. The ability to continue running operations between a host and storage system, even if there is a failure.
1-4 Overview of HDLM Hitachi Dynamic Link Manager (for VMware®) User Guide
2 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.
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.
Figure 2-1 Configuration of an HDLM System When Using an FC-SAN The following table lists the HDLM system components when using an FCSAN. Table 2-1 HDLM System Components When Using an FC-SAN Components Description HBA A host bus adapter. This serves as a cable port on the host. FC-SAN A dedicated network that is used for the transfer of data between hosts and storage systems CHA A channel adapter P A port on a CHA. This serves as a cable port on a storage system.
system is called a port (P) on a channel adapter (CHA) used for iSCSI connections. A logical unit (LU), which lies in a storage system, is either an input target or an output target to or from a host. The areas within an LU are called Devs. A route that connects a host to a Dev in an LU is called a path. HDLM assigns a unique ID to each management-target path. This ID is called AutoPATH_ID. Sometimes, the path is also just simply called a management target.
Figure 2-3 Configuration of an IP-SAN System When Using iSCSI Software and an NIC Table 2-2 HDLM System Components When Using an IP-SAN on page 2-5 lists the HDLM system components when using an IP-SAN. Table 2-2 HDLM System Components When Using an IP-SAN Components Description iSCSI software The driver software that contains the iSCSI initiator function iSCSI HBA A host bus adapter that contains the iSCSI initiator function. This serves as a cable port on a host.
LU Configuration The following figure shows the LU configuration recognized by the host, after the installation of HDLM. Figure 2-4 LU Configuration Recognized by the Host After the Installation of HDLM The following table lists and describes the components recognized by the host. Table 2-3 Components Recognized by the Host Components Description HLU An LU that the host recognizes via the HDLM driver. This type of LU is called a host LU.
Figure 2-5 Configuration of the HDLM Programs The following table lists and describes the functions of these programs.
HDLM driver and NMP positions The HDLM driver and NMP are positioned above the SCSI driver, causing each application on a guest OS to access LUs in the storage system via the HDLM driver and NMP. The following figure shows the positioning of the HDLM driver and NMP. Figure 2-6 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.
Figure 2-7 Flow of I/O Data When the Load Balancing Function Is Not Used on page 2-9 shows the flow of I/O data when the load balancing function is not used. Figure 2-8 Flow of I/O Data When the Load Balancing Function Is Used on page 2-10 shows the flow of I/O data when the load balancing function is used. Both figures show examples of I/O operations being issued for the same LU by multiple applications.
Figure 2-8 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.
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-9 Overview of Load Balancing on page 2-11, suppose that in the owner controller of LU0 is CHA0. When the LU is accessed, the load is balanced between the two paths A and B, which are both owner paths.
Load Balancing Algorithms The load balancing function uses VMware vSphere PSPs or PSPs provided by HDLM. The following table lists the load balancing algorithms that HDLM can use.
You can specify the load balancing function by the dlnkmgr command's set operation. For details on the set operation, see set (Sets Up the Operating Environment) on page 6-16. 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.
For details on error levels, see Table 8-1 Format and Meaning of the Message ID KAPLnnnnn-l on page 8-2 in Format and Meaning of Message IDs on page 8-2.. 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-10 Path Switching on page 2-15, the owner controller of an LU is CHA0, and access to the LU is made via only one path (A).
Figure 2-10 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 nonowner paths.
When an intermittent error#2 occurs in a path, automatic failback repeatedly places the path offline and then online again, which can cause I/O performance to drop. In this case, we recommend that you configure intermittent error monitoring to exclude paths with intermittent errors from the automatic failback process. Automatic failback is implemented by functionality provided by VMware vSphere ESXi, and cannot be disabled. Intermittent error monitoring can be specified in the HDLM command's set operation.
then from online non-owner paths. When the Universal Storage Platform V/VM series, Virtual Storage Platform series, VSP G1000 series, Hitachi AMS2000 series#, Hitachi SMS series#, or HUS100 series# is being used, because all the paths are owner paths, the path to use is not switched even if you change the path status to online. # This storage system applies when the dynamic I/O path control function is disabled.
The status indicating that an I/O could not be issued on a given path, because an error occurred on the path. The (E) in Offline(E) indicates the error attribute, which indicates that an error occurred in the path. Correspondence between VMware vSphere and HDLM path statuses The following table shows the correspondence between the path statuses displayed by VMware vSphere and the path statuses displayed in the output of the HDLM command's view operation.
Online 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. Figure 2-12 Path Status Transitions (P-VOL in HAM environment) Legend: Online 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.
Note: If there is a path failure immediately after a path is placed offline by using the dlnkmgr command, Offline(C) might change to Offline(E). If an offline operation was performed, wait for a fixed period of time (about 2 minute), check the path status by using the dlnkmgr command, and make sure that the status has changed to Offline(C). If it is Offline(E), retry the offline operation.
Intermittent Error Monitoring Actions During intermittent error monitoring, HDLM manages the history of errors# that occurred on each path. If an error occurs on a path, HDLM counts the number of errors that occurred within the time period specified as the error monitoring interval, immediately before that error occurred. If the number reaches the specified condition, then an intermittent error will occur on the path.
change the paths to the blocked state (Offline(C)) before you change the intermittent error monitoring setting. You can check whether intermittent error monitoring is being performed for a path, by executing the HDLM command's view -path operation with the -iem parameter specified, and then checking the displayed IEP item. If a numerical value of 0 or greater is displayed for this item, intermittent error monitoring is being performed on the path.
# For using the dynamic load balance controller function there are restrictions on the versions of the microprograms you install. For details, see the release notes of HDLM. Dynamic I/O Path Control Function In a storage system in which the dynamic load balance controller function is installed, enable the dynamic I/O path control function to make the HDLM load balancing effective.
Figure 2-13 Flow of Data When Path Error Information Is Collected 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 about errors that occurred on ESXi hosts and on a remote management client. • Log data for errors that occurred on the ESXi host is output to syslog on the ESXi host, This log data corresponds to I/O errors and to changes in path status.
Table 2-8 Types of ESXi Host Error Information Log name Syslog Description Output destination Information about detected errors is The default file path collected. is /var/log/vmkernel.log. 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 in Format and Meaning of Message IDs on page 8-2.
In Windows Server 2003 (excluding the x86 edition) and Windows Server 2008 (excluding the x86 edition), Program Files is Program Files (x86). #2 The underlined part indicates a folder specified during installation. After obtaining these files, be sure to also copy them to a backup location. Collecting Error Information You need to collect HDLM error information both from the ESXi host and from remote management clients.
Table 2-10 Categories of Audit Log Data That Can Be Collected Category StartStop Explanation An event indicating the startup or termination of hardware or software, including: • OS startup and termination • Startup and termination of hardware components (including micro-program) • Startup and termination of software running on storage systems, software running on SVPs (service processors), and Hitachi Command Suite products An abnormal hardware or software event, including: Failure LinkStatus • H
Category Explanation • Maintenance AnomalyEvent Viewing or updating audit log settings An event indicating that a maintenance operation has terminated normally or failed, including: • Adding or removing hardware components • Adding or removing software components An event indicating an abnormal state such as exceeding a threshold, including: • Exceeding a network traffic threshold • Exceeding a CPU load threshold • Reporting that the temporary audit log data saved internally is close to its ma
Category Explanation Audit event Severity #1 Message ID 6 KAPL15061-I Administrator or Permission has end-user not been granted authentication to execute the HDLM command. 4 KAPL15111-W Permission has not been granted to start or stop the HDLM manager. 4 KAPL15404-W Initialization of path statistics was successful. 6 KAPL15101-I Initialization of path statistics failed. 4 KAPL15102-W An attempt to place a path online or offline was successful.
Category Explanation Audit event Severity #1 Message ID An attempt to display HDLM managementtarget information failed. 4 KAPL15110-W The status of a path was successfully changed to Online. 6 KAPL15116-I #1 The severity levels are as follows: 4: Warning, 6: Information #2 If you use Ctrl + C to cancel the DLMgetras utility for collecting HDLM error information, audit log data indicating that the DLMgetras utility has terminated will not be output.
You can also filter the audit log output by specifying a severity level and type for the HDLM command's set operation. Filtering by severity: The following table lists the severity levels that can be specified.
information,agent-information,host-sending-request,port-numbersending-request,host-receiving-request,port-number-receivingrequest,common-operation-ID,log-type-information,applicationidentification-information,reserved-area,message-text Up to 950 bytes of text can be displayed for each message-section. Table 2-13 Items Output in the Message Section Item# Explanation Common identifier Fixed to CELFSS Common specification revision number Fixed to 1.
Item# Explanation Application identification information Program identification information Reserved area This field is reserved. No data is output here. Message text Data related to the audit event is output. #: The output of this item depends on the audit event. Example of the message section for the audit event An attempt to display HDLM management-target information was successful: CELFSS,1.1,0,KAPL15109-I, 2008-04-09T10:18:40.
Figure 2-14 Example System Configuration Using HDLM and Global Link Manager 2-34 HDLM Functions Hitachi Dynamic Link Manager (for VMware®) User Guide
3 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 Check the following before installing HDLM: For the requirements for using HDLM in an HAM environment, see the release notes of HDLM. Hosts and OSs Supported by HDLM HDLM can be installed on computers running the following operating systems: Host OS support The following versions of VMware vSphere ESXi are supported as an OS for host computers: • VMware vSphere ESXi 5.0 Enterprise Edition/Enterprise Plus Edition • VMware vSphere ESXi 5.
A remote management client can run on a machine in the same LAN as the host, or on a guest OS installed on the host itself. VMware vSphere CLI 5.0/5.1/5.5 is a prerequisite program for a remote management client. Make sure that VMware vSphere CLI is installed before installing HDLM.
Disk Requirements The disk space requirements for hosts and remote management clients are as follows: • Host 600KB • Remote management client 175 MB Number of LUs and Paths That Are Supported in HDLM The following table lists the number of LUs and paths that are supported by HDLM.
Installing HDLM on a server on which HDLM has not been installed is called a new installation of HDLM. Upgrade installation of HDLM: Installing a newer version of HDLM over the existing version without removing the existing version is called an upgrade installation of HDLM. Re-installation of HDLM: A re-installation of HDLM involves installing the same version of HDLM again to repair an existing installation. You must remove HDLM before reinstalling it.
• At the auto deploy server, apply the host profile of the relevant host. Unless you apply the host profile, HDLM setting changes will not be saved when the host restarts. If you install HDLM while the Startup Type setting for the Windows Installer service is disabled or while another program is using the Windows Installer service, the installation might fail. If this problem occurs, make sure that both of the above conditions are satisfied, and then install HDLM again.
When performing a new installation on a remote management client, you can perform an unattended installation by using the HDLM install utility (installhdlm). An unattended installation enables a user to install HDLM without entering information during processing. For details on the installhdlm utility, see The installhdlm Utility for Installing HDLM on page 7-8.
HDLM Manager Ver WakeupTime Alive x.x.x-xx yyyy/mm/dd hh:mm:ss License Type Expiration Permanent KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> If x.x.x-xx is displayed in HDLM Version, the correct version of HDLM has been installed. Having installed HDLM on the remote management client, go to New installation on host on page 3-9.
drive-containing-installation-DVD-ROM:\HDLM_VMware\DLMTools \installhdlm -f installation-information-settings-file 6. Check the results of the installation. At the command prompt, check the unattended installation results displayed by the installhdlm utility. 7. Restart the remote management client. 8. Log on to Windows on the remote management client as a member of the Administrators group. 9. Launch the Administrator: Command Prompt window. 10.
Execute the following command to check the current acceptance level of the host: esxcli --server=host-name --username=user-name -password=password software acceptance get Save the command output. You will need it if you remove HDLM in the future. After saving the command output, execute the following command to change the host acceptance level: esxcli --server=host-name --username=user-name -password=password software acceptance set -level=PartnerSupported 4. Install HDLM on the host.
password=password storage nmp satp rule add -V HP -M "^OPEN*" -s HTI_SATP_HDLM 7. Check the path configuration according to the procedure described in Checking the Path Configuration on page 3-15. 8. If you are managing HDLM by using Global Link Manager, set up the host and remote management client by following the procedure described in Settings When Managing HDLM by Using Global Link Manager on page 3-11.
Host settings • Create a user account. Remote management client settings • Add the host to the Credential Store file. • Execute the utility for configuring HDLM remote management client environments (dlmrmcenv). • Specify Windows Firewall settings. Creating a user account A user account used for performing operations on the host from the remote management client needs to be created on the host. Use either of the choices below for the user account name.
In addition, if you add the host by specifying the host name from Global Link Manager, configure the settings so that the host name of the ESXi host on the remote management client can be resolved to the IP address. The Credential Store file stores the host information (host name, user name, and password) that is managed by VMware vSphere CLI. The default storage location of the Credential Store is as follows: %APPDATA%\VMware\credstore\vicredentials.
2. Execute the firewall_setup command. 3. Check the displayed message to make sure that the command was executed successfully. The command ended successfully. firewall_setup command syntax The firewall_setup command registers ports used by Hitachi Command Suite Common Agent Component into the exceptions list of Windows Firewall running on the remote management client. The firewall_setup command is stored in the following location, depending on whether the Device Manager agent is installed.
Note: The folder that stores the Hitachi Command Suite Common Agent Component commands is automatically added to the PATH environment variable of the remote management client. So, when executing the command, there is no need to move the current folder to the folder storing the command. Checking the Path Configuration HDLM functions, such as load balancing and failover, are only available for HDLM management-target devices that have more than one active path.
Checking the Current Settings Check the current settings by executing the following command to set the HDLM functionality by using the dlnkmgr command's view operation. PROMPT>dlnkmgr -s host-name -u user-name -p password view -sys -sfunc HDLM Version : x.x.x-xx Service Pack Version : Load Balance : on(extended lio) Intermittent Error Monitor : off Dynamic I/O Path Control : off(10) KAPL01001-I The HDLM command completed normally.
Function Default value Recommended value Set on, if you want to collect audit log data. # This function is applied only when Hitachi AMS2000 series, Hitachi SMS series, or HUS100 series storage is used. Setting Up Load Balancing You can select whether to enable load balancing. The following is an example of using a command to set load balancing.
To enable intermittent error monitoring, specify on. To disable intermittent error monitoring, specify off. When you specify on, you can use the -intvl and -iemnum parameters to specify intermittent error conditions (the conditions used by the system to determine whether an intermittent error is occurring). In the -intvl parameter, specify the monitoring interval for an intermittent error. In the -iemnum parameter, specify the number of times that the error is to occur.
Value (severity) 6 Explanation Error-level, Warning-level, and Information-level audit log data is collected. 7 The table below lists and describes the values for the audit log category setting.. The default is all. Table 3-6 Values Indicating Audit Log Data Categories Value Explanation ss Audit log events of the StartStop category are collected. a Audit log events of the Authentication category are collected. ca Audit log events of the ConfigurationAccess category are collected.
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 PROMPT> Setting Up Integrated Traces When you use HDLM, the activity logs of the HDLM command are output to the integrated trace information file(program-installation-destination-drive: \Program Files#\HITACHI\HNTRLib2\spool\hntr2n.
Network Objectplaza Trace Library (HNTRLib) is already installed, the settings will not be inherited. To change the integrated trace file settings: 1. On the remote management client, double-click the following file in Explorer: program-installation-destination-drive:\Program Files#\HITACHI \HNTRLib2\bin\hntr2utl2.exe # For Windows 7 (x64) , Windows Server 2008, and Windows Vista (x64), Program Files is Program Files (x86). The following dialog box appears.
5. In Interval Timer(Sec), enter a value to shorten the monitoring cycle. The default is 10 (seconds). You can specify a value from 1 to 300. 6. In Lookout Span(Sec), enter a value to specify the interval for monitoring the number of messages to be output to the integrated trace file. The default is 0 (seconds). You can specify a value from 0 to 3600. If you specify 0, you cannot adjust the number of messages to be output because the system ignores the setting of Max Messages / Span. 7.
• If firewall exceptions have been registered by using the firewall_setup command, remove them. Make sure that you do not use another Hitachi Command Suite product to manage the host after removing HDLM. For details about the firewall_setup command, see the description of firewall_setup syntax in Specify Windows Firewall settings on page 3-13 of Settings When Managing HDLM by Using Global Link Manager on page 3-11. Removing HDLM The procedure for removing HDLM is described below.
: naa.60060e8006cf2e000000cf2e00000039 Device Display Name: HITACHI Fibre Channel Disk (naa.
4 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 This section explains how to use the HDLM command. For details on the various command operations, see Chapter 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. • To specify a parameter value containing one or more spaces, enclose the entire value in double quotation marks (").
PROMPT> For details on the displayed items and their descriptions, see view (Displays Information) on page 6-25. 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: 1. Check the current status of the paths. To place paths online by specifying a CHA port, single path, or HBA port WWN, check the path name or PATH_ID used to manage the path.
dlnkmgr -s host-name -u user-name -p password view -path 2. 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. For example, to place a specific path offline, execute the HDLM command's offline operation with the -pathid parameter specified.
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. 1. Check the current status of the path.
PROMPT> 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: PROMPT>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 PROMPT> For details on the displayed items and their descriptions, see view (Displays Information) on page 6-25.
To display license information, execute the dlnkmgr command's view operation with the -sys and -lic parameters specified. The following is an example of executing the command: PROMPT>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 PROMPT> For details on the displayed items and their descriptions, see view (Displays Information) on page 6-25.
To display HDLM version information, execute the dlnkmgr command's view operation with the -sys parameter specified. The following is an example of executing the command: To check the version of HDLM installed on a host: PROMPT>dlnkmgr -s host-name -u user-name -p password view -sys HDLM Version : x.x.
Among the displayed items, HDLM Manager indicate the HDLM component information. Starting and Stopping the HDLM Manager If an error occurs in the system, such as in an HDLM program, you might need to manually stop or start HDLM to recover from the error. Starting the HDLM Manager During installation of the remote management client, the HDLM manager is registered as a Windows service and the startup type is set to Automatic.
Dead KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> When the HDLM Manager column shows Dead, the HDLM manager is inactive. HDLM Resident Processes The table below lists and describes the resident processes in HDLM. To monitor these processes, use the names below. Table 4-1 HDLM resident processes Process Service Description dlmmgr.exe HDLM Manager for VMware HDLM manager process hbsa_service.
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 resolutions for path errors, HDLM program errors, and other types of errors are all described separately. If you need technical support, see Getting help on page xiii.
Collecting Error Information Collect the error information immediately after an error occurs. If the computer is restarted, the error information might be deleted and you will be unable to collect it. For details about how to collect error information, see Collecting Error Information on page 2-26. Checking Error Information in Messages You can check path errors by referring to the KAPL20023-E message output to the syslog.
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. 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. For details on each item displayed in messages, see Checking Error Information in Messages on page 5-2.
Narrowing Down the Hardware That Might Have Caused the Error Check the DskName, iLU, ChaPort, and HBAPortWWN columns of the path with the error to narrow down the hardware that may be the cause of the error. To physically identify the hardware corresponding to DskName, iLU, and ChaPort, use the information provided by the storage-system management program.
Figure 5-3 Troubleshooting Procedure When a Program Error Occurs The following shows the procedure for handling a program error by using the HDLM command (dlnkmgr). Examining the Messages Examine the messages that are output to the host syslog. If an error occurs in an HDLM program, a message is output to syslog. Examine the content of the message. Messages with error level E (Error) or higher require corrective action.
dlnkmgr -s host-name -u user-name -p password view -sys If the KAPL01013-E message is output after the command is executed, restart the host. If the same error re-occurs after you thought you had resolved the problem, go to the subsection Contacting your HDLM Vendor or Maintenance Company on page 5-6. Contacting your HDLM Vendor or Maintenance Company If the error cannot be resolved, contact your HDLM vendor or maintenance company, and report the information that was collected by the DLMgetras utility.
6 Command Reference This chapter describes the HDLM command (dlnkmgr) and its operations.
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 [parametervalue]] dlnkmgr The command name. connection-options The information required to log in to the target host. operation The type of operation. parameter A value required for an operation.
Table 6-1 Operations of the dlnkmgr Command Operation Functions clear Initializes(0) the statistics (I/O count and I/O errors) of all paths managed by the HDLM system. For details, see clear (Returns the Path Statistics to the Initial Value) on page 6-3. help Displays the format of the operations used for HDLM. For details, see help (Displays the Operation Format) on page 6-5. offline Places offline an online path or paths. For details, see offline (Places Paths Offline) on page 6-7.
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 PROMPT>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. Operation name = clear, completion time = yyyy/mm/dd hh:mm:ss PROMPT> -s Executes the command without displaying a message asking for confirmation of command execution from the user.
[ --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 PROMPT> 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. Format dlnkmgr [-s host-name -u user-name -p password] help [operation] [operation] ...
[ -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 ] [ --servicepath=SERVICEPATH ]] KAPL01001-I The HDLM command completed normally.
-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] 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 | --userna
check how many online paths remain. For details about the view operation, see view (Displays Information) on page 6-25.
The following example shows how to place offline all the paths connected to the CHA port 0A. In this example, a path whose AutoPATH_ID is 000001 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. PROMPT>dlnkmgr offline -cha -pathid 000001 KAPL01055-I All the paths which pass the specified CHA port will be changed to the Offline(C) status.
the Offline(C) 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 KAPL01061-I 1 path(s) were successfully placed Offline(C); 0 path(s) were not. Operation name = offline PROMPT> -s Executes the command without displaying the message asking for confirmation of command execution from the user.
[ [ [ [ [ [ --credstore=CREDSTORE ] --passthroughauthpackage=PASSTHROUGHAUTHPACKAGE ] --portnumber=PORTNUMBER ] --protocol=PROTOCOL ] --savesessionfile=SAVESESSIONFILE ] --servicepath=SERVICEPATH ] Valid value AutoPATH_ID { 000000 - 999999 }(Decimal) KAPL01001-I The HDLM command completed normally.
[-s] To Display the Format of the Online Operation dlnkmgr [-s host-name -u user-name -p password] online -help Parameters To place paths Online -path Indicates that the target of the operation is a path managed by HDLM. This parameter is optional because online is always used for paths, so it is assumed. Specify the paths to be taken online by using the -cha, -pathid, or hbaportwwn parameter. If you do not specify any of these parameters, the command will place all the offline paths online.
KAPL01061-I 2 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online PROMPT> -pathid AutoPATH_ID Use this parameter to place a single path online. Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see view (Displays Information) on page 6-25.
of all the paths in the Online(S) and Online(D) statuses, specify only hapath. -dfha Use this parameter to change the paths to the primary volume (P-VOL) in an HAM environment to Online(D). The Online(S) status changes to the Online(D) status. When you do not specify this parameter, the status of the P-VOL paths in the HAM environment will be changed to the Online(S) status.
dlnkmgr [Host-Connection-Options] online [-path] -cha -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] online [-path] -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] online [-path] -hbaportwwn HBA_Port_WWN [-s] dlnkmgr [Host-Connection-Options] online [-path] -hapath [-lu -pathid AutoPATH_ID] [-s] dlnkmgr [Host-Connection-Options] online [-path] -dfha [lu -pathid AutoPATH_ID] [-s] Host-Connection-Options: [ -a | --passthroughauth ] [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --se
set (Sets Up the Operating Environment) The dlnkmgr command's set operation sets the HDLM operating environment.
Parameters To Set the Host Operating Environment The table below 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 Recommended value Load balancing The Extended Least I/Os algorithm is used. The recommended algorithm depends on the operating environment.
path, HDLM assumes that an intermittent error is occurring on the path. A path that is assumed to have an intermittent error is excluded from automatic failback. Intermittent error monitoring is performed on each path.
paths managed by HDLM, and the information of the paths excluded from automatic failback are initialized. Intermittent error monitoring continues. -expathusetimes number-of-path-use-times Specifies the number of times the same path can be used for sequential I/O operations when the extended Round Robin (exrr), Least I/Os (exlio), or Least Blocks (exlbk) algorithm is used for load balancing. You an specify a decimal (base 10) value from 1 to 999999. The default is 100.
If you use a license key file: Store the license key file named hdlm_license directly under the Windows installation drive, and then execute the set -lic operation. A message confirming that the license key has been registered is displayed, depending on the license key type defined in the license key file. When a temporary license key or emergency license key has been registered, the expiration period is displayed (KAPL01071-I, KAPL01072-I).
PROMPT>dlnkmgr -l set -lic KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: y KAPL01083-I There is no license key file. File name =Windows-installation-destination-drive-name\hdlm_license KAPL01068-I Enter a license key:************* KAPL01071-I A permanent license was installed. PROMPT> -audlog {on [-audlv audit-log-data-collection-level] [category [[ss] [a] [ca]|all]]|off} Specifies whether to collect audit log data. on: Audit Log data is collected.
Value Explanation ca Audit log events of the ConfigurationAccess category are collected. all Audit log events of the StartStop, Authentication, and ConfigurationAccess categories are collected. -pstv {on|off} Enables or disables the display of the physical storage system information. The default value is "off". on: Enabled off: Disabled If the display of the physical storage system information is enabled, information about the physical storage system is displayed.
Examples Example 1 The following example displays the format of the operation for both a host and remote management client: PROMPT>dlnkmgr set -help set: Format dlnkmgr [Host-Connection-Options] set { -lb on -lbtype { exrr | exlio | exlbk | vmwmru | vmwrr } | -iem on [ -intvl Error-Monitor-Interval ] [ -iemnum Number-Of-Times ] | -iem off | -expathusetimes Number-Of-ExPathUseTimes | -dpc { on | off } [-pathid AutoPATH_ID { -lu | storage } ] | -dpcintvl Dpc-Interval } [-s] dlnkmgr -l set { -lic | -audlog on
PROMPT> Example 2 The following example displays the format of the operation for a host: PROMPT>dlnkmgr -s host-name -u user-name -p password set -help set: Format dlnkmgr [Host-Connection-Options] set { -lb on -lbtype { exrr | exlio | exlbk | vmwmru | vmwrr } | -iem on [ -intvl Error-Monitor-Interval ] [ -iemnum Number-Of-Times ] | -iem off | -expathusetimes Number-Of-ExPathUseTimes | -dpc { on | off } [-pathid AutoPATH_ID { -lu | storage } ] | -dpcintvl Dpc-Interval } [-s] Host-Connection-Options: [ -a |
Valid value AudlogLevel Category-Value | -audlog on [ -audlv AudlogLevel ] [ -category Category-Value ] | -audlog off } [-s] { 0 - 7 } (Default Value 6) { [ss] [a] [ca] | all } (Default Value all) KAPL01001-I The HDLM command completed normally. Operation name = set, completion time = yyyy/mm/dd hh:mm:ss PROMPT> view (Displays Information) The dlnkmgr command's view operation displays HDLM program information, path information, and LU information.
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] [phys] [virt] [vid] [ha] [-pstv|-vstv] [-hdev host-device-name] [-stname] [-srt {pn|lu|cp}] [-t] To display path information (by abbreviating the list items) dlnkmgr [-s host-name -u user-name -p password] view -path -c [-pstv|-vstv] [-stname] [-srt {lu|cp}] [-t] To Display LU Info
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 To display the format of the operation for a host: dlnkmgr -s host-name -u user-name -p password view -help To display the format of the operation for a remote management client: dlnkmgr -l view -help Parameters (To display program information) This section describes the parameters for the view operation, in the following order: To Display Program Information f
Table 6-7 Items of program information (for hosts) Parameter and program information to be displayed -sfunc Item HDLM Version Information Service Pack about the HDLM Version function settings Load Balance Description HDLM version number HDLM SP version number. This item is blank if no SP is present. Settings for load balancing • Setting status: on: Enabled • Algorithm: One of the following load balancing algorithms is displayed in the parentheses following on.
Parameter and program information to be displayed Item Description The parentheses following the setting status shows the checking interval for reviewing information about the switching of controllers performed by the storage system. "Minute" is used as the unit. If different settings have been specified for each storage system or LU, * is added after the parentheses in which the checking interval is displayed.
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> Example 2 The following example shows how to display the number of times the same path can be used for extended load balancing: PROMPT>dlnkmgr view -sys -expathusetimes Times Same ExPath Was Used : 100 KAPL01001-I The HDLM command completed normally.
Table 6-8 Items of program information (for remote management clients) Parameter and program information to be displayed -msrv Item HDLM Manager Information about the HDLM manager -lic Description Status of the HDLM manager: • Alive: Normal • Dead: Stopped Ver Version number of the HDLM manager WakeupTime Startup time of the HDLM manager License Type License type Information about the HDLM license Expiration • Permanent • Temporary • Emergency License expiration: When using a permanen
Parameter and program information to be displayed Item Description If the collection of audit log data is disabled, a hyphen (-) is displayed. -pstv The display-ofthe-physicalstorage-systeminformation setting Physical Storage View The value of the display-of-the-physical-storagesystem-information setting is displayed.
The following example shows how to display information about the audit log settings: PROMPT>dlnkmgr -l view -sys -audlog Audit Log : off Audit Log Category : KAPL01001-I The HDLM command completed normally.
displayed according to the value specified in the -pstv parameter of set operations. For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see Table 6-6 Display items for which the display results of the view operation differ depending on the -pstv parameter specification on page 6-22 in Parameters on page 6-17. -hdev host-device-name Displays information only for the paths accessing the specified host device.
Displays the status of paths managed by VMware vSphere. For details on VMware vSphere path statuses, see Table 2-6 Correspondence Between VMware vSphere and HDLM Path Statuses on page 2-18. -t Omits the title for each information item. Example The following example displays path information: PROMPT>dlnkmgr view -path Paths:000002 OnlinePaths:000002 PathStatus IO-Count IO-Errors Online 42 0 PathID PathName DskName iLU ChaPort Status Type IO-Count IO-Errors DNum HDevName 000000 0002.0000.0000000000000000.
Items displayed by the dlnkmgr view -path -item command Values specified after the -item parameter ChaPort cp Status# None Type type IO-Count ic IO-Errors ie DNum dnu HDevName hd IEP iep HBAPortWWN hbaportwwn VmRuntimeName vmruntimename VmState vmstate VmPathUID vmpathuid Physical-LDEV phys Virtual-LDEV virt Physical-DskName vid Physical-iLU vid Physical-ChaPort vid Org-DskName ha Org-iLU ha # Because both PathID and Status are always displayed, you do not have to spe
6-6 Display items for which the display results of the view operation differ depending on the -pstv parameter specification on page 6-22 in Parameters on page 6-17. -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.
PROMPT>dlnkmgr view -path -item vmruntimename vmstate vmpathuid Paths:000002 OnlinePaths:000002 PathStatus IO-Count IO-Errors Online 63 0 PathID VmRuntimeName Status VmState VmPathUID 000000 vmhba2:C0:T0:L0 Online active fc.200000e08b90c61c: 210000e08b90c61c-fc.50060e8010027a85:50060e8010027a85t10.HITACHI_770101520191 000001 vmhba5:C0:T0:L0 Online active fc. 20000024ff293611:21000024ff293611-fc. 50060e8010027a81:50060e8010027a81-t10.HITACHI_770101520191 KAPL01001-I The HDLM command completed normally.
Use this parameter to display the model ID of the storage system in the product ID element of the DskName field. When this parameter 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-12 Product ID displayed by the view -path operation on page 6-46. -srt {lu|cp} Use this parameter to sort the path information in ascending order, according to the specified sorting key.
Items of Path information Table 6-10 Path Information on page 6-40 describes the displayed path information. The following explains the table headings: • No summary displayed: The user specifies only the -path parameter or the -path -item parameter. • Summary displayed: The user specifies the -path -c parameter. Table 6-10 Path Information Displayed Item No summary displayed Description Summary displayed Paths Total number of displayed paths, indicated by a decimal number.
Displayed Item No summary displayed Description Summary displayed • Target ID (hexadecimal number) • Host LU number (hexadecimal number) For details about each element of the path name and its representation in VMware vSphere, see Table 6-11 Elements of a path name on page 6-45. DskName#1 DskName Storage system name, which identifies the storage system that is accessed by a path.
Displayed Item No summary displayed Description Summary displayed Status of the path Status • Online: Online • Offline(C): Offline status caused by a command operation • Offline(E): Offline due to an error • Online(S): I/O operations to the primary volume (PVOL) in an HAM environment are suppressed. • Online(D): The paths to the primary volume (P-VOL) in an HAM environment can be recovered automatically. Paths that are in Offline(E) status require corrective action.
Displayed Item No summary displayed Description Summary displayed DNum#1 - When Dev indicates an entire LU, 0 is displayed. HDevName#1 - Host device name. IEP#1 - Information about the intermittent error. This item is displayed only when you specify the -iem parameter or when you specify iep for the -item parameter. One of the following values is displayed for each path: • Indicates that intermittent error monitoring is disabled or the path status is Offline(C).
Displayed Item No summary displayed VmPathUID# - The UID of the path managed by VMware vSphere. This item is displayed when specified in a value of the -path item parameter. - The model ID, serial number, and iLU number of a physical volume are separated by periods and displayed. 1 PhysicalLDEV Description Summary displayed You can identify the physical volume from this information. If the volume is not virtualized, a hyphen (-) is displayed.
Displayed Item No summary displayed Description Summary displayed • Vendor ID: The name of the storage system vendor. • Product ID: Indicates the storage system product ID, emulation type, or model ID. For more details, see Table 6-12 Product ID displayed by the view -path operation on page 6-46. • Serial number: The serial number of the storage system. If an HAM environment is not used, a hyphen (-) is displayed.
Table 6-12 Product ID displayed by the view -path operation Product ID Model names of storage systems Hitachi AMS2000 series Without the -stname parameter product identifier# With the -stname parameter (Displays the following for the model name) AMS Hitachi AMS series AMS Hitachi SMS series SMS Hitachi WMS series WMS HUS100 series HUS100 • Hitachi Universal Storage Platform V • Hitachi Universal Storage Platform VM Emulation type# USP_V Hitachi Virtual Storage Platform VSP VSP G1000 VSP
sorting key is iLU and its configuration information is displayed for each LU. For details on the content of each displayed item, see Table 6-14 LU Information on page 6-51. The sub-parameters are: -pstv|-vstv If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed.
Product, Physical-SerialNumber, Physical-iLU, and PhysicalChaPort, Org-Product, Org-SerialNumber, and Org-iLU, that can be displayed are displayed. The table below lists the correspondence between the display items that can be added by using the -item parameter and the parameter values that can be specified after the -item parameter.
For details on the contents of each displayed item, see Table 6-14 LU Information on page 6-51. The sub-parameters are: -pstv|-vstv If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.
PROMPT>dlnkmgr view -lu -item dpc Product : HUS100 SerialNumber : 9203008 LUs : 3 Dynamic I/O Path Control : on* iLU HDevName DPC PathID Status 000006 t10.HITACHI_770101520191 on 000000 Online 000003 Online 000007 t11.HITACHI_770101520191 off 000001 Online 000004 Online 000008 t12.HITACHI_770101520191 on 000002 Online 000005 Online KAPL01001-I The HDLM command completed normally.
Product S/N LUs iLU HDevName Paths OnlinePaths SANRISE_AMS 77010152 1 0191 t10.HITACHI_770101520191 2 2 KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> Items of LU information Table 6-14 LU Information on page 6-51 describes the displayed LU information. The following explains the table headings: • No summary displayed: The user specifies the -lu parameter. • Summary displayed: The user specifies the -lu -c parameter.
Displayed item No summary displayed Description Summary displayed • For Hitachi AMS2000/AMS/WMS/SMS series and HUS100 series, indicated by a decimal number. The entire value of iLU is the internal LU number within the storage system. You can identify an actual LU by referencing iLU from the storage system management program. • For Universal Storage Platform V/VM series, Hitachi Virtual Storage Platform, and VSP G1000, indicated by a hexadecimal number.
Displayed item No summary displayed Description Summary displayed You can identify an actual CHA port by referencing this number from the storage system management program. CLPR#1 - - Status The number of the CLPR to which the CHA belongs, indicated by a number from 0 to 31.
Displayed item No summary displayed Description Summary displayed However, a hyphen (-) is displayed when an algorithm other than the following is used: • exrr: The Extended Round Robin algorithm • exlio: The Extended Least I/Os algorithm • exlbk: The Extended Least Blocks algorithm IO-Errors#1 - Total I/O error count for a path. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0.
Displayed item No summary displayed Description Summary displayed VmRuntimeName#1 - In path information fields, displays the path runtime information managed by VMware vSphere. VmState#1 - The path status managed by VMware vSphere.
Displayed item No summary displayed Description Summary displayed the CU number, and the last two characters are the internal LU number within the CU. • For Hitachi Virtual Storage Platform, indicated by a hexadecimal number. The first two characters of iLU are the number of the logical DKC (Disk Controller), the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU. When a virtual ID is not used, a hyphen (-) is displayed.
Displayed item No summary displayed Description Summary displayed the logical DKC (Disk Controller), the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU. If an HAM environment is not used, a hyphen (-) is displayed. Legend: - : Not displayed #1 This information is displayed when one of the following conditions exist: - The user selected the item to be displayed by using the -lu -item parameter. - all was specified.
srt {lu | cp}] [-t] dlnkmgr [Host-Connection-Options] view -lu [-pstv | -vstv] [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -item [ [slpr] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] [dpc] [lb] [vmpsp] [vmruntimename] [vmstate] [phys] [virt] [vid] [ha] [hastat] | all ] [-pstv | -vstv] [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -c [-pstv | -vstv] [t] dlnkmgr -l view -sys [ -msrv | -lic | -audlog ] [-t] Hos
AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -item [ [slpr] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] [dpc] [lb] [vmpsp] [vmruntimename] [vmstate] [phys] [virt] [vid] [ha] [hastat] | all ] [-pstv | -vstv] [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -c [-pstv | -vstv] [t] Host-Connection-Options: [ -a | --passthroughauth ] [ -c CONFIG | --config=CONFIG ] [ -f SESSIONFILE | --sessionfile=SESSIONFILE ] [ -h VIHOST | --vihost=VIHOST ] [ -p
6-60 Command Reference Hitachi Dynamic Link Manager (for VMware®) User Guide
7 Utility Reference This chapter explains the utilities used by HDLM.
Overview of the Utilities HDLM provides the following utilities: • The DLMgetras utility for collecting HDLM error information When an error occurs, this utility collects the files that contain the information that you need to submit to your HDLM vendor or maintenance company. For details about the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
collected-information-is-output] [-eventlogtime yyyy/mm/dd | eventlogsize {all | maximum-file-length}] | -h} Parameters host-name Specify the host name for which to collect error information. user-name Specify the user name used to log in to the host. password Specify the password used to log in to the host. folder-to-which-collected-information-is-output Specify the output folder for the information that is to be collected by the DLMgetras utility.
by entering y instructs the DLMgetras utility to overwrite the existing files; entering n (or anything other 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 Control (UAC).
Directory that stores collected files#1 Files Explanation (Default: folder-to-whichcollected-information-isoutput\installationdestination-drive-name_ \Program Files#3\HITACHI \HNTRLib2\spool) folder-to-which-collectedinformation-is-output\ getrasinfo application-list.txt List of installation information dirHdlmRoot.txt All the folders and the list of files in the HDLM installation destination folder dirSystemRoot.
Directory that stores collected files#1 Files Explanation sysdllexe.txt Version information, 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. systeminfo.txt System information wevApplication.evtx Event log for applications wevApplication.txt wevSecurity.evtx Event log for security wevSecurity.txt wevSetup.
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.
Displays the name of the user account that is registered on the remote management client, as well as the Credential Store file path. Example: PROMPT>dlmrmcenv --output ESXiUserName=GLMUser CredentialStoreFilePath="C:\Documents and Settings\xxxxxxxx \Application Data\VMware\credstore\vicredentials.xml" KAPL20907-I The dlmrmcenv utility completed normally. PROMPT> -h Displays the format for running the dlmrmcenv utility.
PROMPT>installhdlm -v installdir=C:\Program Files\HITACHI \DynamicLinkManagerforVMware PROMPT> For an explanation of each display item, see Table 7-2 Keys That Can Be Defined in the [INSTALLATION_SETTINGS] Section on page 7-9. -h Displays the format of the installhdlm utility.
Necessity of definition Key name Description Maximu Upgrad m e charact New installat er installat ion or length# ion Re1 installat ion the installer uses the folder path that has been defined in the TMP or TEMP environment variable. licensekeyfile Specify an absolute path to a license key file stored on the remote management client.
#5 In Windows 7 (x64), Windows Server 2008, or Windows Vista (x64), the installer uses the following folder: Windows-installation-drive:\Program Files (x86)\HITACHI \DynamicLinkManagerforVMware The following shows an example of an installation-information settings file.
Format removehdlm [-s | -h] Parameters -s Executes an unattended removal. -h Displays the format of the removehdlm utility. If you execute the removehdlm utility without any parameters specified, dialog boxes will appear, such as those providing notes on removal and indicating the completion of the removal. Note: ¢ ¢ 7-12 After the removehdlm utility has been executed and the remote management client restarted, the utility is automatically deleted.
8 Messages This chapter describes the format and meaning of the message IDs, and also the terms used in the messages and message explanations. For details on the meaning of the return codes output by HDLM when it receives a request from Global Link Manager and measures to take for them, see Return Codes for Hitachi Command Suite Common Agent Component on page 8-60.
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 • Terms used in the messages and message explanations The information is explained below. Format and Meaning of Message IDs Each message has a message ID. The following table shows the format and meaning of message IDs.
KAPL01001 to KAPL02000 Message ID KAPL01001-I Message Text The HDLM command completed normally. Operation name = aa...aa, completion time = bb...bb Explanation Details The HDLM command completed successfully. When the view -path, or view lu operation is executed, view(pstv) is displayed if the Physical Storage View is disabled, and view(-vstv) is displayed if the Physical Storage View is disabled. aa...aa: Specified operation name bb...bb: Year/month/day hour:minute:second Action None.
Message ID Message Text KAPL01006-W A necessary parameter is not specified. Operation name = aa...aa Explanation Details The specified operation does not contain the necessary parameter. aa...aa: Specified operation name 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, see help (Displays the Operation Format) on page 6-5. KAPL01007-W A duplicate parameter is specified.
Message ID Message Text Explanation company if there is a maintenance contract for HDLM. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL01014-W No authority to execute the HDLM command. Operation name = aa...aa Details You do not have the administrator permissions necessary to execute the HDLM command. aa...aa: Specified operation name Action Execute the command as a user with Administrators group permissions.
Message ID Message Text Explanation 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 have not finished. Action ¢ offline/online operation Use the view operation of the HDLM command (dlnkmgr) to check the settings, and then retry. For details on the view operation, see view (Displays Information) on page 6-25.
Message ID Message Text Explanation Execute help operation of the HDLM command (dlnkmgr) to check which parameters can be specified at the same time, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01036-E The Offline path cannot be placed online. PathID = aa...aa Details The path could not be recovered. aa...aa: Path ID (decimal (base-10) number) Action Remove the error in the path, and then retry.
Message ID Message Text KAPL01044-W A duplicate parameter value is specified. Operation name = aa...aa, parameter = bb...bb, parameter value = cc...cc Explanation Details The same parameter value is specified two or more times. aa...aa: view bb...bb: Parameter name cc...cc: Duplicate parameter value Action Delete the duplicate parameter value, and then retry. KAPL01045-W Too many parameter values are specified. Operation name = aa...aa, parameters = bb...bb, parameter value = cc...cc Details aa...
Message ID Message Text Explanation Operating Environment) on page 6-16. KAPL01050-I The currently selected paths will Details be changed to the Online status. The online operation will be Is this OK? [y/n]: started. To continue the online operation, enter y. To cancel the operation, enter n. Action If you want to execute online processing, enter y. If you want to terminate processing, enter n. For details on the online operation, see online (Places Paths Online) on page 6-11.
Message ID Message Text Explanation If you want to continue processing the offline operation of the HDLM command for other paths, enter y. If you want to terminate processing, enter n. For details on the offline operation, see offline (Places Paths Offline) on page 6-7. KAPL01055-I All the paths which pass the Details specified aa...aa will be changed Multiple paths will be collectively to the Offline(C) status. Is this set to Offline(C) because the OK? [y/n]: cha parameter was specified.
Message ID Message Text Explanation KAPL01058-W The specified parameter value is Details not needed. Operation name = A parameter value was specified aa...aa, parameter = bb...bb, in a parameter that does not need parameter value = cc...cc a parameter value. aa...aa: Specified operation name bb...bb: Parameter name cc...cc: Parameter value Action Execute help operation-name of the HDLM command (dlnkmgr) to check the parameter and parameter value, and then retry.
Message ID Message Text Explanation bb...bb: Online, Online(S), Online(D) or Offline(C) cc...cc: Number of paths where the online/offline operation was unsuccessful (decimal (base-10) number) dd...dd: online or offline Action None. For details on the online operation, see online (Places Paths Online) on page 6-11. For details on the offline operation, see offline (Places Paths Offline) on page 6-7. KAPL01062-I aa...aa path(s) were successfully Details placed Offline(C).
Message ID Message Text Explanation 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-25. For details on the online operation, see online (Places Paths Online) on page 6-11. For details on the offline operation, see offline (Places Paths Offline) on page 6-7.
Message ID Message Text Explanation Install a permanent license by the expiration day. 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. KAPL01075-E A fatal error occurred in HDLM. The system environment is invalid.
Message ID KAPL01083-I Message Text There is no license key file. File name = aa...aa Explanation Details There is no license key file in the designated folder: aa...aa: Windows-installationdestination-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.
Message ID Message Text Explanation ¢ ¢ KAPL01095-E An attempt to acquire the HDLM version information has failed. details = aa...aa Simultaneously execute the HDLM command's set -lic operation with the view -sys -lic operation. Execute the HDLM command's set -lic operation while the license for an upgrade or re-installation is being updated. Details aa...aa: Code showing the reason for the error Action Re-execute the command.
Message ID Message Text Explanation target HBA port WWN. After that, specify the appropriate HBA port WWN, and then retry. 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. To collectively place multiple paths Offline(C), enter y. To not collectively place them Offline(C), enter n. aa...
Message ID Message Text become invalid when this operation is executed. Do you want to execute the operation anyway? Operation name = set [y/n]: KAPL01117-W An error occurred during processing to read the audit log configuration file. Explanation system, enter y. If you want to terminate processing, enter n. Details An internal error occurred while reading the audit log configuration file. Action Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM.
Message ID Message Text Explanation aa...aa: The number of paths which changed to the Online status bb...bb: Online or Online(S) cc...cc: The number of paths which changed to the Online(S) or Online(D) status dd...dd: Online(S), Online(D) or Online(S)/Online(D) ee...ee: The number of paths which failed to change to either the Online, Online(S) or Online(D) status ff...ff: online Action None. KAPL01134-I The target paths are already Online or Online(S).
Message ID Message Text Explanation Execute the help operation of the HDLM command (dlnkmgr) to check the host connection options, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01138-W The aa...aa operation cannot be executed if the host connection option -l is specified. Details aa...
Message ID Message Text KAPL01143-W The host connection option value cannot be specified. Option = aa...aa Explanation Details aa...aa: Option for which an option value cannot be specified Action Execute the help operation of the HDLM command (dlnkmgr) to check the host connection options, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01144-W The HDLM command was not executed from the VMware vSphere CLI command prompt.
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 6-11. For details on the offline operation, see offline (Places Paths Offline) on page 6-7.
Message ID KAPL01150-E Message Text The HDLM command cannot be executed because the VMware vSphere CLI is not installed. Explanation Details The VMware vSphere CLI might have been removed after the utility for configuring HDLM remote management client environments (dlmrmcenv) was executed. Action If the VMware vSphere CLI was removed, install the VMware vSphere CLI again, and then reexecute the dlmrmcenv utility.
Message ID Message Text Explanation (Displays Information) on page 6-25. KAPL01154-W The dynamic I/O path control function is already set to aa...aa for the system. Details aa...aa: on or off Action Use the view operation of the HDLM command (dlnkmgr) to check the setting for the host, storage, and LUs. For details on the view operation, see view (Displays Information) on page 6-25. KAPL01155-W The dynamic I/O path control function is already set to aa...aa for storage. Details aa...
Message ID Message Text Explanation Note: All paths of the LU, including non-P-VOL paths, will be set to Online or Online(D). Action To set to Online or Online(D) all paths that are connected to the LU that has the specified path ID, enter y. To cancel the process, enter n. KAPL01169-I All Online(S) or Online(D) paths will be set to Online. Is this OK? [y/n]: Details All paths in the Online(S) or Online(D) status will be set to Online because no path is specified. To continue, enter y.
Message ID Message Text Explanation execute the HDLM command with the -hapath parameter specified. KAPL01172-I There are no Online(S)/ Online(D) paths among the target paths. Details An online operation was executed using the -hapath parameter, but there are no paths with the Online(S)/Online(D) status among the specified paths. Action Use the view operation of the HDLM command (dlnkmgr) to check the status of the path. KAPL01173-W The target CHA port was constructed from multiple physical CHA ports.
KAPL03001 to KAPL04000 Message ID KAPL03001-I Message Text HDLM API information - aa...aa Explanation Details This information is required for resolving problems. aa...aa: Trace information Action None. KAPL03002-W HDLM API Warning - aa...aa Details This information is required for resolving problems. aa...aa: API trace information Action Refer to the contents of the warning. KAPL03003-E HDLM API Error information aa...aa Details This information is required for resolving problems. aa...
KAPL04001 to KAPL05000 Message ID KAPL04001-I Message Text HDLM manager started. Explanation Action None. KAPL04002-E Could not start the HDLM manager. Details The HDLM manager failed to start because the current environment is unsuitable for the HDLM manager to run in. 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.
Message ID KAPL04006-E Message Text Cannot register the service control handler function. Return value = aa...aa Explanation Details HDLM manager could not start normally because it was unable to register the service control handler function. aa...aa: OS error code Action Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. KAPL04007-E Cannot register the service status. Return value = aa...
Message ID Message Text Explanation If the same error occurs, re-install HDLM. For details on the view operation, see view (Displays Information) on page 6-25. For details on the set operation, see set (Sets Up the Operating Environment) on page 6-16. KAPL04010-E Could not open the error log file. Details HDLM manager could not start normally because it was unable to open the error log file.
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 The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL04014-E Output is impossible via the communication pipe. RC = aa...aa Details Data could not be written to the pipe file while communicating with an HDLM command. aa...
Message ID KAPL04023-E Message Text HDLM manager error information - aa...aa Explanation Details This information is required for resolving problems. aa...aa: HDLM manager trace error information 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 The DLMgetras Utility for Collecting HDLM Error Information on page 7-2.
Message ID Message Text Explanation For any non-default options, use the dlnkmgr set operation to set the options again. For details on the set operation, see set (Sets Up the Operating Environment) on page 6-16. KAPL04034-E An attempt to create the option definition file has failed. Details An attempt to re-create an option definition file using the default values has failed.
Message ID KAPL04058-I Message Text The connection to the VMware server was restored. (VMware server host = aa...aa) Explanation Details aa...aa: VMware server host IP address Action None. KAPL04059-I Monitoring of the VMware server Details started. (VMware server host = aa...aa: VMware server host IP aa...aa) address Action None. KAPL04060-I Monitoring of the VMware server Details will now end. (VMware server aa...aa: VMware server host IP host = aa...aa) address Action None.
Message ID Message Text Explanation The path might be damaged. For details on what to do, see What To Do for a Path Error on page 5-2, and then switch the path shown in the message to Online. KAPL08026-E An error occurred on all the paths of the LU. PathID = aa...aa Details An error occurred in the last, remaining path of an LU. (This is most likely as a result of a disconnection.) aa...
KAPL09001 to KAPL10000 Message ID KAPL09001-E Message Text Explanation There is no system management Details permission. Login with The current user does not have administrator permission and the necessary administrator aa...aa HDLM. permission to install or remove HDLM. aa...aa: re-install or re-remove Action Re-install or re-remove HDLM as a user who is a member of the Administrators group. KAPL09034-E An Internal error occurred in the Details HDLM Installer. Code = aa...
Message ID Message Text Explanation bb...bb: Version number of HDLM you attempted to install or remove Action See the previous warning and error messages to resolve the problems. KAPL09187-W No parameter is specified. Details No installation-information settings file has been specified in the installhdlm utility for installing HDLM. Action Make sure that an actual installation-information settings file for the installhdlm utility is appropriate, and then try again.
Message ID Message Text KAPL09191-W The installation information settings file does not exist. Explanation Details The installation-information settings file specified for the second parameter in the installhdlm utility for installing HDLM does not exist. Action Make sure that the path name of the installation-information settings file is appropriate, and then try again. KAPL09193-W A definition in the installation information settings file is invalid. (aa...aa = bb...
Message ID Message Text Explanation Action Enter a license key when prompted by a message to do so. Alternatively, cancel the installation, save the correct license key file in the designated folder, and then re-execute the installation. KAPL09606-E The entered license key is invalid. The HDLM installation will now terminate. Obtain a valid license key, and then reinstall HDLM. Details The renewal of the license key will be aborted because an invalid license key was entered.
Message ID Message Text Explanation Retry installation. KAPL09612-W There is no installable license key in the license key file. File name = aa...aa Details There is no HDLM-installable license key in the license 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-execute. KAPL09613-E License information cannot be acquired.
Message ID Message Text Explanation • Confirm that valid license information is stored in the license key file specified for licensekeyfile key. If the problem persists, use setup.exe to install HDLM. If an error occurs, take action according to the relevant error message. ¢ remove: Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. KAPL10001 to KAPL11000 Message ID Message Text KAPL10001-W No parameter has been specified.
Message ID Message Text Explanation Action Check the parameters of the DLMgetras utility for collecting HDLM error information, and then retry. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL10009-W The specified directory already Details exists. Do you want to overwrite The specified folder already exists. it? [y/n]: Enter y to overwrite it, or n to cancel. Action The specified folder already exists.
Message ID Message Text Explanation Action None. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL10030-I A user terminated the utility for collecting HDLM error information. Details Processing of the DLMgetras utility for collecting HDLM error information has been terminated because the user replied to the confirmation with an n response. Action None.
Message ID Message Text Explanation bb...bb: Error number of the Windows API (hexadecimal number) Action An error occurred while the information collection file was being copied. The error might be a result of an unstable user environment. Check the system configuration. KAPL10041-I Collection of aa...aa information will now start. Details aa...aa: Log information to be collected Action None. KAPL10042-I Collection of aa...aa information will now finish. Details aa...
Message ID Message Text Explanation The specified parameter is invalid. Action 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. KAPL10047-W A necessary parameter value has not been specified. (parameter = aa...aa) Details A required parameter value has not been specified. aa...
Message ID Message Text Explanation was not executed in the command prompt of VMware vSphere CLI. Action Execute the DLMgetras utility in the command prompt of the VMware vSphere CLI. KAPL11001 to KAPL12000 Message ID KAPL11901-I Message Text aa...aa has started. Explanation Details The operation has started on the host. aa...
Message ID Message Text Explanation ¢ Offline bb...bb: The Path ID of the target path (decimal number) Action None. KAPL11903-I aa...aa has completed normally. Details The operation has completed normally on the host. aa...
Message ID Message Text Explanation ¢ ¢ Get HDLM Manager Status Get HDLM Alert Driver Status ¢ Online ¢ Offline ¢ Get SNMP Trap Information ¢ Set SNMP Trap Information ¢ Set LU Load Balance ¢ Get Path Status Log Information ¢ Get ESXi Information ¢ Add Path Information ¢ Delete Path Information ¢ Set Storage Identification Information bb...
Message ID Message Text Explanation None. KAPL11907-I XML reception - aa...aa Details This information is required for resolving problems. aa...aa: XML information (character string) Action None. KAPL11908-I XML transmission - aa...aa Details This information is required for resolving problems. aa...aa: XML information (character string) Action None. KAPL13001 to KAPL14000 Message ID Message Text KAPL13604-W An error occurred during processing to read the audit log configuration file.
KAPL15001 to KAPL16000 Message ID KAPL15060-I KAPL15061-I KAPL15101-I Message Text Explanation DLMgetras was invoked. Command Line = aa...aa Details DLMgetras successfully executed. Command Line = aa...aa Details Clear operation was completed successfully. Command Line = aa...aa Details aa...aa: Name of the utility that the user executed aa...aa: Name of the utility that the user executed aa...aa: Command that the user executed KAPL15102-W Clear operation has failed. Command Line = aa...
Message ID Message Text Explanation KAPL15110-W An attempt to display information about HDLMmanagement targets has failed. Command Line = aa...aa Details KAPL15111-W The HDLM command was started or stopped by the user who does not have the authority. Command Line = aa...aa Details KAPL15116-I Details bb...bb path(s) were successfully placed aa...aa. dd...dd path(s) were successfully placed cc...cc. ee...ee path(s) were not. Command Line = online aa...aa: Command that the user executed aa...
Message ID Message Text Explanation The termination of the HTI_SATP_HDLM plugin successful. Action None. KAPL20021-I The state of path (aa...aa) was changed from bb...bb to cc...cc. Details The path state changed. aa...aa: Name of Path that changed state bb...bb: Path state before change cc...cc: Path state after change Action None. KAPL20022-W The state of path (aa...aa) was changed from bb...bb to cc...cc. Details The path state changed to a state where I/Os cannot be issued. aa...
Message ID Message Text Explanation Code, check the status of the path where the error was detected. KAPL20025-W I/O (aa...aa) to path (bb...bb) failed. Plugin 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: Plugin status 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.
Message ID Message Text Explanation the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL20028-I The owner controller of device (aa...aa) was changed to (bb...bb). Details The owner controller of the LU connected to the path with the ID shown in the message was changed. aa...aa: Path ID of the changed LU. (same as PathID of view path) (Decimal number) bb...bb: Owner controller ID after the change. (Hexadecimal number) Action None.
Message ID KAPL20033-E Message Text A parameter is invalid. Parameter = "aa...aa" Explanation Details The parameter specified in esxcli command (nmp satp setconfig) is invalid. aa...aa: Specified parameter Action Check the parameter you specified. Specify the correct parameter and retry the esxcli command. KAPL20034-E The device (aa...aa) is not HAM pair. Details The device name specified for -d option of esxcli command (nmp satp setconfig --config pvolrel) is not device (HAM pair). aa...
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 The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL20042-W The state of path (aa...aa) was not able to be updated. Plugin status=bb...bb Details aa...aa: Name of Path that was not able to be updated. bb...
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 The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL20045-W The state of path (aa...aa) was not able to be updated. Sense key=bb...bb ASC/ASCQ=cc...cc Details aa...aa: Name of Path that was not able to be updated. bb...bb: Sense key cc...
Message ID Message Text Explanation remote management client environments (dlmrmcenv), confirm the parameter that should be specified, and then retry the operation. For details on the dlmrmcenv utility, see The dlmrmcenv Utility for Configuring HDLM Remote Management Client Environments on page 7-7. KAPL20903-E The specified Credential store file does not exist. Value = aa...
Message ID Message Text Explanation remote management client environments (dlmrmcenv). aa...aa: Error number Action Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. KAPL20907-I The dlmrmcenv utility completed normally. Details The utility for configuring HDLM remote management client environments (dlmrmcenv) ended normally. Action None.
Message ID Message Text Explanation None. Return Codes for Hitachi Command Suite Common Agent Component When an operation requested of HDLM from Global Link Manager terminates abnormally, or terminates normally with a warning, HDLM outputs one of the return codes described below. Return Code 1002 Explanation Details There is no path on which the operation can be performed. Action Refresh the host information, check the path status, and then perform the operation again.
Return Code 1016 Explanation Details The target path(s) are already Online. Action Update the host information, and then check the path status. 1017 Details The target path(s) are already Offline(C). Action Update the host information, and then check the path status. 1019 Details Acquisition of HDLM Manager information failed.
Return Code Explanation The acquisition of path information has been aborted, because the path configuration was changed while the system was attempting to acquire the path information. Action Refresh the host information, check the path status, and then perform the operation again. 1033 Details An attempt to acquire the HDLM version information failed. Action Re-execute the command.
Return Code Explanation Action Refresh the host information, and then perform the operation again. If the same error occurs again, execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or maintenance company if you have a maintenance contract for HDLM. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. 1038 Details A storage system that cannot use the load balancing function is connected.
Return Code Explanation collecting HDLM error information, and then contact your HDLM vendor or maintenance company if you have a maintenance contract for HDLM. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. 1054 Details The specified storage system or LU cannot use the dynamic I/O path control function. Action None. 1055 Details Name resolution from a host name to an IP address failed.
Return Code Explanation A value outside the valid range is specified for the check interval of the dynamic I/O path control function. Action Specify a value in the range from 5 through 1440 for the check interval of the dynamic I/O path control function, and then retry the operation.
8-66 Messages Hitachi Dynamic Link Manager (for VMware®) User Guide
Acronyms and abbreviations The following acronyms and abbreviations might be used in this guide.
CPU Central Processing Unit CU Control Unit D DBMS Database Management 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 # A B C D E F G H I J K L M N O P Q R S T Acronyms-2 Hitachi Dynamic Link Manager (for VMware®) User Guide U V W X Y Z
HDev Host Device HLU Host Logical Unit HTTP Hypertext Transfer Protocol I I/O Input/Output IP Internet Protocol iSCSI Internet Small 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 # A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Acronyms-3 Hitachi Dynamic Link Manager (for VMware®) User Guide
NIC Network Interface Card NMP Native Multipathing Plugin NTP Network Time Protocol O OS Operating System P P Port PSP Path Selection Plugin R RADIUS 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 # A B C D E F G H I J K L M N O P Q R S T Acronyms-4 Hitachi Dynamic Link Manager (for VMware®) User Guide U V W X Y Z
SMTP Simple Mail Transfer Protocol SNMP Simple Network Management Protocol SP Service Pack SSL Secure Sockets Layer SVP Service Processor U UID User Identifier W WWN World Wide Name # A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Acronyms-5 Hitachi Dynamic Link Manager (for VMware®) User Guide
# A B C D E F G H I J K L M N O P Q R S T Acronyms-6 Hitachi Dynamic Link Manager (for VMware®) User Guide U V W X Y Z
Glossary This glossary explains the terms used in this manual. A 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.
CLPR(Cache Logical Partition) A function supported by the Universal Storage Platform V/VM series, Virtual Storage Platform series, VSP G1000 series, Hitachi AMS2000/AMS/WMS/SMS series, HUS100 series, and HUS VM 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. D Dev (Device) A target that HDLM controls and operates. A Dev is called a device in VMware vSphere.
H HAM environment An environment in which volume pairs that are synchronized between two storage systems are created by HAM (High Availability Manager), and hosts are configured to recognize these volumes as one volume. An HAM environment consists of the primary volume (P-VOL) in the primary site and the secondary volume (S-VOL) in the secondary site. When an error occurs on one of the volumes, the path can be switched to the other volume by using HDLM.
L LDEV (Logical Device) A combination of the storage system's product name, serial number, and an internal LU. HDLM uses this value to identify a particular LU. load balancing Functionality for distributing the load across the paths that access each area within an LU. To distribute loads, load balancing uses multiple paths to perform I/O operations. Load balancing uses VMware vSphere PSPs.
owner path A path that passes through an owner controller for an LU in the Hitachi AMS/WMS series. A path that passes through a controller other than an owner controller is called a non-owner path. When using the Universal Storage Platform V/VM series, Virtual Storage Platform series, VSP G1000 series, Hitachi AMS2000 series#, Hitachi SMS series#, HUS100 series#, or HUS VM, all paths are owner paths.
the LU cannot be accessed from multiple paths (coming from multiple hosts) simultaneously. However, because of this, load balancing is not possible. (See also: persistent reservation) S SAN (Storage Area Network) A high-speed network connecting hosts to storage systems. This network is independent of a LAN and is dedicated to data transfers. A SAN provides faster access to storage systems, and prevents the transfer of high-volumes of data from deteriorating LAN performance. SCSI device A SCSI disk device.
Index A audit log categories and audit events that HDLM can output 2-28 collecting data 2-26 data format 2-31 automatic failback 2-15, Glossary-1 automatic failover 2-13 automatic path switching 2-13 AutoPATH_ID 2-2, 2-4, Glossary-1 clear 6-3 help 6-5 offline 6-7 online 6-11 set 6-16 view 6-25 configuration of HDLM system configuration of HDLM system using FC-SAN 2-2 Critical 8-2 D B boot disk environment buffer size 3-20 bus number 6-45 Glossary-1 C CHA 2-3, 2-5 CHA (Channel Adapter) Glossary-1 Changin
E path error 5-2 HBA 2-3 HBA (Host Bus Adapter) HDev 2-6 HDLM features 1-2 functions 2-1 installing 3-6 new installation 3-6 Elements of a path name 6-45 emulation type Glossary-2 Error 8-2 error information 2-24 checking in messages 5-2 collecting with DLMgetras 7-2 list of error info. collected by the DLMgetras utility for collecting error info.
count 6-3 errors 6-3 identifying error part 5-4 error path 5-3 Information 8-2 installation 3-6 new installation of HDLM 3-6 re-installation of HDLM 3-11 upgrade installation of HDLM 3-11 installation-information settings file [INSTALLATION_SETTINGS] section installhdlm 7-8 integrated HDLM management 2-33 integrated trace file 2-25 integrated trace information file 3-20 integrated traces setup 3-20 intermittent error Glossary-3 definition 2-16 Intermittent Error Monitoring 3-17 IP-SAN 2-3, 2-5 iSCSI 2-5 iSC
path error handling 5-2 Path Health Checking 2-22 path health checking 1-3, 2-22, Glossary-5 path information obtaining 5-3 path name Glossary-5 path status transition 2-17 path status transitions 2-18 setup HDLM 3-15 integrated traces 3-20 SLPR(Storage Logical Partition) Glossary-6 starting HDLM manager 4-9 statistics 6-3 clearing to the initial value 6-3 status transitions (P-VOL in HAM environment) path switching automatically 2-13 manually 2-16 paths to which load balancing is applied 2-10 Performing
W Warning 8-2 what is HDLM? 1-2 what to do for program error 5-4, 5-5 Index-5 Hitachi Dynamic Link Manager (for VMware®) User Guide
Index-6 Hitachi Dynamic Link Manager (for VMware®) User Guide
Hitachi Dynamic Link Manager (for VMware®) User Guide
Hitachi Data Systems Corporate Headquarters 2845 Lafayette Street Santa Clara, California 95050-2639 U.S.A. www.hds.com Regional Contact Information Americas +1 408 970 1000 info@hds.com Europe, Middle East, and Africa +44 (0)1753 618000 info.emea@hds.com Asia Pacific +852 3189 7900 hds.marketing.apac@hds.