Home

HP XP12000 User's Manual

1. Parameter Name Status Description objectid Required Object ID of the host to be modified hostname Optional New name for the existing host Omit this parameter if you do not want to change the name wwnlist Optional Comma separated list of WWNs to replace existing WWNs When you omit this parameter all WWNs in the host will be deleted ipaddress Optional New IP address for the existing host Omit this parameter if you do not want to change the host IP address D LL _ lt _ ____L__ _ _ _ S a Command execution example hdvmcli ModifyHost o D logs ModifyHost log objectid HOST 3 hostname snow wwnlist 12 34 56 78 90 AB CD EF 01 23 45 67 89 AB CD EF ipaddress 172 18 32 9 Command execution result RESPONSE An instance of Host object ID HOST 3 name snow ipAddress 172 18 32 9 capacityInKB 0 hostType 1 List of 2 WWN elements An instance of WWN WWN 01 23 45 67 89 AB CD EF An instance of WWN WWN 12 34 56 78 90 AB CD EF 4 6 9 ModifyHostinfo ModifyHostInfo modifies a Host Info record in the Device Manager server see Table 4 69 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Command Line Interface Commands 91 Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range
2. sssseessseeessteeeernesttnsrtnrnntnrnstrrtrnestnnntennnnnnnnnnenn nennt 26 Table 4 10 AddLogicalUnit Command Parameters nonsssnnnineeeeeeinitrrer errer ttttttnnteetttrnnrrretttt rennet ran rneer e rennene 27 Table 4 11 AddLUSE Command Parametere 29 Table 4 12 AddStorageArray Command Parameters nennen nenne 31 Table 4 13 AddStorageArray Command Parameters nnne nnne nenene 33 Table 4 14 DeleteStorageHostDomain Command Parameters c cccceceeceeeeeeneeeeeeeeeeeeeeeeeeeeeeeeeeeseseeeeseneeees 33 Table 4 15 DeleteLogicalUnit Command Parameters ccccccccccssssceeeeeessseeseeeeeeeesceeseeesaeeeeeeesseeesaeeeeeeeesseeeaaeees 34 Table 4 16 DeleteLogicalUnit Command Parameters cccccccccssssscecceessssssteeeeeeeesceeseeesaeeeeeeeeseesnseeeeeeeeseeeeaaeees 34 Table 4 17 AddStorageArray Command Parameters nnne nennen nenet 34 Table 4 18 GetStorageArray Command PDarameters nenene nenne 35 Table 4 19 GetStorageArray subtarget ArrayGroup Command PDarameiers nenne 36 Table 4 20 GetStorageArray subtarget Commparameters Command Parameter 39 Table 4 21 GetStorageArray subtarget Component Command PDarameiers nenne 39 Table 4 22 GetStorageArray subtarget Filter Command Parameters ccccccccssecsssssceeeeeeesssseseeeeeeeesssssteaeess 41 Table 4 23 GetStorageArray subtarget FreeSpace Command Parameters cccssccecceeeesesssneeeeeeeeeeeessssseeeees 42 Table 4 24 GetStorageArray subtarget Ho
3. Using URLLink When the CLI command and Web Client are used at the AddURLLink same time other Web programs provided by Web Client DeleteURLLink might not be able to start Only a system administrator who has expert knowledge can use this combination Using Disk Cache Partition When you use Disk Cache Partition to create a LUSE AddLUSE when using StorageWorks volume path or copy pair Business Copy XP specify AddLun XP12000 XP 10000 the same storage logical partition If you specify a AddReplication different storage logical partition the storage partition administrator will not be able to manage the created resource PE Command Line Interface Syntax and Parameters 18 4 Command Line Interface Commands This chapter discusses the following topics Extracting parameter values section 4 1 CLI commands and subsystem applicability section 4 2 Storage Array Commands section 4 3 H Logical Command Groups section 4 4 e LUN Commands section 4 5 e Host Management Commands section 4 6 e Server Management Commands section 4 7 Replication Commands section 4 8 4 1 Extracting Parameter Values Some of the parameter values for CLI commands can be found by executing other CLI commands and extracting the parameter values from the resulting output For example in some CLI commands the devnunm is a required parameter To find a particular devnum parameter you can execute the GetStora
4. Command execution example hdvmcli AddObjectForLogicalGroup o D logs XP1024 AddObjectForLogicalGroup log objectID GROUP 0 groupelements PATH HDS9980V 10001 0 0 1 Command execution result RESPONSE An instance of LogicalGroup object ID GROUP 1 name toro parent ID GROUP 0 logicalPath root toro icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 List of 1 GroupElement elements An instance of Path object ID PATH HDS9980V 10001 0 0 0 devNum 0 portID 0 domainID 0 scsiID 15 LUN 0 wwnSecurityValidity true 4 4 4 DeleteLogicalGroup DeleteLogicalGroup deletes an existing logical group from the Device Manager server see Table 4 42 A Guest or Local Guest does not have operational permissions Table 4 42 DeleteLogicalGroup Command Parameters Command execution example Description Object ID of the logical group to be deleted hdvmcli DeleteLogicalGroup o D logs DeleteLogicalGroup log objectid GROUP 0 Command execution result RESPONSE Command completed no data returned 4 4 5 DeleteObjectForLogicalGroup DeleteObject ForLogicalGroup removes the specified object or objects from the logical group see Table 4 43 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest Table 4 43 Del
5. A maximum of 127 WWN groups can be set for a port Only the existing WWNs already used for the port can be changed You cannot change a WWN that belongs to a different WWN group or to a different LUN or LUN group Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator Command Line Interface Commands 82 D No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations E NOTE ModifyWWNGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 60 ModifyWWNGroup Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array in which the WWN group exists model Required Model of the storage array in which the WWN group exists port Required Port number of the WWN group objectid Required Object ID of the WWN group wwn Required Comma separated list of WWNs to be added to the WWN group nickname Optional Unique nickname of the WWN group name Optional The name given to the WWN group Command execution example hdvmcli ModifyWWNGroup o D logs XP512 ModifyWWNGroup log serialnum 10001 model XP512 port 19 objectid WWNGROUP HDS9960 10001 19 hp wwn AA AA AA AA AA AA AA AA BB BB BB BB BB BB BB BB nickname hp Command execu
6. Business Copy XP can create a replica of one or more volumes in the same subsystem 1 5 Downloading CLI from the Device Manager Server By using Web Client you must download Device Manager CLI from the Device Manager server To download Device Manager CLI from the Device Manager server 1 In the navigation frame of Web Client select the Device Manager object 2 Select the Download method in the method frame 3 Click the Download link that corresponds to the OS running on the machine on which Device Manager CLI is to be installed 4 Copy the downloaded file to the machine on which Device Manager CLI is to be installed 5 Decompress the downloaded file After modifying the hdvmcli properties file as needed you can run Device Manager CLI For details on how to download Device Manager CLI see the manual HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide Command View XP Advanced Edition Device Manager Overview 11 2 Setting Up Command Line Interface This chapter describes the system requirements and launching instructions for Device Manager CLI CLI Requirements section 2 1 Launching CLI section 2 2 Using CLI with a secured server section 2 3 2 1 Requirements for CLI Operations RY Storage Subsystems All storage subsystems must be configured for Device Manager operations Please refer to HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide
7. Command Line Interface Commands 70 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Path elements object ID PATH HDS9960 10001 3 16 127 name liu devNum 127 portID 3 domainID 16 scsiID 15 LUN 127 wwnSecurityValidity true List of 1 WWN elements An instance of WWN WWN AA AA An AA An AA An AA nickname Jane List of 2 Ldev elements An instance of LDEV object ID LDEV HDS9960 10001 127 devNum 127 displayName 0 7F emulation OPEN 8 cylinders 50 isComposite 1 sizeInKB 36 000 lba 72 000 raidType RAID5 3D 1P slotSizeInKB 48 chassis 1 arrayGroup 7 path true onDemandDevice false devType isStandardLDEV false substance 0 volumeType 3 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 An instance of LDEV object ID LDEV HDS9960 10001 128 devNum 128 displayName 0 80 emulation OPEN 8 cylinders 50 isComposite 1 sizeInKB 36 000 lba 72 000 raidType RAID5 3D 1P slotSizeInKB 48 chassis 1 arrayGroup 7 path false onDemandDevice false devType isStandardLDEV false substance 0 volumeType 3 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 Command Line Interface Commands 71 clprNumber 1 volumeKind 3 Command execution example 2 hdvmcli AddLun o D logs XP1024 AddLun log serialnum 10001 port 1 domain 4 scsi 15 lun 114 lusedevnums 1001 1002 model XP1024 name hp Command
8. Command execution example 1 In this example the CLI command obtains information about the port controller for a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray PortController log subtarget PortController model XP1024 serialnum 10001 Command execution result 1 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 4 PortController elements An instance of PortController object ID CONTROLLER HDS9980V 10001 1 cluster 1 card 1 controllerID 1 Command Line Interface Commands 54 displayName CHA 1P mode 1 type 12 repeated for other PortController instances Command execution example 2 In this example the CLI command obtains information about the port controller ID 1 used for a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray PortController log subtarget PortController model XP1024 serialnum 10001 controllernum 1 Command execution result 2 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 PortController elements An instance of PortController object ID CONTROLLER HDS9980V 10001 1 cluster 1 card 1 controllerID 1 displayName CHA 1P mode 1 type 12 4 3 12 13 GetStorageArray subtarget Replication nfo GetStorageArray subtarget Repl
9. GetStorageArray subtarget Component obtains information about the configuration of one or all storage subsystems Users with access to this command Yes System Administrator Storage Administrator No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 21 GetStorageArray subtarget Component Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter you will obtain information about the models of all storage subsystems serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify Component Command execution example In this example the CLI command obtains information about the configuration of a storage subsystem serial number 10011 model XP512 hdvmcli GetStorageArray o D logs XP512 GetStorageArray Component log subtarget Component model XP512 serialnum 10011 Command result RESPONSE An instance of StorageArray object ID ARRAY HDS9960 10011 name XP512 10 208 114 140 description XP512 10011 at 10 208 114 140 Command Line Interface Commands 39 serialNumber 10011 arrayFamily HDS9900 arrayType HDS9960 microcodeVersion 01 13 56 00 agentVersion 02 01 06 00 productName XP512 controllerVersion 01 18 01 00 00
10. Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Lu elements An instance of LogicalUnit object ID LU HDS9980V 15001 1001 devNum 1 001 displayName 3 E9 emulation OPEN 3 devCount 2 devType capacityInKB 4 806 720 path false commandDevice false chassis 3 arrayGroup 16 raidType RAID5 3D 1P current PortController 1 defaultPortController 1 isComposite 1 cont inuousAccessVolumeType Simplex businessCopyVolumeType Simplex snapshot VolumeType Simplex Command Line Interface Commands 29 journalVolumeType Simplex sysVolFlag 0 externalVolume 0 differentialManagement 0 List of 2 Ldev elements An instance of LDEV object ID LDEV HDS9980V 15001 1001 devNum 1 001 displayName 3 E9 emulation OPEN 3 cylinders 0 isComposite 1 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 3 arrayGroup 16 path false onDemandDevice false devType isStandardLDEV true guardMode substance 0 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 An instance of LDEV objectID LDEV HDS9980V 15001 1002 devNum 1 002 displayName 3 EA emulation OPEN 3 cylinders 0 isComposite 1 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 3 arrayGroup 16 path false onDemandDevice false devType isStandardLDEV true guardMode substance 0 vo
11. Y 4 5 6 DeleteLun Deletes the path to a volume Y Y 4 5 7 from the host DeleteLunGroup Deletes a LUN group to which a Y 4 5 8 port is assigned DeleteWwWN Deletes a WWN from a port Y Y 4 5 9 DeleteWWNForHostStorageDomain Releases the security set toa Y Y 4 5 10 LUN in the specified host storage domain DeleteWWNForLun Deletes a path from the host to Y 4 5 11 a volume DeleteWWNForLunGroup Deletes a WWN assigned toa Y 4 5 12 LUN group DeleteWWNGroup Deletes a WWN group Y 4 5 13 ModifyLUNGroup Modifies information about a Y 4 5 14 specified LUN group Modif yWWNGroup Modifies the information about a Y 4 5 15 WWN group Table 4 5 Host Management Commands Command Name Description Section AddHost Registers information about a host into the Device Manager server database 4 6 1 AddHostInfo Registers host based information about a LUN into the Device Manager server 4 6 2 database AddHostRefresh Refreshes information about a host from the Device Manager server 4 6 3 DeleteHost Deletes information about a host from the Device Manager server database 4 6 4 DeleteHostInfo Deletes host based information about a LUN from the Device Manager server 4 6 5 database GetHost Obtains information about a host 4 6 6 GetHostInfo Obtains host based information about a LUN 4 6 7 ModifyHost Modifies information about a host 4
12. An instance of HostInfo object ID HOSTINFO HIS HOSTINFO XP1024 0 15 1 name HIS HOSTINFO XP1024 serialNumber 10001 arrayType HDS9980V ipAddress 172 16 64 159 mount Point C portID 7 domainID 0 scsiID 15 lun 3 devNum 3 osScsiBus 0 osScsiID 15 osLun 1 portWWN 11 22 33 44 55 66 77 88 fileSystemType NTFS fileSystemName C sizeInMB 10 percentUsed 10 lastUpdated 1039003852 Command execution example 2 hdvmcli GetHostInfo o D logs XP1024 GetHostInfo log Command execution result 2 RESPONSE An instance of HostInfo object ID HOSTINFO HIS HOSTINFO XP1024 0 15 1 name HIS HOSTINFO XP1024 serialNumber 10001 arrayType HDS9980V ipAddress 172 16 64 159 mount Point C portID 7 domainID 0 scsiID 15 lun 3 Command Line Interface Commands 90 devNum 3 osScsiBus 0 osScsiID 15 osLun 1 portWWN 11 22 33 44 55 66 77 88 fileSystemType NTFS fileSystemName C sizeInMB 10 percentUsed 10 lastUpdated 1039003852 repeated for other HostInfo instances 4 6 8 ModifyHost E ModifyHost modifies information about a host server see Table 4 68 NOTE ModifyHost cannot change WWN information for the external port of a host A Guest or Local Guest does not have operational permissions A Local System Administrator and Local Storage Administrator can specify the allowed hosts only If other hosts that are not allowed are specified an error occurs Table 4 68 ModifyHost Command Parameters
13. CLI Help continues on next D gel nn nnnrn nn nnnnrnnnnnnnnnnnnennnnnnnenrnnenonnrnnnnennrnnnnenenn 17 Tables Table 1 Document CONVENTIONS ccceccceeeeeeeeeeeeeeeeeeeeeeeceeeeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeceeeeeeeeeeeeeeeeeeeeeseeeseeeeeeseeeeeeeeeeeeess 7 Table 2 Revisions EE 9 Table 3 1 hdvmeli Options ssie eee R EE EAE ERa E a Eaa AEEA RES EEEE EER EEEa 14 Table 3 2 Return Values rrnnnnnnnnnnnnnnnrnnnnvorrrnrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnrrnrnnrnnnnnrnnnnnnnrnnnnnnnnnnnnnrnnnnnnnnnnnnnnnnnrrnnnn sne 15 Table 3 3 Notes on Executing CLlCommandes rnnt EEnntnEEn snena nenn nennen nnee 17 Table 4 1 Extracting Parameter Values ccecccceeeeeeeeeeeeeeeeeeeeeeeeeaaeaeeeeeeeeeeaaaeeeeeeeeeeeaaaeeeeeeesseenaaaeeeeeeeeeeeenaeeees 19 Table 4 2 Storage Array Commande rrrnnnnnnrnnnrnnnrnnnnnnrnrrnnnnnnrnnnner raner nnenrn raner rn nnnnrnnnnnenrnnnnnenrnnnnnnrnnnnnenrrnnnnnnnnn 21 Table 4 3 Logical Group Commande scissioni ES EES EES EE EENEG 22 Table 4 4 LUN Commandes 22 Table 4 5 Host Management Commandes nn nnnnnn nn nnnnrnnnnnenrnnnnnnrnnnnnenrnnnnnenrnnnnnnrrnnnnenrrnnnnennnn 23 Table 4 6 Server Management Commandes nn nnnerrn nn nnnnrnnnnerrnnnnnenrnnnnnenrnnnnenrnnnnnennnn 23 Table 4 7 Replication Commandes 24 Table 4 8 AddArrayReservation Command Parameters cccccessceeceeeeeeeeesennseeeeeeeesseenseeeeeeeeeseeessseeeeeessseneanaeess 25 Table 4 9 AddHostStorageDomain Command Parameters
14. Information about the detected storage subsystems is registered in the Device Manager database hdvmcli AddStorageArray o D logs XP1024 AddStorageArray log ipaddress 172 16 45 1 family XP1024 128 userid root arraypasswd hdvm displayfamily XP1024 128 Command execution result RESPONSE An instance of StorageArray objectID ARRAY HDS9980V 10001 name XP10240172 16 45 1 description XP1024 10001 at 172 16 45 1 serialNumber 10001 arrayFamily HDS9900V arrayType HDS9980V microcodeVersion 21 03 00 00 Command Line Interface Commands 31 agentVersion 02 05 14 productName XP1024 controllerVersion 21 04 00 00 00 numberOfControllers 4 capacityInGB 4 018 cacheInMB 1 sharedMemoryInMB 1 numberOfSpareDrives 1 freeCapacityInGB 3 585 allocatedCapacityInGB 434 autoLunCapacityInGB 0 onDemandCapacityInGB 0 totalFreeSpaceInGB 45 largest FreeSpaceInGB 5 capacityInKB 4 213 640 160 freeCapacityInKB 3 759 001 920 allocatedCapacityInKB 454 638 240 autoLunCapacityInKB 0 onDemandCapacityInKB 0 totalFreeSpaceInKB 47 008 512 largestFreeSpaceInKB 5 753 088 multipathSupport 1 securityStatus 2 sequenceNumber 10001 displayArrayFamily XP1024 128 displayArrayType XP1024 numberOfLUs 1 744 numberOfAllocatedLUs 180 numberOfUnallocatedLUs 1 564 slprStatus 1 openTotalCapacity 4 213 640 160 openAllocatedCapacity 454 638 240 openFreeCapacity 3 759 001 920 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAlloc
15. LDEV LU LUN LUSE MB MCU OS PDEV P VOL RAID arbitrated loop application program interface array support library command line interface disk array management program disk controller fibre channel gigabytes 1024 MB graphical user interface hypertext markup language hypertext transmission protocol hypertext transmission protocol secure host bus adapter identification identifier internet protocol Java Runtime Environment kilobytes 1024 bytes logical device logical unit logical unit number LU Size Expansion feature of XP1024 XP128 and XP512 XP48 megabytes 1024 KB main control unit for Continuous Access XP operating system physical device primary volume for Business Copy XP or Continuous Access XP redundant array of independent disks Acronyms and Abbreviations 117 RCU SCSI SNMP SSID S VOL SVP URL VxVm WWN XML remote control unit for Continuous Access XP small computer system interface simple network management protocol storage subsystem ID secondary volume for Business Copy XP or Continuous Access XP service processor component of XP1024 XP128 and XP512 XP48 uniform resource locator VERITAS Volume Manager worldwide name extensible markup language Acronyms and Abbreviations 118
16. List of 2 WWN elements An instance of WWN Command Line Interface Commands 76 WWN 11 55 77 99 33 00 22 66 repeated for other Path instances 4 5 6 AddWWNGroup AddWWNGroup adds a WWN group to a target storage array port XP512 XP48 subsystem only and two or more WWN s to the WWN group see Table 4 51 The maximum number of WWNs in a port WWN group is 127 Only new WWINs none that pre exist on the port can be added A maximum of 127 WWN groups can be set to a port As the WWNs to be grouped into a WWN group you can specify only the WWNs already set for a port or newly created WWNs The WWNs that you have newly specified will be added to the port You cannot add a WWN that belongs to a different WWN group or to a different LUN or LUN group Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Eg NOTE AddWWNGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 51 AddWWNGroup Command Parameters Parameter Name Status Description serialnum Required Serial number of the target storage array to which the WWN group is added model Required Model of the target storage array to which the WWN group is add
17. nickname HCMD1001 4 3 3 AddLogicalUnit AddLogicalUnit creates an LDEV and logical unit in Device Manager see Table 4 10 When executed this command also formats the logical devices that it creates Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest When executed this command also formats the logical devices that it creates Eg NOTE You cannot create an LDEV that is the same size as the free space of the array group because the control area is created on the storage subsystem side Table 4 10 AddLogicalUnit Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array where LU is added model Required Model of the storage array where the LU is added chassis Required Number of chassis for the array group where LU is added groupnum Required Group number of the array group where LU is added capacity Required Desired capacity in KB for the new LU The specified value is adjusted depending on the minimum unit that is set to the volume size of each storage subsystem Therefore the size of the logical unit that was actually created might exceed the specified value Command Line Interface Commands 27 Table 4 10 AddLogicalUnit Command Parameters Parameter Name Status Description emulation Optional Emulation type of t
18. 0 01 on XP1024 Serial 15045 where Port 1 A HostStorageDomain 0 LU 100 is assigned to that LUN do the following hdvmcli t addLUN serialnum 15045 model XP1024 port 0 domain 0 scsi 15 lun 100 devnum 1 Following XML API request will be generated according to specified parameters to hdvmcli lt xml version 1 0 encoding UTF 8 gt lt HiCommandServerMessage gt lt APIInfo version 4 3 gt lt Request gt lt StorageManager gt lt Add target LUN gt lt StorageArray object ID ARRAY HDS9980V 15045 gt lt Path portID 0 domainID 0 scsiID 15 lun 100 devNum 1 gt lt StorageArray gt Using the Device Manager Properties File 112 lt Add gt lt StorageManager gt lt Request gt lt HiCommandServerMessage gt Example 2 Save the following to a file lt xml version 1 0 encoding UTF 8 gt lt HiCommandServerMessage gt lt APIInfo version 4 3 gt lt Request gt lt StorageManager gt lt Add target LUN gt lt StorageArray object ID ARRAY HDS9980V 15045 gt lt Path portID 0 domainID 0 scsiID 15 lun 102 devNum 102 gt lt Path portID 0 domainID 0 scsiID 15 lun 104 devNum 104 gt lt StorageArray gt lt Add gt lt StorageManager gt lt Request gt lt HiCommandServerMessage gt When you specify the saved file that contains the preceding message you can create multiple LUNs using one command as follows hdvmel
19. 1 portWWN 11 33 55 77 99 BB DD FF fileSystemType NTFS1 fileSystemName oo sizeInMB 156 percentUsed 50 lastUpdated 1039003476 4 7 Server Management Commands The Server Management commands provide some management support for the Device Manager server 4 7 1 AddURLLink AddURLLink adds a URL associated with an application and links it with a Command View XP AE object see Table 4 70 If the Command View XP AE object already has an URLLink associated with it the existing reference is overwritten and no error is returned Table 4 70 AddURLLink Command Parameters Parameter Name Status Description url Required The complete URL is required to launch the application or web page name Required Name of the application linkedid Required The object ID to link to Must be a valid existing Command View XP AE object ID description Optional Description of URLLink Command execution example hdvmcli AddURLLink o D logs XP1024 AddURLLink log url 192 168 99 AA name AUTO linkedid HSDOMAIN HDS9980V 10001 0 3 description ARRAY HDS9980V 10001 Command execution result RESPONSE An instance of URLLink object ID URLLINK HSDOMAIN HDS9980V 10001 0 3 1 name AUTO url 192 168 99 AA linkedID HSDOMAIN HDS9980V 10001 0 3 description ARRAY HDS9980V 10001 4 7 2 DeleteAlerts DeleteAlerts deletes one or more alerts from the Device Manager server see Table 4 71 You can specify
20. 4 14 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator H No Guest Local Guest E NOTE When a host group or host storage domain to which paths are assigned is specified access permissions to all the LDEVs to which paths are assigned are required If any inaccessible LDEVs are included an error occurs Table 4 14 DeleteStorageHostDomain Command Parameters Parameter Name Status Description deletionoption Optional Only possible value is lusekeep Omit this parameter to delete a LUSE domain Required The domain ID of the Host Storage Domain to be deleted NOTE Do not specify 0 You cannot delete host domain 0 model Required Model of the storage array for the Host Storage Domain port Required The port ID of the Host Storage Domain to be deleted serialnum Required Serial number of the storage array for the Host Storage Domain Command execution example hdvmcli DeleteHostStorageDomain o D logs XP1024 DeleteHostStorageDomain log serialnum 10001 model XP1024 port 16 domain 1 deletionoption lusekeep Command execution result RESPONSE Command completed no data returned 4 3 8 DeleteLogicalUnit DeleteLogicalUnit deletes the logical unit and corresponding LDEV from the storage device see Table 4 15 Users with access to this command Yes System Administrator
21. 6 8 ModifyHostInfo Modifies host based information about a LUN 4 6 9 Table 4 6 Server Management Commands Command Line Interface Commands 23 Table 4 6 Server Management Commands Command Name Description Section AddURLLink Adds the URL associated with the application and links it to the Command View XP AE 4 7 1 object DeleteAlerts Deletes information about one or more alerts that are managed by the Device Manager 4 7 2 server DeleteURLLink Deletes the relationship between the application or web page and the Device Manager 4 7 3 server object GetAlerts Obtains information about one or more alerts that are managed by the Device Manager 4 7 4 server GetDebugLevel Obtains the current debug level of the Device Manager server 4 7 5 GetLogFile Obtains the requested Device Manager server log file 4 7 6 GetServerInfo Obtains the version URL and other information about the Device Manager server 4 7 7 GetURLLink Obtains any or all of the Device Manager server URLLink objects 4 7 8 ModifyDebugLevel Sets the amount of debugging information created by the Device Manager server 4 7 9 Table 4 7 Replication Commands Command Name Description Storage Subsystems Section XP12000 XP10000 XP512 XP48 and XP1024 XP128 AddConfigFileForReplication Create the configuration Y Y 4 8 1 definition file for copy pairs AddReplication Creates copy pairs Y Y 4 8 2 DeleteR
22. DKC Cache Switch value 1 description Normal An instance of Component name DKC Environment value 1 description Normal An instance of Component name DKC Fan value 1 description Normal An instance of Component name DKC Power Supply value 1 description Normal An instance of Component name DKC Processor value 1 description Normal An instance of Component name DKC Shared Memory value 1 description Normal An instance of Component name DKU Drive value 1 description Normal An instance of Component name DKU Environment value 1 description Normal An instance of Component name DKU Fan value 1 description Normal An instance of Component name DKU Power Supply value 1 description Normal 4 3 12 4 GetStorageArray subtarget Filter GetStorageArray subtarget Filter obtains the information about a specific component of one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator e No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 22 GetStorageArray subtarget Filter Command Parameters WEE Eet Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter you will obtain information about the models of all storage subsystems serialnum Optional Serial number of the storage subsystem When you omit this parameter all th
23. Description Section AddLogicalGroup Creates a logical group 4 4 1 AddLunScan Scans a storage subsystem in a LUN that is not allocated to a logical 4 4 2 group AddObjectForLogicalGroup Adds one or more existing objects host storage domain or host toa 4 4 3 specified logical group in the Device Manager server DeleteLogicalGroup Deletes an existing logical group from the Device Manager server 4 4 4 DeleteObjectForLogicalGroup Deletes a specified object from the logical group 4 4 5 GetLogicalGroup Obtains information about a specified logical group or all logical 4 4 6 groups ModifyLogicalGroup Modifies one or more attributes of an existing logical group 4 4 7 Command Name Description Storage Subsystems Section XP12000 XP10000 XP512 XP48 and XP1024 XP128 AddLun Defines a path to a volume from Y Y 4 5 1 the host AddLunGroup Creates a LUN group Y 4 5 2 Command Line Interface Commands 22 Table 4 4 LUN Commands Command Name Description Storage Subsystems Section XP12000 XP10000 XP512 XP48 and XP1024 XP128 AddWWNForHostStorageDomain Sets the security of a LUN in the Y Y 4 5 3 host storage domain by assigning its WWN in the host storage domain AddWWNForLun Sets the security of a path by Y 4 5 4 assigning its WWN AddWWNForLunGroup Sets the security ofa LUN ina j Y 4 5 5 LUN group by assigning a WWYN in the LUN group AddWWNGroup Creates a WWN group
24. Interface Commands 21 Table 4 2 Storage Array Commands Command Name Description Storage Subsystems Section XP12000 XP10000 XP512 XP48 and XP1024 XP128 ModifyArrayReservation Extends the maximum period for Y Y 4 3 13 which a specified storage subsystem is locked ModifyLogicalUnit Modifies the settings of the logical Y Y 4 3 14 units and the corresponding LDEVs ModifyPort Modifies port attributes Y Y 4 3 15 ModifyPortController Modifies port controller attributes Y Y 4 3 16 RefreshStorageArrays Obtains the most recent status of all Y Y 4 3 17 storage subsystems managed by the Device Manager server NOTE You can use the subtarget parameter to specify the device information Available values are subtarget ArrayGroup see section 4 3 12 1 subtarget Commparameters see section 4 3 12 2 subtarget Component see section 4 3 12 3 subtarget Filter see section 4 3 12 4 subtarget FreeSpace see section 4 3 12 5 subtarget HostStorageDomain see section 4 3 12 6 subtarget LogicalUnit see section 4 3 12 8 subtarget Path see section 4 3 12 9 subtarget PDEV see section 4 3 12 10 subtarget Port see section 4 3 12 11 subtarget PortController see section 4 3 12 12 e e e e e e e subtarget LDEV see section 4 3 12 7 e e e e e e subtarget ReplicationInfo see section 4 3 12 13 Table 4 3 Logical Group Commands Table 4 4 LUN Commands Command Name
25. Local System Administrator Local Storage Administrator H No Guest Local Guest e Restricted to permitted resources Local System Administrator Local Storage Administrator Eg NOTE For the StorageWorks XP12000 XP10000 and XP1024 XP128 when AddLun adds a LUN whose domain ID is not 0 to the host storage domain the LUN security of the target port is automatically enabled Format for the StorageWorks XP12000 XP10000 and StorageWorks XP1024 XP128 hdvmcli URL AddLun port port number domain domain ID scsi SCSI ID lun valid LUN devnum device options serialnum serial number model model name name name number 1lusedevnums 1list of LDEV numbers Format for the StorageWorks XP512 XP48 hdvmcli URL AddLun port port number domain domain ID scsi SCSI ID lun valid LUN devnum device options serialnum serial number model model name name name number 1lusedevnums 1list of LDEV numbers NOTE Since the LUSE has already been created by the first AddLUN the error LDEV with ID LDEV HDS9970V 30117 263 is already in another LUSE has occurred in the second AddLUN with the same lusedevnums When setting up a LUN path to LU to which a LUSE is already set like the following command devnum of the representative LDEV which constitutes the LUSE must be specified and AddLUN must be run gt hdvmcli AddLun serialnum 30117 model XP128 name vailll port 3 domain 0
26. Name Status Description serialnum Required Serial number of the path s storage array model Required Model of the path s storage array port Required Port number of the path domain Required Domain ID of the path devnum Required Device number used to identify the path deletionoption Optional Only value possible lusekeep which is not case sensitive Omit this parameter to delete a LUSE Command execution example hdvmcli DeleteLun o D logs XP1024 DeleteLun log serialnum 10001 model XP1024 port 1 domain 1 devnum 1 deletionoption lusekeep Command execution result RESPONSE Command completed no data returned 4 5 8 DeleteLunGroup DeleteLunGroup deletes a LUN group assigned to a port XP512 XP48 subsystem only any LUNs paths in the group are not deleted see Table 4 53 A WWN can be specified and access is removed for just that WWN Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Eg NOTE DeleteLunGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 53 DeleteLunGroup Command Parameters Parameter Name Status Description serialnum Required Serial num
27. Optional Specific information about the logical unit path The value you can specify is WWN WWNGroup or Host Info When specifying this parameter you must also specify lusubinfo Path ldevsubinfo Optional Information about the LDEV The value you can specify is VolumeConnection When specifying this parameter you must also specify the lusubinfo LDEV Command execution example In this example the CLI command obtains information about the logical units in a storage subsystem serial number 10001 model XP12000 The information includes information about the paths to the logical units the LDEVs used in the logical units the WWNs of the path the WWN groups and the host hdvmcli GetStorageArray o D logs XP12000 GetStorageArray LogicalUnit log model XP12000 lusubinfo Path LDEV VolumeConnection subtarget LogicalUnit ldevsubinfo VolumeConnection lufilter all pathsubinfo wwn wwngroup hostinfo serialnum 10001 Command execution result RESPONSE Attributes List of 1752 An instance object ID devType path true chassis 1 An instance of StorageArray of StorageArray are omitted here Lu elements of LogicalUnit LU USP 10001 100 devNum 100 displayName 0 64 emulation OPEN 3 devCount 1 capacityInKB 2 403 360 commandDevice false commandDeviceSecurity false arrayGroup 16 raidType RAID5 3D 1P currentPortController 1 default
28. Storage Administrator H No Guest Local System Administrator Local Storage Administrator Local Guest Command Line Interface Commands 33 Table 4 15 DeleteLogicalUnit Command Parameters Parameter Name Status Description devnum Required Device number of the LU model Required Model of the storage array of the LU serialnum Required Serial number of the storage array of the LU Command execution example hdvmcli DeleteLogicalUnit o D logs XP12000 DeleteLogicalUnit log serialnum 10001 model XP12000 devnum 1 Command execution result RESPONSE Command completed empty list returned 4 3 9 DeleteLUSE DeleteLUSE deletes a LUSE without any path in the storage device see Table 4 16 Users with access to this command e Yes System Administrator Storage Administrator No Guest Local Guest Restricted to permitted LDEVSs only Local System Administrator Local Storage Administrator NOTE This function is not available for the StorageWorks XP512 XP48 Table 4 16 DeleteLogicalUnit Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array from which the LUSE is to be deleted model Required Model of the storage array from which the LUSE is to be deleted devnums Required Device number used to identify the LUSE to be deleted LUSE device number must be valid in the storage array Command execution exa
29. and directory names system output code and text typed at the command line A CAUTION Indicates that failure to follow directions could result in damage to equipment or data E IMPORTANT Provides clarifying information or specific instructions EA NOTE Provides additional information About this guide 7 HP technical support Telephone numbers for worldwide technical support are listed on the HP web site http www hp com support Collect the following information before calling Technical support registration number if applicable Product serial numbers Product model names and numbers Applicable error messages Operating system type and revision level Detailed specific questions For continuous quality improvement calls may be recorded or monitored HP strongly recommends that customers sign up online using the Subscriber s choice web site at http www hp com go e updates Subscribing to this service provides you with email updates on the latest product enhancements newest versions of drivers and firmware documentation updates as well as instant access to numerous other product resources After signing up you can quickly locate your products by selecting Business support and then Storage under Product Category HP authorized reseller For the name of your nearest HP authorized reseller In the United States call 1 800 345 1518 Elsewhere visit http www hp com and click Contact HP to fin
30. for detailed information on storage subsystem requirements Device Manager Server Please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Server Installation and Configuration Guide for more information on installing and configuring the Device Manager server Device Manager Agent Installation of the Device Manager agent is recommended however it is not required for Device Manager operations If installed the agent will display storage usage and file system statistics Please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Agent Installation Guide for more information Java execution environment e JRE Java Runtime Environment version 1 4 2_XX XX 06 or later e JWS Java Web Start version 1 4 2 XX XX 06 or later NOTE Make sure that you use the latest version of the above products NOTE JWS is automatically installed during installation of JRE Memory Requirements e HDVM_CLI MEM SIZE default value is 256MB This value is specified in bytes and must be a multiple of 1024 that is greater than 2MB Be sure to specify K for kilobytes and M for megabytes e Get commands such as GetStorageArray GetLogicalGroup and GetHost Info may require more memory due to command parameters assigned e If the Device Manager server is managing multiple subsystems you will need more Device Manager CLI memory Eg NOTE If the value of HDVM CLI MEM SIZE is less than what is requ
31. in the copy group For the primary volume P VOL specify LDEV 11 model number XP1024 and serial number 15001 The ID of the host that recognizes the primary volume is 5 the Continuous Access XP instance number is 15 and the port number is 50001 For the secondary volume S VOL specify LDEV 128 model number XP1024 and Command Line Interface Commands 104 serial number 35001 The host ID is 4 the Continuous Access XP instance number is 15 the port number is 50002 and the copy pace is 14 hdvmcli AddReplication o D logs XP1024 AddReplication log pvolhostid 5 pvolinstancenum 15 pvolportnum 50001 svolhostid 4 svolinstancenum 15 svolportnum 50002 pvolarraytype HDS9980V pvolserialnum 15001 pvoldevnum 11 svolarraytype HDS9970V svolserialnum 35001 svoldevnum 128 replicationfunction ContinuousAccess copytracksize 14 Command execution result 3 RESPONSE An instance of ReplicationGroup object ID REPGROUP 2 replicationGroupID 2 groupName HCMD CG0002 pvolHostID 5 pvolInstanceNumber 15 pvolPortNumber 50 001 svolHostID 4 svolInstanceNumber 15 svolPortNumber 50 002 replicationFunction ContinuousAccess fenceLevel Never copyTrackSize 14 List of 1 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 15001 11 35001 128 pairName HCMD CP0000 pvolSerialNumber 15001 pvolArrayType HDS9980V pvolDevNum 11 pvolObjectID LU HDS9980V 15001 11 pvolPoolID 1 svolSer
32. limitations NOTE A Local System Administrator and Local Storage Administrator can specify Host Info for a permitted host Table 4 69 ModifyHostInfo Command Parameters El Parameter Name Status Description objectid Required Object ID of the HostInfo record to be modified serialnum Optional New serial number of the path s storage array Omit this when no change is required model Optional New model of the path s storage array Omit this when no change is required hostname Optional New name of the host Omit this when no change is required ipaddress Optional New IP address of the host Omit this when no change is required mountpoint Optional New mount point on the host file system corresponding to the path Omit this when no change is required port Optional New port on the path Omit this when no change is required domain Optional New domain ID of the path Omit this when no change is required devnum Optional New device number of the path Omit this when no change is required portwwn Optional New port WWN on the host bus adapter Omit this when no change is required filetype Optional New type of the file System Omit this when no change is required filename Optional New name of the file System Omit this when no change is required size Optional New LUN size in MB Omit this when no change is required percentused Optional New percentage of the LUN in use Omit this when no change is requ
33. messages to be returned When you omit this limited by total count if omitted parameter the number of returned alerts is not limited timefilter Optional Request only messages newer than the date and time Required format is YYYY MM DD HH MM SS When you omit this parameter the number of returned alerts is not limited Command execution example hdvmcli GetAlerts o D logs GetAlerts log countfilter 2 timefilter 2002 04 01 00 00 00 Command execution result RESPONSE An instance of Alerts Contains 2Alert instances An instance of Alert number 2 type Server source ARRAY HDS9970V 35001 severity 3 component DKU drive description Serious error detected on DKU drive actionToTake Contact Customer Support data Component has stopped timeOfAlert 2003 01 06 20 13 56 An instance of Alert number 1 type Server source ARRAY HDS9970V 35001 severity 4 component DKC processor description Moderate error detected on DKC processor actionToTake Contact Customer Support data Component does not function fully timeOfAlert 2003 01 06 20 13 51 4 7 5 GetDebugLevel GetDebugLevel returns the current debug level setting of the Device Manager server The debug level affects the amount of information written to the trace log file There are no parameters Users with access to this command Yes System Administrator Storage Administrator No Guest Local Guest Restricted to permitte
34. nenet 62 Table 4 39 AddLogicalGroup Command Parametere 64 Table 4 40 AddLunScan Command Parameters rrrnnnnrrrnrrrrrannnnnrvnrrrrrrrnnnnnnnnnvrnnerrrsnnnnnnvnnnersrssnnnnnnnnssrsnnnnnnnrsnsssrn 65 Table 4 41 AddObjectForLogicalGroup Command Parameters rrrrrrrrrannnnvvrrnrrrrrsnnnnnrvnnrrrrrnnnnnrvrrnrvnnsrrrrsnnnnnvnnsenrn 66 Table 4 42 DeleteLogicalGroup Command Parameter 66 Table 4 43 DeleteObjectForLogicalGroup Command Parameters rrnrnnnrnnnnnnnrnnvnnnrnnnnnnnrnnnnnnrrnnnnnnnnrrnnnnenrrnnnnennnn 66 Table 4 44 GetLogicalGroup Command Parameters rrrrnrrrnrannnnnvvnnnrnrrrnnnnnrnnnnrvnerrrrrnnnnnvrnnssrrrnnnnnnvrnssssrsnnnnnnnnnsesnn 67 Table 4 45 ModifyLogicalGroup Command PDarameiers rennene 69 Table 4 46 AddLun Command Parameters rrrrrrrrrrannnnnvrrnrrrrrnnnnnnnnnnrrnnerrrrnnnnnnnnnnsrrrrnnnnnnnnnnssrrsnnnnnnnnsrssnsnnnnnnnnnsesnn 70 Table 4 47 AddLunGroup Command Parameters ccccseccceeeeeceeeeeeeeeeeeeeeeeeeseeaeeeeeceaeeeeseaeeesecaaeeesenueeeeseeeeeees 73 Table 4 48 AddWWNForHostStorageDomain Command Parameters nnnnnnnanneennnnieneeeeinteetnrnnrneeetntnnnrneeennrn nenne 74 Table 4 49 AddWWNForLun Command Parameters rrrrnnrrnrrannnrnrvvnnrrrrrnnnnnrrrnerrrrsnnnnnnnnnrvnnerrrrnnnnnnnrnnsrsrrsnnnnnnnnsesnn 75 Table 4 50 AddWWNForLunGroup Command Parameters esseeesseeessneeeetnesttrnenertnrnttrnnsrnrnsttnnnsnnnnnnnnnntnn nenne 76 Figures 5 Table 4 51 AddWWNGroup Command
35. numberOfControllers 1 capacityInGB 1 326 cacheInMB 7 168 sharedMemoryInMB 1 numberOfSpareDrives 1 freeCapacityInGB 701 allocatedCapacityInGB 624 autoLunCapacityInGB 0 onDemandCapacityInGB 0 totalFreeSpaceInGB 124 largest FreeSpaceInGB 63 capacityInKB 1 390 713 840 freeCapacityInKB 735 710 400 allocatedCapacityInKB 655 003 440 autoLunCapacityInKB 0 onDemandCapacityInKB 0 totalFreeSpaceInKB 130 084 560 largestFreeSpaceInKB 67 096 800 multipathSupport 1 securityStatus 1 sequenceNumber 10011 displayArrayFamily XP512 48 displayArrayType XP512 numberOfLUs 626 numberOfAllocatedLUs 210 numberOfUnallocatedLUs 416 slprStatus 1 openTotalCapacity 1 390 713 840 openAllocatedCapacity 655 003 440 openFreeCapacity 735 710 400 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAllocatedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 numberOfOpenAllocatedLUs 210 numberOfOpenUnallocatedLUs 416 numberOfImAllocatedLUs 0 numberOfImUnallocatedLUs 0 numberOfMfLDEVs 0 numberOfAllocatedM LDEVs 0 numberOfUnallocatedM LDEVs 0 product Code 1 List of 12 Component elements An instance of Component name DKC Battery value 1 description Normal An instance of Component name DKC Cache value 1 Command Line Interface Commands 40 description Normal An instance of Component name
36. please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide K IMPORTANT Make sure to read the Device Manager Release Notes Always make sure that only one Device Manager server at a time is actively managing a single subsystem Table 6 1 General Troubleshooting Information Problem Description and Recommended Action The CLI application does not run The error message says CAUSE The most likely problem is that there is no C Vhdvm gt hdvmeli help GetStorageArray java exe file in your path The name specified is not recognized as an SOLUTION Either update your path to include the directory internal or external command operable holding the java exe supplied by the Java JDK or JRE program or batch file software or edit the hdvmc1i bat file to specify the full path to your java exe file hdvmcli bat does not run The error message says CAUSE The HiCommandCLI jar file may have been C Vhdvm gt hdvmeli help GetStorageArray moved or renamed Exception in thread main SOLUTION Make sure that the Hi CommandCLI jar file Java lang NoClassDefFoundError has not been moved or renamed and that you are executing com hitachi hds cli Hicmd from the directory where the hdvmcli bat and HiCommandCL1 jar files reside Troubleshooting 116 Acronyms and Abbreviations AL API ASL CLI DAMP DMP DKC FC GB GUI HTML HTTP HTTPS HBA JRE KB
37. returned 4 5 10 Delete WWNForHostStorageDomain DeleteWWNForHostStorageDomain removes security for LUNs that are under a specified HostStorageDomain The HostStorageDomain must already exist and be secured see Table 4 55 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 55 DeleteWWNForHostStorageDomain Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array for the Host Storage Domain model Required Model of the storage array for the Host Storage Domain port Required Port ID of the Host Storage Domain domain Required Domain ID of the Host Storage Domain wwn Required Comma separated list of WWN to unsecure the Host Storage Domain Command execution example hdvmcli DeleteWWNForHostStorageDomain o D logs XP1024 DeleteWWNForHostStorageDomain log serialnum 10001 model XP1024 port 1 domain 1 wwn A AA AA AA AA AA AA AA Command Line Interface Commands 79 4 5 11 Command execution result RESPONSE Command completed no data returned DeleteWWNForLun DeleteWWNForLun removes access to a WWN path see Table 4 56 NOTE This command
38. scsi 15 lun 10 devnum 263 Table 4 46 AddLun Command Parameters Parameter Name Status Description serialnum Required Serial number of the new path s storage array model Required Model of the new path s storage array name Optional Name of the new path port Required Port number of the new path domain Required XP12000 XP10000 Domain ID of the new path Cannot be set when using the wwn and XP1024 XP128 parameter Optional XP512 XP48 scsi Optional SCSI ID of the new path lun Required Actual LUN used for new path devnum Optional Device number used to identify the new path not provided when a LUSE is defined lusedevnums Optional Comma separated list of LDEV numbers to create a LUSE for the see Note path Either devnum or lusedevnums must be specified but not both wwn Optional XP512 XP48 Comma separated list of WVWN to secure the path Cannot be set when using domain parameter This parameter is not valid for the StorageWorks XP12000 XP10000 or StorageWorks XP1024 XP128 NOTE The LUSE is created using the LDEVs of the specified device numbers The new LUSE is created using only those LDEVs that have the same emulation sizelnKB and raidType attributes Command execution example 1 serialnum 10001 model XP512 name liu wwn AA AA AA AA AA AA AA AA hdvmcli AddLun o D logs XP512 AddLun log scsi 15 lun 127 lusedevnums 127 128 port 3 Command execution result 1
39. storage subsystems Cont inuousAccessExtension replicationfunction Optional fencelevel Optional Specify the P VOL fence level as follows default Never The fence level is ignored for Business Copy XP Continuous Access XP Extension and Snapshot XP Never If you specify Never a host write request to P VOL will not be rejected even though the MCU was able to change the status of a S VOL pair into the suspend status Data If you specify Data a host write request to P VOL will be rejected when an update copy fails Status If you specify Status StorageWorks XP Disk Array a host write request to P VOL will be rejected only when the MCU cannot change the status of a S VOL pair to the suspend status Specify a copy pace number of tracks copied at one time during initial copy as an integer between 1 and 15 The default value is 3 for the StorageWorks XP Disk Array This parameter cannot be specified when Snapshot XP is being used ee copytracksize Optional Table 4 79 GetHost Command Display and AddReplication Command Parameters Location of Value Displayed by the GetHost Item Name Corresponding Parameter Command ReplicationGroup replicationGroupID replicationgroupid pvolHostID pvolhostid pvollnstanceNumber pvolinstancenum pvolPortNumber pvolportnum svolHostID svolhostid svollnstanceNumber svolinstancenum svolPortNumber svolportnum ReplicationInfo pvolSeri
40. subtarget FreeSpace obtains the information about the free space in one or all array groups in one or all storage subsystems Users with access to this command Yes System Administrator Storage Administrator e No None H Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 23 GetStorageArray subtarget FreeSpace Command Parameters Model of the storage subsystem When you omit this parameter all the storage subsystems become the target Command Line Interface Commands 42 Table 4 23 GetStorageArray subtarget FreeSpace Command Parameters Parameter Name Status Description serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify FreeSpace array groups arraygroupobjid Optional Object ID of an array group that has free space When you omit this parameter the command displays the information about all the storage Command execution example 1 In this example the CLI command obtains information about all the free space in a storage subsystem serial number 14010 model XP12000 subtarget FreeSpace model XP12000 serialnum 14010 hdvmcli GetStorageArray o D logs XP12000 GetStorageArray FreeSpace log Command execution result 1 RESPONSE An instance of StorageArray Attributes of StorageArray are omi
41. the storage subsystem information in the Device Manager server database is up to date E NOTE To update one storage subsystem use the AddStorageArray command Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest Table 4 38 RefreshStorageArrays Command Parameters Command Line Interface Commands 62 Table 4 38 RefreshStorageArrays Command Parameters Parameter Name Status Description interval Optional Interval time in minutes from storage subsystem recovery completion to start of next storage subsystem recovery You can specify a value from 0 to 2147483647 If it is not set the default interval time is 0 NOTE An error is generated if you specify a negative number or if you include the plus sign This command is designed to refresh configuration data for all discovered storage arrays managed by Device Manager Any storage array reconfigurations made by tools other than Device Manager e g Remote Web Console will be reflected in the Device Manager Configuration database If storage arrays are managed by Device Manager and other tools you should schedule RefreshStorageArray periodically so that the Device Manager Configuration database is kept current Command execution example hdvmcli RefreshStorageArrays o D logs RefreshStorageArrays log interval 1 Command execut
42. using method 2 or 3 specify the ID of the host that recognizes the primary volume P VOL NOTE Ifthe replicationgroupid parameter is specified this parameter is ignored pvolinstancenum Required Method 2 Specify the number of the Continuous Access XP instance that manages P VOL NOTE Ifthe replicationgroupid parameter is specified this parameter is ignored pvolportnum Required Method 3 If you are using method 3 specify the port number of the Continuous Access XP instance that manages P VOL In Solaris specify an integer from 0 to 65535 In ALX Windows HP UX and Linux specify an integer from 1 to 65535 NOTE If the replicationgroupid or pvolinstancenum parameter is specified this parameter is ignored svolhostid Required Method 2 or 3 If you are using method 2 or 3 specify the ID of the host that recognizes the secondary volume S VOL NOTE Ifthe replicationgroupid parameter is specified this parameter is ignored svolinstancenum Required Method 2 Specify the number of the Continuous Access XP instance that manages S VOL NOTE Ifthe replicationgroupid parameter is specified this parameter is ignored svolportnum Required Method 3 If you are using method 3 specify the port number of the Continuous Access XP instance that manages S VOL In Solaris specify an integer from 0 to 65535 In AIX Windows HP UX and Linux specify an integer fr
43. you launch Device Manager CLI without specifying any command line options command arguments are displayed 2 3 Using CLI with HTTPS To implement Device Manager CLI while running HTTPS on the Device Manager server 1 Eg Download the Hi CommandCerts file from the Device Manager server from the following URL http lt device manager server gt lt port id gt service HiCommandCerts NOTE lt device manager server gt indicates the server s IP address or host name Store the downloaded file in the Device Manager CLI installation directory The installation directory contains the hdvmeli bat file NOTE Use the filename HiCommandCerts Set the path name of the Hi CommandCerts file in the HDVM CLI CERTS PATH environment variable e In Windows lt device manager cli installation folder gt HiCommandCerts Execute the desired command For example type as shown below to execute the Get ServerInfo command e In Windows hdvmcli s https lt device manager server gt 2443 service GetServerInfo NOTE Observe the following guidelines e Use the https protocol for the Device Manager server URL e Use the https port for the Device Manager server URL 2443 unless configured differently in the server s configuration file e Use the s or secure switch Setting Up Command Line Interface 13 3 Command Line Interface Syntax and Parameters This chapter describes the command syntax and command parameters
44. 0 00 00 00 01 nickname Jane An instance of WWN WWN 00 00 00 00 00 00 00 50 nickname Jone List of 1 LUNGroup elements An instance of LUNGroup object ID LUNGroup HDS9960 10001 0 0 hp name hp nickname hp repeated for other Port instances 4 3 12 12 GetStorageArray subtarget PortController GetStorageArray subtarget PortController obtains the information about a port controller in one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 30 GetStorageArray subtarget PortController Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify PortController controllernum Optional Controller ID of the port controller in the subsystem When you omit this parameter you will obtain information about all the port controllers controllersubinfo Optional Specific information about the port controller you intend to obtain Available values are IPAddress and PairedPortController You can specify either one or both of these values
45. 000 serialnum 14009 Command execution result An instance of ArrayReservation object ID ARRAYRESERVATION USP 14009 target ARRAY USP 14009 loginID dmuser beginTime 1 039 003 476 4 3 14 ModifyLogicalUnit Modi fyLogicalUnit modifies the LU and its corresponding LDEV in a storage device see Table 4 33 Users with access to this command Yes System Administrator Storage Administrator e No Guest Local System Administrator Local Storage Administrator Local Guest Format for the StorageWorks XP12000 XP10000 and StorageWorks XP1024 XP128 hdvmcli URL ModifyLogicalUnit option serialnum serial number model model devnum device number commanddevice true false commanddevicesecurity true false Format for the StorageWorks XP512 XP48 hdvmcli URL ModifyLogicalUnit option serialnum serial number model model devnum device number commanddevice true false commanddevicesecurity true false Command Line Interface Commands 57 E NOTE If you are using a StorageWorks XP512 XP48 check that at least one path is set for the logical unit that is subject to this commande processing E NOTE For the StorageWorks XP512 XP48 make sure that one or more paths have been set to the logical unit to which the command executes If specifying the commanddevicesecurity parameter use it with the commanddevice parameter EA NOTE For the StorageWorks XP12000 XP10000 and XP1024 XP128 specify at lea
46. 1 7 0 99 devNum 99 portID 7 domainID 0 sesiID 15 LUN 99 wwnSecurityValidity true List of 2 WWN elements An instance of WWN WWN 88 77 77 77 77 77 00 01 nickname Jane An instance of WWN WWN 88 77 77 77 77 77 00 02 nickname Jone 4 3 12 10 GetStorageArray subtarget PDEV GetStorageArray subtarget PDEV obtains the information about a PDEV in one or all storage subsystems Users with access to this command No None Guest Yes System Administrator Storage Administrator Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Table 4 28 GetStorageArray subtarget PDEV Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify PDEV Command Line Interface Commands 51 Table 4 28 GetStorageArray subtarget PDEV Command Parameters Parameter Name Status Description arraygroupobjid Optional Object ID of the array group containing the PDEVs to be returned If you intend to obtain the information about the PDEVs in all the array groups specify ALL pdevid Optional The right most value of the object ID of the PDEV to be returned Among the four element
47. 10 Table 6 1 General Troubleshooting Information 116 Tables 6 About this guide This document describes and provides instructions for using the Command Line Interface CLI software for HP StorageWorks Command View XP Advanced Edition Device Manager Intended audience This document assumes that the user D Has a background in data processing and understands peripheral storage device subsystems and their basic functions e Is familiar with the operating system which hosts the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client software Prerequisites Prerequisites for installing this product include H Reading through the user s guide Meeting all the minimum installation requirements Reviewing the Release Notes on the CD for any last minute announcements Document conventions and symbols Table 1 Document conventions Convention Element Convention Element Medium blue text Figure 1 Cross reference links and e mail addresses Medium blue underlined text Web site addresses http www hp com Bold font e Key names e Text typed into a GUI element such as into a box e GUI elements that are clicked or selected such as menu and list italics font Text emphasis Monospace font e File and directory names e System output e Code e Text typed at the command line Monospace italic font e Code variables e Command line variables Monospace bold font Emphasis of file
48. 10 in the storage subsystem with serial number 35001 and for the RCU with SSID 65534 in the storage subsystem with serial number 15001 hdvmcli GetReplicationControllerPair o D logs XP128 GetReplicationControllerPair log masterserialnum 35001 mastercontrollerid 10 remoteserialnum 15001 remotessid 65534 Command execution result 1 RESPONSE An instance of ReplicationControllerPair object ID REPCTLPAIR 35001 10 15001 65534 masterArrayType HDS9970V masterSerialNumber 35001 masterControllerID 10 masterStartDevNum 0 masterEndDevNum 255 remoteArrayType HDS9980V remoteSerialNumber 15001 remoteSSID 65534 remoteControllerID 15 remoteStartDevNum 0 remoteEndDevNum 255 Command execution example 2 This example obtains the controller pair information in all storage subsystems that have been registered in the Device Manager database hdvmcli GetReplicationControllerPair o D logs XP128 GetReplicationControllerPair log Command execution result 2 RESPONSE An instance of ReplicationControllerPair object ID REPCTLPAIR 35001 10 15001 65534 masterArrayType HDS9970V masterSerialNumber 35001 masterControllerID 10 masterStartDevNum 0 masterEndDevNum 255 Command Line Interface Commands 107 remoteArrayType HDS9980V remoteSerialNumber 15001 remoteSSID 65534 remoteControllerID 15 remoteStartDevNum 0 remoteEndDevNum 255 4 8 5 ModifyReplication ModifyReplication changes a cop
49. 1inkedid parameter with the objectid parameter Command execution example 1 hdvmcli GetURLLink o D logs XP1024 GetURLLink log objectid URLLINK HSDOMAIN HDS9980V 10001 0 3 1 Command execution result 1 RESPONSE An instance of URLLink object ID URLLINK HSDOMAIN HDS9980V 10001 0 3 1 name AUTO url 192 168 99 AA description ARRAY HDS9980V 10001 linkedID HSDOMAIN HDS9980V 10001 0 3 Command execution example 2 hdvmcli GetURLLink o D logs XP1024 GetURLLink log linkedid HSDOMAIN HDS9980V 10001 0 3 Command execution result 2 RESPONSE An instance of URLLink object ID URLLINK HSDOMAIN HDS9980V 10001 0 3 1 name AUTO url 192 168 99 AA description ARRAY HDS9980V 10001 linkedID HSDOMAIN HDS9980V 10001 0 3 4 7 9 ModifyDebugLevel ModifyDebugLevel sets the amount of debugging information generated by the Device Manager server see Table 4 76 The debug level can range from 0 to 4 0 Full Debugging trace 1 Basic Information 2 Warning 3 Error 4 Fatal Modifying the debug level affects the amount of information written to the trace log file subsequent to the change The command does not affect the Device Manager server configuration files so any debug level modifications via this command does not affect the debug level when the server is restarted Users with access to this command Yes System Administrator Storage Administrator No Guest Local Guest
50. CLI with no associated parameters This basic information will include the current CLI version e In Windows c Vhdvm gt hdvmcli e In Solaris or HP UX hdvmcli Command Line Interface Syntax and Parameters 15 Figure 3 2 displays sample help information including the CLI version Device Manager CLI version 1 1 0 00 USAGE hdvmcli server url server command options parameters AVAILABLE COMMANDS AddStorageArray GetStorageArray DeleteStorageArray AddLunScan AddLogicalGroup DeleteLogicalGroup ModifyLogicalGroup GetLogicalGroup AddObjectForLogicalGroup DeleteObject ForLogicalGroup AddLunGroup ModifyLunGroup AddWWNForLUNGroup DeleteWWNForLUNGroup AddWWNGroup ModifyWWNGroup DeleteLunGroup AddLun DeleteLun AddHost StorageDomain DeleteHostStorageDomain AddWWNForLun DeleteWWNForLun AddWWNForHost StorageDomain DeleteWWNForHostStorageDomain DeleteWwn DeleteWwnGroup AddHost DeleteHost ModifyHost GetHost AddHostRefresh AddHostInfo DeleteHostInfo ModifyHostInfo GetHostInfo GetServerInfo GetLogFile ModifyDebugLevel GetDebugLevel GetAlerts DeleteAlerts AddArrayGroup DeleteArrayGroup AddLogicalUnit DeleteLogicalUnit ModifyLogicalUnit AddSpareDrive DeleteSpareDrive ModifyPort ModifyPortController AddURLLink DeleteURLLink Get URLLink RefreshStorageArrays AddLUSE Command Line Interface Syntax and Parameters 16 Figure 3 2 CLI Help continues on
51. Command Line Values Syntax section 3 1 CLI Return Responses section 3 2 Displaying CLI Help section 3 3 Guidelines for Executing CLI Commands section 3 4 3 1 Command Line Syntax Device Manager CLI only supports ASCII characters The general format for the command line values is C hdvmcli server location command options parameters e Server location indicates the complete URL of the Device Manager server e g http localhost 2001 service This includes the service address unless the server has been configured with a non standard servlet alias If you use a property file you can omit the URL For details about how to specify the URL see section 5 3 3 e Commands make processing requests to the server e g Get StorageArray or AddLogicalGroup These are not required when reading the request from an XML file e Options control the behavior of Device Manager CLI application Each option has a single character and an alternate word representation A single character will have a single dash as a prefix A word will have two dashes as a prefix Most options require a following argument See Table 3 1 for a list and description of Device Manager CLI options Specifying an option in the properties file enables you to omit the option when you execute the command For details about how to specify options see section 5 1 e Parameters are passed to the server as part of a request Depending on the command some are requir
52. Guest Local System Administrator Local Storage Administrator Local Guest Table 4 29 GetStorageArray subtarget Port Command Parameters EH Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target Command Line Interface Commands 52 Table 4 29 GetStorageArray subtarget Port Command Parameters Parameter Name Status Description subtarget Required Specify Port port Optional Number of the port of the storage subsystem When you omit this parameter you will obtain information about all the ports portsubinfo Optional Specific information about the ports The value you can specify is WWN WWNGroup LUNGroup or HostStorageDomain wwngroupsubinfo Optional Information obtained from a WWN group Specify WWNGroup in the parameter portsubinfo when using this parameter The value you can specify is WWN only lungroupsubinfo Optional Information obtained from a LUN group Specify LUNGroup in the parameter portsubinfo when using this parameter The value you can specify is Path only pathsubinfo Optional Information obtained from paths of a LUN group Specify Path in the parameter lungroupsubinfo when using this parameter The value you can specify is WWN or WWNGro
53. HP StorageWorks Command View XP Advanced Edition Device Manager CLI User Guide Part number T1780 96011 Second edition October 2005 Legal notices Copyright 2005 Hewlett Packard Development Company L P Hewlett Packard Company makes no warranty of any kind with regard to this material including but not limited to the implied warranties of merchantability and fitness for a particular purpose Hewlett Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing performance or use of this material This document contains proprietary information which is protected by copyright No part of this document may be photocopied reproduced or translated into another language without the prior written consent of Hewlett Packard The information is provided as is without warranty of any kind and is subject to change without notice The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services Nothing herein should be construed as constituting an additional warranty HP shall not be liable for technical or editorial errors or omissions contained herein Emulex is a registered trademark of Emulex Corporation in the United States and other countries AIX and IBM are registered trademarks of International Business Machines Corporation Linux is a registered trademark of Linus Torvalds Microso
54. LUN security is automatically enabled NOTE This command supports only the StorageWorks XP512 XP48 subsystems Table 4 49 AddWWNForLun Command Parameters Parameter Name Status Description serialnum Required Serial number of the port s storage array model Required Model of the port s storage array port Required Port number domain Required Domain ID of the path devnum Required Device number used to identify the path wwn Required Comma separated list of WWNs to secure the path Command execution example hdvmcli AddWwnForLun o D logs XP512 AddWwnForLun log serialnum 10001 model XP512 port 16 devnum 16 domain 0 wwn AA AA AA AA AA AA AA AA Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Path elements Command Line Interface Commands 75 An instance of Path object ID PATH HDS9960 10001 16 0 16 devNum 16 portID 16 domainID 0 scsiID 15 LUN 16 wwnSecurityValidity true List of 1 WWN elements An instance of WWN WWN AA AA AA AA AA AA AA AA nickname Jane 4 5 5 Add WWNForLunGroup AddWWNForLunGroup secures a LUN group by assigning one or more WWN s to it XP512 XP48 subsystem only see Table 4 50 If all of the WWNs in a WWN group are assigned the WWN group is used to secure the LUN group If no WWN in a WWN group is assigned this command will fail Only
55. Local System Administrator Local Storage Administrator Table 4 76 ModifyDebugLevel Command Parameters level Required New debug level number between 0 and 4 0 Full Debugging trace 1 Basic Information 2 Warning 3 Error 4 Fatal Command execution example hdvmcli ModifyDebugLevel o D logs ModifyDebugLevel log level 0 Command execution result RESPONSE Command Line Interface Commands 97 An instance of DebugLevel value 0 Full Debugging trace description Debugging Trace 4 8 Replication Commands Replication commands provide management support for the Device Manager server 4 8 1 AddConfigFileForReplication AddConfigFileForReplication creates the Continuous Access XP configuration definition file for RAID Manager that is required to create copy pairs for Business Copy XP Continuous Access XP Continuous Access XP Extension and Snapshot XP Users with access to this command e Yes System Administrator Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Eg NOTE Continuous Access XP Extension can be used for StorageWorks XP Disk Array Snapshot XP can be used for StorageWorks XP 12000 XP 10000 Table 4 77 AddConfigFileForReplication Command Parameters Parameter Name Status Description groupname Required Method 1 Group name used in th
56. Manager consists of the following basic components e Command Line Interface CLI Device Manager CLI enables you to perform client operations by issuing commands from the system command line prompt Server The Device Manager server communicates with StorageWorks XP Disk Array storage subsystems In addition the Device Manager server manages client connections with Device Manager Web Client and the Device Manager agent s using the http protocol The Device Manager agent and the Device Manager server can be installed on the same host machine For more information about the Device Manager server please refer to the HP StorageWorks XP Advanced Edition Device Manager Server Installation and Configuration Guide Web Client Device Manager Web Client is a web based user interface for monitoring and managing StorageWorks XP Disk Array storage subsystems Web Client is a stand alone Java based application that is deployed using the Java Web Start JWS software It communicates with and runs as a client of Command View XP Advanced Edition Device Manager Overview 10 the Device Manager server For further information on Device Manager Web Client please refer to the HP StorageWorks XP Advanced Edition Device Manager Web Client User Guide Agent The Device Manager agents run on host computers attached to StorageWorks XP Disk Array storage subsystems under management by Device Manager The Agent on a host collects data on the configuratio
57. Parametere 77 Table 4 52 DeleteLun Command Parameters 2 ccccccccceceeeeeeeeeeeeeeeeeeneeeeceaaeeeecaeeesecaeeseseeeeeseceeeeeenueeeeseeaeeees 78 Table 4 53 DeleteLunGroup Command Parameters ssssessseeesenteesrtrnetnrtsttntntttnrnttrnnttnnnstntnnttnnnnnnnnsnnn nnn en nnee 78 Table 4 54 DeleteWWN Command Parameters c cccceeeeeeeeeeeeeeeeeeeeeececeaeeeeeeeneeeeecaaeeeeeeeeeeseeseeeesisaeeeesenaeeees 79 Table 4 55 DeleteWWNForHostStorageDomain Command Parameter 79 Table 4 56 DeleteWWNForLun Command Parameters 2 ccccecccceeeeceeeeeeceeeeeeeeeaceeeeeaeeeeecaeeesenaeeeeseeeeteseeeeeees 80 Table 4 57 DeleteWWNForLunGroup Command Parameter 80 Table 4 58 DeleteWWNGroup Command Parameters esssssessseeessereettretttnesttrntrtnrnttntnnnttnrnnttnrnsrnnnnnn nennen nenne 81 Table 4 59 ModifyLunGroup Command Parameter 82 Table 4 60 ModifyWWNGroup Command Parameters cccceecceeeeeeceeeeeeceeeeeeeeaeeeeeeceeeeeeeeeeeseseeeesesaeeeeeeneeeees 83 Table 4 61 AddHost Command Parameters nn nnenrnnnnnnnrnnnnnrrnnnnnnrnnnnnenrnnnnnrn rn nnnenrnnnnnnnnnn 84 Table 4 62 AddHostlnfo Command Parametere 84 Table 4 63 AddHostRefresh Command Parameter 86 Table 4 64 DeleteHost Command Parameiers nenna nn Ennen Ennen 86 Table 4 65 DeleteHostinfo Command Parameters nn nnnrrnnnnnnrnnnnnnnrnnnnnnrrnnnnenrnnnnnnnnnn 87 Table 4 66 GetHost Command Parameters rn nnnenrnnnnnnnnnn 87 Table 4 67 GetHostinfo Command Par
58. PortController 1 Command Line Interface Commands 48 isComposite 0 cont inuousAccessVolumeType Simplex businessCopyVolumeType Simplex snapshot VolumeType Simplex journalVolumeType Simplex sysVolFlag 0 externalVolume 1 differentialManagement 0 List of 3 Path elements An instance of Path Attributes of Path are omitted here An instance of Path Attributes of Path are omitted here List of 2 WWN elements An instance of WWN WWN 88 77 77 77 77 77 00 01 nickname Jane An instance of WWN WWN 88 77 77 77 77 77 3F 04 nickname Jone repeated for other Path instances List of 1 Ldev elements An instance of LDEV object ID LDEV USP 10001 100 devNum 100 displayName 0 64 emulation OPEN 3 cylinders 0 isComposite 0 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 1 arrayGroup 16 path true onDemandDevice false devType isStandardLDEV true guardMode substance 1 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 List of 1 VolumeConnection elements An instance of VolumeConnection objectid VOLCONN USP 10001 0 mappedArrayType USP mappedSerialNumber 10001 mappedDevNum 100 externalArrayType HDS9960 externalSerialNumber 10002 externalDevNum 150 externalVolumeName 0096 productName 1024 Command Line Interface Commands 49 vendor HP repeated for other VolumeConnection instances 4 3 12 9 GetStora
59. S9980V pvolserialnum 65010001 pvoldevnum 5 svolarraytype HDS9980V svolserialnum 65010012 svoldevnum 10 replicationfunction ContinuousAccess fencelevel Data Command execution result 1 RESPONSE An instance of ReplicationGroup object ID REPGROUP 0 replicationGroupID 0 groupName HCMD CG0003 pvolHostID 1 pvolInstanceNumber 11 pvolPortNumber 50 001 svolHostID 1 svolInstanceNumber 12 svolPortNumber 50 002 replicationFunction ContinuousAccess fenceLevel Data copyTrackSize 15 List of 1 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 65010001 5 0012 10 pairName HCMD CP0004 pvolSerialNumber 6501001 pvolArrayType HDS9980V pvolDevNum 5 pvolObjectID LU HDS9980V 65010001 5 pvolPoolID 1 svolSerialNumber 65010012 svolArrayType HDS9980V svolDevNum 10 svolObjectID LU HDS9980V 65010012 10 svolPoolID 1 fenceLevel Data replicationFunction ContinuousAccess status 1 muNumber 1 copyTrackSize 15 splitTime 1 The second method is to create a copy group in the RAID Manager configuration definition file and adds a copy pair to the copy group by using the following command hdvmcli URL AddReplication option groupname group name pvolhostid host ID pvolinstancenum instance number pvolportnum port number svolhostid host ID svolinstancenum instance number svolportnum port number pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolp
60. System Administrator and Local Storage Administrator do not have access range limitations NOTE DeleteWWNForLunGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 57 DeleteWWNForLunGroup Command Parameters Parameter Name _ Status Description serialnum Required Serial number of the storage array in which the LUN group exists model Required Model of the storage array in which the LUN group exists port Required Port number of the LUN group objectid Required Object ID of the LUN group Command Line Interface Commands 80 Table 4 57 DeleteWWNForLunGroup Command Parameters Comma separated list of WWNs that exist in the LUN group Command execution example hdvmcli DeleteWWNForLunGroup o D logs XP512 DeleteWWNForLUNGroup log serialnum 10001 model XP512 port 19 objectid LUNGROUP HDS9960 10001 19 hp wwn 11 55 77 99 33 00 22 66 AA AA AA AA AA AA AA AA Command execution result RESPONSE Command completed no data returned 4 5 13 Delete WWNGroup DeleteWWNGroup removes a WWN group from a port XP512 XP48 subsystem only see Table 4 58 The corresponding WWNs are not removed from the port Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and L
61. V 65010001 11 pvolPoolID 1 svolSerialNumber 65010001 svolArrayType HDS9570V svolDevNum 12 svolObjectID LU HDS9570V 65010001 12 svolPoolID 1 replicationFunction BusinessCopy status 8 muNumber 0 copyTrackSize 15 splitTime 1 An instance of ReplicationInfo object ID REPINFO 65010001 1012 65010001 102 pairName HCMD_CP0002 pvolSerialNumber 65010001 pvolArrayType HDS9570V pvolDevNum 101 pvolObjectID LU HDS9570V 65010001 101 pvolPoolID 1 svolArrayType HDS9570V svolSerialNumber 65010001 svolDevNum 102 svolObjectID LU HDS9570V 65010001 102 svolPoolID 1 replicationFunction BusinessCopy status 1 muNumber 0 Command Line Interface Commands 89 copyTrackSize 15 splitTime 1 4 6 7 GetHostinfo GetHostInfo returns either a selected Host Info record or all the Host Info on the Device Manager server see Table 4 67 The name of the host that does not have access privileges is displayed as n a Table 4 67 GetHostinfo Command Parameters Optional Object ID of the Hostinfo record to be retrieved Omit this parameter to return all HostInfo records E NOTE If you do not know the object ID of the required Host Info record you can obtain information about all the Host Info records by executing the GetHost Info command Command execution example 1 hdvmcli GetHostInfo o D logs XP1024 GetHostInfo log objectid HOSTINFO MY HOSTINFO XP1024 0 15 1 Command execution result 1 RESPONSE
62. XP10000 and XP1024 XP128 required only at and XP1024 XP128 the initial identification only If you are refreshing information you can omit this parameter if the user password was not changed displayfamily Optional Display array family of the target array This parameter is required at the initial identification Obtain the values available for this parameter from the execution result of the GetServerInfo command In the execution result of this command a combination of the arrayFamily and displayArrayFamily values appears For the StorageWorks XP Disk Array use the displayArrayFamily value to specify the family and displayfamily parameters family Required Array family of the target array ipaddress Required Array IP address searchcommunity Optional SNMP Community string used for identifying device elements via SNMP XP512 XP48 only StorageWorks XP512 XP48 array Default is public userid Optional User ID for array access XP12000 XP10000 For StorageWorks XP12000 XP10000 and StorageWorks XP1024 XP128 and XP1024 XP128 required only at the initial identification only When refreshing information you can omit this parameter if the user ID was not changed Command execution example In this example the CLI command accesses and detects the storage subsystems in an array family family xP1024 128 IP address 172 16 45 1 The command specifies the user ID root and the user password hdvm
63. XP1024 serialNumber 10001 arrayType HDS9980V ipAddress 172 16 64 159 mountPoint C portID 7 domainID 0 sesiID 15 lun 2 devNum 2 osScsiBus 0 osScsiID 15 osLun 1 portWWN 11 22 33 44 55 66 77 88 fileSystemType NTFS fileSystemName C sizeInMB 10 percentUsed 10 lastUpdated 1039003476 4 6 3 AddHostRefresh AddHostRefresh refreshes the information about the hosts that Device Manager manages which is obtained from the Device Manager agent Users with access to this command Command Line Interface Commands 85 Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest e Restricted to permitted resources Local System Administrator Local Storage Administrator Table 4 63 AddHostRefresh Command Parameter Specify the object ID of the target host In this example the CLI command obtains the latest information about the host where an object ID is HOST 5 Command execution example hdvmcli AddHostRefresh o D logs AddHostRefresh log objectid HOST 5 Command execution result RESPONSE An instance of Host object ID Host 5 name rise ipAddress 192 168 32 164 capacityInKB 0 hostType 1 4 6 4 DeleteHost E DeleteHost deletes information about a host server from the Device Manager server see Table 4 64 NOTE DeleteHost does not delete the host information from the External port Users with access to
64. ace Commands 37 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 repeated for other ArrayGroup instances Command execution example 2 In this example the CLI command obtains information only about one array group object ID ARRAYGROUP HDS9980V 10001 1 0 in a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray ArrayGroup log subtarget ArrayGroup model XP1024 serialnum 10001 object ID ARRAYGROUP HDS9980V 10001 1 0 Command execution result 2 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 ArrayGroup elements An instance of ArrayGroup object ID ARRAYGROUP HDS9980V 10001 1 0 chassis 1 number 0 displayName 1 1 1 raidType RAID5 3D 1P emulation OPEN 3 diskType DKR2D J072FC diskSize 72 diskSizeInKB 149 225 472 controllerID 1 totalCapacity 203 925 600 allocatedCapacity 203 925 600 freeCapacity 0 autoLunCapacity 0 onDemandCapacity 0 totalFreeSpace 9 126 144 largestFreeSpace 9 126 144 substance 0 slprNumber 1 clprNumber 1 openTotalCapacity 203 925 600 openAllocatedCapacity 203 925 600 openFreeCapacity 0 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAllocatedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 4 3 12 2 GetStor
65. ageArray subtarget Commparameters GetStorageArray subtarget Commparameters obtains information about how to access one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator D No None Command Line Interface Commands 38 Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 20 GetStorageArray subtarget Commparameters Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter you will obtain information about the models of all storage subsystems serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify Commparameters Command execution example In this example the CLI command obtains information about how to access a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray CommParameters log subtarget CommParameters model XP1024 serialnum 10001 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 CommParameters elements An instance of CommParameters userID root userPassword hdvm ipAddress 172 16 45 1 4 3 12 3 GetStorageArray subtarget Component
66. alNumber pvolserialnum pvolArrayType pvolarraytype pvolDevNum pvoldevnum svolArrayType svolarraytype svolSerialNumber svolserialnum svolDevNum svoldevnum copyTrackSize copytracksize EE You can create a copy pair in one of three ways The first method is adding a copy pair to an existing copy group that is specified in the RAID Manager configuration definition file by using the following command Command Line Interface Commands 102 hdvmcli URL AddReplication option replicationgroupid copy group number pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolportid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction BusinessCopy Cont inuousAccess ContinuousAccessExtension Sna pshot fencelevel fence level copytracksize copy pace Command execution example 1 This example creates a copy pair for Continuous Access XP in an existing copy group Create a copy pair in the copy group with copy group number 0 As the primary volume P VOL specify the logical device with LDEV number 5 in the storage subsystem with model number XP1024 and serial number 65010001 As the secondary volume S VOL specify the logical device with LDEV number 10 in the storage subsystem with model number XP1024 and serial number 65010012 hdvmcli AddReplication o D logs XP1024 AddReplication log replicationgroupid 0 pvolarraytype HD
67. alerts to be deleted using either the alert number or the source Users with access to this command Yes System Administrator Storage Administrator e No Guest Local Guest Local System Administrator Local Storage Administrator Table 4 71 DeleteAlerts Command Parameters Parameter Name Status Description alertnum Optional The number identifying the alert to be deleted You must specify either this parameter or the source parameter but not both source Optional Identifies a source of alerts all alerts from this source are deleted You must specify either this parameter or the alertnum parameter but not both Command Line Interface Commands 93 Command execution example 1 hdvmcli DeleteAlerts o D logs ALL DeleteAlerts log alertnum 6 Command execution result 1 RESPONSE Command completed no data returned Command execution example 2 hdvmcli DeleteAlerts o D logs ALL DeleteAlerts log source ARRAY HDS9980V 0207 Command execution result 2 RESPONSE Command completed no data returned 4 7 3 Delete URLLink DeleteURLLink removes the association of an application or web page with an object in the Device Manager server see Table 4 72 Table 4 72 Delete URLLink Command Parameters Parameter Name Status Description objectid Optional The objectID of the URLLink to be removed You must specify either obj ectid or linkedid linkedi
68. ameter 90 Table 4 68 ModifyHost Command PDarameters nn nnnrnnnnnenrnnnnnnnrnnnnnnrrnnnnenrnnnnnnnnnn 91 Table 4 69 ModifyHostInfo Command Parameiers nn nnenrnnnnnenrnnnnnnrrnnnnenrnnnnnnnnn 92 Table 4 70 AddURLLink Command Parameters ccccceececeeeeceeeeeeeeaeeeeeeaeeeeeeaeeeeecaeeeeseeeeeseceeeeeeeeseeessnaeeees 93 Table 4 71 DeleteAlerts Command Parameter 93 Table 4 72 DeleteURLLink Command Parameters ccccccccceeeeeeceeeeeeeeeeeeeeeeeeeeaeeeeeceeeseecaeeeeseneeeesesneeeeseneeeees 94 Table 4 73 GetAlerts Command Parameter tnnt nEnntEEEnSEEEES EEEE nn EEEn nE Ennn Ennn nnen nnne 94 Table 4 74 GetLogFile Command Parameters nnne n ennen 96 Table 4 75 GetURLLink Command Parameter 97 Table 4 76 ModifyDebugLevel Command Parameters ennnen 97 Table 4 77 AddConfigFileForReplication Command PDarameters rennene 98 Table 4 78 AddReplication Command Parameters cccccccceeeeeeeeeeeeeeeeeeeeeceeeeeeeeaeeeeceaeeeeeecaeeeeeeneeeeeseeeeeesaees 100 Table 4 79 GetHost Command Display and AddReplication Command Parameters reren 102 Table 4 80 DeleteReplication Command Parameters cccceeeceeeeeeeeeeeeeeeeeeeeeeaeeeeeccaeeceseeaeeeeseneeeeessneeeeessaees 105 Table 4 81 GetReplicationControllerPair Command Parameiers 107 Table 4 82 ModifyReplication Command Parameters cccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseaeeceeesecaeeeeeeneeeeseeneeeeeesaees 108 Table 5 1 Example of the Properties File in Windows 1
69. ands 55 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 2 ReplicationInfo elements An instance of ReplicationInfo object ID REPINFO 10001 100 10001 101 pvolSerialNumber 10001 pvolArrayType HDS9980V pvolDevNum 100 pvolObjectID LU HDS9980V 10001 100 pvolPoolID 1 svolSerialNumber 10001 svolArrayType HDS9980V svolDevNum 101 svolObjectID LU HDS9980V 10001 101 svolPoolID 1 replicationFunction BusinessCopy fenceLevel Data status 1 muNumber 0 copyTrackSize 15 splitTime 1 List of 2 Lu elements An instance of LogicalUnit object ID LU HDS9980V 10001 100 devNum 100 displayName 0 64 emulation OPEN 3 devCount 1 devType capacityInKB 2 403 360 path true commandDevice false commandDeviceSecurity false chassis 1 arrayGroup 16 raidType RAID5 3D 1P currentPortController 1 defaultPortController 1 isComposite 0 cont inuousAccessVolumeType Simplex businessCopyVolumeType P VOL snapshot VolumeType Simplex journalVolumeType Simplex sysVolFlag 0 externalVolume 0 differentialManagement 0 An instance of LogicalUnit object ID LU HDS9980V 10001 101 devNum 101 displayName 0 65 emulation OPEN 3 devCount 1 devType capacityInKB 2 403 360 path true commandDevice false commandDeviceSecurity false chassis 1 arrayGroup 16 raidType RAID5 3D 1P currentPortController 1 defaultPortController 1 Command Line Interface Commands 56 isComposite 0 cont inuousAccessVolumeTyp
70. ant to obtain Possible values are HostStorageDomain Path and or Host not case sensitive Omit this parameter to return only logical groups that have no elements Command execution example 1 hdvmcli GetLogicalGroup o D logs GetLogicalGroup log subtarget Host HostStorageDomain path Command execution result 1 RESPONSE An instance of LogicalGroup object ID GROUP 1 name toro parentID GROUP 0 logicalPath root toro icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 List of 3 GroupElement elements An instance of Host object ID HOST 1 name hit ipAddress 192 168 32 63 capacityInKB 0 hostType 1 An instance of HostStorageDomain objectID HSDOMAIN HDS9980V 10001 0 0 portID 0 domainID 0 hostMode HP displayName CL1 A 0 Command Line Interface Commands 67 nickname 1A G00 An instance of Path objectID PATH HDS9980V 10001 0 0 101 devNum 101 port ID 0 domainID 0 scsiID 15 LUN 8 wwnSecurityValidity true repeated for other LogicalGroup instances Command execution example 2 hdvmcli GetLogicalGroup o D logs GetLogicalGroup log objectID GROUP 1 subtarget Host HostStorageDomain path Command execution result 2 RESPONSE An instance of LogicalGroup object ID GROUP 1 name toro parentID GROUP 0 logicalPath root toro icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUN
71. asier access to the configuration monitoring and management features Device Manager allows you to view the configuration of the storage arrays added to the Device Manager system and perform configuration operations such as allocating storage or securing LUNs Device Manager allows you to quickly discover storage subsystems based on key attributes and efficiently manage complex and heterogeneous storage environments Device Manager allows you to back up and restore your configuration database In addition Device Manager can securely manage storage management remotely by means of SSL based communications Device Manager provides H Storage subsystem discovery and configuration display e Hierarchical group management for storage e Alert presentation Volume LUN configuration D Management of hosts and WWNs H Several levels of access and functionality for end users including access control storage management and system support e Access control handles support for the system administrator storage administrator maintenance user and guest user e Storage management functions include storage configuration and manipulation e System support functions include user administration host agent activity and security K IMPORTANT Device Manager does not support management of mainframe volumes You may view those volumes only 1 2 Command View XP Advanced Edition Device Manager Software Components Command View XP Advanced Edition Device
72. atedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 numberOfOpenAllocatedLUs 180 numberOfOpenUnallocatedLUs 1 564 numberOfImAllocatedLUs 0 numberOfImUnallocatedLUs 0 numberOfMf LDEVs 0 numberOfAllocatedMf fLDEVs 0 numberOfUnallocatedMf LDEVs 0 product Code 1 List of 1 CommParameters elements An instance of CommParameters userID root userPassword hdvm ipAddress 172 16 45 1 4 3 6 DeleteArrayReservation DeleteArrayReservation unlocks the target storage subsystem see Table 4 13 Users with access to this command Command Line Interface Commands 32 Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest Table 4 13 AddStorageArray Command Parameters model Required Model of the storage subsystem serialnum Required Serial number of the storage subsystem Command execution example hdvmcli DeleteArrayReservation o D logs DeleteArrayReservation log model XP12000 serialnum 14009 Command execution result RESPONSE Command completed no data returned 4 3 7 DeleteHostStorageDomain DeleteHostStorageDomain deletes a host storage domain For the StorageWorks XP12000 XP10000 and XP1024 XP128 this command deletes a host group from the storage subsystem see Table
73. ber 50 001 svolHostID 1 svolInstanceNumber 12 svolPortNumber 50 002 replicationFunction BusinessCopy copyTrackSize 15 List of 1 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 15001 11 15001 12 pairName HCMD CP0000 pvolSerialNumber 15001 pvolArrayType HDS9980V pvolDevNum 11 pvolObjectID LU HDS9980V 15001 11 pvolPoolID 1 svolSerialNumber 15001 svolArrayType HDS9980V svolDevNum 12 svolObjectID LU HDS9980V 15001 12 svolPoolID 1 replicationFunction BusinessCopy status 1 muNumber 2 copyTrackSize 15 splitTime 1 The third method is to create a new RAID Manager configuration definition file create a copy group then add a copy pair to the copy group using the following command hdvmcli URL AddReplication option groupname group name pvolhostid host ID pvolinstancenum instance number pvolportnum port number svolhostid host ID svolinstancenum instance number svolportnum port number pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolportid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction BusinessCopy Cont inuousAccess Cont inuousAccessExtension Snapshot fencelevel fence level copytracksize copy pace Command execution example 3 This example creates a RAID Manager configuration definition file and a copy group and then creates a copy pair for Continuous Access XP
74. ber of the LUN group s storage array model Required Model of the LUN group s storage array port Required ID for the port of LUN group to be deleted lungroupid Required Object ID of the LUN group to be deleted Command execution example hdvmcli DeleteLunGroup o D logs XP512 DeleteLunGroup log serialnum 10011 Command Line Interface Commands 78 model XP512 port 19 lungroupid LUNGROUP HDS9960 10011 19 LG00 Command execution result RESPONSE Command completed no data returned 4 5 9 Delete VWWN DeleteWWN removes a WWN from a port see Table 4 54 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 54 DeleteWWN Command Parameters Parameter Name Status Description serialnum Required Serial number of the port s storage array model Required Model of the port s storage array port Required Port number wwn Required WWN to be deleted from the port Command execution example hdvmcli DeleteWWN o D logs XP1024 DeleteWWN log serialnum 10001 model XP1024 port 0 wwn 11 22 33 22 44 55 33 11 Command execution result RESPONSE Command completed no data
75. ce Commands 59 Table 4 34 ModifyPort Command Parameters Parameter Name Status Description hostmode Optional New host connect mode value for the port To change this value you must specify the domain parameter For values available to the StorageWorks XP Disk Array see Table 4 35 hostModeOption Optional An option of the host connection mode To specify two or more options XP12000 XP10000 only separate them with semicolons For details on the values that you can specify see Table 4 36 Table 4 35 HostMode Parameter Values StorageWorks XP Disk Array Storage Subsystem Available Values for Setting the HostMode Parameter StorageWorks XP12000 XP10000 Possible values are Standard Sequent HP Solaris Netware Windows Windows Extension Tru64 HI UX AIX OPEN VMS The following value relies on the DKC microcode version For 50 03 0X XX XX or later UVM StorageWorks XP1024 XP128 Possible values are Standard Sequent HP Solaris Netware Windows Windows Extension Tru64 HI UX AIX OPEN VMS For 21 05 00 XX XX or later Windows Extension Solaris Extension For 21 14 02 XX XXor later Standard Extension2 HP Extension2 Solaris Extension2 Windows Extension2 StorageWorks XP512 XP48 Possible values are Standard Sequent HP Solaris Netware Windows Tru64 AIX OPEN VMS El Table 4 36 lists the hostModeOption parameter values and descriptions Command Line Inter
76. ceaeeeeecaeeeesesaeeseseaaeeesecaeeeseecaeeseeeeeeesenueeeeseneeeess 76 4 5 6 ee GOUD VE 77 4 5 7 BITTEN 78 4 5 8 Deletellun Group iiieoo niara eaea ni aE EE 78 4 5 9 DLAI Ve EE 79 4 5 10 DeleteWWNForHostStorageDomain ssssessseeesesenneesinresttrsstrtntttnnntrtntnetnnnnttnnnntennntnnnnnnnn nennen nennt 79 4 5 11 DeleredvWdhkort gp sed eebe d ebe dE ssaa aa eia oa ai kaste madam aa a aedi nE 80 4 5 12 DeleteWWNForLunGroup 2 cceeeeecceeeeeneeeeeeeaeeeeeeeaeeeeeceaeeeeeaeeceseaaeeeeecaeeeesseaeeeesecaeeeseeeaeeeesnaaes 80 Contents 3 GN KC Oe Ee Ee EE EN 4 5 14 ell Ee EE EN 4 5 15 ModiivWuWhNGroup rn nnnnr rn norr raner raneren rn nnenrnnnnnenrnnnnnenrnnnnnnrrnnnnnnrnnnnnnnnnn 82 4 6 Host Management Commandes 83 4 6 1 Addo 84 4 6 2 ele lu e EE 84 4 6 3 AddHostRefresh EE 85 4 6 4 Deler dee ee ee eee nee ee 86 4 6 5 DeleteHostl nfo ceccccccceecccceeeeeceeeeeneeeeseeneeeesaeeeeesaaeeseseaaeeeesaeesessaaeeseesaeeeesseaeeeeeeeaeeeesenaeeeesnaees 86 4 6 6 GEtHost EE 87 4 6 7 GetHostnNfo BEE 90 4 6 8 ModifyHost erste Seene E E EN 4 6 9 okee e a EE EN 4 7 Server Management Commandes nn nnnnr rn nnnnnr nn nnnnrnnnnnen rn nnnnrrnnnnnnrnnnnnnnrnnnnnnrnnnnnnnnnnnnn 93 4 7 1 e EI AE E IT 93 4 7 2 BLEIEN Eg JE EE ee eee 93 4 7 3 PE ET GE EE EEE EEE 94 4 7 4 ETNE CEET 94 4 7 5 1 11D 1 1 e EEE EE bh ECE Eiee 95 4 7 6 E Eora EE 95 4 7 7 Een e EE 96 4 7 8 Get REIN sx actchcceaerchtesaaschty actchtcsavscht asp tc
77. ct ID is HOST 1 hdvmcli GetHost o D logs GetHost log objectid HOST 1 configFileID CONFIGFILE 1 11 Command execution result 1 RESPONSE An instance of Host object ID HOST 1 name toro2 ipAddress 192 168 32 63 capacityInKB 0 hostType 1 List of 2 WWN elements An instance of WWN WWN 00 99 66 33 88 55 22 77 nickname Jane An instance of WWN WWN 11 44 77 22 55 88 33 66 nickname Jone List of 1 ConfigFile elements An instance of ConfigFile Command Line Interface Commands 87 object ID CONFIGFILE 1 11 instanceNumber 11 controlledBy Device Manager portNumber 50000 valid 1 List of 1 ReplicationGroup elements An instance of ReplicationGroup object ID REPGROUP 3 replicationGroupID 3 groupName HCMD CG0003 pvolHostID 1 pvolInstanceNumber 11 pvolPortNumber 50 000 svolHostID 2 svolInstanceNumber 12 svolPortNumber 50 001 replicationFunction BusinessCopy copyTrackSize 15 List of 2 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 65010001 11 65010001 12 pairName HCMD_CP0001 pvolSerialNumber 65010001 pvolArrayType HDS9570V pvolDevNum 11 pvolObjectID LU HDS9570V 65010001 11 pvolPoolID 1 svolSerialNumber 65010001 svolArrayType HDS9570V svolDevNum 12 svolObjectID LU HDS9570V 65010001 12 svolPoolID 1 replicationFunction BusinessCopy status 8 muNumber 0 copyTrackSize 15 splitTime 1 An instance of ReplicationInfo object ID REPINFO 65010001 1012 65010001 102
78. d Optional The object ID of the linked object All links to this object are removed You must specify either obj ectid or linkedid Command execution example 1 hdvmcli DeleteURLLink o D logs XP1024 DeleteURLLink log linkedid HSDOMAIN HDS9980V 10001 0 3 Command execution result 1 RESPONSE Command completed empty list returned Command execution example 2 hdvmcli DeleteURLLink o D logs XP1024 DeleteURLLink log objectid URLLINK HSDOMAIN HDS9980V 10001 0 3 1 Command execution result 2 RESPONSE Command completed empty list returned 4 7 4 GetAlerts GetAlerts returns the alert messages previously generated by the Device Manager server see Table 4 73 The returned alerts can be limited by specifying a time and or a number of messages If you do not specify any conditions to restrict the number of alert messages you intend to obtain the information about all the alerts will be returned Users with access to this command Yes System Administrator Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 73 GetAlerts Command Parameters Command Line Interface Commands 94 Table 4 73 GetAlerts Command Parameters Parameter Name Status Description countfilter Optional returned alerts not Maximum number of
79. d Parameters Model of the storage subsystem When you omit this parameter all the storage subsystems become the target Command Line Interface Commands 47 Table 4 26 GetStorageArray subtarget LogicalUnit Command Parameters Parameter Name serialnum Status Optional Description Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify LogicalUnit lufilter Optional Filter for selecting a logical unit Available values are ALL ASSIGNED and FREE When you omit this parameter or specify ALL you will obtain information about all the logical units When you specify FREE you will obtain the information about the logical units that do not have a LUN assigned When you specify ASSIGNED you will obtain the information about the logical units that have a LUN assigned lufilterchildid Optional Filter for selecting a logical unit Specify the objectID of the LDEV Only the logical units corresponding to the LDEV of the specified objectID are returned lusubinfo Optional Specific information about the logical unit The values you can specify are Path LDEV and VolumeConnection If you specify multiple values at the same time separate values by commas objectid Optional Object ID of the logical unit When you omit this parameter all the logical units become the target pathsubinfo
80. d locations and telephone numbers Helpful web sites For additional product information see the following web sites http www hp com http www hp com go storage http www hp com support About this guide 8 Revision history Revision tables Table 2 Revisions a Date Edition Revision 2 July 11 2005 First Initial Release S October 2005 Second e By the AddHostStorageDomain command and ModifyPort command the following 3 hostmode modes have been added D e Standard Extension2 e Solaris Extension2 e Windows Extension2 e AIX Extension2 Revision history 9 1 Command View XP Advanced Edition Device Manager Overview This chapter provides an overview of Command View XP Advanced Edition Device Manager and describes its software components e Overview of Command View XP Advanced Edition Device Manager section 1 1 D Related software products section 1 4 H Command View XP Advanced Edition Device Manager Software Components section 1 2 Downloading CLI from the Device Manager server section 1 5 1 1 Overview of Command View XP Advanced Edition Device Manager Device Manager provides a consistent easy to use and easy to configure interface for managing storage products Device Manager provides a web based graphical client interface for real time interaction with managed storage arrays as well as a command line interface CLI for scripting Device Manager gives storage administrators e
81. d prompt C Vhdvm gt hdvmcli http localhost 2001 service GetStorageArray serialnum 30057 model XP512 When a parameter is specified both from the command line and from the properties file Device Manager uses the value from the command line EA NOTE All the parameters specified in the properties file are assumed to have been specified when a command is executed If you specify an inappropriate parameter the command execution result may differ from what you expected For this reason make sure that you only specify parameters that do not cause problems to any other commands 5 3 Setting Up the Device Manager CLI Execution Environment This section describes how to set up the Device Manager CLI execution environment based on Table 5 1 Example of Properties File in Windows 5 3 1 Specifying the Log File The default file name of the log file used by Device Manager CLI is hdvmc1i Log This file is created in Device Manager CLI execution directory or folder You can specify a default file name log output destination log level and so on Specify the log output destination in the hdvmcli logfile property in the properties file In the following example the command specifies C Temp diag 1og for the output destination hdvmcli logfile C Temp diag log EA NOTE In a Windows environment use or instead of as a delimiter 5 3 2 Specifying a Log Level You can use hdvmcli diaglevel to specify the level of log information to be o
82. d resources Local System Administrator and Local Storage Administrator do not have access range limitations Command execution example hdvmcli GetDebugLevel o D logs GetDebugLevel log Command execution result RESPONSE An instance of DebugLevel value 0 Full Debugging trace description Debugging Trace 4 7 6 GetLogFile GetLogFile returns the requested Device Manager server log file see Table 4 74 Command Line Interface Commands 95 Users with access to this command e Yes System Administrator Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 74 GetLogFile Command Parameters filename Required Name of the requested log file access Log service log error log or trace log Command execution example hdvmcli GetLogFile o D logs GetLogFile log filename error log Command execution result RESPONSE An instance of File name error log Contents of File Follow Contents of File error log is omitted here End of File Contents 4 7 7 GetServerlnfo GetServerInfo returns information about the Device Manager server including the server version server URI list of supported array families and so on There are no parameters Users with access to this command Yes Syste
83. del Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify LDEV devnum Optional Device number of the LDEV that you intend to obtain When you omit this parameter all the LDEVs become the target ldevfilter Optional Filter used for selecting the LDEV Available values are OPEN INTERMEDIATE and MAINFRAME which are not case sensitive To specify two or more values specify them with a semicolon When you omit this parameter all LDEVs are displayed When you specify OPEN the LDEVs for an open volume will be displayed When you specify INTERMEDIATE the LDEVs for an intermediate volume will be displayed When you specify MAINFRAME the LDEVs for a mainframe volume will be displayed When you specify OPEN MAINFRAME the LDEVs for both the open volume and mainframe volume will be displayed ldevsubinfo Optional Information about the LDEV The value you can specify is VolumeConnection Command execution example In this example the CLI command obtains information about a specific LDEV device number 0 in a storage subsystem serial number 10001 model XP12000 hdvmcli GetStorageArray o D logs XP12000 GetStorageArray LDEV log subtarget LDEV model XP12000 serialnum 10001 devnu
84. dvmcli logfile C Temp diag log Diagnostic level of the diagnostic file currently default is DEBUG Allowable values are DEBUG INFO and WARN each of which will output that level and higher hdvmcli diaglevel INFO Location for the message trace file default when not specified is MessageTrace log in the executing directory hdvmcli tracefile C DeviceManager traffic log set the server url hdvmcli serverurl http localhost 2001 service Hii OPTIONS G nn user khalsa Using the Device Manager Properties File 110 password can be provided directly or from a password file password khalsa password D DeviceManager passwd provide a copy of the raw xml request amp response in MessageTrace log file messagetrace true COMMAND PARAMETERS set the Array model for commands that use this parameter model XP1024 5 2 Using the Properties File to Specify Parameters Specifying a parameter in the properties file in advance allows you to omit entering the parameter at the command prompt You can specify all the parameters you enter at the command prompt in the properties file To specify a parameter use the parameter name as the key and the parameter value as the property value For example when you always execute a command for a certain storage subsystem you can set the property corresponding to the model parameter as model XP512 instead of entering the following at the comman
85. e For example C Vhdvm gt hdvmcli GetStorageArray serialnum 30057 model XP512 When the URL is also specified in the command line that URL is used instead of the URL from the properties file 5 3 5 Inputting Requests from XML Documents A CAUTION To use the XML API CLI feature you should have thorough knowledge of XML API and should take great care in formulating commands Instead of specifying the command and parameters from the command line you can make the request from a file The file must contain a valid XML document in the correct form for a Device Manager request The command line option i or input specifies the input file The other application options are still valid However any command or parameter specified from the command line or in the properties file is ignored because that information is already in the XML document The i lt filename gt option allows you to specify an xml message file You can use this feature to request multiple operations in on the CLI command which can save considerable time For example usually the AddLun command specifies creation of a single LUN The AddLun XML API allows you to create multiple LUNs with a single request Syntax hdvmcli t AddLun serialnum lt Serial Number gt model lt Model Name of Array gt port lt Port gt domain lt HostStorageDomain gt scsi lt Scsi Target gt lun lt SCSI LU gt devnum lt LDEV gt Example 1 To add a LUN to LDEV
86. e Administrator Local Guest Table 4 24 GetStorageArray subtarget HostStorageDomain Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify Host StorageDomain domain Optional Domain ID of the host storage domain When you omit this parameter all the host storage domains become the target hsdsubinfo Optional Specific information about the host storage domain The values you can specify are WWN Path and FreeLUN If you specify multiple values at the same time separate the values by commas port Optional Number of the port containing the host storage domain When you omit this parameter all the host storage domains become the target Command execution example In this example the CLI command obtains information about a host storage domain port number 3 domain ID 1 in a storage subsystem serial number 10001 model XP1024 The information includes information about the paths WWNs and unused LUNs in the host storage domain hdvmcli GetStorageArray o D logs XP1024 GetStorageArray HostStorageDomain log subtarget HostStorageDomain model XP1024 serialnum 10001 port 23 domain 1 hsdsubinfo path wwn freelun C
87. e RAID Manager You cannot specify a name that begins with a hash mark or hyphen You can use 31 or fewer characters When using Method 1 specify a group name that is specified in the definition file pvolhostid Required Host ID for identifying the P VOL When using Method 1 specify the host ID of the P VOL ina group specified in the definition file pvolinstancenum Required Method 1 or 2 Instance number of the Continuous Access XP instance for managing the P VOL When using Method 1 specify the instance number of the P VOL of a group specified in the definition file pvolportnum Required Method 3 Port number of the Continuous Access XP instance for managing the P VOL In Solaris specify an integer from 0 to 65535 In AIX Windows HP UX and Linux specify an integer from 1 to 65535 This parameter is invalid when the pvolinstancenun is specified svolhostid Required Host ID for identifying the S VOL When using Method 1 specify the host ID of the S VOL of a group specified in the definition file svolinstancenum Required Method 1 or 2 Instance number of the Continuous Access XP instance for managing the S VOL When using Method 1 specify the instance number of the S VOL of a group specified in the definition file svolportnum Required Method 3 Port number of the Continuous Access XP instance for managing the S VOL In Solaris specify an integer from 0 to 65535 In ALX Window
88. e Simplex businessCopyVolumeType S VOL snapshotVolumeType Simplex journalVolumeType Simplex sysVolFlag 0 externalVolume 0 differentialManagement 0 repeated for other ReplicationInfo instances 4 3 13 ModifyArrayReservation ModifyArrayReservation extends the period of time that can elapse before the target storage subsystem is unlocked see Table 4 32 Reservation affects only Storage Array Commands and LUN Commands GetStorageArray can be executed for subsystems reserved by another user The commands listed in section 4 3 1 can be performed under your reservation If the configuration is not changed and ModifyArrrayReservation is not executed the reservation will expire in 5 minutes If ModifyArrrayReservation is executed the period of time is reset again to expire in five minutes Users with access to this command e Yes System Administrator Storage Administrator e No Local System Administrator Local Storage Administrator Guest Local Guest EA NOTE A Local System Administrator or Local Storage Administrator can specify only storage subsystems containing accessible LDEVs If any other storage subsystems are specified an error occurs Table 4 32 ModifyArrayReservation Command Parameters model Required Model of the storage subsystem serialnum Required Serial number of the storage subsystem Command execution example hdvmcli ModifyArrayReservation o D logs ModifyArrayReservation log model XP12
89. e from the execution result serialnum Execute the Get StorageArray command and then use the serialNumber value source Execute the GetAlerts command and then obtain the value from the execution result svoldevnum Execute the GetHost command and then obtain the value from the execution result svolsequencenum Execute the Get StorageArray command for the storage subsystem that contains the S VOL Use the value of the sequenceNumber Command Line Interface Commands 20 Table 4 1 Extracting Parameter Values To Find This Parameter Value svolserialnum Do This Execute the Get Host command and then obtain the value from the execution result Wwn Execute the Get StorageArray subtarget Port portsubinfo WWN WWNGroup wwngroupsubinfo WWN command specifying WWN for the portsubinfo parameter and then obtain the value from the execution result NOTE As an alternative method you can specify the wwn parameter by creating a new WWN You can use a WWN group to set the security if you specify all the WWNs existing in the WWN group wwngroup Execute the GetStorageArray subtarget Port portsubinfo WWNGroup command specifying WWNGroup for the portsubinfo parameter Use the nickname value that appears in WWNGroup 4 2 Supported CLI Commands Table 4 2 through Table 4 7 give details about Device Manager CLI commands Y indicates that the particular storage subsystem can be used to ex
90. e storage subsystems become the target subtarget Required Specify Filter Command Line Interface Commands 41 Table 4 22 GetStorageArray subtarget Filter Command Parameters objectID Required Object ID of the component of a storage subsystem The component identified by the object ID you specify with this parameter will be returned Command execution example In this example the CLI command obtains information about a logical unit objectID LU HDS9980V 10001 100 that is a component of a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray Filter log subtarget Filter model XP1024 serialnum 10001 objectID LU HDS9980V 10001 100 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Lu elements An instance of LogicalUnit object ID LU HDS9980V 10001 100 devNum 100 displayName 0 64 emulation OPEN 3 devCount 1 devType capacityInKB 2 403 360 path true commandDevice false commandDeviceSecurity false chassis 1 arrayGroup 16 raidType RAID5 3D 1P currentPortController 1 default PortController 1 isComposite 0 continuousAccessVolumeType Simplex businessCopyVolumeType Simplex snapshotVolumeType Simplex journalVolumeType Simplex sysVolFlag 0 externalVolume 0 differentialManagement 0 4 3 12 5 GetStorageArray subtarget FreeSpace GetStorageArray
91. eNumber 11 pvolPortNumber 50 000 svolHostID 3 svolInstanceNumber 12 svolPortNumber 50 001 replicationFunction BusinessCopy copyTrackSize 15 List of 1 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 65010001 20 65010001 21 pvolSerialNumber 65010001 pairName HCMD_CP0001 pvolArrayType HDS9980V pvolDevNum 20 pvolObjectID LU HDS9980V 65010001 20 pvolPoolID 1 svolSerialNumber 65010001 svolArrayType HDS9980V svolDevNum 21 svolObjectID LU HDS9980V 65010001 21 svolPoolID 1 replicationFunction BusinessCopy status 16 muNumber 0 copyTrackSize 15 splitTime 1 Command Line Interface Commands 109 5 Using the Device Manager Properties File This chapter describes how to use property files to specify option parameters This chapter also describes how to change certain properties by entering commands on the command line e Using the Properties File to Specify Options section 5 1 D Using the Property Files to Specify Parameters section 5 2 Setting Up the Device Manager CLI Execution Environment section 5 3 5 1 Using the Properties File to Specify Options The Device Manager CLI properties file is the file hdvmcli properties in a directory or folder where Device Manager CLI is installed In this properties file you can specify arguments options and parameters to be entered at CLI execution Specifying these arguments options and parameters in the properties file in advance allows you to om
92. ecute the command indicates that it cannot be used to execute the command Table 4 2 Storage Array Commands Command Name Description Storage Subsystems Section XP12000 XP10000 XP512 XP48 and XP1024 XP128 AddArrayReservation Locks a specified storage subsystem Y 4 3 1 AddHost StorageDomain Creates a host storage domain or Y 4 3 2 host group AddLogicalUnit Creates an LDEV and a logical unit in Y Y 4 3 3 the storage subsystem AddLUSE Creates a LUSE that does not have a Y 4 3 4 path AddStorageArray Detects a specified storage Y Y 4 3 5 subsystem and sets it as the device to be managed by the Device Manager server Information about the devices of the detected storage subsystem is registered in the Device Manager server database DeleteArrayReservation Unlocks a specified storage Y Y 4 3 6 subsystem DeleteHostStorageDomain Deletes a host storage domain or Y Y 4 3 7 host group DeleteLogicalUnit Deletes one or more LUs and the Y Y 4 3 8 corresponding LDEVs DeleteLUSE Deletes a LUSE that does not havea Y 4 3 9 path DeleteStorageArray Excludes a storage subsystem from Y Y 4 3 10 the group of storage subsystems managed by the Device Manager server GetArrayReservation Obtains information about the locked Y Y 4 3 11 storage subsystem GetStorageArray see Note Obtains information about the storage Y Y 4 3 12 subsystems Command Line
93. ed port Required Port number of the WWN group wwn Required Comma separated list of WWNs to be added to the WWN group nickname Required A unique nickname of the WWN group name Optional The name given to the WWN group Command execution example hdvmcli AddWWNGroup o D logs XP512 AddWWNGroup log serialnum 10001 model XP512 port 19 wwn 11 55 77 99 33 00 22 66 AA AA AA AA AA AA AA AA nickname hp name hp Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port Attributes of Port are omitted here List of 1 WWNGroup elements An instance of WWNGroup object ID WWNGROUP HDS9960 10001 0 19 hp name hp nickname hp List of 2 WWN elements An instance of WWN WWN AA AA AA AA AA AA AA AA nickname Jane An instance of WWN WWN BB BB BB BB BB BB BB BB Command Line Interface Commands 77 nickname Jone 4 5 7 DeleteLun DeleteLun deletes a path from a host to a volume see Table 4 52 If the LUN is secured the corresponding WWIN is required Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator Local Storage Administrator Table 4 52 DeleteLun Command Parameters Parameter
94. ed Serial number of the storage array in which the LUN group exists model Required Model of the storage array in which the LUN group exists port Required Port number of the LUN group objectid Required Object ID of the LUN group groupelement Required Comma separated list of one or more object IDs of the paths to be added to the LUN group s nickname Optional Unique nickname of the LUN group name Optional The name given to the LUN group i Command execution example hdvmcli ModifyLunGroup o D logs XP512 ModifyLunGroup log serialnum 10001 model XP512 port 19 groupelements PATH HDS9960 10001 16 2 0 PATH HDS9960 10001 16 2 1 objectid LUNGROUP HDS9960 10001 19 hp nickname hp Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port Attributes of Port are omitted here List of 1 LUNGroup elements An instance of LUNGroup objectID LUNGROUP HDS9960 10001 0 19 hp nickname hp List of 2 Path elements An instance of Path object ID PATH HDS9960 10001 16 2 0 devNum 0 portID 19 domainID 16 scsiID 15 LUN 8 wwnSecurityValidity true repeated for other Path instances 4 5 15 ModifyWWNGroup ModifyWWNGroup modifies a WWN group assigned to a target storage array port XP512 XP48 subsystem only and adds two or more WWN s to the WWN group see Table 4 60
95. ed no data returned The second method is adding a copy group to the RAID Manager configuration definition file and adding a copy pair definition to the copy group by using the following command hdvmcli URL AddConfigFileForReplication option groupname copy group name pvolhostid host ID pvolinstancenum instance number pvolportnum port number svolhostid host ID svolinstancenum instance number svolportnum port number Command Line Interface Commands 99 pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolportid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction BusinessCopy Cont inuousAccess Cont inuousAccessExtension Snapshot Command execution example 2 create a group in the configuration files and then add pairs to the group hdvmcli AddConfigFileForReplication o D logs XP1024 AddConfigFileForReplication log pvolhostid 1 pvolinstancenum 11 svolhostid 1 svolinstancenum 12 pvolarraytype HDS9980V pvolserialnum 15001 pvoldevnum 11 svolarraytype HDS9980V svolserialnum 15001 svoldevnum 12 Command execution result 2 RESPONSE Command completed no data returned The third method is creating a new CCI configuration definition file by using the following command hdvmcli URL AddConfigFileForReplication option groupname copy group name pvolhostid host ID pvo
96. ed and some are optional Each parameter is represented as a name value pair e g name value Table 3 1 hdvmcli Options Option Argument Description i or input filename Takes input from the specified file which must contain the server request as a complete XML document and outputs it as an XML formatted document o Or output filename Send output to the specified file instead of the console p or password see Note password or password Either a valid password for the server or a file containing the login password when preceded by a See Note This option is essential if you do not specify it in the properties file s Or secure no argument Uses a secure connection https to communicate with the server u Or user userid A valid user ID for the server This option is essential if you do not specify it in the properties file t or messagetrace no argument Outputs the request and the response in the MessageTrace log file Eg NOTE A password can be contained in a text file This file generally has restricted access but that must include the user The file path is specified either relative to the location where the application is run or as an absolute path and is preceded by an character The text of the first line is the password The parameters that form the input to a command are specified on the command line as name value pairs The parameter name is specified fir
97. ed in another group unique among top level groups When you omit this parameter the group name is not modified iconfile Optional Name of the icon file that visually represents the new logical group When you omit this parameter the group icon file is not modified For details about specifiable icon files see Table 4 39 parent Optional Object ID of another logical group that contains the specified group This must be the valid ID of a group and the parent must either contain only other groups or be empty When you omit this parameter the group s parent is not modified Command execution example hdvmcli ModifyLogicalGroup o D logs ModifyLogicalGroup log objectid GROUP 0 groupname snow iconfile group13 gif Command execution result RESPONSE An instance of LogicalGroup object ID GROUP 0 name snow parentID GROUP 0 logicalPath root snow icon groupl3 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 4 5 LUN Commands For further information on LUN operations please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide 4 5 1 AddLun AddLun defines a path from a host to a volume see Table 4 46 At the time the path is defined a LUN Expansion LUSE logical unit can be specified Users with access to this command Command Line Interface Commands 69 Yes System Administrator Storage Administrator
98. eplication Deletes copy pairs Y Y 4 8 3 GetReplicationControllerPair Obtains RCU remote path Y Y 4 8 4 information registered in the MCU main control unit in storage subsystems managed by the Device Manager server ModifyReplication Changes copy pair status Y Y 4 8 5 4 3 Storage Array Commands For information on storage array operations please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide 4 3 1 AddArrayReservation AddArrayReservation locks the target storage subsystem see Table 4 8 When a storage subsystem is locked you can execute storage array commands and LUN commands You can execute the Get StorageArray command even if another user is locking the storage subsystem If you do not change the configuration of the storage subsystem or execute the ModifyArrayReservation command within five minutes after locking the storage subsystem the storage subsystem will be unlocked Eg NOTE You cannot use the GUI to operate a storage subsystem when it is locked If you want to operate a locked storage subsystem use the CLI commands You can execute the following commands H AddStorageArray AddLun DeleteLun AddHostStorageDomain DeleteHostStorageDomain Command Line Interface Commands 24 e AddLUSE e DeleteLUSE e AddWWNForHostStorageDomain DeleteWWNForHostStorageDomain AddWWNForLun H DeleteWWNForLun e DeleteWWN H AddWWNGroup H Modi
99. erInfo status COMPLETED result 0 resultSource ServerAdmin GetServerInfo messageID 253437470 gt lt ResultList gt lt ServerInfo buildVersion Build 0430 00 Jun 26 2005 serverURL http 193 36 40 55 2001 upTime 1 day 23 hours 52 minutes 4 seconds upSince Mon 8 Sep 2003 11 07 51 GMT gt lt StorageArray arrayFamily HDS9900 displayArrayFamily XP512 48 gt lt StorageArray arrayFamily HDS9900V displayArrayFamily XP1024 128 gt lt StorageArray arrayFamily USP displayArrayFamily XP12K 10K gt lt ServerInfo gt lt ResultList gt lt Response gt lt HiCommandServerMessage gt C hdvm gt Using the Device Manager Properties File 115 6 Troubleshooting This chapter describes appropriate actions to take if there is a problem with Device Manager CLI Troubleshooting section 6 1 6 1 Troubleshooting If there is a problem with Device Manager CLI e Make sure that the problem is not being caused by the PC or LAN hardware or software and try restarting the PC e Make sure that the problem is not occurring at the Device Manager server Please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Server Installation and Configuration Guide for troubleshooting information for the Device Manager server For troubleshooting information specific to Device Manager CLI see Table 6 1 For troubleshooting information common to Device Manager CLI and Web Client
100. erverMessage gt lt APIInfo version 4 3 gt lt Request gt lt ServerAdmin gt lt Get target ServerInfo gt lt ServerAdmin gt lt Request gt lt HiCommandServerMessage gt Copy and save the XML information excluding the HTTP Header information from the MessageTrace log file and use a text editor to create a file called getserv inp For example C Vhdvm gt type getserv inp lt xml version 1 0 encoding UTF 8 gt lt HiCommandServerMessage gt lt APIInfo version 4 3 gt lt Request gt lt ServerAdmin gt lt Get target ServerInfo gt lt ServerAdmin gt lt Request gt lt HiCommandServerMessage gt C Vhdvm gt At the CLI prompt type the following command do i getserv inp You will see results similar to the following example C Vhdvm gt type getservinp Das System kann die angegebene Datei nicht finden C Vhdvm gt type getserv inp lt xml version 1 0 encoding UTF 8 gt lt HiCommandServerMessage gt lt APIInfo version 4 3 gt lt Request gt Using the Device Manager Properties File 114 lt ServerAdmin gt lt Get target ServerInfo gt lt ServerAdmin gt lt Request gt lt HiCommandServerMessage gt c hdvm gt c hdvm gt C hdvm gt do i getserv inp RESPONSE lt xml version 1 0 encoding UTF 8 gt lt HiCommandServerMessage gt lt APIInfo version 4 3 gt lt Response gt lt EchoCommand name GetServ
101. eteObjectForLogicalGroup Command Parameters el Command Line Interface Commands 66 Parameter Name Status Description objectid Required Object ID of the logical group groupelements Required Comma separated list of one or more object IDs of the Host StorageDomains and or hosts to be removed from the logical group These must be valid IDs of objects currently in the group Command execution example hdvmcli DeleteObjectForLogicalGroup o D logs XP1024 DeleteObjectForLogicalGroup log objectID GROUP 0 groupelements PATH HDS9980V 10001 0 0 1 Command execution result RESPONSE Command completed no data returned 4 4 6 GetLogicalGroup GetLogicalGroup returns either a specified logical group or a list of all groups see Table 4 44 By default the characteristics of the group are provided but not the group s contents If you specify a subtarget the group s contents of the specified types are returned If a logical group contains other groups the contained groups cannot be returned with the group Instead the relationship between containing and contained groups is determined by the parent attribute of contained groups Table 4 44 GetLogicalGroup Command Parameters Parameter Name Status Description objectid Optional Object ID of the desired logical group Omit this parameter to include all logical groups subtarget Optional Comma delimited list of elements you w
102. execution example hdvmcli AddLunScan o D logs XP1024 AddLunScan log serialnum 10001 model XP1024 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 94 HostStorageDomain elements An instance of HostStorageDomain objectID HSDOMAIN HDS9980V 10001 0 0 portID 0 domainID 0 hostMode HP displayName CL1 A 0 nickname 1A G00 repeated for other HostStorageDomain instances List of 283 Path elements An instance of Path objectID PATH HDS9980V 10001 0 0 101 devNum 101 portID 0 domainID 0 scesiID 15 LUN 8 wwnSecurityValidity true repeated for other Path instances 4 4 3 AddObjectForLogicalGroup AddObject ForLogicalGroup adds one or more existing objects HostStorageDomain or host to a specified logical group on the Device Manager server see Table 4 41 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest EA NOTE If AddObjectForLogicalGroup is used with Web Client Web Client may not display logical groups and hosts Command Line Interface Commands 65 Table 4 41 AddObjectForLogicalGroup Command Parameters objectid Required Object ID of the logical group groupelements Required Comma separated list of one or more object IDs of the Host StorageDomains and or hosts to add to the logical group
103. execution result 2 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Path elements An instance of Path objectID PATH HDS9980V 10001 1 4 1001 name hp devNum 1 001 portID 1 domainID 4 scsiID 15 LUN 114 wwnSecurityValidity true List of 2 Ldev elements An instance of LDEV object ID LDEV HDS9980V 10001 1001 devNum 1 001 displayName 3 E9 emulation OPEN 3 cylinders 0 isComposite 1 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 3 arrayGroup 16 path true onDemandDevice false devType isStandardLDEV true guardMode substance 0 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 An instance of LDEV object ID LDEV HDS9980V 10001 1002 devNum 1 002 displayName 3 EA emulation OPEN 3 cylinders 0 isComposite 1 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 3 arrayGroup 16 Command Line Interface Commands 72 path false onDemandDevice false devType isStandardLDEV true guardMode substance 0 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 Command execution example 3 hdvmcli AddLun o D logs XP1024 AddLun log lun 120 serialnum 10001 domain 4 scsi 15 devnum 1006 port 1 model XP1024 name hp Command execution result 3 RESPONSE An ins
104. face Commands 60 Table 4 36 hostModeOption Parameter Values and Description hostModeOption Values Description 2 Specify this value when using VERITAS Database Edition Advanced Cluster for Real Application Clusters or VERITAS Cluster Server 4 0 I O fencing feature 6 Specify this value when all of the following conditions are satisfied e The host connection mode is set to Windows mode OG or Windows Extension mode 2C e An Emulex host bus adapter is in use e A mini port driver is in use e The TPRLO parameter for the mini port driver of the host bus adapter is set to 2 7 Specify this value when all of the following conditions are satisfied e The host connection mode is set to Standard mode 00 or Solaris mode 09 e You want to let the system automatically recognize the reduction and increase in the number of devices while a SUN host bus adapter is in use 12 Specify this value when all of the following conditions are satisfied e The host connection mode is set to HP UX mode 03 e You want to prevent devices to which no paths have been defined from creating a device file when the HP UX host is connected 13 Specify this value when you want to get a SIM notification when the number of unsuccessful connections between ports exceeds a threshold 14 Specify this value when all of the following conditions are satisfied e The host connection mode is set to Tru64 mode 07 e You want to use Tr
105. ft and Windows are registered trademarks of Microsoft Corporation NetWare is a registered trademark of Novell Inc Java JDK and Sun are trademarks of Sun Microsystems Inc in the United States and other countries All SPARC trademarks including the SCD Compliant logo are registered trademarks of SPARC International Inc Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems Inc VERITAS is a trademark or registered trademark of Symantec Corporation in the U S and other countries All other brand or product names are or may be trademarks or service marks of and are used to identify products or services of their respective owners Command View XP Advanced Edition Device Manager CLI User Guide Contents Revision history PROVISION Ee 9 1 Command View XP Advanced Edition Device Manager Overview 1 1 Overview of Command View XP Advanced Edition Device Manager 10 1 2 Command View XP Advanced Edition Device Manager Software Components sssesessseesssrssrrreenneee 10 1 3 Command View XP AE Suite Common Component nennen nennt 11 1 4 Related Software Products c cccceeeccceeeeeeceeeeeeeeeeeeeeeeeeeceaeeeeecaeeeeceaaeeeeecaeeceseaeeeeeeaeeeseecaeesetsieeeeseaees 11 1 5 Downloading CLI from the Device Manager Server mrrrnrnnrrnrrrenrrnrnnnrrnnnnnnrrnnnnnnrn rn nnnerrnnnnnnrrnnnnnnrnnnnn 11 2 Setting Up Command Line Interface 2 1 Requirements for CLlOperatons nn nnnrnnnnnn
106. fyWWNGroup H DeleteWWNGroup H AddLunGroup H ModifyLunGroup H DeleteLunGroup AddWWNForLunGroup DeleteWWNForLunGroup AddLogicalUnit DeleteLogicalUnit ModifyLogicalUnit H ModifyPort ModifyPortController Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest Eg NOTE A Local System Administrator or Local Storage Administrator can specify only storage subsystems that contain accessible LDEVs If any other storage subsystems are specified an error occurs Table 4 8 AddArrayReservation Command Parameters model Model of the storage subsystem serialnum Serial number of the storage subsystem Command execution example hdvmcli AddArrayReservation o D logs AddArrayReservation log model XP12000 serialnum 14009 Command execution result An instance of ArrayReservation object ID ARRAYRESERVATION USP 14009 target ARRAY USP 14009 loginID dmuser beginTime 1 039 003 476 4 3 2 AddHostStorageDomain AddHostStorageDomain adds a host storage domain see Table 4 9 For the StorageWorks XP12000 XP10000 and XP1024 XP128 this command also creates a host group in the storage subsystem Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Com
107. ge Domain model Required Model of the storage array for the Host Storage Domain port Required Port ID of the Host Storage Domain domain Required Domain ID of the Host Storage Domain wwn Required Comma separated list of WWN to secure the Host Storage Domain Command execution example hdvmcli AddWWNForHostStorageDomain o D logs XP1024 AddWWNForHostStorageDomain log serialnum 10001 model XP1024 port 1 domain 1 Command Line Interface Commands 74 wwn 22 33 44 55 44 55 44 33 11 33 22 33 44 33 22 22 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 HostStorageDomain elements An instance of HostStorageDomain object ID HSDOMAIN HDS9980V 10001 1 1 portID 1 domainID 1 hostMode Standard displayName CL1 B 1 nickname HCMD0103 List of 2 WWN elements An instance of WWN WWN 22 33 44 55 44 55 44 33 nickname Jane An instance of WWN WWN 11 33 22 33 44 33 22 22 nickname Jone 4 5 4 AddWWNForLun RE AddWWNForLun secures a path by assigning a WWN to it Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations NOTE When AddWWNForLun secures a path
108. geArray subtarget LDEV command specifying only the model and serialnum parameters and specifying LDEV for the subtarget parameter In the resulting output the devnum value appears under An instance of LogicalUnit Table 4 1 describes which CLI commands can be used to find which parameter values Table 4 1 Extracting Parameter Values To Find This Parameter Value Do This alertnum Execute the GetAlerts command Use the value displayed as alert number under An instance of Alerts arraygroupobjid Execute the GetStorageArray subtarget ArrayGroup command specifying only the mode1 and serialnum parameters and ArrayGroup for the subtarget parameter Use the array group displayed as object ID chassis Execute the GetStorageArray subtarget ArrayGroup command specifying only the model and serialnum parameters and ArrayGroup for the subtarget parameter The chassis value appears in a StorageArray ctrlid Execute the Get StorageArray subtarget PortController command specifying only the model and serialnum parameters and Port Controller for the subtarget parameter Use the value displayed as controllerID configfileid Execute the GetHost command without specifying any parameters Use the value displayed as ConfigFile controllernum Execute the GetStorageArray subtarget PortController command specifying only the model and serialnum parameters and the value for subtarget PortController Use the value specified as c
109. geArray subtarget Path GetStorageArray subtarget Path obtains the information about a path in one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator D No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 27 GetStorageArray subtarget Path Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify Path objectid Optional Object ID of the path When you omit this parameter all the paths of storage subsystems become the target pathsubinfo Optional Specific information about the path The values you can specify are LogicalGroup WWN WWNGroup Or HostInfo Command execution example 1 objectid parameter not specified In this example the CLI command obtains information about all the paths to a storage subsystem serial number 10001 model XP1024 The information includes information about the WWNs of all these paths the WWN groups and the host hdvmcli GetStorageArray o D logs XP1024 GetStorageArray_Path log subtarget Path model XP1024 serialnum 10001 pathsubinfo WWN WWNG
110. he logical unit in the StorageWorks XP Disk Array Specify the same emulation type as the array group in which a logical unit is created devnum Optional LU device number If omitted the number is automatically generated lusubinfo Optional sensitive If set to LDEV return the information on LDEV s related to the LU Do not include any LU LDEVs The only value possible is LDEV which is not case Command execution example In this example the CLI command creates a logical unit capacity 1 000 080KB emulation type OPEN 3 for an array group chassis number 4 array group number 32 ina storage subsystem serial number 10001 model XP1024 The LDEVs used to create the logical unit are obtained from the execution result devnum 176 hdvmcli AddLogicalUnit o D logs XP1024 AddLogicalUnit log serialnum 10001 model XP1024 chassis 4 groupnum 32 capacity 1000080 emulation OPEN 3 lusubinfo LDEV Command execution result RESPONSE An instance of StorageArray List of 1 Lu elements An instance of LogicalUnit object ID LU HDS9980V 10001 176 devNum 176 displayName 0 B0 emulation OPEN 3 devCount 1 devType capacityInKB 1 000 080 path false commandDevice false chassis 4 arrayGroup 32 raidType RAID5 3D 1P currentPortController 1 defaultPortController 1 isComposite 0 cont inuousAccessVolumeType Simplex businessCopyVolumeType Simplex snapshotVolumeType Simplex journalVolumeType Simplex
111. he subtarget parameter The objectID value that appears under An instance of PDEV consists of four parts with adjoining parts separated by a dot Use the right most value of object ID to specify the pdevid parameter pdevnums Execute the GetStorageArray subtarget PDEV command specifying only the model and serialnum parameters and PDEV for the subtarget parameter In the execution result of this command the object ID value that appears in a PDEV consists of four parts with adjoining parts separated by a dot Enter the right most value for the pdevnums parameter If there is more than one such value specified separate them with a comma port Execute the GetStorageArray subtarget Port command specifying only the model and serialnum parameters and the value for subtarget Port The port ID value appears under An instance of Port pvoldevnum Execute the Get Host command and then obtain the value from the execution result pvolserialnum Execute the GetHost command The pvolSerialNum is displayed as An instance of ReplicationInfo remoteserialnum Execute the GetReplicationControllerPair command without specifying any parameters and then obtain the value from the execution result remoteSSID Execute the GetReplicationControllerPair command without specifying any parameters and then obtain the value from the execution result replicationgroupid Execute the GetHost command and then obtain the valu
112. herwise UO operations might terminate in an XP12000 XP10000 and error StorageWorks XP1024 XP128 Setting up security for a Be sure to stop host I O to the corresponding port AddWWNForLun LUN or host storage domain before setting up security for a LUN or host storage AddWWNForHostStorageDomain domain Otherwise I O operations might terminate in an error Command Line Interface Syntax and Parameters 17 Table 3 3 Notes on Executing CLI Commands Item Description Related Commands Changing the security or When changing the security or deleting LUNs that ModifyLunGroup deleting storage that belong to LUN groups perform operations on each LUN DeleteLun belongs to a LUN group group If you want to delete or change security for only AddWWNForLun some of the LUNs that belong to a LUN group use the DeleteWWNForLun Modi fyLunGroup command to release the target LUNs from the LUN group and then perform the operation for each LUN Usable characters for logical When the CLI command and Web Client are used at the AddLogicalGroup group host and storage same time usable characters for logical group host Modi fyLogicalGroup subsystem names and storage subsystem names are the following AddHost A Z a z 0 9 ModifyHost Spaces can also be used but you cannot use a name AddStorageArray that consists of spaces only If characters other than those shown above are used operation from Web Client might not be possible
113. hot XP pair is split or resync the specification for this parameter is ignored When changing the copy pace for an identified copy pair specify the parameters pvolserialnum pvoldevnum svolserialnum and svoldevnum When using one operation to change the copy paces of all copy pairs omit these parameters EA NOTE To manipulate a specific copy pair in a copy group the pvolserialnum pvoldevnum svolserialnum or svolsequencenum and svoldevnum parameters must all be specified If you omit all of these parameters the system deletes all copy pairs in the specified copy group Command execution example This example changes to the suspend status split the status of the copy pair for Business Copy XP that is defined in the copy group with copy group number 12 The primary value of the copy pair P VOL is the logical device with LDEV number 20 in the storage subsystem with serial number 65010001 The secondary volume is the logical device with LDEV number 21 in the storage subsystem with serial number 65010001 hdvmcli ModifyReplication o D logs XP1024 ModifyReplication log replicationgroupid 12 operation split pvolserialnum 65010001 pvoldevnum 20 svolserialnum 65010001 svoldevnum 21 Command execution result RESPONSE An instance of ReplicationGroup object ID REPGROUP 12 replicationGroupID 12 Command Line Interface Commands 108 groupName HCMD CG000d pvolHostID 1 pvolInstanc
114. htceastshtaeuehthensnonshtceswtchiusaatshie geheegt 96 4 7 9 Modify Debuglevel gd EENEG Er 97 4 8 Replication Commande rrrnnrnnnrnnvrrnnrvrnnnrnnrrnnnnnnrr nn nnn rn noen rn raner nn n neser nn nnen rn raner rn nnnnrnnnnnenrnnnnnnrnnnnnennnnnnn 98 4 8 1 AddConfotiletorenlicoaton nn nnnrnnnnnnnrnnnnnnrrnnnnnnrnnnnnenrnnnnenrnnnnnrnnnn 98 4 8 2 AddReplica tion EEN 100 4 8 3 Del teReplIicatibn Lnusvrnarnuutagvtabenmuidrt a eaa oei Aretoa eean eai natoka Eina ERs 105 4 8 4 GetReplicationControllerPalir iiine en nearen ei aieo an eian aae e iaa EEEE 107 4 8 5 Kelte IL ee 108 5 Using the Device Manager Properties File 5 1 Using the Properties File to Specify Options n0nseenosnneeeeeeeeeenreesnereerenrserenrstnnnerrnnsernnnsernnnsnnnnnnn nene 110 5 2 Using the Properties File to Specify Parameters nennt 111 5 3 Setting Up the Device Manager CLI Execution Environment 111 5 3 1 Specifying the Log File sisirin ose araia eaen iae aeai piii 111 5 3 2 Specifying a Log Level ccccceceeccceeeeeceeeeeeeeeeeeeeaeeeeeeeeeeeeeaeeeeesaeeeeseaeeeeecaaeessecseeeessueeeesneeeees 111 5 3 3 Message Trace Output 112 5 3 4 Specifying the Device Manager Server URL 112 5 3 5 Inputting Requests from XML Documents 112 5 3 6 Using the Message Trace File to Create XML Eiles 113 6 Troubleshooting 6 1 feele Ee e le 116 Acronyms and Abbreviations Contents 4 Figures Figure 3 1 Figure 3 2 Example of CLI Help for the AddLun Commande 15
115. i t i xmlcommand txt 5 3 6 Using the Message Trace File to Create XML Files When message tracing is turned on each execution of the application writes over the message tracing file with the request and response of that execution so that file never has more than one request and one response The request and the response are identified by labels Each label includes a timestamp The request also includes the HTTP header values set by the application The request is the same string that is streamed over HTTP to the server The response is the string read from the Device Manager server via HTTP before any parsing Therefore even if the application cannot make sense of the response or does not handle the response correctly the message trace contains a record of the response The following example shows how to download Device Manager CLI from the Device Manager server to a personal computer and then use the message trace log file to create XML files 1 Follow the instructions in section 1 5 to download a copy of Device Manager CLI from the Device Manager server to a PC 2 Onthe PC extract the downloaded files to C hdvm 3 Change the directory to hdvm cd hdvm 4 Edit the hdvmcli properties file to turn on message trace For example C Vhdvm gt type hdvmcli properties hdvmcli serverurl http 193 36 40 55 2001 service user system password manager messagetrace true Eg NOTE You need messagetrace true in orde
116. ialNumber 35001 svolArrayType HDS9970V svolDevNum 128 svolObjectID LU HDS9970V 35001 128 svolPoolID 1 fenceLevel Never replicationFunction Cont inuousAccess status 1 muNumber 1 copyTrackSize 14 splitTime 1 4 8 3 DeleteReplication DeleteReplication deletes copy pair information from a RAID Manager configuration definition file and releases the copy pair from the storage subsystem Users with access to this command Yes System Administrator Storage Administrator H No Guest Local Guest H Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Eg NOTE To delete a specific copy pair from a copy group you must specify pvolserialnum pvoldevnun svolserialnum or svolsequencenum and svoldevnum If you omit all of these parameters the system deletes all copy pairs in the specified copy group Table 4 80 DeleteReplication Command Parameters replicationgroupid Required Specify the copy group number Command Line Interface Commands 105 Table 4 80 DeleteReplication Command Parameters Parameter Name Status Description pvolserialnum Optional Specify the serial number of the storage subsystem that contains the primary volume P VOL pvoldevnum Optional Specify the device number of P VOL svolserialnum Optional Specify the serial number of the storage subsystem that contains the S VOL svolsequence
117. icationInfo obtains the information about replication performed by one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator D No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 31 GetStorageArray subtarget Replicationlnfo Command Parameters Parameter Name Status Description subsystems become the target model Optional Model of the storage subsystem When you omit this parameter all the storage storage subsystems become the target serialnum Optional Serial number of the storage subsystem When you omit this parameter all the subtarget Required Specify ReplicationInfo objectid Optional Object ID of the replication information to be returned When you omit this parameter you will obtain all the replication information you can specify replicationsubinfo Optional Specific replication information to be returned LogicalUnit is the only value that Command execution example In this example the CLI command obtains information about the replication performed by a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray ReplicationInfo log subtarget ReplicationInfo model XP1024 serialnum 10001 replicationsubinfo LogicalUnit Command execution result Command Line Interface Comm
118. inuousAccessVolumeType Simplex businessCopyVolumeType Simplex snapshotVolumeType Simplex journalVolumeType Simplex sysVolFlag 0 externalVolume 0 differentialManagement 0 Command Line Interface Commands 58 4 3 15 ModifyPort ModifyPort will change port and host storage domain attributes Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest Format for the StorageWorks XP12000 XP10000 hdvmcli URL ModifyPort topology new port topology channelspeed 0 1 2 storage domain name option serialnum serial number model model port port number fibreaddr new fibre channel address for the port domain domain ID lunsec true false nickname new host hostmode new host mode for the port hostModeOption new host mode option list Format for the StorageWorks XP1024 XP128 hdvmcli URL ModifyPort topology new port topology channelspeed 0 1 2 storage domain name option serialnum serial number model model port port number fibreaddr new fibre channel address for the port domain domain ID lunsec true false nickname new host hostmode new host mode for the port Format for the StorageWorks XP512 XP48 hdvmeli URL ModifyPort topology new port topology lunsec true false option serialnum serial number model model port port nu
119. ion NOTE To operate a specific copy pair in a copy group you must specify all of the pvolserialnum pvoldevnum svolserialnum or svolsequencenum and svoldevnum parameters If you omit all of these parameters all the copy pairs in the copy group will be changed You can use this function in one of three ways The first method is adding a copy pair definition to an existing copy group that is specified in the RAID Manager configuration definition file by using the following command hdvmcli URL AddConfigFileForReplication option groupname copy group name pvolhostid host ID pvolinstancenum instance number svolhostid host ID svolinstancenum instance number pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolportid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction BusinessCopy ContinuousAccess ContinuousAccessExtension Sna pshot Command execution example 1 add pairs to the existing group in the configuration files hdvmcli AddConfigFileForReplication o D logs XP12000 AddConfigFileForReplication log groupname groupl pvolhostid 1 pvolinstancenum 11 svolhostid 1 svolinstancenum 12 pvolarraytype USP pvolserialnum 65010001 pvoldevnum 5 svolarraytype USP svolserialnum 65010012 svoldevnum 10 replicationfunction ContinuousAccess Command execution result 1 RESPONSE Command complet
120. ion result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 CommParameters elements An instance of CommParameters userID userPassword ipAddress2 172 16 50 2 ipAddress 172 16 50 1 An instance of StorageArray Attributes of StorageArray are omitted here List of 1 CommParameters elements An instance of CommParameters snmpWrCommunity public ipAddress 172 16 40 1 snmpRdCommunity public snmpPort 161 repeated for other StorageArray instances 4 4 Logical Group Commands When a group is created the Device Manager server generates an object ID In order to use a command that requires an object ID the ID must be known When a group is created the server returns the new group including the ID When all groups are retrieved with the Get LogicalGroup command the ID of all groups is provided For further information on logical group operations please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide 4 4 1 AddLogicalGroup AddLogicalGroup creates a new logical group which supports the organization and naming of related devices on the Device Manager server see Table 4 39 The new group is returned including the object ID Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator Command Line Interface Commands 63 D No G
121. ired Command execution example In this example the CLI command makes the following modifications to the host based information object ID HOSTINFO MY HOSTINFO XP1024 0 15 1 The newly connected storage subsystem is a storage subsystem serial number 10001 model XP1024 The host name is changed to MY HOSTINFO XP1024 The new IP address is 111 111 111 111 e E is the new mount point of the host file system H The LUN that is used is identified as follows port number 7 domain ID 0 device number 2 H The new WWN for the HBA is 11 33 55 77 99 BB DD FF The new file system name is oo and the new file system type is NTFS1 156 MB is secured for the new LUN and the new percentage of use is set to 50 of the LUN size hdvmcli ModifyHostInfo o D logs XP1024 ModifyHostInfo log objectid HOSTINFO MY HOSTINFO HDS9980V 0 15 1 model XP1024 serialnum 10001 hostname MY HOSTINFO XP1024 ipAddress 111 111 111 111 mountPoint E port 7 domain 0 devnum 2 portwwn 11 33 55 77 99 BB DD FF filetype NTFS1 filename oo size 156 percentused 50 Command execution result RESPONSE An instance of HostInfo object ID HOSTINFO MY HOSTINFO XP1024 0 15 1 name MY HOSTINFO XP1024 serialNumber 10001 arrayType HDS9980V ipAddress 111 111 111 111 mountPoint E portID 7 domainID 0 Command Line Interface Commands 92 scsiID 15 lun 2 devNum 2 osScsiBus 0 osScsiID 15 osLun
122. ired Device number of the path osscsibus Required Host SCSI bus number osscsiid Required Virtualized host SCSI ID oslun Required __ Virtualized host LUN Command Line Interface Commands 84 Table 4 62 AddHostInfo Command Parameters Parameter Name Status Description portwwn Optional Port WWN on the host bus adapter filetype Optional Type of the file System filename Optional Name of the file System size Optional LUN size in MB percentused Optional Percent of the LUN in use In this example the CLI command specifies the following information for the host that connects to a LUN device number 2 port number 7 domain ID 0 in a storage subsystem serial number 10001 model XP1024 H Host name MY HOSTINFO XP1024 H Host IP address 172 16 64 159 H Mount point c H File system type NTFS D File name C e SCSI bus number 0 Host LUN 1 e HBA WWN 11 22 33 44 55 66 77 88 e LUN size 10MB e LUN in use 10 Command execution example hdvmcli AddHostInfo o D logs XP1024 AddHostInfo log serialnum 10001 model XP1024 hostname MY HOSTINFO XP1024 ipaddress 172 16 64 159 mountpoint C port 7 domain 0 devnum 2 osscsibus 0 osscsiid 15 oslun 1 portwwn 11 22 33 44 55 66 77 88 filetype NTFS filename C size 10 percentused 10 Command execution result RESPONSE An instance of HostInfo objectID HOSTINFO MY HOSTINFO XP1024 0 15 1 name MY HOSTINFO
123. ired by a CLI command Device Manager CLI terminates and the following error message is displayed Exception in thread main java lang OutOfMemoryError lt lt no stack trace available gt gt Supported Platforms e Microsoft Windows XP Service Pack 1 and 2 e Microsoft Windows 2000 Service Pack 3 or later e Microsoft Windows Server 2003 no Service Pack or Service Pack 1 32 bit version only e Sun Solaris 8 or 9 SPARC platform only HP UX 11i v1 and v2 2 2 Launching CLI The URL of the Device Manager server must be specified either on the command line or in the properties files described below The URL must include the following items Http protocol http or https see section 2 3 for https requirements Host name or IP address of the Device Manager server Setting Up Command Line Interface 12 Port number of the Device Manager server default is 2001 Base address of the Device Manager server default is service unless the server has been configured with a non standard servlet alias E NOTE When the CLI properties file has an option with no arguments you cannot cancel the option from the command line To launch Device Manager CLI execute the following command from Device Manager CLI installation directory Z In Windows C Vhdvm gt hdvmeli bat In Solaris or HP UX hdvmcli sh NOTE This assumes that Device Manager CLI was installed in the c ndvm folder Eg NOTE If
124. is available only to users of the StorageWorks XP512 XP48 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 56 DeleteWWNForLun Command Parameters Parameter Name Status Description serialnum Required Serial number of the port s storage array model Required Model of the porte storage array port Required Port number domain Required Domain ID of the path devnum Required Device number used to identify the path wwn Required Comma separated list of WWNs for which path security is to be removed Command execution example hdvmcli DeleteWwnForLun o D logs XP512 AddWwnForLun log serialnum 10001 model XP512 port 16 devnum 16 domain 0 wwn 11 55 77 99 33 00 22 66 Command execution result RESPONSE Command completed no data returned 4 5 12 DeleteWWNForLunGroup DeleteWWNForLunGroup removes one or more WWN s from a LUN group XP512 XP48 subsystem only see Table 4 57 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Restricted to permitted resources Local
125. isanmu sinnkmet budt EEN added 34 4 3 11 GetArrayReservation arnnrnnrnnvrnnnrnnnnnnrnnnnnnnrnnnnnnn rn varenr nnnnnrnnnnnenrnnnnnenrnnnnnnrnnnnnenrnnnnnenrnnennernnnnn 35 4 3 12 GetG ioragehrtay rn renn raner rn nnenrn nn nnnrnnnnnnnrnnnnnnnrnnnnnnrrnnnnenrnnnnnennnn 35 4 3 13 ModifyArrayReservatlon 4ciuiimiss idmmimimsme NEE EENS EENS EEN 57 4 3 14 ModifyLogicalUnit cccccccceeeeeceeeeeeeeeeeeceeeeeeeeaeeeeeeeaeeceeeaaeeceeaeeeeseaeeeseeeeeeseeaeeeeeseaeeeessseeeessaees 57 4 3 15 MOGifyPoft A 59 4 3 16 Modify PortGontrolle risen ccccsendsecscnsdiiectedeecstenscesayGaccoce viens st bageaden Ee SEENEN EES 62 4 3 17 RefreshStorageArrays rn nnnnr rn nnnr rn renn nn noen rann nnnrnnnnnnnrnnnnnerrnnnnnnrrnnnnnnrnnnnnnnnnn 62 4 4 Logical Group Commands aisect Edel 63 4 4 1 AddL gIEAIGPIP EE 63 4 4 2 AddEUnSean EE 65 4 4 3 AddObjectForlogical Group EE 65 4 4 4 Deleiel ogoicaltGroup tennent nn stennet enesenn nennen e ne 66 4 4 5 DeleieCbiectt or ogicalt roup nn neennn nne ne 66 4 4 6 GetLogicalGroup PEPE A E E EA E E E EE E A E 67 4 4 7 Modtfvl ogicaltzroup E 69 4 5 LUN Go mmands suis smsvsitmsmsidn en soneagesdetagasdcuengeniedongae Sewenue tac Pecwelacpagceigaaegdeleagagdh E eaaa a E EEEa 69 4 5 1 Fo EE 69 4 5 2 el BET eee eee E SE ee 73 4 5 3 AddWWNForHostStorageDomain issciisiiiiiinnicniiienii icena i eieren iaai 74 4 5 4 AdAWWNFOTLUN WEE 75 4 5 5 AddWWNForLunGroup 2 ccceeeeceeeeeecceeeeeeaeeeee
126. it them when you execute Device Manager CLI D To specify an option use the long option name as the key for example messaget race instead of t and use the option value as the property value H To always output the command execution results you can set the output option corresponding to the property as output redirect out instead of entering the following at the command prompt C Vhdvm gt hdvmeli http localhost 2001 service GetStorageArray output redirect out serialnum 30051 model XP512 E NOTE You must always enter the user option and password option at the command prompt or specify them in the properties file e Whenever an option is specified both from the command line and from the properties file the value from the command line is used To specify options that have no parameters from the properties file set the option to true for example messagetrace true Table 5 1 shows an example of the properties file in Windows Table 5 1 Example of the Properties File in Windows FEFE HE HEHEHE FE HE HE TEHE FE HE HE EHE FE HE HEHEHE H H H HEH H H H HH HH Device Manager Command Line Interface CLI Properties File Can be used to provide options and default parameters for the Device Manager CLI program The Device Manager CLI program does not require any of the properties to be set Location for the diagnostics file default when not specified is hdvmcli log in the executing directory h
127. lable value is LogicalUnit lusubinfo Optional Information about a logical unit You can specify Path or LDEV as the value of this parameter When specifying this parameter you must also specify the arraygroupsubinfo parameter Command execution example 1 In this example the CLI command obtains information about all the array groups in a storage subsystem serial number 14010 model XP12000 hdvmcli GetStorageArray o D logs XP12000 GetStorageArray ArrayGroup log subtarget ArrayGroup model XP12000 serialnum 14010 Command execution result 1 RESPONSE chassis 1 number 0 An instance of StorageArray Attributes of StorageArray are omitted here List of 20 ArrayGroup elements An instance of ArrayGroup object ID ARRAYGROUP USP 14010 1 0 displayName 1 1 1 raidType RAID5 3D 1P em lat ion OPEN 3 diskType DKR2D J072FC diskSize 72 diskSizeInKB 149 225 472 controllerID 1 totalCapacity 203 925 600 allocatedCapacity 203 925 600 freeCapacity 0 autoLunCapacity 0 onDemandCapacity 0 totalFreeSpace 9 126 144 largestFreeSpace 9 126 144 substance 0 slprNumber 1 clprNumber 1 cuInfo openTotalCapacity 203 925 600 openAllocatedCapacity 203 925 600 openFreeCapacity 0 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAllocatedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 Command Line Interf
128. linstancenum instance number pvolportnum port number svolhostid host ID svolinstancenum instance number svolportnum port number pvolarraytype model pvolserialnum serial number pvoldevnum device number pvolportid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction BusinessCopy Cont inuousAccess ContinuousAccessExtension Snapshot Command execution example 3 create configuration files and a group and then add pairs to the group hdvmcli AddConfigFileForReplication o D logs XP1024 AddConfigFileForReplication log pvolhostid 5 pvolinstancenum 15 pvolportnum 50001 svolhostid 4 svolinstancenum 15 svolportnum 50002 pvolarraytype HDS9980V pvolserialnum 15001 pvoldevnum 11 svolarraytype HDS9970V svolserialnum 35001 svoldevnum 128 replicationfunction ContinuousAccess Command execution result 3 RESPONSE Command completed no data returned 4 8 2 AddReplication AddReplication creates copy pairs for Business Copy XP Continuous Access XP Continuous Access XP Extension and Snapshot XP When you create a copy pair the Continuous Access XP configuration definition file for RAID Manager contained in the host is rewritten Continuous Access XP Extension can be used in the StorageWorks XP Disk Array Snapshot XP can be used for StorageWorks XP12000 XP10000 Before using Snapshot XP create a V VOL and
129. lnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Optional Element of the storage subsystem The command acquires the information about the specified element You can specify the following values ArrayGroup Commparameters Component Filter FreeSpace HostStorageDomain LDEV LogicalUnit Path PDEV Port PortController and ReplicationInfo You can add parameters according to the specified element value Command Line Interface Commands 35 Command execution example In this example the CLI command obtains information about the configuration of all the storage subsystems managed by the Device Manager server hdvmcli GetStorageArray Command execution result RESPONSE An instance of StorageArray object ID ARRAY HDS9960 10011 name XP512 10 208 114 140 description XP512 10011 at 10 208 114 140 serialNumber 10011 arrayFamily HDS9900 arrayType HDS9960 microcodeVersion 01 13 56 00 agentVersion 02 01 06 00 productName XP512 controllerVersion 01 18 01 00 00 numberOfControllers 1 capacityInGB 1 326 cacheInMB 7 168 sharedMemoryInMB 1 numberOfSpareDrives 1 freeCapacityInGB 701 allocatedCapacityInGB 624 autoLunCapacityInGB 0 onDemandCapacityInGB 0 totalFreeSpaceInGB 124 largest FreeSpaceInGB 63 capacityInKB 1 390 713 840 freeCapacityInKB 735 710 400 allocatedCapacityInKB 655 003 440 autoLunCapacityInKB 0
130. logs AddLogicalGroup log groupname toro iconfile groupl2 gif Command execution result 1 RESPONSE An instance of LogicalGroup object ID GROUP 2 name toro logicalPath toro icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 Command execution example 2 hdvmcli AddLogicalGroup o D logs AddLogicalGroup log groupname toro iconfile groupl2 gif parent GROUP 0 Command execution result 2 RESPONSE An instance of LogicalGroup objectID GROUP 1 name toro logicalPath root toro parent ID GROUP 0 icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 Command Line Interface Commands 64 4 4 2 AddLunScan AddLunScan scans a storage array for LUNs not assigned to a logical group see Table 4 40 It assigns those LUNs to subgroups of the LUN Scan group according to port and security AddLunScan creates those subgroups as necessary returning the specified storage array and each of the previously unassigned LUNs Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest Table 4 40 AddLunScan Command Parameters Parameter Name Required Description serialnum Serial number of the storage array to scan model Required Model of the storage array to scan Command
131. lumeType 3 diskType 1 clprNumber 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 4 3 5 AddStorageArray AddStorageArray performs a search for storage arrays populating the Device Manager database with the identified device elements and refreshing information see Table 4 12 Users with access to this command Command Line Interface Commands 30 Yes System Administrator Storage Administrator H No Guest Local Guest e Restricted A Local System Administrator or Local Storage Administrator can use this command only when updating the registered information E NOTE When you are performing this command do not shut down the hosts that are using storage subsystem volumes or the host for the Device Manager agent or execution might take longer Format for StorageWorks XP12000 XP10000 and StorageWorks XP1024 XP128 hdvmcli URL AddStorageArray options ipaddress IP address family array family displayfamily array family to be displayed userid user name arraypasswd user password Format for StorageWorks XP512 XP48 hdvmcli URL AddStorageArray options ipaddress IP address family array family displayfamily array family to be displayed searchcommunity searchcommunity Table 4 12 AddStorageArray Command Parameters Parameter Name Status Description arraypasswd Optional User password for array access XP12000 XP10000 For StorageWorks XP12000
132. m 0 ldevsubinfo VolumeConnection ldevfilter open Command execution result Command Line Interface Commands 46 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1756 Ldev elements An instance of LDEV object ID LDEV USP 10001 0 devNum 0 displayName 0 00 emulation OPEN 3 cylinders 0 isComposite 0 sizeInKB 2 403 360 lba 1 201 680 raidType RAID5 3D 1P slotSizeInKB 48 chassis 1 arrayGroup 0 path true onDemandDevice false devType isStandardLDEV true guardMode substance 1 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 List of 1 VolumeConnection elements An instance of VolumeConnection objectid VOLCONN USP 10001 0 mappedArrayType USP mappedSerialNumber 10001 mappedDevNum 0 externalArrayType HDS9960 externalSerialNumber 10002 externalDevNum 150 externalVolumeName 0096 productName 1024 vendor HP repeated for other LDEV instances 4 3 12 8 GetStorageArray subtarget LogicalUnit GetStorageArray subtarget LogicalUnit obtains the information about a logical unit in a storage subsystem Users with access to this command Yes System Administrator Storage Administrator H No None e Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 26 GetStorageArray subtarget LogicalUnit Comman
133. m Administrator Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Command execution example hdvmcli GetServerInfo o D logs GetServerInfo log Command execution result RESPONSE An instance of ServerInfo buildVersion Build 0430 00 Jun 26 2005 serverURL http localhost 2001 upTime 7 minutes 55 seconds upSince Mon 1 Jul 2005 06 07 01 GMT currentApiVersion 4 3 List of 3 StorageArray elements An instance of StorageArray arrayFamily HDS9900 displayArrayFamily XP512 48 An instance of StorageArray arrayFamily HDS9900V displayArrayFamily XP1024 128 An instance of StorageArray arrayFamily USP displayArrayFamily XP12K 10K 4 7 8 GetURLLink GetURLLink gets any or all URLLink objects in the Device Manager server see Table 4 75 Command Line Interface Commands 96 Table 4 75 GetURLLink Command Parameters Parameter Name Status Description objectid Optional The object ID of the URLLink object to be returned You can omit this parameter when using the 1inkedid parameter to return all URLLink objects do not use the 1inkedid parameter with the objectid parameter linkedid Optional The object ID of the linked object All links to this object are returned You can omit this parameter when using the object id parameter to return all URLLink objects do not use the
134. mand Line Interface Commands 25 Eg NOTE For the StorageWorks XP 12000 XP 10000 and XP1024 XP128 when AddHostStorageDomain adds a host storage domain the LUN security of the target port is automatically enabled Table 4 9 AddHostStorageDomain Command Parameters Parameter Name domain Status Required Description DomainID of the host storage domain NOTE For StorageWorks XP12000 XP10000 1 to 254 For StorageWorks XP1024 XP128 1 to 127 All Others 1 to 511 The specifiable values vary depending on the storage subsystem hostmode Optional StorageWorks XP12000 XP10000 and XP1024 XP128 New host connect mode of the Host Storage Domain normally Standard For the StorageWorks XP12000 XP10000 you can specify the following values Standard Sequent HP Solaris Netware Windows Windows Extension Tru64 HI UX AIX OPEN VMS The following value relies on the DKC microcode version For 50 03 0X XX XX or later UVM For the StorageWorks XP1024 XP128 you can specify the following values Standard Sequent HP Solaris Netware Windows Windows Extension Tru64 HI UX AIX OPEN VMS The following value relies on the DKC microcode version For 21 05 00 XX XX or later Windows Extension Solaris Extension For 21 14 02 XX XXor later Standard Extension2 HP Extension2 Solaris Extension2 Windows Extension2 hostModeOption Optional StorageWorks XP12000 XP10000 only An option of the host co
135. mber fibreaddr new fibre channel address for the port domain domain ID hostmode new host mode for the port Table 4 34 ModifyPort Command Parameters Parameter Name Status Description serialnum Required Serial number of the port s storage array model Required Model of the port s storage array port Required Number of the port topology Optional New topology value for the port Possible values are as follows Fabric on FC AL Fabric off FC AL Fabric on Point to Point Fabric off Point to Point fibreaddr Optional New fibre channel address for the port the hex string representation channelspeed Optional New transmission speed of a fiber channel for the port XP12000 XP10000 and For StorageWorks XP12000 XP10000 and XP1024 XP128 you can XP1024 XP128 only specify the following values 0 automatic 1 1 Gb s 2 2 Gb s lunsec Optional New setting for LUN security enabled either true or false domain Optional DomainID of the Host Storage Domain please refer to the notes nickname Optional Specify the nickname of the host storage domain When you specify XP12000 XP10000 and this parameter you must also specify the domain parameter XP1024 XP128 The maximum number of characters that can be used for a nickname is as follows StorageWorks XP12000 XP10000 16 bytes DKC microcode version 50 04 01 or later 32 bytes StorageWorks XP1024 128 8 bytes Command Line Interfa
136. mple hdvmcli DeleteLUSE o D logs XP1024 DeleteLUSE log serialnum 10001 model XP1024 devnum 209 Command execution result RESPONSE Command completed empty list returned 4 3 10 DeleteStorageArray DeleteStorageArray removes a HP StorageWorks Disk Array from the Device Manager management target but does not attempt to change the configuration of any storage device see Table 4 17 Users with access to this command Yes System Administrator Storage Administrator Table 4 17 AddStorageArray Command Parameters No Guest Local System Administrator Local Storage Administrator Local Guest Parameter Name serialnum Required Serial number of the storage array to be deleted model Required Model of the storage array to be deleted Command execution example Command Line Interface Commands 34 4 3 11 hdvmcli DeleteStorageArray o D logs XP1024 DeleteStorageArray log serialnum 10001 model XP1024 Command execution result RESPONSE Command completed no data returned GetArrayReservation GetArrayReservation obtains information about a locked storage subsystem This command does not have parameters Users with access to this command Yes System Administrator Storage Administrator No Local System Administrator Local Storage Administrator Guest Local Guest NOTE A Local System Administrator or Local Storage Administrator can ob
137. n and utilization of the attached storage and sends this information to the Device Manager server For further information on the Device Manager agent please refer to the HP StorageWorks XP Advanced Edition Device Manager Agent Installation Guide The Device Manager agent and the Device Manager server can be installed on the same host machine 1 3 Command View XP AE Suite Common Component Command View XP AE Suite Common Component is a package of features that are used by all Command View XP AE Suite software It is installed as part of the Device Manager installation Each Command View XP AE Suite software bundles Command View XP AE Suite Common Component to use the following functions e Single Sign On e Integrated logging and repository e Common Web Service 1 4 Related Software Products Hitachi Dynamic Link Manager HDLM for Sun Solaris and Hitachi Dynamic Link Manager for IBM AIX from 3 0 to 5 6 manage the storage access paths to and from the host on which it is installed The HDLM GUI for Sun Solaris and HDLM GUI for IBM AIX can be displayed from Device Manager Web Client RAID Manager XP is installed on a host and manages StorageWorks XP Disk Array subsystems from a command line RAID Manager XP tasks include collecting information about storage pair configurations and reporting the information to the Device Manager server Continuous Access XP can create a replica of one or more volumes in a remote subsystem
138. new WWNs none that pre exist on the port can be added Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations NOTE AddWWNForLunGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 50 AddWWNForLunGroup Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array in which the LUN group exists model Required Model of the storage array in which the LUN group exists port Required Port number of the LUN group objectid Required Object ID of the LUN group wwn Required Comma separated list of WWNs to secure the LUN group Command execution example hdvmcli AddWWNForLunGroup o D logs XP512 AddWWNForLUNGroup log serialnum 10001 model XP512 port 19 objectid LUNGROUP HDS9960 10001 19 hp wwn 11 55 77 99 33 00 22 66 AA AA AA AA AA AA AA AA Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port Attributes of Port are omitted here List of 1 LUNGroup elements An instance of LUNGroup objectID LUNGROUP HDS9960 10001 0 19 hp name hp nickname hp
139. next page DeleteLUSE AddReplication DeleteReplication ModifyReplication AddConfigFileForReplication GetReplicationControllerPair AddArrayReservation ModifyArrayReservation DeleteArrayReservation GetArrayReservation FOR COMMAND SPECIFIC HELP TYPE hdvmcli help server command AVAILABLE OPTIONS u userid or user userid login user ID for Device Manager Server p password or password password login password for Device Manager Server s or secure presence indicates secure connection https i filename or input filename take input from the specified file which must contain the complete xml request o filename or output filename send output to the specified file instead of the console t or messagetrace record raw XML request and response in MessageTrace log file SPECIFYING PARAMETERS Specify parameters for a command using name value pairs like serialnum 30051 Use the command specific help to see the parameters for a given command Figure 3 2 CLI Help continued 3 4 Guidelines for Executing CLI commands Table 3 3 lists some procedures to use when you execute Device Manager CLI command Table 3 3 Notes on Executing CLI Commands Item Description Related Commands Adding a LUN or host Be sure to stop host I O to the corresponding port AddLun storage domain before setting up security for a LUN or host storage AddHostStorageDomain for StorageWorks domain Ot
140. nnection mode To specify two or more options separate them with semicolons For details about the values that you can specify see Table 4 36 model Required Model of the storage array for the Host Storage Domain port Required Port ID of the Host Storage Domain a specific array must be specified by serial number and model name Optional Name of the Host Storage Domain Command Line Interface Commands 26 Table 4 9 AddHostStorageDomain Command Parameters Parameter Name Status Description nickname Optional Nickname of the Host Storage Domain StorageWorks XP12000 XP10000 The maximum number of characters that can be used for a nickname is as and XP1024 XP128 follows StorageWorks XP12000 XP10000 16 bytes DKC microcode version 50 04 01 or later 32 bytes StorageWorks XP1024 128 8 bytes serialnum Required Serial number of the storage array for the Host Storage Domain Command execution example hdvmcli AddHostStorageDomain o D logs XP12000 AddHostStorageDomain log serialnum 11111 model XP12000 port 16 domain 1 hostmodeoption 2 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 HostStorageDomain elements An instance of HostStorageDomain object ID HSDOMAIN USP 11111 16 1 portID 16 domainID 1 hostMode Standard hostModeOption 2 displayName CL1 E 1
141. nrnnnnnenrnnnnnnrnnnnnenrnnnnnennnnnneertnnnn 12 2 2 Launching C E E 12 2 3 Using CEP With HTTPS EE 13 3 Command Line Interface Syntax and Parameters 3 1 Command Line Syntax cccccecccceeeeceeeeeeeeeeeeeeeeeeeccaceeeeeaeeeeeeaeeesecaeeeeeecaeeeseeaeeseesaeeesesaeeseeneaeeeeseeaeeees 14 32 CLI Return Responses una kuaunusemnnske icagade eng ee apeo ana linac agit dansa annet SES Eegen de 15 323 Displaying CL AGI EEN 15 3 4 Guidelines for Executing CLI commands rrnrrrrrnnrrnnrrnnrnnnnnnrrnnnnnnrrnnnnen rn nnnerrn nn nnnrnnnnnenrnnnnnnnrnnnnnnrnnnnnennnn 17 4 Command Line Interface Commands 4 1 Extracting Parameter Values ttt ttttt ttt ntu ttt EEEE EAE EEEE EEE EEEA EEEE EEEE Eneee EEEE n annene EEEE 19 4 2 Supported CLI Commandes ettr nntb t raner nn EESE EES SEENEN EESSNEEEEEEEEE EEEn SEEE nnee nnee Ena 21 4 3 Storage Array Gommandsi imusasrmigssnissnr EES ender Ee 24 4 3 1 AddArrayReservation snnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnrnnnnnnnnnnnrnnnnnrnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 24 4 3 2 AddostGiorzgetiomain nn nnnrnnnnnnnrnnnnnnnrnnnnnnrnnnnnenrnnnnernnnnnnnrnnnnnnnrnnnnenrnnnnnrnnnn 25 4 3 3 Lee eye or 1 8 a LEE 27 4 3 4 Velo RULES ET 29 4 3 5 AddStorageArray EE 30 4 3 6 Deler yROS CIV AU eier esbeeekeegebrbeeegeeer eebe eege eege esgeeegeggegegegeh 32 4 3 7 DeleteHostStorageDomain sner 33 4 3 8 DeleteLogicalUnit een 33 4 3 9 Delete SE EEE ER EE EE TE 34 4 3 10 DeleteStorageArray iu urmuan
142. num Optional Specify the sequence number of the storage subsystem that contains the S VOL svoldevnum Optional Specify the device number of S VOL Command execution example 1 This example deletes a copy pair for Continuous Access XP that has been defined in copy group 8 The primary volume P VOL is the LDEV number 10 serial number 65010001 The secondary volume S VOL is LDEV number 11 sequence number 0012 The execution result displays the remaining copy pairs after deleting the specified copy pair hdvmcli DeleteReplication o D logs XP1024 DeleteReplication log replicationgroupid 8 pvolserialnum 65010001 pvoldevnum 10 svolsequencenum 0012 svoldevnum 11 Command execution result 1 RESPONSE An instance of ReplicationGroup object ID REPGROUP 7 replicationGroupID 7 groupName HCMD CG0007 pvolHostID 1 pvolInstanceNumber 11 pvolPortNumber 50 001 svolHostID 2 svolInstanceNumber 12 svolPortNumber 50 002 replicationFunction ContinuousAccess fenceLevel Never copyTrackSize 15 List of 1 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 65010001 12 0012 25 pairName HCMD CP0004 pvolSerialNumber 65010001 pvolArrayType HDS9980V pvolDevNum 12 pvolObjectID LU HDS9980V 65010001 12 pvolPoolID 1 svolSerialNumber 65010012 svolArrayType HDS9980V svolDevNum 25 svolObjectID LU HDS9980V 65010012 25 svolPoolID 1 fenceLevel Never replicationFunction C
143. ocal Storage Administrator do not have access range limitations E NOTE DeleteWWNGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 58 DeleteWWNGroup Command Parameters Parameter Name Status Description serialnum Required Serial number of the port s storage array model Required Model of the port s storage array port Required Port number wwngroup Required Nickname of the WWN group to be deleted from the port Command execution example hdvmcli DeleteWwnGroup o D logs XP512 DeleteWwnGroup log serialnum 10011 model XP512 port 19 wwngroup WG Command execution result RESPONSE Command completed no data returned 4 5 14 ModifyLunGroup Modi fyLunGroup modifies a LUN group assigned to a port of the target storage array XP512 XP48 subsystem only and adds paths in the LUN group see Table 4 59 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Command Line Interface Commands 81 E NOTE ModifyLunGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 59 ModifyLunGroup Command Parameters Parameter Name Status Description serialnum Requir
144. odel and serialnum parameters and LUNGroup for the portsubinfo parameter Use the object ID value that appears under An instance of LUNGroup lusedevnums Execute the GetStorageArray subtarget LDEV command Use the devNum value of the LDEV for which path false and onDemandDevice false Be sure that the LDEVs have the same emulation sizeInkB and raidType attributes specifying them in the form of a comma delimited list mastercontrollerid Execute the GetReplicationControllerPair command without specifying any parameters and then obtain the value from the execution result masterserialnum Execute the GetReplicationControllerPair command without specifying any parameters and then obtain the value from the execution result model Execute the Get StorageArray command Use the displayArrayType value that appears under An instance of StorageArray nickname Execute the GetStorageArray subtarget Port command specifying only the model and serialnum parameters Port for the subtarget parameter and Host StorageDomain for the portsubinfo parameter The nickname value is displayed under An instance of HostStorageDomain objectid Execute the Get StorageArray command setting the subtarget corresponding to the desired component and then obtain the value from the execution result pdevid Execute the GetStorageArray subtarget PDEV command specifying only the model and serialnum parameters and PDEV for t
145. of WWNs ipaddress Optional IP address of the new host Command execution example hdvmcli AddHost o D logs AddHost log hostname toro2 wwnlist AA CC CC CC CC CC CC CC 00 CC CC CC CC CC CC CC ipaddress 192 168 32 63 Command execution result RESPONSE An instance of Host object ID HOST 279 name toro2 ipAddress 192 168 32 63 capacityInKB 0 hostType 1 4 6 2 AddHostinfo AddHost Info adds host based information on a LUN information on storage used by hosts see Table 4 62 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations E NOTE A Local System Administrator and Local Storage Administrator can specify HostInfo for an operational host Table 4 62 AddHostInfo Command Parameters Parameter Name Status Description serialnum Required Serial number of the path s storage array model Required Model of the path s storage array hostname Required Name of the host ipaddress Optional IP address of the host mountpoint Optional Mount point on the host file system corresponding to the path port Required Port that the path is on domain Required Domain ID of the path devnum Requ
146. om 1 to 65535 NOTE Ifthe replicationgroupid or svolinstancenum parameter is specified this parameter is ignored pvolarraytype Required Specify the model of the storage subsystem that contains P VOL pvolserialnum Required Specify the serial number of the storage subsystem that contains P VOL pvoldevnum Required Specify the device number of P VOL pvolportid Optional Specify the port ID in the Continuous Access XP configuration file that manages P VOL paths svolarraytype Required Specify the model of the storage subsystem that contains S VOL svolserialnum Required Specify the serial number of the storage subsystem that contains S VOL svoldevnum Required Specify the device number of S VOL svolportid Optional Specify the port ID in the Continuous Access XP configuration file that manages S VOL paths Command Line Interface Commands 101 Table 4 78 AddReplication Command Parameters Parameter Name Status Description Specify the type of operation that is to be executed with the copy pair BusinessCopy Execute Business Copy XP Cont inuousAccess Execute Continuous Access XP Cont inuousAccessExtension Execute Continuous Access XP Extension Snapshot Execute Snapshot XP The default value is as follows e When P VOL and S VOL are located in the same storage subsystem BusinessCopy e When P VOL and S VOL are located in different
147. ommand execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 41 HostStorageDomain elements An instance of HostStorageDomain object ID HSDOMAIN HDS9980V 10001 0 0 portID 0 domainID 0 hostMode Standard displayName CL1 A 0 nickname 1A G00 List of 256 WWN elements An instance of WWN WWN 88 77 77 77 77 77 00 01 nickname Jane An instance of WWN WWN 88 77 77 77 77 77 00 02 nickname Jone repeated for other WWN instances List of 7 FreeLUN elements An instance of FreeLUN lun 9 Command Line Interface Commands 45 An instance of FreeLUN lun 10 repeated for other FreeLUN instances List of 249 Path elements An instance of Path object ID PATH HDS9980V 10001 7 0 10 devNum 10 portID 7 domainID 0 scsiID 15 LUN 10 wwnSecurityValidity true repeated for other Path instances An instance of HostStorageDomain repeated for other HostStorageDomain instances 4 3 12 7 GetStorageArray subtarget LDEV GetStorageArray subtarget LDEV obtains the information about an LDEV or LDEVs in one or all storage subsystems Users with access to this command Yes System Administrator Storage Administrator D No None H Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 25 GetStorageArray subtarget LDEV Command Parameters Parameter Name Status Description mo
148. onDemandCapacityInKB 0 totalFreeSpaceInKB 130 084 560 largestFreeSpaceInKB 67 096 800 multipathSupport 1 securityStatus 1 sequenceNumber 10011 displayArrayFamily XP512 48 displayArrayType XP512 numberOfLUs 626 numberOfAllocatedLUs 210 numberOfUnallocatedLUs 416 slprStatus 1 4 3 12 1 GetStorageArray subtarget ArrayGroup GetStorageArray subtarget ArrayGroup obtains information about one or all array groups in one or all storage subsystems Users with access to this command Yes System Administrator Storage Administrator D No None Restricted to permitted resources Guest Local System Administrator Local Storage Administrator Local Guest Table 4 19 GetStorageArray subtarget ArrayGroup Command Parameters Model of the storage subsystem When you omit this parameter you will obtain information about the models of all storage subsystems Command Line Interface Commands 36 Table 4 19 GetStorageArray subtarget ArrayGroup Command Parameters Parameter Name Status Description serialnum Optional Serial number of the storage subsystem When you omit this parameter all the storage subsystems become the target subtarget Required Specify ArrayGroup objectid Optional Object ID of the array group in a storage subsystem When you omit this parameter all the array groups become the target arraygroupsubinfo Optional Information obtained about an array group or groups The only avai
149. ontinuousAccess status 8 muNumber 1 copyTrackSize 15 splitTime 1 Command execution example 2 This example deletes copy group 7 and all copy pairs defined in this copy group hdvmcli DeleteReplication o D logs XP1024 DeleteReplication log replicationgroupid 7 Command execution result 2 Command Line Interface Commands 106 RESPONSE Command completed no data returned 4 8 4 GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair In the StorageWorks XP Disk Array the pairs indicate paths between MCUs and RCUs Users with access to this command Yes System Administrator Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 81 GetReplicationControllerPair Command Parameters Parameter Name Status Description masterserialnum Optional Specify the serial number of the storage subsystem that contains the main control unit MCU mastercontrollerid Optional Specify the CU number of the MCU remoteserialnum Optional Specify the serial number of the storage subsystem that contains the remote control unit RCU remotessid Optional Specify the SSID of the RCU Command execution example 1 This example obtains controller pair information for the MCU with CU number
150. ontrollerID devnum Execute the GetStorageArray subtarget LDEV command specifying only the model and serialnum parameters and LDEV for the subtarget parameter and then obtain the value from the execution result In the execution result of this command the devNum value appears in An instance of LogicalUnit domain Execute the GetStorageArray subtarget HostStorageDomain command specifying only the model and serialnum parameters and Host StorageDomain for the subtarget parameter Use the domainID value groupelements Execute the GetStorageArray subtarget Port portsubinfo Path command specifying only the model and serialnum parameters Port for the subtarget parameter and Path for the portsubinfo parameter Use the object ID value groupnum Execute the GetStorageArray subtarget ArrayGroup command specifying only the model and serialnum parameters and ArrayGroup for the subtarget parameter Use the number value Command Line Interface Commands 19 Table 4 1 Extracting Parameter Values To Find This Parameter Value lun Do This Execute the GetStorageArray subtarget HostStorageDomain hsdsubinfo freelun command specifying only the model and serialnum parameters Host StorageDomain for the subtarget parameter and freelun for the hsdsubinfo parameter Use one of the lun values lungroupid Execute the GetStorageArray subtarget Port portsubinfo LUNGroup command specifying only the m
151. ortid port number svolarraytype model svolserialnum serial number svoldevnum device number svolportid port number replicationfunction Command Line Interface Commands 103 BusinessCopy ContinuousAccess ContinuousAccessExtension Snapshot fencelevel fence level copytracksize copy pace Command execution example 2 This example creates a copy group in the existing RAID Manager configuration definition file and creates a copy pair for Business Copy XP For the primary volume P VOL specify the logical device LDEV 11 model number XP1024 and serial number 15001 The host that recognizes the primary volume has ID 1 and the Continuous Access XP instance number is 11 For the secondary volume S VOL specify the logical device LDEV 12 model number XP1024 and serial number 15001 The ID of the host that recognizes the secondary volume is 1 same as the primary volume and the Continuous Access XP instance number is 12 hdvmcli AddReplication o D logs XP1024 AddReplication log pvolhostid 1 pvolinstancenum 11 svolhostid 1 svolinstancenum 12 pvolarraytype HDS9980V pvolserialnum 15001 pvoldevnum 11 svolarraytype HDS9980V svolserialnum 15001 svoldevnum 12 Command execution result 2 The following shows the execution result of the above command RESPONSE An instance of ReplicationGroup object ID REPGROUP 1 replicationGroupID 1 groupName HCMD CG0001 pvolHostID 1 pvolInstanceNumber 11 pvolPortNum
152. pairName HCMD_CP0002 pvolSerialNumber 65010001 pvolArrayType HDS9570V pvolDevNum 101 pvolObjectID LU HDS9570V 65010001 101 pvolPoolID 1 svolArrayType HDS9570V svolSerialNumber 65010001 svolDevNum 102 svolObjectID LU HDS9570V 65010001 102 svolPoolID 1 replicationFunction BusinessCopy status 1 muNumber 0 copyTrackSize 15 splitTime 1 Command execution example 2 hdvmcli GetHost o D logs GetHost log Command execution result 2 RESPONSE An instance of Host object ID HOST 1 name toro2 Command Line Interface Commands 88 ipAddress 192 168 32 63 capacityInKB 0 hostType 1 List of 2 WWN elements An instance of WWN WWN 00 99 66 33 88 55 22 77 nickname Jane An instance of WWN WWN 11 44 77 22 55 88 33 66 nickname Jone List of 1 ConfigFile elements An instance of ConfigFile object ID CONFIGFILE 1 11 instanceNumber 11 controlledBy Device Manager portNumber 50 000 valid 1 List of 1 ReplicationGroup elements An instance of ReplicationGroup object ID REPGROUP 3 replicationGroupID 3 groupName HCMD CG0003 pvolHostID 1 pvolInstanceNumber 11 pvolPortNumber 50 000 svolHostID 3 svolInstanceNumber 12 svolPortNumber 50 001 replicationFunction BusinessCopy copyTrackSize 15 List of 2 ReplicationInfo elements An instance of ReplicationInfo objectID REPINFO 65010001 11 65010001 12 pairName HCMD CP0001 pvolSerialNumber 65010001 pvolArrayType HDS9570V pvolDevNum 11 pvolObjectID LU HDS9570
153. r to view the XML in the message trace log file 5 Copy hdvmcli CLI bat do bat This is so that rather than having to type hdvmc1i followed by the command each time you can just type do followed by the command 6 Atthe CLI prompt type the following command do getserverinfo You will see output similar to the following RESPONSE An instance of ServerInfo buildVersion Build 0430 00 Jun 26 2005 serverURL http 193 36 40 55 2001 Using the Device Manager Properties File 113 upTime 1 day 23 hours 35 minutes 27 seconds upSince Mon 5 Sep 2005 11 07 51 GMT currentApiVersion 4 3 List of 3 StorageArray elements An instance of StorageArray arrayFamily HDS9900 displayArrayFamily XP512 48 An instance of StorageArray arrayFamily HDS9900V displayArrayFamily XP1024 128 An instance of StorageArray arrayFamily USP displayArrayFamily XP12K 10K C Vhdvm gt EA NOTE The XML for this command is now in the MessageTrace log file E 8 9 View the contents of the MessageTrace log file The output will look similar to the following C hdvm gt more MessageTrace log gt gt gt Request Submitted at 12 46 07 CEST to http 193 36 40 55 2001 service Ser verAdmin HTTP Header User Agent HiCommandClient Accept Host 193 36 40 55 Content Type text xml Connection Keep Alive Authorization null Content Length 225 lt xml version 1 0 encoding UTF 8 gt lt HiCommandS
154. roup HostInfo Command execution result 1 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 554 Path elements An instance of Path objectID PATH HDS9980V 10001 0 0 0 devNum 0 portID 0 domainID 0 scsiID 15 LUN 0 wwnSecurityValidity true repeated for other Path instances An instance of Path objectID PATH HDS9980V 10001 7 0 99 devNum 99 portID 7 domainID 0 scsiID 15 LUN 99 wwnSecurityValidity true Command Line Interface Commands 50 List of 256 WWN elements An instance of WWN WWN 88 77 77 77 77 77 00 01 nickname Jane An instance of WWN WWN 88 77 77 77 77 77 00 02 nickname Jone repeated for other WWN instances Command execution example 2 objectid parameter specified In this example the CLI command obtains information about a path objectID PATH HDS9980V 10001 7 0 99 that is set for a storage subsystem serial number 10001 model XP1024 The information includes information about the WWNs of this path the WWN groups and the host hdvmcli GetStorageArray o D logs XP1024 GetStorageArray Path log subtarget Path model XP1024 serialnum 10001 objectid PATH HDS9980V 10001 7 0 99 pathsubinfo WWN WWNGroup HostInfo Command execution result 2 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Path elements An instance of Path object ID PATH HDS9980V 1000
155. s HP UX and Linux specify an integer from 1 to 65535 This parameter is invalid when the svolinstancenun is specified pvolarraytype Required Model of the storage subsystem that includes the P VOL Command Line Interface Commands 98 Table 4 77 AddConfigFileForReplication Command Parameters Parameter Name Status Description pvolserialnum Required Serial number of the storage subsystem that includes the P VOL pvoldevnum Required Device number of the P VOL pvolportid Optional Port number in the Continuous Access XP configuration file that manages the P VOL path svolarraytype Required Model of the storage subsystem that includes the S VOL svolserialnum Required Serial number of the storage subsystem that includes the S VOL svoldevnum Required Device number of the S VOL svolportid Optional Port number in the Continuous Access XP configuration file that manages the S VOL path replicationfunction Optional Type of copy used for the copy pair BusinessCopy Execute Business Copy XP Cont inuousAccess Execute Continuous Access XP Cont inuousAccessExtension Execute Continuous Access XP Extension Snapshot Execute Snapshot XP The default of this parameter differs depending on the condition as shown below e When the P VOL and S VOL exist in the same storage subsystem BusinessCopy e When the P VOL and S VOL exist in different storage subsystems Cont inuousAccessExtens
156. s 0 List of 3 GroupElement elements An instance of Host object ID HOST 1 name hit ipAddress 192 168 32 63 capacityInKB 0 hostType 1 An instance of HostStorageDomain object ID HSDOMAIN HDS9980V 10001 0 0 portID 0 domainID 0 hostMode HP displayName CL1 A 0 nickname 1A G00 An instance of Path objectID PATH HDS9980V 10001 0 0 101 devNum 101 port ID 0 domainID 0 scsiID 15 LUN 8 wwnSecurityValidity true Command execution example 3 hdvmcli GetLogicalGroup o D logs GetLogicalGroup log Command execution result 3 RESPONSE An instance of LogicalGroup object ID GROUP 1 name toro parent ID GROUP 0 logicalPath root toro Command Line Interface Commands 68 icon groupl2 gif capacity 0 capacityInKB 0 realCapacityInKB 0 percentUsed 0 numberOfLUNs 0 repeated for other LogicalGroup instances 4 4 7 ModifyLogicalGroup ModifyLogicalGroup changes one or more characteristics of an existing logical group see Table 4 45 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest Table 4 45 ModifyLogicalGroup Command Parameters Parameter Name Status Description objectid Required Object ID of the logical group to be modified groupname Optional New name for the specified logical group This must be either unique among groups within its parent or if not contain
157. s of the object ID the right most one is the ID of the PDEV When you omit this parameter you will obtain information about all the PDEVs The example below shows how an objectID of a PDEV appears in the execution result Example object ID PDEV HDS9980V 10001 5 The right most value is 5 Specify this value in the form pdevid 5 Command execution example In this example the CLI command obtains information about a PDEV PDEV number 1 belonging to an array group object ID ARRAYGROUP HDS9980V 10001 0 0 that is in a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray PDEV log subtarget PDEV model XP1024 serialnum 10001 pdevid 1 arraygroupobj id ARRAYGROUP HDS9980V 10001 0 0 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 80 PDEV elements An instance of PDEV object ID PDEV HDS9980V 10001 0 chassis 1 arrayGroup 0 capacityInKB 72 000 000 row 1 column 1 depth 1 model DKR2D J072FC dkuType HDS9900V rpm 1 diskType 1 repeated for other PDEV instances 4 3 12 11 GetStorageArray subtarget Port GetStorageArray subtarget Port obtains the information about a port in one or all storage subsystems Users with access to this command Yes System Administrator Storage Administrator No None Restricted to permitted resources
158. st then the equal sign and the parameter value as follows ipaddress 192 168 2 2 Whenever a parameter value requires one or more space characters double quotes can be used to enclose the parameter value as follows E NOTE When you are performing this command do not shut down the hosts that are using storage subsystem volumes or the host for the Device Manager agent or execution might take longer Command Line Interface Syntax and Parameters 14 description Our Newest Array Each command may have required parameters optional parameters or both and you can specify any parameter in the application s properties file If a parameter is specified both on the command line and in the properties file the value from the command line is used For more information on Device Manager properties please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Server Installation and Configuration Guide For more information on Device Manager client operations for example Web Client CLI third party applications please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide Device Manager CLI includes a help file To see the parameters associated with a particular command enter C Vhdvm gt hdvmcli help command name For example to display the output shown in Figure 3 1 enter C hdvm gt hdvmcli help AddLun COMMAND AddLun DESCRIPTION Defines a path from a ho
159. st one of the commanddevice and commanddevicesecurity commands Table 4 33 ModifyLogicalUnit Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array of the LU model Required Model of the storage array of the LU devnum Required Device number of the LU commanddevice Optional New setting for command device true commanddevice false commanddevice Specify true to set the specified LU as a command device and false to release the setting commanddevicesecurity Optional Security mode setting for the command device Specify true to enable security and false to disable it If you are using a StorageWorks XP512 XP48 and you specify this parameter you must also specify the commanddevice parameter Command execution example hdvmcli ModifyLogicalUnit o D logs XP1024 ModifyLogicalUnit log serialnum 10001 model XP1024 devnum 1 commanddevice true Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Lu elements An instance of LogicalUnit objectID LU HDS9980V 10001 1 devNum 1 displayName 0 01 emulation OPEN 3 devCount 1 devType CommandDevice capacityInKB 2 403 360 path true commandDevice true commandDeviceSecurity true chassis 1 arrayGroup 0 raidType RAID5 3D 1P currentPortController 1 default PortController 1 isComposite 0 cont
160. st to a volume PARAMETERS serialnum required Serial Number of the Storage Array of the new Path model required Model of the Storage Array of the new Path name optional Name of the new Path port required Port Number of the new Path domain required For USP 9900V XP12K 10K XP1024 128 9500V with LUNManagement AMS and WMS required others optional Domain Number of the new Path can not be set with parameter wwn together scsi optional SCSI ID of the new Path lun required Number of the actual LUN used for path devnum optional Device number used to identify this logical unit lusedevnums optional Comma separated list of LDEV devnums required for LUSE LUN definition wwn optional Except USP 9900V XP12K 10K XP1024 128 9500V with LUNManagement AMS and WMS Comma separated list of WWN to secure the path can not be set with parameter domain together Figure 3 1 Example of CLI Help for the AddLun Command 3 2 CLI Return Responses Device Manager CLI returns the execution result value at the end of its process Table 3 2 lists and describes the CLI return values Table 3 2 Return Values Return Values Description 1 Specified parameter not defined 0 CLI ends normally 1 CLI found errors within its process for example parameter error 2 CLI found errors in the Device Manager server 3 3 Displaying CLI Help If you want to display basic help information launch Device Manager
161. stStorageDomain Command Parametere 45 Table 4 25 GetStorageArray subtarget LDEV Command Parameters cccccccccsssssceeeeeesssssseeeeeeeessseeesssnnaeees 46 Table 4 26 GetStorageArray subtarget LogicalUnit Command Parameters ssseessseeessnneesrrnesrnrnessrrnnesrrneee 47 Table 4 27 GetStorageArray subtarget Path Command PDarameiers nnne nne 50 Table 4 28 GetStorageArray subtarget PDEV Command Parameters rrrrrnnrrnrannnvnvrnrrrrrrnnrrnnnnnvvvnnerrrrsnnnnnvnnnenrr 51 Table 4 29 GetStorageArray subtarget Port Command Parameter 52 Table 4 30 GetStorageArray subtarget PortController Command Parameter 54 Table 4 31 GetStorageArray subtarget ReplicationInfo Command Parameters snsssnnnnnnneeennnnnneneeeneeennnneenne 55 Table 4 32 ModifyArrayReservation Command Parameters rrnrrrrvnrrnrrannnnnrnnnvrvnrrrnrnnnnnnvvnnsrrrrnnnnnnnrnnerrrrsnnnnnvnnesern 57 Table 4 33 ModifyLogicalUnit Command Parameters rrrrrrrrrnnnnnnnrvnnrrrrrnnnnnvvrnrrrnnrrrsnnnnnnvrnnerrrrnnnnnnvnnnsssrrnnnnnnnnnsssnn 58 Table 4 34 ModifyPort Command Parameters rn nnnrrnnnnenrnnnnnenrnnnnnnrrnnnnenrrnnnnennnn 59 Table 4 35 HostMode Parameter Values StorageWorks XP Disk Array 60 Table 4 36 hostModeOption Parameter Values and Description 61 Table 4 37 ModifyPortController Command Parameiers nenne 62 Table 4 38 RefreshStorageArrays Command Parameters essseeessseeessteeertrnesertnrntrtrnntrtrntttnrntttnnnsrnnnnnn nennen
162. sysVolFlag 0 externalVolume 0 differentialManagement 0 List of 1 Ldev elements An instance of LDEV object ID LDEV HDS9980V 10001 176 devNum 176 displayName 0 B0 emulation OPEN 3 cylinders 0 isComposite 0 sizeInKB 1 000 080 lba 14 351 040 raidType RAID5 3D 1P slotSizeInKB 48 chassis 4 arrayGroup 32 Attributes of StorageArray are omitted here Command Line Interface Commands 28 path false onDemandDevice false devType isStandardLDEV false guardMode substance 0 volumeType 3 diskType 1 cacheResidencyMode 1 stripeSizeInKB 1 slprNumber 1 clprNumber 1 volumeKind 3 4 3 4 AddLUSE AddLUSE creates a LUSE without any path in the storage device see Table 4 11 Users with access to this command Yes System Administrator Storage Administrator e No Guest Local Guest Restricted to permitted resources Local System Administrator Local Storage Administrator E NOTE This function is not available for the StorageWorks XP512 XP48 Table 4 11 AddLUSE Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array from which LUSE is added model Required Model of the storage array from which the LUSE is added devnums Required Comma separated list of LDEV device numbers to create the LUSE Command execution example hdvmcli AddLUSE o D logs XP1024 AddLUSE log serialnum 15001 model XP1024 devnums 1001 1002
163. tHost GetHost returns the information about one or all host servers see Table 4 66 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator Local Storage Administrator Eg NOTE If you do not know the object ID of the required host you can obtain information about all the hosts by executing the GetHost command without specifying this parameter Table 4 66 GetHost Command Parameters Parameter Name Status Description objectid Optional Object ID of the host for which information is to be returned Omit this parameter to include all hosts configfileid Optional Object ID of the Continuous Access XP configuration definition file in the host If you omit this parameter the command acquires information about all Continuous Access XP configuration definition files contained in the host When you specify this parameter you must also specify the object id parameter replicationgroupid Optional ID of the copy group associated with the host ReplicationGroup When you specify this parameter you must specify the objectid and configfileid parameters Lee Command execution example 1 This example obtains the pair information defined in the CCI configuration definition file whose configFileID is CONFIGFILE 1 11 in the host whose obje
164. tain information about locked storage subsystems containing accessible LDEVs Command execution example hdvmcli GetArrayReservation o D logs GetArrayReservation log Command execution result An instance of ArrayReservation object ID ARRAYRESERVATION USP 14009 target ARRAY USP 14009 loginID dmuser beginTime 1 039 003 476 4 3 12 GetStorageArray Eg Eg GetStorageaArray returns information on the storage array NOTE To acquire information about a particular storage subsystem specify the model in the model parameter and the serial number in the serialnum parameter or this command returns information about all of the storage subsystems NOTE To acquire the information about a specific element or narrow down the range of information acquired by specifying conditions use the subtarget parameter For details about values that can be specified see Table 4 18 You can add parameters according to the value specified in subtarget However you cannot add any parameters when component or commparameters is specified Users with access to this command e Yes System Administrator Storage Administrator e No Guest Local System Administrator Local Storage Administrator Local Guest Table 4 18 GetStorageArray Command Parameters Parameter Name Status Description model Optional Model of the storage subsystem When you omit this parameter all the storage subsystems become the target seria
165. tance of StorageArray Attributes of StorageArray are omitted here List of 1 Path elements An instance of Path objectID PATH HDS9980V 10001 1 4 1006 name hp devNum 1 006 portID 1 domainID 4 sesiID 15 LUN 120 wwnSecurityValidity true 4 5 2 AddLunGroup AddLunGroup adds a LUN group to a port of the target storage array and adds paths to the LUN group see Table 4 47 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator D No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations NOTE AddLunGroup is supported by StorageWorks XP512 XP48 storage subsystems only Table 4 47 AddLunGroup Command Parameters Parameter Name Status Description serialnum Required Serial number of the target storage array to which the LUN group is added model Required Model of the target storage array to which the LUN group is added port Required Port number of the LUN group groupelements Required Comma separated list of one or more object IDs of the paths to be added to the LUN group nickname Required Unique nickname of the LUN group name Optional The name given to the LUN group Command execution example Command Line Interface Commands 73 hdvmcli AddLunGroup o D logs XP512 AddL
166. then refresh the storage subsystem information by using the refresh functionality When creating a copy pair specify AddReplication Users with access to this command Yes System Administrator Storage Administrator H No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Obtain the parameter values from the execution result of the GetHost command Specify the values provided as the execution result in the appropriate parameters Table 4 79 lists the items that are displayed by the GetHost command and their correspondence to the parameters of the AddReplication command Table 4 78 AddReplication Command Parameters Required Method 1 If you are using method 1 specify the copy group number NOTE Ifyou are using method 2 or 3 do not specify this parameter If you specify this parameter method 1 is applied replicationgroupid Command Line Interface Commands 100 Table 4 78 AddReplication Command Parameters Parameter Name groupname Status Optional Description Specify the group name used in the RAID Manager The maximum number of characters you can use to specify a group name is 31 The group name cannot begin with a number sign or a hyphen NOTE Ifthe replicationgroupid parameter is specified this parameter is ignored pvolhostid Required Method 2 or 3 If you are
167. this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Restricted to permitted resources Local System Administrator Local Storage Administrator Table 4 64 DeleteHost Command Parameters objectid Object ID of the host to be removed Command execution example hdvmcli DeleteHost o D logs DeleteHost log objectID HOST 1 Command execution result RESPONSE Command completed no data returned 4 6 5 DeleteHostinfo DeleteHost Info deletes a Hostlnfo instance from the Device Manager server see Table 4 65 Users with access to this command Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations NOTE A Local System Administrator and Local Storage Administrator can specify Host Info for a permitted host Command Line Interface Commands 86 Table 4 65 DeleteHostinfo Command Parameters Object ID of the HostInfo record to be removed Command execution example hdvmcli DeleteHostInfo o D logs XP1024 DeleteHostInfo log objectid HOSTINFO MY HOSTINFO XP1024 0 15 1 Command execution result RESPONSE Command completed no data returned 4 6 6 Ge
168. tion result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port Attributes of Port are omitted here List of 1 WWNGroup elements An instance of WWNGroup object ID WWNGROUP HDS9960 10001 0 19 hp nickname hp List of 2 WWN elements An instance of WWN WWN AA AA AA AA AA AA AA AA nickname Jane An instance of WWN WWN BB BB BB BB BB BB BB BB nickname Jone 4 6 Host Management Commands The following commands support the management of hosts and their Host Info records Host Info is the information about the storage that is used by hosts Although typically Device Manager agents produce HostInfo records they can be manually created by these commands Some commands require a host s server generated object ID For further information on host operations please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Web Client User Guide Command Line Interface Commands 83 4 6 1 AddHost AddHost adds information about a host server to the Device Manager server see Table 4 61 Users with access to this command Yes System Administrator Storage Administrator No Guest Local System Administrator Local Storage Administrator Local Guest Table 4 61 AddHost Command Parameters Parameter Name _ Status Description hostname Required Name of the new host wwnlist Optional Comma separated list
169. tted here List of 20 ArrayGroup elements An instance of ArrayGroup object ID ARRAYGROUP USP 14010 1 0 chassis 1 number 0 displayName 1 1 1 raidType RAID5 3D 1P em lat ion OPEN 3 diskType DKR2D J072FC diskSize 72 controllerID 1 totalCapacity 203 925 600 allocatedCapacity 203 925 600 freeCapacity 0 autoLunCapacity 0 onDemandCapacity 0 totalFreeSpace 9 126 144 largestFreeSpace 9 126 144 slprNumber 1 clprNumber 1 cuInfo openTotalCapacity 203 925 600 openAllocatedCapacity 203 925 600 openFreeCapacity 0 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAllocatedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 List of 1 FreeSpace elements An instance of FreeSpace objectID FREESPACE USP 14010 1 0 85 sizeInKB 9 126 144 cylinders 0 Command Line Interface Commands 43 fsControlIndex 85 repeated for other ArrayGroup instances Command execution example 2 In this example the CLI command obtains information about the free space in an array group objectID ARRAYGROUP HDS9980V 10001 1 16 that belongs to a storage subsystem serial number 10001 model XP1024 hdvmcli GetStorageArray o D logs XP1024 GetStorageArray FreeSpace log subtarget FreeSpace model XP1024 serialnum 10001 arraygroupobjid ARRAYGROUP HDS9980V 10001 1 16 Command e
170. uCluster to set up a cluster on both a Continuous Access XP primary and a secondary volume Command execution example In this example the CLI command modifies the settings for a port port number 16 of a storage subsystem serial number 10001 model XP1024 as follows The command changes the value for the hostmode parameter to Standara for the port s host storage domain domain ID 0 changes the topology to Fabric off FC AL sets the Fibre Channel address to 73 disables LUN security by specifying false sets the transmission speed of the Fibre Channel to 1 hdvmcli ModifyPort o D logs XP1024 ModifyPort log serialnum 10001 model XP1024 port 16 domain 0 hostmode Standard topology Fabric off FC AL fibreaddr 73 lunsec false channelspeed 1 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port objectID PORT HDS9980V 10001 16 portID 16 portType Fibre fibreAddress 73 topology Fabric off FC AL displayName CL2 A lunSecurityEnabled false controllerID 5 worldWidePortName 50 06 0E 80 03 3A 99 10 channelSpeed 1 slprNumber 1 portRole Target List of 1 HostStorageDomain elements An instance of HostStorageDomain Command Line Interface Commands 61 object ID HSDOMAIN HDS9980V 10001 16 0 portID 16 domainID 0 nickname HDvM1000 hostMode Standard 4 3 16 Modif
171. uest Local Guest Table 4 39 AddLogicalGroup Command Parameters Parameter Name Status Description groupname Required Name for the new logical group This must be unique among groups within its parent if the parent parameter is supplied or unique among top level groups if no parent is specified iconfile Required Name of the icon file that visually represents the new logical group The specified icons are displayed in the Web Client window The specifiable icon files are as follows group_0 gif group_1 gif group_2 gif group 3 gif group 4 gif group_5 gif group 6 gif group_7 gif group 8 gif group 9 gif group10 gif groupll gif group12 gif group13 gif group1l4 gif group15 gif group16 gif group17 gif group18 gif group19 gif group20 gif group21 gif group22 gif group23 gif group24 gif group25 gif group26 gif group27 gif group28 gif group29 gif group30 gif group31 gif group32 gif group_logical gif group plain gif group_storage gif group storage 1 gif group storage 2 gif group storage 3 gif group storage 4 gif world logical gif world storage gif NOTE Ifa specified icon file does not exist the group plain gif file is specified parent Optional Object ID of another logical group that contains this new group This must be the valid ID of a group and the parent must either contain other groups only or be empty BEE Command execution example 1 hdvmcli AddLogicalGroup o D
172. unGroup log serialnum 10001 model XP512 port 19 groupelements PATH HDS9960 10001 16 2 0 PATH HDS9960 10001 16 2 1 nickname hp name hp Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 Port elements An instance of Port Attributes of Port are omitted here List of 1 LUNGroup elements An instance of LUNGroup object ID LUNGROUP HDS9960 10001 0 19 hp name hp nickname hp List of 2 Path elements An instance of Path object ID PATH HDS9960 10001 16 2 0 devNum 0 portID 19 domainID 16 scsiID 15 LUN 8 wwnSecurityValidity true repeated for other Path instances 4 5 3 AddWWNForHostStorageDomain AddWWNForHostStorageDomain secures LUNs in a host storage domain by assigning one or more WWNs to it see Table 4 48 Users with access to this command e Yes System Administrator Storage Administrator Local System Administrator Local Storage Administrator e No Guest Local Guest e Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations EA NOTE When AddWWNForHostStorageDomain secures LUNs in a host storage domain LUN security is automatically enabled Table 4 48 AddWWNForHostStorageDomain Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage array for the Host Stora
173. up Command execution example In this example the CLI command obtains information about a port port number 7 in a subsystem serial number 10001 model XP512 including WWNs WWN groups LUN groups and the host storage domain hdvmcli GetStorageArray o D logs XP512 GetStorageArray Port log subtarget Port model XP512 serialnum 10001 port 7 portsubinfo WWN WWNGroup LUNGroup HostStorageDomain wwngroupsubinfo WWN Command execution result RESPONSE portID 0 An instance of StorageArray Attributes of StorageArray are omitted here List of 16 Port elements An instance of Port objectID PORT HDS9960 10001 0 portType Fibre fibreAddress EF topology Fabric off displayName CL1 A lunSecurityEnabled true controllerID 1 worldWidePortName 50 06 0E 80 03 3A 99 00 channelSpeed 1 slprNumber 1 portRole Target List of 2 WWN elements An instance of WWN WWN 00 00 00 00 00 00 00 01 nickname Jane An instance of WWN WWN 00 00 00 00 00 00 00 50 nickname Jone List of 2 HostStorageDomain elements An instance of HostStorageDomain object ID HSDOMAIN HDS9960 10001 0 0 portID 0 domainID 0 hostMode Standard displayName CL1 A 0 nickname 1A G00 An instance of HostStorageDomain object ID HSDOMAIN HDS9960 10001 0 1 portID 0 FC AL Command Line Interface Commands 53 domainID 1 hostMode Standard displayName CL1 A 1 nickname HCMD0000 List of 2 WWN elements An instance of WWN WWN 00 00 00 0
174. utput to the log file Specify the log level as follows Debugging hdvmcli diaglevel DEBUG e Information hdvmcli diaglevel INFO e Warnings hdvmeli diaglevel WARN H Errors hdvmcli diaglevel ERROR E NOTE You can set the hdvmcli diaglevel property to DEBUG INFO WARN or ERROR The default logging level is INFO Using the Device Manager Properties File 111 5 3 3 Message Trace Output You can use the t or messagetrace option to record the requests sent to the Device Manager server and the responses received back from the Device Manager server By default the messages are recorded in the MessageTrace log file You can also turn on message trace and specify the location of the log file in the properties file For example you could specify the log file location and turn on message trace in the property file as follows hdvmcli tracefile C DeviceManager traffic log messagetrace true For more information on Device Manager properties please refer to the HP StorageWorks Command View XP Advanced Edition Device Manager Server Installation and Configuration Guide 5 3 4 Specifying the Device Manager Server URL Because the same Device Manager server may be used repeatedly the URL can be specified in the properties file The hdvmcli serverur1 property can specify the following URL hdvmcli serverurl http localhost 2001 service When the URL is defined in the properties file it can be omitted from the command lin
175. xecution result 2 RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 ArrayGroup elements An instance of ArrayGroup object ID ARRAYGROUP HDS9980V 10001 1 0 chassis 1 number 0 displayName 1 1 1 raidType RAID5 3D 1P emulat ion OPEN 3 diskType DKR2D J072FC diskSize 72 controllerID 1 totalCapacity 203 925 600 allocatedCapacity 203 925 600 freeCapacity 0 autoLunCapacity 0 onDemandCapacity 0 totalFreeSpace 9 126 144 largestFreeSpace 9 126 144 substance 0 slprNumber 1 clprNumber 1 openTotalCapacity 203 925 600 openAllocatedCapacity 203 925 600 openFreeCapacity 0 openAutoLunCapacity 0 openOnDemandCapacity 0 imTotalCapacity 0 imAllocatedCapacity 0 imFreeCapacity 0 imAutoLunCapacity 0 imOnDemandCapacity 0 mfTotalCapacity 0 mfAutoLunCapacity 0 mfOnDemandCapacity 0 mfAllocatedCapacity 0 mfUnallocatedCapacity 0 List of 1 FreeSpace elements An instance of FreeSpace objectID FREESPACE HDS9980V 10001 1 0 85 sizeInKB 9 126 144 cylinders 0 fsControlIndex 85 Command Line Interface Commands 44 4 3 12 6 GetStorageArray subtarget HostStorageDomain GetStorageArray subtarget HostStorageDomain obtains the information about a host storage domain of one or all storage subsystems Users with access to this command e Yes System Administrator Storage Administrator e No None H Restricted to permitted resources Guest Local System Administrator Local Storag
176. y pair status to split resync or restore split Copying between copy pair has stopped resync Synchronization is achieved from P VOL to S VOL so that their contents match e restore Synchronization is achieved from S VOL to P VOL so that their contents match Users with access to this command Yes System Administrator Storage Administrator D No Guest Local Guest Restricted to permitted resources Local System Administrator and Local Storage Administrator do not have access range limitations Table 4 82 ModifyReplication Command Parameters KH Parameter Name Status Description replicationgroupid Required Specify the copy group number operation Required Specify one of the following values split Split the copy pair resync Re synchronize the copy pair from the primary volume P VOL to the secondary volume S VOL restore Re synchronize the copy pair from S VOL to P VOL pvolserialnum Optional Specify the serial number of the storage subsystem that contains the P VOL pvoldevnum Optional Specify the device number of P VOL svolserialnum Optional Specify the serial number of the storage subsystem that contains the S VOL svolsequencenum Optional Specify the sequence number of the storage subsystem that contains the S VOL svoldevnum Optional Specify the device number of S VOL copytracksize Optional Specify the copy pace from 1 to 15 When the status of the Snaps
177. yPortController ModifyPortController supports changing characteristics of a PortController see Table 4 37 Users with access to this command e Yes System Administrator Storage Administrator H No Guest Local System Administrator Local Storage Administrator Local Guest Table 4 37 ModifyPortController Command Parameters Parameter Name Status Description serialnum Required Serial number of the port controller s storage array model Required Model of the port controller s storage array ctrlid Required Number of the port controller adaptermode Required New adapter mode value of the port controller Command execution example hdvmcli ModifyPortController o D logs XP1024 ModifyPortController log serialnum 10001 model XP1024 ctrlid 1 adaptermode 1 Command execution result RESPONSE An instance of StorageArray Attributes of StorageArray are omitted here List of 1 PortController elements An instance of PortController objectID CONTROLLER HDS9980V 10001 1 cluster 1 card 1 controllerID 1 displayName CHA 1P mode 1 type 12 4 3 17 RefreshStorageArrays RefreshStorageArrays updates all discovered storage subsystems to their latest state see Table 4 38 The storage subsystems created by the Remote Console or Remote Web Console are applied to the Device Manager server database By executing this command at regular intervals you can ensure that

HP XP12000 User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents