Hp Hitachi Dynamic Link Manager Software Manuel d'utilisateur

Hitachi Dynamic Link Manager Software User's Guide (for Windows(R))3020-3-P35-50(E)

viA generic term for:• Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition• Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition• Micro

3. Creating an HDLM Environment763.2 Flow for Creating an HDLM EnvironmentSet up the environment to use HDLM as follows.Figure 3-1: Flow of HDLM Envir

3. Creating an HDLM Environment773.3 HDLM Installation TypesThis section describes the following types of HDLM installations: new installation, upgrad

3. Creating an HDLM Environment783.4 Notes on Creating an HDLM EnvironmentThis section provides notes on creating an HDLM environment.For details abou

3. Creating an HDLM Environment79Files#\HITACHI\HNTRLib2\spool\hntr2n.log (n indicates a file number)- Trace files after migration: drive-for-program-

3. Creating an HDLM Environment80and Service Pack Version, which are displayed by executing the following command, are the same, then the versions of

3. Creating an HDLM Environment81Windows-installation-drive:\Program Files (x86)\HDVM\HBaseAgent\binWindows-installation-drive:\Program Files (x86)\HD

3. Creating an HDLM Environment82Be aware that even though an upgrade or re-installation of HDLM failed, the Add/Remove Programs window might indicate

3. Creating an HDLM Environment83Specifying a Folder That Does Not Satisfy the Conditions for an HDLM Installation might occur. If this happens, reins

3. Creating an HDLM Environment84If you are using Hyper-V in Windows Server 2008 and an HDLM management-target device has been allocated as a physica

3. Creating an HDLM Environment85following procedure to delete the two oemn.inf files and two oemn.pnf files:1. Check the MPIO driver version indicate

viiA generic term for:• Microsoft(R) Windows Server(R) 2003, Standard Edition• Microsoft(R) Windows Server(R) 2003, Web Edition• Microsoft(R) Windows

3. Creating an HDLM Environment86following table to determine a value, and then change the current value to a value equal to or greater than the value

3. Creating an HDLM Environment87Therefore, make a note of the original values of MISSCOUNT and DISKTIMEOUT before changing them. If you install HDLM

3. Creating an HDLM Environment88on the same drive.• When an HDLM version from another OS has been installed:Uninstall the version of HDLM that is alr

3. Creating an HDLM Environment89In Windows Server 2003 SP1 or later, if you change an HDLM management-target device during an upgrade installation a

3. Creating an HDLM Environment903.5 Installing HDLMFirst, check whether HDLM has been installed on the host.When HDLM has already been installed on

3. Creating an HDLM Environment91Figure 3-2: Single Path Configuration and Multi-path Configuration2. Set up the storage system.Assign an LU to each p

3. Creating an HDLM Environment92See the HBA documentation and manual to complete the required setup.8. If your configuration uses an IP-SAN, install

3. Creating an HDLM Environment93(1) How to Create an Installation-Information Settings FileFor an installation-information settings file, you need to

3. Creating an HDLM Environment943.5.3 Performing a New Installation of HDLM on Windows Server 2003(1) In a Non-Cluster EnvironmentBefore installing H

3. Creating an HDLM Environment95If you have specified n for the restart key in the installation-information settings file, go to step 11.If you have

viiiA generic term for:• Microsoft(R) Windows Server(R) 2003 R2, Datacenter Edition• Microsoft(R) Windows Server(R) 2003 R2, Datacenter x64 Edition• M

3. Creating an HDLM Environment96#This OS cannot be used with the EMC DMX series.The Hitachi storage subsystems and HP StorageWorks XP Series option i

3. Creating an HDLM Environment9712. After the installation finishes, execute the dlmprsvkey utility with the -v parameter specified.Execute the follo

3. Creating an HDLM Environment98after the installation finishes. The KAPL09115-W message will appear if deletion of this file fails. If this happens,

3. Creating an HDLM Environment99configuration.22. Connect cables to all the HBAs to change the configuration to a multi-path configuration.Figure 3-3

3. Creating an HDLM Environment100key during the installation of HDLM. installation-drive:\hdlm_license The license key file will be deleted after the

3. Creating an HDLM Environment1018. follow the procedure below:• The KAPL09127-W message will appear if the MPIO driver has already been installed an

3. Creating an HDLM Environment102always selected. To select an EMC DMX series or EMC CX series LU as the HDLM management-target device, select EMC Sy

3. Creating an HDLM Environment103HDLM-installation-folder\bin\dlmprsvkey -vMake sure that the PRSV key displayed by the dlmprsvkey utility is unique

3. Creating an HDLM Environment104HDLM Alert Driver Ver WakeupTime ElogMem SizeAlive x.x.x-xx yyyy/mm/dd hh:mm:ss 128HDLM Dr

3. Creating an HDLM Environment105HDLM Version : x.x.x-xxService Pack Version : Load Balance : on(extended lio

ixThis manual also uses the following abbreviations.A generic term for:• Microsoft(R) Windows Server(R) 2008 Datacenter• Microsoft(R) Windows Server(R

3. Creating an HDLM Environment106The program checks whether HDLM has already been installed. If HDLM 5.4 or earlier has been installed, the KAPL09129

3. Creating an HDLM Environment107with time information only, or if key creation fails, a dialog box will prompt you to enter the PRSV key.If this dia

3. Creating an HDLM Environment108• The PRSV key will be registered before the installation finishes. If the KAPL09131-W message appears, follow the p

3. Creating an HDLM Environment10918. Modify the storage system settings.Modify the storage system settings by following the procedure described in th

3. Creating an HDLM Environment110If HDLM Manager, HDLM Alert Driver, and HDLM Driver are all Alive, all the programs are running correctly.24. After

3. Creating an HDLM Environment111HDLM. If no message appears, go to step 8.• If you are planning to perform an unattended installation, execute the i

3. Creating an HDLM Environment112value of the PRSV key must be unique for each host.12. If the KAPL09128-W message appears, you will need to re-enter

3. Creating an HDLM Environment113Global Link Manager.15. Check the results of the installation.If you have performed an unattended installation, chec

3. Creating an HDLM Environment114Number Of Elog Files : 2Trace Level : 0Trace File Size(KB) : 1000Number Of Trace F

3. Creating an HDLM Environment115down.3. Restart each host.Start them in a single-path configuration.4. Log on to Windows as a member of the Administ

xCPU Central Processing UnitCSV Comma Separated ValueCU Control UnitDBMS Database Management SystemDEP Data Execution PreventionDev DeviceDNS Domain N

3. Creating an HDLM Environment116If a message appears asking you whether you want to install the MPIO driver, make sure that no multi-path management

3. Creating an HDLM Environment117Storport driver, or install Windows Server 2003 SP1 or later.Notes on using a Storport Miniport driverRead these not

3. Creating an HDLM Environment118If you used a license key file, it will be deleted after the installation finishes. The KAPL09115-W message will app

3. Creating an HDLM Environment11922. Use the results of the dlnkmgr command's view operation to check the version of the installed HDLM.If x.x.x

3. Creating an HDLM Environment120Trace File Size(KB) : 1000Number Of Trace Files : 4Path Health Checking : on(30)Auto Failbac

3. Creating an HDLM Environment121• If you are not performing an unattended installation, insert the DVD into the drive and run the installation progr

3. Creating an HDLM Environment122• The PRSV key will be registered before the installation finishes. If the KAPL09131-W message appears, follow the p

3. Creating an HDLM Environment123Enter five single-byte spaces between DGC and RAID.14. Click the OK button to close the MPIO Properties dialog box.1

3. Creating an HDLM Environment124Number Of Elog Files : 2Trace Level : 0Trace File Size(KB) : 1000Number Of Trace F

3. Creating an HDLM Environment125Figure 3-4: Single Path Configuration and Multi-path Configuration25. Check the path information as described in 3.6

xiConventions: DiagramsThis manual uses the following conventions in diagrams:MPIO Multipath I/OMVS Multiple Virtual StorageNAS Network Attached Stora

3. Creating an HDLM Environment1266. Perform the installation.• If you are not performing an unattended installation, insert the DVD into the drive an

3. Creating an HDLM Environment12710. Follow the instructions shown in the messages that appear in the window.• The PRSV key will be registered before

3. Creating an HDLM Environment12816. For Device Hardware ID, enter DGC RAID, and then click the OK button.Enter five single-byte spaces between D

3. Creating an HDLM Environment12924. Use the results of the view operation to check the version of the installed HDLM.If x.x.x-xx is displayed in HDL

3. Creating an HDLM Environment130Path Health Checking : on(30)Auto Failback : on(1)Remove LU : offIntermitt

3. Creating an HDLM Environment131Specify n for the restart key in the installation-information settings file.This command checks whether HDLM has alr

3. Creating an HDLM Environment13210. Check the results of the installation.If you have performed an unattended installation, check the installation r

3. Creating an HDLM Environment13321. Restart each host.22. Log on to Windows again as a member of the Administrators group.23. Execute the dlnkmgr co

3. Creating an HDLM Environment1343.6 Checking the Path Configuration, and make sure that you have successfully installed HDLM in a single-path config

3. Creating an HDLM Environment135The default of the HDLM management-target device is the same as that before the upgrade installation or re-installat

xiiConventions: Fonts and symbolsFont and symbol conventions are classified as:• General font conventions• Conventions in syntax explanationsThese con

3. Creating an HDLM Environment136addition, delete the files that have the same names as the above files, but with the extension pnf (oemn.pnf).If you

3. Creating an HDLM Environment137Sun Microsystems JRE 6.0_04 (32-bit)Sun Microsystems JRE 6.0_17 (32-bit)• In Windows Server 2008:Sun Microsystems JR

3. Creating an HDLM Environment138 \libAfter installing the JRE, check to make sure that the HDLM GUI starts.Note:• If you uninstall HDLM, HDLM-insta

3. Creating an HDLM Environment139command syntax.Table 3-13: firewall_setup command syntaxNote:In Windows, the folder in which the Hitachi Command Sui

3. Creating an HDLM Environment1403.6 Checking the Path ConfigurationHDLM functions, such as load balancing and failover, are only available for HDLM

3. Creating an HDLM Environment141click Scan for hardware changes.2. From the Disk Management window of Windows, click Rescan Disks.

3. Creating an HDLM Environment1423.7 Setting Up HDLMHDLM includes functions like the load balancing function, the automatic failback function, the er

3. Creating an HDLM Environment143To check the current audit log settings, execute the following command: >dlnkmgr view -sys -audlogAudit Log

3. Creating an HDLM Environment144(1) Setting Up Load BalancingIn a cluster environment, the load balancing function is only available for the Thunder

3. Creating an HDLM Environment145>dlnkmgr set -pchk on -intvl 10 When path health checking is enabled by specifying on for the -pchk parameter, yo

xiiiCode examples and messages appear as follows (though there may be some exceptions, such as when the code is part of a diagram):MakeDatabase...Stor

3. Creating an HDLM Environment146is enabled. To prevent an intermittent error from reducing I/O performance, we recommend that you monitor intermitte

3. Creating an HDLM Environment147Table 3-15: LU Deletion Function Values• Setting up LU deletion by using the set operationThe following is an exampl

3. Creating an HDLM Environment148If an error occurs, you might have to change the collection level to 1 or higher to collect any log information.The

3. Creating an HDLM Environment149trace information.The higher this value is set, the more information that will be output. As the amount of trace inf

3. Creating an HDLM Environment150is set to 2.You can specify a value from 2 to 16 for the number of HDLM manager log files.By specifying both the log

3. Creating an HDLM Environment151By specifying both the trace file size and the number of trace files, you can collect up to 1024000KB of trace data.

3. Creating an HDLM Environment152This example shows how to enable the collection of audit log data: >dlnkmgr set -audlog on -audlv 6 -category all

3. Creating an HDLM Environment153>dlnkmgr view -sys -audlogAudit Log : on(6)Audit Log Category : a11KAPL01001-I T

3. Creating an HDLM Environment1543.8 Setting Up Integrated TracesWhen HDLM is used, the dlnkmgr command and GUI operation logs are output to the inte

3. Creating an HDLM Environment155To change the integrated trace file settings:1. In Explorer, double-click the following file:program-installation-de

xivConventions: KB, MB, GB, and TBThis manual uses the following conventions:• 1 KB (kilobyte) is 1,024 bytes.• 1 MB (megabyte) is 1,0242 bytes.• 1 GB

3. Creating an HDLM Environment156The value you specify here will apply to n in program-installation-destination-drive:\Program Files\HITACHI\HNTRLib2

3. Creating an HDLM Environment157the Services window.From the list of services, select DLMManager. Then, from the Action menu, choose Restart to rest

3. Creating an HDLM Environment1583.9 Uninstalling HDLMThis section explains how to return the operating environment to the way it was before HDLM wa

3. Creating an HDLM Environment159• When uninstalling HDLM on a host where a Device Manager Agent 5.0 or later is installed, do not execute any of the

3. Creating an HDLM Environment160(1) Uninstallation Procedures - in a Non-Cluster EnvironmentTo uninstall HDLM:1. Log on to Windows.Log on as a membe

3. Creating an HDLM Environment1615. On the MPIO-ed Devices page, select Device Hardware ID DGC RAID, and then click the Delete button.6. Click th

3. Creating an HDLM Environment162Log on as a member of the Administrators group.2. Stop all the processes and services that use the HDLM management-t

3. Creating an HDLM Environment163Figure 3-7: Single Path Configuration and Multi-path ConfigurationIn Windows Server 2008, if you have selected an EM

3. Creating an HDLM Environment164From the Administrator: Command Prompt window, execute the uninstallhdlm utility for uninstalling HDLM.For details a

3. Creating an HDLM Environment165The MPIO Properties dialog box opens.5. On the MPIO-ed Devices page, select Device Hardware ID DGC RAID, and the

xvContentsPreface iIntended readers ...iOrganiza

3. Creating an HDLM Environment166If the KAPL09020-E message appears during the uninstallation of HDLM, go to step 3.2. Execute the following command#

3. Creating an HDLM Environment167HNTRLib2 common library file hntr2t.dll. Even if this file remains undeleted, other applications will not be affecte

169Chapter4. HDLM OperationThis chapter describes the operating procedures for HDLM, including how to operate HDLM and the HDLM manager, and how to ch

4. HDLM Operation1704.1 Notes on Using HDLMThis section contains notes that are important for running HDLM operations.4.1.1 Using a Storage Management

4. HDLM Operation171• If the OS is Windows Server 2008:EMC CX series: HDLM 6.4 or later• You can display and use the HDLM GUI windows for the Thunder

4. HDLM Operation1724.2 HDLM Operations Using the HDLM GUIThis chapter explains the procedures for operating the HDLM GUI window components. For detai

4. HDLM Operation1734.3 Using Commands for HDLM OperationsThis section explains how to use the HDLM command. For details on the various command operat

4. HDLM Operation174For details on the displayed items and their descriptions, see 6.7 view (Displays Information).4.3.3 Changing the Status of PathsT

4. HDLM Operation1752. To change the status of paths to online, execute the dlnkmgr command's online operation.The paths to be placed online can

 Relevant program products Hitachi Dynamic Link Manager version 6.6For details about the supported OSs, see the HDLM Release Notes. Tradema

xvi2.10.2 Deleting an LU Dynamically... 422.11 Error Management ...

4. HDLM Operation176port offline, execute the dlnkmgr command's offline operation with the -hba parameter specified. The following shows an examp

4. HDLM Operation177 000011 Online0585 I 000004 Online 000010 Online058A H 000003 Online 000009 O

4. HDLM Operation1784.3.6 Viewing and Setting Up the Operating EnvironmentThis section explains how to display and set up the HDLM operating environme

4. HDLM Operation179• Path health checking• Automatic failback• Intermittent error monitoring• LU dynamic deletion• Error log collection level• Trace

4. HDLM Operation180For details on the displayed items and their descriptions, see 6.7 view (Displays Information).4.3.8 Updating the LicenseThis sect

4. HDLM Operation181Trace File Size(KB) : 1000Number Of Trace Files : 4Path Health Checking : on(30)Auto Failback

4. HDLM Operation182Permanent -KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss>Amo

4. HDLM Operation1834.4 Using the Windows Administrative Tool (Performance) to Check Path InformationThe HDLM Performance Monitor uses the Windows adm

4. HDLM Operation184Table 4-2: Selectable Items for Instances#If no LUs are being managed by HDLM, <No Instances> will be displayed.Avg.Disk Byt

4. HDLM Operation1854.5 Starting and Stopping the HDLM ManagerIf an error occurs in the system, such as in an HDLM program, you might need to manually

xvii3.7 Setting Up HDLM ...1423.7.1 Checking the Curr

4. HDLM Operation186>dlnkmgr view -sys -msrvHDLM Manager Ver WakeupTimeDeadKAPL01001-I The HDLM command completed normally. Operation name = v

4. HDLM Operation1874.6 HDLM Resident ProcessesTable 4-3: HDLM resident processes lists and describes the resident processes in HDLM. To monitor these

4. HDLM Operation1884.7 Reconfiguring the HDLM Operating EnvironmentYou can add or delete LUs and paths while the host installing HDLM is running by u

4. HDLM Operation189Figure 4-1: Using the command to confirm that an LU has been added5. For the new LU, write a signature, create partitions, and the

4. HDLM Operation1908. Restart node B.(2) Checking an Added PathYou can add a path, by inserting a cable into an existing LU, even while the host (on

4. HDLM Operation191- KAPL08019-E and KAPL08022-E- KAPL05301-ENote that these messages are output by Windows activities, and not by an error in HDLM.4

4. HDLM Operation192When an LU is deleted from the HDLM management target by using the LU deletion function, the KAPL08022-E message might not be outp

4. HDLM Operation193Table 4-4: Items and Descriptions for the Path Information Displayed in the KAPL05301-E Message shows the items and descriptions f

4. HDLM Operation194(3) Recovering a Deleted LU or PathTo restore a deleted LU, recover it from the physical failure, and then perform the operations

195Chapter5. TroubleshootingThis chapter describes how to properly use HDLM error information, and then how to resolve the problem, if an error occurs

xviii5. Troubleshooting 1955.1 Information Collected by the DLMgetras Utility for Collecting HDLM Error Information ...

5. Troubleshooting1965.1 Information Collected by the DLMgetras Utility for Collecting HDLM Error InformationImmediately after an error occurs, execut

5. Troubleshooting1975.2 Checking Error Information in MessagesYou can check path errors by referring to the KAPL08xxx messages that are output to the

5. Troubleshooting198LU or Path Has Been Dynamically Deleted in 4.7.2 Deleting an LU Dynamically.ErrorCodeThe error number generated when Windows dete

5. Troubleshooting199displayed.This is the same as the HDevName that is displayed by the view operation. For details on the view operation, see 6.7 vi

5. Troubleshooting2005.3 What To Do for a Path ErrorWhen a path error is detected by HDLM, you must immediately resolve the error and restore the path

5. Troubleshooting201Figure 5-2: Troubleshooting Procedure When a Path Error OccursThe following shows the procedure for using the HDLM command (dlnkm

5. Troubleshooting202pathinfo.txt is the redirection-output file name. Use a file name that matches your environment.5.3.3 Identifying the Error PathC

5. Troubleshooting2035.4 What To Do for a Program ErrorThe following describes what to do to handle errors that occur in an HDLM program. Figure 5-3:

5. Troubleshooting204When an error occurs in the HDLM GUI, take a screenshot at the time the error occurred.5.4.3 What To Do for the Program ErrorFoll

5. Troubleshooting2055.5 What To Do for Other ErrorsWhen the cause of an error may be related to HDLM but is neither a path error nor an HDLM program

xix7.2.2 Parameters ...2867.2.3 List of Collected Er

207Chapter6. Command ReferenceThis chapter describes the HDLM command (dlnkmgr) and its operations.6.1 Overview of the HDLM Command dlnkmgr6.2 clear (

6. Command Reference2086.1 Overview of the HDLM Command dlnkmgrThis section describes how to specify the HDLM command dlnkmgr and its subcommands (cal

6. Command Reference209• If you are using Windows Server 2003, execute HDLM commands as a member of the Administrators group.If you are executing HDLM

6. Command Reference2106.2 clear (Returns the Path Statistics to the Initial Value)The dlnkmgr command's clear operation clears the statistics (I

6. Command Reference211(2) To Display the Format of the clear Operation-helpDisplays the format of the clear operation.Example >dlnkmgr clear -help

6. Command Reference2126.3 help (Displays the Operation Format)The dlnkmgr command's help operation displays the list of operations available for

6. Command Reference213online: Format dlnkmgr online [-path] [-s] dlnkmgr online [-path] -hba HBAPortNumber.BusNumber [-s] dlnkmgr online [-

6. Command Reference2146.4 offline (Places Paths Offline)The dlnkmgr command's offline operation places online paths offline. Specify the paths t

6. Command Reference215-pathid, or -hbaportwwn parameter.-hba host-port-number.bus-numberUse this parameter to place offline, at one time, all the pat

xxAppendixes 449A. Functional Differences Between Versions of HDLM ... 450A.1 Functional Differences Betwe

6. Command Reference216sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the offline operation

6. Command Reference217For host-LU-number, specify the host LU number portion of PathName. Leading zeroes can be omitted from the host LU number (0001

6. Command Reference218ExampleThe following example shows how to display the format of the offline operation: >dlnkmgr offline -helpoffline: Forma

6. Command Reference219 The above command will display information pertaining to only those paths that pass through the specified channel adapter port

6. Command Reference2206.5 online (Places Paths Online)The dlnkmgr command's online operation places offline paths online. To specify the paths t

6. Command Reference221Specify the host port number and bus number of the target HBA port: the numbers are found in the PathName field displayed using

6. Command Reference222KAPL01061-I 2 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online>-pathid AutoPATH_IDUse th

6. Command Reference223to the Online status. Is this OK? [y/n]: yKAPL01061-I 1 path(s) were successfully placed Online; 0 path(s) were not. Operation

6. Command Reference224>ReferenceUsing the view operation together with Windows commands enables you to filter the path information listed for a sp

6. Command Reference2256.6 set (Sets Up the Operating Environment)The dlnkmgr command's set operation sets the HDLM operating environment.6.6.1 F

1Chapter1. Overview of HDLMHDLM is a software package that manages paths between a host and a storage system. HDLM is designed to distribute loads acr

6. Command Reference226Table 6-2: Default and Recommended Values-lb {on [-lbtype {rr|exrr|lio|exlio|lbk|exlbk}]|off}Enables or disables load balancing

6. Command Reference227SMS series, Universal Storage Platform V/VM, Virtual Storage Platform, and the EMC DMX series. The conditions mentioned above w

6. Command Reference228The higher the error log collection level value, the more log information will be output. As the amount of log information that

6. Command Reference229indicates a file number of 1 or 2)), the number of log files is set at 2.-systflv trace-levelSpecify the trace output level.The

6. Command Reference230If the value is changed to something smaller than the value that is currently set, the execution confirmation message KAPL01097

6. Command Reference231on: Enabledoff: DisabledEnabling automatic failbacks might automatically place paths online that were intentionally placed offl

6. Command Reference232 error-monitoring-interval >= checking-interval-for-automatic-failback x number-of-times-error-is-to-occur-during-intermitte

6. Command Reference233occur is reached during the monitoring interval. A path that is assumed to have an intermittent error is excluded from automati

6. Command Reference234after the next time an automatic failback is successful. Because the errors and elapsed time are not counted or measured while

6. Command Reference235that if you use the view -sys operation to display the HDLM functionality configuration, Intermittent Error Monitor will be sho

1. Overview of HDLM21.1 What is HDLM?With the widespread use of data warehousing and increasing use of multimedia data, the need for high-speed proces

6. Command Reference236Legend:AFB: Automatic failbackIEM: Intermittent error monitoring#1When this condition is not satisfied, the KAPL01080-W message

6. Command Reference237-licSpecify this option for when a license is updated. The HDLM license is provided via a license key or license key file. A li

6. Command Reference238KAPL01071-I A permanent license was installed.>Example 2The following example shows how to update the license key when the l

6. Command Reference239-audlog {on [-audlv audit-log-data-collection-level] [-category [[ss][a][ca]|all]]|off}Specifies whether to collect audit log d

6. Command Reference240Indicating Audit Log Data Categories lists the values that indicate categories of audit log data. The default is all. Note that

6. Command Reference241 | -systfs TraceFileSize | -systfn Number-Of-TraceFiles | -pchk on [ -intvl Interv

6. Command Reference242 Interval-Time { 1 - 1440 }(Minute) (Default Value 1) (afb) Error-Monitor-Interval { 1 - 1440 }(Minute

6. Command Reference2436.7 view (Displays Information)The dlnkmgr command's view operation displays HDLM program information, HDLM management-tar

6. Command Reference244[-t]To display a summary of path informationdlnkmgr view -path -c[-stname][-srt {lu|cp}][-t](4) To Display LU InformationTo dis

6. Command Reference2456.7.2 ParametersThis section describes the parameters for the view operation, in the following order:(1) Parameters Used When D

1. Overview of HDLM3• Lightning 9900V Series• Thunder 9500V Series• Universal Storage Platform V/VM• Virtual Storage Platform• EMC DMX series• EMC CX

6. Command Reference246Load Balance Settings for load balancing• Setting status:on: Enabledoff: Disabled• Algorithm:When the setting status of load ba

6. Command Reference247Number Of Trace FilesNumber of trace filesPath Health Checking• Settings for path health checking:on: Enabledoff: Disabled• Che

6. Command Reference248-adrvInformation about the HDLM alert driverHDLM Alert DriverStatus of the HDLM alert driver:Alive: NormalDead: StoppedVer Vers

6. Command Reference249#When the HDLM manager starts, HDLM cluster servers are automatically recognized.ExamplesExample 1The following example shows h

6. Command Reference250 >dlnkmgr view -sys -msrvHDLM Manager Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssKAPL01001-I The HD

6. Command Reference251>dlnkmgr view -sys -audlogAudit Log : offAudit Log Category : -KAPL01001-I The HDLM command

6. Command Reference252#2The EMC DMX series and the HP EVA series cannot be managed.-tDoes not display the title for each information item.Example >

6. Command Reference253the host device unless a drive letter has been assigned. The host-device-name string is case sensitive. If the command ends wit

6. Command Reference254• When the only HDLM management-target devices are the Thunder 9500V series, Lightning 9900 series, Lightning 9900V series, Hit

6. Command Reference255When the -exlu parameter is specified:Parameters to display path information, by selecting a display item:-path -itemWhen you s

1. Overview of HDLM41.2 HDLM FeaturesHDLM features include the following:The ability to distribute a load across multiple paths. This is also known as

6. Command Reference256Table 6-12: Items That Can Be Selected by the -path -item Parameter and the Sub-parameters#Because both PathID and Status are a

6. Command Reference257necessary to specify hd for the -item parameter. If the command ends with the KAPL01064-W or KAPL01013-E message, follow the re

6. Command Reference258DMX series, EMC CX series, and HP EVA series will not be displayed. Ellipsis (...) will be displayed instead.• When an HDLM man

6. Command Reference259Parameters to display a summary of path information:-path -cIf the -c parameter is specified at the same time as the -path para

6. Command Reference260in the product ID element of the DskName field is limited to 10. When there are 11 or more characters in the product ID, the 8t

6. Command Reference261Displayed path informationTable 6-13: Displayed Path Informationdescribes the displayed path information. The following explain

6. Command Reference262PathStatus Status of the displayed paths. The displayed status indicates the following:•Online: All paths are available.•Reduce

6. Command Reference263DskName#1DskName The storage system name, which identifies the storage system that is accessed by a path.A storage system name

6. Command Reference264iLU#1iLU • For the Thunder 9500V series, Lightning 9900 series, Lightning 9900V series, Hitachi USP, Hitachi AMS2000/AMS/WMS/SM

6. Command Reference265Status Status of the path•Online: Online•Offline(C): Placed offline using the Path Management window of the HDLM GUI or by a co

1. Overview of HDLM5HDLM can utilize both configuration-diagrams and the list format to display information about all the paths that exist between hos

6. Command Reference266Legend:- : Not displayed#1The path information is displayed only when a value is specified for the -path -item parameter.#2In a

6. Command Reference267#3The drive letter assigned to a dynamic disk volume is not displayed.Table 6-14: Elements of a Path NameThe path name correspo

6. Command Reference268Thunder 9500V seriesProduct identifier#9500VHitachi AMS2000 series AMSHitachi AMS AMSHitachi SMS SMSHitachi WMS WMSLightning 99

6. Command Reference269#• When a summary is displayed by specifying the -path -c parameter and there are 11 or more characters in the summary string,

6. Command Reference270-pathid AutoPATH_IDUse this parameter to display only the information about the LU that is connected to the path with that spec

6. Command Reference271 000009 Online Product : EMC SerialNumber : -LUs : 4 iLU HDevNa

6. Command Reference272 iLU HDevName PathID Status 6006048000018781000153594D423031 L 000000 Online

6. Command Reference273In the sub-parameters, -hdev or -pathid, you can filter the LU information to be displayed. If you omit both parameters, the co

6. Command Reference274Parameters to display a summary of LU information:-lu -cWhen the -c parameter is specified with the -lu parameter, a summary of

6. Command Reference275If this parameter is specified, all 32 digits of the iLU are displayed instead of truncating the iLU to 13 digits. If this para

Summary of AmendmentsThe following table lists changes in this manual (3020-3-P35-50(E)) and product changes related to this manual.In addition to the

6. Command Reference276Parameters to display a summary of LU information by adding items to be displayed:-lu -c -itemThe items displayed when the -ite

6. Command Reference277Displayed LU informationTable 6-18: Displayed LU Information describes the displayed LU information. The following explains the

6. Command Reference278iLU • For the Thunder 9500V series, Lightning 9900 series, Lightning 9900V series, Hitachi USP, Hitachi AMS2000/AMS/WMS/SMS ser

6. Command Reference279PathName#1- The path name. When you modify the system configuration or replace a hardware item, you should check the path names

6. Command Reference280Status - Status of the path•Online: Online•Offline(C): Placed offline by using the Path Management window of the HDLM GUI or by

6. Command Reference281Legend:- : Not displayed#1 This information is displayed when one of the following conditions exist:- The user selected the ite

6. Command Reference282This information is displayed when one of the following conditions exist:- The user selected the item to be displayed by using

283Chapter7. Utility ReferenceThis chapter explains the utilities used by HDLM.7.1 Overview of the Utilities7.2 The DLMgetras Utility for Collecting H

7. Utility Reference2847.1 Overview of the UtilitiesHDLM provides the following utilities:• The DLMgetras utility for collecting HDLM error informatio

7. Utility Reference285Administrators group.If you are executing the utilities in Windows Server 2008, see 4.1.6 Using Windows Server 2008.

7Chapter2. HDLM FunctionsThis chapter describes the various functions that are built into HDLM. Before the function specifications are explained thoug

7. Utility Reference2867.2 The DLMgetras Utility for Collecting HDLM Error InformationThis utility collects information that is needed to analyze HDLM

7. Utility Reference287DLMgetras utility. The output-destination folders shown in Table 7-1: List of Error Information Collected by the DLMgetras Util

7. Utility Reference288folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files\HITACHI\DynamicLinkMana

7. Utility Reference289folder-to-which-collected-information-is-output\HDLM-installation-destination-drive-name_\Program Files_\HITACHI\DynamicLinkMan

7. Utility Reference290cluster-sys.txt MSCS informationdirHdlmRoot.txt All the folders and the list of files in the HDLM installation destination fold

7. Utility Reference291#1The target error information collection folder is created in the folder to which collected information is output. The user sp

7. Utility Reference292which collected information is output, or if the DLMgetras utility is executed from the Windows Start menu, the default for the

7. Utility Reference293product other than HDLM from which error information is to be collected is being used.

7. Utility Reference2947.3 The dlmpr Utility for Clearing HDLM Persistent ReservationsThe dlmpr utility clears the persistent reservation that is lef

7. Utility Reference295box, and then click the OK button.4. In the Computer Management window, choose Device Manager. From the View menu, select Show

2. HDLM Functions82.1 Devices Managed by HDLMBelow is a list of devices that can or cannot be managed by HDLM. The devices that can be managed by HDLM

7. Utility Reference296the LU you specified will be cleared. Please confirm that no other servers are accessing this LU.[y/n]:yKAPL10658-I The persist

7. Utility Reference2977.4 The dlmprsvkey Utility for Registering an HDLM Persistent Reservation KeyThis utility registers and displays a PRSV key on

7. Utility Reference298now start. Is this OK? [y/n]: yKAPL12106-I An attempt to register the PRSV key was successful. (PRSV key = 0123456789abcdef)In

7. Utility Reference2997.5 The dlmchkpath Utility for Checking HDLM PathsIf you install or uninstall HDLM in a multi-path configuration, the disk migh

7. Utility Reference300>dlmchkpath -singleconnectKAPL12402-W iLU(0100) is in a multi-path configuration. PathID = 0,3KAPL12402-W iLU(0101) is in a

7. Utility Reference3017.6 The dlmhostinfo Utility for Checking HDLM Installation InformationThis utility either displays HDLM installation informatio

7. Utility Reference302Displays installation information.Example:Without specifying the -output parameter:>dlmhostinfo"installDirectory",

7. Utility Reference3037.7 The installhdlm Utility for Installing HDLMThe installhdlm utility can perform a new installation, upgrade installation, o

7. Utility Reference304storage_emc=nstorage_eva=nHDLM_core=nFor an explanation of each display item, see Table 7-3: Keys That Can Be Defined in the [I

7. Utility Reference305licensekeyfile Specify an absolute path to a license key file stored on the host.#2, #3 If this key is omitted, the installer u

2. HDLM Functions92.2 System ConfigurationHDLM is available in two SAN environment types: FC-SAN and IP-SAN. Note that the EMC DMX series, EMC CX seri

7. Utility Reference306Legend:Optional: If no key or setting value is specified, the installer uses the default value.Not required: The specification

7. Utility Reference307#2If a value is not of an allowable type, an error will occur.#3The value to be specified does not have to be enclosed within d

7. Utility Reference308Table 7-4: Keys That Can Be Defined in the [ENVIRONMENT_SETTINGS] SectionKey name#1Description#2Necessity of definitionMaximum

7. Utility Reference309trace_file_number Specify the maximum number of trace files (hdlmtr[1-64].log).You can specify a value from 2 to 64. The defaul

7. Utility Reference310Legend:Optional: • For a new installation:If no key or setting value is specified, the installer uses the default values.• For

7. Utility Reference311Specifying an invalid value results in an error.For details about the function settings, see 6.6 set (Sets Up the Operating Env

7. Utility Reference312intermittent_error_monitor=off#intermittent_error_monitor_interval=30#intermittent_error_monitor_number=3remove_lu=offremove_lu

7. Utility Reference3137.8 The uninstallhdlm Utility for Uninstalling HDLMThe uninstallhdlm utility uninstalls HDLM. If you execute the uninstallhdlm

7. Utility Reference314the host, check the results of the HDLM uninstallation recorded in the uninstallhdlm.log file.

315Chapter8. MessagesThis chapter describes the format and meaning of the message IDs, and also the terms used in the messages and message explanation

2. HDLM Functions10Figure 2-1: Configuration of an HDLM System When Using an FC-SANTable 2-1: HDLM System Components When Using an FC-SAN lists the HD

8. Messages3168.1 Before Viewing the List of MessagesThis section explains the following information that is needed to locate messages and understand

8. Messages3178.2 KAPL01001 to KAPL02000KAPL01001-IThe HDLM command completed normally. Operation name = aa...aa, completion time = bb...bbDetailsThe

8. Messages318KAPL01005-WA parameter is invalid. Operation name = aa...aa, parameter = bb...bbDetailsaa...aa: clear, set, online, offline, or viewbb..

8. Messages319Specify the parameter value, and then retry.KAPL01009-WA parameter value is invalid. Operation name = aa...aa, parameter = bb...bb, para

8. Messages320KAPL01014-WNo authority to execute the HDLM command. Operation name = aa...aaDetailsYou do not have the administrator permissions necess

8. Messages321aa...aa: viewActionExecute the view operation of the HDLM command (dlnkmgr view -path) to check the value displayed in HDevName. Specify

8. Messages322Terminate unnecessary applications to increase the amount of free memory, and then try again.KAPL01023-WThe last Online path for the dev

8. Messages323ActionRemove the error in the path, and then retry.KAPL01039-WDuring the online operation processing of the HDLM command, a path that ca

8. Messages324DetailsThe same parameter value is specified two or more times.aa...aa: viewbb...bb: Parameter namecc...cc: Duplicate parameter valueAct

8. Messages325ActionWait until the offline request registered in the batch job finishes, and then retry.KAPL01048-WHelp information cannot be found. O

2. HDLM Functions112.2.2 System Configuration Using an IP-SANIn an IP-SAN, LAN cables are used to connect hosts to storage systems. The cable port on

8. Messages326KAPL01051-IBecause no path has been selected among the currently displayed paths, the paths in the Offline(C), Offline(E), and Online(E)

8. Messages327PathID = aa...aa Would you like to continue the processing of the offline operation? [y/n]:DetailsA path that cannot be set to Offline(C

8. Messages328DetailsMultiple paths will be collectively placed Online because the -hba or -cha parameter has been specified. To continue processing,

8. Messages329see 6.3 help (Displays the Operation Format).KAPL01060-IThe user terminated the operation. Operation name = aa...aaDetailsCommand proces

8. Messages330cc...cc: The number of paths that were not successfully taken offline (decimal (base-10) number)dd...dd: offlineActionFor batch processi

8. Messages331KAPL01065-EThe configuration does not support the simultaneous use of the load balancing and cluster support functions.DetailsIf a stora

8. Messages332The license was renewed and is registered as a permanent license.ActionNone.KAPL01072-IThe emergency license was installed. The license

8. Messages333You do not need to install a license because a permanent license has already been installed.ActionNone.KAPL01079-WThe intermittent error

8. Messages334DetailsThere is no useable license key for HDLM in the license key file.aa...aa: Windows-installation-destination-drive-name\hdlm_licens

8. Messages335which parameter can be specified, and then retry. For details on the help operation, see 6.3 help (Displays the Operation Format).KAPL01

2. HDLM Functions12Figure 2-3: Configuration of an IP-SAN System When Using iSCSI Software and an NICTable 2-2: HDLM System Components When Using an I

8. Messages336KAPL01097-WAll the current trace files will be deleted. Is this OK? [y/n]DetailsIf you set a value that is less than the current value o

8. Messages337ActionUse the view operation of the HDLM command (dlnkmgr view -path -hbaportwwn) to check the target HBA port WWN. After that, specify

8. Messages338If you want to execute the online processing for the paths which pass the specified target, enter y. If you want to terminate the proces

8. Messages339KAPL01115-WThe audit log configuration file cannot be opened. Execute the "dlnkmgr view -sys -audlog" command and check whethe

8. Messages340KAPL01119-WAn error occurred during processing to output the audit log configuration file.DetailsAn internal parameter error when the au

8. Messages3418.3 KAPL02001 to KAPL03000KAPL02001-IHDLM GUI has started normally. java.version = aa...aaDetailsaa...aa: VersionActionNone.KAPL02002-IH

8. Messages342DLMgetras Utility for Collecting HDLM Error Information.KAPL02005-EAn attempt to start HDLM GUI has failed due to insufficient memory.De

8. Messages343If you want to execute the operation, click OK. To cancel the operation, click Cancel.KAPL02012-Iaa...aa has started.Detailsaa...aa: Ope

8. Messages344• Error Log File Size• Monitoring Interval• Number of times• Error Log Number of Files• Trace File Size• Trace Number of FilesActionData

8. Messages345• Path Health Checking Interval• Auto Failback Checking Interval• Error Log File Size• Monitoring Interval• Number of times• Error Log N

2. HDLM Functions13(1) Setting Range of the iSCSI Software and iSCSI HBAThe following describes the ranges that can be used for the iSCSI software and

8. Messages346The currently selected paths will be changed to the Offline(C) status. If you want to continue, click OK. If you do not want to proceed,

8. Messages347ActionIf you want to continue online processing, click OK. To cancel online processing, click Cancel. For the paths in which online proc

8. Messages348KAPL02027-EThe last Online path or Online(E) path to the LU cannot be placed in the Offline(C) status. PathID = aa...aaDetailsThe path s

8. Messages349• Get HDLM Driver Status• Get HDLM Alert Driver Statusbb...bb: Issuing API name (character string)•JHSPGetOption• JHSPSetOption• JHSPOnl

8. Messages350• Set Option Information• Get HDLM Manager Status• Get HDLM Driver Status• Get HDLM Alert Driver StatusActionTerminate unnecessary appli

8. Messages351aa...aa: Path ID (decimal (base-10) number)ActionRemove the error in the path, and then retry.KAPL02041-WThe cluster support function is

8. Messages352The existing file will be overwritten. To continue, click OK. Otherwise, click Cancel. aa...aa: File nameActionTo overwrite the existing

8. Messages353KAPL02055-IThe target path(s) are already aa...aa.DetailsThe specified paths are already Online/Offline(C), as a result of the online/of

8. Messages354After confirming that the paths are not currently being reconfigured, click the Refresh button.KAPL02063-WThe version number cannot be d

8. Messages355The HDLM version information could not be acquired.aa...aa: Code showing the reason for the errorActionRe-execute the command. If the sa

2. HDLM Functions142.3 LU ConfigurationAfter you have properly installed HDLM, the LU configuration will change as follows:Before the installation of

8. Messages356DetailsDuring the GUI startup, an error occurred that was plrobably not a result of a user operation.aa...aa: Executed function name (ch

8. Messages357aa...aa: Trace informationActionNone.

8. Messages3588.4 KAPL03001 to KAPL04000KAPL03001-IHDLM API information - aa...aaDetailsThis information is required for resolving problems.aa...aa: T

8. Messages359Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the maintenance company if the

8. Messages360KAPL03999-EAn unexpected error occurred.DetailsConflicting versions of HDLM modules are being used.ActionExecute the DLMgetras utility f

8. Messages3618.5 KAPL04001 to KAPL05000KAPL04001-IHDLM manager started.ActionNone.KAPL04002-ECould not start the HDLM manager.DetailsThe HDLM manager

8. Messages362ActionThe HDLM manager starts as a service and as such, to start HDLM from the command line, use the net start DLMManager command.KAPL04

8. Messages363DetailsHDLM manager could not start normally because some of the definitions in the option definition file were invalid.ActionIf the KAP

8. Messages364Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the maintenance company if the

8. Messages365KAPL04021-IHDLM manager information - aa...aaDetailsThis information is required for resolving problems.aa...aa: HDLM manager trace info

2. HDLM Functions15Figure 2-4: LU Configuration Recognized by the Host After the Installation of HDLMTable 2-3: Components Recognized by the Host list

8. Messages366Execute the DLMgetras utility for collecting HDLM error information, and then contact your HDLM vendor or the maintenance company if the

8. Messages367Install a permanent license.KAPL04030-EThe temporary license has already expired.ActionInstall a permanent license.KAPL04031-EThe emerge

8. Messages368KAPL04035-IThe path health check will now start. Total number of paths = aa...aaDetailsaa...aa: Total number of pathsActionNone.KAPL0403

8. Messages369aa...aa: Trap IDbb...bb: Destination IP address of the trapcc...cc: Destination port number of the trapdd...dd: Community name given to

8. Messages3708.6 KAPL05001 to KAPL06000KAPL05001-IDriverEntry() started.DetailsThe initialization function was executed.ActionNone.KAPL05002-IDriverE

8. Messages371None.KAPL05005-IThe control function (aa...aa) for the HDLM driver (filter component) was initialized successfully.DetailsThe HDLM drive

8. Messages372ActionCheck whether the HDLM driver has started normally. If it has not started or contains an error, contact your HDLM vendor or the ma

8. Messages373Detailsaa...aa: Path ID (hexadecimal number)bb...bb: Disk sequence number (decimal (base-10) number)cc...cc: Degree of progress in healt

8. Messages374company. Refer to the HDLM User's Guide for instructions how to execute the DLMgetras utility.DetailsWhen the LU deletion function

8. Messages3758.7 KAPL07001 to KAPL08000KAPL07819-IData for maintenance: aa...aa bb...bb cc...cc dd...dd.DetailsThis message is generated by the core

2. HDLM Functions162.4 Program ConfigurationHDLM is actually a combination of several programs. Because each program corresponds to a specific HDLM op

8. Messages376KAPL07822-WAn LU connected to PathID (aa...aa) cannot use the load balancing function in a cluster configuration.DetailsThe LU connected

8. Messages3778.8 KAPL08001 to KAPL09000KAPL08019-EThe path (aa...aa) detected an error (bb...bb). (cc...cc)DetailsAn error occurred in the path. The

8. Messages378bb...bb: Path ID (same as PathID of view -path) (decimal (base-10) number)cc...cc: Host port number (same as PathName of view -path) (he

8. Messages379paths is recovered.aa...aa: Path ID(same as PathID of view -path) (decimal (base-10) number)ActionNone.KAPL08026-EAn error occurred on a

8. Messages3808.9 KAPL09001 to KAPL10000KAPL09001-EThere is no system management permission. Login with administrator permission and aa...aa HDLM.Deta

8. Messages381No. I will restart my computer later check box.KAPL09005-ECould not stop the HDLM manager. Stop it manually, and then try the installati

8. Messages382KAPL09010-EYou cannot install onto storage media that is not a built-in disk.ActionInstall HDLM onto a built-in disk.KAPL09014-EThe OS m

8. Messages383KAPL09020-EAn attempt to uninstall Hitachi Network Objectplaza Trace Library 2 failed.DetailsAn attempt to uninstall HNTRLib2 has failed

8. Messages384ActionContact your HDLM vendor or the maintenance company if there is a maintenance contact of HDLM.KAPL09071-EThe specified installatio

8. Messages385None.KAPL09080-IThe temporary license has been installed. The license expires on aa...aa.Detailsaa...aa: Year (4 digits)/month (01-12)/d

2. HDLM Functions17Table 2-4: Functions of HDLM ProgramsNote:HDLM programs other than the HDLM GUI are referred to as the HDLM Core components.Program

8. Messages386ActionInstall a permanent license.KAPL09086-WThe entered license key is invalid.ActionEnter a valid license key.KAPL09087-EThe entered l

8. Messages387Install a permanent license at a later time.KAPL09091-EA fatal error occurred in HDLM. The system environment is invalid. Contact your H

8. Messages388If a license key file exists, delete it.KAPL09118-WThe license key file is invalid. File name = aa...aaDetailsThe format of the license

8. Messages389In this case, the following message is not displayed: Driver aa...aa has already been installed. The file version is bb...bb is not disp

8. Messages390KAPL09134-EThe HDLM path cannot be added to the Path environment variable.Refer to the Messages section of the HDLM User's Guide fo

8. Messages391(x86)\HITACHI\DynamicLinkManager\lib• C:\Program Files (x86)\Common Files\HitachiHowever, if Hntrlib2 has already been installed, the fo

8. Messages392When linkage is performed with Global Link Manager, cancel remote access. If this message is still output, execute the hbsasrv stop -f c

8. Messages393None.KAPL09182-WAn attempt to aa...aa HDLM version bb...bb has failed.See the previous messages to resolve the problems.DetailsThe unatt

8. Messages394Action• In installhdlm utility for installing HDLM:Restart the computer and make sure that HDLM is running correctly.• In uninstallhdlm

8. Messages395for uninstalling HDLM.ActionMake sure that the parameters for the installhdlm or uninstallhdlm utilities are appropriate, and then try a

2. HDLM Functions182.5 Driver Levels of the HDLM and MPIO DriversThe HDLM and MPIO drivers are positioned at a higher driver level than the SCSI drive

8. Messages396Make sure that the path name of the installation-information settings file is appropriate, and then try again.KAPL09192-WAn installation

8. Messages397KAPL09195-WThe setup.exe file does not exist.DetailsHDLM cannot be installed, because the installation program (setup.exe) does not exis

8. Messages398bb...bb: Detailed information (decimal (base-10) number)ActionContact your HDLM vendor or the maintenance company if there is a maintena

8. Messages399KAPL09216-EAn error occurred during I/O of a file that aa...aa uses. Error Code = bb...bb cc...ccDetailsAn error occurred during an I/O

8. Messages400aa...aa: Feature that has not been installed• If the value of aa...aa is HDLM GUI:The HDLM GUI cannot be used.• If Hitachi Command Suite

8. Messages401KAPL09253-Wy cannot be specified in the HDLM_core key when all HDLM components are installed.DetailsIn an environment where all HDLM com

8. Messages402If you are not sure which search paths were specified during the installation of Windows, contact Microsoft.KAPL09257-WHDLM cannot be in

8. Messages403None.KAPL09260-WErrors were detected during the HDLM aa...aa installation check.See the previous messages to resolve the problems.Detail

8. Messages404KAPL09265-IA temporary license (excluding HDLM Light) will be installed. The license expires on aa...aa.DetailsA temporary license (excl

8. Messages405aa...aa: HDLM installation folderActionTo execute a silent installation, use drive-to-which-the-installation-DVD-is-inserted:\HDLM_Windo

2. HDLM Functions192.6 Distributing a Load Using Load BalancingWhen the system contains multiple paths to a single LU, HDLM can distribute the load ac

8. Messages406installed HDLM or SP. When installing HDLM: First uninstall the installed HDLM or SP, and then perform a new installation. When installi

8. Messages4078.10 KAPL10001 to KAPL11000KAPL10002-WToo many parameters have been specified.DetailsFour or more parameters have been specified.ActionC

8. Messages408ActionThe specified folder already exists. Enter y to overwrite the existing file. Enter n or press any other key to terminate the DLMge

8. Messages409aa...aa: Collected file namebb...bb: Year/month/day hour:minute:secondActionNone.KAPL10022-IThe utility for collecting HDLM error inform

8. Messages410Re-execute the DLMgetras utility. For details on the DLMgetras utility, see 7.2 The DLMgetras Utility for Collecting HDLM Error Informat

8. Messages411Detailsaa...aa: What percentage of all the information to be collected is log informationActionNone.KAPL10044-WThere is insufficient dis

8. Messages412error information are appropriate, and then try again.KAPL10048-EAn error occurred in internal processing of the utility for collecting

8. Messages413ActionNone. For details on the dlmpr utility, see 7.3 The dlmpr Utility for Clearing HDLM Persistent Reservations.KAPL10644-WThe specifi

8. Messages414KAPL10652-EThe entered value is invalid. The operation stopsDetailsAn invalid response to a request was entered three times in a row.Act

8. Messages415We recommend that you report the effects of using the utility to the user for confirmation.ActionTo clear the LU reservation, enter y. E

2. HDLM Functions20Figure 2-7: Flow of I/O Data When the Load Balancing Function Is Not UsedWhen the load balancing function is not used, I/O operatio

8. Messages416• An LU was disconnected from the server during execution of a utility.KAPL10662-EFree memory is insufficient.ActionTerminate unnecessar

8. Messages417ActionNone.KAPL10667-CAn attempt to the get physical drive number failed. LU = aa...aaDetailsAn LU without a physical drive number exist

8. Messages4188.11 KAPL11001 to KAPL12000KAPL11901-Iaa...aa has started.DetailsThe operation has started on the host.aa...aa : Operation (character st

8. Messages419None.KAPL11903-Iaa...aa has completed normally.DetailsThe operation has completed normally on the host.aa...aa: Any of the following ope

8. Messages420• Clear Data• Get HDLM Driver Status• Get HDLM Manager Status• Get HDLM Alert Driver Status• Online• Offline• Get SNMP Trap Information•

8. Messages421KAPL11907-IXML reception - aa...aaDetailsThis information is required for resolving problems.aa...aa: XML information (character string)

8. Messages4228.12 KAPL12001 to KAPL13000KAPL12101-WA parameter has not been specified.ActionMake sure that the parameters for the dlmprsvkey utility

8. Messages423ActionTo execute the operation, enter y. To stop the operation, enter n.KAPL12105-WThe user does not have permission to execute the util

8. Messages424Registering an HDLM Persistent Reservation Key.KAPL12110-WThe entered value is invalid. Processing of the utility for registering the HD

8. Messages425KAPL12113-EAn attempt to acquire the PRSV key has failed.DetailsAn attempt to acquire the PRSV key from the registry key HKEY_LOCAL_MACH

2. HDLM Functions21Figure 2-8: Flow of I/O Data When the Load Balancing Function Is UsedWhen the load balancing function is used, I/O operations are d

8. Messages426None.KAPL12117-ITrace data for maintenance: registered PRSV key = aa...aaDetailsOutput when PRSV key registration is successful. aa...aa

8. Messages427KAPL12150-WAn error occurred during internal processing of HDLM Performance Monitor. HDLM Performance Monitor cannot start. Details = aa

8. Messages428There might not be enough memory or the host might be under a heavy load.This message might also be output when the WMI repository is co

8. Messages429Detailsaa...aa: Specified parameterActionExecute the dlmchkpath utility for checking HDLM paths with the -h parameter to check the param

8. Messages4308.13 KAPL13001 to KAPL14000KAPL13601-WThe audit log configuration file does not exist. Execute the "dlnkmgr view -sys -audlog"

8. Messages431file.ActionContact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM.KAPL13605-WAn error occurred

8. Messages432message.KAPL13803-WThe user does not have the privileges required to execute the dlmhostinfo utility for confirming HDLM installation in

8. Messages433DetailsThe dlmhostinfo utility for confirming HDLM installation information cannot be executed if HDLM is not installed.ActionNone.KAPL1

8. Messages4348.14 KAPL15001 to KAPL16000KAPL15010-WThe HDLM utility was executed by the user who does not have the authority. Command Line = aa...aaD

8. Messages435KAPL15035-WAn attempt to display the status that indicates whether paths are in an individual or multiple path configuration has failed.

2. HDLM Functions22have different owner controllers, different LUs might also have different owner paths. A non-owner path is a path that passes throu

8. Messages436bb...bb: Online or Offline(c)cc...cc: Command that the user executedKAPL15105-ISetting up the operating environment succeeded. Command L

8. Messages437aa...aa: Command that the user executedKAPL15201-IHDLM GUI has started successfully.KAPL15202-IHDLM GUI has terminated.KAPL15203-WHDLM G

8. Messages438KAPL15402-WCould not start the HDLM manager.KAPL15403-IHDLM Manager successfully stopped.KAPL15404-WThe HDLM Manager was executed by the

8. Messages4398.15 Return Codes for Hitachi Command Suite Common Agent ComponentWhen an operation requested of HDLM from Global Link Manager terminate

8. Messages440ActionClick Refresh to update the host information, check the path status, and then retry the offline operation.1015DetailsThe Offline p

8. Messages441maintenance contract for HDLM. For details on the DLMgetras utility, see 7.2 The DLMgetras Utility for Collecting HDLM Error Information

8. Messages442Refresh the host information, and then perform the operation again. If the same error occurs again, execute the DLMgetras utility for co

8. Messages443Re-execute the command. If the same error occurs again, execute the DLMgetras utility for collecting HDLM error information, and then co

8. Messages444A storage system that cannot use the load balancing function is connected.ActionCheck the system configuration. One or more connected st

8. Messages4451046DetailsA parameter is invalid.ActionRefresh the host information, and then perform the operation again. If the same error occurs aga

2. HDLM Functions23(2) When Using the Lightning 9900 Series, Lightning 9900V Series, Hitachi USP, Universal Storage Platform V/VM, Virtual Storage Pla

8. Messages4468.16 Events Output to Windows Event Logs by HDLMThe following table lists Table 8-3: Events Output to the Windows Application Log and Ta

8. Messages447Table 8-4: Events Output to the Windows System LogKAPL04029-E Error DLMManager None 16413 N/AKAPL04030-E Error DLMManager None 16414 N/A

449AppendixesA. Functional Differences Between Versions of HDLMB. Glossary

A. Functional Differences Between Versions of HDLM450A. Functional Differences Between Versions of HDLMThis section explains the functional difference

A. Functional Differences Between Versions of HDLM451longer needs to be removed as a target of the Data Execution Prevention (DEP) functionality.• In

A. Functional Differences Between Versions of HDLM452following conditions is satisfied, the path status remains Online:• A path is disconnected and is

A. Functional Differences Between Versions of HDLM453recovered• An LU was removed from being an HDLM management-target, and then the same LU is re-add

A. Functional Differences Between Versions of HDLM454Offline(E) Status in A.8 Path Status Transition and Automatic Path Switching. A.10 Differences in

A. Functional Differences Between Versions of HDLM455A.12 Differences in the Load Balancing Function in an MSCS EnvironmentHDLM 05-00 or earlier does

2. HDLM Functions24If the data is sequential, the path used will be the one to which the data of the I/O that was issued immediately beforehand was di

B. Glossary456B. GlossaryThis glossary explains the terms used in this manual.Aautomatic failbackA function for checking the status of paths at regula

B. Glossary457In Windows, each LU has only one Dev.Each Dev has a Dev number.(See also: Dev number)Dev numberA Dev number (the DNum column) in the con

B. Glossary458In this manual, the term HBA indicates an interface card that is mounted on a host from which the host connects to a storage system via

B. Glossary459LLDEV (Logical Device)A combination of the storage system's product name, serial number, and an internal LU. HDLM uses this value t

B. Glossary460(See also: owner path, non-owner controller)Oowner controllerA controller that has been set as an owner controller for an LU. Owner cont

B. Glossary461• Target ID (hexadecimal number)• Host LU number (hexadecimal number)A path name is used to identify a path.(See also: host LU number)pe

B. Glossary462SLPR (Storage Logical Partition)A function supported by Hitachi USP, Universal Storage Platform V/VM, and Virtual Storage Platform for l

463IndexAabbreviations defined iiactive host 60audit logcategories and audit events that HDLM can output 50collecting data 49data format 55automatic f

Index464driver levelHDLM and MPIO drivers 18dynamic reconfiguration 457EEMC CX seriescluster software 67EMC DMX seriescluster software 67dlnkmgr view

Index465HDev 15HDevName 198HDLMfeatures 4functions 7installing 90new installation (on Windows Server 2003) 94new installation (on Windows Server 2008)

2. HDLM Functions25You can specify the load balancing function from the Options window of the HDLM GUI or by using the dlnkmgr command's set oper

Index466installing 136KKB meaning xivLLDEV (Logical Device) 459load balancing 4, 19, 226, 459load balancing algorithms 23log collection levelvalues 22

Index467view [view operation] 249operation name 316operations 208displaying format 212of the HDLM command 208Oracle RACnote 85organization of this man

Index468TB meaning xivtermin message 316trace file 45trace file size 229trace level values 229types of collected logs 45types of error information 45U

iPrefaceThis manual describes the functions and use of the following program products.• Hitachi Dynamic Link ManagerIntended readersThis manual is int

2. HDLM Functions262.7 Performing Failovers and Failbacks Using Path SwitchingWhen the system contains multiple paths to an LU and an error occurs on

2. HDLM Functions27ErrorA high-risk error, which can be avoided by performing a failover or some other countermeasure.For details on error levels, see

2. HDLM Functions28Figure 2-10: Path Switching(2) Automatic FailbacksWhen a path recovers from an error, HDLM can automatically place the recovered pa

2. HDLM Functions29When the Lightning 9900 series, Lightning 9900V series, Hitachi USP, Universal Storage Platform V/VM, Virtual Storage Platform, Hit

2. HDLM Functions30Hitachi USP, Universal Storage Platform V/VM, Virtual Storage Platform, Hitachi AMS2000 series, or Hitachi SMS is being used, all t

2. HDLM Functions31Offline(C).The (P) means pending, which indicates that the operation to take the path offline is in the waiting-to-execute status (

2. HDLM Functions32The status indicating that an I/O could not be issued on a given path, because an error occurred on the path.The (E) means error.•O

2. HDLM Functions33Offline operation: Offline operation performed in the Path Management window or by executing the dlnkmgr command's offline ope

2. HDLM Functions34the Online(E) paths have been deleted.• The Offline(E) paths are assumed to have had an intermittent error, and are thus excluded f

2. HDLM Functions352.8 Monitoring Intermittent Errors (Functionality When Automatic Failback Is Used)An intermittent error refers to an error that occ

iiproblems that you might encounter.6. Command ReferenceChapter 6 describes all the HDLM commands.7. Utility ReferenceChapter 7 describes the HDLM uti

2. HDLM Functions362.8.3 Intermittent Error Monitoring ActionsIntermittent error monitoring is performed on each path, and it automatically starts as

2. HDLM Functions37(2) When an Intermittent Error Does Not OccurIf an error does not occur on a path a specified number of times within a specified in

2. HDLM Functions38(3) When the Conditions for an Intermittent Error Are Changed During Error MonitoringWhen the conditions for an intermittent error

2. HDLM Functions39check the IEP item displayed when the dlnkmgr command's view -path operation is executed with the -iem parameter specified, or

2. HDLM Functions40#1When you turn the intermittent error monitoring function off, information about paths not subject to automatic failback will be r

2. HDLM Functions412.9 Detecting Errors by Using Path Health CheckingHDLM can check the status of paths for which I/O operations are not being perform

2. HDLM Functions422.10 Dynamic Re-configurationUtilizing the Windows plug-and-play functionality, you can add or delete an LU or a path while the hos

2. HDLM Functions432.11 Error ManagementFor troubleshooting purposes, HDLM collects information and stores it into log files. The error information to

2. HDLM Functions44Figure 2-15: Flow of Data When Collecting Error InformationLogs might be collected in layers below HDLM, such as for the SCSI drive

2. HDLM Functions452.11.1 Types of Collected LogsHDLM collects information on detected errors and trace information and stores it into the integrated

iiiFull name or meaning AbbreviationDevice Manager Agent included in Hitachi Device Manager Device Manager AgentEMC CLARiiON CX series EMC CX seriesEM

2. HDLM Functions46#1For Windows Server 2003 (excluding the x86 edition) and Windows Server 2008 (excluding the x86 edition), Program Files is Program

2. HDLM Functions472.11.2 Filtering of Error InformationErrors detected by HDLM are classified into various error levels. Table 2-8: Error Levels list

2. HDLM Functions48• Outputs all trace informationFor details on how to change the collection level, see 3.7.2 Setting Up the HDLM Functions.2.11.3 Co

2. HDLM Functions492.12 Collecting Audit Log DataHDLM and other Hitachi storage-related products provide an audit log function so that compliance with

2. HDLM Functions50The categories of audit log data that can be collected differ depending on the product. The following sections explain only the cat

2. HDLM Functions51Table 2-10: Categories and Audit Events That Can Be Output to the Audit LogCategory Explanation Audit eventSeverity#1Message IDStar

2. HDLM Functions52Initialization of path statistics failed.4 KAPL15102-WAn attempt to place a path online or offline was successful.6 KAPL15103-IAn a

2. HDLM Functions53#1An attempt to place a path offline by using the HDLM GUI failed.4 KAPL15208-WAn attempt to perform an operation by using the HDLM

2. HDLM Functions54The severity levels are as follows:4: Warning, 6: Information#2If you use Ctrl + C to cancel the DLMgetras utility for collecting H

2. HDLM Functions55Filtering by category:The following categories can be specified:•StartStop• Authentication• ConfigurationAccess• All of the aboveFo

ivHP StorageWorks XP128 Disk Array HP XP128HP StorageWorks XP1024 Disk Array HP XP1024HP StorageWorks XP10000 Disk Array HP XP10000HP StorageWorks XP1

2. HDLM Functions56Up to 950 bytes of text can be displayed for each message-section.Table 2-12: Items Output in the Message SectionItem#ExplanationCo

2. HDLM Functions57#: The output of this item depends on the audit event.Example of the message section for the audit event An attempt to display HDLM

2. HDLM Functions582.13 Integrated HDLM management using Global Link ManagerBy using Global Link Manager, you can perform integrated path management o

2. HDLM Functions59Figure 2-16: Example System Configuration Using HDLM and Global Link Manager

2. HDLM Functions602.14 Cluster SupportHDLM can also be used in cluster configurations.For details about the cluster software supported by HDLM, see T

61Chapter3. Creating an HDLM EnvironmentThis chapter explains how to set up an HDLM environment and also how to erase environment settings.Make sure t

3. Creating an HDLM Environment623.1 HDLM System RequirementsCheck the following before installing HDLM:3.1.1 OSs Supported by HDLMThis subsection des

3. Creating an HDLM Environment63Note:In this manual, Windows running on a 32-bit processor is referred to as x86.#To use the Storport Miniport driver

3. Creating an HDLM Environment64ID for every connected host and storage system. For details about the micro-program versions for using HDLM, see the

3. Creating an HDLM Environment65Legend:Y: Usable--: Not usableFC I/F: FC InterfaceiSCSI I/F: iSCSI Interface#1Dual controller configuration is requir

vA generic term for:• AIX• HP-UX• Linux• SolarisUNIXThis abbreviation is used when it is not necessary to distinguish the following products:• Hitachi

3. Creating an HDLM Environment66#5The evaluation of HP EVA8000 has been completed. Response to inquiries for other systems of the HP EVA series must

3. Creating an HDLM Environment67#5Connection mainframe: MVSConnection storage system: Hitachi USP3.1.3 Cluster Software Supported by HDLMTable 3-5: S

3. Creating an HDLM Environment68Windows Server 2003 (x64)#2No service packMSCS Y -- Y YVCS 4.3 Y -- -- --Oracle RAC 10g#1Y ------SP2 MSCS Y -- Y YVCS

3. Creating an HDLM Environment69Windows Server 2003 R2 (x64)#2No service packMSCS Y -- Y YVCS 4.3, 5.0Y ------Oracle RAC 10g#1Y ------Oracle RAC 11g#

3. Creating an HDLM Environment70Windows Server 2003 (x86)#2No service packMSCS Y YYYVCS 4.1, 4.2, 4.3 Y ------Oracle 9i RAC#1Y ------Oracle RAC 10g#1

3. Creating an HDLM Environment71Windows Server 2003 R2 (x86)#2No service packMSCS Y YYYVCS 4.3, 5.0Y ------Oracle RAC 10g#1Y ------Oracle RAC 11g#1Y

3. Creating an HDLM Environment72Windows Server 2008 R2(IPF) No service packMSCS Y -- Y --SP1 MSCS Y -- Y --Windows Server 2008 (x64) No service packM

3. Creating an HDLM Environment73Legend:Y: Usable--: Not usable#1For details about Oracle RAC versions, see the HDLM Release Notes.#2The following ope

3. Creating an HDLM Environment74#The EMC DMX Series, EMC CX Series and HP EVA Series do not support volume managers.3.1.5 Virtual Environments Suppor

3. Creating an HDLM Environment75Table 3-8: Disk Space Requirements for a Host#1This size depends on the log files settings. The maximum size is 30000