Hp XP Racks User Manual Page 1

Hitachi Command SuiteDynamic Link Manager SoftwareUser Guide for AIX®MK-92DLM111-21Document OrganizationProduct VersionGetting HelpContents

KAPL08001 to KAPL09000...8-48KAPL09001 to KAPL10000...

hdisk8 Definedhdisk9 Definedhdisk10 DefinedKAPL10531-I The status of all of the HDLM drivers was changed to "Defined".To avoid inheriting th

When an existing hdisk is successfully deleted, the KAPL09012-Imessage is displayed. If the KAPL09012-I message is not displayed,make sure that no pro

11. For an upgrade installation, execute the following command:¢When installing HDLM from the DVD-ROM# /directory-in-which-the-DVD-ROM-is-mounted/inst

During installation, the KAPL09241-W message might be output. In thiscase, installation of HDLM continues, but installation of HDLM componentshas fail

Intermittent Error Monitor : offDynamic I/O Path Control : off(10)HDLM Manager Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssH

When Installing HDLM in a Boot Disk Environment1. Log in to AIX as a user with root permissions.If you are using a virtual I/O server, see the virtual

HDLM management-target paths, and then re-execute the procedureof step 6. The hdisk of the boot disk cannot be deleted.¢Inheriting the existing hdisk

# /directory-in-which-the-DVD-ROM-is-mounted/installux.shor# installp -aXgd /directory-in-which-the-DVD-ROM-is-mounted/HDLM_AIX all¢When installing HD

If re-installation ends with an error, HDLM might be removed. In thiscase, proceed to step 13.During installation, the KAPL09241-W message might be ou

After executing the lspv command, if there is no hdisk other than theone that constitutes rootvg, re-execute the procedure starting from step14.16. Ex

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

Execute the following command on the virtual I/O server:When creating an hdisk as a virtual target device:$ mkvdev -vdev hdisk-name -vadapter virtual-

You do not need to mount the DVD-ROM. If you install HDLM by using adirectory to which the DVD-ROM is copied or if you use the nim command,you do not

# /usr/DynamicLinkManager/bin/dlnkmgr view -sysHDLM Version : x.x.x-xxService Pack Version :Load Balance : on(

¢If you prepared a license key for an upgrade installation of HDLM on astandby BOS to be newly created, go to step 2.¢If you prepared a license key fi

6. If you install HDLM as an installation bundle, create a bundle filecontaining the HDLM syntax. The following is an operation example ofadding the H

If there is even one BROKEN status displayed, remove HDLM and thenperform a new installation, or delete the standby BOS and then re-createthe standby

¢If you are using a virtual I/O server, see the virtual I/O serverdocumentation for details about how to log in to AIX.¢If you are not using a virtual

$ rmdev -dev vtscsin10. Insert the DVD-ROM.11. If there is no directory for mounting the DVD-ROM, make the directory.# mkdir /cdromcdrom is the desire

directory/odm-environment-settings-file-name -set /tmp/any-desired-directory/set-environment-settings-file-nameFor details about the dlmmigsts utility

# umount /cdrom26. Delete any mount directory you may have created in step 11.# rm -r /cdromInstalling HDLM in a PowerHA 5.5 or PowerHA 6.1 Environmen

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

If you are using a virtual I/O server, see the virtual I/O serverdocumentation to log in to AIX.2. Stop PowerHA on the standby host.3. Upgrade or re-i

WARNING: Custom disk method: ghostdisks's file: /usr/DynamicLinkManager/cluster/dlm_hacmp_gdisk_check does not exist or is not executable on node

1. Log in to the standby host as the root user.2. Execute the following command on the standby host to stop PowerHA.# smitty cl_stop3. Execute the fol

# clctrl -start -m node-name6. Execute the following command on the standby host to start PowerHA.# smitty cl_start7. Execute the following command on

When the OS used in a PowerHA 7.1 environment is AIX V6.1 TL06 or AIXV7.1 with no TL:# clusterconf -r hdiskxxWhen the OS used in a PowerHA 7.1 environ

cdrom is the desired directory name. Hereafter, cdrom is used forpurposes of explanation.4. Mount the DVD-ROM.# mount -r -v cdrfs /dev/cd0 /cdromThe /

Create the /var/DLM directory, and then, in this directory, create thelicense key file (dlm.lic_key). The following shows an example whenthe license k

# umount /cdrom11. Delete the created mount directory.# rm -r /cdrom12. Delete the installation information settings file.# rm -r /directory-containin

If the boot physical volume that contains the logical volume hd5 isdifferent from the physical volume used for booting, the followingmessage appears,

Also, these files need to be copied to the same directory to which theinstallhdlm utility is copied.For a new installation, proceed to step 8.8. If yo

Chapter Description4 HDLM Operation on page 4-1 Describes procedures for operating HDLM by usingthe HDLM commands, and procedures for manuallystarting

The following shows an example of copying thesample_installhdlm.conf file, and then changing the file name toinstall_set.conf:# cp -p /cdrom/HDLM_AIX/

the settings have been updated as specified in the installation informationsettings file.Note that, if the upgrade installation or re-installation end

The following describes how to check path information by using the dlnkmgrcommand's view operation. For details about the view operation, see vie

Checking the Current SettingsThis chapter describes how to check the HDLM function settings before anychanges are made by using the dlnkmgr command&ap

Function Default value Recommended value30-minute check interval The recommended checkinginterval depends on theoperating environment.Automatic failba

• rr for the Round Robin algorithm• exrr for the Extended Round Robin algorithm• lio for the Least I/Os algorithm• exlio for the Extended Least I/Os a

# /usr/DynamicLinkManager/bin/dlnkmgr set -afb on -intvl 10To enable the automatic failback function, set it to on. The checking intervalcan be specif

The dynamic I/O path control function can be set for each storage system orLU. The checking interval for reviewing the switching status information ca

Setting the Trace LevelThe trace output level can be set.You can set up the trace level for a trace file hdlmtrn.log (n indicates a filenumber from 1

# /usr/DynamicLinkManager/bin/dlnkmgr set -elfs 1000Specify the size of the error log file in kilobytes.Setting the Number of Error Log FilesThe numbe

Document conventionsThis document uses the following typographic conventions:Convention DescriptionBold Indicates text on a window, other than the win

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

This example shows how to enable the collection of audit log data:# /usr/DynamicLinkManager/bin/dlnkmgr set -audlog on -audlv 6 -category allSpecify o

When you change some settings, you can display information about all ofHDLM function settings. The following is an example of executing thecommand:# /

Table 3-18 Default and Recommended Values for the Integrated Trace FileSettingsSetting Default valueRecommendedvalueIntegrated trace file size 256 (KB

If you do not want to change the settings, type e and then press theEnter key to quit the menu.The following explains how to modify each setting.Chang

Changing the Number of Integrated Trace FilesThe following procedure shows how to change the number of integrated tracefiles.To change the number of i

of 64. Set this to a value smaller than that set in step 2 of Changing theSize of Integrated Trace Files on page 3-82. We recommend setting avalue of

2. Enter a desired interval in New Span (sec).The specifiable range is between 0 and 3600 seconds, with a default of 0.We recommend setting a value of

The new setting is applied and the Hitachi Network Objectplaza TraceLibrary setup menu appears again.Finishing the Hitachi Network Objectplaza Trace L

7. Start the programs stopped in step 3.If you stopped programs other than HDLM in step 3, start them.About the Reservation PolicyThe following table

Logical capacity unit Value1 block 512 bytes1 KB1,024 (210) bytes1 MB1,024 KB or 1,0242 bytes1 GB1,024 MB or 1,0243 bytes1 TB1,024 GB or 1,0244 bytes1

Storage System SettingsSetting Up a Thunder 9500V Series DeviceTo use a Thunder 9500V series device as the storage system, perform thesetup shown in t

¢When a XP series is used:disk/fcp/HP¢When a Thunder 9500V series, Lightning 9900V series (excluding XPseries), Hitachi USP series (excluding XP serie

# umount file-system-mount-point4. Execute the following command to display all the activated volumegroups.# lsvg -o5. Among the displayed volume grou

Note that, depending on the settings of Oracle RAC, Oracle RAC mightdetermine that a node error has occurred before the failover processingperformed b

Storage system typeNumberof pathsconnected to thevotingdiskFormula for obtaining the value ofDISKTIMEOUT• Hitachi USP series•Lightning 9900V series• U

6. Execute the chdev command to change the reserve_policy attribute tono_reserve.# chdev -l hdisk-name -a reserve_policy=no_reserve7. Confirm that the

Figure 3-4 Example of Editing the Preonline ScriptRemoving HDLMThis section explains how to return the HDLM environment to the way it wasbefore HDLM w

Hitachi Network Objectplaza Trace Library (HNTRLib2), only HDLM will beremoved.You can use the installp command or SMIT to remove HDLM. The followinge

For details about the stopping method, see the manual for eachapplication.10. Specify the -A parameter, as required, and execute the dlmrmdev utilityt

¢If Thunder 9500V series, Lightning 9900V series (excluding XPseries), Hitachi USP series (excluding XP series), Universal StoragePlatform V/VM series

xviPrefaceHitachi Dynamic Link Manager User Guide for AIX®

22. Execute the following command in the client logical partition toreconfigure the device:# cfgmgr23. Execute the following command in the client log

$ rmdev -dev vtscsinIf the boot disk is in a single-path configuration, proceed to step 12.9. If the boot disk is in a multi-path configuration, execu

# shutdown -Fr18. If GPFS + RVSD was used, delete the setting information from the /etc/vsd/oemdisktypes.lst file.¢If XP series is used, delete the fo

$ mkvdev -vdev hdisk-name -vadapter virtual-SCSI-server-adapter-name¢To create a logical volume as a virtual target device$ mkvdev -vdev logical-volum

I did not do the Uninstall.If HNTRLib2 was not removed, execute the following command tocheck if any programs are using it.# /opt/hitachi/HNTRLib2/etc

¢Even if you attempt to remove HNTRLib2 when HNTRLib is installed,HNTRLib will not be removed. If no other programs are usingHNTRLib, delete it manual

3-104Creating an HDLM EnvironmentHitachi Dynamic Link Manager User Guide for AIX®

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

Notes on Using HDLMThis section provides notes on using HDLM and using the environment inwhich HDLM is installed. Make sure that you read this section

Storage System•Start up the storage system before you start up the hosts, so that AIXcan detect the storage system.• To delete an LU from the storage

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

Notes on Enabling Both Primary and Secondary Volumes to BeViewed From the Same ServerTo enable both primary and secondary volumes to be viewed from th

To cancel the reservation for the LU, execute the dlmpr utility from a hostthat can access this LU. For details on this utility, see dlmpr Utility for

To display path information, execute the dlnkmgr command's view operationwith the -path parameter specified. The following example shows how toex

For example, if you want to place all the paths that pass through aspecific HBA port online, execute the dlnkmgr command's onlineoperation with t

3. Check to see if the statuses of all the applicable paths have changed.The following example shows how to execute the command:# /usr/DynamicLinkMana

operation, see view (Displays Information) on page 6-32. The executionresult of this operation is displayed on a single line for each path.The followi

Viewing and Setting Up the Operating EnvironmentThis section explains how to display and set up the HDLM operatingenvironment.Viewing the Operating En

• Dynamic I/O path control•Error log collection level• Trace level• Error log file size• The number of error log files• Trace file size• The number of

Updating the LicenseThis section explains how to update the license.To update the license, execute the dlnkmgr command's set operation withthe -l

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

What is HDLM?The widespread use of data warehousing and increasing use of multimediadata have increased the need for high-speed processing of large vo

# /usr/DynamicLinkManager/bin/dlnkmgr view -sys -msrv# /usr/DynamicLinkManager/bin/dlnkmgr view -sys -adrv# /usr/DynamicLinkManager/bin/dlnkmgr view -

# /usr/DynamicLinkManager/bin/dlnkmgr view -sys -msrvHDLM Manager Ver WakeupTimeDeadKAPL01001-I The HDLM command completed normally. Operation

2. Stop all processes and services that are using the device that is to bedeleted.3. Execute the following command to unmount the file system that use

Changing hdisk attributeshdisk attributes consist of default values and values actually used. When anew hdisk is configured, or deleted and then recon

4. Execute the following command to restart the host.# shutdown -Fr5. Execute the following command to make sure that the status of thehdisks recogniz

Reconfigure the HDLM device. Proceed to step 2 to automatically performthe processing needed to unmount for reconfiguration, and processing tochange t

# /usr/DynamicLinkManager/bin/dlmchpdattr -A -a reserve_policy=no_reserveA message is displayed to confirm whether processing should continue.Enter y

In this example, hdisk3 and hdisk4 are recognized as HDLM-manageddevices.If the status of all hdisks is Available, proceed to step 14. If there areany

# bootlist -m normal -ohdisk0 blv=hd5hdisk0 blv=hd5hdisk1 blv=hd5...Deleting a Path (of a Volume Group Other than rootvg)The following shows an exampl

# rmpath -l hdisk10 -p fscsi5 -w 50060e800436e240,6a0000000000004. Check that the path has been deleted.# /usr/DynamicLinkManager/bin/dlnkmgr view -dr

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

In the second line of the above examples, 11 in 11-08-02 indicates thebus number and 08 indicates the HBA adapter number. The fscsinumber to be used w

For details on the operations after executing the diag command, seethe AIX documentation. Steps 7 to 14 below provide an example ofthe execution proce

# cfgmgr -l fcsnTo reconfigure the device, specify the device name of the PCI slot wherethe HBA was replaced (fcs device); n indicates the instance nu

Specify the device name of the PCI slot (fcs device) where each HBAhas been replaced. n indicates the instance number of the fcs device.f. Execute the

Replacing a Fiber CableIf there are multiple active paths for an LU, you can replace a desired cablewhile running your applications by placing offline

Depending on the NPIV option setting for the dlmodmset utility checked instep 1, execute one of the following commands:¢If the NPIV option is set to o

# /usr/DynamicLinkManager/bin/dlmodmset -oThe following are execution examples:Lun Reset : offOnline(E) IO Block

fcsn indicates the name of the parent device that was acquired in step 5;n indicates the instance number of the fcs device.9. Execute the following co

4-32HDLM OperationHitachi Dynamic Link Manager User Guide for AIX®

5TroubleshootingThis chapter describes how to check HDLM error information, and how to takeaction if an error occurs in HDLM. Descriptions of the acti

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

1-4Overview of HDLMHitachi Dynamic Link Manager User Guide for AIX®

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

PathNameThe path name, which indicates a path. When you modify the systemconfiguration or replace a hardware item, you should check the pathnames to i

Figure 5-1 Error location when the KAPL08022-E message is outputThe following figure shows the troubleshooting procedure when theKAPL08022-E message i

Examining the messagesExamine the message that is output to syslog in the management-target hostby using applications or tools for monitoring messages

If any path cannot be placed online due to an error, the KAPL01039-Wmessage will appear. To ignore such paths and to continue processing, typey. Type

What To Do for the Program ErrorFollow the recommended actions for messages in 8 Messages on page 8-1.If the error occurs again after you thought that

5-8TroubleshootingHitachi Dynamic Link Manager User Guide for AIX®

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

Overview of the HDLM Command dlnkmgrThis section describes command formats and operations used for HDLM.Command formatEnter the command using the foll

clear (Returns the Path Statistics to the Initial Value)The dlnkmgr command's clear operation clears the statistics (I/O count andI/O errors) of

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

# /usr/DynamicLinkManager/bin/dlnkmgr clear -helpclear: Format dlnkmgr clear -pdst [-s]KAPL01001-I The HDLM command completed normally. Operation

The following example shows how to display the formats of multipleoperations.# /usr/DynamicLinkManager/bin/dlnkmgr help online offline helponline: Fo

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

Use this parameter to place offline, at one time, all the paths that passthrough a specific HBA port. The command will place offline all the pathsconn

path(s) were not. Operation name = offline#-cha -pathid AutoPATH_IDUse this parameter to place offline, at one time, all the paths that passthrough a

The following example shows how to place offline all paths connectedto the CHA port whose CHA-port-ID is 00001.# /usr/DynamicLinkManager/bin/dlnkmgr o

hdisk0 -ospathid 1KAPL01052-I The currently selected paths will be changed to the Offline(C) status. Is this OK? [y/n]:yKAPL01053-I If you are sure th

ReferenceUsing the view operation together with standard UNIX commands enablesyou to filter the path information listed for a specific HBA port or CHA

[-s]To Display the Format of the Online Operation/usr/DynamicLinkManager/bin/dlnkmgr online -helpParametersTo Place Paths Online-pathIndicates that th

path(s) were not. Operation name = online#-hbaid HBA-port-IDUse this parameter to place online, at one time, all paths that passthrough a specific HBA

□Integrated HDLM management using Global Link Manager□Cluster support2-2HDLM FunctionsHitachi Dynamic Link Manager User Guide for AIX®

KAPL01057-I All the paths which pass the specified CHA port will be changed to the Online status. Is this OK? [y/n]:yKAPL01061-I 2 path(s) were succes

To display HDevName and OSPathID, execute the view operation asfollows:# /usr/DynamicLinkManager/bin/dlnkmgr view -luFor details on how to execute the

{ -hba HBAPortNumber.BusNumber | -hbaid HBA_ID } [-s] dlnkmgr online [-path] { -cha -pathid AutoPATH_ID | -chaid CHA_ID } [-s] dlnkmgr o

FormatTo Set Up the HDLM Operating Environment/usr/DynamicLinkManager/bin/dlnkmgr set{-lb {on [-lbtype {rr|exrr|lio|exlio|lbk|exlbk}]|off}|-ellv error

Item name Default value Recommended valueError log collectionlevel3: Collect error information forthe Information level andhigher.3: Collect error inf

Enables or disables load balancing.on: Enabledoff: DisabledLoad balancing distributes load among paths and prevents theperformance of the entire syste

# /usr/DynamicLinkManager/bin/dlnkmgr set -ellv 1KAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: yKAPL01001-I The HDL

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

health check) has already elapsed, the path health check will startover.The path health check interval setting remains stored in the systemeven if you

If intermittent error monitoring is on and the number of times that theerror is to occur is set to a value of 2 or more, the following conditionmust b

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

¢When the intermittent error monitoring interval or the number oftimes that the error is to occur has been specified before:The values specified from

value will take effect after the next automatic failback successfullycompletes. When intermittent error monitoring is not beingperformed, the number o

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

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

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

Table 6-8 Values Indicating Audit Log Data CategoriesValue ExplanationssAudit log events of the StartStop category are collected.aAudit log events of

You an specify a decimal (base 10) value from 0 to 999999. The default is100.If you specify 0, the same path is used as long as the sequential I/Ooper

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

Number-Of-PathUseTimes { 0 - 999999 }(Times) (Default Value 20) Number-Of-ExPathUseTimes { 0 - 999999 }(Times) (Default Value 100) AutoPAT

To display a summary of path information/usr/DynamicLinkManager/bin/dlnkmgr view -path -c[-stname][-srt {lu|cp}][-t]To Display LU InformationTo displa

Figure 2-1 HDLM System ConfigurationThe following table lists and describes the HDLM system components.Table 2-1 HDLM System ComponentsComponents Desc

ParametersThis section describes the parameters for the view operation, in the followingorder:To Display Program Information on page 6-34To Display Pa

Parameterandprograminformation to bedisplayedItem Descriptionoff: Disabled•AlgorithmWhen the setting status of load balancing is on,one of the followi

Parameterandprograminformation to bedisplayedItem DescriptionTrace FileSize(KB)Trace file size in kilobytesNumber OfTrace FilesNumber of trace files.P

Parameterandprograminformation to bedisplayedItem Description• Checking intervalThe parentheses following the setting statusshows the checking interva

Parameterandprograminformation to bedisplayedItem Descriptionview -sys -lic operation is executed, (ndaysafter) appears if there are n days left until

Parameterandprograminformation to bedisplayedItem Description-expathusetimesThenumber oftimes thesame pathcan beused forextendedloadbalancingTimes Sam

# /usr/DynamicLinkManager/bin/dlnkmgr view -sys -msrvHDLM Manager Ver WakeupTimeAlive x.x.x-xx yyyy/mm/dd hh:mm:ssKAPL01

# /usr/DynamicLinkManager/bin/dlnkmgr view -sys -lbpathusetimesTimes Same Path Was Used : 20KAPL01001-I The HDLM command completed normally. Operat

Use this parameter to display the model ID of the storage system inthe product ID element of the DskName field. When this parameter isomitted, the com

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

LU ConfigurationOn a system using HDLM, the logical device file for the HDLM management-target device is used to access the target LU.An LU recognized

When you specify this parameter, HDevName is displayed by default.Therefore, it is not necessary to specify hd for the -item parameter.-stnameUse this

To display a summary of path information-path -cIf the -c parameter is specified at the same time as the -path parameter,only PathID, DskName, iLU, CP

For details about the information about product IDs, see Table 6-14Product ID Displayed by the View -Path Operation on page 6-51.-srt {lu|cp}Use this

Table 6-12 Displayed Path InformationDisplayed ItemDescriptionNosummarydisplayedSummarydisplayedPathsTotal number of displayed paths, indicated by a d

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedDskName#1DskNameStorage system name, which identifies the storage system thatis accessed by

Displayed ItemDescriptionNosummarydisplayedSummarydisplayed• Offline(C): Offline status caused by a commandoperation• Offline(E): Offline due to an er

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

Element AIX representationCorrespondinginformationTarget ID (example:00000000000000E2)Target ID The value of scsi_id, whichis displayed by executingth

Model names of storagesystemsProduct IDWithout the -stnameparameterWith the -stnameparameter(Displays the followingfor the model name)Hitachi Virtual

Filters the information only for the paths accessing the specified hostdevice.Specify hdisk name for host-device-name.The host-device-name string is c

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

The table below lists the correspondence between the display items thatcan be added by using the -item parameter and the parameter valuesthat can be s

Example 2When using Hitachi AMS2000 series, or HUS100 series and displaying LUinformation with DPC added to the display items: # /usr/DynamicLinkManag

# To display a summary of LU information-lu -cWhen the -c parameter is specified with the -lu parameter, a summaryof LU configuration information is d

Table 6-16 Items That Can Be Added by Using the -lu -c -itemParameter and Sub-parametersItem that can be added Sub-parameterSLPR slprVG vgAll items al

Displayed itemDescriptionNo summarydisplayedSummarydisplayedLUsTotal number of LUs managed by HDLM among theLUs in the storage systemDynamic I/OPath C

Displayed itemDescriptionNo summarydisplayedSummarydisplayeddisplayed if the storage logical partition functionalityfor the storage system for the tar

Displayed itemDescriptionNo summarydisplayedSummarydisplayed• CHA ports in the storage system that do notsupport cache logical partition functionality

Displayed itemDescriptionNo summarydisplayedSummarydisplayedFor details about the clear operation, see clear(Returns the Path Statistics to the Initia

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

KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ss#The subsequent sub-parameters are:-srt p

Program name Functions• Migration of HDLM•Clear HDLM persistent reservation• Exclude the hdisk recognized as a boot disk frombeing an HDLM management

Item Descriptionshould check the offline paths and take appropriate action for anypath that has an error status.ExampleThe subsequent sub-parameters a

Item DescriptionAutoPATH_ID is assigned when you execute the cfgmgrcommand.HDevNameHost device name.Hdisk name is displayed.OSPathIDOS management path

dlnkmgr view -lu -item [ [slpr] [vg] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] [dpc]

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

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

about the dlmpr utility, see dlmpr Utility for Clearing HDLM PersistentReservation on page 7-22.•The dlmpreremove utility executed before removing HDL

OperationNumber of pathsfor an LU/ Totalnumber ofpaths#2Execution time#1, #3(when HDLM is installed)8/2048 42 seconds16/4096 43 secondsExecution time

This file contains a symbolic link to the system crash dump file.•hbsa.tar.ZThis file contains compressed error information of the Hitachi CommandSuit

Figure 7-1 Coding Example of a File that Defines the Information tobe CollectedRules for coding a file that defines the information to be collected•Us

entering n (or anything other than y) instructs the utility to terminatewithout executing.In the latter case, you can either rename the existing direc

Figure 2-4 Position of the HDLM Driver and hdiskDistributing a Load Using Load BalancingWhen the system contains multiple paths to a single LU, HDLM c

Output directory#1Files Explanationdlminquiry[1-2].logdlminquiry[1-2].txtInquiry logdlmguiinst.logInstallation linkage script logused when linking wit

Output directory#1Files Explanationdlmwebagent.propertiesHitachi Command Suite CommonAgent Component settings filedlmmgr_DPC.xmlDPC option setting fil

Output directory#1Files Explanationdisk.txtList of disks in the /dev directorydlmgetomtrace.dmpHDLM function tracedlmls-la.txtHDLM directory informati

Output directory#1Files ExplanationMaintenance-Level.txtMaintenance level of information,displayed when the instfix -icommand was executedmount.txtMou

In the actual file name, a file number is appended to Trace-file-prefixspecified-in-the-Hitachi-Network-Objectplaza-Trace-Library-utility2. Forexample

Parameters-a Attribute=ValueSpecifies one or more attribute name and attribute value pairs. Ifspecifying multiple pairs, separate them by using a spac

Prevents the confirmation message from being displayed when the utilityis executed.-oDisplays the current value set for the reservation policy.-hDispl

dlmgetrasinst Utility for Collecting HDLM Installation ErrorInformationThis utility collects information that is needed to analyze errors that haveocc

List of Collected Error InformationThe following table lists and describes the information collected by thedlmgetrasinst utility.Table 7-4 Information

Output directory#Files ExplanationCuPathAt.txtInformation of Object DatabaseManagerCuVPD.txtInformation of Object DatabaseManagerdisk.txtList of disks

Figure 2-5 Flow of I/O Data When the Load Balancing Function Is NotUsedWhen the load balancing function is not being used, I/O operations convergeon o

Output directory#Files Explanationdescriptors) that are available toprocessesuname-a.txtInformation on the AIX versionrootvginfo.txtrootvg information

| -h}Parameters-bSaves the settings files by using the names specified in the -odm and -setparameters.Notes on specifying the -b parameter•Do not save

ExamplesIn the following example, the utility saves the ODM environment settings inthe /tmp/odmset file and the set environment settings in the /tmp/d

When an error (such as one that might occur in a LVM mirrorconfiguration) is detected and I/O access for a path in the Online(E)status continues, dete

| -i {on | off} | -v {on | off} } [ -s ] | -o |

Parameters-kSpecify this parameter to display the Reservation Key. The followingexplains the items displayed when the -k parameter is specified:Reserv

1. Execute the dlmpr utility to display the Reservation Keys for hdisk1,hdisk2, hdisk3, hdisk4, hdisk5, hdisk6, hdisk7# /usr/DynamicLinkManager/bin/dl

Parameters-hDisplays the format of the dlmpreremove utility.-sExecutes the command without displaying the message asking forconfirmation of command ex

Unmounts file systems and deactivates volume groups that are beingused by HDLM before deleting the hdisks that are recognized as HDLMmanagement-target

Format/directory-in-which-the-DVD-ROM-is-mounted-or-copied/HDLM_AIX/hdlmtool/instutil/installhdlm { -f installation-information-settings-file-name | -

ContentsPreface...xiIntended audience...

Figure 2-6 Flow of I/O Data When the Load Balancing Function Is UsedWhen the load balancing function is being used, I/O operations aredistributed via

Key name#1Description#2Necessity ofdefinitionMaximumnumberofcharactersNewinstallationUpgradeinstallation or re-installationlogdirSpecify the absolute

Key name#1Description#2Necessity ofdefinitionMaximumnumberofcharactersNewinstallationUpgradeinstallation or re-installationrestartSpecify whether to r

For details about the dlmchpdattr utility, see dlmchpdattr Utility forChanging HDLM Default Settings on page 7-12.The following table lists and descri

Table 7-7 Keys in the [ODM_SETTINGS] SectionKey name#1Description#2Necessity ofdefinitionMaximumnumberofcharactersNewinstallationUpgradeinstallation o

[ENVIRONMENT_SETTINGS] sectionThis section defines information that is used when the set operation of theHDLM command is executed. This section is opt

Key name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinstallation orre-installationlbex_usetimes_limitSpecify

Key name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinstallation orre-installationpath_health_check_intervalS

Key name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinstallation orre-installationoff: Disabled (default)dyna

#4If you want to enable intermittent error monitoring, specify this key afterspecifying the auto_failback and auto_failback_interval keys.#5The checki

Log fileA log file (installhdlm.log) is output after an unattended installation ofHDLM.The following explains the installhdlm.log file.• installhdlm.l

paths and non-owner paths. If failures occur across some of the owner paths,load balancing will be performed among the remaining, usable owner paths.I

Displays the format of the installux.sh utility.Log fileThe installux.sh utility outputs execution information to the log file /var/tmp/hdlm_installux

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

□Return Codes for Hitachi Command Suite Common Agent Component8-2MessagesHitachi Dynamic Link Manager User Guide for AIX®

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

• HDLM manager•HDLM driver (filter component)• HDLM alert driver• HDLM management targetKAPL01001 to KAPL02000MessageIDMessage Text ExplanationKAPL010

MessageIDMessage Text Explanationaa...aa: clear, set,online, offline, or viewbb...bb: SpecifiedparameterActionExecute help operation-name of the HDLMc

MessageIDMessage Text ExplanationKAPL01009-WA parameter value is invalid. Operationname = aa...aa, parameter = bb...bb,parameter value = cc...cc, Vali

MessageIDMessage Text Explanationcompany if there is amaintenance contract forHDLM. For details on theDLMgetras utility, seeDLMgetras Utility forColle

MessageIDMessage Text ExplanationAction¢If the path ID of thepath managementpath was specified in -pathidExecute the viewoperation of the HDLMcommand

MessageIDMessage Text ExplanationFor details on the viewoperation, see view(Displays Information) onpage 6-32.KAPL01019-WThe target path was not found

¢Virtual Storage Platform series¢Hitachi AMS2000 series#¢Hitachi SMS series¢HUS100 series##This storage system applies when the dynamic I/O path contr

MessageIDMessage Text Explanationand then contact yourHDLM vendor or thecompany for whichyou have a servicecontract. For details onthe DLMgetras utili

MessageIDMessage Text ExplanationOperation Format) on page6-4.KAPL01036-EThe Offline path cannot be placed online.PathID = aa...aaDetailsaa...aa: Path

MessageIDMessage Text ExplanationCheck the correct value,and then re-execute theHDLM command.KAPL01044-WA duplicate parameter value is specified.Opera

MessageIDMessage Text Explanationcancel the operation, entern.aa...aa: clear or setActionIf you want to execute theoperation, enter y. If youwant to t

MessageIDMessage Text Explanation(dlnkmgr) to check thepath status. For details onthe view operation, seeview (DisplaysInformation) on page 6-32.For d

MessageIDMessage Text ExplanationActionIf you want to continueprocessing the offlineoperation of the HDLMcommand for other paths,enter y. If you want

MessageIDMessage Text Explanationbecause the -hba or -chaparameter was specified.To continue the operation,enter y; to cancel theoperation, enter n.aa

MessageIDMessage Text Explanationretry. For details on thehelp operation, see help(Displays the OperationFormat) on page 6-4.KAPL01060-IThe user termi

MessageIDMessage Text ExplanationActionUse the view operation ofthe HDLM command(dlnkmgr) to check thestatus of the path. Fordetails on the viewoperat

MessageIDMessage Text Explanationaa...aa: Year (4 digits)/month (01-12)/day(01-31)ActionInstall a permanent licenseby the expiration day.KAPL01073-ETh

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

MessageIDMessage Text ExplanationActionEnable automatic failbacks,and then re-execute.KAPL01080-WThe error monitoring interval and thenumber of times

MessageIDMessage Text Explanationaa...aa: /var/tmp/hdlm_licenseActionWhen the message thatprompts you to enter thelicense key is displayed,enter the l

MessageIDMessage Text Explanationcompany if there is amaintenance contract forHDLM.Do not perform thefollowing operations:¢Simultaneouslyexecute the H

MessageIDMessage Text Explanationnumber of trace files, allthe current trace files willbe deleted. To continue theoperation, enter y. Tocancel the ope

MessageIDMessage Text ExplanationIf you want to execute theoffline processing for thepaths which pass thespecified target, enter y. Ifyou want to term

MessageIDMessage Text ExplanationPerform one of thefollowing procedures.When performing aninstallationSee Installing HDLM onpage 3-17, and thencomplet

MessageIDMessage Text ExplanationIf the dlnkmgr view -sys-audlog command doesnot display a normalresult, contact your HDLMvendor or maintenancecompany

MessageIDMessage Text ExplanationKAPL01120-WA storage system model ID could not bedisplayed. Details = aa...aa, bb...bbDetailsA storage system model I

MessageIDMessage Text ExplanationUse the view operation ofthe HDLM command(dlnkmgr) to check thesetting for storage. Fordetails on the viewoperation,

Message ID Message Text Explanationaa...aa: Trace informationActionNone.KAPL03003-EHDLM API Error information - aa...aa DetailsThis information isrequ

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

Message ID Message Text Explanationerror information, and thencontact your HDLM vendoror the maintenancecompany if there is amaintenance contract forH

Message ID Message Text ExplanationActionExecute the DLMgetrasutility for collecting HDLMerror information, and thencontact your HDLM vendoror the mai

MessageIDMessage Text Explanationcompany if there is amaintenance contract forHDLM. For details on theDLMgetras utility, seeDLMgetras Utility forColle

MessageIDMessage Text ExplanationFor details on the setoperation, see set (Sets Upthe OperatingEnvironment) on page6-16.KAPL04010-ECould not open the

MessageIDMessage Text ExplanationDLMgetras Utility forCollecting HDLM ErrorInformation on page 7-4.KAPL04013-EInput is impossible via the communicatio

MessageIDMessage Text Explanationaa...aa: API return code(decimal (base-10)number)ActionExecute the DLMgetrasutility for collecting HDLMerror informat

MessageIDMessage Text ExplanationActionExecute the DLMgetrasutility for collecting HDLMerror information, and thencontact your HDLM vendoror the maint

MessageIDMessage Text ExplanationKAPL04027-IThe emergency license is valid. Thelicense expires in aa...aa days on(bb...bb).Detailsaa...aa: Expiration

MessageIDMessage Text ExplanationEnvironment) on page6-16.KAPL04034-EAn attempt to create the option definitionfile has failed.DetailsAn attempt to re

MessageIDMessage Text ExplanationActionNone.KAPL04045-IHDLM SNMP TRAP was sent. Trap ID =aa...aa, IP Address = bb...bb, PortNumber= cc...cc, Community

controller of an LU is CHA0, and access to the LU is made via only one path(A). After that access path (A) is placed offline, the first choice for the

MessageIDMessage Text Explanationto recover the settings. Fordetails on the viewoperation, see view(Displays Information) onpage 6-32. For details ont

Message ID Message Text Explanationerror information, and then contact yourvendor or maintenance company. Referto the HDLM User's Guide for instr

Message ID Message Text ExplanationKAPL05014-I The device object (aa...aa) wasregistered as the path (bb...bb).DetailsThe path (bb...bb: Corelogic pat

Message ID Message Text Explanationvendor or maintenance company. Referto the HDLM User's Guide for instructionshow to execute the DLMgetras util

Message ID Message Text ExplanationNone.KAPL06001 to KAPL07000Message ID Message Text ExplanationKAPL06003-I Initialization of the HDLM alert driver(a

Message ID Message Text ExplanationKAPL06010-ECould not process the IOCTL (aa...aa).(bb...bb:cc...cc)DetailsAlthough the IOCTLrequest (aa...aa: code(h

Message ID Message Text ExplanationCheck whether any othererror occurred. Theinformation that could notbe written is discarded.Review the actual memor

Message ID Message Text ExplanationIf the actual memory sizeis sufficient, execute theDLMgetras utility forcollecting HDLM errorinformation, and thenc

MessageIDMessage Text Explanationbb...bb: Owner controllerID after the change.(Hexadecimal number)ActionNone.KAPL07825-IThe owner core of the LU conne

Message ID Message Text ExplanationCheck the path in whichthe error was detected.KAPL08022-EA path error occurred. ErrorCode =aa...aa, PathID = bb...b

Priority of Switching Destination PathsPriority of paths varies depending on the architecture of the host machine.If the architecture of the host is C

Message ID Message Text Explanationbb...bb.cc...cc.dd...dd.ee...ee, DNum =ff...ff, HDevName = gg...ggaa...aa: Path ID (same asPathID of view -path)(de

Message ID Message Text Explanation(decimal (base-10)number)ActionAn intermittent error hasoccurred. Check the pathfor any possible problems.For detai

MessageIDMessage Text ExplanationActionNone.KAPL09013-ESome HDLM drivers could not beremoved.DetailsThe dlmrmdev commandwas run, but HDLM driverscould

MessageIDMessage Text ExplanationKAPL09022-EHDLM cannot be removed. aa...aa isrunning.DetailsHDLM cannot be removedbecause the HDLMmanager, HDLM drive

MessageIDMessage Text Explanation/usr/HDVM/agent/classes/com/Hitachi/soft/HiCommand/DVM/agent/module/HDLMWebAgent.class/usr/HDVM/agent/classes/jp/usr/

MessageIDMessage Text ExplanationKAPL09048-EHDLM cannot be installed. aa...aa isrunning.DetailsAn attempt to install HDLMfailed because either ofaa...

MessageIDMessage Text ExplanationKAPL09081-IThe emergency license has been installed.The license expires on aa...aa.DetailsThe emergency license hasbe

MessageIDMessage Text ExplanationKAPL09100-EInstallation is not possible becauseaa...aa is already installed.DetailsInstallation is not possiblebecaus

MessageIDMessage Text Explanationcorrect license key file inthe designated directory,and then re-execute theinstallation./var/tmp/hdlm_licenseKAPL0911

MessageIDMessage Text ExplanationKAPL09142-EHDLM aa...aa cannot be performed. Waita while, and then perform aa...aa again.Error Code =bb...bbDetailsHD

d. Execute a command that displays the information for the path forwhich a new path priority number has been set:# lspath -l hdisk4 -p fscsi0 -w50060e

MessageIDMessage Text ExplanationIf any other error code isoutput:Contact your HDLMvendor or themaintenance companyif there is amaintenance contractfo

MessageIDMessage Text ExplanationActionMake sure that theparameters forinstallhdlm areappropriate, and then tryagain.KAPL09190-WThe installation infor

MessageIDMessage Text ExplanationKAPL09212-Eaa...aa ended abnormally. Detailsaa...aa ended abnormally.aa...aa: installhdlm,installp, cfgmgr,dlmodmset,

MessageIDMessage Text Explanationspecifies the executedprocessingActionIf the error code is 1:The /tmp directorydoes not exist. Preparethe /tmp direct

MessageIDMessage Text ExplanationIf the error code is 7:There is not enoughunused capacity forthe file system of the /var/tmp or /var/DLMdirectory. Ma

MessageIDMessage Text Explanationprocessing (decimal(base-10) number)bb...bb: Return value ofthe executed processing(decimal (base-10)number)ActionMak

MessageIDMessage Text Explanationin the correct location, oryou do not have a requiredpermission.aa...aa:installhdlm_analysis,dlmodmset, dlnkmgr, ordl

MessageIDMessage Text Explanationbb...bb: Return value(decimal number) of theexecuted processingActionContact your HDLM vendoror the maintenancecompan

MessageIDMessage Text Explanationsettings file, and then retrythe operation.KAPL09227-WThe definition of the installationinformation settings file inc

MessageIDMessage Text Explanationbb...bb: Return value(decimal number) of theexecuted processingcc...cc: Line number(decimal number) of aninstallation

NoteDepending on the HBA, you need to repeat steps b and c.For details on the position of slots, see the manual of the host.CHA port numberThe port nu

MessageIDMessage Text Explanationsettings file and then retrythe operation.KAPL09232-WThe composition of the definition of theinstallation information

MessageIDMessage Text ExplanationSpecify the revisedinstallation informationsettings file and then retrythe operation.KAPL09235-EThe log file cannot b

MessageIDMessage Text ExplanationCheck the error messageoutput before thismessage, and thenperform the actionindicated in that errormessage.KAPL09237-

MessageIDMessage Text Explanationmaintenance company(if an HDLMmaintenance contractexists).KAPL09238-WThe specified file is not a normal one. Failname

MessageIDMessage Text Explanationre-executedlminstcomp utility.If the error code is 200:Execute dlminstcomputility.If any other error code isoutput:Co

MessageIDMessage Text ExplanationContact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDLM.KAPL09248-WA parameter is

MessageIDMessage Text ExplanationKAPL09603-EThe installation will now stop because acommand or utility cannot be executed.Confirm that the command or

KAPL10001 to KAPL11000MessageIDMessage Text ExplanationKAPL10001-WNo parameter has been specified. DetailsNo directory to which thecollected informati

MessageIDMessage Text Explanationaa...aa: Invalid parameterActionCheck the parameters ofthe DLMgetras utility forcollecting HDLM errorinformation, and

MessageIDMessage Text ExplanationCheck the parameters ofthe DLMgetras utility forcollecting HDLM errorinformation, and thenretry. For details on theDL

#1This storage system applies when the dynamic I/O path control function isdisabled.#2An intermittent error means an error that occurs irregularly bec

MessageIDMessage Text Explanationbe collected in the file fordefining the information tobe collected.aa...aa: Line number ofthe file for defininginfor

MessageIDMessage Text ExplanationCollecting HDLM ErrorInformation on page 7-4.KAPL10012-WThe specified file or directory does notexist. Line = aa...aa

MessageIDMessage Text Explanationcheck the contents of thefile for defining theinformation to be collected.This file is shown in themessage. If the co

MessageIDMessage Text Explanationaa...aa: Third parameterActionAfter the DLMgetras utilityfor collecting HDLM errorinformation terminates,check whethe

MessageIDMessage Text ExplanationActionNone.KAPL10021-IProcessing terminated before completionbecause a signal was received.DetailsThe process has bee

MessageIDMessage Text ExplanationKAPL10032-WThe entered value is invalid. The utilityfor collecting HDLM error informationstops.DetailsProcessing of t

MessageIDMessage Text Explanationthe output directoryspecified at the time ofexecution, and thencontact your HDLM vendoror your maintenancecompany if

MessageIDMessage Text ExplanationKAPL10521-WA parameter is invalid. (parameter =aa...aa)Detailsaa...aa: invalid parameter(character string)ActionExecu

MessageIDMessage Text ExplanationKAPL10525-EAn internal error occurred in thedlmrmdev utility. (error code = aa...aa))Execute the DLMgetras utility to

MessageIDMessage Text ExplanationThe dlmrmdev commandwas executed, but somehdisks could not bedeleted.ActionCheck the hdisk status andre-execute the d

The online path status...2-20The offline path status...

Path status transitionEach of the online and offline statuses described in Performing Failovers andFailbacks Using Path Switching on page 2-14 is furt

MessageIDMessage Text ExplanationKAPL10555-IExecuting the dlmpostrestore utility willreboot the host. Is this OK? [y/n] :DetailsExecuting thedlmpostre

MessageIDMessage Text ExplanationConfirm that all of theprocesses and servicesthat use HDLMmanaged paths havestopped. Afterconfirming that all theproc

MessageIDMessage Text ExplanationAn invalid parameter isspecified.aa...aa: The specifiedparameterActionWith the -h parameterspecified, execute thedlmc

MessageIDMessage Text Explanationdlmchpdattr utility. Makesure that the format of theutility is correct, and thenre-execute it.KAPL10578-WAn attribute

MessageIDMessage Text ExplanationActionTo execute dlmchpdattrutility again, enter either"y" or "n".KAPL10583-EAn internal error oc

MessageIDMessage Text ExplanationThe dlmrmdev utility isnot in the defaultlocation, or the userdoes not haveexecution permissionsfor the dlmrmdevutili

MessageIDMessage Text ExplanationReboot the host to applythe changes to thesettings.ActionNone.KAPL10586-IProcessing terminated before completionbecau

MessageIDMessage Text ExplanationA parameter is notspecified for the dlmprutility.ActionExecute the dlmpr -hutility to check theparameter, and then re

MessageIDMessage Text Explanationaa...aa: specifiedparameter (characterstring)ActionExecute help of the dlmprutility to check theparameters that can b

MessageIDMessage Text ExplanationDLMgetras utility to collect errorinformation, and then contact yourvendor or maintenance company. Refer tothe HDLM U

Table 2-5 Correspondence Between Path Statuses Displayed by the OS andby HDLMPath status displayed by an AIXcommandPath status displayed by the HDLMCa

MessageIDMessage Text ExplanationKAPL10670-Iaa...aa: The HDLM driver's hdisk, which isthe boot disk, was excluded from the harddisks subject to t

MessageIDMessage Text Explanationspecified, and then retry.For details on thedlmodmset utility, seeKAPL08001 to KAPL09000on page 8-48.KAPL10804-EAn in

MessageIDMessage Text ExplanationKAPL10808-IThe user terminated the operation. DetailsThe utility has beenterminated because n wassent to a request.Ac

Message ID Message Text Explanation¢Set OptionInformation¢Clear Data¢Get HDLM ManagerStatus¢Get HDLM DriverStatus¢Get HDLM Alert DriverStatus¢Get SNMP

Message ID Message Text Explanation¢Get HDLM ManagerStatus¢Get HDLM Alert DriverStatus¢Online¢Offline¢Get SNMP TrapInformation¢Set SNMP TrapInformatio

Message ID Message Text ExplanationExecute the DLMgetrasutility for collecting HDLMerror information to collectthe error information, andthen contact

Message ID Message Text ExplanationActionNone.KAPL13001 to KAPL14000Message ID Message Text ExplanationKAPL13001-I The dlmmigsts utility completedsucc

Message ID Message Text ExplanationKAPL13008-WA parameter is invalid. parameter =aa...aaDetailsaa...aa: Parameter(character string)ActionSpecify the -

Message ID Message Text Explanationoption that should bespecified, and then re-execute. For details aboutthe dlmmigsts utility, seedlmmigsts Utility f

Message ID Message Text Explanationafter another, or specifythe modified odmsetfilein dlmmigsts again, andthen re-execute. Fordetails about thedlmmigs

#2When the following conditions are satisfied, a path that has beendetermined to have an intermittent error also becomes subject toautomatic failback:

Message ID Message Text ExplanationKAPL13021-EThe file dlnksetfile was not restored. ActionCheck file name, and thentry again.KAPL13101-I The dlmprere

Message ID Message Text Explanationbb...bb: Return value ofthe executed processing(decimal number)ActionContact your HDLM vendoror the maintenancecomp

Message ID Message Text Explanationaudlog" command, andthen specify any desiredsettings by using the"dlnkmgr set -audlog"command or the

Message ID Message Text ExplanationContact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDLM.KAPL13606-WAn error occ

Message ID Message Text ExplanationKAPL15010-WThe HDLM utility was executed by theuser who does not have the authority.Command Line = aa...aaDetailsaa

Message ID Message Text ExplanationKAPL15104-Waa...aa path(s) were failed to placebb...bb. Command Line = cc...ccDetailsaa...aa: Number of pathsthat f

Message ID Explanation1002 DetailsThere is no path on which the operation can be performed.ActionRefresh the host information, check the path status,

Message ID ExplanationAn error occurred during HDLM internal processing.ActionExecute the DLMgetras utility for collecting HDLM errorinformation, and

Message ID ExplanationRe-execute the command. If the same error occurs again,execute the DLMgetras utility for collecting HDLM errorinformation, and t

Message ID ExplanationActionCheck whether the HDLM manager is running on the host. Ifit is not running, start the HDLM manager.1042 DetailsInformation

Monitoring intermittent errors (functionality whenautomatic failback is used)An intermittent error refers to an error that occurs irregularly because

8-120MessagesHitachi Dynamic Link Manager User Guide for AIX®

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

Functional Differences Between Version 6.2 and VersionsEarlier than 6.2•In HDLM version 6.1.0 or earlier, when you create a system replication(clone)

BDifferences Between HDLM Version 5.9or Later and Version 5.8.1 or EarlierHDLM version 5.9 or later supports MPIO used by AIX 5L V5.2 or later, whichh

Add-in HDLM Driver ModuleHDLM version 5.9 or later supports MPIO used by AIX 5L V5.2 or later. Thishas improved compatibility with the OS because user

• Eliminating the rc.shutdown fileHDLM version 5.8.1 or earlier provided an rc.shutdown file in order toavoid having physical volumes already defined

Commands of the utilities foroperating HDLM volume groupsCorresponding AIX commandsdlmrestvg restvgdlmsavevg savevgdlmsyncvg syncvgdlmunmirrorvg unmir

Migrating Reservation Control SettingsIn HDLM version 5.8.1 or earlier, the reservation control setting is called thereservation level and is specifie

Changing a Virtual I/O Server's Method of RecognizingVirtual SCSI DisksIn HDLM version 5.8.1 or earlier, either PVID or unique_id can be selected

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

Intermittent Error Monitoring ActionsIntermittent error monitoring is performed on each path, and it automaticallystarts as soon as a path is recovere

DDBMSDatabase Management SystemDevDeviceDNSDomain Name ServerFFCFibre ChannelFC-SPFibre Channel Security ProtocolFOFailoverFQDNFully Qualified Domain

HLUHost Logical UnitHTTPHypertext Transfer ProtocolII/OInput/OutputIPInternet ProtocoliSCSIInternet Small Computer System InterfaceLLANLocal Area Netw

MMPIOMultipath I/ONNASNetwork Attached StorageNIMNetwork Installation ManagementNPIVN-Port ID VirtualizationNTPNetwork Time ProtocolOODMObject Data Ma

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

WWWNWorld Wide Name#A B C D E F G H I J K L M N O P Q R S T U V W X Y ZAcronyms-6Hitachi Dynamic Link Manager User Guide for AIX®

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

CLPR(Cache Logical Partition)A function supported by the Hitachi USP series, Universal Storage Platform V/VM series,Virtual Storage Platform series, H

failoverA function for switching to another normal path if there is an error in the current accesspath, thereby enabling the system to continue to ope

Iintermittent errorAn error that occurs irregularly due to, for example, a loose cable connection.LLDEV (Logical Device)A combination of the storage s

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

the path again at a later time, error monitoring will resume when the path isrecovered from the error via an automatic failback.If it takes a long tim

path nameThe path name consisting of the following four elements, separated by periods:- HBA adapter number or adapter type (character string)- Bus nu

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

# A B C D E F G H I J K L M N O P Q R S T U V W X Y ZGlossary-8Hitachi Dynamic Link Manager User Guide for AIX®

IndexAactive host2-42adapter number 3-14, 6-50adapter type 3-14, 6-50audit logcategories and audit events that HDLM canoutput 2-35collecting data 2-34

Dev number Glossary-2directory to which collected information is output7-5, 7-15Displayed program information 6-34displayinginformation 6-32LU informa

HDLMfeatures1-2functions 2-1installing 3-17Migrating 3-53migration of 3-12new installation 3-24new installation of 3-11overview 1-1preparations for an

load balancing 1-2, 2-8, 6-19, Glossary-4load balancing algorithms2-12load distribution using load balancing 2-8log filter 2-32logging levelvalues 6-1

automatically 2-14manually2-19PathID 5-2PathName 5-3Paths to which load balancing is applied 2-10PCI bus number 6-50Performing Failovers and Failbacks

Uunattended installationinstallation-information settings file7-27log file 7-37upgrade installation 3-12utilitiesdlmmigsts Utility for Assisting HDLM

Hitachi Dynamic Link Manager User Guide for AIX®

The figure below shows the action taken when the conditions for anintermittent error are changed during intermittent error monitoring. For thisexample

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

User operationNumber oferrors and timepassed sinceerrormonitoringstartedInformationabout pathsnot subject toautomaticfailbackintermittent errormonitor

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

statuses on the controller and prevents storage system performance fromdecreasing.The following is a list of the storage systems that provide the dyna

Notes on Storage Systems...3-15Notes on the Cluster...

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

Table 2-7 Types of error informationLog name Description Output destinationIntegrated tracefileOperation logs of the HDLMcommand are collected.The def

Log name Description Output destinationHDLMconfiguration logHDLM configuration log is anoperation log of the configurationprocessing for the HDLM driv

¢Collects error information at the Error level and higher.¢Collects error information at the Warning level and higher.¢Collects error information at t

Collecting Audit Log DataHDLM and other Hitachi storage-related products provide an audit logfunction so that compliance with regulations, security ev

Category ExplanationConfigurationAccessAn event indicating that a permitted operation performedby the administrator has terminated normally or failed,

Category Explanation Audit eventSeverity#1Message IDStartup of the HDLMmanager failed.3 KAPL15402-EThe HDLM managerstopped.6 KAPL15403-IStartup of the

Category Explanation Audit eventSeverity#1Message IDAn attempt to displayprogram informationfailed.3 KAPL15108-EAn attempt to displayHDLM management-t

If you use Ctrl + C to cancel the DLMgetras utility for collecting HDLMerror information, audit log data indicating that the DLMgetras utility hasterm

• Specify the following setting in the /etc/syslog.conf file:local0.info /usr/local/audlog•Use the HDLM command's set operation to specify local0

Setting the Audit Log Facility...3-79Checking the Updated Settings...

¢[process-ID]¢message-sectionThe following shows the format of message-section and explains its contents.The format of message-section:common-identifi

Item#ExplanationAgent information Agent informationHost sending request Name of the host sending a requestPort number sendingrequestNumber of the port

Figure 2-14 Example System Configuration Using HDLM and Global LinkManagerCluster supportHDLM can also be used in cluster configurations.HDLM supports

3Creating an HDLM EnvironmentThis chapter describes the procedures for creating an HDLM environment andfor canceling the setup.Make sure that HDLM is

□Settings for Using Oracle RAC 10g or Oracle RAC 11g□Settings for Using VCS□Removing HDLM3-2Creating an HDLM EnvironmentHitachi Dynamic Link Manager U

HDLM System RequirementsCheck the following before installing HDLM.For OS patches and software provided by OS vendors, download them fromthe Web site

OS KernelAIX V7.1 (Virtual I/O Server)#3ioslevel 2.1.0.0 to 2.2.1.xx (where xx is a number)#1Every SP is applicable, unless otherwise specified.#2To s

¢Universal Storage Platform V/VM series (excluding XP20000 andXP24000)¢Hitachi Virtual Storage Platform¢HUS100 seriesNote:When you install HTC_ODM in

• P9500•SVS• HUS100 seriesThe applicable storage systems require a dual controller configuration. If youuse the system in a hub-connected environment,

OS Related Programs• Oracle RAC 10g 10.1.0.5.0If the HDLM device is specified for direct access:ASM + raw devices#1•Oracle RAC 10g 10.2.0.2.0If the HD

Displaying the Correspondences Between hdisks, OS Management Path IDs, andLDEVs...

OS Related Programs•VCS 5.1#4•Oracle RAC 10g 10.2.0.4.0If the HDLM device is specified for direct access:ASM + raw devices• Oracle RAC 10g 10.2.0.5.0I

OS Related Programs• PowerHA 7.1.1Client: No Technology LevelServer: ioslevel 2.1.0.0 to 2.2.1.xx (where xx is a number)#1When using Technology Level

Disk Capacity RequirementsThe following table lists the disk capacity used by the host.Table 3-5 Disk Capacity Occupied by the HostDirectory Disk capa

Item Supported numberTotal number of paths 1 to 8,192#1For details on the maximum number of LUs that can be recognized by aCHA port, see the specifica

Installing HDLM on a server where HDLM has not yet been installed iscalled a new installation.Upgrade installation of HDLMInstalling a new version of

• When HDLM is installed, all devices shown under Devices that HDLM canmanage in Devices Managed by HDLM on page 2-3 are set to be targetsfor HDLM man

• If you want to use HDLM in a client partition to which a virtual HBA isapplied by using the virtual I/O server NPIV functionality, set the NPIVoptio

Notes on Trace FilesIn HDLM 5.6 or later, trace files for versions of HDLM earlier than 5.6 aredivided into integrated trace files and trace files. Th

Notes on the Cluster•When you use HDLM in a cluster configuration, you must install the sameversion of HDLM on all the nodes that comprise the cluster

Installing HDLMWhen you install HDLM, Hitachi Network Objectplaza Trace Library will also beinstalled. The file path of the integrated trace informati

Format...6-3To Set the Path Statistics to 0.

In addition to installing HDLM on a typical host, you can install it in thefollowing environments:•Boot disk• You can install HDLM on a virtual I/O se

Only upgrade installations are supported.Table 3-8 Combination of Installation Methods that Are Available in anPowerHA Environment and the Supported I

¢Upgrading or Re-installing HDLM in a PowerHA 5.5 or PowerHA 6.1Environment (in a Boot Disk Environment) on page 3-57 in InstallingHDLM in a PowerHA 5

Only new installations, upgrade installations, and re-installations aresupported.Table 3-10 Combinations of Migration Methods Available in an PowerHAE

Preparations for a New Installation of HDLMIn this subsection, you will perform such preparations as backing up theHDLM management-target devices, app

For details on how to set up the storage system, see the maintenancedocumentation for the storage system. If you are using PowerHA, see alsoStorage Sy

4. Restart the system.# shutdown -Fr5. Execute the following command to confirm that the kernel mode has beenchanged properly.# bootinfo -KSet Up Clus

In this example, hdisk3 and hdisk4 are recognized as devices to bemanaged by HDLM. If all devices to be managed by HDLM are recognized,proceed to step

If the KAPL09172-E message is displayed, the hdisk for the device that ismanaged by HDLM still remains. Re-execute the procedure starting fromstep 5.D

18. Enable the defined parent device (fscsin).# cfgmgr19. Execute the chdev command, as required, to change the attributes of thehdisk:# chdev -l hdis

Format...7-5Parameters...

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

30. Check the path configuration according to the procedure described inChecking the Path Configuration on page 3-69.When Installing HDLM in a Boot Di

4. If there is no directory for mounting the DVD-ROM, make the directory.# mkdir /cdromcdrom is the desired directory name. Hereafter, cdrom is used f

Store the license key file directly under the /var/tmp/ directory byusing the hdlm_license name./var/tmp/hdlm_licenseNote that the hdlm_license and dl

16. Make sure that the boot disk is in a multi-path configuration:# lspath -l hdisk10 -s availableAvailable hdisk10 fscsi0Available hdisk10 fscsi1...T

25. Execute the chdev command, as required, to change the attributes of thehdisk:# chdev -l hdisk-name -a queue_depth=8 -a rw_timeout=6026. Execute on

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

Preparations for an Upgrade Installation or Re-installation of HDLMMake necessary preparations, such as backing up the HDLM management-target devices.

Performing an Upgrade Installation or Re-installation of HDLMThis subsection explains how to perform an upgrade installation from anearlier version, o

If an upgrade installation or re-installation fails, perform a newinstallation, and then re-execute setup to reflect the settings that havebeen backed