Hp XP Command View Advanced Edition Software Manual do Utilizador

HP StorageWorks XP Command View Advanced Edition software Device Manager CLI user guide Reference number: T1780-96080 Tenth editio

Figures and Tables 10 Table 4-80 AddHost command parameters...

Command line interface commands 100 clprNumber=-1 cuInfo= openTotalCapacity=418,184,640 openAllocatedCapacity=266,

Command line interface commands 101 autoLunCapacity=0 onDemandCapacity=0 totalFreeSpace=3,223,296 largestFreeSpace

Command line interface commands 102 Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray ar

Command line interface commands 103 autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=110 largestFreeSpaceInGB=63

Command line interface commands 104 name=DKC Battery value=1 description=Normal An instance of Component name=

Command line interface commands 105 Table 4-36 GetStorageArray (subtarget=Filter) command parameters Parameter Name Status Description

Command line interface commands 106 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayerrayType=XP1024

Command line interface commands 107 Table 4-37 GetStorageArray (subtarget=Freespace) command parameters Parameter Name Status Descripti

Command line interface commands 108 openAutoLunCapacity=2,403,360 openOnDemandCapacity=0 imTotalCapacity=0 imAlloc

Command line interface commands 109 freeCapacity=76,943,520 autoLunCapacity=0 onDemandCapacity=0 totalFreeSpace=1,

Figures and Tables 11 Table 4-133 Items output when instance is ServerInfo ...

Command line interface commands 110 Table 4-38 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter Name Status D

Command line interface commands 111 Table 4-38 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter Name Status D

Command line interface commands 112 . . (repeated for other FreeLUN instances) . List of 1 Path ele

Command line interface commands 113 Table 4-39 GetStorageArray (subtarget=JournalPool) command parameters Parameter Name Status Descrip

Command line interface commands 114 List of 256 JournalPool elements: An instance of JournalPool objectID=***** poolFunc

Command line interface commands 115 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simple

Command line interface commands 116 An instance of LogicalUnit objectID=***** devNum=3,025 displayNa

Command line interface commands 117 Table 4-40 GetStorageArray (subtarget=LDEV) command parameters Parameter Name Status Description mo

Command line interface commands 118 Command execution example: In this example, the CLI command obtains information about a specific LDEV

Command line interface commands 119 productName=1024 vendor= HP . . (repeated for other LDEV instances) . *****: The

About this guide 12 About this guide This document describes and provides instructions for using the Command Line Interface (CLI) for HP S

Command line interface commands 120 onDemandCapacityInKB=0 totalFreeSpaceInKB=3,239,433,148 largestFreeSpaceInKB=516,113,664 multi

Command line interface commands 121 4-4-17-12 GetStorageArray (subtarget=LogicalUnit) GetStorageArray (subtarget=LogicalUnit) obtains th

Command line interface commands 122 Table 4-42 GetStorageArray (subtarget=LogicalUnit) command parameters Parameter Name Status Descrip

Command line interface commands 123 devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false

Command line interface commands 124 raidType=RAID5(3D+1P) substance=1 volumeType=3 slotSizeInKB=48

Command line interface commands 125 Table 4-43 GetStorageArray (subtarget=Path) command parameters Parameter Name Status Description su

Command line interface commands 126 domainID=0 scsiID=15 LUN=0 wwnSecurityValidity=true . . (repea

Command line interface commands 127 WWN=88.77.77.77.77.77.00.02 nickname=Jone *****: The value is encoded by the CLI.

Command line interface commands 128 objectID=***** chassis=1 arrayGroup=0 capacityInKB=75,497,472

Command line interface commands 129 Table 4-45 GetStorageArray (subtarget=Pool) command parameters Parameter Name Status Description mo

About this guide 13 Table 1 Revisions Date Edition Revision November 2006 Fifth • The following OSs are now supported (command line inte

Command line interface commands 130 Command execution example: In this example, the GetStorageArray (subtarget=Pool) command obtains infor

Command line interface commands 131 differentialManagement=false snapshotPoolID=-1 journalPoolID=0

Command line interface commands 132 List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=**

Command line interface commands 133 sysVolFlag=0 externalVolume=0 differentialManagement=false sna

Command line interface commands 134 Table 4-46 GetStorageArray (subtarget=Port) command parameters Parameter Name Status Description po

Command line interface commands 135 nickname=Jane An instance of WWN WWN=00.00.00.00.00.00.00.50 nic

Command line interface commands 136 Table 4-47 GetStorageArray (subtarget=PortController) command parameters Parameter Name Status Desc

Command line interface commands 137 Command execution result 2: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray

Command line interface commands 138 Table 4-48 GetStorageArray (subtarget=ReplicationInfo) command parameters Parameter Name Status Des

Command line interface commands 139 List of 2 Lu elements: An instance of LogicalUnit objectID=***** dev

About this guide 14 Table 1 Revisions Date Edition Revision February 2007 Sixth • Device Manager CLI now supports HP-UX 11i v3 as a new

Command line interface commands 140 externalVolume=0 differrentialManagement=false SnapshotPoolID=-1

Command line interface commands 141 4-4-19 ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage de

Command line interface commands 142 Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of Storage

Command line interface commands 143 Format when the command is used to change the usage rate threshold of a THP pool: hdvmcli [URL] Modify

Command line interface commands 144 status=0 threshold=75 threshold2=80 capacityInKB=31,458,240 freeCapacity

Command line interface commands 145 arrayGroup=64 raidType=RAID5(3D+1P) currentPortController=-1 d

Command line interface commands 146 4-4-21 ModifyPort ModifyPort changes port and host storage domain attributes (see parameters in Table

Command line interface commands 147 Table 4-52 ModifyPort command parameters Parameter Name Status Description fibreaddr Optional New

Command line interface commands 148 Table 4-52 ModifyPort command parameters Parameter Name Status Description nickname Optional (for X

Command line interface commands 149 Table 4-52 ModifyPort command parameters Parameter Name Status Description wwnnickname Optional (fo

About this guide 15 Table 1 Revisions Date Edition Revision Edition or Windows Server 2003 R2 x64 Edition, Device Manager CLI must be used

Command line interface commands 150 Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/S

Command line interface commands 151 Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/S

Command line interface commands 152 Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/S

Command line interface commands 153 Table 4-54 hostModeOption parameter values and description hostModeOption Values Description 7 Specif

Command line interface commands 154 • Changes the value for the hostmode parameter to Standard, for the port's host storage domain (

Command line interface commands 155 4-4-22 ModifyPortController ModifyPortController supports changing characteristics of a PortControlle

Command line interface commands 156 NOTE: This command can be used only with XP24000/XP20000 storage subsystems. Format when the command

Command line interface commands 157 Table 4-56 ModifyVirtualVolume command parameters Parameter Name Status Description threshold Opti

Command line interface commands 158 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=15 tcaPoolID=-1 *

Command line interface commands 159 . List of 1 CommParameters elements: An instance of CommParameters userID= root ipAdd

About this guide 16 Table 1 Revisions Date Edition Revision • The value that indicates the array group of a THP volume has been added to

Command line interface commands 160 Table 4-58 AddLogicalGroup command parameters Parameter Name Status Description groupname Required

Command line interface commands 161 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 *****: The value is encoded by the CLI. Command

Command line interface commands 162 List of 94 HostStorageDomain elements: An instance of HostStorageDomain objectID=*****

Command line interface commands 163 Command execution example: hdvmcli AddObjectForLogicalGroup -o "D:\logs\XP1024 AddObjectForLogica

Command line interface commands 164 Command execution example: hdvmcli DeleteLogicalGroup -o "D:\logs\DeleteLogicalGroup.log" &

Command line interface commands 165 A user to whom a user-defined resource group is assigned can obtain information about logical groups t

Command line interface commands 166 portID=0 domainID=0 scsiID=15 LUN=8 wwnSecurityValidity=true . .

Command line interface commands 167 Command execution result 3: RESPONSE: An instance of LogicalGroup objectID=***** name=toro paren

Command line interface commands 168 Table 4-64 ModifyLogicalGroup command parameters Parameter Name Status Description parent Optional

Command line interface commands 169 Format for the XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: hdvmcli [URL] AddLun [optio

About this guide 17 Table 1 Revisions Date Edition Revision ○ openReservedCapacity ○ openReservedActualCapacity ○ numberOfReservedLUs ○

Command line interface commands 170 Table 4-65 AddLun command parameters Parameter Name Status Description devnum Optional Device numb

Command line interface commands 171 displayName=00:7F emulation=OPEN-8 cylinders=50 isComposite=1

Command line interface commands 172 thpPoolID=-1 threshold=-1 systemDisk=0 List of 1 WWN elements:

Command line interface commands 173 thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1

Command line interface commands 174 scsiID=15 LUN=120 wwnSecurityValidity=true *****: The value is encoded by the CLI. 4

Command line interface commands 175 . List of 1 Port elements: An instance of Port . . (Attributes of Port are omitted here) . L

Command line interface commands 176 Table 4-67 AddWWNForHostStorageDomain command parameters Parameter Name Status Description port Opt

Command line interface commands 177 Command execution example: hdvmcli AddWWNForHostStorageDomain -o "D:\logs\XP1024 AddWWNForHostSto

Command line interface commands 178 Table 4-68 AddWWNForLun command parameters Parameter Name Status Description domain Required Domai

Command line interface commands 179 Table 4-69 AddWWNForLunGroup command parameters Parameter Name Status Description serialnum Require

About this guide 18 Table 1 Revisions Date Edition Revision ○ svolHORCMMONHostName ○ svolHORCMINSTHostName • The license attribute has

Command line interface commands 180 is 127. Only WWNs not used for a port can be added. WWNs already existing in a port cannot be added. A

Command line interface commands 181 . List of 1 WWNGroup elements: An instance of WWNGroup objectID=***** name

Command line interface commands 182 Command execution example: hdvmcli DeleteLun -o "D:\logs\XP1024 DeleteLun.log" "serialn

Command line interface commands 183 Table 4-73 DeleteWWN command parameters Parameter Name Status Description serialnum Required Seria

Command line interface commands 184 Table 4-74 DeleteWWNForHostStorageDomain command parameters Parameter Name Status Description domai

Command line interface commands 185 Table 4-75 DeleteWWNForLun command parameters Parameter Name Status Description port Optional Port

Command line interface commands 186 Table 4-76 DeleteWWNForLunGroup command parameters Parameter Name Status Description portname Optio

Command line interface commands 187 Command execution result: RESPONSE: (Command completed; no data returned) 4-6-14 ModifyLunGroup Modi

Command line interface commands 188 List of 1 Port elements: An instance of Port . . (Attributes of Port are omitted her

Command line interface commands 189 Table 4-79 ModifyWWNGroup command parameters Parameter Name Status Description nickname Optional U

About this guide 19 Table 1 Revisions Date Edition Revision ○ force ○ quickformat • In Device Manager CLI, descriptions have been added

Command line interface commands 190 A user who has only View permission cannot execute this command. A user to whom a user-defined resourc

Command line interface commands 191 Table 4-81 AddHostInfo command parameters Parameter Name Status Description hostname Required Name

Command line interface commands 192 • Host LUN: 1 • HBA WWN: 11.22.33.44.55.66.77.88 • LUN size: 10MB • LUN in use: 10% Command execut

Command line interface commands 193 Table 4-82 AddHostRefresh command parameter Parameter Name Status Description objectid Optional Sp

Command line interface commands 194 Command execution result: RESPONSE (Command completed; no data returned) 4-7-5 DeleteHostInfo Delete

Command line interface commands 195 Table 4-85 GetHost command parameters Parameter Name Status Description configfileid Optional Obje

Command line interface commands 196 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONH

Command line interface commands 197 Command execution result 2: RESPONSE: An instance of Host objectID=***** name=testmf capacityInK

Command line interface commands 198 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10

Command line interface commands 199 Table 4-87 ModifyHost command parameters Parameter Name Status Description objectid Optional Objec

Legal notices © Copyright 2005, 2008 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required

About this guide 20 Table 1 Revisions Date Edition Revision ○ threshold ○ systemDisk • The following attributes have been added to the

Command line interface commands 200 *****: The value is encoded by the CLI. 4-7-9 ModifyHostInfo ModifyHostInfo modifies a HostInfo recor

Command line interface commands 201 Table 4-88 ModifyHostInfo command parameters Parameter Name Status Description devnum Optional New

Command line interface commands 202 serialNumber=10001 arrayType=XP1024 ipAddress=111.111.111.111 mountPoint=E: portID=7 domai

Command line interface commands 203 An instance of URLLink objectID=***** name=AUTO url=192.168.99.AA linkedID=***** description

Command line interface commands 204 Table 4-91 DeleteURLLink command parameters Parameter Name Status Description objectid Optional Th

Command line interface commands 205 Command execution example: hdvmcli GetAlerts -o D:\logs\GetAlerts.log "countfilter=2" "

Command line interface commands 206 Table 4-93 GetLogFile command parameters Parameter Name Status Description filename Required Name o

Command line interface commands 207 4-8-8 GetURLLink GetURLLink gets any or all URLLink objects in the Device Manager server (see Table 4

Command line interface commands 208 Modifying the debug level affects the amount of information written to the trace.log file, subsequent

Command line interface commands 209 Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status Description pvolhos

About this guide 21 • Reviewing the Release Notes on the CD for any last-minute announcements Document conventions and symbols Table 2 Do

Command line interface commands 210 Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status Description pvolpor

Command line interface commands 211 Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status Description replica

Command line interface commands 212 Command execution example 1: (add pairs to the existing group in the configuration files). hdvmcli Add

Command line interface commands 213 Command execution result 3: RESPONSE (Command completed; no data returned) 4-9-2 AddReplication The

Command line interface commands 214 Table 4-97 AddReplication command parameters Parameter Name Status Description pvolportnum Optional

Command line interface commands 215 Table 4-97 AddReplication command parameters Parameter Name Status Description pvolpoolid Optional

Command line interface commands 216 Table 4-97 AddReplication command parameters Parameter Name Status Description munum Optional Spec

Command line interface commands 217 Table 4-98 GetHost command display and AddReplication command parameters Location of Value Displayed

Command line interface commands 218 Command execution result 1: RESPONSE: An instance of ReplicationGroup objectID=***** replicationGr

Command line interface commands 219 the primary volume (P-VOL), specify the logical device (LDEV 11, model number XP1024, and serial numbe

About this guide 22 Table 3 Conventions: Abbreviations Abbreviation Full name or meaning XP Business Copy Software This abbreviation is

Command line interface commands 220 number|pvolportname=port-name]] pvolpoolid=pool-ID svolarraytype=model svolserialnum=serial-number svo

Command line interface commands 221 status=1 muNumber=-1 copyTrackSize=14 splitTime=-1 *****: The values are encoded by th

Command line interface commands 222 Command execution example 1: This example deletes a copy pair for XP Continuous Access Synchronous So

Command line interface commands 223 Command execution result 2: RESPONSE (Command completed; no data returned) 4-9-4 GetReplicationContr

Command line interface commands 224 Command execution result 2: RESPONSE An instance of ReplicationControllerPair objectID=***** maste

Command line interface commands 225 Table 4-101 ModifyReplication command parameters Parameter Name Status Description svolserialnum Op

Command line interface commands 226 Command execution result: RESPONSE: An instance of ReplicationGroup objectID=***** replicationGrou

Command line interface commands 227 4-10 Items output as command execution results This section lists the items that are output when Devi

Command line interface commands 228 Table 4-103 lists and describes the attributes of the ArrayGroup instance. Table 4-103 Items output w

Command line interface commands 229 Table 4-103 Items output when instance is ArrayGroup Attribute Description allocatedCapacity Total si

About this guide 23 HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://w

Command line interface commands 230 Table 4-103 Items output when instance is ArrayGroup Attribute Description mfOnDemandCapacity Total s

Command line interface commands 231 4-10-3 Items output when instance is ArrayReservation The ArrayReservation instance is output when th

Command line interface commands 232 4-10-5 Items output when instance is Component The Component instance is output when the GetStorageAr

Command line interface commands 233 4-10-6 Items output when instance is ConfigFile The ConfigFile instance is output when the GetHost co

Command line interface commands 234 Table 4-109 Items output when instance is File Attribute Description name Log file name The log recor

Command line interface commands 235 Table 4-112 Items output when instance is Host Attribute Description objectID Object ID of the host n

Command line interface commands 236 Table 4-113 Items output when instance is HostInfo Attribute Description devNum Device number of the

Command line interface commands 237 Table 4-114 Items output when instance is HostStorageDomain Attribute Description hostMode Host conne

Command line interface commands 238 Table 4-114 Items output when instance is HostStorageDomain Attribute Description For XP1024/XP128:

Command line interface commands 239 Table 4-114 Items output when instance is HostStorageDomain Attribute Description hostModeOption Host

XP Command View Advanced Edition Device Manager overview 24 1 XP Command View Advanced Edition Device Manager overview This chapter provi

Command line interface commands 240 Table 4-116 Items output when instance is JournalPool Attribute Description objectID Object ID of the

Command line interface commands 241 • AddLUSE (see section 4-4-4 ) • AddVirtualVolume (see section 4-4-7 ) • FormatLU (see section 4-4-

Command line interface commands 242 Table 4-117 Items output when instance is LDEV Attribute Description volumeType Information about LDE

Command line interface commands 243 Table 4-117 Items output when instance is LDEV Attribute Description diskType Type of the disk drive

Command line interface commands 244 Table 4-117 Items output when instance is LDEV Attribute Description status LDEV status One of the fo

Command line interface commands 245 Table 4-117 Items output when instance is LDEV Attribute Description thpPoolID Pool ID of the XP Thin

Command line interface commands 246 4-10-18 Items output when instance is LogicalGroup The LogicalGroup instance is output when the follo

Command line interface commands 247 • GetStorageArray (subtarget=ReplicationInfo) (see section 4-4-17-18 ) • ModifyLogicalUnit (see sec

Command line interface commands 248 Table 4-120 Items output when instance is LogicalUnit Attribute Description chassis Number of the cha

Command line interface commands 249 Table 4-120 Items output when instance is LogicalUnit Attribute Description journalVolumeType Volume

XP Command View Advanced Edition Device Manager overview 25 1-2 XP Command View Advanced Edition Device Manager components XP Command Vie

Command line interface commands 250 Table 4-120 Items output when instance is LogicalUnit Attribute Description consumedCapacityInKB Spac

Command line interface commands 251 • AddWWNForLunGroup (see section 4-6-5 ) • GetStorageArray (subtarget=Port) (see section 4-4-17-16

Command line interface commands 252 4-10-23 Items output when instance is PairedPortController The PairedPortController instance is outpu

Command line interface commands 253 Table 4-125 Items output when instance is Path Attribute Description wwnSecurityValidity Indicates wh

Command line interface commands 254 Table 4-126 Items output when instance is PDEV Attribute Description dkuType Type of the disk unit co

Command line interface commands 255 Table 4-127 Items output when instance is Pool Attribute Description controllerID ID of the disk cont

Command line interface commands 256 Table 4-127 Items output when instance is Pool Attribute Description capacityInKB Capacity of the jou

Command line interface commands 257 Table 4-128 Items output when instance is Port Attribute Description objectID Object ID of the port n

Command line interface commands 258 Table 4-128 Items output when instance is Port Attribute Description portRole Port attribute One of t

Command line interface commands 259 Table 4-129 Items output when instance is PortController Attribute Description mode Mode of the port

XP Command View Advanced Edition Device Manager overview 26 Table 1-1 Functions supported by Device Manager CLI Function Storage Subsyste

Command line interface commands 260 Table 4-129 Items output when instance is PortController Attribute Description For XP1024/XP128: •

Command line interface commands 261 4-10-29 Items output when instance is ReplicationControllerPair The ReplicationControllerPair instanc

Command line interface commands 262 Table 4-131 Items output when instance is ReplicationGroup Attribute Description groupName Name of th

Command line interface commands 263 • AddReplication (see section 4-9-2 ) • DeleteReplication (see section 4-9-3 ) • GetHost (see secti

Command line interface commands 264 Table 4-132 Items output when instance is ReplicationInfo Attribute Description fenceLevel Fence leve

Command line interface commands 265 Table 4-133 Items output when instance is ServerInfo Attribute Description buildVersion Version and b

Command line interface commands 266 • GetStorageArray (subtarget=Filter) (see section 4-4-17-6 ) • GetStorageArray (subtarget=FreeSpace

Command line interface commands 267 Table 4-134 Items output when instance is StorageArray Attribute Description sharedMemoryInMB Size of

Command line interface commands 268 Table 4-134 Items output when instance is StorageArray Attribute Description slprStatus SLPR status o

Command line interface commands 269 Table 4-134 Items output when instance is StorageArray Attribute Description numberOfUnallocatedMfLDE

XP Command View Advanced Edition Device Manager overview 27 HP StorageWorks XP Command View Advanced Edition software Device Manager web c

Command line interface commands 270 Table 4-134 Items output when instance is StorageArray Attribute Description numberOfOpenReservedLUs

Command line interface commands 271 Table 4-136 Items output when instance is VolumeConnection Attribute Description mappedDevNum Device

Command line interface commands 272 • GetStorageArray (subtarget=Port) (see section 4-4-17-16 ) • ModifyWWNGroup (see section 4-6-15 )

Command line interface commands 273 4-11-1-1 Batch file format and input rules The batch file format is as follows: beginbatch hdvmcli

Command line interface commands 274 portname parameter is specified. For this reason, to execute such commands together, the parameters ne

Command line interface commands 275 4-11-1-4 Examples of batch file creation The following shows an example of a batch file created acco

Command line interface commands 276 description= XP12000 (14053) at 10.208.116.108 serialNumber=14053 arrayFamily=XP12K/10K/SVS200

Command line interface commands 277 numberOfUnallocatedMfLDEVs=0 productCode=2 lastRefreshed=1,153,456,561 autoFormatLU=1 status

Command line interface commands 278 4-11-3-1 When the target storage subsystem is other than XP24000/XP20000, or is an XP24000/XP20000 w

Command line interface commands 279 Table 4-143 Actions to take for storage subsystem error codes Storage subsystem error code Action 100

XP Command View Advanced Edition Device Manager overview 28 To download the Device Manager CLI from the Device Manager server: 1. In the

Command line interface commands 280 Table 4-143 Actions to take for storage subsystem error codes Storage subsystem error code Action 100

Command line interface commands 281 • Mainframe volume information (VOLSER and DEVN) • Logical DKC serial number of a storage subsystem

Command line interface commands 282 2. From the execution result of the AddHost command, make sure that specified information is correctl

Command line interface commands 283 Notes on executing the AddURLLink command: If the name parameter is specified incorrectly, the mainfra

Command line interface commands 284 Example of executing the command: Hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" &q

Command line interface commands 285 *****: The values are encoded by the CLI. 4-12-4 Acquiring mainframe agent information registered in

Command line interface commands 286 4-12-6 Deleting mainframe agent information registered in the Device Manager To delete the mainframe

Command line interface commands 287 NOTE: When you change the host name, specify the host name that was set in the initialization paramet

Command line interface commands 288 4-13 Example of Device Manager CLI commands This section gives an example of applying Device Manager

Command line interface commands 289 Example of executing the command: hdvmcli GetHost Example of output from executing the command: RESPO

Setting up command line interface 29 2 Setting up command line interface This chapter describes the system requirements and startup instr

Command line interface commands 290 4. Register a new host, assigning to it the WWNs that were deleted in step 2. Command format: hdvmcli

Using the Device Manager properties file 291 5 Using the Device Manager properties file This chapter describes how to specify options and

Using the Device Manager properties file 292 Table 5-1 Example of the properties file (in Windows) # Device Manager Command Line In

Using the Device Manager properties file 293 NOTE: When true is set in a property file for an option without an argument, it cannot be ov

Using the Device Manager properties file 294 The following example specifies C:\Temp\diag.log for the output destination: hdvmcli.logfile=

Using the Device Manager properties file 295 Manager request. The command line option -i or --input specifies the input file. The other op

Using the Device Manager properties file 296 When you specify the saved file that contains the preceding message, you can create multiple

Using the Device Manager properties file 297 6. At the CLI prompt, enter the the following command: do getserverinfo You will see output

Using the Device Manager properties file 298 C:\hdvm>type getserv.inp <?xml version="1.0" encoding="UTF-8"?>

Using the Device Manager properties file 299 5-4-7 Output format of execution results Command results are output in the standard format s

This product includes altered versions of software originally developed by Henry Spencer. Reference number: T1780-96080 Tenth edition: Februa

Setting up command line interface 30 Table 2-1 Platform, Java Runtime Environment, and IPv6 environment support for Device Manager CLI OS

Using the Device Manager properties file 300 Figure 5-1 Output image of an execution result of Device Manager CLI (CSV format) The execut

Using the Device Manager properties file 301 When an execution result is output in XML format, an XML declaration, a DOCTYPE declaration,

Troubleshooting 302 6 Troubleshooting If there is a problem with Device Manager CLI: • Make sure that the problem is not being caused by

Troubleshooting 303 Table 6-1 General troubleshooting information Problem Cause Recommended Action The following error message is displa

Appendix A 304 Appendix A Using a DTD with Device Manager CLI To use a Document Type Definition (DTD), you must create a DTD using the fol

Appendix A 305 <!ATTLIST DvMCLIResult version CDATA #IMPLIED> <!ATTLIST CommandResult command CDATA #IMPLIED> <!ATTLIST

Appendix A 306 <!ATTLIST StorageArray numberOfAllocatedLUs CDATA #IMPLIED> <!ATTLIST StorageArray numberOfUnallocatedLUs CDATA #I

Appendix A 307 <!ATTLIST ArrayGroup name CDATA #IMPLIED> <!ATTLIST ArrayGroup chassis CDATA #IMPLIED> <!ATTLIST ArrayGroup

Appendix A 308 <!ATTLIST ArrayGroup openReservedCapacity CDATA #IMPLIED> <!ATTLIST ArrayGroup openReservedActualCapacity CDATA #I

Appendix A 309 <!ATTLIST HostInfo fileSystemName CDATA #IMPLIED> <!ATTLIST HostInfo sizeInMB CDATA #IMPLIED> <!ATTLIST Host

Setting up command line interface 31 Table 2-1 Platform, Java Runtime Environment, and IPv6 environment support for Device Manager CLI OS

Appendix A 310 <!ATTLIST LDEV raidType CDATA #IMPLIED> <!ATTLIST LDEV substance CDATA #IMPLIED> <!ATTLIST LDEV volumeType C

Appendix A 311 <!ATTLIST LogicalUnit objectID CDATA #IMPLIED> <!ATTLIST LogicalUnit name CDATA #IMPLIED> <!ATTLIST LogicalU

Appendix A 312 <!ATTLIST PairedJournalPool pairedSerialNumber CDATA #IMPLIED> <!ATTLIST PairedJournalPool pairedPoolID CDATA #IMP

Appendix A 313 <!ATTLIST Pool name CDATA #IMPLIED> <!ATTLIST Pool poolFunction CDATA #IMPLIED> <!ATTLIST Pool poolID CDATA

Appendix A 314 <!ATTLIST PortController card CDATA #IMPLIED> <!ATTLIST PortController controllerID CDATA #IMPLIED> <!ATTLIS

Appendix A 315 <!ATTLIST WWNGroup objectID CDATA #IMPLIED> <!ATTLIST WWNGroup name CDATA #IMPLIED> <!ATTLIST WWNGroup nick

Glossary Glossary 316 Glossary Glossary term Definition AL arbitrated loop API application program interface ASL array support library C

Glossary 317 Glossary term Definition OS operating system PDEV physical device P-VOL primary volume (for XP Business Copy Software or XP

Index 318 Index B batch: execution example, 275; execution results, 275 batch file to execute command, 272 D document: providing feedback,

Setting up command line interface 32 NOTE: If the system on which HP-UX operates uses a Dual-Core Intel(R) Itanium(R) 2 Processor for the

Setting up command line interface 33 NOTE: If the value of HDVM_CLI_MEM_SIZE is less than what is required by a CLI command, CLI terminat

Setting up command line interface 34 If you do not know the installation directory for the Common Component, you can check the directory i

Setting up command line interface 35 <device-manager-cli-installation-folder>\DeviceManagerCerts ○ In Solaris, Linux or HP-UX: <

Command line interface syntax and parameters 36 3 Command line interface syntax and parameters This chapter discusses the following: • C

Command line interface syntax and parameters 37 NOTE: When you specify options in the properties file, you can omit them on the command l

Command line interface syntax and parameters 38 Table 3-1 hdvmcli options Option Argument Status Description -o or --output Filename 2 O

Command line interface syntax and parameters 39 Each command may have required parameters, optional parameters, or both, and you can speci

Contents 4 Contents Figures and Tables Figures ...

Command line interface syntax and parameters 40 Table 3-2 Return values Return Values Description 1 CLI found errors within its process

Command line interface syntax and parameters 41 DeleteLun AddHostStorageDomain DeleteHostStorageDomain Add

Command line interface syntax and parameters 42 GetArrayReservation FOR COMMAND-SPECIFIC HELP, TYPE: "hdvmcli help {server-c

Command line interface syntax and parameters 43 required; others, optional. Domain N

Command line interface syntax and parameters 44 Table 3-3 Notes on executing CLI commands Item Description Related Commands Changing the

Command line interface commands 45 4 Command line interface commands This chapter discusses the following topics: • Extracting parameter

Command line interface commands 46 Table 4-1 describes which CLI commands can be used to find which parameter values. Table 4-1 Extractin

Command line interface commands 47 Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: domain Execute the GetSto

Command line interface commands 48 Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: munum Obtain this value f

Command line interface commands 49 Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: pvolpoolid Obtain this va

Contents 5 4-4-6 AddStorageArray...

Command line interface commands 50 4-2 Supported CLI commands Table 4-2 through Table 4-7 give details about Device Manager CLI commands.

Command line interface commands 51 Table 4-2 Storage array commands Storage Subsystems Command Name Description XP24000/XP20000 XP12000/

Command line interface commands 52 NOTE: You can use the subtarget parameter to specify the device information. Available values are: • s

Command line interface commands 53 Table 4-4 LUN commands Storage Subsystems Command Name Description XP24000/XP20000 XP12000/ XP10000/

Command line interface commands 54 Table 4-5 Host management commands Command Name Description Sub- sectionDeleteHostInfo Deletes host-

Command line interface commands 55 Table 4-7 Replication commands Storage Subsystems Command Name Description XP24000/XP20000 XP12000/ X

Command line interface commands 56 Table 4-8, Table 4-9, Table 4-10, Table 4-11, Table 4-12, and Table 4-13 list commands and show their a

Command line interface commands 57 Table 4-9 Availability of logical group commands based on resource group and user permission All Resou

Command line interface commands 58 Table 4-11 Availability of host management commands based on resource group and user permission All Re

Command line interface commands 59 Table 4-13 Availability of replication commands based on resource group and user permission All Resour

Contents 6 4-7-1 AddHost...

Command line interface commands 60 • AddWWNForLunGroup • DeleteWWNForLunGroup • AddLogicalUnit • DeleteLogicalUnit • ModifyLogicalUni

Command line interface commands 61 Table 4-15 AddHostStorageDomain command parameters Parameter Name Status Description domain Optional

Command line interface commands 62 Table 4-15 AddHostStorageDomain command parameters Parameter Name Status Description • Sequent • H

Command line interface commands 63 Table 4-15 AddHostStorageDomain command parameters Parameter Name Status Description XP10000/ SVS200

Command line interface commands 64 NOTE: For XP12000/XP10000/SVS200, logical units cannot be created in array groups with chassis numbers

Command line interface commands 65 Table 4-16 AddLogicalUnit command parameters Parameter Name Status Description capacity Required De

Command line interface commands 66 Command execution example: In this example, the CLI command creates a logical unit (capacity: 1,000,080

Command line interface commands 67 using logical devices that the user is permitted to access. If LDEVs that are not allowed are specified

Command line interface commands 68 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false

Command line interface commands 69 systemDisk=0 An instance of LDEV objectID=***** devNum=1,002

Contents 7 4-10-37 Items output when instance is WWNGroup...

Command line interface commands 70 • It has a guard mode of Read/Write. • It has an emulation type of OPEN-V. • It is not an XP Thin Pr

Command line interface commands 71 Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray ar

Command line interface commands 72 thpPoolID=0 threshold=-1 tcaPoolID=-1 An instance of LogicalUnit

Command line interface commands 73 NOTE: When using the AddStorageArray command to register storage subsystem information, HP recommends

Command line interface commands 74 Table 4-19 AddStorageArray command parameters Parameter Name Status Description searchcommunity Opti

Command line interface commands 75 Command execution result: RESPONSE: An instance of StorageArray objectID=***** [email protected]

Command line interface commands 76 numberOfOpenUnallocatedLUs=990 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLD

Command line interface commands 77 Format when the command is used to create THP volumes in an existing virtual volume group: hdvmcli [URL

Command line interface commands 78 Table 4-20 AddVirtualVolume command parameters Parameter Name Status Description numoflus Optional

Command line interface commands 79 diskType= diskSize=-1 diskSizeInKB=-1 controllerID=-1 totalCapacity=419,4

Figures and Tables 8 Figures and Tables Figures Figure 3-1 Example of CLI help for the AddLun command...

Command line interface commands 80 businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeTy

Command line interface commands 81 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 raidT

Command line interface commands 82 sizeInKB=2,801,729,280 cylinders=0 fsControlIndex=0 *****: The value is e

Command line interface commands 83 Table 4-22 DeleteHostStorageDomain command parameters Parameter Name Status Description domain Optio

Command line interface commands 84 Table 4-23 DeleteLogicalUnit command parameters Parameter Name Status Description devnum Required T

Command line interface commands 85 Command execution result: RESPONSE: (Command completed; empty list returned) 4-4-12 DeletePool Delet

Command line interface commands 86 NOTE: If execution of the DeleteStorageArray command results in an error, take appropriate action acco

Command line interface commands 87 Table 4-27 DeleteVirtualVolume command parameters Parameter Name Status Description model Required

Command line interface commands 88 NOTE: When formatting the LDEV, make sure that the value of the status attribute of the LDEV is Blocke

Command line interface commands 89 Command execution example: hdvmcli -t formatlu model=XP12000 serialnum=82893 devnums=3:E8,3:E9 Comman

Figures and Tables 9 Table 4-28 FormatLU command parameters ...

Command line interface commands 90 slotSizeInKB=64 chassis=1 arrayGroup=144 path=false o

Command line interface commands 91 displayName=03:E9 emulation=OPEN-V cylinders=0 isComposite=0

Command line interface commands 92 4-4-17 GetStorageArray GetStorageArray obtains information about storage subsystems managed by the Dev

Command line interface commands 93 Table 4-29 Element information that can be acquired by using the parameter subtarget Value of subtarge

Command line interface commands 94 Table 4-30 subinfo parameters that can be used together with the parameter subtarget Value of the para

Command line interface commands 95 Table 4-30 subinfo parameters that can be used together with the parameter subtarget Value of the para

Command line interface commands 96 Table 4-31 shows examples of specifying the parameter subtarget and the subinfo parameters. Table 4-31

Command line interface commands 97 microcodeVersion=01-13-56/00 agentVersion=02-01-06/00 productName=XP512 controllerVersion=01-18

Command line interface commands 98 statusOfDBInconsistency=0 openAllocatedActualCapacity=1,038,504,240 openUnallocatedCapacity=355,4

Command line interface commands 99 Table 4-33 GetStorageArray (subtarget=ArrayGroup) command parameters Parameter Name Status Descripti