Hp XP7 Storage Manuel d'utilisateur Page 1

Hitachi Command SuiteDynamic Link Manager(for VMware®) User GuideMK-92DLM130-07Document OrganizationProduct VersionGetting HelpContents

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

check how many online paths remain. For details about the view operation,see view (Displays Information) on page 6-25.FormatTo place paths offlinedlnk

The following example shows how to place offline all the pathsconnected to the CHA port 0A. In this example, a path whoseAutoPATH_ID is 000001 is conn

the Offline(C) status. Is this OK? [y/n]: yKAPL01053-I If you are sure that there would be no problem when the path is placed in the Offline(C) status

[ --credstore=CREDSTORE ] [ --passthroughauthpackage=PASSTHROUGHAUTHPACKAGE ] [ --portnumber=PORTNUMBER ] [ --protocol=PROTOCOL ]

[-s]To Display the Format of the Online Operationdlnkmgr [-s host-name -u user-name -p password] online-helpParametersTo place paths Online-pathIndica

KAPL01061-I 2 path(s) were successfully placed Online; 0 path(s) were not. Operation name = onlinePROMPT> -pathid AutoPATH_IDUse this parameter to

of all the paths in the Online(S) and Online(D) statuses, specify only -hapath.-dfhaUse this parameter to change the paths to the primary volume (P-VO

dlnkmgr [Host-Connection-Options] online [-path] -cha -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options]

set (Sets Up the Operating Environment)The dlnkmgr command's set operation sets the HDLM operatingenvironment.FormatTo Set the Host Operating Env

ParametersTo Set the Host Operating EnvironmentThe table below shows the defaults and recommended values for eachsetting. If you change the value of t

Chapter/Appendix DescriptionChapter 1, Overview of HDLM onpage 1-1Gives an overview of HDLM, and describes itsfeatures.Chapter 2, HDLM Functions onpag

path, HDLM assumes that an intermittent error is occurring on the path. Apath that is assumed to have an intermittent error is excluded fromautomatic

paths managed by HDLM, and the information of the paths excluded fromautomatic failback are initialized. Intermittent error monitoring continues.-expa

If you use a license key file:Store the license key file named hdlm_license directly under theWindows installation drive, and then execute the set -li

PROMPT>dlnkmgr -l set -licKAPL01049-I Would you like to execute the operation? Operation name = set [y/n]: yKAPL01083-I There is no license key fi

Value ExplanationcaAudit log events of the ConfigurationAccess category arecollected.allAudit log events of the StartStop, Authentication, andConfigur

ExamplesExample 1The following example displays the format of the operation for both a hostand remote management client: PROMPT>dlnkmgr set -helpse

PROMPT> Example 2The following example displays the format of the operation for a host: PROMPT>dlnkmgr -s host-name -u user-name -p password set

| -audlog on [ -audlv AudlogLevel ] [ -category Category-Value ] | -audlog off

To display path information (by selecting a display item)dlnkmgr [-s host-name -u user-name -p password] view -path -item[pn] [hbaportwwn] [dn] [lu] [

To Display the Format of the view OperationTo display the format of the operation for both a host and remotemanagement client:dlnkmgr view-helpTo disp

Convention DescriptionItalic Indicates a variable, which is a placeholder for actual text provided bythe user or system. Example: copy source-file tar

Table 6-7 Items of program information (for hosts)Parameter andprograminformation tobe displayedItem Description-sfuncInformationabout the HDLMfunctio

Parameter andprograminformation tobe displayedItem DescriptionThe parentheses following the settingstatus shows the checking interval forreviewing inf

KAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ssPROMPT> Example 2The following example

Table 6-8 Items of program information (for remote management clients)Parameter andprograminformation tobe displayedItem Description-msrvInformationab

Parameter andprograminformation tobe displayedItem DescriptionIf the collection of audit log data is disabled, ahyphen (-) is displayed.-pstvThe displ

The following example shows how to display information about the auditlog settings: PROMPT>dlnkmgr -l view -sys -audlogAudit Log

displayed according to the value specified in the -pstv parameter ofset operations.For information about the items that are displayed differentlydepen

Displays the status of paths managed by VMware vSphere. For detailson VMware vSphere path statuses, see Table 2-6 CorrespondenceBetween VMware vSphere

Items displayed by the dlnkmgr view-path -item commandValues specified after the -itemparameterChaPort cpStatus#NoneType typeIO-Count icIO-Errors ieDN

6-6 Display items for which the display results of the view operationdiffer depending on the -pstv parameter specification on page 6-22 inParameters o

Logical capacity unit Value1 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 PB1,024 TB or 1,

PROMPT>dlnkmgr view -path -item vmruntimename vmstate vmpathuidPaths:000002 OnlinePaths:000002PathStatus IO-Count IO-ErrorsOnline 63

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

Items of Path informationTable 6-10 Path Information on page 6-40 describes the displayed pathinformation. The following explains the table headings:•

Displayed ItemDescriptionNosummarydisplayedSummarydisplayed• Target ID (hexadecimal number)• Host LU number (hexadecimal number)For details about each

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedStatusStatus of the path• Online: Online• Offline(C): Offline status caused by a commandope

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedDNum#1-When Dev indicates an entire LU, 0 is displayed.HDevName#1-Host device name.IEP#1-In

Displayed ItemDescriptionNosummarydisplayedSummarydisplayedVmPathUID#1-The UID of the path managed by VMware vSphere. Thisitem is displayed when speci

Displayed ItemDescriptionNosummarydisplayedSummarydisplayed• Vendor ID: The name of the storage system vendor.• Product ID: Indicates the storage syst

Table 6-12 Product ID displayed by the view -path operationModel names of storagesystemsProduct IDWithout the -stnameparameterWith the -stnameparamete

sorting key is iLU and its configuration information is displayed for eachLU.For details on the content of each displayed item, see Table 6-14 LUInfor

xivPrefaceHitachi Dynamic Link Manager (for VMware®) User Guide

Product, Physical-SerialNumber, Physical-iLU, and Physical-ChaPort, Org-Product, Org-SerialNumber, and Org-iLU, that can bedisplayed are displayed.The

For details on the contents of each displayed item, see Table 6-14 LUInformation on page 6-51.The sub-parameters are:-pstv|-vstvIf the -pstv parameter

PROMPT>dlnkmgr view -lu -item dpcProduct : HUS100SerialNumber : 9203008 LUs : 3Dynamic I

Product S/N LUs iLU HDevName Paths OnlinePathsSANRISE_AMS 77010152 1 0191 t10.HITACHI_770101520191 2 2KAPL01

Displayed itemDescriptionNo summarydisplayedSummarydisplayed• For Hitachi AMS2000/AMS/WMS/SMS seriesand HUS100 series, indicated by a decimalnumber. T

Displayed itemDescriptionNo summarydisplayedSummarydisplayedYou can identify an actual CHA port byreferencing this number from the storage systemmanag

Displayed itemDescriptionNo summarydisplayedSummarydisplayedHowever, a hyphen (-) is displayed when analgorithm other than the following is used:• exr

Displayed itemDescriptionNo summarydisplayedSummarydisplayedVmRuntimeName#1-In path information fields, displays the pathruntime information managed b

Displayed itemDescriptionNo summarydisplayedSummarydisplayedthe CU number, and the last two charactersare the internal LU number within the CU.• For H

Displayed itemDescriptionNo summarydisplayedSummarydisplayedthe logical DKC (Disk Controller), the middletwo numbers are the CU number, and thelast tw

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

srt {lu | cp}] [-t] dlnkmgr [Host-Connection-Options] view -lu [-pstv | -vstv] [ -hdev HostDeviceName | -pathid AutoPATH_ID ] [-t]

AutoPATH_ID ] [-t] dlnkmgr [Host-Connection-Options] view -lu -item [ [slpr] [pn] [cp] [clpr] [type] [ic] [ie] [dnu] [iep] [dpc]

6-60Command ReferenceHitachi Dynamic Link Manager (for VMware®) User Guide

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

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

collected-information-is-output] [-eventlogtime yyyy/mm/dd | -eventlogsize {all | maximum-file-length}] | -h} Parametershost-nameSpecify the host name

by entering y instructs the DLMgetras utility to overwrite the existingfiles; entering n (or anything other than y) instructs the utility toterminate

Directory that storescollected files#1Files Explanation(Default: folder-to-which-collected-information-is-output\installation-destination-drive-name_\

Directory that storescollected files#1Files Explanationsysdllexe.txtVersion information,timestamps for PE formatfiles, last modification dates,and fil

File names are created by using the value in the Hitachi NetworkObjectplaza Trace Library utility's Output (folder and prefix), adding2 onto the

What is HDLM?With the widespread use of data warehousing and increasing use ofmultimedia data, the need for high-speed processing of large volumes of

Displays the name of the user account that is registered on the remotemanagement client, as well as the Credential Store file path.Example: PROMPT>

PROMPT>installhdlm -vinstalldir=C:\Program Files\HITACHI\DynamicLinkManagerforVMwarePROMPT> For an explanation of each display item, see Table

Key name DescriptionNecessity ofdefinitionMaximumcharacterlength#1NewinstallationUpgradeinstallation orRe-installationthe installer uses the folder pa

#5In Windows 7 (x64), Windows Server 2008, or Windows Vista (x64), theinstaller uses the following folder:Windows-installation-drive:\Program Files (x

Formatremovehdlm [-s | -h]Parameters-sExecutes an unattended removal.-hDisplays the format of the removehdlm utility.If you execute the removehdlm uti

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

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

KAPL01001 to KAPL02000Message ID Message Text ExplanationKAPL01001-I The HDLM command completednormally. Operation name =aa...aa, completion time =bb.

Message ID Message Text ExplanationKAPL01006-W A necessary parameter is notspecified. Operation name =aa...aaDetailsThe specified operation does notco

Message ID Message Text Explanationcompany if there is a maintenancecontract for HDLM. For details onthe DLMgetras utility, see TheDLMgetras Utility f

The ability to distribute a load across multiple paths. This is also known asload balancing.When a host is connected to a storage system via multiple

Message ID Message Text ExplanationThe specified path does notexist.¢view operationThe paths have not beenconfigured because creationof the HDLM envir

Message ID Message Text ExplanationExecute help operation of theHDLM command (dlnkmgr) tocheck which parameters can bespecified at the same time, andt

Message ID Message Text ExplanationKAPL01044-W A duplicate parameter value isspecified. Operation name =aa...aa, parameter = bb...bb,parameter value =

Message ID Message Text ExplanationOperating Environment) on page6-16.KAPL01050-I The currently selected paths willbe changed to the Online status.Is

Message ID Message Text ExplanationIf you want to continue processingthe offline operation of theHDLM command for other paths,enter y. If you want to

Message ID Message Text ExplanationKAPL01058-W The specified parameter value isnot needed. Operation name =aa...aa, parameter = bb...bb,parameter valu

Message ID Message Text Explanationbb...bb: Online, Online(S),Online(D) or Offline(C)cc...cc: Number of paths wherethe online/offline operationwas uns

Message ID Message Text ExplanationUse the view operation of theHDLM command (dlnkmgr) tocheck the status of the path. Fordetails on the view operatio

Message ID Message Text ExplanationInstall a permanent license by theexpiration day.KAPL01073-E The temporary license expired. DetailsThe temporary li

Message ID Message Text ExplanationKAPL01083-I There is no license key file. Filename = aa...aaDetailsThere is no license key file in thedesignated fo

1-4Overview of HDLMHitachi Dynamic Link Manager (for VMware®) User Guide

Message ID Message Text Explanation¢Simultaneously execute theHDLM command's set -licoperation with the view -sys-lic operation.¢Execute the HDLM

Message ID Message Text Explanationtarget HBA port WWN. After that,specify the appropriate HBA portWWN, and then retry.KAPL01102-I All the paths which

Message ID Message Text Explanationbecome invalid when thisoperation is executed. Do youwant to execute the operationanyway? Operation name = set[y/n]

Message ID Message Text Explanationaa...aa: The number of pathswhich changed to the Onlinestatusbb...bb: Online or Online(S)cc...cc: The number of pat

Message ID Message Text ExplanationExecute the help operation of theHDLM command (dlnkmgr) tocheck the host connectionoptions, and then retry. Fordeta

Message ID Message Text ExplanationKAPL01143-W The host connection optionvalue cannot be specified.Option = aa...aaDetailsaa...aa: Option for which an

Message ID Message Text Explanationcc...cc: Number of paths wherethe online/offline operationwas unsuccessful(decimal(base-10) number)dd...dd: Number

Message ID Message Text ExplanationKAPL01150-E The HDLM command cannot beexecuted because the VMwarevSphere CLI is not installed.DetailsThe VMware vSp

Message ID Message Text Explanation(Displays Information) on page6-25.KAPL01154-W The dynamic I/O path controlfunction is already set to aa...aafor th

Message ID Message Text ExplanationNote: All paths of the LU,including non-P-VOL paths, will beset to Online or Online(D).ActionTo set to Online or On

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

Message ID Message Text Explanationexecute the HDLM command withthe -hapath parameter specified.KAPL01172-I There are no Online(S)/Online(D) paths amo

KAPL03001 to KAPL04000Message ID Message Text ExplanationKAPL03001-I HDLM API information - aa...aa DetailsThis information is required forresolving p

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

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

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

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

Message ID Message Text ExplanationKAPL04023-E HDLM manager errorinformation - aa...aaDetailsThis information is required forresolving problems.aa...a

Message ID Message Text ExplanationFor any non-default options, usethe dlnkmgr set operation to setthe options again. For details onthe set operation,

Message ID Message Text ExplanationKAPL04058-I The connection to the VMwareserver was restored. (VMwareserver host = aa...aa)Detailsaa...aa: VMware se

Message ID Message Text ExplanationThe path might be damaged. Fordetails on what to do, see WhatTo Do for a Path Error on page5-2, and then switch the

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

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

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

Message ID Message Text Explanationbb...bb: Version number of HDLMyou attempted to install orremoveActionSee the previous warning anderror messages to

Message ID Message Text ExplanationKAPL09191-W The installation informationsettings file does not exist.DetailsThe installation-informationsettings fi

Message ID Message Text ExplanationActionEnter a license key whenprompted by a message to do so.Alternatively, cancel theinstallation, save the correc

Message ID Message Text ExplanationRetry installation.KAPL09612-W There is no installable licensekey in the license key file. Filename = aa...aaDetail

Message ID Message Text Explanation• Confirm that valid licenseinformation is stored inthe license key filespecified forlicensekeyfile key.If the prob

Message ID Message Text ExplanationActionCheck the parameters of theDLMgetras utility for collectingHDLM error information, and thenretry. For details

Message ID Message Text ExplanationActionNone. For details on theDLMgetras utility, see TheDLMgetras Utility for CollectingHDLM Error Information on p

Message ID Message Text Explanationbb...bb: Error number of theWindows API (hexadecimalnumber)ActionAn error occurred while theinformation collection

Message ID Message Text ExplanationThe specified parameter is invalid.ActionMake sure that the parameters forthe DLMgetras utility for collectingHDLM

Figure 2-1 Configuration of an HDLM System When Using an FC-SANThe following table lists the HDLM system components when using an FC-SAN.Table 2-1 HDL

Message ID Message Text Explanationwas not executed in the commandprompt of VMware vSphere CLI.ActionExecute the DLMgetras utility inthe command promp

Message ID Message Text Explanation¢Offlinebb...bb: The Path ID of the targetpath (decimal number)ActionNone.KAPL11903-I aa...aa has completed normall

Message ID Message Text Explanation¢Get HDLM Manager Status¢Get HDLM Alert DriverStatus¢Online¢Offline¢Get SNMP Trap Information¢Set SNMP Trap Informa

Message ID Message Text ExplanationNone.KAPL11907-I XML reception - aa...aa DetailsThis information is required forresolving problems.aa...aa: XML inf

KAPL15001 to KAPL16000Message ID Message Text ExplanationKAPL15060-I DLMgetras was invoked.Command Line = aa...aaDetailsaa...aa: Name of the utility t

Message ID Message Text ExplanationKAPL15110-W An attempt to displayinformation about HDLM-management targets has failed.Command Line = aa...aaDetails

Message ID Message Text ExplanationThe termination of theHTI_SATP_HDLM plugin successful.ActionNone.KAPL20021-I The state of path (aa...aa) waschanged

Message ID Message Text ExplanationCode, check the status of the pathwhere the error was detected.KAPL20025-W I/O (aa...aa) to path (bb...bb)failed. P

Message ID Message Text Explanationthe DLMgetras utility, see TheDLMgetras Utility for CollectingHDLM Error Information on page7-2.KAPL20028-I The own

Message ID Message Text ExplanationKAPL20033-E A parameter is invalid.Parameter = "aa...aa"DetailsThe parameter specified in esxclicommand (

system is called a port (P) on a channel adapter (CHA) used for iSCSIconnections.A logical unit (LU), which lies in a storage system, is either an inp

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

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

Message ID Message Text Explanationremote management clientenvironments (dlmrmcenv),confirm the parameter that shouldbe specified, and then retry theo

Message ID Message Text Explanationremote management clientenvironments (dlmrmcenv).aa...aa: Error numberActionContact your HDLM vendor or themaintena

Message ID Message Text ExplanationNone.Return Codes for Hitachi Command Suite Common AgentComponentWhen an operation requested of HDLM from Global Li

ReturnCodeExplanation1016 DetailsThe target path(s) are already Online.ActionUpdate the host information, and then check the path status.1017 DetailsT

ReturnCodeExplanationThe acquisition of path information has been aborted, because thepath configuration was changed while the system was attempting t

ReturnCodeExplanationActionRefresh the host information, and then perform the operation again.If the same error occurs again, execute the DLMgetras ut

ReturnCodeExplanationcollecting HDLM error information, and then contact your HDLMvendor or maintenance company if you have a maintenance contractfor

ReturnCodeExplanationA value outside the valid range is specified for the check interval ofthe dynamic I/O path control function.ActionSpecify a value

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

8-66MessagesHitachi Dynamic Link Manager (for VMware®) User Guide

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

CPUCentral Processing UnitCUControl UnitDDBMSDatabase Management SystemDevDeviceDNSDomain Name ServerFFCFibre ChannelFC-SPFibre Channel Security Proto

HDevHost DeviceHLUHost Logical UnitHTTPHypertext Transfer ProtocolII/OInput/OutputIPInternet ProtocoliSCSIInternet Small Computer System InterfaceLLAN

NICNetwork Interface CardNMPNative Multipathing PluginNTPNetwork Time ProtocolOOSOperating SystemPPPortPSPPath Selection PluginRRADIUSRemote Authentic

SMTPSimple Mail Transfer ProtocolSNMPSimple Network Management ProtocolSPService PackSSLSecure Sockets LayerSVPService ProcessorUUIDUser IdentifierWWW

# 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 (for VMware®) User Guide

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 Universal Storage Platform V/VM series, Virtual StoragePlatform series, VSP G1000 series, Hit

HHAM environmentAn environment in which volume pairs that are synchronized between two storagesystems are created by HAM (High Availability Manager),

LU ConfigurationThe following figure shows the LU configuration recognized by the host, afterthe installation of HDLM.Figure 2-4 LU Configuration Reco

LLDEV (Logical Device)A combination of the storage system's product name, serial number, and an internal LU.HDLM uses this value to identify a pa

owner pathA path that passes through an owner controller for an LU in the Hitachi AMS/WMSseries. A path that passes through a controller other than an

the LU cannot be accessed from multiple paths (coming from multiple hosts)simultaneously. However, because of this, load balancing is not possible.(Se

IndexAaudit logcategories and audit events that HDLM canoutput 2-28collecting data 2-26data format 2-31automatic failback 2-15, Glossary-1automatic fa

EElements of a path name 6-45emulation type Glossary-2Error 8-2error information 2-24checking in messages 5-2collecting with DLMgetras 7-2list of erro

count 6-3errors 6-3identifyingerror part 5-4error path 5-3Information 8-2installation 3-6new installation of HDLM 3-6re-installation of HDLM 3-11upgra

path errorhandling 5-2Path Health Checking 2-22path health checking 1-3, 2-22, Glossary-5path informationobtaining 5-3path name Glossary-5path status

WWarning 8-2what is HDLM? 1-2what to do forprogram error 5-4, 5-5Index-5Hitachi Dynamic Link Manager (for VMware®) User Guide

Index-6Hitachi Dynamic Link Manager (for VMware®) User Guide

Hitachi Dynamic Link Manager (for VMware®) User Guide

Figure 2-5 Configuration of the HDLM ProgramsThe following table lists and describes the functions of these programs.Table 2-4 Functions of HDLM Progr

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

HDLM driver and NMP positionsThe HDLM driver and NMP are positioned above the SCSI driver, causing eachapplication on a guest OS to access LUs in the

Figure 2-7 Flow of I/O Data When the Load Balancing Function Is Not Used onpage 2-9 shows the flow of I/O data when the load balancing function isnot

Figure 2-8 Flow of I/O Data When the Load Balancing Function Is UsedWhen the load balancing function is used, I/O operations are distributed viamultip

load balancing will be performed among the remaining, usable owner paths.It is only when absolutely no owner paths are available, that load balancing

ContentsPreface... ixIntended audience...

Load Balancing AlgorithmsThe load balancing function uses VMware vSphere PSPs or PSPs provided byHDLM. The following table lists the load balancing al

You can specify the load balancing function by the dlnkmgr command's setoperation. For details on the set operation, see set (Sets Up the Operati

For details on error levels, see Table 8-1 Format and Meaning of the MessageID KAPLnnnnn-l on page 8-2 in Format and Meaning of Message IDs onpage 8-2

Figure 2-10 Path SwitchingAutomatic FailbacksWhen a path recovers from an error, HDLM can automatically place therecovered path back online. This func

When an intermittent error#2 occurs in a path, automatic failback repeatedlyplaces the path offline and then online again, which can cause I/Operforma

then from online non-owner paths. When the Universal Storage PlatformV/VM series, Virtual Storage Platform series, VSP G1000 series, HitachiAMS2000 se

The status indicating that an I/O could not be issued on a given path,because an error occurred on the path.The (E) in Offline(E) indicates the error

Online operation: Online operation performed by executing the dlnkmgrcommand's online operation.Offline operation: Offline operation performed by

Note:If there is a path failure immediately after a path is placed offline by usingthe dlnkmgr command, Offline(C) might change to Offline(E). If an o

Intermittent Error Monitoring ActionsDuring intermittent error monitoring, HDLM manages the history of errors#that occurred on each path. If an error

Automatic Failbacks...2-15Manual Path Switching...

change the paths to the blocked state (Offline(C)) before you change theintermittent error monitoring setting.You can check whether intermittent error

#For using the dynamic load balance controller function there arerestrictions on the versions of the microprograms you install. For details,see the re

Figure 2-13 Flow of Data When Path Error Information Is CollectedLogs might be collected in layers below HDLM, such as for the SCSI driver.For more de

Table 2-8 Types of ESXi Host Error InformationLog name Description Output destinationSyslog Information about detected errors iscollected.The default

In Windows Server 2003 (excluding the x86 edition) and Windows Server2008 (excluding the x86 edition), Program Files is Program Files(x86).#2The under

Table 2-10 Categories of Audit Log Data That Can Be CollectedCategory ExplanationStartStopAn event indicating the startup or termination of hardwareor

Category Explanation• Viewing or updating audit log settingsMaintenanceAn event indicating that a maintenance operation hasterminated normally or fail

Category Explanation Audit eventSeverity#1Message IDTermination ofthe DLMgetrasutility#26 KAPL15061-IAuthenticationAdministrator orend-userauthenticat

Category Explanation Audit eventSeverity#1Message IDAn attempt todisplay HDLMmanagement-target informationfailed.4 KAPL15110-WThe status of apath wass

You can also filter the audit log output by specifying a severity level and typefor the HDLM command's set operation.Filtering by severity:The fo

Setting Up HDLM... 3-15Checking the Current Settings...

information,agent-information,host-sending-request,port-number-sending-request,host-receiving-request,port-number-receiving-request,common-operation-I

Item#ExplanationApplicationidentificationinformationProgram identification informationReserved area This field is reserved. No data is output here.Mes

Figure 2-14 Example System Configuration Using HDLM and Global LinkManager2-34HDLM FunctionsHitachi Dynamic Link Manager (for VMware®) User Guide

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

HDLM System RequirementsCheck the following before installing HDLM:For the requirements for using HDLM in an HAM environment, see the releasenotes of

A remote management client can run on a machine in the same LAN as thehost, or on a guest OS installed on the host itself.VMware vSphere CLI 5.0/5.1/5

Disk RequirementsThe disk space requirements for hosts and remote management clients are asfollows:• Host600KB• Remote management client175 MBNumber o

Installing HDLM on a server on which HDLM has not been installed iscalled a new installation of HDLM.Upgrade installation of HDLM:Installing a newer v

• At the auto deploy server, apply the host profile of the relevanthost.Unless you apply the host profile, HDLM setting changes will not besaved when

When performing a new installation on a remote management client, you canperform an unattended installation by using the HDLM install utility(installh

What To Do for Other Errors...5-66 Command Reference...

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

drive-containing-installation-DVD-ROM:\HDLM_VMware\DLMTools\installhdlm -f installation-information-settings-file 6. Check the results of the install

Execute the following command to check the current acceptance level ofthe host: esxcli --server=host-name --username=user-name --password=password sof

password=password storage nmp satp rule add -V HP -M "^OPEN-*" -s HTI_SATP_HDLM7. Check the path configuration according to the procedure de

Host settings• Create a user account.Remote management client settings• Add the host to the Credential Store file.• Execute the utility for configurin

In addition, if you add the host by specifying the host name from GlobalLink Manager, configure the settings so that the host name of the ESXihost on

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

Note:The folder that stores the Hitachi Command Suite Common AgentComponent commands is automatically added to the PATH environmentvariable of the rem

Checking the Current SettingsCheck the current settings by executing the following command to set theHDLM functionality by using the dlnkmgr command&a

Function Default value Recommended valueSet on, if you want to collectaudit log data.#This function is applied only when Hitachi AMS2000 series, Hitac

7 Utility Reference... 7-1Overview of the Utilities...

To enable intermittent error monitoring, specify on. To disable intermittenterror monitoring, specify off. When you specify on, you can use the -intvl

Value (severity) Explanation6 Error-level, Warning-level, and Information-levelaudit log data is collected.7The table below lists and describes the va

Audit Log : on(6)Audit Log Category : allKAPL01001-I The HDLM command completed normally. Operation name = view, comp

Network Objectplaza Trace Library (HNTRLib) is already installed, the settingswill not be inherited.To change the integrated trace file settings:1. On

5. In Interval Timer(Sec), enter a value to shorten the monitoring cycle.The default is 10 (seconds). You can specify a value from 1 to 300.6. In Look

• If firewall exceptions have been registered by using the firewall_setupcommand, remove them. Make sure that you do not use another HitachiCommand Su

:naa.60060e8006cf2e000000cf2e00000039 Device Display Name: HITACHI Fibre Channel Disk (naa.60060e8006cf2e000

4HDLM OperationThis chapter describes the procedures for operating HDLM. This includes howto operate HDLM and the HDLM manager, and how to change thec

HDLM Operations Using CommandsThis section explains how to use the HDLM command. For details on thevarious command operations, see Chapter 6, Command

PROMPT> For details on the displayed items and their descriptions, see view (DisplaysInformation) on page 6-25.Changing the Status of PathsThis sec

viiiHitachi Dynamic Link Manager (for VMware®) User Guide

dlnkmgr -s host-name -u user-name -p password view -path 2. To change the status of paths to Offline(C), execute the dlnkmgrcommand's offline op

Initializing Statistical Information for PathsThis section explains how to initialize statistical information (I/O counts andI/O errors) for all the p

PROMPT> To display the operating environment of the audit log, execute the HDLMcommand's view operation with the -sys and -audlog parameters s

To display license information, execute the dlnkmgr command's viewoperation with the -sys and -lic parameters specified.The following is an examp

To display HDLM version information, execute the dlnkmgr command's viewoperation with the -sys parameter specified. The following is an example o

Among the displayed items, HDLM Manager indicate the HDLM componentinformation.Starting and Stopping the HDLM ManagerIf an error occurs in the system,

DeadKAPL01001-I The HDLM command completed normally. Operation name = view, completion time = yyyy/mm/dd hh:mm:ssPROMPT> When the HDLM Manager colu

5TroubleshootingThis chapter describes how to properly use HDLM error information, and thenhow to resolve the problem, if an error has occurred in HDL

Collecting Error InformationCollect the error information immediately after an error occurs. If thecomputer is restarted, the error information might

Figure 5-2 Troubleshooting Procedure When a Path Error OccursThe following shows the procedure for using the HDLM command (dlnkmgr)to handle a path er

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

Narrowing Down the Hardware That Might Have Caused the ErrorCheck the DskName, iLU, ChaPort, and HBAPortWWN columns of the path withthe error to narro

Figure 5-3 Troubleshooting Procedure When a Program Error OccursThe following shows the procedure for handling a program error by using theHDLM comman

dlnkmgr -s host-name -u user-name -p password view -sys If the KAPL01013-E message is output after the command is executed,restart the host.If the sa

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 how to specify the HDLM command dlnkmgr and itssubcommands (called operations in HDLM).Comm

Table 6-1 Operations of the dlnkmgr CommandOperation FunctionsclearInitializes(0) the statistics (I/O count and I/O errors) of all pathsmanaged by the

ParametersTo Set the Path Statistics to 0-pdstClears statistics (I/O count and I/O errors) of all paths managed by HDLMto the initial value (0).Exampl

[ --portnumber=PORTNUMBER ] [ --protocol=PROTOCOL ] [ --savesessionfile=SAVESESSIONFILE ] [ --servicepath=SERVICEPATH ]KAPL01001-I Th

[ -h VIHOST | --vihost=VIHOST ] [ -p PASSWORD | --password=PASSWORD ] [ -r URL | --url=URL ] [ -s SERVER | -

-cha -pathid AutoPATH_ID [-s] dlnkmgr [Host-Connection-Options] offline [-path] -pathid AutoPATH_ID [-s] dlnkmg