Hp XP7 Storage User Manual

Hitachi Command SuiteDynamic Link Manager(for Windows®) User GuideMK-92DLM129-29Document OrganizationProduct VersionGetting HelpContents

xHitachi Dynamic Link Manager (for Windows®) User Guide

¢In the last installation window, the following message might beoutput:When you manage a host by using Global Link Manager and Windows firewall is ena

Unattended Installation on page 3-28 or About the Log File on page 7-27in The installhdlm Utility for Installing HDLM on page 7-17.Make sure that the

21. Check the path information as described in Checking the PathConfiguration on page 3-70, and make sure that you have successfullyinstalled HDLM in

6. Perform the installation.¢If you are not performing an unattended installation, insert the DVDinto the drive.In the displayed window, click the Ins

¢If no message appears, go to the next step.9. Specify a license key file or enter a license key by following theinstructions shown in the messages th

Please update the Storport Miniport driver to a Storport.syswith a file version n.n.nnnn.n or later.¢The PRSV key will be registered before the instal

An example of executing the dlnkmgr command's view operation is asfollows:PROMPT>dlnkmgr view -sysHDLM Version : x.x.x-xxServ

33. Restart each host.34. Log on to Windows again as a member of the Administrators group.35. Make sure that the program is working normally running p

¢If you are not performing an unattended installation, insert the DVDinto the drive.In the displayed window, click the Install button next to forWindo

The utility for registering HDLM persistent reservation keys (dlmprsvkey)will be automatically executed. However, creation of the PRSV key mightbe uns

PrefaceThis document describes how to use the Hitachi Dynamic Link Manager.□Intended audience□Product version□Release notes□Document revision level□Do

When you manage a host by using Global Link Manager and Windows firewall is enabled on that host, execute the firewall_setup command to allow a firewa

Load Balance : on(extended lio)Support Cluster : on MSCSElog Level : 3Elog File Size (KB) : 99

6. Save the license key file directly under the Windows installation-destination drive.Also, instead of using the license key file, you can directly s

9. Specify a license key file or enter a license key by following theinstructions shown in the messages that appear in the window.If a license key fil

When you manage a host by using Global Link Manager and Windows firewall is enabled on that host, execute the firewall_setup command to allow a firewa

Trace Level : 0Trace File Size(KB) : 1000Number Of Trace Files : 4Path Health Checking : on(30)Auto Failback

5. Save the license key file directly under the Windows installation-destination drive. Also, instead of using the license key, you can directlyspecif

8. Specify a license key file or enter a license key by following theinstructions shown in the messages that appear in the window.If a license key fil

When you manage a host by using Global Link Manager and Windows firewall is enabled on that host, execute the firewall_setup command to allow a firewa

Trace Level : 0Trace File Size(KB) : 1000Number Of Trace Files : 4Path Health Checking : on(30)Auto Failback

Intended audienceThis document is intended for storage administrators who use HitachiDynamic Link Manager (HDLM) to operate and manage storage systems

PROMPT>dlnkmgr view -sysHDLM Version : x.x.x-xxService Pack Version : Load Balance : on(extended lio)Suppor

3. Perform the installation.¢If you are not performing an unattended installation, insert the DVDinto the drive.In the displayed window, click the Ins

¢Although a message prompting you to restart the host appears afterthe installation has finished, a restart is not necessary.¢In the last installation

14. Click the OK button to close the MPIO Properties dialog box.15. Shut down the host.Leave the host in a single-path configuration until you check (

HDLM Manager Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssHDLM Alert Driver Ver WakeupTime ElogMem SizeAlive

Installing MSCS after an HDLM installationTo install HDLM and then MSCS:1. Shut down all the hosts.2. Make sure that all the hosts that make up the cl

The utility for registering HDLM persistent reservation keys (dlmprsvkey)will be automatically executed. However, creation of the PRSV key mightbe uns

appear if deletion of this file fails. If this happens, delete the filemanually.13. If you want to select an EMC CX series or an HP EVA series LU as t

HDLM Alert Driver Ver WakeupTime ElogMem SizeAlive x.x.x-xx yyyy/mm/dd hh:mm:ss 128HDLM Driver Ver WakeupTimeAlive

Auto Failback : on(1)Remove LU : offIntermittent Error Monitor : offDynamic I/O Path Control : off(10)HDLM Man

Document organizationThe following table provides an overview of the contents and organization ofthis document. Click the chapter title in the left co

This command checks whether HDLM has already been installed. Ifthe KAPL09183-I message will appear, the re-installation isperformed.After the installa

HDLM-installation-folder\bin\dlmprsvkey -vMake sure that the PRSV key displayed by the dlmprsvkey utility isunique among all the other hosts in the SA

HDLM Version : x.x.x-xxService Pack Version : Load Balance : on(extended lio)Support Cluster : on

The dlmchkpath utility is executed automatically when the installationprogram (setup.exe) starts. The dlmchkpath utility checks whether thesystem is i

Migrating from HDLM 5.4 or Earlier to HDLM 5.5 or LaterTo upgrade from HDLM 5.4 or earlier:1. Copy the following files to any location other than the

DLMAlertDriver by using the procedure below. Note, however, thatleaving DLMAlertDriver on the window will not affect HDLM operations:a. From the Devic

\jre1.6.0_04# \bin \lib#The folder name depends on the JRE version that will be used:When using JRE 1.4.2_13: j2re1.4.2_13When using JRE 5.0_10

firewall_setup command syntaxIf the host OS is Windows, the firewall_setup command is used to registerthe ports used by the Hitachi Command Suite Comm

In Windows, the folder in which the Hitachi Command Suite CommonAgent Component commands are installed is automatically added to theenvironment variab

Setting Up HDLMHDLM includes functions like the load balancing function, the automaticfailback function, the error logging function, the audit logging

• Hitachi USP Series User's Guide• Hitachi Workgroup Modular Storage Series User's Guide• Thunder9580V Series Disk Array Subsystem User&apos

KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ssPROMPT>Setting Up the HDLM FunctionsTh

Function Default value Recommended valueCollection of audit logdataoff The recommended valuedepends on the operatingenvironment.Set on, if you want to

Setting Up Path Health CheckingYou can choose whether you want to use path health checking.• Set up path health checking by using the set operationThe

Setting Up Intermittent Error MonitoringIntermittent error monitoring is specifiable only when the automatic failbackfunction is enabled. To prevent a

dlnkmgr set -dpc on -pathid 000001 -ludlnkmgr set -dpcintvl 10Specify "on" to enable the dynamic I/O path control function, or "off&quo

Setting the Error Log Collection LevelThere are two error logs: the HDLM manager log file dlmmgrn.log (nindicates a file number from 1 to 16) and the

Value Description2 Program operation summaries are output.3 Program operation details are output.4 All information is output.If an error occurs, you m

Setting the Number of Error Log FilesThere are two error logs: the HDLM manager log file dlmmgrn.log (nindicates a file number from 1 to 16) and the H

KAPL01097-W message will be displayed to confirm the execution, and thetrace file will be temporarily deleted.By specifying both the trace file size a

dlnkmgr set -audlog on -audlv 6 -category allSpecify on if you want to collect audit log data, and off if you do not want tocollect audit log data. If

Physical capacity unit Value1 kilobyte (KB)1,000 (103) bytes1 megabyte (MB)1,000 KB or 1,0002 bytes1 gigabyte (GB)1,000 MB or 1,0003 bytes1 terabyte (

Files#\HITACHI\HNTRLib2\spool\Hntr2n.log files (n indicates a filenumber)).#For Windows Server 2003 (excluding the x86 edition) , Windows Server2008 (

#For Windows Server 2003 (excluding the x86 edition), WindowsServer 2008 (excluding the x86 edition), or Windows Server 2012,Program Files is Program

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 outputbecause the

• Depending on the environment, removing HDLM might take some time.Do not terminate the removal process while a progress bar for removal isdisplayed.

the folder specified in the TMP or TEMP environment variable, if the -wparameter was not specified).Removing HDLMAfter HDLM is removed, sometimes the

Figure 3-6 Single Path Configuration and Multi-path ConfigurationIf you have selected an EMC CX series or an HP EVA series LU as theHDLM management-ta

From the Command Prompt window, execute the removehdlm utilityfor removing HDLM.For details about the removehdlm utility, see The removehdlm Utilityfo

Figure 3-7 Single Path Configuration and Multi-path ConfigurationIn Windows Server 2008, if you have selected an EMC CX series or an HPEVA series LU a

Server Core environment:From the Command Prompt window, execute the removehdlm utilityfor removing HDLM.For details about the removehdlm utility, see

¢For an HP EVA series:The hardware ID is HP HSV.6. Click the OK button to close the MPIO Properties dialog box.7. Start the removal program.From Contr

our existing Support Portal and support services by providing an area whereyou can get answers to non-critical issues and questions. Join theconversat

3.Execute the following command#1 to check if any program is usingHNTRLib2:"C:\Program Files#2\HITACHI\HNTRLib2\bin\hntr2getname.exe"If the

c. Check that the hntr2t.dll file exists and the hntr2sys.dll andhntr2tj.dll files do not exist in the folder, and then delete thehntr2t.dll file.Clea

3-94Creating an HDLM EnvironmentHitachi Dynamic Link Manager (for Windows®) User Guide

4HDLM OperationThis chapter describes the operating procedures for HDLM, including how tooperate HDLM and the HDLM manager, and how to change the conf

Notes on Using HDLMThis section contains notes that are important for running HDLM operations.Using a Storage Management ProgramYou must not change th

EMC DMX series and EMC CX series: HDLM 5.7 or laterHP EVA series: HDLM 5.9.1 or later¢If the OS is Windows Server 2008:EMC CX series: HDLM 6.4 or late

If you attempt to perform an HDLM operation by any other method, a dialogbox will appear, requesting confirmation that you have administratorpermissio

¢Execute the HDLM command using the Administrator account.¢To execute an HDLM command with a non-administrator account, usethe Administrator: Command

Changing the Status of Paths to OnlineTo change the status of paths to online:1. Check the current status of the paths.To place paths online by specif

The paths to be placed offline can be specified by using an HBA port, CHAport, single path, or HBA port WWN. For details on how to specify paths,see o

1Overview of HDLMHDLM is a software package that manages paths between a host and astorage system. HDLM is designed to distribute loads across multipl

000009 OnlineKAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ssPROMPT> For

The following shows an example in which the command is executed:PROMPT>dlnkmgr view -sys -sfuncHDLM Version : x.x.x-xxService Pac

• Trace file size• The number of trace files• Number of times the same path can be used for load balancing• Number of times the same path can be used

Note:When you are executing the dlnkmgr command's set operation with the -lic parameter to install the license, you can only execute it once at a

PROMPT> The value displayed in HDLM version indicates the HDLM version.Viewing HDLM Component InformationThis section explains how to display HDLM

Using the Windows Administrative Tool (Performance) toCheck Path InformationThe HDLM Performance Monitor uses the Windows administrative toolPerforman

Counter name DescriptionDisk ReadBytes/SecThe amount of data transferred per second from the diskduring read operations.Disk WriteBytes/SecThe amount

Starting the HDLM ManagerDuring installation, the HDLM manager is registered as a Windows serviceand the startup type is set to Automatic. This means

HDLM Resident ProcessesThe table below lists and describes the resident processes in HDLM. Tomonitor these processes, use the names below.Table 4-3 HD

3. If the LU is not displayed in the Disk Management window, perform thefollowing operations to add the LU as an HDLM management-target.¢From the Devi

What is HDLM?With the widespread use of data warehousing and increasing use ofmultimedia data, the need for high-speed processing of large volumes of

When you create a partition, assign the same drive letter as the oneassigned for node A in step 3.6. Stop node B, and then restart node A.7. On node A

- KAPL05301-ENote that these messages are output by Windows activities, and notby an error in HDLM.Deleting an LU DynamicallyThe LU deletion function

When an LU is deleted from the HDLM management target by using theLU deletion function, the KAPL08022-E message might not be output tothe event log. I

The following table shows the items and descriptions for the path information,which are displayed in the KAPL05301-E message.Table 4-4 Items and Descr

4-22HDLM OperationHitachi Dynamic Link Manager (for Windows®) User Guide

5TroubleshootingThis chapter describes how to properly use HDLM error information, and thenhow to resolve the problem, if an error occurs in HDLM. The

Information Collected by the DLMgetras Utility forCollecting HDLM Error InformationImmediately after an error occurs, execute the DLMgetras utility fo

output to the event log. If this happens, refer to the KAPL05301-Emessage to check the path information.The message elements are explained below:For d

The name of the host device.A drive letter is used. If no drive letter has been assigned, a hyphen (-)will be displayed.This is the same as the HDevNa

Figure 5-2 Troubleshooting Procedure When a Path Error OccursThe following shows the procedure for using the HDLM command (dlnkmgr)to handle a path er

The ability to continue running operations between a host and storagesystem, even if there is a failure. This is also known as performing a failover.W

Identifying the Error PathCheck the obtained path information to find the path with the error. In theStatus column, the error path has the status Offl

Figure 5-3 Troubleshooting Procedure When a Program Error OccursThe following shows the procedure for handling a program error by using theHDLM comman

problem. For details on the view operation, see view (Displays Information)on page 6-33.Execute the following command:Example:dlnkmgr view -sysIf the

6Command ReferenceThis chapter describes the HDLM command (dlnkmgr) and its operations.□Overview of the HDLM Command dlnkmgr□clear (Returns the Path S

Overview of the HDLM Command dlnkmgrThis section describes how to specify the HDLM command dlnkmgr and itssubcommands (called operations in HDLM).Comm

¢If you are using Windows Server 2003 , execute HDLM commands asa member of the Administrators group.If you are executing HDLM commands in Windows Ser

PROMPT>dlnkmgr clear -pdst -sKAPL01001-I The HDLM command completed normally. Operation name = clear, completion time = yyyy/mm/dd hh:mm:ssPROMPT&

ExamplesExample 1The following example shows how to display all the operations available inthe HDLM command. PROMPT>dlnkmgr helpdlnkmgr: Format

help: Format dlnkmgr help { clear | offline | online | set | view | delete}KAPL01001-I The HDLM command completed normally. Operation name = help,

This parameter is optional because offline is always used for paths, so itis assumed.Make sure that you specify the paths to be taken offline by using

© 2014 Hitachi, Ltd. All rights reserved.No part of this publication may be reproduced or transmitted in any form or by any means,electronic or mechan

1-4Overview of HDLMHitachi Dynamic Link Manager (for Windows®) User Guide

AutoPATH_IDs are re-assigned every time the host is restarted. Alwaysmake sure that you use the view operation to find the currentAutoPATH_ID of the t

For details on how to execute the view operation and display the HBAport WWN and path name, see Parameters Used When Displaying PathInformation on pag

Valid value AutoPATH_ID { 000000 - 999999 }(Decimal) Host_LUN { 0000 - FFFF }(Hexadecimal)KAPL01001-I The HDLM command completed no

online (Places Paths Online)The dlnkmgr command's online operation places offline paths online. Tospecify the paths to be placed online, specify

operation. Enter a period between these two parameter values. Fordetails about the view operation, see view (Displays Information) on page6-33. Leadin

Use this parameter to place a single path online.Specify the current AutoPATH_ID of the target path, which is displayed byusing the view operation. Fo

of all the paths in the Online(S) and Online(D) statuses, specify only -hapath.-dfhaUse this parameter to change the paths to the primary volume (P-VO

dlnkmgr online [-path] -cha -pathid AutoPATH_ID [-s] dlnkmgr online [-path] [-pathid AutoPATH_ID] [-s] dlnkmgr online [-path] [-hbaportwwn H

status of, has been deleted, and then resolve the path error. For details, seeDeleting an LU Dynamically on page 4-19.set (Sets Up the Operating Envir

Table 6-2 Default and Recommended ValuesItem name Default value Recommended valueLoad balancingonThe Extended Least I/Osalgorithm is used.onThe recomm

2HDLM FunctionsThis chapter describes the various functions that are built into HDLM. Beforethe function specifications are explained though, this cha

Item name Default value Recommended valueyou want to display thephysical storage systeminformation.#This item is applied only when Hitachi AMS2000 ser

HDLM GUI logs:dlmguin.log (n indicates a file number of 1 or 2)Table 6-3 Values of the Error Log Collection Level on page 6-19shows the values of the

When combined with the specification for the error log file size, themaximum total size of error log files that can be collected is 32000000KB(approxi

When combined with the specification for the trace file size, the maximumtotal size of the trace files that can be collected is 1024000KB.If the value

Enabling automatic failbacks might automatically place paths online thatwere intentionally placed offline (for example, paths placed offline formainte

When you set the number of times that the error is to occur to 1, theabove condition does not need to be satisfied.When you change the error monitor i

When a value of 2 or more is specified for the number of times, thefollowing condition must be satisfied: error-monitoring-interval >= checking-int

completes. When intermittent error monitoring is not beingperformed, the number of errors that determine that an intermittenterror has occurred is not

SettingAvailable operation Result of operationAFB IEMChange the IEM settings. • While a path is being monitored, thevalue of the error count and theel

KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: yKAPL01001-I The HDLM command completed normally. Operation name = se

□Collecting Audit Log Data□Integrated HDLM management using Global Link Manager□Cluster Support2-2HDLM FunctionsHitachi Dynamic Link Manager (for Wind

KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: yKAPL01071-I A permanent license was installed.PROMPT>Example 2The

Value Descriptionon -forceThe LU is removed from HDLM-management when all the paths to theLU are disconnected, even when an Offline(C) path is include

Value ExplanationallAudit log events of the StartStop, Authentication, andConfigurationAccess categories are collected.-lbpathusetimes number-of-path-

on: Enabledoff: DisabledIf the display of the physical storage system information is enabled,information about the physical storage system is displaye

| -elfn Number-Of-ElogFiles | -systflv TraceLevel | -systfs TraceFileSize | -systfn Numbe

view (Displays Information)The dlnkmgr command's view operation displays HDLM program information,HDLM management-target device information, path

To display a summary of path informationdlnkmgr view -path -c[-pstv|-vstv][-stname][-srt {lu|cp}][-t]To Display LU InformationTo display LU informatio

ParametersThis section describes the parameters for the view operation, in the followingorder:Parameters Used When Displaying Program Information on p

Parameter andprograminformation tobe displayedItem DescriptionWhen the setting status of load balancing ison, one of the following types of algorithms

Parameter andprograminformation tobe displayedItem DescriptionNumber Of TraceFilesNumber of trace filesPath HealthChecking• Settings for path health c

Devices Managed by HDLMBelow is a list of devices that can or cannot be managed by HDLM. Thedevices that can be managed by HDLM are called HDLM manage

Parameter andprograminformation tobe displayedItem Description• Checking intervalThe parentheses following the setting statusshows the checking interv

Parameter andprograminformation tobe displayedItem DescriptionFor example, when there are 100 days leftuntil the license period (2006/08/21) expires,t

Parameter andprograminformation tobe displayedItem Descriptionstorage-system-informationsettingoff: Disabled#When the HDLM manager starts, HDLM cluste

HDLM Alert Driver Ver WakeupTime ElogMem SizeAlive x.x.x-xx yyyy/mm/dd hh:mm:ss 128KAPL01001-I The HDLM command completed norm

= view, completion time = yyyy/mm/dd hh:mm:ssPROMPT>Example 9The following example shows how to display the value of the display-of-the-physical-st

Item DescriptionIf the OS is Windows Server 2008, this item always displayson.#1The EMC DMX series cannot be managed.#2The EMC DMX series and the HP E

system is displayed. If neither parameter is specified, information isdisplayed according to the value specified in the -pstv parameter ofset operatio

• When an HDLM management-target device is the EMC DMX series,EMC CX series, or HP EVA series:If this parameter is specified, all 32 digits of the iLU

Parameters to display path information, by selecting a display item:-path -itemWhen you specify the -path parameter together with the -itemparameter,

Selectable items Sub-parametersStatus#NoneType typeIO-Count icIO-Errors ieDNum dnuHDevName hdIEP iepHBAPortWWN hbaportwwnPhysical-LDEV physVirtual-LDE

HDLM assigns a unique ID to each management-target path. This ID is calledAutoPATH_ID. Sometimes, the path is also just simply called a managementtarg

Specify a drive letter to indicate the desired host device. You cannotspecify the host device unless a drive letter has been assigned. Thehost-device-

DMX series, EMC CX series, and HP EVA series will not bedisplayed. Ellipsis (...) will be displayed instead.• When an HDLM management-target device is

path information. The displayed contents are also shortened, so that eachpath information item is displayed on a single line.The items that are displa

-tOmits the title for each information item.ExampleThe following example shows how to display a summary of the pathinformation in order of iLUs.Displa

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedcheck the status of individual paths and resolve the problemfor any paths that have an erro

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedStorage Platform V/VM series, and Virtual StoragePlatform series the serial number of the s

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedThe ID that differs from the LU number in the storagesystem and that identifies the LU is i

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedOwn: Owner pathNon: Non-owner pathWhen connecting to the Lightning 9900V series, HitachiUSP

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedrange (the path status is Online(E), Offline(C) orOffline(E)).• A value of at least 0Indica

Displayed ItemDescriptionNosummarydisplayedSummarydisplayed• For HUS VM indicated by a hexadecimal number. The firsttwo characters of iLU are the CU n

System Configuration Using an IP-SANIn an IP-SAN, LAN cables are used to connect hosts to storage systems. Thecable port on the host is called an iSCS

In a cluster configuration, an offline operation requested during reserveprocessing is put into the waiting-to-execute state, and does not executeunti

Model names ofstorage systemsProduct IDWithout the -stname parameterWith the -stnameparameter(Displays thefollowing for themodel ID)Hitachi SMS series

characters after the 9th character are not displayed, and ellipsis (...)are displayed instead.¢For command devices, -CM is added to the end of the emu

Displays information only for the paths accessing the specified hostdevice, if the -hdev parameter is specified.Specify a drive letter to indicate the

000010 Online 6006048000018... M 000001 Online 000011 Online 6006048000018... N

The items specified with the -item option are displayed among with thosedisplayed by the -lu option.If all is specified for the -item parameter, all i

If the -pstv parameter is specified, information about the physicalstorage system is displayed. If the -vstv parameter is specified,information about

Example 2:When using Hitachi AMS2000 series, Hitachi SMS series , or HUS100series storage and displaying LU information with DPC added to thedisplay i

¢For the EMC DMX series and EMC CX series, LU information isdisplayed for each vendor ID.¢For the HP EVA series, LU information is displayed for eachv

When the -exlu parameter is specified:Parameters to display a summary of LU information by adding itemsto be displayed:-lu -c -itemThe items displayed

Figure 2-3 Configuration of an IP-SAN System When Using iSCSI Softwareand an NICThe following table lists the HDLM system components when using an IP-

For information about the items that are displayed differentlydepending on the specified -pstv and -vstv parameters, see Table6-10 Display items for w

Table 6-19 Displayed LU InformationDisplayed itemDescriptionNosummarydisplayedSummarydisplayedProduct• For the Thunder 9500V series, Lightning 9900Vse

Displayed itemDescriptionNosummarydisplayedSummarydisplayedThis number combined with the storage systemname (shown in DskName) identifies the LU thati

Displayed itemDescriptionNosummarydisplayedSummarydisplayedHDevName#1#3- Host device name.A drive letter is displayed. If no drive letter has beenassi

Displayed itemDescriptionNosummarydisplayedSummarydisplayedCLPR#1- The number of the CLPR to which the CHA portbelongs, indicated by a number from 0 t

Displayed itemDescriptionNosummarydisplayedSummarydisplayedWhen connected to the Lightning 9900V series,Hitachi USP series, Universal Storage Platform

Displayed itemDescriptionNosummarydisplayedSummarydisplayedPhysical-LDEV- The model ID, serial number, and iLU number of aphysical volume are separate

Displayed itemDescriptionNosummarydisplayedSummarydisplayed-OnlinePathsNumber of online paths among the paths recognizedby HDLM for the LU. When the v

- The user selected the item to be displayed by using the -lu -c -itemparameter.- No value was specified for the parameter.#3The drive letter assigned

PROMPT> delete (Deletes a Path Dynamically)The dlnkmgr command's delete operation batch-deletes disconnected pathswhose statuses are Offline(C

Setting Range of the iSCSI Software and iSCSI HBAThe following describes the ranges that can be used for the iSCSI softwareand iSCSI HBA settings. For

Note:Any paths excluded from the HDLM-management targets must be deletedfrom the OS before executing this command.To Display the Format of the delete

7Utility ReferenceThis chapter explains the utilities used by HDLM.□Overview of the Utilities□The DLMgetras Utility for Collecting HDLM Error Informat

Overview of the UtilitiesHDLM provides the following utilities:• The DLMgetras utility for collecting HDLM error informationWhen an error occurs, this

files, definition files, and OS information. The collected information isarchived in a file and saved to a folder of your choosing.Whenever the host i

The utility obtains logs from each application, system, and security eventlog. The logs obtained are those output after 00:00 on the dateyyyy/mm/dd. S

Folder that stores collectedfiles#1Files Explanationdlmstnn.logLog file of the function forsetting storage systemnames.hcmdslicense2.logLog when updat

Folder that stores collectedfiles#1Files Explanationinstallation-destination-drive-name_\Program Files\VERITAS\Volume ManagerM.N\logs#6folder-to-which

Folder that stores collectedfiles#1Files Explanationdlmmgr-lu.txtResult of the dlnkmgr view -lu -item pn cp type ic iednu slpr clpr dpc vid -exlu comm

Folder that stores collectedfiles#1Files Explanationhyper-v.txtWMI class instance related toHyper-Vhyperv-haadm.txtWindows event log related toHyper-V

Folder that stores collectedfiles#1Files ExplanationwevFCOper.txtContents of Windows eventlogwevFCMgrA.txtContents of Windows eventlogwin_dep.logDEP s

After the installation of HDLM, an LU recognized by a host is called a host LU(HLU). The areas in a host LU that correspond to the Devs in a storagesy

For Windows Server 2003 (excluding the x86 edition), Windows Server2008 (excluding the x86 edition), or Windows Server 2012, ProgramFiles is Program F

-dDisplays a list of the paths for LUs managed by HDLM and persistentreservation information.-hDisplays the format of the dlmpr utility.No parametersD

ExclusiveAccessRegistrantOnly000001 0001.0000.0000000000000000.0001 1 200000E08B1059EC ExclusiveAccessRegistrantOnlyKAPL10655-I Specify the Pat

The dlmprsvkey Utility for Registering an HDLM PersistentReservation KeyThis utility registers and displays a PRSV key on an HDLM host. A PRSV key isr

successful. (PRSV key = 0123456789abcdef)PROMPT>-sSpecify this parameter to avoid displaying a confirmation messageupon execution of the dlmprsvkey

Checks whether a single path configuration is being used to connect theHDLM management-target LU to the host.ExamplesIn the following example, the uti

The dlmhostinfo Utility for Checking HDLM InstallationInformationThis utility either displays HDLM installation information from the commandprompt or

"version","x.x.x-xx"KAPL13801-I The dlmhostinfo utility for confirming HDLM installation information completed normally.PROMPT>

Formatinstallhdlm {-f installation-information-settings-file-name [-c ]| -v| -h}Parameters-f installation-information-settings-file-nameSets the infor

Table 7-3 Keys That Can Be Defined in the [INSTALLATION_SETTINGS]SectionKey name DescriptionNecessity ofdefinitionMaximumcharacterlength#1Newinstallat

Program ConfigurationHDLM is actually a combination of several programs. Because each programcorresponds to a specific HDLM operation, it is important

Key name DescriptionNecessity ofdefinitionMaximumcharacterlength#1NewinstallationUpgradeinstallation orRe-installationIf this key is omitted¢In Window

Key name DescriptionNecessity ofdefinitionMaximumcharacterlength#1NewinstallationUpgradeinstallation orRe-installationn: Do not restart (default).In a

[ENVIRONMENT_SETTINGS] sectionThis section defines HDLM operational and function information. HDLMoperational and function information is optional, ho

Key name#1Description#2Necessity ofdefinitionMaximumcharacterlength#3NewinstallationUpgradeinstallation orRe-installation(rr), Least I/Os (lio), or Le

Key name#1Description#2Necessity ofdefinitionMaximumcharacterlength#3NewinstallationUpgradeinstallation orRe-installationtrace_file_numberSpecify the

Key name#1Description#2Necessity ofdefinitionMaximumcharacterlength#3NewinstallationUpgradeinstallation orRe-installationYou can specify a value from

Legend:Optional:¢For a new installation:If no key or setting value is specified, the installer uses the defaultvalues.¢For an upgrade installation or

load_balance_type=exlioload_balance_same_path_use_times=1lbex_usetimes_limit=100error_log_level=3error_log_size=9900error_log_number=2trace_level=0tra

The removehdlm Utility for Removing HDLMThe removehdlm utility removes HDLM. If you execute the removehdlm utilitywith the -s parameter specified, no

8MessagesThis chapter describes the format and meaning of the message IDs, and alsothe terms used in the messages and message explanations. For detail

ContentsPreface... xiIntended audience...

Program name Functions• Clear persistent reservations• Register persistent reservation keys• Check the configuration of the paths• Check the installat

□KAPL15001 to KAPL16000□Return Codes for Hitachi Command Suite Common Agent Component□Events Output to Windows Event Logs by HDLM8-2MessagesHitachi Dy

Before Viewing the List of MessagesThis section explains the following information that is needed to locatemessages and understand the explanations in

KAPL01001 to KAPL02000Message ID Message Text ExplanationKAPL01001-I The HDLM command completednormally. Operation name =aa...aa, completion time =bb.

Message ID Message Text ExplanationKAPL01006-W A necessary parameter is notspecified. Operation name =aa...aaDetailsThe specified operation does notco

Message ID Message Text Explanationthen retry the HDLM command.For details on the view operation,see view (Displays Information)on page 6-33.KAPL01013

Message ID Message Text ExplanationKAPL01016-W The target CHA port was notfound. Operation name =aa...aaDetailsThe path ID indicated by -pathidand req

Message ID Message Text Explanation¢view operationRefer to Chapter 3, Creatingan HDLM Environment onpage 3-1. Creating an HDLMEnvironment or Reconfigu

Message ID Message Text Explanationspecified at the same time, andthen retry. For details on the helpoperation, see help (Displays theOperation Format

Message ID Message Text ExplanationKAPL01041-E The entered value is invalid. Theoperation stops. Operationname = aa...aaDetailsCommand processing will

Message ID Message Text ExplanationKAPL01047-W Only one offline request can beregistered in a batch job.DetailsThe offline command cannot beexecuted b

Figure 2-6 Driver Levels of the HDLM and MPIO DriversDistributing a Load Using Load BalancingWhen the system contains multiple paths to a single LU, H

Message ID Message Text Explanationsee online (Places Paths Online)on page 6-11.KAPL01051-I Because no path has beenselected among the currentlydispla

Message ID Message Text Explanationcommand, a path that cannot beplaced in the Offline(C) statuswas detected. PathID = aa...aaWould you like to contin

Message ID Message Text Explanationenter y. To cancel processing,enter n.aa...aa: CHA port or HBAActionIf you want to execute onlineprocessing for the

Message ID Message Text ExplanationNone.KAPL01061-I aa...aa path(s) weresuccessfully placed bb...bb;cc...cc path(s) were not.Operation name = dd...ddD

Message ID Message Text ExplanationAs a result of a previous online/offline operation, the specifiedpath has already been set toOnline/Online(S)/Onlin

Message ID Message Text Explanationoperation without specifyingthe host device name.KAPL01065-E The configuration does notsupport the simultaneous use

Message ID Message Text ExplanationActionInstall a permanent license by theexpiration day.KAPL01073-E The temporary license expired. DetailsThe tempor

Message ID Message Text Explanation(automatic-failback-checking-interval x number-of-times-error-is-to-occur-for-intermittent-error-monitoring).KAPL01

Message ID Message Text Explanationparameter = bb...bb, parametervalues = cc...ccbb...bb: Parameter namecc...cc: Parameter values thatcannot be specif

Message ID Message Text Explanationthe DLMgetras utility for collectingHDLM error information, acquirethe error information, and thencontact your HDLM

Platform V/VM series, and Virtual Storage Platform series. In a non-clusterenvironment, the load balancing function is available for the Thunder 9500V

Message ID Message Text Explanationtarget HBA port WWN. After that,specify the appropriate HBA portWWN, and then retry.KAPL01102-I All the paths which

Message ID Message Text ExplanationKAPL01107-I The load balancing typespecified for individual LUs willbecome invalid when thisoperation is executed.

Message ID Message Text Explanationspecify the desired setting byusing the dlnkmgr set -audlogcommand.KAPL01117-W An error occurred duringprocessing t

Message ID Message Text Explanationbb...bb: Online or Online(S)cc...cc: The number of pathswhich changed to the Online(S)or Online(D) statusdd...dd: O

Message ID Message Text ExplanationKAPL01156-I The dynamic I/O path controlfunction was set to aa...aa forstorage.Detailsaa...aa: "on" or &q

Message ID Message Text ExplanationEnter y to change the pathconfiguration, or enter n to cancelthe operation.KAPL01163-E The path configuration chang

Message ID Message Text ExplanationActionIf you want to change the numberof times that the same path canbe used for the system, enter y.To cancel the

Message ID Message Text ExplanationLU that has the specified pathID will be set to Online. Is thisOK? [y/n]:specified LU will be set to Online.To cont

Message ID Message Text ExplanationSpecify a physical CHA port byusing the -cha -pathidparameter, and then re-executethe offline or online operation.K

Message ID Message Text Explanation¢JHSPGetDriverStatus¢JHSPGetADriverStatus¢JHSPVerifyAuthorizationActionExecute the DLMgetras utility forcollecting

Figure 2-8 Flow of I/O Data When the Load Balancing Function Is UsedWhen the load balancing function is used, I/O operations are distributed viamultip

Message ID Message Text ExplanationThis is a confirmation forexecution. If you want to executethe operation, click OK. To cancelthe operation, click C

Message ID Message Text ExplanationActionData has not been input for thespecified item. See the HDLM GUIHelp to specify a number withinthe valid range

Message ID Message Text ExplanationIf you do not want to proceed,click Cancel.ActionIf you want to execute onlineprocessing, click OK. To cancelonline

Message ID Message Text ExplanationFor the path ID of a path forwhich online/offline processingfailed, see the operation log.KAPL02022-W A path that c

Message ID Message Text Explanationaa...aa: Operation (characterstring)¢Online¢Clear Data¢Export CSV¢Get Path Information¢RefreshActionClick Refresh t

Message ID Message Text Explanation¢Clear Data¢Get HDLM Manager Status¢Get HDLM Driver Status¢Get HDLM Alert DriverStatusbb...bb: Issuing API name(cha

Message ID Message Text ExplanationTerminate unnecessaryapplications to increase theamount of free memory, or restartthe host.KAPL02033-E An unexpecte

Message ID Message Text Explanationwant to use the load balancingfunction, remove MSCS.KAPL02042-E An unexpected error occurred.The HDLM GUI cannot st

Message ID Message Text Explanationoperation, see view (DisplaysInformation) on page 6-33.KAPL02053-I Would you like to terminate theHDLM GUI? [OK/Can

Message ID Message Text Explanationmaintenance company to checkwhether the storage systems youare using support persistentreservations.KAPL02061-W The

load balancing will be performed among the remaining, usable owner paths.It is only when absolutely no owner paths are available, that load balancing

Message ID Message Text Explanationis-to-occur-for-intermittent-error-monitoring).KAPL02065-W The getting PathInformation hasbeen stopped because thec

Message ID Message Text ExplanationKAPL02083-I HDLM GUI is started by theuser-specified JRE. aa...aa,bb...bbDetailsaa...aa: The user-specified JREvers

Message ID Message Text ExplanationKAPL02200-I GUI information - aa...aa DetailsThis information is required forresolving problems.aa...aa: Trace info

Message ID Message Text ExplanationActionExecute the DLMgetras utility forcollecting HDLM error information,and then contact your HDLMvendor or the ma

Message ID Message Text ExplanationExecute the DLMgetras utility forcollecting HDLM error information,and then contact your HDLMvendor or the maintena

Message ID Message Text ExplanationThe HDLM manager internalparameter is invalid.ActionExecute the DLMgetras utility forcollecting HDLM error informat

Message ID Message Text Explanationaa...aa: Option definition filenameActionCheck whether another program iscurrently using this file (forexample, the

Message ID Message Text ExplanationKAPL04012-E Could not create acommunication pipe. RC =aa...aaDetailsHDLM manager could not startnormally because it

Message ID Message Text ExplanationHDLM Error Information on page7-2.KAPL04019-E Could not collect the errorinformation. RC = aa...aaDetailsAn attempt

Message ID Message Text ExplanationExecute the DLMgetras utility forcollecting HDLM error information,and then contact your HDLMvendor or the maintena

¢VSP G1000 series¢Hitachi AMS2000 series#¢Hitachi SMS series#¢HUS100 series#¢HUS VM#: This storage system applies when the dynamic I/O path controlfun

Message ID Message Text ExplanationInstall a permanent license by theexpiration day.KAPL04028-E The temporary license expired. ActionInstall a permane

Message ID Message Text ExplanationKAPL04036-I The path health check for thepath aa...aa was executed.Number of error paths = bb...bbDetailsaa...aa: N

Message ID Message Text ExplanationKAPL04054-I The owner controller will now berevised. (number of LUs =aa...aa)Detailsaa...aa: number of targeted LUs

Message ID Message Text ExplanationKAPL05004-I The filtering function (aa...aa)for the HDLM driver (filtercomponent) was initializedsuccessfully.Detai

Message ID Message Text ExplanationActionCheck whether the HDLM driverhas started normally. If it has notstarted or contains an error,contact your HDL

Message ID Message Text ExplanationKAPL05032-I The path health checking for thepath (aa...aa) completednormally. (bb...bb,cc...cc)Detailsaa...aa: Path

Message ID Message Text Explanationmaintenance company. Refer tothe HDLM User's Guide forinstructions how to execute theDLMgetras utility.PathID

Message ID Message Text ExplanationNone.KAPL07820-E The configuration does notsupport the simultaneous use ofthe load balancing and clustersupport fun

Message ID Message Text Explanationfunction can also be used for thiskind of LU.aa...aa: Path ID (same as PathIDof view -path) (decimal(base-10) numbe

Message ID Message Text Explanation¢When the Windows plug-and-play functionality deletes theSCSI device from Windows0x00000000 is displayed.¢When a pa

If the data is not sequential, these algorithms select the path to be usedeach time an I/O request is issued.¢Extended Round RobinThe paths are simply

Message ID Message Text Explanationff...ff: HLU number (same asPathName of view -path)(hexadecimal number)gg...gg: Dev number (same asDNum of view -pa

Message ID Message Text ExplanationNone.KAPL08026-E An error occurred on all thepaths of the LU. PathID =aa...aaDetailsAn error occurred in the last,r

Message ID Message Text ExplanationActionTo return a path to the Online(D)status, resolve the path failure,and then execute the "dlnkmgronline -d

Message ID Message Text ExplanationKAPL09005-E Could not stop the HDLMmanager. Stop it manually, andthen try the installation programor the remove pro

Message ID Message Text ExplanationActionRemove the HDLM that has beeninstalled on another OS on thesame drive, and then restart theinstallation progr

Message ID Message Text ExplanationContact your HDLM vendor orthe maintenance company ifthere is a maintenance contractof HDLM.During installation of

Message ID Message Text ExplanationKAPL09080-I The temporary license has beeninstalled. The license expires onaa...aa.Detailsaa...aa: Year (4 digits)/

Message ID Message Text ExplanationBecause the license informationcannot be acquired, a licenseneeds to be installed.ActionEnter a license key whenpro

Message ID Message Text Explanation\hdlm_license or the-file-that-the-user-specifiedActionIf a license key file exists, deleteit.KAPL09118-W The licen

Message ID Message Text ExplanationThe file version is bb...bb is notdisplayed.aa...aa: File name (mpio.sys,mpspfltr.sys, or mpdev.sys)bb...bb: Versio

Performing Failovers and Failbacks Using Path SwitchingWhen the system contains multiple paths to an LU and an error occurs on thepath that is current

Message ID Message Text ExplanationKAPL09134-E The HDLM path cannot be addedto the Path environmentvariable.Refer to the Messages section ofthe HDLM U

Message ID Message Text Explanation¢C:\Program Files(x86)\HDVM\HBaseAgent\bin¢C:\Program Files(x86)\HDVM\HBaseAgent\util\bin¢C:\Program Files(x86)\HIT

Message ID Message Text Explanationwhile updating a license for anupgrade or re-installation of HDLMKAPL09142-E HDLM aa...aa cannot beperformed. Wait

Message ID Message Text Explanationaa...aa: installation or removebb...bb: Version number of theinstalled or removed HDLMActionNone.KAPL09182-W An att

Message ID Message Text Explanation¢In removehdlm utility forremoving HDLM:None.KAPL09186-I The computer will now restart. Details¢In installhdlm util

Message ID Message Text Explanationinstallhdlm utility, see Theinstallhdlm Utility for InstallingHDLM on page 7-17. For detailson the removehdlm utili

Message ID Message Text Explanationproduct version is specified.(hdlmversion = aa...aa)The specified installation-information settings file is notsupp

Message ID Message Text ExplanationKAPL09196-W Some of the LUs managed byHDLM are not in a single pathconfiguration.DetailsBefore performing an upgrad

Message ID Message Text ExplanationActionNone.KAPL09212-E aa...aa ended abnormally. Detailsaa...aa: dlnkmgrActionCheck the error message that wasoutpu

Message ID Message Text ExplanationMake sure that there isenough unused capacity forthe folder specified by the -wparameter. If there is not,allocate

If the Thunder 9500V series, or Hitachi AMS/WMS series is being used, HDLMwill select the path to be used next from among the various paths that acces

Message ID Message Text ExplanationActionContact your HDLM vendor or themaintenance company if there is amaintenance contact of HDLM.KAPL09226-I An up

Message ID Message Text ExplanationAdd the search paths that werespecified during the installationof Windows, and then re-installHDLM.The search paths

Message ID Message Text ExplanationKAPL09259-I The HDLM aa...aa installationcheck has completedsuccessfully.DetailsThe HDLM installation check hascomp

Message ID Message Text Explanationaa...aa: Year (4 digits)/Month(01-12)/Day (01-31)ActionNone.KAPL09281-I HDLM 6.3.0 or later has beeninstalled. Only

Message ID Message Text ExplanationCheck whether HDLM has beencorrectly installed.KAPL09504-E The language environments ofHDLM and the Service Pack ar

KAPL10001 to KAPL11000Message ID Message Text ExplanationKAPL10002-W Too many parameters havebeen specified.DetailsFour or more parameters havebeen sp

Message ID Message Text Explanationutility for collecting HDLM errorinformation, without executing it.For details on the DLMgetrasutility, see The DLM

Message ID Message Text ExplanationKAPL10031-W The entered value is invalid.Continue operation ? [y/n]:DetailsA value other than y or n hasbeen entere

Message ID Message Text ExplanationKAPL10043-I Error information is beingcollected. (aa...aa%)Detailsaa...aa: What percentage of allthe information to

Message ID Message Text ExplanationContact your HDLM vendor or themaintenance company if there is amaintenance contract for HDLM.KAPL10080-I Data for

Automatic FailbacksWhen a path recovers from an error, HDLM can automatically place therecovered path back online. This function is called the automat

Message ID Message Text Explanationaa...aa: Specified parameter(character string)ActionExecute the dlmpr utility forclearing HDLM persistentreservatio

Message ID Message Text Explanationaa...aa: The path ID (decimal(base-10) number)ActionEnter y to execute clearing, or nto cancel.KAPL10657-I If you c

Message ID Message Text ExplanationTerminate unnecessaryapplications, and then retry. If theproblem persists, restart the host,and then retry. Alterna

Message ID Message Text Explanation- The cluster system service andthe driver are running.KAPL10668-E An attempt to open a devicefailed. DeviceName =

Message ID Message Text ExplanationNone.KAPL11902-I aa...aa has started. PathID =bb...bbDetailsThe operation has started on thehost.aa...aa: Operation

Message ID Message Text Explanationaa...aa: Operation (characterstring)¢Get Path Information¢Get Option Information¢Set Option Information¢Clear Data¢

Message ID Message Text Explanationfor Collecting HDLM ErrorInformation on page 7-2.KAPL11906-I GUI information - aa...aa DetailsThis information is r

Message ID Message Text Explanationan HDLM Persistent ReservationKey on page 7-13.KAPL12103-W The parameter value is invalid.(value = aa...aa)DetailsT

Message ID Message Text ExplanationKAPL12106-I An attempt to register the PRSVkey was successful. (PRSV key= aa...aa)Detailsaa...aa: Registered PRSV k

Message ID Message Text Explanationcontact your HDLM vendor or themaintenance company if there is amaintenance contract for HDLM.KAPL12112-E An error

Automatic Failovers... 2-17Automatic Failbacks...

You can manually place a path online or offline by doing the following:• Use the HDLM GUI Path Management window.• Execute the dlnkmgr command's

Message ID Message Text Explanation\HDLMdsm\Parameters\PRSVKeyString.ActionExecute the dlmprsvkey utility forregistering an HDLM persistentreservation

Message ID Message Text ExplanationActionNone.KAPL12119-E Trace data for maintenance:aa...aa bb...bb cc...cc dd...ddee...eeDetailsThis is the trace me

Message ID Message Text ExplanationThe Windows ManagementInstrumentation service might notbe working.This message might also beoutput when the WMI rep

Message ID Message Text ExplanationActionNone.KAPL12402-W iLU (aa...aa) is in a multi-pathconfiguration. PathID =bb...bb[,cc...cc]...DetailsThe LU for

Message ID Message Text Explanation¢Error code: 22Check whether HDLM hasbeen installed correctly.If it has, contact your HDLMvendor or the maintenance

Message ID Message Text ExplanationKAPL13604-W An error occurred duringprocessing to read the audit logconfiguration file.DetailsAn internal error occ

Message ID Message Text ExplanationKAPL13804-W Too many parameters havebeen specified.DetailsThree or more parameters havebeen specified.ActionCheck t

Message ID Message Text ExplanationActionMake sure that the installationinformation file does not meet anyof the above conditions.KAPL13809-E An inter

Message ID Message Text Explanationdisplayed. Command Line =aa...aaKAPL15035-W An attempt to display the statusthat indicates whether paths arein an i

Message ID Message Text ExplanationKAPL15109-I Information about HDLM-management targets wassuccessfully displayed.Command Line = aa...aaDetailsaa...a

The Online Path StatusesThe online path statuses are as follows:• OnlineI/Os can be issued normally.• Online(P)A state in which a path in the Online s

Message ID Message Text ExplanationKAPL15206-W aa...aa has failed. Detailsaa...aa: Refresh, Clear Data,Export CSV, Get OptionInformation, or Set Optio

ReturnCodeExplanationCheck whether a path between the host and the storage system isconnected. If a path is connected, check whether HDLM is configure

ReturnCodeExplanationExecute the DLMgetras utility for collecting HDLM error information,and then contact your HDLM vendor or the maintenance company

ReturnCodeExplanationRefresh the host information, check the path status, and thenperform the operation again.1027 DetailsThe error monitoring interva

ReturnCodeExplanationsee The DLMgetras Utility for Collecting HDLM Error Information onpage 7-2.1037 DetailsA parameter is invalid.ActionRefresh the h

ReturnCodeExplanation1046 DetailsA parameter is invalid.ActionRefresh the host information, and then perform the operation again.If the same error occ

Message ID Type Source Category Event ID UserKAPL04027-I Information DLMManager None 16411 N/AKAPL04028-E Error DLMManager None 16412 N/AKAPL04029-E E

AFunctional Differences BetweenVersions of HDLMThis section explains the functional differences between newer and olderversions of HDLM.□Functional Di

□Differences in Default Values□Differences in the Load Balancing Function in an MSCS EnvironmentA-2Functional Differences Between Versions of HDLMHita

Functional Differences Between Version 6.6 or Later andVersions Earlier Than 6.6• The type of the messages listed below that are output to the event l

The paths to the primary volume (P-VOL) in the HAM environment haverecovered from an error, but I/O to the P-VOL is suppressed.•Online(D)#The paths to

Functional Differences Between Version 5.9.4 or Later andVersions Earlier Than 5.9.4• The following operations have been changed to reduce the number

• An LU has been removed from being an HDLM management-targetAutomatic Switching of Paths That Have the Online(E), Offline(C), orOffline(E) StatusIn H

Differences in the LU Dynamic Removal FunctionDepending on the HDLM version, the LU dynamic removal function differs asfollows:• In HDLM 05-02, and 5.

Differences in the Drive Letters Displayed in WindowsDepending on the HDLM version, the Windows' drive letters that aredisplayed when all paths c

MSCS environment, even if you set the load balancing function to on, it willautomatically change to off.A-8Functional Differences Between Versions of

Acronyms and abbreviationsThe following acronyms and abbreviations might be used in this guide.AALArbitrated LoopAPIApplication Programming InterfaceA

CSVComma Separated ValueCUControl UnitDDBMSDatabase Management SystemDEPData Execution PreventionDevDeviceDNSDomain Name ServerFFCFibre ChannelFC-SPFi

GUIGraphical User InterfaceGUIDGlobally Unique IdentifierHHBAHost Bus AdapterHDevHost DeviceHLUHost Logical UnitHTTPHypertext Transfer ProtocolII/OInp

LULogical UnitLUNLogical Unit NumberMMPIOMultipath I/OMVSMultiple Virtual StorageNNICNetwork Interface CardNTPNetwork Time ProtocolOOSOperating System

RRADIUSRemote Authentication Dial in User ServiceSSANStorage Area NetworkSCSISmall Computer System InterfaceSLPRStorage Logical PartitionSMTPSimple Ma

Figure 2-11 Path Status TransitionsLegend:Online operation: Online operation performed in the Path Managementwindow or by executing the dlnkmgr comman

# 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 ZAcronyms-6Hitachi Dynamic Link Manager (for Windows®) User Guide

GlossaryThis glossary explains the terms used in this manual.Aautomatic failbackA function for checking the status of paths at regular intervals, and

clusterA system of connecting multiple hosts with the same OS or platform (essentially, anenvironment in which the same application can run) and treat

FC-SAN (Fibre Channel - Storage Area Network)A SAN using Fibre Channel.HHAM environmentAn environment in which volume pairs that are synchronized betw

host LU numberA number assigned to a host LU. The host LU number is part of a path name.(See also: host LU, path name)Iintermittent errorAn error that

Non-owner controllers exist only in the Thunder 9500V series, or Hitachi AMS/WMSseries.(See also: owner controller, non-owner path)non-owner pathA pat

path nameThe path name consisting of the following four elements, separated by periods:- Host port number (hexadecimal number)- Bus number (hexadecima

SLPR (Storage Logical Partition)A function supported by Hitachi USP series, Universal Storage Platform V/VM series,Virtual Storage Platform series, an

# 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 ZGlossary-8Hitachi Dynamic Link Manager (for Windows®) User Guide

IndexAactive host 2-47audit logcategories and audit events that HDLM canoutput 2-39collecting data 2-37data format 2-44automatic failback 2-19, 6-21,

When the following conditions are all satisfied, a path that has beendetermined to have an intermittent error also becomes subject toautomatic failbac

summary of path information 6-34Distributing a Load Using Load Balancing 2-11dlmchkpath 7-14DLMgetras 5-7, 5-8, 7-2dlmhostinfo 7-16dlmpr 7-10dlmprsvke

narrowing down 5-6HBA 2-4notes on HBA and HBA drivers 3-15HBA (Host Bus Adapter) Glossary-3HDev 2-8HDevName 5-3HDLMfeatures 1-2functions 2-1installin

log collection levelvalues 6-19logical unit 2-3, 2-5logical unit ID 6-58logsHDLM output to Windows event logs 8-117LU 2-4, 2-6, 4-16configuration 2-7L

PP 2-4, 2-6path 2-3, 2-5, Glossary-5checking the configuration 3-70deleting dynamically 6-77path errorhandling 5-4Path Health Checking 2-31path healt

using Windows administrative tool (Performance)checking path information 4-13utilitiesfor checking HDLM installation information 7-16for checking HDLM

Hitachi Dynamic Link Manager (for Windows®) User Guide

Hitachi Data SystemsCorporate Headquarters2845 Lafayette StreetSanta Clara, California 95050-2639U.S.A.www.hds.comRegional Contact InformationAmericas

Online operation: Online operation performed by executing the dlnkmgrcommand's online operation.Offline operation: Offline operation performed by

HDLM command or the HDLM GUI, and then make sure that the statushas changed to Offline(C). If it is still Offline(E), retry the offlineoperation.Monit

monitoring depend on the values specified for automatic failbacks. For detailson how to specify the settings, see set (Sets Up the Operating Environme

When an Intermittent Error Does Not OccurIf an error does not occur on a path a specified number of times within aspecified interval, an intermittent

since the error monitoring started are both reset to 0. As such, the errormonitoring will not finish, and it will start over by using the new conditio

Disk Requirements...3-13Number of LUs and Paths That Are Supported in HD

Table 2-6 When Effects of a User Changing the Intermittent ErrorInformationUser operationNumber oferrors and timepassed sinceerrormonitoringstartedInf

User operationNumber oferrors and timepassed sinceerrormonitoringstartedInformationabout pathsnot subject toautomaticfailbackRestarting the host Reset

For example, in a normal state, I/O operations are not performed on thepaths coming from the standby host in the cluster configuration or on non-owner

The dynamic I/O path control function can be enabled or disabled based oneach host, connected storage system, or LU.The dynamic I/O path control funct

Figure 2-16 Flow of Data When Collecting Error InformationLogs might be collected in layers below HDLM, such as for the SCSI driver.For more details,

A system memory dump file is a file to which the system memory data isoutput when a Windows system is down. Specify the following procedure tooutput t

For Windows Server 2003 (excluding the x86 edition) , Windows Server2008 (excluding the x86 edition), and Windows Server 2012 ProgramFiles is Program

¢Collects error information from the Warning level and higher.¢Collects error information from the Information level and higher(information from all t

Category Explanation• Startup and termination of software running on storagesystems, software running on SVPs (serviceprocessors), and Hitachi Command

Category ExplanationAnomalyEventAn event indicating an abnormal state such as exceeding athreshold, including:• Exceeding a network traffic threshold•

Notes on Removing HDLM...3-84Removing HDLM...

Category Explanation Audit eventSeverity#1Message IDStartup of theHDLM GUI wassuccessful.6 KAPL15201-IStartup of theHDLM GUI failed.4 KAPL15204-WTermi

Category Explanation Audit eventSeverity#1Message IDAn attempt todisplay programinformation wassuccessful.6 KAPL15107-IAn attempt todisplay programinf

Category Explanation Audit eventSeverity#1Message IDAn attempt toperform anoperation byusing the HDLMGUI failed.4 KAPL15206-WProcessing of thedlmprsvk

Requirements for Outputting Audit Log DataHDLM can output audit log data when all of the following conditions aresatisfied:• The Event Log service is

¢StartStop¢Authentication¢ConfigurationAccess¢All of the aboveFor details on how to specify audit log settings, see Setting Up the HDLMFunctions on pa

Item#ExplanationAudit event result Event resultSubject ID for auditevent resultDepending on the event, an account ID, process ID, or IPaddress is outp

For large-scale system configurations using many hosts running HDLM, theoperational load for managing paths on individual hosts increases with thesize

For details about the cluster software supported by HDLM, see Table 3-5Supported Cluster Software on page 3-8 in Cluster Software Supported byHDLM on

2-48HDLM FunctionsHitachi Dynamic Link Manager (for Windows®) User Guide

3Creating an HDLM EnvironmentThis chapter explains how to set up an HDLM environment and also how toerase environment settings.Make sure that you have

5 Troubleshooting...5-1Information Collected by the DLMgetras Utility

HDLM System RequirementsCheck the following before installing HDLM:For the requirements for using HDLM in an HAM environment, see the releasenotes of

OS Service packWindows Server 2012 (x64) No service packWindows Server 2012 R2(x64) No service packNote:In this manual, Windows running on a 32-bit pr

settings required for using HDLM, see the maintenance documentation forstorage systems.Table 3-3 Supported Storage systemsSupported storage systems#1I

Supported storage systems#1InterfaceOSWindowsServer2003,WindowsServer2003 R2WindowsServer2008,WindowsServer2008 R2WindowsServer2012,WindowsServer2012

#6Not supported for Windows Server 2003 (x64) or Windows Server 2003R2 (x64).#7Supported only for Windows Server 2008.#8Supported only for EVA6400 sto

For details, see Supported OSs on page 3-2 in OSs Supported by HDLMon page 3-2.#2Connection mainframe: MVSConnection storage system: Lightning 9900V S

Table 3-5 Supported Cluster SoftwareOS SPClustersoftwarenameThunder 9500Vseries,Lightning9900V series,Hitachi USPseries, HitachiAMS2000/AMS/WMS/SMSser

OS SPClustersoftwarenameThunder 9500Vseries,Lightning9900V series,Hitachi USPseries, HitachiAMS2000/AMS/WMS/SMSseries,UniversalStoragePlatform V/VMser

OS SPClustersoftwarenameThunder 9500Vseries,Lightning9900V series,Hitachi USPseries, HitachiAMS2000/AMS/WMS/SMSseries,UniversalStoragePlatform V/VMser

OS SPClustersoftwarenameThunder 9500Vseries,Lightning9900V series,Hitachi USPseries, HitachiAMS2000/AMS/WMS/SMSseries,UniversalStoragePlatform V/VMser

To Display Program Information... 6-33To Display HDLM Management-target Device Information..

--: Not usable#1For details about Oracle RAC versions, see the HDLM Release Notes.#2The following operating systems can manage the EMC DMX series, EMC

• Logical partitioning feature available on Hitachi Compute Blade bladeservers• Windows Server 2008 Hyper-V• Windows Server 2012 Hyper-VMemory and Dis

q = (t x n) / 1024 MB (rounded-up to the nearest integer)Number of LUs and Paths That Are Supported in HDLMThe following table lists the number of LUs

Migration of HDLM:Installing HDLM 5.5 or later after removing HDLM 5.4 or earlier is called amigration of HDLM. By doing this, you can keep the settin

Notes on HDLM Versions• If HDLM 5.4 or earlier has been installed, remove HDLM first and thenproceed with a new installation of HDLM by following the

• Before installing or upgrading HDLM 5.5 or later, make sure that no otherapplication is using an HDLM management-target LU.• When HDLM 5.5 or later

For Windows Server 2003 (excluding the x86 edition) , Windows Server2008 (excluding the x86 edition) , or Windows Server 2012:Windows-installation-dri

• If you install HDLM when either of the following conditions exists, an errormight be displayed for the mirror disk in the Disk Management window ofW

Problem What to dowhen the DLMgetras utility for collectingHDLM error information was executed.• When installing HDLM in Windows Server 2008 or Window

• HDLM uses the following MPIO drivers according to the host OS:¢In Windows Server 2003HDLM uses the MPIO driver on the HDLM DVD that is installed dur

8 Messages... 8-1Before Viewing the List of Messages...

d. Delete the setup information files from the following folder:Windows-installation-folder\infIf there are any files whose names are the same as the

is different for each type of storage system. Use the following table todetermine a value, and then change the current value to a value equalto or gre

Installation of HDLM on Windows Server 2008 and Windows Server 2012on page 3-52, the contents of the disk might become corrupted.Notethat you can upgr

For Windows Server 2003 (excluding the x86 edition) , WindowsServer 2008 (excluding the x86 edition) or Windows Server 2012,Program Files is Program F

Restore the disk number managed by Windows to the number that was inuse prior to the migration installation or upgrade installation. For detailsabout

Figure 3-2 Single Path Configuration and Multi-path Configuration2. Set up the storage system.Assign an LU to each port.To change the settings of a st

10. Restart the host.11. Confirm that the host is operating normally.Preparations for Installing HDLM by Performing an UnattendedInstallationAn unatte

2. Use a text editor to edit the sample file that was copied in step 1, in orderto create an installation-information settings file for your particula

The license key file will be deleted after the installation finishes.3. Perform the installation.¢If you are not performing an unattended installation

6. Specify the installation folder by following the instructions shown in themessages that appear in the window.The utility for registering HDLM persi