Hitachi Command Suite Dynamic Link Manager Software User Guide for VMware® Document Organization Product Version Getting Help Contents MK-92DLM130-06
© 2011-2013 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 User Guide for VMware®
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 7.6 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 User Guide for VMware®
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 User Guide for VMware®
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-15. 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, 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 is /var/ collected. 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 An attempt to display HDLM managementtarget information failed. The status of a path was successfully changed to Online. 6 #1 Message ID 4 KAPL15110-W 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 User Guide for VMware®
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.
VMware vSphere CLI 5.0/5.1 is a prerequisite program for a remote management client. Make sure that VMware vSphere CLI is installed before installing HDLM.
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. Table 3-2 Number of LUs and Paths That Are Supported by HDLM Item Number supported Number of LUs 1 to 256 Number of paths per LU 1 to 32 Total number of paths 1 to 1024 Flow for Creating an HDLM Environment Set up the environment to use HDLM as follows.
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. Notes on Creating an HDLM Environment This section provides notes on creating an HDLM environment.
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. Be aware that even though an upgrade or re-installation of HDLM failed, the Add/Remove Programs window might indicate that HDLM has been installed normally.
installhdlm utility, see The installhdlm Utility for Installing HDLM on page 7-8. To manually perform an installation on the remote management client, follow the procedure in New installation on remote management client on page 3-7. To perform an unattended installation, follow the procedure in Unattended installation on remote management client on page 3-8. New installation on remote management client 1. Log on to Windows on the remote management client as a member of the Administrators group. 2.
= 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. Unattended installation on remote management client Notes on unattended installations ¢ ¢ Do not forcibly stop the execution of the installhdlm utility during an unattended installation of HDLM.
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 HDLM command's view operation to confirm that HDLM has been installed.
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. Execute the following command. In the -d parameter, specify the name of an offline bundle file you copied in step 1.
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. Performing an Upgrade Installation of HDLM The procedure for an upgrade installation of HDLM is the same as for a new installation.From the following, use the procedure that matches the installation destination: You can use VMware vSphere Update Manager.
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.
The default storage location of the Credential Store is as follows: %APPDATA%\VMware\credstore\vicredentials.xml To add a host to the Credential Store file, execute the VMware vSphere CLI script (credstore_admin.pl). Executing the dlmrmcenv utility The dlmrmcenv utility registers the user account created in Creating a user account on page 3-12 into the remote management client. To execute the utility: 1. Log on to Windows on the remote management client as a member of the Administrators group. 2.
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. • Device Manager agent is installed: program-installation-destination-drive:\Program Files#\Hitachi \HDVM\HBaseAgent\bin\firewall_setup.
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. After you install HDLM or change the hardware configuration, check the structure and statuses of the paths. You can use the HDLM command's view operation from the remote management client to check path information.
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-24. 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-24.
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-24.
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-24.
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.
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-24. Leading zeros can be omitted (000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value. AutoPATH_IDs are re-assigned every time the host is restarted.
-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. If I/O operations to the secondary volume (S-VOL) do not occur and only the paths to the P-VOL recover from an error, the path to the P-VOL will be in the Online status regardless of this parameter specification.
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 | --sessionfile=SESSIONFILE ] [ -h VIHOST | --vihost=VIHOST ] [ -p PASSWORD | --password=PASSWORD ] [ -r URL | --url=URL ] [ -s SERVER | --server=SERVER ] [ -t
Format To Set the Host Operating Environment dlnkmgr [-s host-name -u user-name -p password] set {-lb on -lbtype {exrr|exlio|exlbk|vmwmru|vmwrr} |-iem {on [-intvl error-monitoring-interval] [-iemnum numberof-times-error-is-to-occur]|off} |-expathusetimes number-of-path-use-times |-dpc {on|off} [-pathid path-ID -lu|-pathid path-ID -storage] |-dpcintvl checking-interval } [-s] To Set the Remote Management Client Operating Environment dlnkmgr -l set {-lic |-audlog {on [-audlv audit-log-data-collection-level]
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. Intermittent error monitoring off on Number of times the same path can be used for extended load balancing 100 The recommended value depends on the operating environment. Dynamic I/O path control# off off The checking interval is 10 minutes.
¢ When the intermittent error monitoring interval or the number of times that the error is to occur has not been specified before: The intermittent error monitoring interval is set to 30 minutes, and the number of times that the error is to occur is set to 3. When the intermittent error monitoring interval or the number of times that the error is to occur has been specified before: The values specified from the last time are used.
You an specify a decimal (base 10) value from 1 to 999999. The default is 100. -dpc {on|off} [-pathid path-ID -lu | -pathid path-ID -storage] Enables or disables the dynamic I/O path control function for each storage system or LU. The default value is "off". on: Enabled off: Disabled -pathid path-ID -lu Sets the dynamic I/O path control function to enabled or disabled for each LU. Specify one of the IDs of the paths connected to the target LU.
been registered, the expiration period is displayed (KAPL01071-I, KAPL01072-I). If you do not use a license key file: When the set -lic operation is executed, a message (KAPL01068-I) asking the user to enter a license key appears. Enter the license key. A message confirming that the license key has been registered is displayed, depending on the license key type described in the license key file.
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. off: Audit Log data is not collected. -audlv audit-log-data-collection-level Specifies the severity level of audit log data to be collected. The table below lists and describes the values used for this setting. The default is 6.
To Display the Format of the Set Operation -help Displays the format of the set operation.
all } (Default Value all) KAPL01001-I The HDLM command completed normally.
PROMPT>dlnkmgr -l set -help set: Format dlnkmgr -l set { -lic | -audlog on [ -audlv AudlogLevel ] [ -category Category-Value ] | -audlog off } [-s] Valid value AudlogLevel { 0 - 7 } (Default Value 6) Category-Value { [ss] [a] [ca] | all } (Default Value all) KAPL01001-I The HDLM command completed normally.
[-vmstate] [-t] To display path information (by selecting a display item) dlnkmgr [-s host-name -u user-name -p password] view -path -item [pn] [hbaportwwn] [dn] [lu] [cp] [type] [ic] [ie] [dnu] [hd] [iep] [vmruntimename] [vmstate] [vmpathuid] [vid] [ha] [-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 [-stname] [-srt {lu|cp}] [-t] To Display LU Information To display LU inf
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 for Hosts on page 6-26 To Display Program Information for a Remote Management Client on page 6-29 To display path information on p
Parameter and program information to be displayed Item Load Balance Description 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 after the parentheses in which the checking interval is displayed. Times Same expathusetimes ExPath Was Used The number of times the same path can be used for extended load balancing 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. -satp SATP Displays HTI_SATP_HDLM.
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. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> Example 3 The following example displays SATP information: PROMPT>dlnkmgr view -sys -satp SATP : HTI_SATP_HDLM Default PSP : HTI_PSP_HDLM_EXLIO KAPL01001-I The HDLM command completed normally.
Table 6-7 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. Examples Example 1 The following example displays configuration information for HDLM functions on a remote management client: PROMPT>dlnkmgr -l view -sys HDLM Version : x.x.x-xx Service Pack Version : 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.
KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss PROMPT> To display path information When displaying path information, if you specify either the -item or -c parameter and also specify the -path parameter, you can select the items to display and display a summary of path information. This section describes each parameter, path information and displayed items.
The sorting keys are as follows: the first sorting key is the name of the storage system (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID. The available parameter values to specify the second sorting key are: • pn: Path name • lu: LU number of the storage system • cp: Port number of the CHA When the -srt parameter is omitted, the path information is listed in ascending order of AutoPATH_IDs.
When you specify the -path parameter together with the -item parameter, the command only displays the items specified by the value of the -item parameter. When the value of the -item parameter is omitted, only the PathID and the Status fields are displayed. The following table lists the correspondence between the display items that can be selected by using the -item parameter and the parameter values that can be specified after the -item parameter.
-hdev host-device-name Displays information only for the paths accessing the specified host device. The host-device-name string is case-sensitive. When you specify this parameter, HDevName is displayed by default. It is not necessary to specify hd for the -item parameter. -stname Use this parameter to display the model ID of the storage system in the product ID element of the DskName field. When this parameter is omitted, the command displays the product ID or emulation type of the storage system instead.
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.
When the -srt parameter is omitted, the path information is listed in ascending order of AutoPATH_IDs. -t Omits the title for each information item. Example The following example shows how to abbreviate the display of information about the paths, ordered by iLU. PROMPT>dlnkmgr view -path -c -srt lu Paths:000012 OnlinePaths:000012 PathStatus IO-Count IO-Errors Online 1616 0 PathID DskName iLU CP Status Type 000000 HITACHI .DF600F .0051 0005 0A Online Own 000003 HITACHI .DF600F .
Displayed Item No summary displayed Description Summary displayed OnlinePaths Number of online paths from within the displayed paths, indicated by a decimal number. When the value of Paths equals the value of OnlinePaths, all paths are online. If the value of OnlinePaths is less than that of Paths, some paths are offline. In this case, you should check the offline paths and take appropriate action for any paths that have an error status. PathStatus Status of the displayed paths.
Displayed Item No summary displayed Description Summary displayed • Product ID: Indicates the storage system product ID, emulation type, or model ID (for example, DF600F). For more details, see Table 6-11 Product ID displayed by the view -path operation on page 6-42. • Serial number: The serial number of the storage system (for example, 0051). You can identify an actual storage system by referencing the above information from the storage system management program.
Displayed Item No summary displayed Description Summary displayed When connecting to Universal Storage Platform V/VM series, Virtual Storage Platform series, Hitachi AMS2000 series#2, Hitachi SMS series#2, HUS100 series#2, or HUS VM, all paths are owner paths. IO-Count#1 - Total I/O count for the path, indicated by a decimal number. The maximum value that can be displayed is 232 1 (4294967295). If the total I/O count reaches the maximum value, it will re-start from 0.
Displayed Item No summary displayed Description Summary displayed Indicates that an intermittent error occurred (automatic failbacks do not check the path) (the path status is Offline(E)). - A 16-digit hexadecimal number indicating the WWN information for an HBA connected to the storage system. This item is displayed only when you specify the hbaportwwn parameter or when you specify hbaportwwn for the -item parameter.
Table 6-10 Elements of a path name Element VMware vSphere representation Host port number (example: 0000) Host ID (host port number) Bus number (example: 0000) Channel number (bus number) Target ID (example: 000000000000003A) Target ID Host LU number(example: 0005) Lun (host LU number) Table 6-11 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
To display LU information -lu When neither the -c nor -item parameter is specified with the -lu parameter, the information about the LU recognized by HDLM is displayed without selecting items to be displayed or displaying a summary. The sorting key is iLU and its configuration information is displayed for each LU. By using the sub-parameter, -hdev or -pathid, you can filter the LU information to be 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.
Use this parameter to display only the information about the LU that is connected to the path with that specified AutoPATH_ID. -t Omits the title for each information item.
When the -c parameter is specified with the -lu parameter, a summary of LU configuration information is displayed on one line. The total number of paths recognized by HDLM and the number of online paths are displayed for each LU. You cannot specify the -c parameter together with the -hdev or -pathid parameter. For details on the contents of each display item, see Table 6-13 LU Information on page 6-46. -t Omits the title for each information item.
Displayed item No summary displayed Description Summary displayed -: The dynamic I/O path control function is not supported. If an LU whose settings differ from the settings based on the system storage unit is included, * is added after the on or off being displayed. LU number in the storage system. iLU This number combined with the storage system name (shown in DskName) identifies the LU that is accessed by a path. • For P9500, indicated by a hexadecimal number.
Displayed item No summary displayed PathName#1 Description Summary displayed - The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the path that will be affected by the change.
Displayed item No summary displayed IO-Count#1 Description Summary displayed - Total I/O count for a path. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O count reaches the maximum value, it is reset, and the count is re-started from 0. To reset the IO-Count value to 0, execute the dlnkmgr command's clear operation. Executing the clear operation also resets the number of I/ O errors (IO-Errors) to 0.
Displayed item No summary displayed Description Summary displayed • vmwfixed: The Fixed algorithm (VMware) • vmwmru: The Most Recently Used algorithm (VMware) • vmwrr: The Round Robin algorithm (VMware) • unknown: An algorithm other than the above VmPSP#1 - The PSP currently in effect. VmRuntimeName#1 - In path information fields, displays the path runtime information managed by VMware vSphere. VmState#1 - The path status managed by VMware vSphere.
#2 This storage system applies when the dynamic I/O path control function is disabled. To display the format of the view operation -help Use this parameter to display the view operation format.
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 view -help view: Format dlnkmgr [Host-Connection-Options] view -sys [ -sfunc | -satp | -rule ] [-t] dlnkmgr [Host-Connection-Options] view -path [-iem] [-hbaportwwn] [-vmruntimename] [-vmstate] [ -hdev HostDeviceName ] [-stname] [-srt {pn | lu | cp}] [-t] dlnkmgr [Host-Connection-Options] view -path -item [pn] [dn] [lu] [cp] [type] [ic] [ie] [dnu] [hd] [iep] [hbaport
Format dlnkmgr -l view -sys [ -msrv | -lic | -audlog ] [-t] KAPL01001-I The HDLM command completed normally.
6-54 Command Reference Hitachi Dynamic Link Manager User Guide for VMware®
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-59.
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. aa...aa: clear, help, offline, online, set, or view bb...bb: Year/month/day hour:minute:second Action None. KAPL01002-I The HDLM command started. Operation name = aa...aa Details The HDLM command was executed. aa...aa: clear, offline, online, set, or view Action None.
Message ID Message Text Explanation aa...aa: clear, set, offline, or view Action Execute help operation-name of the HDLM command (dlnkmgr) to check the parameter. Specify the correct parameter, and then retry. For details on the help operation, see help (Displays the Operation Format) on page 6-5. KAPL01007-W A duplicate parameter is specified. Operation name = aa...aa, parameter = bb...bb Details aa...aa: clear, offline, online, set, or view bb...
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. 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...
Message ID Message Text KAPL01019-W The target path was not found. Operation name = aa...aa Explanation Details aa...aa: offline, online, or view ¢ offline/online operation The specified path does not exist. ¢ view operation The paths have not been configured because creation of the HDLM environment or configuration changes to the HDLM operating environment have not finished. Action ¢ offline/online operation Use the view operation of the HDLM command (dlnkmgr) to check the settings, and then retry.
Message ID Message Text Explanation KAPL01024-W The specified parameters cannot Details be specified at the same time. aa...aa: clear, offline, online, Operation name = aa...aa, set, or view parameters = bb...bb bb...bb: Parameters that cannot be specified at the same time Action Execute help operation of the HDLM command (dlnkmgr) to 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.
Message ID Message Text Explanation value was entered three times in a row for a request. aa...aa: clear, offline, online, or set Action Check the correct value, and then re-execute the HDLM command. KAPL01044-W A duplicate parameter value is specified. Operation name = aa...aa, parameter = bb...bb, parameter value = cc...cc Details The same parameter value is specified two or more times. aa...aa: view bb...bb: Parameter name cc...
Message ID Message Text Explanation If you want to execute the operation, enter y. If you want to terminate processing, enter n. For details on the clear operation, see clear (Returns the Path Statistics to the Initial Value) on page 6-3. For details on the set operation, see set (Sets Up the Operating Environment) on page 6-15. 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.
Message ID Message Text was detected. PathID = aa...aa Would you like to continue the processing of the offline operation? [y/n]: Explanation multi-path offline processing. To ignore this path and perform offline processing for the next path, enter y. To cancel offline processing, enter n. aa...aa: Path ID (decimal (base-10) number) Action 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.
Message ID Message Text Explanation aa...aa: CHA port Action If you want to execute online processing for the paths that meet the specified requirements, enter y. If you want to terminate processing, enter n. KAPL01058-W The specified parameter value is Details not needed. 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: clear, offline, online, set, or view bb...bb: Parameter name cc...
Message ID KAPL01061-I Message Text Explanation aa...aa path(s) were successfully Details placed bb...bb; cc...cc path(s) This message indicates the were not. Operation name = number of the paths processed in dd...dd an online/offline operation. aa...aa: Number of paths where the online/offline operation was successful (decimal (base-10) number) bb...bb: Online, Online(S), Online(D) or Offline(C) cc...cc: Number of paths where the online/offline operation was unsuccessful (decimal (base-10) number) dd...
Message ID Message Text Explanation As a result of a previous online/ offline operation, the specified path has already been set to Online/Online(S)/Online(D)/ Offline(C). aa...aa: Online, Online(S), Online(D) or Offline(C) Action Use the view operation of the HDLM command (dlnkmgr) to check the status of the path. For details on the view operation, see view (Displays Information) on page 6-24. For details on the online operation, see online (Places Paths Online) on page 6-11.
Message ID Message Text Explanation None. KAPL01072-I The emergency license was installed. The license expires on aa...aa. Details A license was renewed and is registered as an emergency license. aa...aa: Year (4 digits)/month (01-12)/day (01-31) Action Install a permanent license by the expiration day. 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.
Message ID KAPL01082-E Message Text There is no installable license key in the license key file. File name = aa...aa Explanation Details There is no useable license key for HDLM in the license key file. aa...aa: Windows-installationdestination-drive-name \hdlm_license Action Make sure that the license key file is correct, and then re-execute. KAPL01083-I There is no license key file. File name = aa...aa Details There is no license key file in the designated folder: aa...
Message ID Message Text operation: another set -lic operation, or an update of the license for an update installation. Explanation Check the license by using the HDLM command's view -sys -lic operation. If necessary, reexecute the HDLM command's set -lic operation. If the same error message is output again, contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM.
Message ID Message Text KAPL01101-W The target HBA port was not found. Operation name = aa...aa Explanation Details The HBA having the HBA port WWN specified in the hbaportwwn parameter could not be found. aa...aa: offline or online Action Use the view operation of the HDLM command (dlnkmgr view path -hbaportwwn) to check the 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...
Message ID Message Text Explanation aa...aa: HBA Action If you want to execute the online processing for the paths which pass the specified target, enter y. If you want to terminate the processing, enter n. KAPL01107-I The load balancing type specified for individual LUs will 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.
Message ID Message Text Explanation contract for HDLM. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL01133-I aa...aa path(s) were successfully Details placed bb...bb; cc...cc path(s) The number of paths processed were successfully placed by an online operation is shown. dd...dd; ee...ee path(s) were aa...aa: The number of paths not. Operation name = ff...ff which changed to the Online status bb...bb: Online or Online(S) cc...
Message ID Message Text Explanation help (Displays the Operation Format) on page 6-5. KAPL01136-W The specified host connection options cannot be specified at the same time. Options = aa...aa Details aa...aa: Host connection options that cannot be specified at the same time 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. KAPL01138-W The aa...
Message ID Message Text Explanation Action Execute the operation-name help operation of the HDLM command (dlnkmgr) to check the format of the operation, and then retry. KAPL01143-W The host connection option value cannot be specified. Option = aa...aa 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.
Message ID Message Text paths = dd...dd, operation name = ee...ee Explanation aa...aa: Number of paths where the online/offline operation was successful(decimal (base-10) number) bb...bb: Online or Offline(C) 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.
Message ID Message Text Explanation the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL01150-E The HDLM command cannot be executed because the VMware vSphere CLI is not installed. Details The VMware vSphere CLI might have been removed after the utility for configuring HDLM remote management client environments (dlmrmcenv) was executed.
Message ID Message Text Explanation Execute the view operation the HDLM command (dlnkmgr) to check the path status. For details on the view operation, see view (Displays Information) on page 6-24. 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.
Message ID Message Text Explanation continue, enter y. To cancel the operation, enter n. 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.
Message ID Message Text Explanation status of a path from Online(S) or Online(D) to Online, reexecute 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.
Message ID Message Text Explanation HDLM Error Information on page 7-2. KAPL03999-E An unexpected error occurred. Details Conflicting versions of HDLM modules are being used. 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 the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL04004-I KAPL04005-E HDLM manager will now terminate. Action Cannot connect the service control manager. Details None. HDLM manager could not start normally because it was unable to connect the service control manager. Action The HDLM manager starts as a service and as such, to start HDLM from the command line, use the net start DLMManagerVM command.
Message ID Message Text Explanation file has been inadvertently deleted. KAPL04009-E The option definition is invalid. Details HDLM manager could not start normally because some of the definitions in the option definition file were invalid. Action If the KAPL04033-W message is output after this message, execute the dlnkmgr view -sys -sfunc command, and then check the option settings. Use the dlnkmgr set operation to return options settings back to where you had them.
Message ID Message Text Explanation aa...aa: OS error code (decimal number) 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. KAPL04013-E Input is impossible via the communication pipe. RC = aa...
Message ID Message Text Explanation aa...aa: HDLM manager trace information Action None. KAPL04022-W HDLM manager warning information - aa...aa Details This information is required for resolving problems. aa...aa: HDLM manager trace warning 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.
Message ID Message Text Explanation HDLM Error Information on page 7-2. KAPL04025-C A memory shortage occurred in the HDLM manager. Details There was not enough memory to run the HDLM manager processes. Action To increase the amount of free memory, terminate unnecessary applications or restart the host. KAPL04033-W The option definition file was re- Details created. When an existing option definition file cannot be read, a new option definition file will be re-created by using the default values.
Message ID Message Text Explanation ee...ee: Transmission data Action None. KAPL04053-W The option definition file was recovered from a work file. Details KAPL04057-E Details An attempt to connect to the VMware server failed. (VMware server host = aa...aa) Execute the dlnkmgr view -sys command to check whether the settings are recovered. If the settings are not recovered, execute the dlnkmgr set operation to recover the settings. aa...
Message ID Message Text Explanation cc...cc: Host port number (same as PathName of view -path) (hexadecimal number) dd...dd: Bus number (same as PathName of view -path) (hexadecimal number) ee...ee: Target ID (same as PathName of view -path) (hexadecimal number) ff...ff: HLU number (same as PathName of view -path) (hexadecimal number) gg...gg: Dev number (same as DNum of view -path) (decimal number) hh...hh: Host device name (same as HDevName of view -path) Action The path might be damaged.
Message ID Message Text Explanation Path Error on page 5-2, and switch the path shown in the message to Online. KAPL08032-I A path was recovered. (PathID = aa...aa) Details The path has changed to an online status. aa...aa: Path ID (same as PathID of view -path) (decimal number) Action None KAPL09001 to KAPL10000 Message ID KAPL09001-E Message Text Explanation There is no system management Details permission.
Message ID KAPL09181-I Message Text The aa...aa of HDLM version bb...bb completed successfully. Explanation Details The unattended installation or remove of HDLM has completed normally. aa...aa: installation or remove bb...bb: Version number of the installed or removed HDLM Action None. KAPL09182-W An attempt to aa...aa HDLM version bb...bb has failed. See the previous messages to resolve the problems. Details The unattended installation or remove of HDLM failed. aa...aa: install or remove bb...
Message ID Message Text Explanation -s, or -h must be specified as parameters for the removehdlm utility for removing HDLM. aa...aa: Invalid parameter (character string) Action Make sure that the parameters for the installhdlm or removehdlm utility are appropriate, and then try again. For details on the installhdlm utility, see The installhdlm Utility for Installing HDLM on page 7-8. For details on the removehdlm utility, see The removehdlm Utility for Removing HDLM on page 7-11.
Message ID Message Text KAPL09284-W HDLM is not installed. Explanation Details If HDLM is not installed, the installhdlm utility for installing HDLM cannot be executed with the -v parameter. Action None. KAPL09605-I There is no license key file. File name = aa...aa Details There is no license key file in the designated folder. aa...aa: Windows-installationdestination-drive-name \hdlm_license or the-filethat-the-user-specified Action Enter a license key when prompted by a message to do so.
Message ID Message Text Explanation Action Login with administrator permission and re-install or reremove HDLM. KAPL09610-W The entered license key is invalid. Details Re-enter the license key because an entered license key is invalid. Action Enter a valid license key. KAPL09611-E The entered license key is invalid. The HDLM installation will now terminate. Obtain a valid license key, and then reinstall HDLM. Details The entered license key is invalid. Installation is aborted.
Message ID Message Text Explanation bb...bb : Version number of HDLM you attempted to install or remove Action ¢ install: Confirm the following, and then execute the installhdlm utility for installing HDLM again: • Confirm that the file and folder specified for the following keys in the installation-information settings file are correct: licensekeyfile installdir • Confirm that valid license information is stored in the license key file specified for licensekeyfile key.
Message ID Message Text KAPL10002-W Too many parameters have been specified. Explanation Details Four or more parameters have been specified. 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. KAPL10004-W The parameter contains an incorrect value. Value = aa...aa Details The first parameter must be a folder. aa...
Message ID Message Text Explanation on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL10020-I The file has been obtained successfully. File = aa...aa, Collection time = bb...bb(GMT:bb...bb) Details The file to be collected has been obtained. aa...aa: Collected file name bb...bb: Year/month/day hour:minute:second Action None. KAPL10022-I The utility for collecting HDLM error information completed normally.
Message ID Message Text Explanation Re-execute the DLMgetras utility. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL10033-W The file does not exist. Filename Details = aa...aa No file to collect information exists. aa...aa: Information collection file Action None. KAPL10034-E The file could not be copied. Filename = aa...aa, Details = bb...bb Details Execution of the cp command failed. aa...aa: File name you tried to copy bb...
Message ID Message Text Explanation the available disk capacity has decreased to less than 50 MB. Action Re-execute in an environment that has at least 50 MB of free disk capacity. KAPL10045-W A parameter is invalid. Details The specified parameter is invalid. Action Make sure that the parameters for the DLMgetras utility for collecting HDLM error information are appropriate, and then try again.
Message ID Message Text Explanation Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. KAPL10956-W An attempt to connect to the specified server has failed. Details An attempt to connect to the specified host has failed. Action Check the host name, user name or password that was specified in the DLMgetras utility for collecting HDLM error information, and then retry.
Message ID Message Text Explanation ¢ Get Path Status Log Information ¢ Get Local Time ¢ Get ESXi Information ¢ Add Path Information ¢ Delete Path Information ¢ Set Storage Identification Information Action None. KAPL11902-I aa...aa has started. PathID = bb...bb Details The operation has started on the host. aa...aa: Operation (character string) ¢ Online ¢ Offline bb...bb: The Path ID of the target path (decimal number) Action None. KAPL11903-I aa...aa has completed normally.
Message ID Message Text Explanation ¢ ¢ ¢ Add Path Information Delete Path Information Set Storage Identification Information Action None. KAPL11904-E aa...aa has completed abnormally. Error status = bb...bb Details The operation has completed abnormally on the host. aa...
Message ID KAPL11905-E Message Text An unexpected error occurred. Explanation Details An exception occurred during processing on the host. Action Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the 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. KAPL11906-I GUI information - aa...
Message ID Message Text Explanation Contact your HDLM vendor or maintenance company if there is a maintenance contract for HDLM. KAPL13605-W An error occurred during processing to output the audit log configuration file. Details An internal parameter error occurred during output of the audit log data. Action Contact your HDLM vendor or maintenance company if there is a maintenance contract for HDLM. KAPL13606-W An error occurred during processing to output the audit log configuration file.
Message ID Message Text Explanation bb...bb: Online or Offline(c) cc...cc: Command that the user executed KAPL15105-I Setting up the operating environment succeeded. Command Line = aa...aa Details aa...aa: Command that the user executed KAPL15106-W Setting up the operating environment failed. Command Line = aa...aa Details KAPL15107-I Details Program information was successfully displayed. Command Line = aa...aa aa...aa: Command that the user executed aa...
Message ID KAPL15403-I Message Text Explanation HDLM Manager successfully stopped. - KAPL15404-W The HDLM Manager was executed by the user who does not have the authority. - KAPL20001 to KAPL21000 Message ID KAPL20001-I Message Text The initialization of the plugin (HTI_SATP_HDLM) was successful. Explanation Details The initialization of the HTI_SATP_HDLM plugin has successful. Action None. KAPL20009-I The termination of the plugin (HTI_SATP_HDLM) was successful.
Message ID Message Text Explanation aa...aa: Name of Path that changed state bb...bb: Path state before change cc...cc: Path state after change Action Check the status of the path where the error was detected. KAPL20024-W I/O (aa...aa) to path (bb...bb) failed. Sense key=cc...cc ASC/ ASCQ=dd...dd Details An I/O error occurred. aa...aa: SCSI command bb...bb: Name of Path that had I/ O error cc...cc: Sense Key dd...
Message ID Message Text Explanation 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. KAPL20027-W I/O (aa...aa) to path (bb...bb) failed. Device status=cc...cc Details An I/O error occurred. aa...aa: SCSI command bb...bb: Name of Path that had I/ O error cc...
Message ID Message Text Explanation None. KAPL20031-E A primary volume of HAM pair (aa...aa) was blocked. Details The primary volume of HAM pair was blocked. aa...aa: Name of primary volume of HAM pair that is blocked Action Recover the path for the primary volume of the HAM pair, and resynchronize the HAM pair. After that, release the blocked state of the primary volume. KAPL20032-I A primary volume of HAM pair (aa...aa) was released. Details The primary volume of HAM pair was released. aa...
Message ID Message Text Explanation aa...aa: Name of device (HAM pair) specified for -d option Action Check the parameter you specified. Specify the correct parameter and retry the esxcli command. KAPL20036-E An attempt to release the primary volume of HAM pair (aa...aa) has failed. Details An attempt to release the primary volume of HAM pair specified for d option of esxcli command (nmp satp setconfig --config pvolrel) has failed. aa...
Message ID Message Text Explanation bb...bb: Host 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. For details on the DLMgetras utility, see The DLMgetras Utility for Collecting HDLM Error Information on page 7-2. KAPL20044-W The state of path (aa...aa) was not able to be updated. Device status=bb...bb Details aa...aa: Name of Path that was not able to be updated.
Message ID KAPL20051-E Message Text Explanation No path connected to the device Details (aa...aa) is in the Online(D) Due to path failure, path deletion, status. or offline operation, no path connected to the LU (aa...aa) is in the Online(D) status. aa...aa: Device name (same as HDevName of "dlnkmgr view path" command) Action To return a path to the Online(D) status, resolve the path failure, and then execute the "dlnkmgr online -dfha" command. KAPL20902-E A parameter is invalid. parameter = aa...
Message ID Message Text Explanation Action Check the Credential Store file, and then retry. For details on the dlmrmcenv utility, see The dlmrmcenv Utility for Configuring HDLM Remote Management Client Environments on page 7-7. KAPL20905-E The VMware vSphere CLI information could not be acquired. Details The VMware vSphere CLI information could not be acquired. Action Make sure that the environment variable of VMware vSphere CLI. Make sure that the command is executed by a VMware vSphere CLI.
KAPL21001 to KAPL22000 Message ID KAPL21001-I Message Text The initialization of the pspPlugin (aa...aa) was successful. Explanation Details The initialization of the HTI_PSP_HDLM plugin has successful. aa...aa: HTI_PSP_HDLM_EXLBK, HTI_PSP_HDLM_EXLIO, or HTI_PSP_HDLM_EXRR Action None. KAPL21009-I The termination of the pspPlugin Details (aa...aa) was successful. The termination of the HTI_PSP_HDLM plugin successful. aa...aa: HTI_PSP_HDLM_EXLBK, HTI_PSP_HDLM_EXLIO, or HTI_PSP_HDLM_EXRR Action None.
Return Code Explanation Terminate unnecessary applications to increase free memory, or restart the host. 1006 Details An Offline path cannot be placed Online. Action Remove the error in the path, and then retry. 1007 Details The target path of the offline operation is the last, remaining path connected to the device and therefore, cannot be placed in the offline status. Action Click Refresh to update the host information, check the path status, and then retry the offline operation.
Return Code Explanation Batch registration of Offline processing was performed. Action Refresh the host information, and then check the path status. 1023 Details Batch registration of Offline processing has already been performed. Action Refresh the host information, and then check the path status. 1025 Details A parameter value is invalid. Action Refresh the host information, and then perform the operation again.
Return Code Explanation An attempt to acquire information about the HDLM version or SP version has failed. Action Re-execute the command. 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 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.
Return Code 1043 Explanation Details The specified LU is part of a storage system that cannot use the load balancing function. Action Check the storage system of the LU that is connected by the specified path. 1045 Details A parameter is invalid. Action Refresh the host information, and then perform the operation again.
Return Code Explanation ¢ A communication error with the host occurred. Action Use the dlnkmgr command to verify that the host can be accessed from the remote management client, and then retry the operation. 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.
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 Acronyms-2 Hitachi Dynamic Link Manager User Guide for VMware® T 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 User Guide for VMware®
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 Acronyms-4 Hitachi Dynamic Link Manager User Guide for VMware® T 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 User Guide for VMware®
# A B C D E F G H I J K L M N O P Q R S Acronyms-6 Hitachi Dynamic Link Manager User Guide for VMware® T 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, 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, 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-15 view 6-24 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-42 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-42 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 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) 2-19 path switching automatically 2-13 manually 2-16 paths to which load balancing is applied 2-10 Performing F
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 User Guide for VMware®
Index-6 Hitachi Dynamic Link Manager User Guide for VMware®
Hitachi Dynamic Link Manager User Guide for VMware®
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.
