HP P9500 Instrukcja Użytkownika

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

dlmrmprshkey Utility for Clearing HDLM Persistent Reservation (Shared-HostMethodology)...

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

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

Changing a Virtual I/O Server's Method of Recognizing Virtual SCSI Disks...B-6Acronyms and abbreviationsGlossaryIndexxiHitachi Dy

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

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

xiiHitachi Dynamic Link Manager User Guide for AIX®

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

Before you upgrade HDLM on a NIM client, make sure that your HDLM licensehas not expired. If the license has expired, prepare a valid license key orli

Make sure that DLManager.mpio.rte exists among the file set items onthe output list, and that only the COMMITTED status is displayed.If there is even

To migrate to HDLM version 5.9 or later:1. Log in to AIX as a user with root permissions.¢If you are using a virtual I/O server, see the virtual I/O s

9. Execute the following command to delete the virtual target device in thevirtual I/O server:$ rmdev -dev vtscsin10. Insert the DVD-ROM.11. If there

# /cdrom/HDLM_AIX/hdlmtool/dlmmigsts -r -odm /tmp/any-desired-directory/odm-environment-settings-file-name -set /tmp/any-desired-directory/set-environ

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

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

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

# 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

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

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

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

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:# /

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

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-85. 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

Settings for Using PowerHATo use PowerHA, install HDLM on all hosts comprising the cluster, configurethe hdisks, set up the storage system (if using T

Communications Applications and Services, HACMP for AIX,Extended Configuration, Extended Resource Configuration, HACMPExtended Resource Configuration,

1. Check the setting for the reserve_policy attribute of the hdisk.# lsattr -El hdisk-name -a reserve_policyreserve_policy PR_exclusive

• Hitachi Command Suite Global Link Manager Messages, MK-95HC108• Hitachi Adaptable Modular Storage Series User's Guide• Hitachi Simple Modular S

Settings for Using Oracle RAC 10g or Oracle RAC 11gSettings for MISSCOUNT and DISKTIMEOUTWhen a host and an Oracle RAC voting disk are connected by mu

Table 3-23 Formula for Calculating DISKTIMEOUTStorage system typeNumberof pathsconnected to thevotingdiskFormula for obtaining the value ofDISKTIMEOUT

4. Execute the following command to display all the activated volumegroups.# lsvg -o5. Among the displayed volume groups, inactivate the volume groups

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

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

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

$ 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

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

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

paragraphs whenever possible. All comments become the property of HitachiData Systems Corporation.Thank you!xviiiPrefaceHitachi Dynamic Link Manager U

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-33. 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 o

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

# /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

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

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 -d -l hdisk10 -p fscsi5 -w 50060e800436e240,6a0000000000004. Check that the path has been deleted.# /usr/DynamicLinkManager/bin/dlnkmgr view

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

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

15. Execute the following command to reconfigure the device:# cfgmgr -l fcsnTo reconfigure the device, specify the device name of the PCI slot whereth

# cfgmgr -l fcsnSpecify the device name of the PCI slot (fcs device) where each HBAhas been replaced. n indicates the instance number of the fcs devic

© 2011-2013 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

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

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

Place in Online status the path that goes through the HBA to which thereplaced cable is connected.Depending on the NPIV option setting for the dlmodms

2. Execute the dlmodmset utility for setting the HDLM execution environmentODM to check the NPIV option setting.# /usr/DynamicLinkManager/bin/dlmodmse

8. Execute the following command to reconfigure the HBA device:# cfgmgr -l fcsnfcsn indicates the name of the parent device that was acquired in step

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

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

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

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 Chapter 8, Messages onpage 8-1.If the error occurs again after you thou

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

¢Execute the command as a user with root permissions.¢To specify a value that contains a space in its parameter, enclose theentire value in double quo

To Display the Format of the Clear Operation-helpDisplays the format of the clear operation.Example# /usr/DynamicLinkManager/bin/dlnkmgr clear -helpcl

# /usr/DynamicLinkManager/bin/dlnkmgr helpdlnkmgr: Format dlnkmgr { clear | help | offline | online | set | view | add | delete}KAPL01001-I The HD

# /usr/DynamicLinkManager/bin/dlnkmgr help helphelp: Format dlnkmgr help { clear | offline | online | set | view | add | delete }KAPL01001-I The H

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

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

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

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

be specified for the -hdev parameter. This parameter is not casesensitive.ExampleThe following shows an example of placing offline path for which theh

OS_Path_ID [-s] Valid value AutoPATH_ID { 000000 - 999999 }(Decimal) HBA_ID { 00000 - 99999 }(Decimal) CHA_ID { 00000 -

FormatTo Place Paths Online/usr/DynamicLinkManager/bin/dlnkmgr online[-path][-hba HBA-adapter-number.bus-number-or-adapter-type.adapter-number|-hbaid

between these two parameter values. For details about the viewoperation, see view (Displays Information) on page 6-33. The HBA-adapter-number.bus-numb

AutoPATH_IDs are re-assigned every time the host is restarted. When youwant to add a new LU without restarting the host, AutoPATH_IDs are re-assigned

AutoPATH_IDs are re-assigned every time the host is restarted. When youwant to add a new LU without restarting the host, AutoPATH_IDs are re-assigned

to the P-VOL will be in the Online status regardless of this parameterspecification. To change the status of a specific LU, use the -lu and -pathid pa

OS_Path_ID]] [-s] dlnkmgr online [-path] -hapath [-lu -pathid AutoPATH_ID] [-s] dlnkmgr online [-path] -dfha [-lu -pathid AutoPATH_ID] [-s] Val

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

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

¢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

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

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

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

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

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

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

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

-hdev host-device-nameDisplays information only for the paths accessing the specified hostdevice.Specify hdisk name for host-device-name.The host-devi

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-53.-srt {lu|cp}Use this

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

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

#1The path information is displayed only when a value is specified for the -path -item parameter.#2This storage system applies when the dynamic I/O pa

Table 6-14 Product ID Displayed by the View -Path OperationModel names of storagesystemsProduct IDWithout the -stnameparameterWith the -stnameparamete

To Display LU InformationWhen displaying LU information, if the -item parameter, -c parameter, orthe -c -item parameter is specified at the same time

00001 000007 Online003E hdisk4 00000 000008 Online 00001 000009 Online003F hdisk5 00000 000010 Online

Item that can be added Subsequent parameterPhysical-SerialNumber vidPhysical-iLU vidPhysical-ChaPort vidOrg-Product haOrg-SerialNumber haOrg-iLU haHaS

Example 2When using Hitachi AMS2000 series, Hitachi SMS series, or HUS100 seriesand displaying LU information with DPC added to the display items: # /

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

# 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 summarydisplayedSummarydisplayedSLPR#1SLPR#2The number of the SLPR to which an LU belongs,indicated by a number from 0 to

Displayed itemDescriptionNo summarydisplayedSummarydisplayed31. Note that a hyphen (-) is displayed if thefollowing items are subject to display:• CHA

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

Displayed itemDescriptionNo summarydisplayedSummarydisplayedWhen a virtual ID is not used, a hyphen (-) isdisplayed.Physical-ChaPort-When a path is mi

Table 6-18 Items Displayed as HBA Port InformationItem DescriptionHbaIDHBA port IDPort.BusPort (HBA adapter number in character string) and Bus (busnu

To Display CHA Port Information-chaUse this parameter to display information about the paths to each CHAport. HDLM displays the unique CHA port ID ass

Sorts the CHA port information by the storage system model IDs(Product), storage system serial numbers (S/N), and CHA portnumbers (ChaPort).-tDoes not

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

000004 hdisk1 00001 9500V.0051.0015000005 hdisk2 00001 9500V.0051.0020KAPL01001-I The HDLM command completed normally. Operation name = view

FormatTo Add a Path Dynamically/usr/DynamicLinkManager/bin/dlnkmgr add -path [-s]To Display the Format of the add Operation/usr/DynamicLinkManager/bin

dlnkmgr add -path [-s]KAPL01001-I The HDLM command completed normally. Operation name = add, completion time = yyyy/mm/dd hh:mm:ss#delete (Deletes

:KAPL01164-I Paths were deleted. (number of paths deleted = 2, completion time = yyyy/mm/dd hh:mm:ss)To Display the Format of the delete Opera

6-72Command ReferenceHitachi Dynamic Link Manager User Guide for AIX®

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

□installux.sh Utility for HDLM Common Installer7-2Utility ReferenceHitachi Dynamic Link Manager User Guide for AIX®

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-25.• The dlmpremkcd utility for preparing for a system ba

Table 7-1 Examples of the Starting Time of the Host and the ExecutionTime of the UtilitiesOperationNumber of pathsfor an LU/ Totalnumber ofpaths#2Exec

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

collected information is archived in a file and saved to the directory that youspecified. The following files are output:• Name-of-the-directory-conta

The following is an example of the coding in the file that defines theinformation to be collected.Figure 7-1 Coding Example of a File that Defines the

entering y instructs the DLMgetras utility to overwrite the existing files;entering n (or anything other than y) instructs the utility to terminatewit

Output directory#1Files Explanationdlmwebagent[1-16].logHitachi Command Suite CommonAgent Component log filesdlminquiry[1-2].logdlminquiry[1-2].txtInq

Output directory#1Files Explanationusr/DynamicLinkManager/configdlmmgr.xmldlmmgr setting filedlmwebagent.propertiesHitachi Command Suite CommonAgent C

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

Output directory#1Files Explanationlsps-a.txtSwap area, usage of swaplspv.txtPhysical volume informationlsvg.txtInformation of volume groupsMaintenanc

An output directory is created in the specified directory when you openthe getras.tar.Z file.#2In the actual file name, a file number is appended to T

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

Performs automatic hdisk reconfiguration required to reflect the changedreservation policy. If this parameter is omitted, the hdisk reconfigurationnee

ContentsPreface...xiiiIntended audience...

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

# /usr/DynamicLinkManager/bin/dlmchpdattr -ouniquetype = disk/fcp/Hitachi reserve_policy : no_reserveKAPL10571-I The dlmchpdattr utility comple

location from the DVD-ROM, also copy the UtilAudLog file to the samedirectory to which you copy the dlmgetrasinst file.• Because dlmgetrasinst first s

Output directory#Files Explanation.historyDefault history file in the Cshell (csh).sh_historyDefault history file in the Kornshell (ksh)bootlist-v.txt

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

Format/usr/DynamicLinkManager/bin/dlminstcomp [-h]Parameter-hDisplays the format of the dlminstcomp utility.dlmmigsts Utility for Assisting HDLM Migra

Restores the settings files by using the names specified in the -odm and -set parameters.-odm odm-environment-settings-file-nameSpecifies the file nam

| -v {on | off}| -j {on | off}} [-s]| -o| -h }Parameters-r { on | off }Enables or disables the LUN RESET option.on: Enableoff: DisableThe default is o

off: Do not output messages.The default is off.You do not need to reconfigure the hdisk or restart the host when youchange this parameter.In the OS er

Location: U78AA.001.WZSJPKR-P1-C4-T1-W50060E801082EEA0-L5C000000000000DescriptionHDLM detected a path failure.Probable CausesHDLM detected a pa

NPIV Option : offOS Error Log Output : offKAPL10800-I The dlmodmset utility completed normally.#In t

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

up a cluster configuration. In this case, this utility clears the Reservation Keyto cancel the persistent reservation.Format/usr/DynamicLinkManager/bi

When multiple hdisks are specified, even if an error occurs duringprocessing, the processing continues for all hdisks.-hDisplays the format of the dlm

reserve_policy : PR_shared Regist Key : [0xaaaaaaaaaaaaaaaa] , Key Count : 4 Regist Key : [0xdddddddddddddddd] , Key Count : 2

-uDeletes the HDLM-backup information from the OS backup setting, andrestore the setting to its original state.-hDisplays the format of the dlmpremkcd

ExamplesIn the following example, the utility is executed in a boot disk environment:# /usr/DynamicLinkManager/bin/dlmpreremove -sKAPL13103-I HDLM can

NoteBefore executing the dlmrmdev utility, stop all processes and services usingthe paths managed by HDLM. If you execute the dlmrmdev utility without

• Verify that no error has occurred on the path connected to the specifiedphysical volume. If an error has occurred, the persistent reservation(shared

[INSTALLATION_SETTINGS] sectionThis section defines information that is used when the installhdlm utility isexecuted. Specify this section name at the

Key name#1Description#2Necessity ofdefinitionMaximumnumberofcharactersNewinstallationUpgradeinstallation or re-installationThe default is /var/DLM/dlm

If no value is specified for either of these keys, the files below are read inthe order listed:a. License key file (/var/tmp/hdlm_license)b. File cont

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

¢For a new installation:The default value will be used.¢For an upgrade installation or re-installation:The previous setting will be inherited.#1Enter

Key name#1Description#2Necessity ofdefinitionMaximumnumberofcharactersNewinstallationUpgradeinstallation or re-installationoff: Disabled (default)odm_

Table 7-8 Keys in the [ENVIRONMENT_SETTINGS] SectionKey name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinsta

Key name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinstallation orre-installationYou can set a level from 0

Key name#1Description#2Necessity ofdefinitionMaximumnumber ofcharactersNewinstallationUpgradeinstallation orre-installationoff: Disabledauto_failback_

Legend:Optional: If a key and its setting are not specified, one of the followingvalues will be used:¢For a new installationThe default value will be

odm_online_e_io_block=off odm_npiv_option=off odm_os_error_log=off[ENVIRONMENT_SETTINGS] load_balance=on load_balance_type=exlio load_balance_same_pa

• If the installhdlm.log file cannot be output for some reason, such asthere being insufficient capacity on the output disk, a message is outputto thi

7-44Utility ReferenceHitachi Dynamic Link Manager User Guide for AIX®

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

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

□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 ExplanationKAPL01

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-33.KAPL01019-WThe target path was not found

MessageIDMessage Text Explanationthe error information,and then contact yourHDLM vendor or thecompany for whichyou have a servicecontract. For details

MessageIDMessage Text Explanationhelp (Displays theOperation Format) on page6-4.KAPL01036-EThe Offline path cannot be placed online.PathID = aa...aaDe

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

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-33.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 Explanationaa...aa: Online,Online(S), Online(D),or Offline(C)ActionUse the view operation ofthe HDLM command(dlnkmgr) to check t

MessageIDMessage Text ExplanationKAPL01071-IThe permanent license was installed. DetailsThe license was renewedand is registered as apermanent license

MessageIDMessage Text Explanationexecution of the HDLM command.Operation name = aa...aaActionAfter the processing tochange the pathconfiguration has f

MessageIDMessage Text ExplanationActionMake sure that the licensekey file is correct, and thenre-execute./var/tmp/hdlm_licenseKAPL01083-IThere is no l

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 Explanation(Displays the OperationFormat) on page 6-4.KAPL01089-EOne of the following was executed at thesame time as an HDLM co

MessageIDMessage Text ExplanationRe-execute the command.If the same error occursagain, execute theDLMgetras utility forcollecting HDLM errorinformatio

MessageIDMessage Text ExplanationKAPL01102-IAll the paths which pass the specifiedaa...aa port will be changed to theOffline(C) status. Is this OK? [y

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

MessageIDMessage Text ExplanationRestart the HDLMManager, and execute thedlnkmgr view -sys -audlog command, andthen specify the desiredsetting by usin

MessageIDMessage Text ExplanationActionContact your HDLM vendoror maintenance company ifthere is a maintenancecontract for HDLM.KAPL01119-WAn error oc

MessageIDMessage Text Explanationplaced dd...dd; ee...ee path(s) were not.Operation name = ff...ffThe number of pathsprocessed by an onlineoperation i

MessageIDMessage Text Explanation(dlnkmgr) to check thesetting for the host,storage, and LUs. Fordetails on the viewoperation, see view(Displays Infor

MessageIDMessage Text ExplanationKAPL01159-IPaths were added. (number of pathsadded = aa...aa, completion time =bb...bb)DetailsThis message indicatest

MessageIDMessage Text Explanationto check whether thepaths have alreadybeen deleted fromHDLM.KAPL01161-IThis operation will change the pathconfigurati

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

MessageIDMessage Text ExplanationHDLM, the maintenancecompany.KAPL01164-IPaths were deleted. (number of pathsdeleted = aa...aa, completion time =bb...

MessageIDMessage Text Explanationcancel the operation, entern.KAPL01167-IAll paths will be set to Online orOnline(D). Is this OK? [y/n]:DetailsAll pat

MessageIDMessage Text Explanationn. Before you execute theprocessing, you mustcheck the path status byexecuting the viewoperation of the HDLMcommand d

MessageIDMessage Text ExplanationUse the view operation ofthe HDLM command(dlnkmgr) to check thestatus of the path.KAPL03001 to KAPL04000Message ID Me

Message ID Message Text Explanationmaintenance contract forHDLM. For details on theDLMgetras utility, seeDLMgetras Utility forCollecting HDLM ErrorInf

Message ID Message Text ExplanationExecute the DLMgetrasutility for collecting HDLMerror information, and thencontact your HDLM vendoror the maintenan

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

MessageIDMessage Text Explanationthis message, execute thedlnkmgr view -sys -sfunc command, and thencheck the option settings.For options with setting

MessageIDMessage Text Explanationpipe file, which is used incommunication with HDLMcommands.aa...aa: OS error code(decimal (base-10)number)ActionExecu

MessageIDMessage Text Explanationerror information, and thencontact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDL

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 Explanationcompany if there is amaintenance contract forHDLM. For details on theDLMgetras utility, seeDLMgetras Utility forColle

MessageIDMessage Text ExplanationIncrease the amount ofmemory available for theprocess.KAPL04026-IThe temporary license is valid. Thelicense expires i

MessageIDMessage Text Explanationdefault values. If some ofthe options can be read,those values can be used.As for any remainingvalues, the default va

MessageIDMessage Text ExplanationAll the paths that pathhealth checking examinedare fine.aa...aa: Path ID for thepath examined by pathhealth checking.

MessageIDMessage Text Explanationcontact your HDLM vendoror maintenance company ifthere is a maintenancecontract for HDLM. Fordetails on the DLMgetras

KAPL05001 to KAPL06000Message ID Message Text ExplanationKAPL05003-I The HDLM driver (filter component) wassuccessfully attached to Disk (aa...aa),Par

Message ID Message Text Explanationdd...dd: Filter drivermanagement table address(hexadecimal number)ActionCheck whether the HDLMdriver has startednor

Message ID Message Text ExplanationThe processing for therequested IOCTL operationwas successful.aa...aa: IOCTL code(hexadecimal number)ActionNone.KAP

Message ID Message Text ExplanationKAPL05508-I Data for maintenance(PathCheck): ErrorCode = aa...aa, Status Validity =bb...bb, Status Code = cc...cc,

Message ID Message Text ExplanationActionNone.KAPL05819-I Data for maintenance: aa...aa bb...bbcc...cc dd...dd.DetailsThe filter driver outputsthis me

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 Explanationcontact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDLM and report the errorand

Message ID Message Text ExplanationWhen a log output requestwas made from the filterdriver, the log informationwas discarded because of amemory alloca

Message ID Message Text Explanationoutput message, its loginformation was discardedby the HDLM alert driver.aa...aa: Message code(hexadecimal number)b

MessageIDMessage Text Explanationcc...cc: Detailedinformation 2 (decimal(base-10) number)dd...dd: Detailedinformation 3 (decimal(base-10) number)Actio

Message ID Message Text Explanationaa...aa: Path identifier(hexadecimal number)bb...bb: Error code(hexadecimal number)¢When the path error isdetected

Message ID Message Text Explanationff...ff: Host LU number(same as PathName ofview -path) (hexadecimalnumber)gg...gg: Dev number(same as DNum of view

Message ID Message Text Explanation(decimal (base-10)number)ActionErrors are detected in allthe paths connected to theLUs. See What To Do for aPath Er

Message ID Message Text Explanation(decimal (base-10)number)ActionTo return a path to theOnline(D) status, resolvethe path failure, and thenexecute th

MessageIDMessage Text ExplanationActionCheck the HDLM driverstatus and remove thedrivers.KAPL09019-EAn attempt to cancel the registration ofthe bundle

MessageIDMessage Text ExplanationActionExecute the dlmrmdevutility, and then re-executethe remove program.KAPL09023-EA file or directory related to HD

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 Explanationsoft/HiCommand/DVM/agent/module/hdlm/usr/HDVM/HBaseAgent/agent/classes/com/Hitachi/soft/HiCommand/DVM/agent/module/HD

MessageIDMessage Text ExplanationExecute the dlmrmdevutility, and then re-executethe installation program.KAPL09076-IThe permanent license was install

MessageIDMessage Text ExplanationInstall a permanent licenseby the expiration day.KAPL09082-WThe temporary license expired. ActionEnter a permanent li

MessageIDMessage Text ExplanationRe-install after removingthe fileset that was outputin the message.KAPL09112-EThe license key file is invalid. File n

MessageIDMessage Text Explanationaa...aa : /var/tmp/hdlm_licenseActionIf a license key file exists,delete it./var/tmp/hdlm_licenseKAPL09116-WThe comma

MessageIDMessage Text ExplanationWait a while, and thenreperform the installationor remove. After theinstallation or remove hasfinished, use the backu

MessageIDMessage Text ExplanationDelete the hdisk, and thenre-execute the installationprogram.KAPL09179-IData for maintenance: aa...aa bb...bb Details

MessageIDMessage Text ExplanationThe installation informationsettings file is not specifiedfor the second parameterin the installhdlm utilityfor insta

MessageIDMessage Text ExplanationCheck the error messagethat was output just beforethis message, and thenperform the actionindicated in that errormess

MessageIDMessage Text ExplanationIf the error code is 2:You do not have writepermission for the /tmp directory. Makesure that you haveaccess permissio

Path status transition...2-20The online path status...

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 ExplanationThe /var directorydoes not have enoughunused capacity, orthe user does not havewrite permission for it.Make sure ther

MessageIDMessage Text Explanationcapacity is insufficient,allocate the requiredamount of capacity, andthen retry the operation.For details about how t

MessageIDMessage Text ExplanationIf aa...aa is dlmodmset ordlnkmgr :The correct location ofdlmodmset anddlnkmgr is /usr/DynamicLinkManager/bin. If dlm

MessageIDMessage Text Explanationmaintenance contract forHDLM.KAPL09220-WThe composition of the installationinformation settings file is invalid. Erro

MessageIDMessage Text Explanationspecifies the executedprocessingbb...bb: Return value(decimal number) of theexecuted processingcc...cc: Line number(d

MessageIDMessage Text ExplanationSpecify the revisedinstallation informationsettings file and then retrythe operation.KAPL09230-WThe definition of the

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

MessageIDMessage Text Explanationaa...aa: Error number(decimal number) thatspecifies the executedprocessing.ActionIf the error code is 1:The log file

MessageIDMessage Text ExplanationActionCheck the status of HDLMby executing lslpp -laDLManager.mpio.rte.If HDLM is not installed:Re-executeinstallhdlm

MessageIDMessage Text Explanationaa...aa: Specified file name(character string)ActionSpecify the correct file,and then retry theoperation.KAPL09239-IT

#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 ExplanationContact your HDLMvendor or themaintenance companyif there is amaintenance contractfor HDLM.KAPL09242-ENo usable JDK o

MessageIDMessage Text Explanationaa...aa: The specifiedparameter (characterstring)ActionWith the -h parameterspecified, execute thedlminstcomp utility

MessageIDMessage Text Explanation/usr/bin/errupdate -q -f /usr/DynamicLinkManager/common/.dlmfdrv_err_templateIf the message is outputafter command ex

MessageIDMessage Text Explanation¢If an installation isperformed from theDVD-ROM, confirmthat the DVD-ROM isnot damaged.¢If an installation isperforme

MessageIDMessage Text Explanationretry. For details on theDLMgetras utility, seeDLMgetras Utility forCollecting HDLM ErrorInformation on page 7-5.KAPL

MessageIDMessage Text ExplanationKAPL10005-WThe number of parameters is insufficient. DetailsThe -f parameter existsbut the file for defining theinfor

MessageIDMessage Text ExplanationYou do not have writepermission for thespecified directory, or thecreation of a subdirectoryof the specified director

MessageIDMessage Text Explanationspecified file. Thedisplayed directory will beignored and the DLMgetrasutility for collecting HDLMerror information w

MessageIDMessage Text Explanation(decimal (base-10)number)bb...bb: Indicated contentsof a lineActionAfter the DLMgetras utilityfor collecting HDLM err

MessageIDMessage Text ExplanationDLMgetras Utility forCollecting HDLM ErrorInformation on page 7-5.KAPL10014-WYou lack read permission for the specifi

This storage system applies when the dynamic I/O path control function isdisabled.Path status transitionEach of the online and offline statuses descri

MessageIDMessage Text ExplanationCollecting HDLM ErrorInformation on page 7-5.KAPL10016-WThe root directory has been specified inthe first parameter.D

MessageIDMessage Text Explanationterminated beforecompletion. If the directoryis unnecessary, deletedirectory. For details onthe DLMgetras utility, se

MessageIDMessage Text ExplanationRe-execute the DLMgetrasutility. For details on theDLMgetras utility, seeDLMgetras Utility forCollecting HDLM ErrorIn

MessageIDMessage Text ExplanationExecution of the compresscommand failed.aa...aa : compresscommand output messageActionSee the details in themessage,

MessageIDMessage Text ExplanationFor details on thedlmrmdev utility, seedlmrmdev Utility forDeleting HDLM Drivers onpage 7-30.KAPL10523-EAn attempt to

MessageIDMessage Text ExplanationContact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDLM.KAPL10526-IAn attempt to

MessageIDMessage Text ExplanationKAPL10531-IThe status of all of the HDLM drivers waschanged to "Defined".ActionNone.KAPL10532-EThe status o

MessageIDMessage Text ExplanationIf you do not want toexecute dlmpostrestoreutility, enter n.KAPL10556-WThe entered value is invalid. Re-enter. [y/n]:

MessageIDMessage Text ExplanationAny other error code:Contact your HDLMvendor or themaintenancecompany, if you havean HDLM maintenancecontract.KAPL105

MessageIDMessage Text Explanationutility is correct, and thenre-execute it.KAPL10574-WThe specified parameters cannot bespecified at the same time. pa

change the status to the Online(D) status, specify the -dfha parameterfor the HDLM command's online operation.#The status changes to this status

MessageIDMessage Text Explanationaa...aa: The specifiedattributeActionWith the -h parameterspecified, execute thedlmchpdattr utility. Makesure that th

MessageIDMessage Text Explanationoccurred duringdlmchpdattr utilityprocessing.aa...aa: Error number(decimal number)bb...bb: Return code(decimal number

MessageIDMessage Text ExplanationIf the error code is 6,2 or7,-1:The bosbootcommand is not in thedefault location, or theuser does not haveexecution p

MessageIDMessage Text ExplanationNone.KAPL10587-WThe specified ODM is not installed.parameter value = aa...aaDetailsThe specified ODM is notinstalled.

MessageIDMessage Text ExplanationKAPL10644-WThe specified parameters cannot bespecified at the same time. parameter =aa...aaDetailsThe specified param

MessageIDMessage Text ExplanationKAPL10648-EAn internal error occurred in the dlmprutility. Error Code = aa...aaDetailsAn error not caused by theuser

MessageIDMessage Text ExplanationKAPL10650-Iaa...aa: NO RESERVATION DetailsA LU has not beenreserved.aa...aa: Hdisk nameActionNone.KAPL10651-IThe user

MessageIDMessage Text Explanationclear the HDLM persistentreservation.KAPL10800-IThe dlmodmset utility completednormally.DetailsThe dlmodmset utilityc

MessageIDMessage Text Explanationthe HDLM User's Guide for instructionshow to execute the DLMgetras utility.aa...aa: Error Code(character string)

MessageIDMessage Text ExplanationNo operation has beenspecified.ActionExecute help of thedlmodmset utility to checkthe operations that can bespecified

Figure 2-9 Path status transitionsLegend:Online operation: Online operation performed by executing the dlnkmgrcommand's online operation.Offline

Message ID Message Text Explanation¢Get SNMP TrapInformation¢Set SNMP TrapInformation¢Set LU Load Balance¢Get Path Status LogInformation¢Get Local Tim

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

Message ID Message Text Explanation¢Add Path Information¢Delete PathInformation¢Set StorageIdentificationInformationbb...bb: Error statusreturned from

Message ID Message Text ExplanationThis information isrequired for resolvingproblems.aa...aa: XML informationActionNone.KAPL11908-I XML transmission -

Message ID Message Text ExplanationAssisting HDLM Migrationon page 7-20.KAPL13007-WNo parameter has been specified. ActionSpecify the -h option inthe

Message ID Message Text Explanationdlmmigsts again, and thenre-execute.If parameter =-set, specify dlnksetfile indlmmigsts again, and thenre-execute.

Message ID Message Text ExplanationContact your HDLM vendoror the maintenancecompany if there is amaintenance contract forHDLM.KAPL13015-EThere is an

Message ID Message Text ExplanationGuide for instructions how to execute theDLMgetras utility.KAPL13019-EThe same file name was specified forodmsetfil

Message ID Message Text ExplanationActionNone.KAPL13108-EAn internal error occurred in thedlmpreremove utility. Error Code =aa...aa, bb...bb Execute t

Message ID Message Text Explanationutility, see dlmpreremoveUtility for Executed BeforeRemoving HDLM on page7-29.KAPL13141-I The dlmpremkcd utility co

This path is deleted when the AIX chdev command is executed on anhdisk where an Online or Offline(E) path exists. To restore the deletedpath, remove t

Message ID Message Text ExplanationActionTo execute thedlmpremkcd utility, enter"y". If you do not want toexecute the dlmpremkcdutility, ent

Message ID Message Text Explanationenvironment for executingthe dlmpremkcd utility.aa...aa: Error number(decimal number)bb...bb: Return code(decimal n

Message ID Message Text ExplanationThe specified parameterscannot be specified at thesame time.aa...aa: The specifiedparameterActionWith the -h parame

Message ID Message Text ExplanationActionEnter either "y" or "n".KAPL13165-I The user stopped the operation. DetailsThe dlmrmprshk

Message ID Message Text Explanationmaintenance contract, themaintenance company.KAPL13168-EThe system environment is invalid. ErrorCode = aa...aa,bb..

Message ID Message Text Explanationsettings by using the"dlnkmgr set -audlog"command or the "dlnkmgrset -audfac" commandas necessa

Message ID Message Text Explanationcompany if there is amaintenance contract forHDLM.KAPL13606-WAn error occurred during processing tooutput the audit

Message ID Message Text ExplanationKAPL15060-I DLMgetras was invoked. Command Line= aa...aaDetailsaa...aa: Name of the utilitythat the user executedKA

Message ID Message Text ExplanationKAPL15094-EAn attempt to clear the server from thePR_shared reservation for the targetdevice has failed. Command Li

Message ID Message Text ExplanationKAPL15110-EAn attempt to display information aboutHDLM-management targets has failed.Command Line = aa...aaDetailsa

The last available online path for each LU cannot be placed offline byexecuting the offline operation. This ensures access to the LU. For detailson th

Return Codes for Hitachi Command Suite Common AgentComponentWhen an operation requested of HDLM from Global Link Manager terminatesabnormally, or term

Message ID Explanation1017 DetailsThe target path(s) are already Offline(C).ActionUpdate the host information, and then check the pathstatus.1019 Deta

Message ID ExplanationSet the intermittent error-monitoring interval to a value thatis equal to or greater than (automatic- failback-checking-interval

Message ID ExplanationDLMgetras utility for collecting HDLM error information, andthen contact your HDLM vendor or maintenance company ifyou have a ma

8-136MessagesHitachi 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

Setting up intermittent error monitoringWhen you enable the intermittent error monitoring function, specify thefollowing monitoring conditions: the er

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

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

Figure 2-11 Action What Will Happen When an Intermittent Error Occurson a PathWhen an intermittent error does not occurIf an error does not occur on a

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

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

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

When an error occurs on a path that was in the Online status, path health checkingchanges the status of the path to the Offline(E) status.Path health

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

# 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 host 2-44adapter number 3-15, 6-52adapter type 3-15, 6-52add 6-68audit logcategories and audit events that HDLM canoutput 2-37collecting

Ddecimal number, meaning 6-48default and recommended values 6-18delete 6-70Dev 2-3, 2-4, Glossary-2Dev number Glossary-2directory to which collected i

HHAM environment Glossary-3handlingpath error 5-3HBA 2-4HBA (Host Bus Adapter) Glossary-3HBA adapter number 6-52HDev 2-5HDevName 5-3HDLMfeatures 1-2fu

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

Kkernel modeswitching 3-24LLB 8-3LDEV (Logical Device) Glossary-4load balancing 1-2, 2-8, 6-20, Glossary-4load balancing algorithms 2-12load distribut

path 2-3, Glossary-5adding dynamically 6-68checking the configuration 3-72deleting dynamically 6-70path errorhandling 5-3path health checking 1-3, 2-2

syslog 2-33system configuration 2-3Ttaking actions forhardware error 5-5program error 5-6, 5-7target ID 6-52trace file 2-32trace file size 6-21trace l

Hitachi Dynamic Link Manager User Guide for AIX®

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

Notes on Trace Files...3-15Notes on Storage Systems...

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

User operationNumber oferrors and timepassed sinceerrormonitoringstartedInformationabout pathsnot subject toautomaticfailbackPlacing the path Onlinewh

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

The dynamic I/O path control function can be specified by using the HDLMcommand's set operation. For details about the set operation, see set (Se

Logs might be collected in layers below HDLM, such as for the HBA driver. Formore details, see the AIX documentation.Types of Collected LogsHDLM colle

Log name Description Output destinationSyslog The HDLM messages on or above thelevel set by the user with /etc/syslog.conf are collected.#We recommend

Error information is filtered according to the error level, and then collected.In syslog, the HDLM messages on or above the level set by the userconfi

By executing the dlmgetrasinst utility, you can collect system informationand log files needed to analyze errors that occurred during installation. Yo

Category ExplanationAccessControlAn event indicating that a resource access attempt madeby a device, administrator, or end-user has succeeded orfailed

Categories and Audit Events that HDLM Can Output to the Audit LogThe following table lists and explains the categories and audit events thatHDLM can o

Setting the Trace File Size...3-80Setting the Number of Trace Files...

Category Explanation Audit eventSeverity#1Message IDProcessing of thedlmpremkcd -ucommand wassuccessful.6 KAPL15090-IProcessing of thedlmpremkcd -ucom

Category Explanation Audit eventSeverity#1Message IDAn attempt to displayHDLM management-target informationfailed.3 KAPL15110-EProcessing of thedlmpr

The severity levels are as follows:3: Error, 4: Warning, 6: Informational#2If you use Ctrl + C to cancel the DLMgetras utility for collecting HDLMerro

For example, to change the output destination of audit log data to /usr/local/audlog, specify the following two settings:• Specify the following setti

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

Item#ExplanationRedundancyidentificationinformationRedundancy identification informationAgent information Agent informationHost sending request Name o

The following figure is an example of a system configuration using HDLM andGlobal Link Manager.Figure 2-15 Example System Configuration Using HDLM and

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

Changing the Status of Paths to Offline(C)...4-7Viewing LU Information...

OS KernelApply SP1 or laterAIX V6.1 (Virtual I/O Server)#3,#5ioslevel 2.1.0.01 to 2.2.2.xx (where xx is a number)AIX V7.1#1, #3No Technology LevelTech

# lslpp -L xlC.aix61.rteFor AIX V7.1# lslpp -L xlC.aix61.rte• HTC_ODM 5.0.52.1 or laterIf you are using the following storage systems, use HTC_ODM 5.0

• Hitachi Universal Storage Platform V• Hitachi Universal Storage Platform VM• XP128/XP1024/XP10000/XP12000/XP20000/XP24000• Thunder 9500V series• Lig

Platform V Hitachi Virtual Storage Platform FAL for AIX FAL for HP-UX FAL forSolaris FAL for Windows FAL for NCR UNIX FAL for HI-UX/WE2 FAL for Tru64U

OS Related Programs•VCS 5.1#4AIX 5L V5.3 (VirtualI/O Server)• PowerHA 6.1Client: Technology Level 07 or laterServer: ioslevel 2.1.0.0 to 2.2.2.xx (whe

OS Related Programs• PowerHA 7.1• PowerHA 7.1.1• PowerHA 7.1.2• Oracle RAC 11g 11.2.0.2.0If the HDLM device is specified for direct access:ASM + raw d

#6Apply fix pack 3.3.0.3 or later.#7Only the NSD (Network Shared Disk) configuration is supported.Memory and Disk Capacity RequirementsThe table below

n is the number of trace files (default is 4). The resulting fraction will berounded up.#3This is the amount of unused capacity required to use the in

Figure 3-1 Flow of HDLM Environment SetupTypes of HDLM InstallationThis section describes the following HDLM installation types: new installation,upgr

Re-installation of HDLMInstalling the same version of HDLM for repair purposes without removingthe existing instance of HDLM is called re-installation

6 Command Reference...6-1Overview of the HDLM Command dlnkmgr...

• If you upgrade or re-install HDLM before you resolve a path failure, LUreservations might persist without being released. In such a case, use theuti

When the NPIV option is set to on, HBA adapter number and bus numberfor PathName, which are output by HDLM command view operations, arechanged to adap

Trace files after the migration: /var/DynamicLinkManager/log/hdlmtrn.log (n indicates a file number)Notes on Storage Systems• Do not change the vendor

• If you are using PowerHA, note that HDLM does not support non-concurrent volume groups due to limitations in PowerHA. For details,contact IBM.• If a

¢Upgrade installation¢Re-installation¢Unattended installation• Use SMIT or the installp command.You can also copy the contents of the HDLM DVD-ROM to

Methods that Are Available in an PowerHA Environment and the SupportedInstallation Environments on page 3-19 lists the combinations of installationmet

InstallationmethodInstallation environmentHost Virtual I/O serverLocal bootdiskenvironmentBoot diskenvironmentLocal bootdiskenvironmentBoot diskenviro

To use SMIT, see the AIX documentation.When Performing a Migration of HDLMTable 3-9 Combination of Available Migration Methods and MigrationEnvironmen

Table 3-10 Combinations of Migration Methods Available in an PowerHAEnvironment and the Migration EnvironmentsMigration methodMigration environmentHos

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

Format...6-69To Add a Path Dynamically...

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

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-72.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