Hp Hitachi Dynamic Link Manager Software Manual do Utilizador

Hitachi Command SuiteDynamic Link Manager SoftwareUser Guide (for Windows(R))MK-92DLM129-21Document OrganizationProduct VersionGetting HelpContents

xHitachi Dynamic Link Manager User Guide (for Windows(R))

The program checks whether HDLM has already been installed. IfHDLM 5.4 or earlier has been installed, the KAPL09129-E message willappear. If this happ

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

¢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

Elog Level : 3Elog File Size (KB) : 9900Number Of Elog Files : 2Trace Level : 0Trace File Size

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

HDLM 5.5 or later has been installed, the KAPL09173-W message willappear. If this happens, carry out the procedure shown in UpgradeInstallation or Re-

10. If the KAPL09128-W message appears, you will need to re-enter thecorrect PRSV key.If a message does not appear, go to the next step.11. Select an

13. Check the results of the installation.If you have performed an unattended installation, check the installationresults from the command prompt.14.

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

In the displayed window, click the Install button next to forWindows of Hitachi Dynamic Link Manager Software.If no window is displayed, manually run

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

created with time information only, or if key creation fails, a dialog boxwill prompt you to enter the PRSV key.If this dialog box appears, go to step

15. Check the results of the installation.If you have performed an unattended installation, check the installationresults from the command prompt.16.

HDLM Driver Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssLicense Type ExpirationPermanent -KAPL01001-I The HDLM command compl

If no window is displayed, manually run the installer (setup.exe).The program checks whether HDLM has already been installed. IfHDLM 5.4 or earlier ha

10. Enter the PRSV key by following the instructions shown in the dialog box.The PRSV key is required for the HDLM functions to properly operate.Also,

15. After the installation finishes, execute the dlmprsvkey utility with the -vparameter specified.Execute the following command:HDLM-installation-fol

KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss22. Use the results of the dlnkmgr comman

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

fileThis command checks whether HDLM has already been installed. Ifthe KAPL09183-I message appears, a re-installation will beperformed.If you specifie

If you have performed an unattended installation, check the installationresults from the command prompt.9. After the installation finishes, execute th

Intended audienceThis manual is intended for system administrators who use Hitachi DynamicLink Manager (HDLM) to operate and manage storage systems. T

Make sure that the PRSV key displayed by the dlmprsvkey utility isunique among all the other hosts in the SAN. If the PRSV key is notunique or is not

24. Connect cables to all the HBAs to change the configuration to a multi-pathconfiguration.Figure 3-4 Single Path Configuration and Multi-path Config

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

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

20. Make sure that all the hosts in the cluster system have completely shutdown.21. Restart each host.22. Log on to Windows again as a member of the A

29. Shut down the host.30. Perform steps 21 to 29 on all the hosts that make up the cluster system.31. Restart each host.32. Install MSCS on each host

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

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

18. Perform steps 1 to 17 on all the hosts that make up the cluster system.19. Make sure that all the hosts that make up the cluster system havecomple

27. Connect cables to all the HBAs to change the configuration to a multi-pathconfiguration.28. Check the path information as described in Checking th

Chapter Descriptionconfigure an environment to properly operate HDLM,such as changing the HDLM management-target devicesthat connect paths or replacin

Note:If you want to install all HDLM components on a host on which the HDLMCore components have been installed, use an unattended installation.When yo

\HDLM-installation-folder\config\dlmmgr.xml\HDLM-installation-folder\config\dlmwebagent.properties 6. Delete the files copied in step 1.7. Restart the

HDLM-installation-folder\jre_userIf you use JRE 6.0_04, the folder configuration is as follows:HDLM-installation-folder\jre_user \jre1.6.0_04# \bin

2. Execute the firewall_setup command.3. Check the displayed message to make sure that the command wasexecuted successfully.The command ended successf

Checking the Path ConfigurationHDLM functions, such as load balancing and failover, are only available forHDLM management-target devices that have mor

operation or by using the Options window of the HDLM GUI. The followingsubsections describe how to set up HDLM functions by using the HDLMcommand’s se

Setting Up the HDLM FunctionsThe recommended and default values for each HDLM function is shown belowin Table 3-14 The Recommended and Default Values

these conditions are applied regardless of whether or not the load balancingfunction is enabled in those series. For example, in a cluster environment

Setting Up the Automatic Failback FunctionWhen intermittent error monitoring is enabled and the number of erroroccurrences is 2 or more, the following

When a value of 2 or more is specified for the number of times an errorneeds to occur, make sure that the condition shown in Setting Up theAutomatic F

These conventions are described below.General font conventionsThe following table lists the general font conventions:Font ConventionBold Bold type ind

Values in the setoperationDescriptionThe removed LU is restored after it is recovered from the physicalfailure and the disk is re-scanned.• Setting up

>dlnkmgr set -ellv 2Specify the error log collection level as a number.Setting the Trace LevelYou can set up the trace level for a trace file hdlmt

a value over 9901, 9900 will be used. For HDLM manager logs, the specifiedvalue will be applied as it is without being limited by the above.When an er

• Setting up the trace file size by using the set operationThe following is an example of setting up the trace file size by using acommand:>dlnkmgr

Value (severity) Explanation7Table 3-19 Values Indicating Audit Log Data Categories on page 3-78describes the values that indicate audit log data cate

KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss>After you have set up the collection

Setting Default valueRecommendedvalueBuffer size permonitoring interval64 (KB) 256 (KB)Number ofmessages to beoutput permonitoringintervalMonitoring c

Figure 3-5 Hitachi Network Objectplaza Trace Utility 2 Release 2.0Dialog Box.2. In Number of Files, change the number of integrated trace files.The de

The default is 0. You can specify a value from 0 to 500.If you specify 0, you cannot adjust the number of messages to be output.If you specify 0 for L

#To uninstall HDLM, you must reconfigure the system to a single-pathconfiguration. The time for doing this does not affect the timerequired for an uni

Example font orsymbolConventionSDBold code-font characters indicate the abbreviation for acommand.permUnderlined characters indicate the default value

Uninstalling HDLMAfter HDLM is uninstalled, sometimes the files below will not be deleted. Thefollowing files will be deleted when you restart the hos

Figure 3-6 Single Path Configuration and Multi-path ConfigurationIn Windows Server 2008, if you have selected an EMC CX series LU as theHDLM managemen

¢If a warning dialog box is not displayed, go to the next step.9. Follow the instructions shown in the messages that appear in the window.If the KAPL0

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

about the dlmchkpath utility, see The dlmchkpath Utility for CheckingHDLM Paths on page 7-13.¢If a warning dialog box is not displayed, go to the next

¢If a warning dialog box is not displayed, go to the next step.9. Follow the instructions shown in the messages that appear in the window.If the KAPL0

#2For Windows Server 2003 (excluding the x86 edition) or Windows Server2008 (excluding the x86 edition), Program Files is Program Files(x86).Notes:¢If

¢If HDLM is uninstalled in one of the following situations, the persistentreservation in the LU will remain:- When MSCS or VCS is running- When a cabl

3-92Creating an HDLM EnvironmentHitachi Dynamic Link Manager User Guide (for Windows(R))

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

Logical capacity unit Value1 TB1,024 GB or 1,0244 bytes1 PB1,024 TB or 1,0245 bytes1 EB1,024 PB or 1,0246 bytesGetting helpThe Hitachi Data Systems cu

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

• You can display and use the HDLM GUI windows for the Thunder 9500Vseries, Lightning 9900 series, Lightning 9900V series, Hitachi USP, HitachiAMS2000

HDLM Operations Using the HDLM GUIThis chapter explains the procedures for operating the HDLM GUI windowcomponents. For details on the components of e

• To specify a parameter value containing one or more spaces, enclose theentire value in double quotation marks (").• If the I/O load on the dyna

To place paths online by specifying an HBA port, CHA port, single path, orHBA port WWN, check the path name or PATH_ID used to manage thepath.The foll

operation with the -hba parameter specified. The following shows anexample of executing this command:>dlnkmgr offline -hba 1.1KAPL01055-I All the p

For details on the displayed items and their descriptions, see view (DisplaysInformation) on page 6-29.Initializing Statistical Information for PathsT

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

For example, to set up the error log collection level, execute the dlnkmgrcommand's set operation with the -ellv parameter specified. When thecon

environment is invalid. If this message appears, execute the dlnkmgr command's view operationwith the -sys -lic parameter to make sure that the l

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

To display HDLM component information, execute the dlnkmgr command'sview operation with the -sys parameter specified. The following shows anexamp

¢If an error occurs in the HDLM performance monitor, performanceinformation is not collected after the error. To restart the acquisitionof performance

Selectable items#Descriptionpathid disk-number drive-letter Selecting this item displays the instance of theselected path. The following items are dis

>dlnkmgr view -sys -msrvHDLM Manager Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssKAPL01001-I The HDLM command completed normal

Process Service Descriptionhntr2mon.exehntr2srv.exeHitachi NetworkObjectplaza TraceMonitor 2Hitachi Network Objectplaza TraceLibrary (HNTRLib2) proces

Figure 4-1 Using the command to confirm that an LU has been added onpage 4-17 shows an example of using the command to confirm that anLU has been adde

Checking an Added PathYou can add a path, by inserting a cable into an existing LU, even while thehost (on which HDLM is installed) is running.When yo

Deleting an LU DynamicallyThe LU deletion function automatically removes an LU from HDLMmanagement when all the paths to that particular LU are discon

Figure 4-3 An example of displaying the KAPL05301-E messageIn the event viewer, deleted path information is displayed in the followingformat: PathID P

Table 4-4 Items and Descriptions for the Path Information Displayed in theKAPL05301-E Message on page 4-21 shows the items and descriptions forthe pat

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

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

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

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

What To Do for a Program ErrorThe following describes what to do to handle errors that occur in an HDLMprogram. Figure 5-3 Troubleshooting Procedure W

If the error occurs again after you thought that you had resolved theproblem, use the dlnkmgr command's view operation to check the status ofthe

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

HDLM FeaturesHDLM features include the following:The ability to distribute a load across multiple paths. This is also known asload balancing.When a ho

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 executing HDLM commands in Windows Server 2008, seeUsing Windows Server 2008 on page 4-3.¢To specify a value that contains a space in its p

> To Display the Format of the clear Operation-helpDisplays the format of the clear operation.Example >dlnkmgr clear -helpclear: Format dlnk

>dlnkmgr helpdlnkmgr: Format dlnkmgr { clear | help | offline | online | set | view }KAPL01001-I The HDLM command completed normally. Operatio

offline (Places Paths Offline)The dlnkmgr command's offline operation places online paths offline.Specify the paths to be placed offline by speci

Specify the host port number and bus number of the target HBA port: thenumbers are found in the PathName field displayed using the viewoperation. Ente

when all the paths which pass the specified CHA port are placed in the Offline(C) status, enter y. Otherwise, enter n. [y/n]: yKAPL01061-I 2 path(s)

when the path is placed in the Offline(C) status, enter y. Otherwise, enter n. [y/n]: yKAPL01061-I 1 path(s) were successfully placed Offline(C); 0 pa

We recommend that you use the following command and verify theinformation on the target paths before you execute the offline operation toplace offline

|-hbaportwwn HBA-port-WWN [-tid target-ID -hlun host-LU-number]][-s]To Display the Format of the Online Operationdlnkmgr online -helpParametersTo Plac

© 2011 Hitachi, Ltd., Hitachi Data Systems Corporation. All rights reserved.No part of this publication may be reproduced or transmitted in any form o

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

Use this parameter to place online, at one time, all the paths that passthrough a specific channel adapter port. The command will place online allthe

For target-ID, specify the target ID portion of PathName. Leading zeroescan be omitted from the target ID (0000000000000001 and 1 are thesame value).

online: Format dlnkmgr online [-path] [-s] dlnkmgr online [-path] -hba HBAPortNumber.BusNumber [-s] dlnkmgr online [-path] -cha -pathid Auto

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

Item name Default value Recommended valueThe Extended Least I/Osalgorithm is used.The recommended algorithmdepends on the operatingenvironment.Error l

-lbtype {rr|exrr|lio|exlio|lbk|exlbk}Specify the algorithm to be used for load balancing.rr: The Round Robin algorithmexrr: The Extended Round Robin a

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

The higher the error log collection level value, the more log informationwill be output. As the amount of log information that is output increases,the

The explanation for the following sub-parameter describes how to specifythe checking interval.-intvl checking-intervalSpecify the checking interval be

The previously used intervalThe explanation for the following sub-parameter describes how to specifythe interval between path status checks.-intvl che

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

When you use automatic failback, we recommend that you setintermittent error monitoring to on to prevent an intermittent error fromreducing I/O perfor

while intermittent errors are not being monitored, the values will notchange.The monitoring interval specified in this parameter is stored eventhough

Table 6-5 Relationship Between the Setting for the Automatic FailbackFunction and Intermittent Error Monitoring and the Executable OperationsSettingAv

SettingAvailable operation Result of operationAFB IEMoffSet AFB to on. AFB is enabled.Set AFB to off. The operations of AFB and IEM do notchange.Legen

key file. For a temporary license key or emergency license key, theexpiration period is also displayed (KAPL01071-I, KAPL01072-I).Table 6-6 License Ke

The following sub-parameter can be used to specify how the LU dynamicdeletion function operates.-forceThe LU is removed from under HDLM-management whe

Value (severity) Explanation1234Error-level and Warning-level audit log data is collected.56Error-level, Warning-level, and Information-level audit lo

dlnkmgr set { -lb on [ -lbtype { rr | exrr | lio | exlio | lbk | exlbk } ] | -lb off | -ellv ElogLevel

FormatTo Display Program Informationdlnkmgr view -sys[-sfunc|-msrv|-adrv|-pdrv|-lic|-audlog][-t]To Display HDLM Management-target Device Informationdl

[-hdev host-device-name|-pathid AutoPATH_ID][-exlu][-t]To display LU information (by adding items to be displayed)dlnkmgr view -lu -item[ [slpr] [pn]

□Integrated HDLM management using Global Link Manager□Cluster Support2-2HDLM FunctionsHitachi Dynamic Link Manager User Guide (for Windows(R))

Use one of the sub-parameters (following -sys) to specify the programinformation that you want to display. If you do not specify a sub-parameter, the

Parameter andprograminformation tobe displayedItem Description• 2: Collects error information at the Warninglevel or higher.• 3: Collects error inform

Parameter andprograminformation tobe displayedItem DescriptionIntermittentError Monitor• Setting for intermittent error monitoring:on: Enabledoff: Dis

Parameter andprograminformation tobe displayedItem DescriptionExpirationLicense expiration:• When using a permanent license: -• When using a temporary

>dlnkmgr view -sys -sfuncHDLM Version : x.x.x-xxService Pack Version : Load Balance : on(extended li

>dlnkmgr view -sys -licLicense Type ExpirationPermanent -KAPL01001-I The HDLM command completed normally. Operation name = view, completion tim

Item Description• Windows Server 2003 (IPF) SP1 or later•Windows Server 2003 (x64)#1•Windows Server 2008#2If the OS is Windows Server 2008, this item

-hdev host-device-nameDisplays information only for the paths accessing the specified hostdevice.Specify a drive letter to indicate the desired host d

• When the only HDLM management-target devices are the Thunder9500V series, Lightning 9900 series, Lightning 9900V series,Hitachi USP, Hitachi AMS2000

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

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

Selectable items Sub-parametersiLU luChaPort cpStatus#NoneType typeIO-Count icIO-Errors ieDNum dnuHDevName hdIEP iep#Because both PathID and Status ar

Use this parameter to sort the path information in ascending order,according to the specified sorting key.The sorting keys are as follows: the first s

Parameters to display a summary of path information:-path -cIf the -c parameter is specified at the same time as the -path parameter,only PathID, DskN

ID element of the DskName field. When this parameter is omitted, thecommand displays the product ID or emulation type of the storagesystem instead.For

Displayed path informationTable 6-13 Displayed Path Information on page 6-46describes the displayedpath information. The following explains the table

Displayed ItemDescriptionNosummarydisplayedSummarydisplayed• Host LU number (hexadecimal number)For details about each element of the path name and it

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedstorage system. You can identify an actual LU byreferencing iLU from the storage system man

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedType#1Type• For the Thunder 9500V series, Lightning 9900 series,Lightning 9900V series, Hit

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedOne of the following values is displayed for each path:•-Indicates that intermittent error

Element Windows representationTarget ID (example: 0000000000000000,000000000000007A)Target IdHost LU number (example: 0001) Logical Unit ID or LUNThe

Figure 2-1 Configuration of an HDLM System When Using an FC-SAN on page2-4 shows the configuration of an HDLM system using an FC-SAN.Figure 2-1 Config

Model names ofstorage systemsProduct IDWithout the -stname parameterWith the -stnameparameter(Displays thefollowing for themodel ID)• Hitachi NSC55• H

Note that:¢For the Thunder 9500V series, Lightning 9900 series, Lightning 9900Vseries, Hitachi USP, Hitachi AMS2000/AMS/WMS/SMS series,Universal Stora

>dlnkmgr view -luProduct : 9500VSerialNumber : 0329 LUs : 2iLU HDevName PathID Status 0000 P 000006 Online

SerialNumber : -LUs : 4iLU HDevName PathID Status 6006048000018781000153594D423031 L 000000 Online

In the sub-parameters, -hdev or -pathid, you can filter the LUinformation to be displayed. If you omit both parameters, the commanddisplays the inform

Parameters to display a summary of LU information:-lu -cWhen the -c parameter is specified with the -lu parameter, a summaryof LU configuration inform

Hitachi USP, Hitachi AMS2000/AMS/WMS/SMS series, UniversalStorage Platform V/VM, or Virtual Storage Platform:16 digits are displayed for the iLU even

Table 6-17 Items That Can Be Added by Using the -lu -c -itemParameter and Sub-parametersItem that can be added Sub-parameterSLPR slprThe sub-parameter

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

Displayed itemDescriptionNosummarydisplayedSummarydisplayed9500V series, and Hitachi AMS2000/AMS/WMS/SMS series, the entire value of iLU is theinterna

must be installed ahead of time on the host. The cable port on the storagesystem is called a port (P) on a channel adapter (CHA) used for iSCSIconnect

Displayed itemDescriptionNosummarydisplayedSummarydisplayedFor details about each element of the path name andits representation in Windows, see Table

Displayed itemDescriptionNosummarydisplayedSummarydisplayeddetermined by referring to What To Do for a PathError on page 5-4Type#1- • For the Thunder

Displayed itemDescriptionNosummarydisplayedSummarydisplayed• -: Indicates that intermittent error monitoring isdisabled or the monitoring time for ani

Parameter Used When Displaying the Format of the view Operation-helpUse this parameter to display the view operation format.Example>dlnkmgr view -h

6-66Command ReferenceHitachi Dynamic Link Manager User Guide (for Windows(R))

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 date yyyy/mm/dd.

Folder that stores collectedfiles#1Files Explanationfolder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program

Figure 2-3 Configuration of an IP-SAN System When Using iSCSI Softwareand an NICTable 2-2 HDLM System Components When Using an IP-SAN on page 2-6lists

Folder that stores collectedfiles#1Files Explanationfolder-to-which-collected-information-is-output\Volume-Manager-installation-destination-drive-name

Folder that stores collectedfiles#1Files Explanationdlmmgr-lic.txtResult of the dlnkmgr view -sys -lic commanddlmmgr-lu.txtResult of the dlnkmgr view

Folder that stores collectedfiles#1Files Explanationiscsi-reg.txtiSCSI registry informationLocalhost_Cluster.log#4MSCS logmpio-list.txtMPIO informatio

#5The value N depends on the setting in the dlmwebagent.properties file.The default value is 2.#6M.N indicates the version of VxVM, or of Veritas Stor

Formatdlmpr {-c| -d| -h}Parameters-cDisplays a list of the paths for LUs managed by HDLM and persistentreservation information. When you specify the p

6. Execute dlmpr -c.From the displayed list, enter the path ID where KeyCount is not 0. Aconfirmation message is displayed twice. Check the message an

The persistent reservation is cleared. Repeat the procedure untilKeyCount for all the paths is changed to 0.6. Restart the VCS.7. Restart all the othe

KAPL12106-I An attempt to register the PRSV key was successful. (PRSV key = 0123456789abcdef)In the following example, the utility registers the PRSV

Formatdlmchkpath {-singleconnect | -h}Parameters-singleconnectChecks whether a single path configuration is being used to connect theHDLM management-t

name = view, completion time = yyyy/mm/dd hh:mm:ss -hDisplays the format of the dlmchkpath utility.If you do not specify any parameters, a warning mes

Components DescriptionPath A route that connects a host to a Dev in an LUSetting Range of the iSCSI Software and iSCSI HBAThe following describes the

No parametersDisplays installation information.Example:Without specifying the -output parameter:>dlmhostinfo"installDirectory","C:\P

For details about the procedure for performing an unattended installation, seePerforming a New Installation of HDLM on Windows Server 2003 on page3-28

Table 7-3 Keys That Can Be Defined in the [INSTALLATION_SETTINGS]Section on page 7-18lists and explains the keys that can be defined in the[INSTALLATI

Key name DescriptionNecessity ofdefinitionMaximumcharacterlength#1NewinstallationUpgradeinstallation orRe-installationy: Include them as managementtar

Key name DescriptionNecessity ofdefinitionMaximumcharacterlength#1NewinstallationUpgradeinstallation orRe-installationrestartSpecify whether to restar

components have already been installed. If you want to do this, firstuninstall HDLM, and then perform a new installation.¢If you want to install all t

Key name#1Description#2Necessity ofdefinitionMaximumcharacterlength#3NewinstallationUpgradeinstallation orRe-installationexlio: The Extended Least I/O

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

Key name#1Description#2Necessity ofdefinitionMaximumcharacterlength#3NewinstallationUpgradeinstallation orRe-installationon: Enable the LU dynamicremo

When on is specified for the auto_failback key in the installation-information settings file¢For an upgrade installation or re-installation:When on is

This means that each LU in the storage system is always recognized asonly one LU, regardless of the number of paths that are connected toSCSI devices.

• The installhdlm.log file is created in the folder specified by theworkdir key in the installation-information settings file.• If the installhdlm.log

¢After the uninstallhdlm utility has been executed and the hostrestarted, the utility is automatically deleted.¢After executing the uninstallhdlm util

7-28Utility ReferenceHitachi Dynamic Link Manager User Guide (for Windows(R))

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

□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 Explanationaa...aa: clear, set, offline, orviewActionExecute help operation-name ofthe HDLM command (dlnkmgr) tocheck the para

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

Message ID Message Text Explanationoperation, see view (DisplaysInformation) on page 6-29.KAPL01016-W The target CHA port was notfound. Operation name

Components DescriptionHDev A Dev in an LU that the host recognizes via the HDLMdriver. This type of Dev is called a host device.Program ConfigurationH

Message ID Message Text Explanationcheck the settings, and thenretry. For details on the viewoperation, see view (DisplaysInformation) on page 6-29.¢v

Message ID Message Text Explanationbb...bb: Parameters that cannotbe specified at the same timeActionExecute help operation of theHDLM command (dlnkmg

Message ID Message Text ExplanationA value other than y and n wasentered. Enter y or n.ActionEnter y or n.KAPL01041-E The entered value is invalid. Th

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

Message ID Message Text Explanationdetails on the online operation,see online (Places Paths Online)on page 6-10.KAPL01051-I Because no path has beense

Message ID Message Text ExplanationKAPL01054-W During the offline operationprocessing of the HDLMcommand, a path that cannot beplaced in the Offline(C

Message ID Message Text Explanationto the Online status. Is this OK?[y/n]:or -cha parameter has beenspecified. To continue processing,enter y. To canc

Message ID Message Text Explanationaa...aa: online, offline, set, orclearActionNone.KAPL01061-I aa...aa path(s) weresuccessfully placed bb...bb;cc...c

Message ID Message Text ExplanationKAPL01063-I The target path(s) are alreadyaa...aa.DetailsAs a result of a previous online/offline operation, the sp

Message ID Message Text Explanationbe used in the clusterenvironment.ActionMake sure that all HDLM-managedstorage systems supportpersistent reservatio

ContentsPreface...xiIntended audience...

Program name Functions• Set up the HDLM operating environmentHDLM command Provides the dlnkmgr command, which enables you to:• Manage paths• Display e

Message ID Message Text ExplanationActionRegister a permanent license.KAPL01074-E The emergency license expired. DetailsThe emergency license hasexpir

Message ID Message Text Explanationaa...aa: Windows-installation-destination-drive-name:\hdlm_licenseActionStore the license key file directlyunder th

Message ID Message Text ExplanationExecute help operation-name ofthe HDLM command (dlnkmgr) tocheck which parameter can bespecified, and then retry. F

Message ID Message Text ExplanationKAPL01097-W All the current trace files will bedeleted. Is this OK? [y/n]DetailsIf you set a value that is less tha

Message ID Message Text ExplanationKAPL01102-I All the paths which pass thespecified aa...aa port will bechanged to the Offline(C)status. Is this OK?

Message ID Message Text Explanationoperation is executed. Do youwant to execute the operationanyway? Operation name = set[y/n]:system, enter y. If you

Message ID Message Text Explanationusing the dlnkmgr set -audlogcommand.KAPL01117-W An error occurred duringprocessing to read the audit logconfigurat

KAPL02001 to KAPL03000Message ID Message Text ExplanationKAPL02001-I HDLM GUI has started normally.java.version = aa...aaDetailsaa...aa: VersionAction

Message ID Message Text ExplanationSet up a path between the hostand storage system, and thenrestart the host.KAPL02007-E The HDLM manager could not b

Message ID Message Text Explanation¢Refresh¢Clear DataActionNone.KAPL02014-W No data has been input inaa...aa.DetailsNothing has been entered into the

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 ExplanationThe entered value for the inputfield of the Option window is notwithin the valid range.aa...aa: Input item (charact

Message ID Message Text ExplanationIf you want to execute offlineprocessing, click OK. To canceloffline processing, click Cancel.KAPL02020-I If you ar

Message ID Message Text Explanationchanged to Offline(C) wasdetected. If you want to ignorethe path and continue, click OK.To cancel the operation, cl

Message ID Message Text Explanationcheck the path status, and thenretry.KAPL02028-W You lack write permission forthe aa...aa.DetailsYou do not have wr

Message ID Message Text Explanationvendor or the maintenancecompany if there is a maintenancecontract for HDLM. For details onthe DLMgetras utility, s

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

Message ID Message Text ExplanationClick Refresh to update thecontents of the view operation,check the path status, and thenretry.KAPL02044-W aa...aa

Message ID Message Text ExplanationFor the Path IDs of any failedpaths, see the operation log. ClickRefresh to view any paths thatwere registered toge

Message ID Message Text Explanationreconfigured, click the Refreshbutton.KAPL02063-W The version number cannot bedisplayed.DetailsThe version number c

Message ID Message Text Explanationcontact your HDLM vendor ormaintenance company if there is amaintenance contract for HDLM.KAPL02077-W An attempt to

VM, and Virtual Storage Platform. In a non-cluster environment, the loadbalancing function is available for the Thunder 9500V series, Lightning 9900se

Message ID Message Text ExplanationHDLM error information, and thencontact your HDLM vendor ormaintenance company if there is amaintenance contract fo

Message ID Message Text ExplanationActionRefer to the contents of thewarning.KAPL03003-E HDLM API Error information -aa...aaDetailsThis information is

Message ID Message Text ExplanationHDLM Error Information on page7-2.KAPL03007-E An error occurred duringcommunication with the HDLMmanager. (aa...aa)

KAPL04001 to KAPL05000Message ID Message Text ExplanationKAPL04001-I HDLM manager started. ActionNone.KAPL04002-E Could not start the HDLMmanager.Deta

Message ID Message Text ExplanationKAPL04006-E Cannot register the servicecontrol handler function. Returnvalue = aa...aaDetailsHDLM manager could not

Message ID Message Text ExplanationIf the same error occurs, re-installHDLM. For details on the viewoperation, see view (DisplaysInformation) on page

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

Message ID Message Text ExplanationNone.KAPL04022-W HDLM manager warninginformation - aa...aaDetailsThis information is required forresolving problems

Message ID Message Text ExplanationKAPL04025-C A memory shortage occurred inthe HDLM manager.DetailsThere was not enough memory torun the HDLM manager

Message ID Message Text Explanationremaining values, the defaultvalues will be used.ActionFor any non-default options, usethe dlnkmgr set operation to

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 Explanationbb...bb, Port Number= cc...cc,Community = dd...dd, TrapData = ee..eebb...bb: Destination IP address ofthe trapcc...

Message ID Message Text Explanationcomponent) was initializedsuccessfully.The HDLM driver (filtercomponent) was successfullyinitialized for each devic

Message ID Message Text Explanation(base-10) number)), partition(cc...cc: Partition sequencenumber (decimal (base-10)number)), and device objectaddres

Message ID Message Text Explanationbb...bb: Disk sequence number(decimal (base-10) number)cc...cc: Degree of progress in diskrecognition processing(he

Message ID Message Text ExplanationKAPL05819-I Data for maintenance: aa...aabb...bb cc...cc dd...dd.DetailsThe filter driver outputs thismessage for m

Message ID Message Text Explanationfor HDLM, your maintenancecompany, to confirm whether yourstorage systems supportpersistent reservations.KAPL07821-

KAPL08001 to KAPL09000Message ID Message Text ExplanationKAPL08019-E The path (aa...aa) detected anerror (bb...bb). (cc...cc)DetailsAn error occurred

Message ID Message Text Explanationcc...cc: Host port number (sameas PathName of view -path)(hexadecimal number)dd...dd: Bus number (same asPathName o

Message ID Message Text ExplanationThe auto recover functionrecovered a path.This message is output if an erroroccurs in all the paths to an LUand one

KAPL09001 to KAPL10000Message ID Message Text ExplanationKAPL09001-E There is no system managementpermission. Login withadministrator permission andaa

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 ExplanationKAPL09006-E Could not install HDLM. ActionIf the installation was interrupted,incomplete files and folders mightrem

Message ID Message Text ExplanationObjectplaza Trace Library 2failed. Uninstall Hitachi NetworkObjectplaza Trace Library 2 byreferring to HDLM User&ap

Message ID Message Text ExplanationContact your HDLM vendor or themaintenance company if there is amaintenance contact of HDLM.KAPL09071-E The specifi

Message ID Message Text ExplanationInstall a permanent license.KAPL09084-W The temporary license cannot beinstalled.DetailsThe temporary license canno

Message ID Message Text ExplanationContact your HDLM vendor or themaintenance company if there is amaintenance contract of HDLM.KAPL09093-I aa...aa wi

Message ID Message Text ExplanationKAPL09119-W There is no installable licensekey in the license key file. Filename = aa...aaDetailsThere is no HDLM-i

Message ID Message Text ExplanationAn invalid PRSV key has beenentered.ActionEnter a valid PRSV key.KAPL09129-E The version upgrade fromaa...aa to bb.

Message ID Message Text Explanationservice pack), if the Pathenvironment variable was roundeddown to 1,024 bytes, but theMicrosoft patch program to so

Message ID Message Text Explanation\Hitachi For Windows Server 2003(excluding the x86 edition) orWindows Server 2008 (excludingthe x86 edition), Progr

Message ID Message Text ExplanationKAPL09173-W HDLM version aa...aa isinstalled. Do you want tooverwrite it with versionbb...bb?Detailsaa...aa: Instal

• The Extended Round Robin algorithm• The Least I/Os algorithm• The Extended Least I/Os algorithm• The Least Blocks algorithm• The Extended Least Bloc

Message ID Message Text ExplanationKAPL09183-I HDLM version aa...aa isinstalled. This version will nowbe overwritten with versionbb...bb.Detailsaa...a

Message ID Message Text ExplanationAction¢In installhdlm utility forinstalling HDLM:After the computer restarts,make sure that HDLM isrunning correctl

Message ID Message Text Explanationaa...aa: Invalid parameter(character string)ActionMake sure that the parameters forthe installhdlm oruninstallhdlm

Message ID Message Text ExplanationKAPL09193-W A definition in the installationinformation settings file isinvalid. (aa...aa = bb...bb)DetailsAn inval

Message ID Message Text Explanationpressing Ctrl + C. Theinstallhdlm.exe oruninstallhdlm.exe processinghas ended, but the HDLMinstallation or uninstal

Message ID Message Text ExplanationKAPL09213-W An error occurred during aa...aaprocessing.DetailsAlthough the aa...aa processinghas ended, an error oc

Message ID Message Text ExplanationUninstalling HDLM on page3-82.KAPL09222-E HDLM could not be uninstalled. DetailsHDLM could not be uninstalled.Actio

Message ID Message Text Explanationwill be installed, withoutoverwriting the MPIO driver.MPIO driver bundled with HDLMwill not be installed.aa...aa: V

Message ID Message Text ExplanationAdd all of the search paths thatwere specified during theinstallation of Windows into thePath system environmentvar

Message ID Message Text ExplanationActionNone.KAPL09260-W Errors were detected during theHDLM aa...aa installation check.See the previous messages tor

Table 2-5 Features of the Load Balancing AlgorithmsAlgorithm type Algorithm features•Round Robin#• Least I/Os• Least BlocksThese types of algorithms a

Message ID Message Text ExplanationKAPL09281-I HDLM 6.3.0 or later has beeninstalled. Only the HDLM driverwill be installed, withoutoverwriting the MP

Message ID Message Text ExplanationThe Japanese SP was applied tothe English edition of HDLM, orvice versa.ActionAcquire the SP that has the samelangu

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 Explanationaa...aa: Collected file namebb...bb: Year/month/dayhour:minute:secondActionNone.KAPL10022-I The utility for collect

Message ID Message Text Explanationaa...aa: Information collection fileActionNone.KAPL10034-E The file could not be copied.Filename = aa...aa, Details

Message ID Message Text ExplanationMake sure that the parameters forthe DLMgetras utility for collectingHDLM error information areappropriate, and the

Message ID Message Text Explanationee...ee: The command that couldnot be executed and the registrykey that could not be obtained.ActionNoneKAPL10640-I

Message ID Message Text ExplanationHDLM Persistent Reservations onpage 7-9.KAPL10651-I The user terminated theoperation.ActionNone.KAPL10652-E The ent

Message ID Message Text ExplanationKAPL10659-I There is no LU for whichpersistent reservationinformation exists.ActionNone.KAPL10660-I There is no LU

means that the path cannot receive I/Os. A path will go into the offline statusfor the following reasons:• An error occurred on the path.• A user inte

Message ID Message Text Explanationaa...aa: Port number(hexadecimal number)bb...bb: Error code (hexadecimalnumber)ActionContact your HDLM vendor or th

KAPL11001 to KAPL12000Message ID Message Text ExplanationKAPL11901-I aa...aa has started. DetailsThe operation has started on thehost.aa...aa : Operat

Message ID Message Text Explanation¢Get HDLM Alert DriverStatus¢Online¢Offline¢Get SNMP Trap Information¢Set SNMP Trap Information¢Set LU Load Balance

Message ID Message Text ExplanationAn exception occurred duringprocessing on the host.ActionExecute the DLMgetras utility forcollecting HDLM error inf

Message ID Message Text Explanationan HDLM Persistent ReservationKey on page 7-12.KAPL12102-W There are too many parameters ActionMake sure that the p

Message ID Message Text ExplanationActionTry again as a user who is amember of the Administratorsgroup. For details on thedlmprsvkey utility, see Thed

Message ID Message Text ExplanationKAPL12111-E The registry key for theregistration destination does notexist.DetailsThe registry keyHKEY_LOCAL_MACHIN

Message ID Message Text Explanationcompany if there is a maintenancecontract for HDLM. For details onthe dlmprsvkey utility, see Thedlmprsvkey Utility

Message ID Message Text Explanationerror occurs before the PRSV keycan be acquired.aa...aa: Maintenance information1 (hexadecimal number)bb...bb: Main

Message ID Message Text Explanationvendor or the maintenancecompany if there is a maintenancecontract for HDLM.If the WMI repository is corrupted,cons

is placed offline, the switching destination can come from any of the otherthree paths (B, C, or D).Figure 2-10 Path SwitchingAutomatic FailbacksWhen

Message ID Message Text Explanationvendor or the maintenancecompany if there is a maintenancecontract for HDLM.If the WMI repository is corrupted,cons

Message ID Message Text ExplanationTerminate unnecessaryapplications to increase theamount of free memory.Alternatively, restart the host.KAPL12406-E

Message ID Message Text ExplanationKAPL13603-W The audit log configuration file isinvalid. Execute the "dlnkmgrview -sys -audlog" commandand

Message ID Message Text ExplanationKAPL13803-W The user does not have theprivileges required to executethe dlmhostinfo utility forconfirming HDLM inst

Message ID Message Text Explanation¢The installation informationfile already exists.¢A folder with the same nameas the installation informationfile ex

Message ID Message Text ExplanationKAPL15032-I An HDLM persistent reservationkey was successfully displayed.Command Line = aa...aaDetailsaa...aa: Name

Message ID Message Text ExplanationKAPL15105-I Setting up the operatingenvironment succeeded.Command Line = aa...aaDetailsaa...aa: Command that the us

Message ID Message Text Explanationcc...cc path(s) could not beplaced bb...bb.aa...aa: Number of paths thatwere successfully placed online orofflinebb

Message ID ExplanationTerminate unnecessary applications to increase free memory, orrestart the host.1006 DetailsAn Offline path cannot be placed Onli

Message ID ExplanationActionExecute the DLMgetras utility for collecting HDLM error information,and then contact your HDLM vendor or the maintenance c

HDLM automatically places the recovered path online, the path that iscurrently being used will continue to be used (as opposed to switching over tothe

Message ID ExplanationSet the intermittent error-monitoring interval to a value that is equalto or greater than (automatic-failback-checking-interval

Message ID Explanationvendor or maintenance company if you have a maintenance contractfor HDLM. For details on the DLMgetras utility, see The DLMgetra

Events Output to Windows Event Logs by HDLMThe following table lists Table 8-3 Events Output to the Windows ApplicationLog on page 8-110 and Table 8-4

Message ID Type Source Category Event ID UserKAPL05011-E Error DLMManager None 20491 N/AKAPL07820-E Error DLMManager None 29492 N/AKAPL08019-E Error D

8-112MessagesHitachi Dynamic Link Manager User Guide (for Windows(R))

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

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

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

6-10. After a path status is changed to online, the path can be selected as auseable path by HDLM in the same manner as automatic path switching.When

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

LDEVLogical DeviceLULogical UnitLUNLogical Unit NumberMMPIOMultipath I/OMVSMultiple Virtual StorageNNICNetwork Interface CardNTPNetwork Time ProtocolO

QQFEQuick Fix EngineeringRRADIUSRemote Authentication Dial in User ServiceSSANStorage Area NetworkSCSISmall Computer System InterfaceSLPRStorage Logic

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

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

The (E) means error, which indicates that an error has occurred on thepath from some previous operation.• Online(EP)The status of an Offline(P) path c

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.HHBA (Host Bus Adapter)A device that is an interface between hosts and external

Iintermittent errorAn error that occurs irregularly due to, for example, a loose cable connection.IP-SAN (Internet Protocol - Storage Area Network)A d

non-owner pathA path that passes through a non-owner controller.Non-owner paths exist only in the Thunder 9500V series, or Hitachi AMS/WMS series.(See

A path name is used to identify a path.(See also: host LU number)persistent reservationSimilar to reservations, persistent reservations enable a serve

IndexAactive host 2-44audit logcategories and audit events that HDLM canoutput 2-37collecting data 2-35data format 2-42automatic failback 2-18, 6-20,

dlmhostinfo 7-15dlmpr 7-9dlmprsvkey 7-12dlnkmgr 6-1DNum 5-3driver levelHDLM and MPIO drivers 2-10dynamic reconfiguration Glossary-2EEMC CX seriesclust

features 1-3functions 2-1installing 3-24new installation (on Windows Server 2003) 3-28new installation (on Windows Server 2008) 3-51notes on versio

LU configuration recognized by the host 2-8LUN 6-51Mmanual path switching 2-19messageexamining 5-7message elementDNum 5-3ErrorCode 5-3PathID 5-3PathNa

path switchingautomatically 2-17manually 2-19PathID 5-3PathName 5-3paths to which load balancing is applied 2-13Performance 4-12Performance Monitor 4-

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

VVCS 3-7, 3-8, 3-9, 3-86vendor ID 6-47view 6-29viewingGUI Help 4-4WWarning 2-34what is HDLM? 1-2what to do forprogram error 5-7Windowsnotes on 3-16I

Hitachi Dynamic Link Manager User Guide (for Windows(R))

Hitachi Data SystemsCorporate Headquarters750 Central ExpresswaySanta Clara, California 95050-2627U.S.A.Phone: 1 408 970 [email protected]

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

hardware is then re-installed, HDLM will automatically place the path backonline. However, this is the case only when there is no other cause orreason

Setting Up Intermittent Error MonitoringWhen you enable the intermittent error monitoring function, specify thefollowing monitoring conditions: the er

Figure 2-12 Action What Will Happen When an Intermittent Error Occurson a PathWhen an Intermittent Error Does Not OccurIf an error does not occur on a

As shown in Figure 2-13 What Will Happen When an Intermittent Error DoesNot Occur on a Path on page 2-26, normally, the count for the number oftimes t

When a User Changes the Intermittent Error InformationThe following might be reset when a user changes any of the values set forthe intermittent error

User operationNumber oferrors and timepassed sinceerrormonitoringstartedInformationabout pathsnot subject toautomaticfailbackChanging the pathstatusTa

HDLM Installation Types...3-13Notes on Creating an HDLM Environme

The number of errors and the time passed since error monitoring hadstarted are both reset to 0, and then monitoring restarts from the timethe HDLM man

Deleting an LU DynamicallyThe dynamic LU deletion function automatically removes an LU from underHDLM control when all the paths to that LU have been

Figure 2-15 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

#1For Windows Server 2003 (excluding the x86 edition) and WindowsServer 2008 (excluding the x86 edition), Program Files is ProgramFiles (x86).#2The un

¢Collects error information from the Error level and higher.¢Collects error information from the Warning level and higher.¢Collects error information

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•

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

Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib2)...3-89Clearing the Persistent Reservation...

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

However, audit log data might still be output regardless of the aboveconditions if, for example, an HDLM utility is executed from external media.##:Th

Audit Log Data FormatsThe following describes the format of audit log data:The following is the format of audit log data. This data can be viewed in t

Item#ExplanationLocation identificationinformationLocation identification informationFQDN Fully qualified domain nameRedundancyidentificationinformati

Global Link Manager collects and manages information about paths frominstances of HDLM installed on multiple hosts. Even if multiple users managethese

For example, in Figure 2-17 Path Switching in a Cluster Configuration on page2-45, when HDLM uses a path (A) from the active host to access a devicewi

2-46HDLM FunctionsHitachi Dynamic Link Manager User Guide (for Windows(R))

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

HDLM System RequirementsCheck the following before installing HDLM:OSs Supported by HDLMThis subsection describes the OSs, Microsoft MPIO drivers, and

In this manual, Windows running on a 32-bit processor is referred to asx86.#To use the Storport Miniport driver for the HBA driver in an environmentwh

Examining the Messages...5-5Obtaining Path Information...

Table 3-3 Supported Storage systemsSupported storagesystems#1InterfaceOSWindows Server 2003 Windows Server 2008x86 IPF x64 x86 IPF x64EMC DMX series#2

Legend:Y: Usable--: Not usableFC I/F: FC InterfaceiSCSI I/F: iSCSI Interface#1Dual controller configuration is required.#2The evaluation of EMC DMX300

Table 3-4 Related Programs When Intermediate Volumes Managed byHitachi RapidXchange Are Used to Exchange DataOS Related programsWindows Server 2003 R2

Table 3-5 Supported Cluster SoftwareOS SPClustersoftwarenameThunder 9500Vseries,Lightning 9900series,Lightning9900V series,Hitachi USP,HitachiAMS2000/

OS SPClustersoftwarenameThunder 9500Vseries,Lightning 9900series,Lightning9900V series,Hitachi USP,HitachiAMS2000/AMS/WMS/SMS series,UniversalStorageP

OS SPClustersoftwarenameThunder 9500Vseries,Lightning 9900series,Lightning9900V series,Hitachi USP,HitachiAMS2000/AMS/WMS/SMS series,UniversalStorageP

OS SPClustersoftwarenameThunder 9500Vseries,Lightning 9900series,Lightning9900V series,Hitachi USP,HitachiAMS2000/AMS/WMS/SMS series,UniversalStorageP

- Windows Server 2003 (x64)Notes:¢When you use HDLM in a cluster configuration, you must install thesame version of HDLM on all the nodes that make up

Memory and Disk Capacity RequirementsThis section describes memory and disk capacity requirements.Memory RequirementsTable 3-7 Memory Requirements for

Number of Paths Supported in HDLMTable 3-9 Number of LUs and Paths Supported in HDLM on page 3-13 liststhe number of LUs, the number of paths for an i

To Display the Format of the view Operation...6-31Parameters...

Installing HDLM 5.5 or later after uninstalling HDLM 5.4 or earlier is calleda migration of HDLM. By doing this, you can keep the settings from thepre

described in Migrating from HDLM 5.4 or Earlier to HDLM 5.5 or Later onpage 3-64.• For HDLM 5.6 or later, the trace files for HDLM versions earlier th

• When you use HDLM in a cluster configuration, you must install the sameversion of HDLM on all the nodes that make up the cluster. If differentversio

Windows-installation-drive:\Program Files (x86)\HDVM\HBaseAgent\util\binHDLM-installation-folder\binHDLM-installation-folder\libFor other versions of

¢An application that uses the dmaadmin service is being executed.This error does not affect the data on the HDLM management-targetdevices. If you rest

¢If the disk is not used as a cluster resource:In the Windows' Disk Management windows, offline the disk.¢If the disk is used as a cluster resour

• If you attempt to install HDLM on a Windows Server 2003 host on whichan MPIO driver has already been installed, and the MPIO driver versiondiffers f

¢If you are installing HDLM on Windows Server 2008, do not delete themulti-path I/O feature from the Server Manager.• When a host is connected to an O

Storage system typeNumberof pathsconnected to thevotingdiskFormula for obtaining the valueof DISKTIMEOUT• Hitachi USP• Universal StoragePlatform V/VM•

specified in the license key file or the input license key type. Forinformation on license key types and the set operation, see set (Sets Upthe Operat

KAPL09001 to KAPL10000...8-57KAPL10001 to KAPL11000...

unattended installation, see The installhdlm Utility for Installing HDLM onpage 7-16.• After all HDLM components have been installed on a host, if you

When you install HDLM, Hitachi Network Objectplaza Trace Library will also beinstalled. The file path of the Hitachi Network Objectplaza Trace Library

3. Install the HBAs onto the host.Install as many HBAs as you want to use.In a cluster configuration, make sure that the manufacturer and model ofthe

This section describes the following aspects of an unattended installation:• How to create an installation-information settings file• Notes on install

A folder specified in the workdir key (if the workdir key has not beenspecified, a folder specified in the TMP or TEMP environment variable)must have

drive-to-which-the-installation-DVD-is-inserted:\HDLM_Windows\DLMTools\installhdlm -f installation-information-settings-fileThis command checks whethe

¢Windows Server 2003 (x64)##This OS cannot be used with the EMC DMX series.The Hitachi storage systems and HP StorageWorks XP Series optionis always s

Make sure that the PRSV key displayed by the dlmprsvkey utility isunique among all the other hosts in the SAN. If the PRSV key is notunique or is not

Support Cluster : offElog Level : 3Elog File Size (KB) : 9900Number Of Elog Files : 2Trace Level

Figure 3-3 Single Path Configuration and Multi-path Configuration23. Check the path information as described in Checking the PathConfiguration on page