Hp Hitachi Dynamic Link Manager Software Instrukcja Użytkownika

Hitachi Dynamic Link Manager Software User's Guide (for AIX(R))3000-3-F01-50(E)

viFO FailoverGMT Greenwich Mean TimeGUI Graphical User InterfaceHBA Host Bus AdapterHDev Host DeviceHLU Host Logical UnitHTTP Hypertext Transfer Proto

3. Creating an HDLM Environment78Installation on alternate disks(3) When Installing HDLM on Alternate Disks in 3.5.5 Performing an Upgrade Installatio

3. Creating an HDLM Environment79Table 3-10: Combinations of Migration Methods Available in an HACMP Environment and the Migration EnvironmentsLegend:

3. Creating an HDLM Environment80described in the following sub-sections on all hosts that comprise the cluster.(1) Perform Operations for HDLM Manage

3. Creating an HDLM Environment81(2) Set Up the HardwareCheck the topology (Fabric, AL, etc.) and perform setup as appropriate.1. Set up the storage s

3. Creating an HDLM Environment822. Switch the kernel mode.When AIX is running, change the symbolic link for /usr/lib/boot/unix and /unix to switch th

3. Creating an HDLM Environment831. Log in to AIX as the root user.If you are using a virtual I/O server, see the virtual I/O server documentation to

3. Creating an HDLM Environment846. Execute the following command to make sure that the hdisk recognized as the device to be managed by HDLM has been

3. Creating an HDLM Environment85installation of HDLM continues, but installation of HDLM components has failed. After installing HDLM, resolve the pr

3. Creating an HDLM Environment8615. Change the fc_err_recov setting of the parent device (fscsin) to fast_fail. # chdev -l fscsin -a fc_err_recov=fas

3. Creating an HDLM Environment87hdisk3 Available 1H-08-02 Hitachi Disk Array (Fibre)hdisk4 Available 1H-08-02 Hitachi Disk Array (Fibre

viiConventions: DiagramsThis manual uses the following conventions in diagrams:RADIUS Remote Authentication Dial in User ServiceSAN Storage Area Netwo

3. Creating an HDLM Environment88x.x.x-xx is the installed version of HDLM.24. From the execution result of the view operation, check that the program

3. Creating an HDLM Environment8930. Check the path configuration according to the procedure described in 3.6 Checking the Path Configuration.(2) When

3. Creating an HDLM Environment90 The KAPL10529-I message is displayed.If the KAPL10529-I message is not displayed, the HDLM management-target device

3. Creating an HDLM Environment91or# installp -aXgd /directory-copied-from-DVD-ROM/HDLM_AIX allEven though a message asking you to restart the host is

3. Creating an HDLM Environment92 The following procedure assumes that hdisk10 is recognized as a boot disk:16. Check the current boot disk list: # bo

3. Creating an HDLM Environment93 21. Verify that the settings for the parent device (fscsin) are enabled.Also, verify that the fc_err_recov setting h

3. Creating an HDLM Environment94 Make sure that the status of all displayed hdisks is Available.hdisks 0 to 2 are the physical device file names for

3. Creating an HDLM Environment95x.x.x-xx is the installed version of HDLM.29. From the execution result of the view operation, check that the program

3. Creating an HDLM Environment96When using HDLM in a cluster configuration, make sure to perform the operations described in the following sub-sectio

3. Creating an HDLM Environment97# varyoffvg volume-group-name3.5.5 Performing an Upgrade Installation or Re-installation of HDLMThis subsection expla

viiiConventions: Fonts and SymbolsFont and symbol conventions are classified as:• General font conventions• Conventions in syntax explanationsThese co

3. Creating an HDLM Environment98When dlmrmdev is executed, a message is displayed asking you to continue processing. Enter y to continue processing.T

3. Creating an HDLM Environment99hdisk7 deletedhdisk8 deletedhdisk9 deletedhdisk10 deletedKAPL09012-I All HDLM drivers were removed. • When the existi

3. Creating an HDLM Environment100/DVD-ROM-mounted-directory/HDLM_AIX/hdlmtool/dlmrmdev • Deleting an existing hdiskWhen an existing hdisk is successf

3. Creating an HDLM Environment101# echo "123456789ABCDEF" > /var/DLM/dlm.lic_key• When the license key file has been providedStore the l

3. Creating an HDLM Environment10212. For a re-installation, execute the following command:• When installing HDLM from the DVD-ROM# /directory-in-whic

3. Creating an HDLM Environment10315. Execute the following command and verify that the status of the hdisks is Available:# lsdev -Cc diskhdisk0 Ava

3. Creating an HDLM Environment104Alive x.x.x-xx yyyy/mm/dd hh:mm:ss 4000HDLM Driver Ver WakeupTimeAlive x.x.x-xx yyyy/m

3. Creating an HDLM Environment105# cfgmgr23. Execute the following command in the client logical partition to confirm that the physical volume has be

3. Creating an HDLM Environment106(2) When Installing HDLM in a Boot Disk Environment1. Log in to AIX as a user with root permissions.If you are using

3. Creating an HDLM Environment107hdisk configuration, use the dlmrmdev utility that is included in the installation DVD-ROM of the HDLM version to be

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

3. Creating an HDLM Environment108• When only the license key has been providedCreate the /var/DLM directory, and then, in this directory, create the

3. Creating an HDLM Environment109procedure in step 6.If an upgrade installation ends with an error, HDLM might be uninstalled. In this case, proceed

3. Creating an HDLM Environment110 Make sure that the fileset item in the output listing contains DLManager.mpio.rte, and all the displayed statuses a

3. Creating an HDLM Environment111The files beginning at hdisk3 are the names of the logical device files corresponding to the storage system's p

3. Creating an HDLM Environment112running properly.If HDLM Manager, HDLM Alert Driver, and HDLM Driver are all Alive, all programs are running correct

3. Creating an HDLM Environment113Table 3-12: List of Files Inherited During an Upgrade Installation or Re-installation(3) When Installing HDLM on Alt

3. Creating an HDLM Environment114key file (dlm.lic_key). The following shows an example when the license key is 123456789ABCDEF:# mkdir /var/DLM# ech

3. Creating an HDLM Environment1155. For a re-installation, execute the following command:• When installing HDLM on an alternate disk from the DVD-ROM

3. Creating an HDLM Environment116HDLM Alert Driver Ver WakeupTime ElogMem SizeAlive x.x.x-xx yyyy/mm/dd hh:mm:ss 4000HD

3. Creating an HDLM Environment1173.5.6 Migrating from HDLM Version 5.8.1 or Earlier to Version 5.9 or LaterWhen HDLM version 5.8.1 or earlier is migr

xConventions: 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 Environment118unique_id : offHDLM Subclass : nodeKAPL10800-I The dlmodmset utility completed normally.# If

3. Creating an HDLM Environment119O server: $ rmdev -dev vtscsin 10. Insert the DVD-ROM.11. If there is no directory for mounting the DVD-ROM, make th

3. Creating an HDLM Environment120Because HDLM version 5.9 or later requires deletion of hdisk, do not attempt to perform device configuration (cfgmgr

3. Creating an HDLM Environment121# /usr/DynamicLinkManager/bin/dlmrmdev Check the file names for odm-environment-settings-file-name and set-environme

3. Creating an HDLM Environment122To upgrade or re-install HDLM in an environment that uses HACMP and a local boot disk:1. Log in to AIX as the root u

3. Creating an HDLM Environment1236. Upgrade or re-install HDLM on the active host.To do so, perform steps 2 through 21 in (2) When Installing HDLM in

3. Creating an HDLM Environment124#Name of the node being used.6. Stop HACMP on the active host.Specify takeover as the shutdown mode.7. Migrate HDLM

3. Creating an HDLM Environment1253.5.8 Performing an Unattended Installation of HDLMThis subsection explains how to install HDLM using the installhdl

3. Creating an HDLM Environment126The /dev/cd0 part depends on the system.5. If you are using a copy of the installhdlm utility that you have placed i

3. Creating an HDLM Environment127• When only the license key has been providedCreate the /var/DLM directory, and then, in this directory, create the

xiContentsPreface iIntended Readers ...iOrganizat

3. Creating an HDLM Environment128 # /cdrom/HDLM_AIX/hdlmtool/instutil/installhdlm -f /any-directory/installation-information-settings-file Even thoug

3. Creating an HDLM Environment1292. Log in to AIX as the root user.If you are using a virtual I/O server, see the virtual I/O server documentation to

3. Creating an HDLM Environment130For a new installation, proceed to step 8.7. If you are upgrading or re-installing HDLM, back up the HDLM settings.I

3. Creating an HDLM Environment1319. Create an installation information settings file.To use the sample file, copy it from the DVD-ROM to a directory

3. Creating an HDLM Environment132# /cdrom/installux.sh -f /any-directory/installation-information-settings-file To execute installhdlm: # /cdrom/HDLM

3. Creating an HDLM Environment133 14. Delete the created mount directory. # rm -r /cdrom 15. Delete the installation information settings file. # rm

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

3. Creating an HDLM Environment135# lsdev -Cc disk > redirect-destination-file-2 2. Open both redirect-destination-file-1 and redirect-destination-

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

3. Creating an HDLM Environment137Table 3-14: The Recommended and Default Values of Each Function(1) Setting Up Load BalancingYou can select whether t

xii2.10.4 Collecting installation error information using the utility for collecting HDLM installation error information (dlmgetrasinst) ...

3. Creating an HDLM Environment138Set it to on to enable load balancing. Otherwise, set it to off. When you set on, specify one of the following algor

3. Creating an HDLM Environment139If this happens, change any of the following settings: the checking interval for automatic failbacks, the intermitte

3. Creating an HDLM Environment140on specifies that intermittent error monitoring is to be used. To disable intermittent error monitoring, specify off

3. Creating an HDLM Environment141You can set up the trace level for a trace file hdlmtrn.log (n indicates a file number from 1 to 64).Table 3-16: Val

3. Creating an HDLM Environment142size. # /usr/DynamicLinkManager/bin/dlnkmgr set -elfs 1000 Specify the size of the error log file in kilobytes.(8) S

3. Creating an HDLM Environment143(10) Setting the Number of Trace FilesYou can set the number of the trace files.Trace files for which the number of

3. Creating an HDLM Environment144Table 3-18: Values Indicating Audit Log Data Categories describes the values that indicate audit log data categories

3. Creating an HDLM Environment145This example shows how to specify the audit log facility: # /usr/DynamicLinkManager/bin/dlnkmgr set -audfac local0 3

3. Creating an HDLM Environment146 # /usr/DynamicLinkManager/bin/dlnkmgr view -sys -audlogAudit Log : on(6)Audit Log Category

3. Creating an HDLM Environment1473.8 Setting up Integrated TracesWhen HDLM is used, the dlnkmgr command logs are output to the integrated trace infor

xiii3.8 Setting up Integrated Traces ...1473.8.1 Notes on Using the

3. Creating an HDLM Environment148If HNTRLib2 has already been installed on a host when you install HDLM, the settings in the trace library will be i

3. Creating an HDLM Environment1491. In the Hitachi Network Objectplaza Trace Library setup menu, type 1 and then press the Enter key.A screen to set

3. Creating an HDLM Environment1502. Enter the desired number in New Number (KB).You can specify a value from 1 to 16. The default is 4. The value set

3. Creating an HDLM Environment1514. In the Hitachi Network Objectplaza Trace Library setup menu, type 5 and then press the Enter key.A screen to set

3. Creating an HDLM Environment1522. Enter a desired interval in New Span (sec).The specifiable range is between 0 and 3600 seconds, with a default of

3. Creating an HDLM Environment153When you specify a monitoring interval of 0 in 6: Lookout span, the value set in New Max (sec) will be disregarded.A

3. Creating an HDLM Environment154Hitachi Dynamic Link Manager# 3. Stop the programs that are using HNTRLib2.If programs other than HDLM are displayed

3. Creating an HDLM Environment1553.9 About the Reservation PolicyThe reservation policy settings are explained in the following table.Table 3-21: Res

3. Creating an HDLM Environment1563.10 Settings for Using HACMPTo use HACMP, install HDLM on all hosts comprising the cluster, configure the hdisks, s

3. Creating an HDLM Environment157Choose the following sequence of menu items to display this window:Communications Applications and Services, HACMP f

xiv4.2.5 Displaying the Correspondences Between hdisks, OS Management Path IDs, and LDEVs...

3. Creating an HDLM Environment1583.10.3 Setting the Reservation PolicyWhen you use HACMP, we usually recommend that you set the reserve_policy attrib

3. Creating an HDLM Environment1593.11 Settings for Using GPFSTo use GPFS or GPFS+RVSD, carry out the following procedure before starting GPFS or GPFS

3. Creating an HDLM Environment1603.12 Settings for Using Oracle RAC 10g or Oracle RAC 11g3.12.1 Settings for MISSCOUNT and DISKTIMEOUTWhen a host and

3. Creating an HDLM Environment161Table 3-25: Formula for Calculating DISKTIMEOUTFor details on how to change MISSCOUNT and DISKTIMEOUT, contact the c

3. Creating an HDLM Environment1624. Execute the following command to display all the activated volume groups. # lsvg -o 5. Among the displayed volume

3. Creating an HDLM Environment1633.13 Settings for Using VCSTo use VCS, install HDLM on all of the hosts that comprise the cluster, and then configur

3. Creating an HDLM Environment164Figure 3-4: Example of Editing the Preonline Script

3. Creating an HDLM Environment1653.14 Uninstalling HDLMThis section explains how to return the HDLM environment to the way it was before HDLM was in

3. Creating an HDLM Environment1663. Execute the following command for the file system used to configure volume groups in the client logical partition

3. Creating an HDLM Environment167for confirmation that processing is to continue.Enter y for this message to continue processing. # /usr/DynamicLinkM

xv6.3.1 Format ...2326.3.2 Parameter...

3. Creating an HDLM Environment168# lsdev -Cc disk 16. If GPFS + RVSD was used, delete the setting information from /etc/vsd/oemdisktypes.lst• If HP X

3. Creating an HDLM Environment169If you are not using a virtual I/O server, uninstallation of HDLM is complete and you do not need to perform the rem

3. Creating an HDLM Environment1702. Execute the following command to activate the volume group that is using the virtual SCSI disk of the HDLM manage

3. Creating an HDLM Environment171# shutdown -F 10. Configure the host and storage system so that only a single path connects the host to the storage

3. Creating an HDLM Environment172 If the KAPL13108-E message is displayed, the hdisk for the device that is managed by HDLM still remains. Re-execute

3. Creating an HDLM Environment173# rm /opt/VRTSvcs/bin/triggers/preonline# haconf -makerw# hagrp -modify service-group PreOnline 0# haconf -dump -mak

3. Creating an HDLM Environment174 3.14.3 Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib2)When you uninstall HDLM, if the KAPL09019-E

3. Creating an HDLM Environment175than HDLM are using HNTRLib2, contact your HDLM vendor or maintenance company if there is a maintenance contract for

3. Creating an HDLM Environment176log files will not be deleted during uninstallation. In this case, delete these files after uninstallation.• Even if

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

 Relevant program products Hitachi Dynamic Link Manager version 6.6For details about applicable OSs, see the Release Notes. TrademarksAIX i

xvi7.10.1 Format... 3337.10.2 Parameters ...

4. HDLM Operation1784.1 Notes on Using HDLMThis section provides notes on using HDLM and using the environment in which HDLM is installed. Make sure t

4. HDLM Operation179message, you can suspend the command.4.1.3 Storage System Start up the storage system before you start up the hosts, so that AIX

4. HDLM Operation1804.1.6 Notes on Enabling Both Primary and Secondary Volumes to Be Viewed From the Same ServerTo enable both primary and secondary v

4. HDLM Operation181To cancel the reservation for the LU, execute the dlmpr utility from a host that can access this LU. For details on this utility,

4. HDLM Operation1824.2 HDLM Operations Using CommandsThis section explains how to use the HDLM command. For details on the various command operations

4. HDLM Operation183(1) Changing the Status of Paths to OnlineTo change the status of paths to online:1. Check the current status of the paths.To chan

4. HDLM Operation184(2) Changing the Status of Paths to Offline(C)To change the status of paths to Offline(C):1. Check the current status of the paths

4. HDLM Operation185# /usr/DynamicLinkManager/bin/dlnkmgr view -path 4.2.4 Viewing LU InformationThis section explains how to display LU information b

4. HDLM Operation186You display this information by executing the HDLM command's view operation with the -drv parameter specified. For details on

4. HDLM Operation187name = clear, completion time = yyyy/mm/dd hh:mm:ss# 3. Check to see whether the statistical information for all the paths has bee

xviiB.3 Changing the HDLM Environment Configuration and Operation Procedures by Changes to the Logical Device Files...

4. HDLM Operation188Audit Log Facility : -KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/m

4. HDLM Operation189To check whether the settings have been applied, see (1) Viewing the Operating Environment.4.2.8 Viewing License InformationThis s

4. HDLM Operation190KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: yKAPL01071-I A permanent license was installed.#

4. HDLM Operation191which the command is executed: # /usr/DynamicLinkManager/bin/dlnkmgr view -sysHDLM Version : x.x.x-xxService P

4. HDLM Operation1924.3 Starting and Stopping the HDLM ManagerIf an error occurs in the system, such as in an HDLM program, you may need to manually s

4. HDLM Operation193The stop script that was set up during HDLM installation runs, and stops the HDLM manager.Use the following dlnkmgr command's

4. HDLM Operation1944.4 HDLM Resident ProcessesTable 4-1: HDLM resident processes lists and describes the resident processes in HDLM. To monitor these

4. HDLM Operation1954.5 Changing the Configuration of the HDLM Operating EnvironmentThis chapter describes the procedures for changing the configurati

4. HDLM Operation196 # /usr/DynamicLinkManager/bin/dlnkmgr view -path If you deleted all devices, check that the following message appears: KAPL01019-

4. HDLM Operation197instead of the dlmchpdattr utility to change the values actually used. The following explains how to use the dlmchpdattr utility t

4. HDLM Operation1985. Execute the following command to make sure that the status of the hdisks recognized as HDLM-managed devices is Available. # lsd

4. HDLM Operation199either step 2 or 6, any changed values will not be applied, even though the lsattr command execution results will show that the ch

4. HDLM Operation200 If the command terminates normally, the KAPL10531-I message is displayed. If the KAPL10531-I message is not displayed, make sure

4. HDLM Operation201• If the execution environment is a boot disk environment:Proceed to step 11.10. Execute the following command to change the hdisk

4. HDLM Operation202Make sure that the changed default value is reflected in the value actually used. # lsattr -El hdisk-name | grep reserve_policyres

4. HDLM Operation203# bootlist -m normal hdisk0 hdisk1 4. Make sure that the boot disk is configured with the specified number of paths.The following

4. HDLM Operation204# lspath -Hl hdisk10 -F "name path_id parent connection"name path_id parent connection hdisk10 0 fscsi4 50060e80

4. HDLM Operation205The following shows an example of executing the command: # bootlist -m normal hdisk0 hdisk1 4. Make sure that the boot disk is con

4. HDLM Operation206Lun Reset : offOnline(E) IO Block : onNPIV Option

4. HDLM Operation207HBA to the LUN security.6. Execute the following command: # diag NoteFor details on the operations after executing the diag comman

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

4. HDLM Operation20812. Go back to the PCI Hot Plug Manager window, select Replace/Remove a PCI Hot Plug Adapter.Select the HBA to be replaced.13. Sel

4. HDLM Operation209procedure when all the following conditions are satisfied#, the volume group cannot be activated after the host is restarted:• The

4. HDLM Operation210For details on path information, see 6.7 view (Displays Information).7. Execute the utility for clearing HDLM persistent reservati

4. HDLM Operation211hdisk10 blv=hd5hdisk0 blv=hd5hdisk1 blv=hd5...4.5.5 Replacing a Fiber CableIf there are multiple active paths for an LU, you can r

4. HDLM Operation212• If the NPIV option is set to on:Use the fscsi number to execute the command below. The following example shows how to place the

4. HDLM Operation213# /usr/DynamicLinkManager/bin/dlnkmgr view -path For details about path information, see 6.7 view (Displays Information).4.5.6 Rep

4. HDLM Operation214Check the NPIV Option line.3. Place in Offline (C) status the path that goes through the Fibre Channel switch to be replaced.Depen

4. HDLM Operation2156. Delete the HBA device associated with the Fibre Channel switch that is to be replaced. # rmdev -dl fscsin -R 7. Replace the Fib

217Chapter5. TroubleshootingThis chapter describes how to check HDLM error information, and how to take action if an error occurs in HDLM. Description

1. Overview of HDLM21.1 What is HDLM?The widespread use of data warehousing and increasing use of multimedia data have increased the need for high-spe

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

5. Troubleshooting2195.2 Checking error information in messagesWhen you want to configure the system so that HDLM messages are output to syslog, speci

5. Troubleshooting220The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the

5. Troubleshooting2215.3 What To Do for a Path ErrorWhen a path error is detected, HDLM performs a failover on the path and outputs the KAPL08022-E me

5. Troubleshooting222Figure 5-2: Troubleshooting procedure when a path error occursThe following shows the procedure for using the HDLM command (dlnkm

5. Troubleshooting2235.3.3 Identifying the Error PathCheck the obtained path information to find the path with the error. In the Status column, the er

5. Troubleshooting2245.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. Troubleshooting2255.4.3 What To Do for the Program ErrorFollow the recommended actions for messages in 8. Messages.If the error occurs again after

5. Troubleshooting2265.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

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

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

6. Command Reference2286.1 Overview of the HDLM Command dlnkmgrThis section describes command formats and operations used for HDLM.Command formatEnter

6. Command Reference229• Execute the command as a user with root permissions.• To specify a value that contains a space in its parameter, enclose the

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

6. Command Reference231(2) To Display the Format of the Clear Operation-helpDisplays the format of the clear operation.Example # /usr/DynamicLinkManag

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

6. Command Reference233 # /usr/DynamicLinkManager/bin/dlnkmgr help online offline helponline: Format dlnkmgr online [-path] [-s] dlnkmgr online

6. Command Reference234 Format dlnkmgr help { clear | offline | online | set | view }KAPL01001-I The HDLM command completed normally. Operation na

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

6. Command Reference236-hba HBA-adapter-number.bus-numberOr-hba adapter-type.adapter-numberUse this parameter to place offline, at one time, all the p

6. Command Reference237ExampleThe following example shows how to place offline all paths connected to the HBA port whose HBA-port-ID is 00001. # /usr/

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 Reference238port will be changed to the Offline(C) status. Is this OK? [y/n]:yKAPL01056-I If you are sure that there would be no problem wh

6. Command Reference239AutoPATH_IDs are re-assigned every time the host is restarted. When you want to add a new LU without restarting the host, AutoP

6. Command Reference240The following example shows how to place a path, whose AutoPATH_ID is 000001, offline without asking for confirmation of comman

6. Command Reference241connected to a specific HBA port or CHA port.Example 1The following example shows how to filter and display the information on

6. Command Reference2426.5 online (Places Paths Online)The dlnkmgr command's online operation places offline paths online. Specify the paths to b

6. Command Reference243-hba adapter-type.adapter-numberUse this parameter to place online, at one time, all the paths that pass through a specific HBA

6. Command Reference244port will be changed to the Online status. Is this OK? [y/n]:yKAPL01061-I 15 path(s) were successfully placed Online; 0 path(s)

6. Command Reference245 # /usr/DynamicLinkManager/bin/dlnkmgr view -cha For details about how to execute the view operation to display the CHA port ID

6. Command Reference246# /usr/DynamicLinkManager/bin/dlnkmgr view -luFor details on how to execute the view operation and display the host device name

6. Command Reference247 # /usr/DynamicLinkManager/bin/dlnkmgr online -helponline: Format dlnkmgr online [-path] [-s] dlnkmgr online [-path]

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

6. Command Reference248The following example shows how to filter and display the information on all paths that pass through the CHA port 0A of the Thu

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

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

6. Command Reference251rr: The Round Robin algorithmexrr: The Extended Round Robin algorithmlio: The Least I/Os algorithmexlio: The Extended Least I/O

6. Command Reference252KAPL01001-I The HDLM command completed normally. Operation name = set, completion time = yyyy/mm/dd hh:mm:ss#-elfs error-log-fi

6. Command Reference253time before existing information is overwritten becomes shorter.-systfs trace-file-sizeSpecify the size of the trace file in ki

6. Command Reference254The previously specified intervalThe explanation for the following sub-parameter describes how to specify the checking interval

6. Command Reference255When you specify on, specify the checking interval by specifying the parameter immediately following on. If you do not specify

6. Command Reference256number-of-times-error-is-to-occur] | off }Enables or disables intermittent error monitoring.on: Enabledoff: DisabledIntermitten

6. Command Reference257The following shows the sub-parameters that should be specified: the error monitoring interval and the number of times that the

2. HDLM Functions62.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

6. Command Reference258when -iem off is specified and intermittent error monitoring is disabled. Therefore, when you re-enable intermittent error moni

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

6. Command Reference260#2Because automatic failback is off, intermittent error monitoring is disabled.ExampleThe following example shows how to monito

6. Command Reference261#A temporary license key cannot be installed by using the dlnkmgr set operation.Example 1The following example shows how to upd

6. Command Reference262Specifies the severity level of audit log data to be collected. Table 6-7: Values Indicating Audit Log Data Collection Levels d

6. Command Reference263Table 6-9: Values of the Audit Log Facility-sExecutes the command without displaying the message asking for confirmation of com

6. Command Reference264 | -elfn Number-Of-ElogFiles | -systflv TraceLevel | -systfs TraceFileSize

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

6. Command Reference2666.7 view (Displays Information)The view option displays HDLM program information, path information, LU information, HBA port in

6. Command Reference267[-srt {lu|cp}][-t](3) To Display LU InformationTo display LU information/usr/DynamicLinkManager/bin/dlnkmgr view -lu[-hdev host

2. HDLM Functions72.2 System ConfigurationHDLM manages routes between a host and a storage system by using the SCSI driver. The host and storage syste

6. Command Reference268(1) To Display Program Information(2) To Display Path Information(3) To Display LU Information(4) To Display HBA Port Informati

6. Command Reference269Load Balance Settings for load balancing• Setting status:on: Enabledoff: Disabled• AlgorithmWhen the setting status of load bal

6. Command Reference270Path Health Checking• Settings for path health checking:on: Enabledoff: Disabled• Checking interval:When the setting of the pat

6. Command Reference271WakeupTime Startup time of the HDLM alert driverElogMem Size Size of error log memory for the HDLM alert driver in kilobytes-pd

6. Command Reference272#When you use cluster software, the settings of the cluster support function and the product name of the cluster software is no

6. Command Reference273#Example 2The following example shows how to display information about the HDLM manager. # /usr/DynamicLinkManager/bin/dlnkmgr

6. Command Reference274Example 6The following example shows how to display information about the audit log settings: # /usr/DynamicLinkManager/bin/dln

6. Command Reference275Use this parameter to display the model ID of the storage system in the product ID element of the DskName field. When this para

6. Command Reference276Parameters to display path information by selecting a display item:-path -itemWhen you specify the -path parameter together wit

6. Command Reference277#Because both PathID and Status are always displayed, you do not have to specify any parameters. In the sub-parameters followin

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

2. HDLM Functions8Figure 2-1: HDLM System ConfigurationTable 2-1: HDLM System Components lists the HDLM system components.Table 2-1: HDLM System Compo

6. Command Reference278storage system (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is Aut

6. Command Reference279To display a summary of path information-path -cIf the -c parameter is specified at the same time as the -path parameter, only

6. Command Reference28011 or more characters in the product ID, the 8th and following characters are abbreviated to ellipses (...). The sub-parameters

6. Command Reference281Displayed path informationTable 6-12: Displayed Path Information describes the displayed path information. The following explai

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

6. Command Reference283iLU#iLU LU number of the storage systemThis number combined with the storage system name (shown in DskName) identifies the LU t

6. Command Reference284Legend:-: Not displayedIO-Count#- Total I/O count for the path, indicated by a decimal number. The maximum value that can be di

6. Command Reference285#The path information is displayed only when a value is specified for the -path -item parameter.Table 6-13: Elements of a Path

6. Command Reference286Table 6-14: Product ID Displayed by the View -Path Operation#Model names of storage systemsProduct IDWithout the -stname parame

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

2. HDLM Functions9Path A route that connects a host and a Dev.Components Description

6. Command Reference288 iLU HDevName OSPathID PathID Status003A hdisk0 00000 000000 Online 00001 000001 Online003B hdisk1 0000

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

6. Command Reference290To display a summary of LU information-lu -cWhen the -c parameter is specified with the -lu parameter, a summary of LU configur

6. Command Reference291You cannot specify the -c parameter together with the -hdev or -pathid parameter.For details on the contents of each display it

6. Command Reference292Table 6-16: Items That Can Be Added by Using the -lu -c -item Parameter and Sub-parametersThe sub-parameter is:-tOmits the titl

6. Command Reference293Table 6-17: Displayed LU InformationDisplayed item DescriptionNo summary displayedSummary displayedProduct Model ID of the stor

6. Command Reference294PathName#1- The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you sho

6. Command Reference295IO-Count#1- Total I/O count for a path. The maximum value that can be displayed is 232 - 1 (4294967295). If the total I/O count

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

6. Command Reference297Example# /usr/DynamicLinkManager/bin/dlnkmgr view -hbaHbaID Port.Bus IO-Count IO-Errors Paths OnlinePaths00000 08.11

2. HDLM Functions102.3 LU ConfigurationOn a system using HDLM, the logical device file for the HDLM management-target device is used to access the tar

6. Command Reference298ExampleThe subsequent sub-parameters are:-srt cpSorts the CHA port information by the storage system model IDs (Product), stora

6. Command Reference299and information about the LDEVs in a storage system (identified by the storage system model ID, serial number, and LU number, s

6. Command Reference300(7) To Display the Format of the View Operation-helpUse this parameter to display the view operation format.ExampleThe followin

6. Command Reference301KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss#

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

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

7. Utility Reference305that includes HDLM-managed devices.For details about the dlmpostrestore utility, see 7.8 dlmpostrestore Utility for HDLM Restor

7. Utility Reference306number of LUs and paths.Table 7-1: Examples of the Starting Time of the Host and the Execution Time of the Utilities lists exam

7. Utility Reference307The number of LUs is 256.#3The execution environment is as follows:Machine Spec: CPU: Power4 1200MHz x 2

2. HDLM Functions11Table 2-2: Components recognized by the hostComponents DescriptionHLU An LU that the host recognizes via the HDLM driver. It is cal

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

7. Utility Reference309Specify the output directory for the information that is to be collected by the DLMgetras utility for collecting HDLM error inf

7. Utility Reference310files in that directory, including files contained in the directory's subdirectories. If no files are found in a specified

7. Utility Reference311This file is output only when using the Hitachi Command Suite products that is the target for collecting error information.•get

7. Utility Reference312opt/hitachi/HNTRLib2/mmap hntr2mmap.mm Memory mapped file (HNTRLib2)integrated-trace-file-output-directory-specified-in-the-Hit

7. Utility Reference313bootinfo.txt Information about the operation mode of the kernel (32/64 bit) and multi-CPU supportbootlist-v.txt List of boot de

7. Utility Reference314env.txt Environment variable fileerrpt-a.txt Error log edit filegenkex.txt Information of loaded drivershacmp.txt Information o

7. Utility Reference315#1An output directory is created in the specified directory when you open the getras.tar.Z file.#2In the actual file name, a fi

7. Utility Reference3167.3 dlmchpdattr Utility for Changing HDLM Default SettingsThis utility changes the default value for the hdisk attribute.By cha

7. Utility Reference317multiple pairs, separate them by using a space, and enclose the list of pairs in double quotation marks (").Table 7-3 show

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

7. Utility Reference318-oDisplays the current value set for the reservation policy.-hDisplays the format of the dlmchpdattr utility.Notes• Before you

7. Utility Reference3197.4 dlmgetrasinst Utility for Collecting HDLM Installation Error InformationThis utility collects information that is needed to

7. Utility Reference320 7.4.3 List of Collected Error InformationTable 7-4: Information Stored in the getrasinst.tar.Z File shows the error informatio

7. Utility Reference321CuVPD.txt Information of Object Database Managerdisk.txt List of disks in the /dev directorydlmls-la.txt HDLM directory informa

7. Utility Reference322#An output directory is created in the specified directory when you open the getrasinst.tar.Z fileulimit-a.txt Limits on system

7. Utility Reference3237.5 dlminstcomp Utility for HDLM Component InstallationThis utility complements HDLM installation.Execute this utility when bot

7. Utility Reference3247.6 dlmmigsts Utility for Assisting HDLM MigrationThis utility saves HDLM program information and the HDLM execution environmen

7. Utility Reference325-odm odm-environment-settings-file-nameSpecifies the file name in which the ODM environment settings are defined.Specify the fi

7. Utility Reference3267.7 dlmodmset Utility for Setting the HDLM Execution Environment ODMThis utility sets ODM to define HDLM operations.7.7.1 Forma

7. Utility Reference327parameter.NoteWhen this parameter is set to on, I/O access to the Online(E) path will be suppressed, so I/O success will automa

2. HDLM Functions13Table 2-3: Functionality of HDLM ProgramsProgram name FunctionsHDLM command Provides the dlnkmgr command, which enables you to:• Ma

7. Utility Reference328# /usr/DynamicLinkManager/bin/dlmodmset -hUsage : dlmodmset {{-r {on | off} | -i {on | off} |

7. Utility Reference3297.8 dlmpostrestore Utility for HDLM Restoration SupportThis utility updates HDLM information to match that of the target system

7. Utility Reference3307.9 dlmpr Utility for Clearing HDLM Persistent ReservationThe persistent reservation of a logical unit (LU) may not be canceled

7. Utility Reference331Specify the hdisk for which you want to display or clear the Reservation Key. You can specify more than one volume.If you omit

7. Utility Reference332In the following example, the utility displays Help:# /usr/DynamicLinkManager/bin/dlmpr -hUsage : dlmpr {{ -k | -c } [hdisk-nam

7. Utility Reference3337.10 dlmpreuninst Utility for Executed Before Uninstalling HDLMThis utility excludes the hdisk recognized as a boot disk from b

7. Utility Reference3347.11 dlmrmdev Utility for Deleting HDLM DriversThis utility deletes hdisks or changes the status of hdisks to Defined according

7. Utility Reference335inactivates the volume group used by HDLM, and deletes all the hdisks recognized as HDLM management-target devices:# /usr/Dynam

7. Utility Reference3367.12 installhdlm Utility for Installing HDLMThis utility is used to execute an unattended installation when a new installation,

7. Utility Reference337Table 7-5: Keys in the [INSTALLATION_SETTINGS] SectionKey name#1Description#2Necessity of definitionMaximum number of character

2. HDLM Functions142.5 Position of the HDLM Driver and hdiskThe HDLM driver is positioned above the SCSI driver and is an add-in module of MPIO driver

7. Utility Reference338Legend:Optional: If a key and its setting are not specified, the default value will be used.However, for an upgrade installatio

7. Utility Reference339If none of these files exist when you attempt to perform a new installation, unattended installation ends with an error.#4When

7. Utility Reference340Enter one key and one setting per line.#2If the value is not of an allowable type, an error will occur.[ODM_SETTINGS] sectionDe

7. Utility Reference341• For a new installation:The default value will be used.• For an upgrade installation or re-installation:The previous setting w

7. Utility Reference342load_balance_type Specify one of the following values to indicate the load balancing algorithm:rr: The Round Robin algorithmexr

7. Utility Reference343Legend:path_health_check Specify one of the following values to indicate whether to enable or disable the path health check fun

7. Utility Reference344Optional: If a key and its setting are not specified, one of the following values will be used:• For a new installationThe defa

7. Utility Reference345[DISK_DEFAULT_SETTINGS] reserve_policy=PR_exclusive[ODM_SETTINGS] odm_lun_reset=off odm_online_e_io_block=off odm_npiv_option=o

7. Utility Reference346Therefore, delete the original installhdlm.log manually if it is no longer required.• If the installhdlm.log file cannot be out

7. Utility Reference3477.13 installux.sh Utility for HDLM Common InstallerThis utility determines what OS HDLM will be installed on, and installs the

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

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

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

8. Messages3518.1.3 Components that Output Messages to syslogSome messages for the following components are output to syslog:• HDLM manager• HDLM driv

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

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

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

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

8. Messages356-cha), and check the target CHA port and the CHA ID of that CHA port. Then, specify the applicable CHA ID, and retry the operation. For

8. Messages357the DLMgetras utility, see 7.2 DLMgetras Utility for Collecting HDLM Error Information.KAPL01021-ECannot execute the HDLM command due to

2. HDLM Functions16When the load balancing function is not being used, I/O operations converge on one physical path (A). The load on the physical path

8. Messages358KAPL01039-WDuring the online operation processing of the HDLM command, a path that cannot be placed in the Online status was detected. P

8. Messages359bb...bb: Parameter namecc...cc: Duplicate parameter valueActionDelete the duplicate parameter value, and then retry.KAPL01045-WToo many

8. Messages360Statistics to the Initial Value). For details on the set operation, see 6.6 set (Sets Up the Operating Environment).KAPL01050-IThe curre

8. Messages361KAPL01053-IIf you are sure that there would be no problem when the path is placed in the Offline(C) status, enter y. Otherwise, enter n.

8. Messages362KAPL01056-IIf you are sure that there would be no problem when all the paths which pass the specified aa...aa are placed in the Offline(

8. Messages363see 6.3 help (Displays the Operation Format).KAPL01059-WCannot specify the parameter aa...aa at the same time if you specify parameter b

8. Messages364dd...dd: online, or offlineActionNone. For details on the online operation, see 6.5 online (Places Paths Online). For details on the off

8. Messages365was entered three times in a row.ActionObtain a valid license key, and then retry.KAPL01071-IThe permanent license was installed.Details

8. Messages366The license information file is missing.ActionRe-install HDLM.KAPL01076-IThe permanent license has been installed.DetailsYou need not in

8. Messages367Set the intermittent error-monitoring interval to a value that is equal to or greater than (automatic-failback-checking-interval x numbe

2. HDLM Functions17(1) When Using the Thunder 9500V Series, or Hitachi AMS/WMS SeriesWhen HDLM performs load balancing, it differentiates between load

8. Messages368KAPL01084-WAn attempt to delete the license key file has failed. File name = aa...aaDetailsaa...aa: /var/tmp/hdlm_licenseActionIf a lice

8. Messages369KAPL01095-EAn attempt to acquire the HDLM version information has failed. details = aa...aaDetailsaa...aa: Code showing the reason for t

8. Messages370None.KAPL01101-WThe target HBA port was not found. Operation name = aa...aaDetailsThe HBA having the HBA_ID specified in the -hbaid para

8. Messages371DetailsMultiple paths will be collectively placed Online because the -hbaid or -chaid parameter was specified. To collectively place mul

8. Messages372Restart the HDLM Manager, and execute the dlnkmgr view -sys -audlog command, and then specify the desired setting by using the dlnkmgr s

8. Messages373ActionContact your HDLM vendor or maintenance company if there is a maintenance contract for HDLM.KAPL01119-WAn error occurred during pr

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

8. Messages375aa...aa: API trace error informationActionExecute the DLMgetras utility for collecting HDLM error information, and then contact your HDL

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

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

2. HDLM Functions18Figure 2-7: Overview of load balancing(2) When Using the Lightning 9900V Series, Hitachi USP, Universal Storage Platform V/VM, Virt

8. Messages378aa...aa: Option definition file nameActionCheck whether another program is currently using this file (for example, the file is being ope

8. Messages379KAPL04012-ECould not create a communication pipe. RC = aa...aaDetailsHDLM manager could not start normally because it was unable to crea

8. Messages380DetailsAn attempt to read the log information from the alert driver failed.aa...aa: API return code (decimal (base-10) number)ActionExec

8. Messages381Utility for Collecting HDLM Error Information.KAPL04024-CA critical error occurred in the HDLM manager. (aa...aa)DetailsThis information

8. Messages382KAPL04028-EThe temporary license expired.ActionInstall a permanent license.KAPL04029-EThe emergency license expired.ActionInstall a perm

8. Messages383KAPL04034-EAn attempt to create the option definition file has failed.DetailsAn attempt to re-create an option definition file (/usr/Dyn

8. Messages384DetailsAll the paths that path health checking examined are fine.aa...aa: Start or stopActionNone.KAPL04045-IHDLM SNMP TRAP was sent. Tr

8. Messages3858.5 KAPL05001 to KAPL06000KAPL05003-IThe HDLM driver (filter component) was successfully attached to Disk (aa...aa), Partition (bb...bb)

8. Messages386cc...cc: Error code (hexadecimal number)dd...dd: Filter driver management table address (hexadecimal number)ActionCheck whether the HDLM

8. Messages387ActionNone.KAPL05023-ECould not process the IOCTL(aa). (aa:cc) Check the message of the HDLM command or the HDLM manager, and then take

2. HDLM Functions19• The Extended Least Blocks algorithmThe above algorithms are divided into two categories, which differ in their processing method.

8. Messages388DetailsThe filter driver outputs this message for maintenance.aa...aa: Device minor numberbb...bb: Message output location informationcc

8. Messages3898.6 KAPL06001 to KAPL07000KAPL06003-IInitialization of the HDLM alert driver (aa...aa) was successful.DetailsInitialization of the alert

8. Messages390processed by the alert driver.bb...bb: error code (hexadecimal number)cc...cc: 0 (fixed)ActionCheck the message of the HDLM command (dln

8. Messages391When a log output request was made from the filter driver, the log information was discarded because of a memory allocation failure. Alt

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

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

8. Messages394ee...ee: Target ID (hexadecimal number)ff...ff: Host LU number (same as PathName of view -path) (hexadecimal number)gg...gg: Dev number

8. Messages395to the target LU.KAPL08027-EA path was excluded from the items subject to automatic failback. PathID = aa...aaDetailsA path was excluded

8. Messages3968.9 KAPL09001 to KAPL10000KAPL09003-ECannot install in this system. Install HDLM on a supported OS.DetailsHDLM cannot be installed on th

8. Messages397ActionManually cancel the PP name registration, and then uninstall Hitachi Network Objectplaza Trace Library 2. If the attempt to cancel

2. HDLM Functions20Table 2-4: Features of the Load Balancing Algorithms#Some I/O operations managed by HDLM can be distributed across all paths, and s

8. Messages398A target file to copy to the directory of Hitachi Command Suite products other than HDLM could not be found among the files related to H

8. Messages399DetailsAn attempt to install HNTRLib2 failed.ActionContact your HDLM vendor or the maintenance company if there is a maintenance contact

8. Messages400KAPL09077-IThe temporary license was installed. The license expires on aa...aa.DetailsA temporary license was installed.aa...aa: Year (4

8. Messages401aa...aa: Year (4 digits)/month (01-12)/day (01-31)ActionInstall a permanent license by the expiration day.KAPL09082-WThe temporary licen

8. Messages402KAPL09091-EA fatal error occurred in HDLM. The system environment is invalid. Contact your HDLM vendor or the maintenance company if the

8. Messages403There is no HDLM-installable license key in the license key file.aa...aa: /var/tmp/hdlm_licenseActionMake sure that the license key file

8. Messages404use the output name, use the output command to overwrite or re-install.KAPL09135-EOne of the following was executed at the same time as

8. Messages405KAPL09171-EAn internal error occurred in the installation of the HDLM. Error Code = aa...aa bb...bbDetailsA system-based error, not caus

8. Messages406None.KAPL09187-WNo parameter is specified.DetailsNo installation-information settings file has been specified in the installhdlm utility

8. Messages407KAPL09210-Iaa...aa will now start.Detailsaa...aa has just started.aa...aa: installhdlm, installp, cfgmgr, dlmodmset, dlnkmgr, or dlmrmde

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

8. Messages408Check the error message that was output just before this message, and then perform the action indicated in that error message.KAPL09214-

8. Messages409If the error code is 6:You do not have write permission for the file system of the /var/tmp or /var/DLM directory. Make sure you have ac

8. Messages410required, see 3.5.8 Performing an Unattended Installation of HDLM.KAPL09217-EAn error occurred during reading of the installation inform

8. Messages411KAPL09219-EAn internal error occurred in the installhdlm_analysis. Error Code = aa...aa,bb...bbDetailsAn internal error occurred in the

8. Messages412KAPL09227-WThe definition of the installation information settings file includes an invalid key. Error Code = aa...aa,bb...bb, line = cc

8. Messages413operation.KAPL09230-WThe definition of the installation information settings file includes a duplicated section name. Error Code = aa...

8. Messages414Specify the revised installation information settings file and then retry the operation.KAPL09233-WThe definition of the installation in

8. Messages415If the error code is 2:You do not have write permission for the log file destination directory. Modify your access permissions as necess

8. Messages416If the status of HDLM is not COMMITTED:Perform uninstallation or cleanup according to the displayed status. If an uninstallation or clea

8. Messages417If the error code is 200:Execute dlminstcomp utility.If any other error code is output:Contact your HDLM vendor or the maintenance compa

2. HDLM Functions22For details on error levels, see 2.10.2 Filtering of error information.When the Thunder 9500V series, or Hitachi AMS/WMS series is

8. Messages418Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM.KAPL09248-WA parameter is invalid. param

8. Messages419all of the DVD-ROM files.KAPL09603-EThe installation will now stop because a command or utility cannot be executed. Confirm that the com

8. Messages4208.10 KAPL10001 to KAPL11000KAPL10001-WNo parameter has been specified.DetailsNo directory to which the collected information will be out

8. Messages421ActionCheck the parameters of the DLMgetras utility for collecting HDLM error information, and then retry. For details on the DLMgetras

8. Messages422DetailsYou do not have write permission for the specified directory, or the creation of a subdirectory of the specified directory failed

8. Messages423Two or more file names or directory names exist in the file for defining the information to be collected.aa...aa: Line number of the fil

8. Messages424number)bb...bb: Indicated contents in a lineActionAfter the DLMgetras utility for collecting HDLM error information terminates, check th

8. Messages425KAPL10016-WThe root directory has been specified in the first parameter.DetailsA root "/" cannot be specified in a directory t

8. Messages426utility, see 7.2 DLMgetras Utility for Collecting HDLM Error Information.KAPL10022-IThe utility for collecting HDLM error information co

8. Messages427DetailsNo file to collect information exists.aa...aa: File to collectActionNone.KAPL10034-EThe file could not be copied. Filename = aa..

2. HDLM Functions23Figure 2-8: Path switching(2) Priority of Switching Destination PathsPriority of paths varies depending on the architecture of the

8. Messages428See the details in the message, and then remove the cause of the error. For information about the error, collect the archive in the outp

8. Messages429Detailsaa...aa: failed file system (character string)ActionMake sure of the status of the failed file system and then re-execute the pro

8. Messages430ActionNone.KAPL10527-IAn attempt to inactivate the volume group has succeeded. (volume group = aa...aa)Detailsaa...aa: volume group succ

8. Messages431None.KAPL10532-EThe status of one or more HDLM drivers could not be changed to "Defined".ActionCheck the hdisk status and re-e

8. Messages432DetailsExecuting the dlmpostrestore utility will reboot the host.ActionTo execute dlmpostrestore utility, enter y.If you do not want to

8. Messages433ActionIf the error code is 3.1:Confirm that all of the processes and services that use HDLM managed paths have stopped. After confirming

8. Messages434KAPL10573-WA parameter is invalid. parameter = aa...aaDetailsAn invalid parameter is specified.aa...aa: The specified parameterActionWit

8. Messages435ActionWith the -h parameter specified, execute the dlmchpdattr utility. Make sure that the format of the utility is correct, and then re

8. Messages436DetailsThe dlmchpdattr utility has been stopped because an invalid response was sent three times consecutively to a request.ActionTo exe

8. Messages437execution permissions for the dlmrmdev utility. Check the status of the dlmrmdev utility.If the error code is 6,2 or 7,-1:The bosboot co

2. HDLM Functions24This sub-section explains these keys.Path priority numberThis number indicates the priority level set for each path. Priority level

8. Messages438aa...aa: Specified parameter valueActionSpecify an ODM that has been installed, and then retry the operation.KAPL10588-WA duplicate attr

8. Messages439KAPL10644-WThe specified parameters cannot be specified at the same time. parameter = aa...aaDetailsThe specified parameters cannot be s

8. Messages440ActionIf a message with Error Code = 35 is output, check for the hdisk was deleted. If the hdisk was deleted, recover the state of the h

8. Messages441The dlmpr utility has been terminated because n was sent to a request.ActionNone.KAPL10652-EThe entered value is invalid. The operation

8. Messages442DetailsThe dlmodmset utility completed normally.ActionNone. For details on the dlmodmset utility, see 7.7 dlmodmset Utility for Setting

8. Messages443Contact your HDLM vendor or the maintenance company if there is a maintenance contract for HDLM. For details on the dlmodmset utility, s

8. Messages444DetailsNo operation has been specified.ActionExecute help of the dlmodmset utility to check the operations that can be specified, and th

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

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

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

2. HDLM Functions25node_name 0x50060e8005271720 FC Node Name Falsestate Enabled N/A Truepriority 5 N/A

8. Messages448None.KAPL11907-IXML reception - aa...aaDetailsThis information is required for resolving problems.aa...aa: XML informationActionNone.KAP

8. Messages4498.12 KAPL13001 to KAPL14000KAPL13001-IThe dlmmigsts utility completed successfully.ActionNone.KAPL13002-EThe dlmmigsts utility ended abn

8. Messages450utility, see 7.6 dlmmigsts Utility for Assisting HDLM Migration.KAPL13008-WA parameter is invalid. parameter = aa...aaDetailsaa...aa: Pa

8. Messages451KAPL13012-WToo many parameters have been specified.ActionSpecify the -h option in the HDLM migration support utility, confirm the option

8. Messages452Migration. For details on the dlmodmset utility, see 7.7 dlmodmset Utility for Setting the HDLM Execution Environment ODM.If parameter =

8. Messages453KAPL13021-EThe file dlnksetfile was not restored.ActionCheck file name, and then try again.KAPL13101-IThe dlmpreuninst utility completed

8. Messages454KAPL13107-IThe user stopped the operation.DetailsThe dlmpreuninst utility has been terminated because n was sent to a request.ActionNone

8. Messages455Execute the dlmrmdev command, and then re-execute the dlmpreuninst. For details about the dlmrmdev utility, see 7.11 dlmrmdev Utility fo

8. Messages456DetailsAn internal error occurred during processing to read the audit log configuration file.ActionContact your HDLM vendor or the maint

8. Messages4578.13 KAPL15001 to KAPL16000KAPL15001-IThe registered value of ReserveKey was successfully displayed. Command Line = aa...aaDetailsaa...a

2. HDLM Functions26The obtained physical location code is in the Uaa.bb-Pcc-Idd format. The first letters, Uaa.bb, depend on the model of the host. HD

8. Messages458aa...aa: Name of the utility that the user executedKAPL15060-IDLMgetras was invoked. Command Line = aa...aaDetailsaa...aa: Name of the u

8. Messages459Detailsaa...aa: Name of the utility that the user executedKAPL15101-IClear operation was completed successfully. Command Line = aa...aaD

8. Messages460KAPL15107-IProgram information was successfully displayed. Command Line = aa...aaDetailsaa...aa: Command that the user executedKAPL15108

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

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

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

8. Messages464HDLM Error Information.1034DetailsAn attempt to acquire information about the HDLM version or SP version has failed.ActionRe-execute the

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

8. Messages466utility, see 7.2 DLMgetras Utility for Collecting HDLM Error Information.

467AppendixesA. Functional Differences Between Versions of HDLMB. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or EarlierC. Glossar

2. HDLM Functions27then HDLM automatically places the recovered path online while a non-owner path is in use, the path will be automatically switched

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

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier469B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier470B.2 Simplifying the HDLM Environment Configuration and Operation Proce

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier471• 4.6.1 Notes on changing the configuration of the HDLM operating envi

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier472• dlmcfgmgr utility for managing the HDLM configurationIn HDLM version

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier473• Settings when GPFS is used• Replacement of HBA• Changing HDLM manage

B. Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier474The dlmpreuninst utility excludes, before you uninstall HDLM, the hdis

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

C. Glossary476DDev (Device)A logical division of an LU that HDLM controls and operates. A Dev is equivalent to a logical volume in AIX.In an AIX envir

C. Glossary477configurations where the host and storage units are connected via a FC connection.HDLM alert driverA program that receives information a

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

2. HDLM Functions28other paths that run through the same physical path are switched.Executing the online operation places the offline path online. For

C. Glossary478LU. HDLM uses this value to identify a particular LU.load balancingA function for distributing the load across all the paths that are ac

C. Glossary479(See also: owner path, non-owner controller)OODM (Object Data Manager)An AIX-dedicated database for managing system information. HDLM us

C. Glossary480path nameThe path name consisting of the following four elements, separated by periods:• HBA adapter number or adapter type (character s

C. Glossary481slot numberA value indicating the location of a slot on which a HBA is mounted.SLPR (Storage Logical Partition)A function supported by H

483IndexAabbreviations defined iiactive host 55adapter number 285adapter type 285adapter number 72adapter type 72audit logcategories and audit events

Index484Displayed program information 268displayinginformation 266LU information 287path information 266, 274path information (by selecting a display

Index485path error 221HBA 8host bus adapterreplacing 205HBA (Host Bus Adapter) 476HBA adapter number 285HDev 11HDevName 220HDLMfeatures 4functions 5in

Index486definition 27I/Ocount 230errors 230KKB meaning xkernel modeswitching 81LLB 350LDEV (Logical Device) 477load balancing 4, 15, 250, 478load bala

Index487commands 228HDLM 1owner controller 17, 479owner path 17, 479PP8path 7, 479checking the configuration 134path errorhandling 221path health chec

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

Index488system configuration 7Ttaking actions forhardware error 223program error 224, 225target ID 285TB meaning xtrace file 41trace file size 253trac

2. HDLM Functions30Figure 2-9: Path status transitionsLegend:Online operation: Online operation performed by executing the dlnkmgr command's onli

2. HDLM Functions31Offline(C).• All the paths connected to an LU have been determined to have an intermittent error.• The processing of continuous I/O

2. HDLM Functions322.8 Monitoring intermittent errors (functionality when automatic failback is used)An intermittent error refers to an error that occ

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

2. HDLM Functions34(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 Functions35(3) When the conditions for an intermittent error are changed during error monitoringWhen the conditions for an intermittent error

2. HDLM Functions36path, check the IEP item displayed when the dlnkmgr command's view -path operation is executed with the -iem parameter. If a n

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

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

2. HDLM Functions382.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 Functions392.10 Error managementFor troubleshooting purposes, HDLM collects information and stores it into log files. The error information to

2. HDLM Functions40Figure 2-13: Flow of Data When Collecting Error InformationLogs might be collected in layers below HDLM, such as for the HBA driver

2. HDLM Functions412.10.1 Types of Collected LogsHDLM collects information on the detected error and trace information in the integrated trace file, t

2. HDLM Functions42#When you want to configure the system so that HDLM messages are output to syslog, specify user for the facility in the /etc/syslog

2. HDLM Functions43• Collects no error information.• Collects error information at the Error level and higher.• Collects error information at the Warn

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

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

2. HDLM Functions46Table 2-10: Categories and Audit Events that Can Be Output to the Audit LogCategory Explanation Audit event Severity#1Message IDSta

2. HDLM Functions47Setup of the operating environment was successful.6 KAPL15105-ISetup of the operating environment failed.3 KAPL15106-EAn attempt to

iiiGlobal Link Manager Hitachi Global Link ManagerGPFS General Parallel File SystemHACMP High Availability Cluster Multi-ProcessingA generic term for:

2. HDLM Functions48#1The severity levels are as follows:3: Error, 4: Warning, 6: Informational#2If you use Ctrl + C to cancel the DLMgetras utility fo

2. HDLM Functions49For details on how to enable syslog, see 2.11.3 Destination and Filtering of Audit Log Data or the AIX documentation.• You might ne

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

2. HDLM Functions51Table 2-12: Items Output in the Message SectionItem#ExplanationCommon identifier Fixed to CELFSSCommon specification revision numbe

2. HDLM Functions52#: 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 Functions532.12 Integrated HDLM management using Global Link ManagerBy using Global Link Manager, you can perform integrated path management o

2. HDLM Functions54Figure 2-14: Example System Configuration Using HDLM and Global Link Manager

2. HDLM Functions552.13 Cluster supportHDLM can also be used in cluster configurations.HDLM supports the cluster software listed below.• GPFS• HACMP•

57Chapter3. Creating an HDLM EnvironmentThis chapter describes the procedures for creating an HDLM environment and for canceling the setup.Make sure t

ivHitachi WMS Hitachi Workgroup Modular Storage seriesHP XP128 HP StorageWorks XP128 Disk ArrayHP XP1024 HP StorageWorks XP1024 Disk ArrayHP XP10000 H

3. Creating an HDLM Environment583.1 HDLM System RequirementsCheck the following before installing HDLM.For OS patches and software provided by OS ven

3. Creating an HDLM Environment59#1Every SP is applicable, unless otherwise specified.#2To set up a boot disk environment that uses Thunder 9500V seri

3. Creating an HDLM Environment60HTC_ODM 5.0.52.1 or laterIf you are using the following storage systems, use HTC_ODM 5.0.52.1 or later:• Hitachi AMS

3. Creating an HDLM Environment61• HP XP128/HP XP1024/HP XP10000/HP XP12000/HP XP20000/HP XP24000• Thunder 9500V series• Lightning 9900V series• Hitac

3. Creating an HDLM Environment623.1.3 Cluster Software Supported by HDLMThe HDLM-related programs required when you combine cluster configurations ar

3. Creating an HDLM Environment63AIX 5L V5.3 (Virtual I/O Server)#5• HACMP 5.4Client APAR: IY84920Client: Technology Level 05 or laterServer: ioslevel

3. Creating an HDLM Environment64#1When using Technology Level 05, apply IY92037.#2If you have updated the host environment by, for example, applying

3. Creating an HDLM Environment65usePersistentReserve option to no in the GPFS cluster configuration information.#4VxVM is not supported.#5PowerVM Liv

3. Creating an HDLM Environment66#1This value depends on the error log file settings. The maximum is 30,000 MB.p = (s x m) / 1024 (in MB),where:s is t

3. Creating an HDLM Environment67#1The maximum number of LUs that can be recognized by a CHA port is 256.#2If the reservation policy is PR_exclusive,

vThis manual also uses the following abbreviations.Universal Storage Platform V/VM A generic term for:• Hitachi Universal Storage Platform V• Hitachi

3. Creating an HDLM Environment683.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 Environment693.3 Types of HDLM InstallationThis section describes the following HDLM installation types: new installation, upgrade

3. Creating an HDLM Environment703.4 Notes on Creating an HDLM EnvironmentThis section provides notes on creating an HDLM environment.For notes on ope

3. Creating an HDLM Environment71Re-installation in 3.5.5 Performing an Upgrade Installation or Re-installation of HDLM. If you upgrade or re-install

3. Creating an HDLM Environment72HDLM Drivers.2. Execute the following command to reconfigure the HDLM device:# cfgmgrWhen the NPIV option is set to o

3. Creating an HDLM Environment73When you migrate from HDLM 05-00 or laterTrace files before the migration: /var/opt/hitachi/HNTRLib2/spool/hntr2n.log

3. Creating an HDLM Environment74 # /usr/DynamicLinkManager/bin/dlnkmgr view -sys  When you use HACMP, GPFS, Oracle RAC 10g, Oracle RAC 11g, or VCS,

3. Creating an HDLM Environment753.5 Installing HDLMWhen you install HDLM, Hitachi Network Objectplaza Trace Library will also be installed. The file

3. Creating an HDLM Environment76where the replication is created is called an alternate disk.In addition to installing HDLM on a typical host, you ca

3. Creating an HDLM Environment77#Only upgrade installations and re-installations are supported.Table 3-8: Combination of Installation Methods that Ar