HP XP12000 Manuel d'utilisateur

HP StorageWorks Command View XP Advanced Edition Device Manager CLI User Guide Part number: T1780-96011 Second edition: October, 2005

Command View XP Advanced Edition Device Manager Overview 10 1 Command View XP Advanced Edition Device Manager Overview This chapter provides an

Command Line Interface Commands 100 pvolarraytype=model pvolserialnum=serial-number pvoldevnum=device-number [pvolportid=port-number] svolarrayt

Command Line Interface Commands 101 Table 4-78 AddReplication Command Parameters Parameter Name Status Description groupname Optional Specify

Command Line Interface Commands 102 Table 4-78 AddReplication Command Parameters Parameter Name Status Description replicationfunction Optio

Command Line Interface Commands 103 hdvmcli [URL] AddReplication [option] replicationgroupid=copy-group-number pvolarraytype=model pvolserialnum=s

Command Line Interface Commands 104 {BusinessCopy|ContinuousAccess|ContinuousAccessExtension|Snapshot}] [fencelevel=fence-level] [copytracksize=

Command Line Interface Commands 105 serial number 35001. The host ID is 4, the Continuous Access XP instance number is 15, the port number is 5000

Command Line Interface Commands 106 Table 4-80 DeleteReplication Command Parameters Parameter Name Status Description pvolserialnum Optional

Command Line Interface Commands 107 RESPONSE (Command completed; no data returned) 4-8-4 GetReplicationControllerPair GetReplicationControllerPai

Command Line Interface Commands 108 remoteArrayType=HDS9980V remoteSerialNumber=15001 remoteSSID=65534 remoteControllerID=15 remoteSta

Command Line Interface Commands 109 groupName=HCMD_CG000d pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 svolHostID=3 svolIn

Command View XP Advanced Edition Device Manager Overview 11 the Device Manager server. For further information on Device Manager Web Client, pleas

Using the Device Manager Properties File 110 5 Using the Device Manager Properties File This chapter describes how to use property files to spe

Using the Device Manager Properties File 111 # password can be provided directly, or from a password file password=khalsa #password=@D:\\DeviceMa

Using the Device Manager Properties File 112 5-3-3 Message Trace Output You can use the –t or --messagetrace option to record the requests sent

Using the Device Manager Properties File 113 </Add> </StorageManager> </Request> </HiCommandServerMessage> Ex

Using the Device Manager Properties File 114 upTime=1 day 23 hours 35 minutes 27 seconds upSince=Mon, 5 Sep 2005 11:07:51 GMT currentApiVe

Using the Device Manager Properties File 115 <ServerAdmin> <Get target="ServerInfo" /> </ServerAdmin>

Troubleshooting 116 6 Troubleshooting This chapter describes appropriate actions to take if there is a problem with Device Manager CLI. • Troub

Acronyms and Abbreviations 117 Acronyms and Abbreviations AL API ASL CLI DAMP, DMP DKC FC GB GUI HTML HTTP HTTPS HBA ID IP JRE KB LDEV LU

Acronyms and Abbreviations 118 RCU SCSI SNMP SSID S-VOL SVP URL VxVm WWN XML remote control unit (for Continuous Access XP) small computer

Setting Up Command Line Interface 12 2 Setting Up Command Line Interface This chapter describes the system requirements and launching instructi

Setting Up Command Line Interface 13 • Port number of the Device Manager server (default is 2001) • Base address of the Device Manager server (d

Command Line Interface Syntax and Parameters 14 3 Command Line Interface Syntax and Parameters This chapter describes the command syntax and com

Command Line Interface Syntax and Parameters 15 description=“Our Newest Array” Each command may have required parameters, optional parameters, or

Command Line Interface Syntax and Parameters 16 Figure 3-2 displays sample help information, including the CLI version. Device Manager CLI versi

Command Line Interface Syntax and Parameters 17 Figure 3-2 CLI Help (continues on next page) DeleteLUSE AddReplication Del

Command Line Interface Syntax and Parameters 18 Table 3-3 Notes on Executing CLI Commands Item Description Related Commands Changing the secur

Command Line Interface Commands 19 4 Command Line Interface Commands This chapter discusses the following topics: • Extracting parameter values (

2 Legal notices © Copyright 2005 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this

Command Line Interface Commands 20 Table 4-1 Extracting Parameter Values To Find This Parameter Value: Do This: lun Execute the GetStorageArr

Command Line Interface Commands 21 Table 4-1 Extracting Parameter Values To Find This Parameter Value: Do This: svolserialnum Execute the GetHo

Command Line Interface Commands 22 Table 4-2 Storage Array Commands Storage Subsystems Command Name Description XP12000/XP10000 and XP1024/XP

Command Line Interface Commands 23 Table 4-4 LUN Commands Storage Subsystems Command Name Description XP12000/XP10000 and XP1024/XP128 XP512/XP

Command Line Interface Commands 24 Table 4-6 Server Management Commands Command Name Description Section AddURLLink Adds the URL associated

Command Line Interface Commands 25 • AddLUSE • DeleteLUSE • AddWWNForHostStorageDomain • DeleteWWNForHostStorageDomain • AddWWNForLun • Dele

Command Line Interface Commands 26 NOTE: For the StorageWorks XP12000/XP10000 and XP1024/XP128, when AddHostStorageDomain adds a host storage

Command Line Interface Commands 27 Table 4-9 AddHostStorageDomain Command Parameters Parameter Name Status Description nickname Optional (Stor

Command Line Interface Commands 28 Table 4-10 AddLogicalUnit Command Parameters Parameter Name Status Description emulation Optional Emulat

Command Line Interface Commands 29 path=false onDemandDevice=false devType= isStandardLDEV=false

Contents 3 Contents Revision history Revision tables ...

Command Line Interface Commands 30 journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=0

Command Line Interface Commands 31 • Yes: System Administrator, Storage Administrator • No: Guest, Local Guest • Restricted: A Local System A

Command Line Interface Commands 32 agentVersion=02-05-14 productName=XP1024 controllerVersion=21-04-00-00/00 numberOfControllers=4 cap

Command Line Interface Commands 33 • Yes: System Administrator, Storage Administrator, Local System Administrator, Local Storage Administrator •

Command Line Interface Commands 34 Table 4-15 DeleteLogicalUnit Command Parameters Parameter Name Status Description devnum Required Device

Command Line Interface Commands 35 hdvmcli DeleteStorageArray -o "D:\logs\XP1024 DeleteStorageArray.log" "serialnum=10001" &qu

Command Line Interface Commands 36 Command execution example: In this example, the CLI command obtains information about the configuration of a

Command Line Interface Commands 37 Table 4-19 GetStorageArray (subtarget=ArrayGroup) Command Parameters Parameter Name Status Description seria

Command Line Interface Commands 38 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 . . (repeated for other ArrayGroup instances) . Co

Command Line Interface Commands 39 • Restricted to permitted resources: Guest, Local System Administrator, Local Storage Administrator, Local Gue

Contents 4 4-5-13 DeleteWWNGroup...

Command Line Interface Commands 40 serialNumber=10011 arrayFamily=HDS9900 arrayType=HDS9960 microcodeVersion=01-13-56/00 agentVersion=

Command Line Interface Commands 41 description=Normal An instance of Component name=DKC Cache Switch value=1 descripti

Command Line Interface Commands 42 Table 4-22 GetStorageArray (subtarget=Filter) Command Parameters Parameter Name Status Description objectI

Command Line Interface Commands 43 Table 4-23 GetStorageArray (subtarget=FreeSpace) Command Parameters Parameter Name Status Description serial

Command Line Interface Commands 44 fsControlIndex=85 . . (repeated for other ArrayGroup instances) . Command execut

Command Line Interface Commands 45 4-3-12-6 GetStorageArray (subtarget=HostStorageDomain) GetStorageArray (subtarget=HostStorageDomain) obtains th

Command Line Interface Commands 46 An instance of FreeLUN lun=10 . . (repeated for other FreeLUN instanc

Command Line Interface Commands 47 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1756

Command Line Interface Commands 48 Table 4-26 GetStorageArray (subtarget=LogicalUnit) Command Parameters Parameter Name Status Description se

Command Line Interface Commands 49 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapsho

Figures 5 Figures Figure 3-1 Example of CLI Help for the AddLun Command ...

Command Line Interface Commands 50 vendor= HP . . (repeated for other VolumeConnection instances) . 4-3-12-9 GetStorageArra

Command Line Interface Commands 51 List of 256 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nicknam

Command Line Interface Commands 52 Table 4-28 GetStorageArray (subtarget=PDEV) Command Parameters Parameter Name Status Description arraygrou

Command Line Interface Commands 53 Table 4-29 GetStorageArray (subtarget=Port) Command Parameters Parameter Name Status Description subtarget

Command Line Interface Commands 54 domainID=1 hostMode=Standard displayName=CL1-A-1 nickname=HCMD0000

Command Line Interface Commands 55 displayName=CHA-1P mode=1 type=12 . . (repeated for other PortController instances) .

Command Line Interface Commands 56 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 2 R

Command Line Interface Commands 57 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=S-VOL

Command Line Interface Commands 58 NOTE: If you are using a StorageWorks XP512/XP48, check that at least one path is set for the logical unit

Command Line Interface Commands 59 4-3-15 ModifyPort ModifyPort will change port and host storage domain attributes. Users with access to this co

Tables 6 Table 4-51 AddWWNGroup Command Parameters...

Command Line Interface Commands 60 Table 4-34 ModifyPort Command Parameters Parameter Name Status Description hostmode Optional New host c

Command Line Interface Commands 61 Table 4-36 hostModeOption Parameter Values and Description hostModeOption Values Description 2 Specify this

Command Line Interface Commands 62 objectID=HSDOMAIN.HDS9980V.10001.16.0 portID=16 domainID=0 nickname=H

Command Line Interface Commands 63 Table 4-38 RefreshStorageArrays Command Parameters Parameter Name Status Description interval Optional Int

Command Line Interface Commands 64 • No: Guest, Local Guest Table 4-39 AddLogicalGroup Command Parameters Parameter Name Status Description

Command Line Interface Commands 65 4-4-2 AddLunScan AddLunScan scans a storage array for LUNs not assigned to a logical group (see Table 4-40). It

Command Line Interface Commands 66 Table 4-41 AddObjectForLogicalGroup Command Parameters Parameter Name Status Description objectid Require

Command Line Interface Commands 67 Parameter Name Status Description objectid Required Object ID of the logical group. groupelements Required

Command Line Interface Commands 68 nickname=1A-G00 An instance of Path objectID=PATH.HDS9980V.10001.0.0.101 devNum=101

Command Line Interface Commands 69 icon=group12.gif capacity=0 capacityInKB=0 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 .

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

Command Line Interface Commands 70 • Yes: System Administrator, Storage Administrator, Local System Administrator, Local Storage Administrator

Command Line Interface Commands 71 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here)

Command Line Interface Commands 72 clprNumber=-1 volumeKind=3 Command execution example 2: hdvmcli AddLun -o "D:\logs\

Command Line Interface Commands 73 path=false onDemandDevice=false devType= isStandardLDEV=true

Command Line Interface Commands 74 hdvmcli AddLunGroup -o "D:\logs\XP512 AddLunGroup.log" "serialnum=10001" "model=XP51

Command Line Interface Commands 75 "wwn=22.33.44.55.44.55.44.33,11.33.22.33.44.33.22.22" Command execution result: RESPONSE: An instanc

Command Line Interface Commands 76 An instance of Path objectID=PATH.HDS9960.10001.16.0.16 devNum=16 portID=16 domai

Command Line Interface Commands 77 WWN=11.55.77.99.33.00.22.66 . . (repeated for other Path instances) . 4-5-6 AddWWNGroup

Command Line Interface Commands 78 nickname=Jone 4-5-7 DeleteLun DeleteLun deletes a path from a host to a volume (see Table 4-52). I

Command Line Interface Commands 79 "model=XP512" "port=19" "lungroupid=LUNGROUP.HDS9960.10011.19.LG00" Command exec

About this guide 8 HP technical support Telephone numbers for worldwide technical support are listed on the HP web site: http://www.hp.com/suppor

Command Line Interface Commands 80 Command execution result: RESPONSE: (Command completed; no data returned) 4-5-11 DeleteWWNForLun DeleteWWNF

Command Line Interface Commands 81 Table 4-57 DeleteWWNForLunGroup Command Parameters Parameter Name Status Description wwn Required Comma-se

Command Line Interface Commands 82 NOTE: ModifyLunGroup is supported by StorageWorks XP512/XP48 storage subsystems only. Table 4-59 ModifyLu

Command Line Interface Commands 83 • No: Guest, Local Guest • Restricted to permitted resources: Local System Administrator and Local Storage Ad

Command Line Interface Commands 84 4-6-1 AddHost AddHost adds information about a host server to the Device Manager server (see Table 4-61). Use

Command Line Interface Commands 85 Table 4-62 AddHostInfo Command Parameters Parameter Name Status Description portwwn Optional Port WWN on t

Command Line Interface Commands 86 • Yes: System Administrator, Storage Administrator, Local System Administrator, Local Storage Administrator

Command Line Interface Commands 87 Table 4-65 DeleteHostInfo Command Parameters Parameter Name Status Description objectid Required Object ID

Command Line Interface Commands 88 objectID=CONFIGFILE.1.11 instanceNumber=11 controlledBy=Device Manager portNumber=500

Command Line Interface Commands 89 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 List of 2 WWN elements: An instance of WWN

Revision history 9 Revision history Revision tables Table 2 Revisions Date Edition Revision July 11, 2005 First Initial Release October, 2005

Command Line Interface Commands 90 copyTrackSize=15 splitTime=-1 4-6-7 GetHostInfo GetHostInfo returns either a selecte

Command Line Interface Commands 91 devNum=3 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS file

Command Line Interface Commands 92 • Restricted to permitted resources: Local System Administrator and Local Storage Administrator do not have

Command Line Interface Commands 93 scsiID=15 lun=2 devNum=2 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.33.55.77.99.BB.DD.FF fileSy

Command Line Interface Commands 94 Command execution example 1: hdvmcli DeleteAlerts -o "D:\logs\ALL DeleteAlerts.log" "alertnum=

Command Line Interface Commands 95 Table 4-73 GetAlerts Command Parameters Parameter Name Status Description countfilter Optional (returned al

Command Line Interface Commands 96 Users with access to this command: • Yes: System Administrator, Storage Administrator • No: Guest, Local Gu

Command Line Interface Commands 97 Table 4-75 GetURLLink Command Parameters Parameter Name Status Description objectid Optional The object ID

Command Line Interface Commands 98 An instance of DebugLevel value=0 [Full Debugging trace] description=Debugging Trace 4-8 Replication Com

Command Line Interface Commands 99 Table 4-77 AddConfigFileForReplication Command Parameters Parameter Name Status Description pvolserialnum R