HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96392 Twelfth edition: January 2014
Legal and notice information © Copyright 2010, 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents Preface .............................................................................................. 17 1 Overview of the Device Manager CLI ................................................. 19 About the Device Manager CLI ................................................................................................... 19 Terms used in this document ....................................................................................................... 19 Device Manager licenses ................
AddHostStorageDomain ...................................................................................................... 56 AddLabel .......................................................................................................................... 66 AddLogicalUnit .................................................................................................................. 68 AddLUSE .............................................................................................................
ModifyTieringPolicy .......................................................................................................... ModifyVirtualVolume ........................................................................................................ RefreshPerformanceData .................................................................................................... RefreshStorageArrays ........................................................................................................
ExternalStorage instance .......................................................................................................... FreeLUN instance .................................................................................................................... FreeSpace instance ................................................................................................................. Host instance ...................................................................................................
When an error occurs during batch functionality execution (if the target storage system is an XP24000/XP20000 whose microcode version is 60-02-00-00/00 or later) ................................... 455 7 Import functionality ......................................................................... 459 Overview of the import functionality .......................................................................................... Importing host information (using the ImportHosts command) .....................
XML-formatted execution results (GetStorageArray) ................................................................ 491 The DTD used for outputting execution results in XML format (GetStorageArray) ............................... 492 C XML-API request file ........................................................................ 505 About XML-API request files ......................................................................................................
Figures 1 Device Manager CLI execution environment ................................................................ 21 2 Example of executing the AddExternalArrayGroup command ........................................ 54 3 Relationship of attributes (total size of the volumes in the storage system) ...................... 434 4 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 434 5 Relationship of attributes (the sizes of the volumes) ..........................
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 20 2 Device Manager CLI options .................................................................................... 29 3 Device Manager CLI return values ............................................................................. 31 4 Storage system management commands and related storage systems ............................. 33 5 Commands related to logical groups ....................................
32 DeleteArrayReservation command parameters .......................................................... 108 33 DeleteExternalArrayGroup command parameters ...................................................... 109 34 DeleteHostStorageDomain command parameters ...................................................... 109 35 DeleteLabel command parameters ........................................................................... 111 36 DeleteLogicalUnit command parameters .......................................
69 GetZeroPageReclaimStatus Command Parameters ..................................................... 206 70 ModifyArrayReservation command parameters ......................................................... 207 71 ModifyExternalTierRank command parameters .......................................................... 208 72 ModifyLabel command parameters ......................................................................... 211 73 ModifyLogicalUnit command parameters ........................................
105 RefreshVirtualizationServer command parameter ....................................................... 317 106 AddURLLink command parameters .......................................................................... 319 107 DeleteAlerts command parameters .......................................................................... 321 108 DeleteURLLink command parameters ........................................................................ 322 109 GetAlerts command parameters ...........................
2 Path instance attributes .......................................................................................... 402 143 PDEV instance attributes ......................................................................................... 403 144 PerformanceStatus instance attributes ....................................................................... 405 145 Pool instance attributes ..........................................................................................
177 Conditions for specification of parameters for the DeleteLUSE command ....................... 450 178 Conditions for specification of parameters for the DeleteVLDEVFromVRPU command ...... 450 179 Conditions for specification of parameters for the ModifyVirtualVolume command ......... 451 180 Corrective actions for Device Manager server error codes and storage system error codes ..................................................................................................................
Preface This guide describes HP StorageWorks P9000 Command View Advanced Edition Suite Software and how to set up and use the command line interface (CLI). Besides command syntax and parameters, topics include batch files, mainframe hosts, output formats, and troubleshooting. The intended audience is a storage administrator with independent knowledge of HP StorageWorks P9000 storage systems, SANs, and Java environments.
Preface
1 Overview of the Device Manager CLI This chapter describes information you need to know before using the Device Manager CLI. About the Device Manager CLI The Device Manager CLI provides a command line from which you can use HP StorageWorks P9000 Command View Advanced Edition Software to perform storage system operations and to manage storage resources. A request is sent to the storage system by submitting an entered command to the Device Manager server.
A full license is required to use all Device Manager functions. The types of full licenses are as follows: permanent, temporary, emergency, and meter-based term. Core CLI/SMI-S license: The Core CLI/SMI-S license enables you to use only storage management functions that use the Device Manager CLI. With the Core CLI/SMI-S license, you cannot use storage management functions from the GUI.
2 Preparing to use the Device Manager CLI This chapter describes the environment settings that are necessary for using the Device Manager CLI. About the Device Manager CLI execution environment The Device Manager CLI must be executed on a management client or management server. • Management client A computer on which P9000 Command View AE Suite products are used via a GUI or CLI. To execute the Device Manager CLI on a management client, download the necessary file from the GUI, and then install the file.
To install the Device Manager CLI: 1. Download the Device Manager CLI file from the P9000 Command View AE Suite GUI. 2. Copy the downloaded file to the computer on which the CLI is to be installed. 3. Decompress the copied file. 4. Configure the execution environment and the properties file.
• Install the Oracle JRE. To set up a Java environment (recommended settings): • For the HDVM_CLI_JRE_PATH environment variable, specify the path to a different JRE from the one used on the Device Manager server. If you use the JRE that is being used on the Device Manager server, the JRE might unexpectedly be updated to a version not supported by the Device Manager CLI. This could happen when Java on the Device Manager server is updated, or when Device Manager is upgraded.
2. Use method 1 or 2 below to specify the memory heap size. Since this value is specified in bytes, make sure that you always attach k or K when indicating kilobytes, or m or M when indicating megabytes. If both methods are used, the value set by method 1 takes precedence. Method 1: Use the command prompt or terminal window to set the calculated value for the HDVM_CLI_MEM_SIZE environment variable. Method 2: Use a text editor to open the hdvmcli.bat file or hdvmcli.
You can select either the NORMAL or HIGH encoding security level for encoding passwords. For details about how to change the level to HIGH in order to generate a safer and more secure character string, see the HP P9000 Command View Advanced Edition Suite Software Administrator Guide. Related topics • Command syntax, page 27 • Property for specifying command options , page 470 Encoding the password To encode a password, execute the hdvmaccount command.
for the user property in the properties file. In addition, if an encoded password is already set for the password2 property, delete that value. -f Specify this option if you want to output the encoded password to a file. Use an absolute path to specify the file name. If you specify the -f option, the path to the file is set for the password2 property in the properties file. If you omit the -f option, the character string of the encoded password is set. help Displays Help for the hdvmaccount command.
3 Executing commands This chapter describes how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Command syntax This section describes the Device Manager CLI command syntax. • In Windows: In the following example, the Device Manager CLI has been installed in the C:\hdvmcli folder. C:\hdvmcli>hdvmcli.bat [URL] [command] [options] [parameters] • In Solaris, AIX, Linux, or HP-UX: # ./hdvmcli.
• Port number • When using HTTP: The HTTP port for the Device Manager server (default is 2001) • When using HTTPS: The HTTPS port for the Device Manager server (default is 2443) If a firewall is set up between the computer on which the Device Manager CLI is running and the Device Manager server, set the firewall so the Device Manager server port number can be used.
For usable parameters, see Chapter 4 on page 49. TIP: You can also set the URL, options, and parameters arguments in the properties file. If arguments are specified both in the properties file and from the command line, the arguments specified from the command line take precedence.
Option Argument for the option Status Description The format in which the execution results are output You can use this option only when you execute the GetStorageArray command. The execution results of the GetStorageArray command can be output in the following formats: -f or --format csv or xml Optional csv: CSV format#4 xml: XML format Note: Specify csv or xml by using lowercase letters. If this option is omitted, the execution results are output in the standard format.
specified when outputting execution results of the GetStorageArray command in CSV format” on page 489. #5 If you specify the -i (or --input) option to read requests to the Device Manager server from the XML API request file, if the XML API contains , the execution results are not suppressed.
Device Manager CLI log files Device Manager CLI logs are output to the hdvmcli.log file in the Device Manager CLI execution directory or folder. In the properties file, you can specify the output destination, file name, and log level. Related topics • Property for specifying the output destination of log files (hdvmcli.logfile), page 468 • Property for specifying the log level (hdvmcli.
Basic Help includes the current Device Manager CLI version. • Command Help Command Help explains the functions of specific commands and the parameters that can be specified for those commands. You can display command Help from the Device Manager CLI as follows: C:\hdvm> hdvmcli help command-name For example, to display command Help for the GetServerInfo command, specify the following: C:\hdvm> hdvmcli help GetServerInfo • Help for the batch function The Device Manager CLI contains a batch function.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- -- Creates a host storage domain or host group. Y Y Y Y AddLabel Sets a label. Y Y Y Y AddLogicalUnit Creates an LDEV and a logical unit in the storage system. Y Y Y Y AddLUSE Creates a LUSE. Y Y Y Y AddPool Creates a THP/Smart pool. Y Y -- -- AddStorageArray Searches for storage systems and registers the storage system information into the Device Manager server database.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y DeleteExternalArrayGroup Deletes an external parity group. Also, deletes the LUs that belong to the deleted external parity group. Y Y -- -- DeleteHostStorageDomain Deletes a host storage domain or host group. Y Y Y Y DeleteLabel Deletes a label. Y Y Y Y DeleteLogicalUnit Deletes an LU and the corresponding LDEV. Y Y Y Y DeleteLUSE Deletes any LUSEs that do not have a path. Y Y Y Y DeletePool Deletes a THP/Smart pool.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- Obtains the execution status of a zero-page reclaim operation. Y Y -- -- ModifyArrayReservation Extends the maximum period for which a specified storage system is locked. Y Y Y Y ModifyExternalTierRank Modifies the external LDEV tier rank of the THP/Smart pool volume. Y -- -- -- ModifyLabel Modifies a label. Y Y Y Y ModifyLogicalUnit Modifies the settings of the logical units and the corresponding LDEVs.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y RefreshStorageArrays Refreshes the configuration information for all of the storage systems that are managed by the Device Manager server with the most recent information. Y Y Y Y RunZeroPageReclaim Releases unused capacity in THP/Smart volumes. Y Y -- -- ShrinkPool Shrinks a THP/Smart pool.
If the Core License is used, logical group commands cannot be used. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 19. Table 5 Commands related to logical groups Command name Description GetLogicalGroup Obtains information about logical groups.
Commands related to host management You can use the host management commands to manage information about hosts and the storage systems used by hosts. The following table explains the host management commands. Table 7 Commands related to host management Command name Description AddHost Registers information about a host into the Device Manager server database. AddHostInfo Registers host-based information about a LUN into the Device Manager server database.
The following table explains the server management commands. Table 8 Commands related to server management Command name Description AddURLLink For Device Manager objects managed by the Device Manager server (referred to as mainframe hosts), this command sets information regarding links to the URLs of the P9000 mainframe agent instances running on mainframe hosts (referred to as URLLinks). DeleteAlerts Deletes information about the alerts that are managed by the Device Manager server.
Command name Description ModifyReplication Changes copy pair statuses. P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y XP1024/ XP128 Y Legend: Y: Indicates that the particular storage system can be used to execute the command. --: Indicates that it cannot be used to execute the command.
Commands related to resources after a data migration that uses virtual IDs The Device Manager CLI supports operations for resources (host storage domains, ports, and volumes) that contain virtual information. You can perform operations on resources that contain virtual information for P9500 with a microcode version of 70-03-30-XX/XX or later. Also, you can register, modify, and delete virtual information for P9500 with a microcode version of 70-05-04-XX/XX or later.
Supported functions Command name Registration, modification, and deletion of virtual information AddVLDEVToVRPU DeleteVLDEVFromVRPU #1 LUN security settings cannot be changed. #2 Operations related to LUSE volumes cannot be performed. #3 The LUN security for the specified port must be enabled. Related topics • Chapter 4, page 49 About the relationship between commands and roles To execute Device Manager commands, a user must belong to a user group to which resource groups and roles are assigned.
Table of commands and roles The following tables show the roles required for executing each command.
Command name Role GetArrayReservation Admin or Modify GetPoolShrinkStatus Admin or Modify GetStorageArray Admin, Modify, or View GetTieredPoolStatus Admin or Modify GetZeroPageReclaimStatus Admin or Modify ModifyArrayReservation Admin or Modify ModifyExternalTierRank Admin or Modify ModifyLabel Admin or Modify ModifyLogicalUnit Admin or Modify ModifyPool Admin or Modify ModifyPort Admin or Modify ModifyPortController Admin or Modify ModifyStorageArray Admin#1 or Modify#1 ModifyTi
Command name Role AddWWNForHostStorageDomain Admin or Modify DeleteLun Admin or Modify DeleteWWN Admin or Modify DeleteWWNForHostStorageDomain Admin or Modify Table 15 Roles required to execute commands (Commands related to host management) Command name Role AddHost Admin or Modify AddHostInfo Admin or Modify AddHostRefresh Admin or Modify AddVirtualizationServer Admin or Modify DeleteHost Admin or Modify DeleteHostInfo Admin or Modify GetHost Admin, Modify, or View GetHostInfo Ad
Command name Role GetServerInfo Admin, Modify, or View GetURLLink Admin, Modify, or View # All Resources must be assigned as a resource group.
Item Description When a CLI command and the GUI are used at the same time, usable characters for host names are the following: A-Z a-z 0-9 - _ . @ Spaces can also be used, but you cannot use a name that consists of spaces only. Usable characters for host names. If characters other than those shown above are used, GUI operations might not be possible.
4 Command reference This chapter describes the syntax and parameters of Device Manager CLI commands with execution examples. Commands related to storage system management The storage system management commands can be used to register, modify, and delete storage system information. AddArrayReservation AddArrayReservation locks the target storage system.
• DeleteLogicalUnit • DeleteLun • DeleteLUSE • DeletePool • DeleteVirtualVolume • DeleteVLDEVFromVRPU • DeleteWWN • DeleteWWNForHostStorageDomain • FormatLU • ModifyArrayReservation • ModifyLogicalUnit • ModifyPool • ModifyPort • ModifyPortController • ModifyVirtualVolume • RunZeroPageReclaim • ShrinkPool Parameters Table 19 AddArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Para
arrayType=XP12000 loginID=dmuser beginTime=1,039,003,476 *****: The values are encoded by the CLI. AddExternalArrayGroup AddExternalArrayGroup performs one-to-one mapping of external volumes (volumes in an externally connected storage system) to internal volumes, and then creates a parity group. AddExternalArrayGroup also creates an LU in the created external parity group. When you perform mapping, you can specify multiple paths (alternate paths).
Parameter name Status Description Port WWN of the external storage system If you specify multiple (alternate) paths, use a comma to separate each entry. externalwwn Required When specifying paths, the parameters portname, externalwwn, and externallun must all be specified as a set. The order in which they are specified dictates the path priority. (The first parameter in the set becomes the primary path.) Make sure that the order and number of the values specified for these parameters are correct.
Parameter name Status Description Option information that determines whether logical units are to be created at the same time an external parity group is created Either of the following values can be specified: luoption Optional • none: No logical unit is created. • create: Logical units are created. If this parameter is omitted, none is set. Number of logical units to be created The only valid value is 1. numoflus Optional If this parameter is omitted, 1 is set.
externalwwn For external storage systems other than SMI-S enabled storage systems, obtain this value from the execution results of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Then, select the port whose wwn value displayed below An instance of WWN matches the worldWidePortName value of the portname parameter. Then, for the externalwwn parameter, specify the worldWidePortName value of that port. At this time, record the portID value.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
sizeInKB=1,048,576 cylinders=0 fsControlIndex=0 List of 2 ExternalPathInfo elements: An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.50 externalLun=1 portID=13 pathGroupID=23 priority=1 An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.52 externalLun=0 portID=15 pathGroupID=23 priority=2 *****: The values are encoded by the CLI. AddHostStorageDomain AddHostStorageDomain adds a host storage domain.
Parameter name Status Description Domain ID of the host storage domain This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional The specifiable values depend on the storage system.
Parameter name Status Description Nickname of the host storage domain Specify the name used for the host group to be created in the storage system. If this parameter is omitted, it is set automatically. When adding a host storage domain, if you use the HostScan command to register a host in Device Manager, in the nickname parameter specify the name of the host that uses the host storage domain. For details about the HostScan command, see “HostScan” on page 300.
Storage system Value of hostmode • Standard • Sequent • HP • Solaris • Netware XP12000 • Windows XP10000 • Windows Extension SVS200 • Tru64 • AIX • OPEN-VMS The following value relies on the microcode version. For 50-03-0X-XX/XX or later: • UVM • Standard • Sequent • HP • Solaris • Netware • Windows • Tru64 • AIX XP1024 XP128 • OPEN-VMS The following value relies on the microcode version.
For details, see the documentation of the LUN management product for the storage system you are using. Table 23 Values that can be specified in the hostmodeoption parameter hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y Y Y Y P9500 VERITAS Database Edition/Advanced Cluster 2 Specify this value when using VERITAS Database Edition/Advanced Cluster for Real Application Clusters or VERITAS Cluster Server 4.0 or later (I/O fencing feature).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y -- -- Y Y Y Y Y Y Y P9500 SIM report at link failure 13 Specify this value when you want to get a SIM notification when the number of unsuccessful connections between ports exceeds a threshold. HP TruCluster with Continuous Access function Specify this value when both of the following conditions are satisfied: 14 • The host mode is set to Tru64 (mode 07).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 -- -- Y -- -- Y Y Y -- Y Y -- P9500 2TB or Larger LUN Support Specify this value when both of the following conditions are satisfied: • The host accesses a volume that exceeds 2 TB. • The host OS is one of the following: - AIX 5L Version 5.2 TL08 or later, or AIX 5L Version 5.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- Y Y -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- P9500 V-Vol expansion Specify this value when both of the following conditions are satisfied: 40 • The host mode is set to Windows (mode 0C) or Windows Extension (mode 2C). • After increasing the THP volume capacity, you want to force that capacity to be automatically recognized.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- Y -- -- P9500 Round Trip Set Up Option 51 Specify this value when you want to use Round Trip to improve True Copy performance. ESAM and Cluster Software for SCSI-2 Reserve 52 Specify this value when cluster software is used that uses SCSI-2 Reserve in a configuration that uses External Storage Access Manager.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y -- -- Y -- -- P9500 Online LUSE expansion Specify this value when the expansion of the capacity of a LUSE volume is notified for a host. 69 Change the Unit Attention for Blocked Pool-VOLs Specify this value when a Unit Attention (UA) response for a closed pool volume is changed from NOT READY to MEDIUM ERROR.
Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter. nickname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. Execute this command by specifying only the model and serialnum parameters, Port for the subtarget parameter, and HostStorageDomain for the portsubinfo parameter.
Parameter name Status Description Device number of the logical unit to which a label is to be added For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution result RESPONSE: An instance of ObjectLabel targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. AddLogicalUnit AddLogicalUnit creates an LDEV and LU. With P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, you can create multiple logical units at once. The LDEVs created by this command are formatted when they are created.
capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick#}] [capacitytype={KB|block}] When creating multiple logical units in bulk by specifying their capacity and number: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number |arraygroupname=parity-group-name} [fsindex=index-number-of-region-of-unused-capacity] creationoption=bulk capacity=capacit
Parameters Table 25 AddLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system where the LU is added model Required Model of the storage system where the LU is added Number of the chassis for the parity group where the LU is added If you specify this parameter, make sure that groupnum is also specified. chassis Optional Always specify either the chassis and groupnum parameters together, or the arraygroupname parameter by itself.
Parameter name Status Description LU creation method Specify a creation method for creating multiple LUs at once. One of the following values can be specified: Optional (P9500 XP24000 creationoption# XP20000 XP12000 XP10000 SVS200) • bulk: Creates LUs by specifying their capacity and number. If you specify bulk, also specify capacity and numoflus. • dividebynum: Creates LUs by specifying their number. If you specify dividebynum, also specify numoflus but do not specify capacity.
Parameter name Status Description Emulation type of the logical unit The following are the specifiable emulation types: • OPEN-3 • OPEN-8 • OPEN-9 • OPEN-E • OPEN-K • OPEN-V emulation Optional Specify the same emulation type as the parity group in which a logical unit is created. If no such emulation is present, parity group emulation is used. This parameter must be specified if the creationoption parameter is specified. In this case, OPEN-V is the only value you can specify.
Parameter name Status Description The unit for the value specified in the capacity parameter The values you can specify are KB or block. capacitytype Optional If this parameter is omitted, KB is set as the unit. block can be specified for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200 only. # For P9500 and XP24000/XP20000, if you do not specify the fsindex and creationoption parameters, you can optimize the regions of unused capacity to create an LU.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: • When you add a LUSE volume with the luseoption parameter set, specify a LDEV in which a path is set as the first LDEV. If a LDEV without a path set is specified as the first LDEV, an error occurs. • When a LUSE volume is added with the luseoption parameter set, the extended LUSE volume might not be able to be recognized, based on the host. In this case, restart the host.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. Command execution example hdvmcli AddLUSE -o "D:\logs\AddLUSE.log" "serialnum=15001" "model=XP1024" "devnums=1001,1002" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversal
diskType=0 slprNumber=-1 clprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. AddPool AddPool creates a THP/Smart pool in a targeted storage system.
• It does not belong to a resource group used for data migrations that use virtual IDs. • If more than one logical unit is specified, all of them must have the same cache mode. The following conditions apply only to P9500 with a microcode version earlier than 70-02-00-XX/XX: • If more than one logical unit is specified for a THP/Smart pool, internal volumes and external volumes cannot be mixed together.
NOTE: For details about the following conditions, see the Thin Provisioning documentation: • The number of pool volumes that can be specified in a THP/Smart pool • The total maximum number of THP/Smart pools, Snapshot pools, and Fast Snap pools Format for P9500 hdvmcli [URL] AddPool [options] model=model serialnum=serial-number [poolid=pool-ID] [threshold=THP/Smart-pool-threshold-1] [threshold2=THP/Smart-pool-threshold-2] [threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold]
Parameter name Status Description Threshold1 of the THP/Smart pool (%) The threshold1 of the THP/Smart pool is the usage rate of the THP/Smart pool. For P9500 whose microcode version is earlier than 70-014X-XX/XX: Specify a multiple of 5 in the range from 5 to 95. threshold Optional For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100. For XP24000/XP20000: Specify a multiple of 5 from 5 to 95.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#2 Specify a threshold value used to issue an advance warning. For P9500: overprovisioningwarning#1 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Optional If this parameter is omitted, -1 is set. -1 indicates that a threshold value is not set.
Parameter name Status Description Specify whether to create a Smart pool. Optional tiercontrol (P9500) One of the following values can be specified. • enable: Creates a Smart pool. • disable: Creates a THP pool. If this parameter is omitted, enable is set. Specify whether to automatically execute performance monitoring and hardware tier relocation. Optional automigration (P9500) If you specify this parameter, you must also specify tiercontrol=enable. One of the following values can be specified.
Parameter name Status Description Performance monitoring mode. If you specify this parameter, you must also specify tiercontrol=enable. Specifiable values vary, depending on the microcode version. Optional monitoringmode (P9500) If the microcode version is earlier than 70-02-XX-XX/XX: 0: Periodic If this parameter is omitted, 0 is set. If the microcode version is 70-02-XX-XX/XX or later: 0: Periodic 1: Continuous If this parameter is omitted, 1 is set.
Parameter name Status Description Buffer space for hardware tier relocation (%) Specify how much work space the storage system can use for data relocation for each hardware tier of a Smart pool. You can specify an integer from 2 to 40. If this parameter is omitted, 2 is set for all tiers. HP recommends that you use the default values. The following uses a three-tier Smart pool as an example of how to specify this parameter.
unit that satisfies the conditions to be used as a pool volume in a THP/Smart pool to specify the devnums parameter. Command execution example In this example, the AddPool command creates a Smart pool whose pool ID is 5 (poolid: 5) in the storage system (serialnum: 53039, model: P9500). In addition, this command also sets the usage rate threshold for the Smart pool to 75% (threshold: 75). hdvmcli AddPool -o "D:\logs\AddPool.
lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 numberOfLBAs=20,971,520 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false comm
substance=0 bufSpaceForNewPageAssignment=8 bufSpaceForTierRelocation=2 *****: The values are encoded by the CLI. AddStorageArray AddStorageArray searches for storage systems (including SMI-S enabled storage systems), and registers the storage system information (such as the IP address, user ID, and password) into the Device Manager server database.
NOTE: • When executing the AddStorageArray command for a storage system, do not shut down hosts that are using storage system volumes, and do not stop the Device Manager agent. If you do so, the AddStorageArray command might take longer to perform. • When using the AddStorageArray command to register storage system information, HP recommends that, for the parameter userid, you specify a different user ID from user IDs that other storage system management tools use.
Parameters Table 28 AddStorageArray command parameters Parameter name Status Description IP address For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: Specify the IP address of the storage system. You can also specify the host name (alias name) of the port controller of the storage system. ipaddress Required For P9500 and XP24000/XP20000, this parameter can be specified by using an IPv6 IP address. For an SMI-S enabled storage system: Specify the IP address of the SMI-S provider.
Parameter name Status Description Protocol Specify the data transfer protocol used by the SMI-S provider. Optional protocol (SMI-S enabled storage system) One of the following values can be specified. The values are not case-sensitive. • Non-secure: HTTP communication • Secure: HTTPS communication If you omit this parameter when initially registering an SMI-S enabled storage system, Secure is set.
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP1024@172.16.45.1 description=XP1024 (10001) at 172.16.45.
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=0 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,039,003,476 autoFormatLU=-1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocatedActualCapacity=1,578,120,480 openUnallocatedCapacity=2,442,665,520 openUnallocatedActualCapacity=2,442,665,520 openReservedCapacity=4,806,720 openReservedActualCapacity=4,806,720 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 List of 1 CommParamete
3. Check the execution status of performance monitoring. Execute the GetTieredPoolStatus command to check the execution results. Check the values of monitoringState, lastMonitorStartDate, and lastMonitorEndDate under An instance of Pool displayed in the execution results. For details about the values, see Table 145. 4. Start hardware tier relocation. Execute the AddTieredPoolOperation command with startRelocation specified for the operation parameter.
tierControl appear under An instance of Pool. The An instance of Pool for which enable is displayed for the tierControl value contains information about a Smart pool. Specify the poolID value of the Smart pool subject to performance monitoring or hardware tier relocation for the poolids parameter. Command execution example In this example, the AddTieredPoolOperation command starts performance monitoring by specifying startMonitor for the operation parameter.
lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationProgress=-1 numberOfTiers=1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 *****: The value is encoded by the CLI. AddVirtualVolume AddVirtualVolume creates THP/Smart volumes in a target storage system. This command also assigns the THP/Smart volumes to be added to a target THP/Smart pool.
• When a THP pool is specified, the over-provisioning percent must be less than the over provisioning limit threshold. NOTE: Note the following when using this command with XP24000/XP20000: • HP recommends that you do not create more than one THP volume in a virtual parity group. Also, if the microcode version is 60-04-XX-XX/XX or later and the system option 726 is set to ON, you cannot create more than one THP volume in a virtual parity group.
When the command is used to create as many virtual parity groups as the THP volumes to be created, and to populate each group with a THP volume: hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-THP-volumes [numoflus=number-of-THP-volumes] [devnum=device-number-of-logical-unit] [clprNumber=CLPR-number] [poolid=pool-ID-of-THP-pool [threshold=usage-rate-threshold-of-THP-volumes]] [capacitytype={KB|block}] When the command is used to create THP volumes in an exi
Parameter name Status Description Capacity of THP/Smart volumes You can use the capacitytype parameter to specify the unit used for capacity (KB or blocks).
Parameter name Status Description Pool ID of a THP/Smart pool poolid Optional Specify the pool ID of the THP/Smart pool to which to assign the THP/Smart volumes to be created. For P9500, always specify this poolid parameter. Usage rate threshold for the THP volumes (%) threshold Optional Specify a multiple of 5 from 5 to 300. (XP24000 If omitted, 5 is set. XP20000) If the poolid parameter is omitted, the specification for this parameter becomes invalid.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differe
stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LogicalUnit objectID=***** devNum=12,289 displayName=00:30:01 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0
sizeInKB=209,715,200 lba=419,430,400 raidType=substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypt
• • • • • It is not a LUSE volume. It does not have a path. It is not a command device It must be an open volume The emulation type must be OPEN-V. • If an LDEV is to be added to a resource group used for data migrations that use virtual IDs, the LDEV belongs to a resource group (meta_resource) that is managed by a storage system management tool and whose resource group ID is 0.
Parameter name Status Description Virtual emulation type of the LDEV The following are the specifiable emulation types: • OPEN-3 • OPEN-8 vemulation Optional • OPEN-9 • OPEN-E • OPEN-K • OPEN-L • OPEN-V If this parameter is omitted, it is assumed that OPEN-V is specified. Virtual SSID of the LDEV vssid Optional Specify an integer from 4 to 65533 for the virtual SSID of the LDEV.
An instance of VResourcePartitionUnit. Use this value to specify the vrpuid parameter. devnum Obtain this value from the execution results of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter. In the execution results, the devNum value, which is required for the devnum parameter, is output after An instance of LDEV. Specify this devNum value for the devnum parameter.
Parameters Table 32 DeleteArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 33 DeleteExternalArrayGroup command parameters Parameter name Status Description serialnum Required Serial number of the storage system where you want to delete the external parity group model Required Model of the storage system where you want to delete the external parity group arraygroupnames Required List of external parity group names to be deleted Use a comma to delimit multiple values.
Parameter name Status Description model Required Model of the storage system for the host storage domain. The port ID of the host storage domain to delete Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Port name for the host storage domain to delete portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain. Use this value to specify the domainnickname parameter. Command execution example hdvmcli DeleteHostStorageDomain -o "D:\logs\DeleteHostStorageDomain.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter.
Parameter name Status Description Device number of the LU For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution example hdvmcli DeleteLogicalUnit -o "D:\logs\DeleteLogicalUnit.log" "serialnum=10001" "model=XP12000" "devnum=1" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLUSE DeleteLUSE deletes a LUSE volume on a storage system.
isComposite=1 and path=false indicates that it is a LUSE volume that does not have a path. In the execution result of this command, the devNum value of the relevant logical unit appears under An instance of LogicalUnit. Use this devNum value to specify the devnum parameter. Command execution example hdvmcli DeleteLUSE -o "D:\logs\DeleteLUSE.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter. Command execution example In this example, the DeletePool command deletes the THP pool whose pool ID is 0 (poolid: 0) from the storage system (serialnum: 15065, model: XP24000). hdvmcli DeletePool -o "D:\logs\DeletePool.
Parameters Table 39 DeleteStorageArray command parameters Parameter name Status Description Serial number of the storage system to delete serialnum # Optional You cannot specify this parameter if you are deleting an SMI-S enabled storage system. Model of the storage system to delete # model Optional saobjid Optional# You cannot specify this parameter if you are deleting an SMI-S enabled storage system.
NOTE: This command can be used only with P9500 and XP24000/XP20000. For P9500 and XP24000/XP20000, to delete a THP/Smart volume, the following conditions must be satisfied: • The THP/Smart volume does not have any paths. • To delete specified THP/Smart volumes, Open Volume Management must be installed in the storage system. • The THP/Smart volume has a guard mode of Read/Write.
hdvmcli [URL] DeleteVirtualVolume [options] model=model serialnum=serial-number [deletionoption=force] devnums=device-number-of-THP-volume # If the microcode version is 60-04-XX-XX/XX or later and the system option 726 is set to ON, you cannot specify this format. If you specify this format, an error occurs.
Command execution example In this example, the DeleteVirtualVolume command deletes the virtual parity group (arraygroupnames: X200-1) containing THP volumes from the storage system (serialnum: 15065, model: XP24000). In addition, this command also deletes THP volumes whose assignations with THP pools have not been released by specifying force for the deletionoption parameter. hdvmcli DeleteVirtualVolume -o "D:\logs\DeleteVirtualVolume.
Parameter name Status Description Device number of the LDEV devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. The execution results are output in decimal. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
To check whether the LDEV was formatted properly if you omitted the wait parameter, or if you specified false in the wait parameter, first use the AddStorageArray command to refresh the storage system, and then execute the GetStorageArray (subtarget=LDEV) command and check the value of status in the execution results. If you specified true in the wait parameter, simply check the value of status in the execution results of the FormatLU command. CAUTION: This command erases data on the LU.
Parameter name Status Description Specifies whether to wait until formatting is complete before ending the command. You can specify the following values: wait Optional • true: Wait until formatting is complete before ending the command. • false: Do not wait until formatting is complete before ending the command. If this parameter is omitted, false is set. If you specify true for this parameter, you cannot specify true for the quickformat parameter at the same time.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=100,000 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LogicalUnit ob
threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=1,176 displayName=00:04:98 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=100,000 lba=200,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=256 chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3
Command execution result An instance of ArrayReservation objectID=***** target=***** serialNumber=14009 arrayType=XP12000 loginID=dmuser beginTime=1,039,003,476 *****: The values are encoded by the CLI. GetPoolShrinkStatus The GetPoolShrinkStatus command obtains the execution status of the THP/Smart-pool shrinking operation that was executed by the ShrinkPool command. If you execute this command, the information of the THP/Smart pool volumes that belong to the THP/Smart pool is displayed.
Command execution example In this example, the GetPoolShrinkStatus command obtains the execution status of the operation for shrinking the THP/Smart pool whose pool ID is 1 (poolid: 1) in the storage system (serial number: 53039, model: P9500). hdvmcli GetPoolShrinkStatus -o "D:\logs\GetPoolShrinkStatus.
lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 numberOfLBAs=20,972,160 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false co
commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFla
numberOfPoolVols=30 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=135 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1
differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The values are encoded by the CLI. GetStorageArray GetStorageArray obtains information about storage systems managed by the Device Manager server.
Specify the subinfo parameters when you want to acquire the information related to a specific element specified for the parameter subtarget. The subinfo parameters that you can specify differ depending on the value of the parameter subtarget. Table 44 shows the element information that can be acquired by using the parameter subtarget. Table 45 shows the subinfo parameters that can be used together with the parameter subtarget.
Value of subtarget Information that can be acquired Location PortController Information about port controllers GetStorageArray (subtarget=PortController) , page 188 ReplicationInfo Information about copy pairs GetStorageArray (subtarget=ReplicationInfo) , page 190 SnapshotGroup Information about snapshot groups GetStorageArray (subtarget=SnapshotGroup), page 195 TieringPolicy Information about tiering policies that can be applied to Smart volumes of P9500 GetStorageArray (subtarget=TieringPoli
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information The following information about logical units can be acquired: • LDEV: LDEV information lusubinfo • Path: Path information • VolumeConnection: Mapping information of external volumes for LDEVs Specify Path for the parameter lusubinfo when using this parameter.
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information SnapshotGroup snapshotgrpsubinfo ReplicationInfo: Information about Fast Snap copy pairs that belong to a snapshot group The following information about resource groups used for data migration using virtual IDs can be acquired: VResourcePartitionUnit vrpusubinfo • VHostStorageDomain: Virtual information about host storage domains • VLDEV: Virtual information about
hdvmcli [URL] GetStorageArray [options] When obtaining information about a storage system (other than an SMI-S enabled storage system): hdvmcli [URL] GetStorageArray [options] serialnum=serial-number model=model When obtaining information about an SMI-S enabled storage system: hdvmcli [URL] GetStorageArray [options] saobjid=object-ID-of-SMI-S-enabled-storage-system Parameters Table 47 GetStorageArray (subtarget not specified) command parameters Parameter name Status Description serialnum Optional# m
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600@10.208.115.220 description=R600 (10007) at 10.208.115.
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is e
Parameter name Status Description Information about a logical unit lusubinfo Optional The values you can specify are Path and LDEV. If you specify multiple values at the same time, separate the values by commas. If you specify this parameter, you must also specify arraygroupsubinfo=LogicalUnit. Starting sequence number of parity groups for which information is to be obtained Specify this parameter when you want to obtain information for a part of parity groups in a specific storage system.
Command execution example 1 In this example, the GetStorageArray (subtarget=ArrayGroup) command obtains information about parity groups in a storage system (serial number: 14010, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_ArrayGroup.log" subtarget=ArrayGroup model=XP12000 serialnum=14010 Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
openUnallocatedActualCapacity=149,008,320 openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 . . (repeated for other ArrayGroup instances) . *****: The value is encoded by the CLI. Command execution example 2 In this example, the GetStorageArray (subtarget=ArrayGroup) command obtains information only about one parity group (object ID: *****) in a storage system (serial number: 10001, model: XP1024).
openTotalCapacity=209,638,800 openAllocatedCapacity=192,256,560 openFreeCapacity=17,382,240 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=192,256,560 openUnallocatedCapacity=17,382,240 openUnallocatedActualCapacity=17,382,240 openReservedCapacity=0 openReservedActualCapacity=0 type
Parameters Table 49 GetStorageArray (subtarget=CommParameters) command parameters Parameter name Status Description subtarget Required Specify CommParameters. serialnum Optional# model Optional# Serial number of the storage system You cannot specify this parameter if you are obtaining information about a particular SMI-S enabled storage system. Model of the storage system You cannot specify this parameter if you are obtaining information about a particular SMI-S enabled storage system.
userID=root ipAddress=172.16.45.1 GetStorageArray (subtarget=Component) GetStorageArray (subtarget=Component) obtains information about the configuration of storage systems. Parameters Table 50 GetStorageArray (subtarget=Component) command parameters Parameter name Status Description subtarget Required Specify Component. Serial number of the storage system serialnum Optional model Optional If you omit this parameter, all the storage systems become the target.
agentVersion=05_06_00 productName=RAID600 controllerVersion=60-06-21-00/00 numberOfControllers=2 capacityInGB=6,617 cacheInMB=65,536 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=3,765 allocatedCapacityInGB=2,851 autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,438 largestFreeSpaceInGB=466 capacityInKB=6,938,910,203 freeCapacityInKB=3,948,652,130 allocatedCapacityInKB=2,990,258,073 autoLunCapacityInKB=0 onDemandCapacityInKB=0 totalFreeSpaceInKB=3,605,150,982 largestFreeSpaceIn
openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 List of 12 Component elements: An instance of Component name=DKC Battery value=4 description=Moderate An instance of Component name=DKC Cache value=1 description=Normal An instance of Component name=DKC Cache Switch value=1 description=Normal An instance of Component name=DKC Environment value=3 description=Serious An instance of Component name=DKC Fa
GetStorageArray (subtarget=ExternalStorage) GetStorageArray (subtarget=ExternalStorage) acquires information about the external connection of storage systems. Parameters Table 51 GetStorageArray (subtarget=ExternalStorage) command parameters Parameter name Status Description subtarget Required Specify ExternalStorage. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target.
Parameters Table 52 GetStorageArray (subtarget=Filter) command parameters Parameter name Status Description subtarget Required Specify Filter. Object ID for a component (such as a path, port, or logical unit) of the storage system objectid Required Information is displayed about the storage system for the component identified by the object ID you specify with this parameter. Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
capacityInKB=4,025,592,720 freeCapacityInKB=2,442,665,520 allocatedCapacityInKB=1,578,120,480 autoLunCapacityInKB=4,806,720 onDemandCapacityInKB=0 totalFreeSpaceInKB=20,192,256 largestFreeSpaceInKB=3,796,992 multipathSupport=1 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayArrayType==XP1024 numberOfLUs=1,555 numberOfAllocatedLUs=565 numberOfUnallocatedLUs=990 slprStatus=-1 openTotalCapacity=4,025,592,720 openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoL
Parameters Table 53 GetStorageArray (subtarget=FreeSpace) command parameters Parameter name Status Description subtarget Required Specify FreeSpace. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Command execution example 1 In this example, the GetStorageArray (subtarget=FreeSpace) command obtains information about the unused capacity in a storage system (serial number: 14010, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_FreeSpace.log" subtarget=FreeSpace model=XP12000 serialnum=14010 Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=***** sizeInKB=1,847,952 cylinders=0 fsControlIndex=85 . . (repeated for other ArrayGroup instances) . *****: The values are encoded by the CLI.
totalFreeSpace=1,492,992 largestFreeSpace=1,492,992 substance=0 slprNumber=-1 clprNumber=-1 openTotalCapacity=211,531,680 openAllocatedCapacity=134,588,160 openFreeCapacity=76,943,520 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=134,588,160 openUnallocatedCapacity=76,943,520 openU
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Domain ID of the host storage domain If you omit this parameter, all the host storage domains become the target. If you specify this parameter, you must also specify the model and serialnum parameters. This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix.
Parameter name Status Description Port name of the host storage domain If port and portname are omitted, information about all ports is displayed. If you specify this parameter, you must also specify the model and serialnum parameters. portname Optional If you specify this parameter, you must specify the domain or domainnickname parameter. If neither is specified, this parameter is ignored. Do not specify port and portname at the same time. If they are specified at the same time, an error occurs.
domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain. Use this value to specify the domainnickname parameter.
scsiID=15 LUN=10 wwnSecurityValidity=true *****: The values are encoded by the CLI. GetStorageArray (subtarget=LDEV) GetStorageArray (subtarget=LDEV) obtains the information about LDEVs. Parameters Table 55 GetStorageArray (subtarget=LDEV) command parameters Parameter name Status Description subtarget Required Specify LDEV. Serial number of the storage system serialnum Optional If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Filter used for selecting the LDEV ldevfilter Optional Available values are OPEN, INTERMEDIATE, and MAINFRAME, which are not case-sensitive. To specify two or more values, separate them with semicolons (;). If you omit this parameter, all LDEVs are displayed. If you specify OPEN, the LDEVs for an open volume are displayed. If you specify INTERMEDIATE, the LDEVs for an intermediate volume are displayed.
devNum value appears under An instance of LDEV. Use this devNum value to specify the devnum parameter. Command execution example In this example, the GetStorageArray (subtarget=LDEV) command obtains information about a specific LDEV (device number: 0) in a storage system (serial number: 10001, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LDEV.
threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 List of 1 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=10001 mappedDevNum=0 displayMappedDevNum=00:00 externalArrayType=XP12000 externalSerialNumber=10002 externalDevNum=150 displayExternalDevNum=00:96 externalVolumeName=0096 productName=12000 vendor=HP *****: The values are encoded by the CLI.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LogicalDKC.log" subtarget=LogicalDKC model=XP24000 serialnum=12345 Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP24000 @10.208.115.221 description=XP24000 (12345) at 10.208.115.
mfAutoLunCapacity=23,239,440 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=589 numberOfOpenUnallocatedLUs=3,799 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=14 numberOfMfLDEVs=327 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,176,711,367 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=0 openAllocatedActualCapacity=663,807,296 openUnallocatedCapacity=7,227,624,640 openUnallocatedActualCapacity=6,090,395,200
Parameter name Status Description Filter for selecting a logical unit Available values are ALL, ASSIGNED, FREE, UNASSIGNED, and RESERVED. Omit this parameter or specify ALL to display information about all the logical units. Specify ASSIGNED to display information about the logical units that have an assigned LUN. lufilter Optional Specify FREE to display information about logical units that do not have an assigned LUN.
Parameter name Status Description Filter for selecting a THP/Smart volume Specify either the pool ID of a THP/Smart pool, or Unassigned. If you specify the pool ID of a THP/Smart pool, information about the THP/Smart volumes assigned to that THP/Smart pool is obtained. thpvolfilter Optional If you specify Unassigned, information about THP/Smart volumes not assigned to a THP/Smart pool is obtained. This information cannot be obtained by the partitioned storage administrator.
Parameter name Status Description Label name of logical units for which information is to be obtained label Optional Specify this parameter to obtain information about logical units for which a specific label is specified. You can specify only one label. If you specify this parameter, you must also specify lusubinfo=LDEV. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
numberOfLBAs=4,806,720 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-1-17 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=1 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID
volumeType=3 slotSizeInKB=48 chassis=1 arrayGroup=16 arrayGroupName=1-1-17 path=true onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 L
NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes. • For XP24000/XP20000, if there is information about copy pairs consisting of mainframe volumes, microcode version 60-01-6X-XX/XX or later is required. Parameters Table 58 GetStorageArray (subtarget=MFReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify MFReplicationInfo.
Parameter name Status Description Number of mainframe-volume copy pair information items to be obtained. numOfElementsFilter Optional Specify this parameter to obtain information for copy pairs of some mainframe volumes from a specific storage system. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
displaySvolDevNum=00:0D:05 svolObjectID=***** svolPoolID=-1 replicationFunction=ShadowImageForMF status=1 muNumber=3 List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=3,332 displayName=00:0D:04 emulation=3390-3 cylinders=3,339 isComposite=0 sizeInKB=2,904,930 lba=5,809,860 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=58 chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cac
chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=1 status=Normal thpType=-1 consumedSizeInKB=2,904,930 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=S-VOL mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encode
Parameter name Status Description Object ID of the path objectid Optional Specify this parameter when you want to obtain information about a specific path. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and omit the objectid parameter, information about paths for the specified storage system is obtained. Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
Parameter name Status Description Nickname of the host storage domain domainnickname Optional Specify this parameter to acquire information about a particular path. When you specify this parameter, you must also specify the model and serialnum parameters, either the portname or port parameter and the devnum parameter. Do not specify this parameter together with the domain parameter. If they are specified at the same time, an error occurs.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Path.log" subtarget=Path model=XP1024 serialnum=10001 pathsubinfo=WWN,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=***** devNum=0 displayDevNum=00:00 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=0 wwnSecurityValidity=true . . (repeated for other Path instances) .
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Path.log" subtarget=Path model=XP1024 serialnum=10001 objectid=***** pathsubinfo=WWN,HostInfo *****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Parameter name Status Description Object ID of the parity group containing the PDEVs to be returned arraygroupobjid Optional Specify this parameter when you want to obtain information about the PDEVs in a specific parity group. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and omit the arraygroupobjid parameter, information about the PDEVs in parity groups of the specified storage system is obtained.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 ArrayGroup elements: . . (Attributes of ArrayGroup are omitted here) .
NOTE: • When SLPR functionality is used in XP24000/XP20000 or XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain information about the pool even if he or she registers the storage system (SLPR) as a target to be managed by Device Manager. • Information about a journal volume to be stored in the pool appears as the LogicalUnit instance. This information can be obtained only when a journal volume is an open volume.
Parameter name Status Description Pool ID of the pool poolid Optional If the model or serialnum parameter is omitted, the specification for this parameter becomes invalid. You must specify the poolid and poolfunction parameters together. If the poolfunction parameter is omitted, the specification for this parameter becomes invalid. Information about the pool The values you can specify are LDEV, LogicalUnit, PairedPool, PoolTier, and ReplicationInfo. Use a comma to delimit multiple values.
poolid Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter. clprfilter • If the function type that is used to operate the pools is Continuous Access Journal Software: Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command.
combination= volAlertNotice=-1 overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu el
thpPoolVolControlFlag=-1 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=3,028 displayName=0B:D4 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 numberOfLBAs=3,277,440 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotV
overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 ReplicationInfo elements: An instanc
muNumber=0 copyTrackSize=-1 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,025 displayName=0B:D1 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 numberOfLBAs=3,277,440 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortControl
GetStorageArray (subtarget=Port) GetStorageArray (subtarget=Port) obtains the information about ports. Parameters Table 62 GetStorageArray (subtarget=Port) command parameters Parameter name Status Description subtarget Required Specify Port. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. Execute this command by specifying only the model and serialnum parameters, and the value for subtarget=Port.
domainID=0 hostMode=Standard hostModeOption= displayName=CL3-E-0 domainType=0 nickname=3E-G00 An instance of HostStorageDomain objectID=***** portID=9 portName=CL3-E domainID=1 hostMode=Standard hostModeOption= displayName=CL3-E-1 domainType=0 nickname=HP0900 List of 1 WWN elements: An instance of WWN WWN=21.00.00.E0.8B.0C.39.2F nickname= *****: The values are encoded by the CLI.
Parameter name Status Description Controller name for port controller of storage system controllername Optional Specify this parameter when you want to obtain information about a specific port controller. If you specify this parameter, you must also specify the model and serialnum parameters. If controllernum and controllername are omitted, port controller information is obtained for the specified storage system. Do not specify controllernum and controllername at the same time.
. List of 4 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 . . (repeated for other PortController instances) . *****: The value is encoded by the CLI. Command execution example 2 In this example, the GetStorageArray (subtarget=PortController) command obtains information about a port controller (controller ID: 1) used for a storage system (serial number: 10001, model: XP1024).
NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes. • For XP24000/XP20000, if there is information about copy pairs consisting of mainframe volumes, microcode version 60-01-6X-XX/XX or later is required.
Parameter name Status Description Starting sequence number of copy pair information to be obtained Specify this parameter to obtain information for some copy pairs from a specific storage system. When copy pair information is in the order shown below and starts from 0, specify the first number in the sequence of copy pair information that you want to obtain. startElementNumFilter Optional Order of copy pair information: 1. Serial numbers of P-VOLs in ascending order 2.
an objectID value appears under An instance of ReplicationInfo. Use this objectID value to specify the objectid parameter. snapshotgrpidfilter and snapshotgrpnamefilter Obtain these values from the execution results of the GetStorageArray (subtarget=SnapshotGroup) command. Execute this command with the model and serialnum parameters specified and SnapshotGroup specified for the subtarget parameter. You can obtain information about the snapshot group from the specified storage system.
emulation=OPEN-3 devCount=1 devType= capacityInKB=2,403,360 numberOfLBAs=4,806,720 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=P-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 jour
differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 . . (repeated for other ReplicationInfo instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=SnapshotGroup) The GetStorageArray (subtarget=SnapshotGroup) command obtains information about snapshot groups and about Fast Snap copy pairs that belong to the snapshot groups.
Parameter name Status Description Name of the snapshot group snapshotgroupname Optional Specify this parameter if you want to obtain information about a specific snapshot group. Do not specify this parameter together with the snapshotgroupid parameter. If both are specified, this parameter is ignored. Information about the Fast Snap copy pairs that belong to the snapshot group snapshotgrpsubinfo Optional You can only specify ReplicationInfo.
ctGrp=NotCTG List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=12,800 displayPvolDevNum=00:32:00 pvolPoolID=38 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=49,152 displaySvolDevNum=00:C0:00 svolPoolID=38 replicationFunction=FastSnap status=1 muNumber=0 copyTrackSize=-1 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=1 An instance of ReplicationInfo objectID=***** pvolSer
Parameters Table 66 GetStorageArray (subtarget=TieringPolicy) command parameters Parameter name Status Description subtarget Required Specify TieringPolicy. serialnum Optional model Optional Serial number of the storage system. If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
List of 1 TieringPolicy elements: An instance of TieringPolicy objectID=***** policyID=10 allocationThresholdT1Max=50 allocationThresholdT1Min=20 allocationThresholdT3Max=40 allocationThresholdT3Min=10 numberOfVVols=4 *****: The values are encoded by the CLI. GetStorageArray (subtarget=VResourcePartitionUnit) The GetStorageArray (subtarget=VResourcePartitionUnit) command obtains information about resource groups used for data migration using virtual IDs.
Parameter name Status Description Name of a resource group used for data migrations that use virtual IDs vrpuname Optional Specify this parameter when you want to obtain information about a specific resource group. If you specify this parameter, you must also specify the model and serialnum parameters. Information about the resource groups used for data migration using virtual IDs vrpusubinfo Optional Available values are VHostStorageDomain, VLDEV, and VPort.
Parameter name Status Description Number of the first host storage domain for which information is obtained Specify this parameter when you want to obtain virtual information about only some host storage domains in a specific storage system. startVhsdElementNumFilter When host storage domains are ordered as shown below and numbered from 0 upward, specify the number of the host storage domain from which you want to start obtaining information. Optional Order of host storage domains: 1.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. vrpuid Obtain this value from the execution results of the GetStorageArray (subtarget=VResourcePartitionUnit) command. Execute this command by specifying only the model and serialnum parameters, and VResourcePartitionUnit for the subtarget parameter.
domainID=0 vArrayFamily=**** vSerialNumber=10007 vPortID=-1 vDomainID=-1 An instance of VHostStorageDomain objectID=**** resourcePartitionUnitID=1 portID=138 domainID=1 vArrayFamily=**** vSerialNumber=10007 vPortID=64 vDomainID=0 . .(repeated for other VHostStorageDomain instances) . List of 102 VLDEV elements: An instance of VLDEV objectID=**** resourcePartitionUnitID=1 devNum=1 vArrayFamily=**** vSerialNumber=10007 vDevNum=1 vEmulation=OPEN-V vSSID=5 vLUSE=0 vCVS=0 . .
Parameter name Status Description List of pool IDs poolids Required Specify the pool ID of a Smart pool. Use a comma to delimit multiple values. The maximum number of pool IDs that can be specified is 128. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
numberOfPoolVols=31 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=131 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=enable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=1 lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationProgress=-1 nu
Parameters Table 69 GetZeroPageReclaimStatus Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP/Smart volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
commandDeviceAuth=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=5 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 *****: The value is encoded by the
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli ModifyArrayReservation -o "D:\logs\ModifyArrayReservation.
Parameter name Status Description Specify the device number of the logical unit of the THP/Smart pool volume whose external LDEV tier rank is changed to High. highdevnums Optional# Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values.
and serialnum parameters, Pool for the subtarget parameter, and LogicalUnit for the poolsubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit. Specify the devNum value of a logical unit, for which the external LDEV tier rank is changed from the THP/Smart pool volume in a THP/Smart pool, to a parameter such as highdevnums, middledevnums, or lowdevnums.
differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,784 thpPoolID=57 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=0 managementAreaPoolID=-1 externalTierRank=High List of 1 PoolTier elements: An instance of PoolTier objectID=***** tierID=0 capacityInKB=6,150,144 freeCapacityInKB=6,064,128 usageRate=1 raidLevel=Unknown combination=Unknown rpm=-1 diskType=-1 substance=1 bufSpaceForNewPageAssignment=8 bufSpaceForTierRelocation=2 *****: The values are encoded
Parameter name Status Description Label character string You can use the following characters: label Required A-Z a-z 0-9 ! # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ] ^ _ ` { | } ~ and spaces You can use a character string of 1-64 bytes for a label. A label character string cannot begin or end with spaces. When used with the GUI, follow the GUI specification rules. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Format hdvmcli [URL] ModifyLogicalUnit [options] serialnum=serial-number model=model devnum=device-number {commanddevice={true|false}|commanddevicesecurity={true|false}} Parameters Table 73 ModifyLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system of the LU model Required Model of the storage system of the LU Device number of the LU For P9500 and XP24000/XP20000: Required devnum Specify this parameter as a decimal number or colo
Command execution example hdvmcli ModifyLogicalUnit -o "D:\logs\ModifyLogicalUnit.log" "serialnum=10001" "model=XP1024" "devnum=1" "commanddevice=true" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
ModifyPool ModifyPool expands a THP/Smart pool or changes the settings related to the THP/Smart pool. NOTE: • This command can be used only with P9500 and XP24000/XP20000. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.3 or later.
[monitorendtime=end-time-of-performance-monitoring] [monitoringmode={0|1}] [bufspacesfornewpageassignment=buffer-space-for-new-page-assignment] [bufspacesfortierrelocation=buffer-space-for-hardware-tier-relocation] Format for XP24000/XP20000 When the command is used to expand a THP pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID adddevnums=device-number-of-logical-unit [threshold=THP-pool-threshold-1] [overprovisioningwarning=over-provisioning-warning-threshold]
Parameter name Status Description Threshold2 of the THP/Smart pool (%) The threshold2 of the THP/Smart pool is the usage rate of the THP/Smart pool. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: Optional threshold2#1 (P9500) A value cannot be specified for threshold2. For P9500 whose microcode version is 70-01-4X-XX/XX or later: If you specify this parameter, threshold2mode must be set to 1.
Parameter name Status Description Over provisioning limit threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: Specify an integer from 0 to 65534. You need to specify a value larger than the one specified for overprovisioningwarning. Specify -1 to cancel an already set threshold value.
Parameter name Status Description Execution cycle of performance monitoring and hardware tier relocation This parameter can be specified when automigration is set to enable. One of the following values can be specified. migrationinter- Optional val#1, #5 (P9500) • 0: 30 minutes • 1: 1 hour • 2: 2 hours • 4: 4 hours • 8: 8 hours • 24: 24 hours You can specify 0 only when the microcode version is 70-02-XX-XX/XX or later.
Parameter name Status Description Buffer space for new page assignment (%) Specify the percent of the space prepared for assignment of new pages for each hardware tier of a Smart pool. Before you specify this parameter, check how many hardware tiers the Smart pool has. You can check the number of hardware tiers by using the GetStorageArray (subtarget=Pool) command. You can specify an integer from 0 to 50.
#1 For P9500, you need to specify at least one of the following parameters: threshold, threshold2, threshold2mode, overprovisioningwarning, overprovisioninglimit, adddevnums, tiercontrol, automigration, migrationinterval, monitorstarttime, monitorendtime, or monitoringmode. #2 For XP24000/XP20000, you need to specify at least one of the following parameters: threshold, overprovisioningwarning, overprovisioninglimit, or adddevnums.
hdvmcli ModifyPool -o "D:\logs\ModifyPool.log" model=P9500 serialnum=53039 poolid=5 adddevnums=00:07:CF Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 numberOfLBAs=20,971,520 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3
arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 *****: The values are encoded by the CLI.
objectID=***** tierID=1 capacityInKB=4,085,760 freeCapacityInKB=4,085,760 usageRate=0 raidLevel=RAID5 combination=3D+1P rpm=7,200 diskType=4 substance=0 bufSpaceForNewPageAssignment=30 bufSpaceForTierRelocation=20 An instance of PoolTier objectID=***** tierID=2 capacityInKB=8,386,560 freeCapacityInKB=8,386,560 usageRate=0 raidLevel=Unknown combination=Unknown rpm=-1 diskType=-1 substance=1 bufSpaceForNewPageAssignment=30 bufSpaceForTierRelocation=40 *****: The values are encoded by the CLI.
Format for P9500 (when a connection other than an FCoE connection is used), XP24000/XP20000, and XP12000/XP10000/SVS200 hdvmcli [URL] ModifyPort [options] serialnum=serial-number model=model {port=port-number|portname=port-name} [topology=new-port-topology] [fibreaddr=new-fibre-channel-address-for-the-port] [channelspeed={0|1|2|4|8}] [lunsec={true|false}] [domain=domain-ID] [nickname={new-host-storage-domain-name|existing-host-storage-domain-name}] [newdomainnickname=new-host-storage-domain-name]] [hostmode
Parameters Table 75 ModifyPort command parameters Parameter name Status Description serialnum Required Serial number of the port's storage system model Required Model of the port's storage system Number of the port port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Port name portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Parameter name Status Description DomainID of the host storage domain domain Optional If you specify the nickname, newdomainnickname, hostmode, hostmodeoption, wwn, wwnnickname or newwwnnickname host storage domain attribute, you must also specify either the domain or nickname parameter. Note that when this parameter is specified, at least one host storage domain attribute must also be specified. This parameter can be specified in decimal and hexadecimal.
Parameter name Status Description Host mode for the port hostmode Optional If you specify this parameter, you must also specify the domain or nickname parameter. Optional List of host mode options (P9500 To specify two or more options, separate them with semicolons (;). XP24000 hostmodeoption For the values that can be specified, see Table 22. XP20000 XP12000 XP10000 SVS200) For details about the values that you can specify, see Table 23.
Parameter name Status Description The nickname for the WWN To specify two or more WWN nicknames, separate them with commas. The value specified for this parameter differs depending on whether wwn is specified. If wwn is specified: Specify the new nickname for WWN. If wwn is not specified: Specify the nickname for the WWN that is used to provide security for the host storage domain. If you specify the wwn parameter and do not specify the wwnnickname parameter, the WWN nickname will not be changed.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. Execute this command by specifying only the model and serialnum parameters, and Port for the subtarget parameter.
"topology=Fabric(off), FC-AL" fibreaddr=73 lunsec=false channelspeed=1 "wwn=22.33.44.55.44.55.44.33,11.33.22.33.44.33.22.22,55.66.77.88.44.33.22.22" "wwnnickname=Jane,Jone," Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Port elements: An instance of Port objectID=***** portID=16 portType=Fibre fibreAddress=73 topology=Fabric(off), FC-AL displayName=CL2-A lunSecurityEnabled=false controllerID=5 worldWidePortName=50.06.0E.80.03.
NOTE: This command can be used only with XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128. Parameters Table 76 ModifyPortController command parameters Parameter name Status Description serialnum Required Serial number of the port controller's storage system model Required Model of the port controller's storage system Number of the port controller ctrlid Optional Specify either ctrlid or controllername. Do not specify both parameters at the same time.
Command execution example hdvmcli ModifyPortController -o "D:\logs\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=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI.
Parameters Table 77 ModifyStorageArray command parameters Parameter name Status Description Serial number of the storage system. serialnum # Optional You cannot specify this parameter if the storage system is an SMI-S enabled storage system. Model of the storage system # model Optional saobjid Optional# You cannot specify this parameter if the storage system is an SMI-S enabled storage system. Object ID of the SMI-S enabled storage system Specify the object ID obtained from another CLI response.
objectID=***** name=R600#1 description=R600 (10007) at 10.208.115.
lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is encoded by the CLI. ModifyTieringPolicy The ModifyTieringPolicy command modifies the tiering policy.
Parameter name Status Description Maximum allocation threshold value (%) for Tier 1 allocationthresholdt1max#1 Optional#2 Specify the maximum capacity threshold value to be allocated for Tier 1 of virtual volumes to which the tiering policy has been applied. You can specify 0 or a multiple of 10, in the range from 0 to 100.
• Changes the maximum allocation threshold for Tier 3 to 40 (allocationthresholdt3max: 40) • Changes the minimum allocation threshold for Tier 3 to 10 (allocationthresholdt3min: 10) hdvmcli ModifyTieringPolicy model=P9500 serialnum=53039 allocationthresholdt1max=50 allocationthresholdt3max=40 -o "D:\logs\ModifyTieringPolicy.log" policyid=10 allocationthresholdt1min=20 allocationthresholdt3min=10 Command execution result RESPONSE: An instance of StorageArray . .
• If you are assigning a THP volume to a THP pool, the THP volume must not already be assigned to a THP pool. • If you are assigning a THP volume to a THP pool, the status of the THP pool must not be Blocked. • If you are assigning a THP pool, the over-provisioning percent must be less than the over provisioning limit threshold. • If you are releasing a THP volume from a THP pool, or if you are only changing the threshold value, the THP volume must already be assigned to a THP pool.
hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=true devnums=device-number-of-THP-volume poolid=pool-ID-of-THP-pool [threshold=usage-rate-threshold-of-THP-volumes] When the command is used to release the assignation between THP volumes and a THP pool: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=false devnums=device-number-of-THP-volume When the command is used to change the usage rate threshold of THP volumes: hdvmcli [URL]
Parameter name Status Description Usage rate threshold for the THP volumes (%) Specify this parameter when you are assigning THP volumes to a THP pool, or when you are changing the threshold value. Specify a multiple of 5 from 5 to 300. Optional threshold (XP24000 XP20000) If this parameter is omitted when true is specified for the assign parameter, 5 is set. This parameter must be specified if the assign parameter is omitted.
Parameter name Status Description Tiering policy to be applied to Smart volumes.
Parameter name Status Description New CLPR number Optional clprNumber (P9500) You can specify this parameter if a path has not been assigned to the THP/Smart volume. This parameter cannot be specified with the capacity, tieringpolicy, tierrelocation, or capacitytype parameter. To specify this parameter, microcode version 70-06-09-XX/XX or later is necessary. If the specified CLPR number is not in the storage system, an error occurs.
objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalV
An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=P9500 serialnum=15000 devnums=00:00:C4 tierrelocation=disable Command execution result 3 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Lu elements: An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
thpTier1ConsumedCapacityInKB=0 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=disable resourcePartitionUnitID=0 *****: The value is encoded by the CLI. RefreshPerformanceData RefreshPerformanceData obtains storage system performance information collected by HP StorageWorks P9000 Performance Advisor Software, and refreshes the Device Manager server database with the most recent information.
Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example In this example, the RefreshPerformanceData command refreshes performance information for a specific storage system.
Parameters Table 81 RefreshStorageArrays command parameter Parameter name Status Description Either of the following values can be specified to determine how storage systems are refreshed: refreshmode Optional • 1: Refreshes storage systems sequentially. • 2: Refreshes multiple storage system in parallel.# The default is 1.
Command execution result RESPONSE: [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.116.106 userID=root ] [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.40.1 ] . . (repeated for other StorageArray instances) .
Parameters Table 82 RunZeroPageReclaim Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP/Smart volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
numberOfLBAs=2,098,560 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold
Parameters Table 83 ShrinkPool command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system poolid Required Pool ID Specify the pool ID of the THP/Smart pool to be shrunk. Device number of the logical unit(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number.
hdvmcli ShrinkPool -o "D:\logs\ShrinkPool.log" model=P9500 serialnum=53039 poolid=1 devnums=00:06:0B Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 numberOfLBAs=20,972,160 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolume
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=1 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The value is encoded by the CLI.
Parameter name subtarget Status Optional Description Specify this parameter if you want to obtain information about an element in addition to information about the logical group. The only value that can be specified is Path. This setting is not case-sensitive. Type of the logical group to be obtained One of the following values can be specified. The values are not case-sensitive.
. . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. Command execution example 2 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=path" *****: The value is encoded by the CLI.
Command execution result 3 RESPONSE: An instance of LogicalGroup objectID=***** name=UG-B1 description=UG-B1 logicalPath=~UG-B1 capacity=3 capacityInKB=3,191,728 realCapacityInKB=3,191,728 percentUsed=0 numberOfLUNs=4 resourceType=0 specificationType=-1 An instance of LogicalGroup objectID=***** name=Volumes@UG-B1 description= parentID=***** logicalPath=~UG-B1/Volumes@UG-B1 capacity=3 capacityInKB=3,191,728 realCapacityInKB=3,191,728 percentUsed=0 numberOfLUNs=4 resourceType=2 specificationType=1 *****: T
domain=domain-ID [scsi=SCSI-ID] lun=valid-LUN {devnum=device-number|lusedevnums=list-of-LDEV-numbers} NOTE: When setting up a LUN (path) to an LU to which a LUSE is already set, like the following command, you must specify devnum of the representative LDEV which constitutes the LUSE, and run AddLun.
Parameter name Status Description lun Required Actual LUN used for new path Device number used to identify the new path (not provided when a LUSE is defined) For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
parameter, and freelun for the hsdsubinfo parameter. In the execution result of this command, the portID, domainID and nickname values appear under An instance of HostStorageDomain. Use these portID values to specify the port parameter. Use the domainID value to specify the domain parameter, or use the nickname value to specify the domainnickname parameter. For the lun parameter, specify one of the lun values that appear under An instance of FreeLUN.
objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversal
diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. Command execution example 2 hdvmcli AddLun -o "D:\logs\AddLun.
NOTE: When security is set for a host storage domain, the LUN security setting of a port to which the host storage domain belongs is automatically enabled. Make sure that the I/Os of the target port are stopped.
Parameter name Status Description Comma-separated list of WWNs to secure the host storage domain wwn Required If you use the HostScan command to register a host in Device Manager, every WWN that you specify in the wwn parameter must be a WWN used by that host only. In this case, the value specified for the domainnickname parameter is used as the name of the host. For details about the HostScan command, see “HostScan” on page 300.
serialnum parameters, Port for the subtarget parameter, and WWN for the portsubinfo parameter. In the execution result of this command, the wwn value appears under An instance of WWN. Use this wwn value to specify the wwn parameter. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter.
Parameters Table 87 DeleteLun command parameters Parameter name Status Description serialnum Required Serial number of the path's storage system model Required Model of the path's storage system Port number of the path port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Port name of the path portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port, domain, and devnum Obtain these values from the execution result of the GetStorageArray (subtarget=Path) command. Execute this command by specifying only the model and serialnum parameters, and Path for the subtarget parameter.
Parameter name Status Description Port name portname Optional wwn Required Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. WWN to delete from the port Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 89 DeleteWWNForHostStorageDomain command parameters Parameter name Status Description serialnum Required Serial number of the storage system for the host storage domain model Required Model of the storage system for the host storage domain Port ID of the host storage domain Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs.
domain, port, and wwn Obtain these values from the execution result of the GetStorageArray (subtarget=HostStorageDomain, hsdsubinfo=WWN) command. Execute this command by specifying only the model and serialnum parameters, HostStorageDomain for the subtarget parameter, and WWN for the hsdsubinfo parameter. In the execution result of this command, the domainID and portID values appear under An instance of HostStorageDomain.
AddHost AddHost adds information about a host server to the Device Manager server. NOTE: To register a virtualization server by using vMA or Host Data Collector, use the AddVirtualizationServer command.
Parameter name Status Description OS type of the host One of the following values can be specified. The values are not case-sensitive. If you register a normal host: - AIX - HP-UX - Linux - SunOS - Windows ostype Optional - Others If you register a virtualization server: VMware If you specify this parameter, the host type is automatically set to normal host or virtualization server. Do not specify this parameter and the hosttype parameter at the same time.
objectID=***** name=toro2 hostID=279 ipAddress=192.168.32.63 capacityInKB=0 hostType=3 managedBy=-1 osType=VMware statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddHostInfo AddHostInfo adds host-based information about a LUN (information about storage used by hosts). NOTE: This command does not support virtualization servers.
Parameter name Status Description Device number of the path For P9500 and XP24000/XP20000: devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
• HostInfo record name: MY_HOSTINFO_XP1024 • Host IP address: 172.16.64.159 • Mount point: C: • File system type: NTFS • File name: C: • SCSI bus number: 0 • Host LUN: 1 • HBA WWN: 11.22.33.44.55.66.77.88 • LUN size: 10MB • LUN in use: 10% hdvmcli AddHostInfo -o "D:\logs\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.
NOTE: • This command does not support virtualization servers. To refresh the information of a virtualization server that was registered with vMA or Host Data Collector, use the RefreshVirtualizationServer command. • If the copy pair management host is unable to recognize a copy pair that was created on a host that is not the copy pair management host, the copy status of that copy pair cannot be refreshed even if the AddHostRefresh command is executed.
hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of Host objectID=***** name=rise hostID=5 ipAddress=192.168.32.164 capacityInKB=0 hostType=-1 managedBy=-1 osType=Windows statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database by using vMA or Host Data Collector.
NOTE: • Use the AddHost command to register a virtualization server without using vMA or Host Data Collector. • This command can be used to register the following versions of virtualization servers: - If using vMA: VMware ESX 4.x or VMware ESXi 4.x - If using Host Data Collector: VMware ESX 4.x, VMware ESXi 4.x, or VMware ESXi 5.x • The information collection method of a virtualization server that was registered with vMA can be switched to using Host Data Collector.
Parameters Table 93 AddVirtualizationServer command parameters Parameter name Status Description IP address ipaddress Required For details about specifiable values, see Table 94. You can specify an IPv4 or IPv6 IP address. Value indicating the host type hosttype Required Specify 3.
As shown in the following table, the values to be specified for the parameters ipaddress, hostprotocol, hostuserid, and hostuserpassword depend on the management environment of the virtualization server.
Command execution example 1 This example uses vMA (IP address: 10.208.119.114) to detect two virtualization servers (VMware ESX, host type: 3), and then registers the information about the detected virtualization servers into the Device Manager server database. hdvmcli AddVirtualizationServer -o "D:\logs\AddVirtualizationServer.log" ipaddress=10.208.119.
hdvmcli AddVirtualizationServer -o "D:\logs\AddVirtualizationServer.log" ipaddress=10.208.119.113 hosttype=3 hostprotocol=Secure hostuserid=root "hostuserpassword=boss!" hdcipaddress=10.208.119.110 Command execution result 2 RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 managedBy=1 osType=VMware statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 2 WWN elements: An instance of WWN WWN=21.00.00.24.FF.2C.AE.
You must specify either objectid or hostname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetHost command. In the execution result of this command, the objectID value appears under An instance of Host. Use this objectID value to specify the objectid parameter. hostname Obtain this value from the execution result of the GetHost command.
Obtain this value from the execution result of the GetHostInfo command. In the execution result of this command, the objectID value appears under An instance of HostInfo. Use this objectID value to specify the objectid parameter. Command execution example hdvmcli DeleteHostInfo -o "D:\logs\DeleteHostInfo.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE (Command completed; no data returned) GetHost GetHost returns the information about hosts.
When obtaining information about a particular snapshot group related to the host, or information for a Fast Snap copy pair that belongs to the particular snapshot group: hdvmcli [URL] GetHost [options] objectid=object-ID-of-host-for-which-information-is-obtained model=storage-system-model-of-snapshot-group-for-which-information-is-obtained serialnum=serial-number-for-storage-system-of-snapshot-groupfor-which-information-is-obtained subtarget=SnapshotGroup {snapshotgroupid=ID-of-snapshot-group-for-which-info
Parameter name Status Description Type of the host that acquires information Omit this parameter when all hosts are the target. You can specify the following values: • NORMAL: Normal host • EXT_PORT: External port hostfilter Optional • MAINFRAME: Mainframe host • VMWARE_ESX: Virtualization server (VMware ESX or VMware ESXi) To specify two or more values, separate them with semicolons (;). Do not specify the objectid and hostname parameters at the same time.
Parameter name Status Description ID of the snapshot group for which information is obtained snapshotgroupid Optional If you specify the snapshotgrpsubinfo parameter, you must also specify either the snapshotgroupid parameter or the snapshotgroupname parameter. Name of the snapshot group for which information is obtained snapshotgroupname Optional If you specify the snapshotgrpsubinfo parameter, you must also specify either the snapshotgroupid parameter or the snapshotgroupname parameter.
Command execution result 1 RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 managedBy=2 osType=Others statusOfDBUpdating=0 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.
svolPoolID=-1 replicationFunction=BusinessCopy status=8 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 An instance of ReplicationInfo objectID=***** pairName=HCMD_CP0002 pvolSerialNumber=65010001 pvolArrayType=XP1024 pvolDevNum=101 displayPvolDevNum=00:65 pvolObjectID=***** pvolPoolID=-1 svolArrayType=XP1024 svolSerialNumber=65010001 svolDevNum=102 displaySvolDevNum=00:66 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessC
capacityInKB=408,103,872 hostType=-1 managedBy=2 osType=Windows statusOfDBUpdating=0 List of 2 WWN elements: An instance of WWN WWN=23.88.00.00.87.1A.D9.22 An instance of WWN WWN=23.88.00.00.87.1A.D9.
objectID=***** name=testmf hostID=1 capacityInKB=0 hostType=2 managedBy=2 statusOfDBUpdating=-1 An instance of Host objectID=***** name=testmf2 hostID=2 capacityInKB=0 hostType=2 managedBy=2 statusOfDBUpdating=-1 *****: The values are encoded by the CLI. Command execution example 4 In this example, the command obtains information about the logical unit that is assigned to the host (hostname = test).
commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=0 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=2,000,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 3 Path
lun=20 devNum=1,008 displayDevNum=00:03:F0 osScsiBus=1 osScsiID=4 osLun=20 portWWN=10.00.00.00.C9.6F.EB.D6 fileSystemType=Datastore fileSystemName= datastoreName=R600#2_1 sizeInMB=1,953 percentUsed=-1 lastUpdated=1254708417 An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) . *****: The values are encoded by the CLI. Command execution example 5 This example obtains information about a virtualization server (hostname = boss.
*****: The value is encoded by the CLI. Command execution result 5-2: when managing the virtualization server with Host Data Collector (IP address: 10.208.119.110) In the execution result, hdcIPAddress appears in the CommParameters instance, indicating that the virtualization server is being managed by Host Data Collector. RESPONSE: An instance of Host objectID=***** name=boss.
virtualizationServerVersion=VMware ESXi 4.1.0 build-260247 List of 2 WWN elements: An instance of WWN WWN=10.00.00.00.C9.95.30.81 An instance of WWN WWN=10.00.00.00.C9.95.30.80 List of 2 VM elements: An instance of VM vmID=***** name=vm1 guestOSVersion=Microsoft Windows Server 2008 R2 (64-bit) List of 2 VirtualDisk elements: An instance of VirtualDisk vmDiskID=***** name=[ds1] vm1/vm1.vmdk datastoreID=datastore-1191 An instance of VirtualDisk vmDiskID=***** name=[ds1] vm1/vm1_1.
GetHostInfo GetHostInfo returns the host-based information about a LUN. NOTE: If two or more paths are set from a virtualization server for a single volume, the values for the portID attribute, domainID attribute, and scsiID attribute for the HostInfo instance for the target volume might not be correct. Use the management client for the virtualization server to check this information.
devNum=3 displayDevNum=00:03 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 *****: The value is encoded by the CLI. Command execution example 2 hdvmcli GetHostInfo -o "D:\logs\GetHostInfo.log" Command execution result 2 RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.
that was assigned to the host storage domain. In an environment that satisfies the following conditions, the HostScan command can be used to easily register hosts into the Device Manager server: (1) all WWNs in one host storage domain must be assigned to one host only, and (2) that host name is set as the nickname of the host storage domain. The following lists the conditions for using the HostScan command: • LUN Manager is installed on the storage system.
Parameters Table 99 HostScan command parameters Parameter name serialnum model option Status Description #1, #2 Optional #1, #2 Optional Optional#1 Parameter used to specify the serial numbers of the storage systems for which a host scan is to be performed. Use a comma to delimit multiple values. Parameter used to specify the models of the storage systems for which a host scan is to be performed. Use a comma to delimit multiple values. Parameter used to perform a host scan for all storage systems.
NOTE: • If you add hosts, the imported hosts are registered as normal hosts or virtualization servers. • To update (overwrite) host information, confirm that the hosts to be updated have been registered manually (hosts registered by using the AddHost command or the HostScancommand). The ImportHosts command only updates normal hosts or virtualization servers that were manually registered by using the Device Manager GUI or CLI.
Parameter name Status Description Mapping definition file name mappingfile Optional Use an absolute path or relative path to specify a property format file that associates the information in the host information file with the host information to be imported. If this parameter is omitted, import.properties in the Device Manager CLI installation directory or folder is used as the mapping definition file.
Command execution result 1 RESPONSE: Verification of records from 1 to 15 in "D:\work\hostImport.csv" is complete. Number of hosts that can be imported = 10 Number of hosts that cannot be imported = 5 Number of hosts that can be imported but for which a warning was given = 1 See "D:\work\ImportHostsCheckResult-20120515113355.txt" for information about the hosts that can be imported. See "D:\work\ImportHostsResult-20120515113355.log" for details about errors and warnings.
The following describes the output items: • Number of hosts added Number of added hosts (including the value for Number of hosts added or updated with a warning) • Number of hosts updated Number of updated (overwritten) hosts (including the value for Number of hosts added or updated with a warning) This item is output only when true is specified for the overwrite parameter.
Command execution example hdvmcli MergeHost -o "D:\logs\MergeHost.log" "targetname=host0" "hostnames=host6,host7" Command execution result RESPONSE: An instance of Host objectID=***** name=host0 hostID=1 capacityInKB=0 hostType=3 managedBy=-1 osType=VMware statusOfDBUpdating=0 List of 2 WWN elements: An instance of WWN WWN=50.06.0E.80.05.27.35.47 An instance of WWN WWN=10.00.00.00.C9.3D.2A.88 *****: The value is encoded by the CLI. ModifyHost ModifyHost modifies information about a host server.
Parameters Table 102 ModifyHost command parameters Parameter name Status objectid Optional Description Object ID of the host to modify You must specify objectid or hostname. Name of the host to modify Omit this parameter if you do not want to change the name. You can use a character string of 1-64 bytes for a name. The value specified for this parameter differs depending on whether objectid is specified. When objectid is specified: hostname Optional Specify the new name of the host.
Parameter name Status Description OS type of the host after modification One of the following values can be specified. The values are not case-sensitive. • AIX • HP-UX • Linux • SunOS ostype Optional • Windows • VMware • Others If you specify VMware in this parameter, the host type will be virtualization server. If you specify a value other than VMware, the host type will be normal host. You can specify this parameter for a host whose host type is normal host or virtualization server.
Command execution result RESPONSE An instance of Host objectID=***** name=snow hostID=1 ipAddress=172.18.32.9 capacityInKB=0 hostType=3 managedBy=-1 osType=VMware statusOfDBUpdating=0 List of 2 WWN elements: An instance of WWN WWN=12.34.56.78.90.AB.CD.EF An instance of WWN WWN=01.23.45.67.89.AB.CD.EF *****: The value is encoded by the CLI. ModifyHostInfo ModifyHostInfo modifies a HostInfo record in the Device Manager server. NOTE: This command does not support virtualization servers.
Parameter name Status ipv6address Optional mountpoint Optional Description New IPv6 IP address of the host Omit this parameter if you are not changing the IPv6 IP address of the host. New mount point on the host file system corresponding to the path Omit this when no change is required. New port on the path Omit this when no change is required. port Optional When this is changed, port or portname must be specified. Do not specify both parameters at the same time.
Parameter name Status size Optional percentused Optional Description New LUN size in MB Omit this when no change is required. New percentage of the LUN in use Omit this when no change is required. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
"port=7" "domain=0" "devnum=2" "portwwn=11.33.55.77.99.BB.DD.FF" "filetype=NTFS1" "filename=oo" "size=156" "percentused=50" *****: The value is encoded by the CLI. Command execution result RESPONSE An instance of HostInfo objectID=***** name=MY_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=111.111.111.111 mountPoint=E: portID=7 portName=CL1-H domainID=0 scsiID=15 lun=2 devNum=2 displayDevNum=00:02 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.33.55.77.99.BB.DD.
NOTE: • To change the information of a virtualization server that was not registered with vMA or Host Data Collector, use the ModifyHost command. • This command can be used for the following versions of virtualization servers: - If using vMA: VMware ESX 4.x or VMware ESXi 4.x - If using Host Data Collector: VMware ESX 4.x, VMware ESXi 4.x, or VMware ESXi 5.x • The information collection method of a virtualization server registered with vMA can be switched to using Host Data Collector.
Specify the value of VMware vCenter Server in a configuration in which VMware vCenter Server is used to perform integrated management on virtualization servers. Parameters Table 104 ModifyVirtualizationServer command parameters Parameter name Status Description hostname Required Host name of the virtualization server whose information is to be modified ipaddress Optional#1 To modify the IP address, specify in IPv4 or IPv6 format. For details about modifiable values, see Table 94.
the name value appears under An instance of Host. In the hostname parameter, specify the name value for the virtualization server whose information you want to modify. Command execution example 1 This example modifies the password for a program that is used for managing a virtualization server (host name: boss.boss), and registers the modified information into the Device Manager server database.
managedBy=1 osType=VMware statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 2 WWN elements: An instance of WWN WWN=21.00.00.24.FF.2C.AE.19 An instance of WWN WWN=21.00.00.24.FF.2C.AE.18 List of 1 CommParameters elements: An instance of CommParameters hdcIPAddress=10.208.119.110 ipAddress=10.208.119.113 portNumber=443 protocol=Secure userID=root *****: The value is encoded by the CLI.
Command execution result 1-1: when managing the virtualization server with vMA (IP address: 10.208.119.114) RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 managedBy=3 osType=VMware statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.114 portNumber=5989 protocol=Secure userID=vi-admin *****: The value is encoded by the CLI.
Commands related to server management The Server Management commands provide some management support for the Device Manager server. AddURLLink AddURLLink allows a user to specify URL information (referred to as a URLLink) for a Device Manager object managed by the Device Manager server. AddURLLink is used for the following purposes: • To specify a URLLink for an SMI-S enabled storage system The URL information of the software started from Element Manager of the GUI is modified.
Parameter name Status Description Object ID of the Device Manager object for which the URLLink is set linkedid Required Must be a valid, existing the object ID. Specify the object ID obtained from another CLI response. The value is encoded by the CLI. If you specify an SMI-S enabled storage system object ID for the linkedid parameter, any URLLink that has already been specified for the SMI-S enabled storage system is overwritten.
Parameters Table 107 DeleteAlerts command parameters Parameter name Status Description alertnum Optional# The number identifying the alert to delete source Optional# Identifies a source of alerts; all alerts from this source are deleted. # Specify either alertnum or source. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs.
NOTE: This command does not support virtualization servers.
The DeleteURLLink command only deletes URLLinks set by a user. The command cannot delete URLLinks that are automatically set by the Device Manager server when an SMI-S enabled storage system is initially registered. Command execution example hdvmcli DeleteURLLink -o "D:\logs\DeleteURLLink.log" "objectid=*****" "targetoption=smi-s" *****: The value is encoded by the CLI.
Command execution result RESPONSE An instance of Alerts Contains 2Alert instances: An instance of Alert number=2 type=Server source=***** 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=***** severity=4 component=DKC processor description=Moderate error detected on DKC processor. actionToTake=Contact Customer Support.
displayArrayFamily=AMS/WMS/SMS An instance of StorageArray arrayFamily=HDS9500V displayArrayFamily=HDS9500V An instance of StorageArray arrayFamily=XP1024/128 displayArrayFamily=HDS9900V An instance of StorageArray arrayFamily=HUS displayArrayFamily=HUS An instance of StorageArray arrayFamily=P9500 displayArrayFamily=P9500 An instance of StorageArray arrayFamily=XP12K/10K/SVS200 displayArrayFamily=USP An instance of StorageArray arrayFamily=XP24K/20K displayArrayFamily=USP_V An instance of StorageArray arra
When obtaining URLLink information for a particular Device Manager object that is not an SMI-S enabled storage system: hdvmcli [URL] GetURLLink [options] {objectid=object-ID-of-the-URLLink |linkedid=object-ID-of-the-Device-Manager-object} [targetoption=other] Parameters Table 110 GetURLLink command parameters Parameter name Status Description The object ID of the URLLink for which you want to obtain information objectid Optional# Specify the object ID obtained from another CLI response.
"objectid=*****" "targetoption=smi-s" *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of URLLink objectID=***** name=test url=http://10.208.184.97 linkedID=***** createdByUser=1 *****: The values are encoded by the CLI. Commands related to replication The Replication commands can be used to manage copy pairs.
[svolpoolid=pool-ID] [svolportid=port-number|svolportname=port-name] replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] • Method 2: Adds a copy group to the RAID Manager configuration definition file, and adds a copy pair definition to the copy group.
Parameters Table 111 AddConfigFileForReplication command parameters Parameter name Status Description Group name used in the RAID Manager groupname Optional You can use a maximum of 31 bytes. You cannot specify a name that begins with a hash mark (#) or hyphen (-). When using Method 1, specify a group name that is specified in the definition file. You must specify this parameter when you are using method 1.
Parameter name Status Description Device number of the P-VOL For P9500 and XP24000/XP20000: pvoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Parameter name Status Description MU number of the P-VOL This parameter can be specified only for Continuous Access Journal Software. munum Optional For Continuous Access Journal Software if this parameter is not specified, the MU number of the created HORCM configuration file for RAID Manager is set to 1. For Business Copy Software or Snapshot, the MU number of the created HORCM configuration file for RAID Manager is set to 0.
See No. 2, No. 5, No. 6, and No. 7 in the table below. Table 112 How to obtain parameter values (AddConfigFileForReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the P-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile, and the groupName value under An instance of ReplicationGroup.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile (configuration definition file information).
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=LogicalUnit) with LogicalUnit specified for the subtarget parameter and the object ID of the logical unit to be used as the P-VOL or the S-VOL (the object ID recorded in No. 5) specified for the objectID parameter. pvolarraytype 6 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"pvoldevnum=5" "svolarraytype=XP12000" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" Command execution result 1 RESPONSE (Command completed; empty list returned) Command execution example 2 This example creates a group in the configuration files, and then adds pairs to the group: hdvmcli AddConfigFileForReplication -o "D:\logs\AddConfigFileForReplication.
Continuous Access Journal Software. When you create a copy pair, the HORCM configuration file for RAID Manager, contained in the host, is rewritten. To create Fast Snap copy pairs, see “AddReplication (For Fast Snap)” on page 350. NOTE: • This command is not available for XP1024/XP128. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs.
[pvolportid=port-number|pvolportname=port-name] [pvolpoolid=pool-ID] svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=port-number|svolportname=port-name] [svolpoolid=pool-ID] replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] [fencelevel=fence-level] [copytracksize=copy-pace] [pairoption=suspend] • Method 3: Create a new RAID Manager configuration definition file, creates a copy group, then ad
Parameter name Status Description ID of the host that recognizes the primary volume (P-VOL) pvolhostid Optional If you are using method 2 or 3, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored. Number of the HORCM instance that manages the P-VOL pvolinstancenum Optional If you are using method 2, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored.
Parameter name Status Description Device number of the P-VOL For P9500 and XP24000/XP20000: pvoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Parameter name Status Description Fence level of the P-VOL This parameter applies only when Continuous Access Synchronous Software is being used. In other cases, the value specified for this parameter is ignored. You can specify the following values: fencelevel Optional • Never: If you specify Never, a host write request to the PVOL will not be rejected even though the MCU was able to change the status of a S-VOL pair into the suspend status.
See No. 2, No. 4, No. 5, and No. 6 in the table below. Table 114 How to obtain parameter values (AddReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the PVOL is installed.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the P-VOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile (configuration definition file information).
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=LogicalUnit) with LogicalUnit specified for the subtarget parameter and the object ID of the logical unit to be used as the P-VOL or the S-VOL (the object ID recorded in No. 4) specified for the objectID parameter. pvolarraytype 5 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"pvolarraytype=XP1024" "pvolserialnum=65010001" "pvoldevnum=5" "svolarraytype=XP1024" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" "fencelevel=Data" Command execution result 1 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=0 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.
device with LDEV number 11 in the storage system with model number XP1024 and serial number 15001. The ID of the host that recognizes the primary volume is 1 and the instance number of the HORCM that manages the primary volume is 11. Similarly, as the secondary volume (S-VOL), specify the logical device with LDEV number 12 in the storage system with model number XP1024 and serial number 15001.
pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 *****: The values are encoded by the CLI. 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 Synchronous Software in the copy group. As the primary volume (P-VOL), specify the logical device with LDEV number 11 in the storage system with model number XP1024 and serial number 15001.
pvolPoolID=-1 svolSerialNumber=35001 svolArrayType=XP128 svolDevNum=128 displaySvolDevNum=00:80 svolObjectID=***** svolPoolID=-1 fenceLevel=Never replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=14 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 *****: The values are encoded by the CLI. AddReplication (For Fast Snap) The AddReplication command creates copy pairs.
• Method 2: Create a snapshot group, and then add a copy pair to that snapshot group.
Parameter name Status Description Snapshot group name Use a maximum of 32 bytes for a group name. The group name cannot begin with a hyphen (-). snapshotgroupname Optional For details about the characters that can be used group names, follow the rules for RAID Manager. This parameter is ignored if the snapshotgroupid parameter is specified. replicationfunction Required Type of operation that is to be executed with the copy pair Specify FastSnap.
includes below it An instance of LogicalUnit for which the specified objectID is displayed. Use the value of arrayType or displayArrayType to specify the pvolarraytype parameter, and use the value of serialNumber to specify the pvolserialnum parameter. When you specify these parameters, record the values of the pvolarraytype and pvolserialnum parameters.
objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=5 displayPvolDevNum=00:00:05 pvolPoolID=7 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=10 displaySvolDevNum=00:00:0A svolPoolID=7 replicationFunction=FastSnap status=16 muNumber=6 copyTrackSize=-1 splitTime=1,385,028,155 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=5 *****: The values are encoded by the CLI.
serialNumber=10001 groupID=1 groupName=test1 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=5 displayPvolDevNum=00:00:05 pvolPoolID=7 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=10 displaySvolDevNum=00:00:0A svolPoolID=7 replicationFunction=FastSnap status=16 muNumber=6 copyTrackSize=-1 splitTime=1,385,028,155 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID
NOTE: • This command is not available for XP1024/XP128. • You cannot execute any operations for Fast Snap copy pairs defined in the HORCM configuration file. • For Fast Snap, you cannot use the Device Manager CLI to perform any operations for consistency groups. • To delete a specific copy pair from a copy group, you must specify pvolserialnum, pvoldevnum, svolserialnum (or svolsequencenum), and svoldevnum. If you omit all of these parameters, the system deletes all copy pairs in the specified copy group.
Parameter name Status Description Serial number of the storage system that contains the S-VOL svolserialnum Optional svolsequencenum Optional If you specify this parameter, do not specify the svolsequencenum parameter. If they are specified at the same time, an error occurs. Sequence number of the storage system that contains the S-VOL If you specify this parameter, do not specify the svolserialnum parameter. If they are specified at the same time, an error occurs.
pvolDevNum in the pvoldevnum parameter, the value of svolSerialNumber in the svolserialnum parameter, and the value of svolDevNum in the svoldevnum parameter. svolsequencenum Obtain the parameter value from the execution result of the GetStorageArray command for the storage system that contains the S-VOL. Specify the value of sequenceNumber that is displayed as An instance of StorageArray in the svolsequencenum parameter.
An instance of ReplicationGroup objectID=***** replicationGroupID=7 groupName=HCMD_CG0007 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
Command execution result 2 RESPONSE (Command completed; empty list returned) Command execution example 3 This example deletes a Fast Snap copy pair that belongs to the snapshot group 8. The primary volume (P-VOL) of the copy pair is the logical device with LDEV number 10 in the storage system with model number P9500 and serial number 10001. The secondary volume (S-VOL) is the logical device with LDEV number 11 in the storage system with model number P9500 and serial number 10001.
svolPoolID=38 replicationFunction=FastSnap status=16 muNumber=988 copyTrackSize=-1 splitTime=1,385,186,735 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=8 *****: The values are encoded by the CLI. Command execution example 4 This example deletes snapshot group 8 and all the copy pairs that are defined in the snapshot group. hdvmcli DeleteReplication -o "D:\logs\DeleteReplication.
Parameters Table 117 GetReplicationControllerPair command parameters Parameter name Status Description masterserialnum Optional# Serial number of the storage system that contains the main control unit (MCU) mastercontrollerid Optional# CU number of the MCU remoteserialnum Optional# Serial number of the storage system that contains the remote control unit (RCU) remotessid Optional# SSID of the RCU mastermodel Optional# Model of the storage system that contains the MCU remotefamily Optional
hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
remoteSSID=0 remoteControllerID=0 remotePathGroupID=165 remoteStartDevNum=-1 remoteEndDevNum=-1 pairType=0 bandwidth=-1 numOfMinConnection=1 . . (repeated for other ReplicationControllerPair instances) . *****: The value is encoded by the CLI. ModifyReplication The ModifyReplication command is used to change the status of a copy pair. NOTE: • You cannot execute any operations for Fast Snap copy pairs defined in the HORCM configuration file.
Parameter name Status Description 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). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot or Fast Snap copy pair, the copy pair is split after the re-synchronization. For this reason, the paired volume status is set to PAIR, and then changes toPSUS.
Parameter name Status Description Copy pace You can specify an integer from 1 to 15. copytracksize Optional 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. If split or resync is specified for the operation parameter, this parameter is ignored.
hostid Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the raidcom command for RAID Manager (raidcom command) that manages the P-VOL is installed. The execution results of the GetHost command displays the hostID value under An instance of Host. Use the hostID value to specify the hostid parameter.
svolHORCMINSTHostName=192.168.32.
managedBy=2 osType=Windows statusOfDBUpdating=0 List of 1 SnapshotGroup elements: An instance of SnapshotGroup objectID=***** arrayType=P9500 serialNumber=10001 groupID=12 groupName=test12 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=20 displayPvolDevNum=00:00:14 pvolPoolID=1 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=21 displaySvolDevNum=00:00:15 svolPoolID=1 repli
Command reference
5 Output items This chapter describes items that are output by Device Manager CLI commands. The items are output for each instance as attributes of Device Manager instances. The meaning of items that have the same name might differ for different instances. When you reference an output item, check the instance of the item.
Attribute Description timeOfAlert Time at which the alert occurred (example: 2008/04/06 20:13:56) ArrayGroup instance Commands for which an ArrayGroup instance is output • • • • • • • • AddExternalArrayGroup, page 51 AddPool, page 78 AddVirtualVolume, page 96 GetStorageArray (subtarget=ArrayGroup) , page 139 GetStorageArray (subtarget=FreeSpace) , page 150 GetStorageArray (subtarget=PDEV) , page 176 GetStorageArray (subtarget=Pool) , page 178 ModifyPool, page 215 Table 120 ArrayGroup instance attribut
Attribute Description diskSize Size (in GB units for type tag) of physical drives that make up the parity group (example: 72) 0 is output for an external volume. diskSizeInKB Actual size (in KB) of physical drives that make up the parity group (example: 75,497,472) 0 is output for an external volume. formFactor Currently, this information does not apply to storage systems (-1 is output).
Attribute Description openAutoLunCapacity Total size of all open LDEVs reserved for Auto LUN Software in the parity group (in KB) openOnDemandCapacity Total size of all open LDEVs expanded on demand in the parity group (in KB) imTotalCapacity Total size of all intermediate LDEVs in the parity group (in KB) imAllocatedCapacity Total size of all intermediate LDEVs assigned paths in the parity group (in KB) imFreeCapacity Total size of all intermediate LDEVs that are not assigned paths in the parity
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openReservedActualCapacity • Paths are not assigned. • Paths cannot be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity.
Attribute Description Protection level of the parity group For P9500 or XP24000/XP20000, one of the following values is output: • 0: Standard The parity group consists of drives other than SATA drives • 1: SATA-W/V The parity group consists of SATA drives • 2: SATA-E protectionLevel The parity group consists of SATA drives and the write performance is more enhanced than SATA-W/V -1 is output if any of the following conditions are satisfied: • The protection level of the parity group is unknown.
CommParameters instance Commands for which a CommParameters instance is output • • • • • • • AddStorageArray, page 88 AddVirtualizationServer, page 280 GetHost, page 287 GetStorageArray (subtarget=CommParameters) , page 143 ModifyVirtualizationServer, page 313 RefreshStorageArrays, page 249 RefreshVirtualizationServer, page 317 Table 122 CommParameters instance attributes Attribute Description User ID For a storage system: User ID for accessing the storage system For SMI-S enabled storage systems: userI
Attribute Description Protocol For SMI-S enabled storage systems: Data transfer protocol of the SMI-S provider - Non-secure: HTTP communication - Secure: HTTPS communication For a virtualization server that was registered with vMA or Host Data Collector: protocol Communication protocol for acquiring information about the virtualization server - Non-secure: HTTP communication - Secure: HTTPS communication For details about output values, see the description about parameter hostprotocol in Table 94.
Component instance Commands for which a Component instance is output • GetStorageArray (subtarget=Component) , page 145 Table 123 Component instance attributes Attribute Description Component name For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128: • DKC Battery: Status of all batteries • DKC Cache: Status of the controller cache • DKC Cache Switch: Status of the internal bus • DKC Environment: Status of the controller environment name • DKC Fan: Status of controller fans • DKC Power Sup
ConfigFile instance Commands for which a ConfigFile instance is output • GetHost, page 287 Table 124 ConfigFile instance attributes Attribute Description objectID Object ID of the configuration definition file for RAID Manager instanceNumber Instance number of the HORCM instance. controlledBy Name of the program that defines the configuration of the copy pair portNumber Port number of the HORCM instance Indicates whether HORCM instance can operate. valid • 0: The HORCM instance can operate.
• AddExternalArrayGroup, page 51 Table 126 ExternalPathInfo instance attributes Attribute Description objectID Object ID of the external path information externalWWN Port WWN of the external storage system externalLun LUN of the external volume portID Port ID of the port to which the external storage system is connected pathGroupID Path group ID Path priority • -1: None priority • 1: Primary path • 2 or greater: Alternate path ExternalStorage instance Commands for which an ExternalStorage inst
FreeSpace instance Commands for which a FreeSpace instance is output • AddExternalArrayGroup, page 51 • AddVirtualVolume, page 96 • GetStorageArray (subtarget=FreeSpace) , page 150 Table 129 FreeSpace instance attributes Attribute Description objectID Object ID of a region of unused capacity in the parity group sizeInKB Size of a region of unused capacity in the parity group (in KB) Number of cylinders in a region of unused capacity in the parity group cylinders 0 is output for open volumes.
Attribute Description hostID ID of the host ipAddress IPv4 IP address of the host ipv6Address IPv6 IP address of the host Size of the LDEV allocated to the host (in KB) capacityInKB For mainframe hosts, the value output for this attribute is 0. Host type • -1: Normal host hostType • 1: External port • 2: Mainframe host • 3: Virtualization server (VMware ESX or VMware ESXi) Data source of the host • 1: Host Data Collector managedBy • 2: Device Manager agent • 3: vMA In other cases, -1 is output.
HostInfo instance Commands for which a HostInfo instance is output • • • • • • AddHostInfo, page 276 GetHost, page 287 GetHostInfo, page 299 GetStorageArray (subtarget=LogicalUnit) , page 163 GetStorageArray (subtarget=Path) , page 172 ModifyHostInfo, page 310 Table 131 HostInfo instance attributes Attribute Description objectID Object ID of HostInfo arrayType Type (model) of the storage system connected to the host serialNumber Serial number of the storage system connected to the host Display name
Attribute Description Type of the file system to be mounted fileSystemType The name of the disk type (Datastore or Raw LUN) is output for a virtualization server. Note that if the volume is not used as a datastore or Raw Device Mapping, a space is output. File system name fileSystemName A space is output for a virtualization server. Datastore name for a virtualization server datastoreName Datastore identification name or datastore mapping file name is output for a virtualization server.
NOTE: In the Device Manager CLI, host storage domain information is output as the HostStorageDomain instance even if the LUN security for the port is disabled. Table 132 HostStorageDomain instance attributes Attribute Description objectID Object ID of the host storage domain Name of the host storage domain name This is a user-specified name and used only by Device Manager to identify the host storage domain. This item is output only if it has been registered.
LDEV instance Commands for which an LDEV instance is output • • • • • • • • • • • AddLogicalUnit, page 68 AddLun, page 260 AddLUSE, page 74 AddVirtualVolume, page 96 FormatLU, page 121 GetStorageArray (subtarget=ArrayGroup) , page 139 GetStorageArray (subtarget=LDEV) , page 158 GetStorageArray (subtarget=LogicalUnit) , page 163 GetStorageArray (subtarget=MFReplicationInfo) , page 168 GetStorageArray (subtarget=Pool) , page 178 ModifyVirtualVolume, page 239 Table 134 LDEV instance attributes Attribute Des
Attribute Description lba Number of LBAs (capacity in blocks) RAID type of the LDEV The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]). • RAIDx: RAID level raidType • yD: Number of data drives • zP: Number of parity drives For example, RAID5(3D+1P) indicates a RAID5 configuration consisting of three data drives and one parity drive.
Attribute Description Guard mode guardMode A space is output when the guard mode is invalid. When multiple modes are set, the modes are separated by semicolons (;) when they are output (example: Protect). Type of the drive • -1: Unknown • 0: FC • 1: SATA diskType • 4: SAS • 5: SSD • 8: FMD If a storage system is connected externally and an external volume is mapped to the internal volume, a value different from the actual drive type might be output.
Attribute Description LDEV status One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) • Blocked: Blocked status or unformatted. status • Format: The LDEV is being formatted. • Correction Access: The access attribute is being modified. • Copying: Data is being copied. • ReadOnly: Read-only • Shredding: The LDEV is being shredded.
Attribute Description Volume type of Hitachi ShadowImage for Mainframe Software • Unknown: Unknown mfShadowImageVolumeType • Simplex: Not a Hitachi ShadowImage for Mainframe Software volume • P-VOL • S-VOL • SP-VOL Volume type of Hitachi Universal Replicator for Mainframe Software • Unknown: Unknown mfUniversalReplicatorVolumeType • Simplex: Not a Hitachi Universal Replicator for Mainframe Software volume • P-VOL • S-VOL • MF-JNL: Journal volume Pool ID of LDEV One of the following values is output for
Attribute Description Usage rate threshold of the THP/Smart volumes. One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit consists of THP/Smart volumes: usage rate threshold value of the THP/Smart volumes#1, #2 • For volumes other than THP/Smart volumes : -1 is output. threshold #1 When the THP/Smart volumes are not assigned to a THP/Smart pool, -1 is displayed. #2 When the operator is a partitioned storage administrator, -1 is displayed.
Attribute Description ID of the resource group to which the LDEV belongs resourcePartitionUnitID The ID of a resource group managed by a storage system management tool is output. This item is output for P9500. -1 is output for all other storage systems.
Attribute Description percentUsed Usage percentage of the logical units included in the logical group (%)# numberOfLUNs Number of LUNs included in the logical group# Type of logical group. • 0: Folder resourceType • 1: Host logical group • 2: Volume logical group Method for specifying a resource. Indicates the method for specifying a resource (a host or volume) managed by a logical group.
• ShrinkPool, page 253 Table 137 LogicalUnit instance attributes Attribute Description objectID Object ID of the logical unit Name of the logical unit name This item is output if it has been registered. Number of the LDEV contained in the logical unit devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output.
Attribute Description Indicates whether the user authentication mode is valid when the logical unit is used as a command device. commandDeviceAuth • true: Valid • false: Not valid chassis Number of the chassis where the logical unit is located arrayGroup Number of the parity group containing the logical unit RAID type of the logical unit The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]).
Attribute Description Volume type of Continuous Access Journal Software • Unknown: Unknown • Simplex: Not a Continuous Access Journal Software volume • P-VOL journalVolumeType • S-VOL • SP-VOL • JNL-VOL: Continuous Access Journal Software JNL-VOL • MF-JNL: Hitachi Universal Replicator for Mainframe Software JNL-VOL sysVolFlag This item is output only for XP12000/XP10000/SVS200 or XP1024/XP128. 0 is output for other storage systems. Indicates whether the logical unit is used as an external volume.
Attribute Description Usage of on the THP/Smart volume (KB) One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit does not consist of THP/Smart volumes: The same value as capacityInKB. • When the logical unit consists of THP/Smart volumes: Usage of on the THP/Smart volumes. -1 is output for other storage systems.
Attribute Description The status of a THP/Smart pool volume. One of the following values is output for P9500: • 2 : The THP/Smart pool can shrink. thpPoolVolControlFlag • 1 : The THP/Smart pool is shrinking. • 0 : The THP/Smart pool cannot shrink (for example, the initial THP/Smart pool volume). • -1 : The volume is normal (includes the volumes that became normal volumes after the THP/Smart pool finishes shrinking). -1 is output for other storage systems.
Attribute Description svolSerialNumber Serial number of the storage system containing the S-VOL Type of the storage system containing the S-VOL svolArrayType If the storage system containing the S-VOL is not registered, Unknown is output. svolDevNum Device number of the S-VOL Device number of the S-VOL For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number.
ObjectLabel instance Commands for which an ObjectLabel instance is output • • • • • GetStorageArray (subtarget=ArrayGroup) , page 139 GetStorageArray (subtarget=LDEV) , page 158 GetStorageArray (subtarget=LogicalUnit) , page 163 AddLabel, page 66 ModifyLabel, page 211 Table 139 ObjectLabel instance attributes Attribute Description targetID Object ID of the label label Label name PairedPool instance Commands for which a PairedPool instance is output • GetStorageArray (subtarget=Pool) , page 178 Table
Attribute Description Name of the paired port controller name This item is output if it has been registered.
Attribute Description Display name of the logical unit device number For P9500 or XP24000/XP20000: displayDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description depth Currently, this information does not apply to storage systems. role This item is not output. vendor This item is not output. model Drive model Physical device firmware version firmwareVersion This item is not output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128. Serial number of the drive serialNumber This item is not output.
PerformanceStatus instance Commands for which a PerformanceStatus instance is output • RefreshPerformanceData, page 248 Table 144 PerformanceStatus instance attributes Attribute Description arrayType Type of the storage system serialNumber Serial number of the storage system Performance information acquisition status • SUCCEEDED • FAILED • NO_DATA status NO_DATA is output when the target storage system is monitored by HP StorageWorks P9000 Performance Advisor Software but no performance information h
NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.2, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script that you use in version 6.3 or later. Table 145 Pool instance attributes Attribute Description objectID Object ID of the Pool instance Name of the pool name This is output if the name has been registered. Outputs the function by which the pools are being used.
Attribute Description Indicates the pool type. The value output depends on the poolFunction value.
Attribute Description Threshold2 of the pool (%) threshold2 If poolFunction is 5, the threshold2 of the THP/Smart pool is output. This information is invalid for other cases (-1 is output). Indicates whether the value output to threshold2 is the value determined by the storage system.
Attribute Description Combination of data drives and parity drives in a RAID configuration. For P9500, if the pool is a THP pool, this item is output in the format xD+yP or xD+xD. • xD: Number of data drives • yP: Number of parity drives combination Unknown is output if the combination is unknown.
Attribute Description Type of the drive If the storage system is P9500 and a THP pool is used, one of the following values is output: • 1: SATA • 4: SAS • 5: SSD or FMD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive drive types are mixed (except for SSD and FMD) • Drives with different drive speeds are mixed This information is invalid for other cases (-1 is output). Indicates whether the pool is a Smart pool.
Attribute Description Execution status of performance monitoring #2 monitoringState • 0: Stopped • 1: Executing lastMonitorStartDate#2 lastMonitorEndDate#2 Date and time at which performance monitoring started If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output. Date and time at which performance monitoring ended If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output.
PoolTier instance Commands for which a PoolTier instance is output • • • • AddPool, page 78 GetStorageArray (subtarget=Pool) , page 178 ModifyExternalTierRank, page 208 ModifyPool, page 215 Table 146 PoolTier instance attributes Attribute Description objectID Object ID of the hardware tier name Name of the hardware tier tierID ID of the hardware tier Capacity of the hardware tier (KB) capacityInKB This value does not match the total capacity of the Smart pool volumes because the pool of Smart Tie
Attribute Description Type of the drive • 1: SATA • 4: SAS • 5: SSD or FMD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive drive types are mixed (except for SSD and FMD) • Drives with different drive speeds are mixed Indicates whether the volumes that make up the hardware tier are internal or external volumes: substance • 0: Internal volume • 1: External volume • -1: Unknown, or internal volumes and external volumes are mixed bufSpaceForNewPageAssign
Attribute Description displayName Display name of the port Indicates whether LUN security is valid for the port. lunSecurityEnabled • true: Valid • false: Not valid controllerID Port controller ID Port option portOption No value is output if the option is invalid. WWN of the port worldWidePortName This item is valid when the port is a Fibre port or an FCoE port.
• ModifyPortController, page 232 Table 148 PortController instance attributes Attribute Description objectID Object ID of the port controller Name of the port controller name This item is output if it has been registered.
Attribute Description Port type type For details about the output values, see Table 149.
Storage system Values output for the type attribute • 2: ESCON • 8: Fibre-Tachyon Shortwave (2 ports) • 12: Fibre-Tachyon Shortwave (4 ports) • 13: Fibre-Tachyon Shortwave (4 ports) XP1024/XP128 • 14: Fibre-Tachyon Shortwave (8 ports) • 15: Fibre-Tachyon Longwave (4 ports) • 21: E-NAS • 25: iSCSI • 32: FICON Shortwave (4 ports) • 33: FICON Longwave (4 ports) RelatedDistributedArrayGroup instance Commands for which a RelatedDistributedArrayGroup instance is output • GetStorageArray (subtarget=ArrayGroup)
Attribute Description remoteEndDevNum Maximum device number among the applicable LUs in the RCU remoteSerialNumber Serial number of the RCU SSID of the RCU remoteSSID 0 is displayed if there is no RCU.
#1 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the value for objectID will be invalid. #2 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the remoteArrayFamily, remotePathGroupID, pairPortType, numOfMinConnection, and nickname attributes will not be output.
Attribute Description Value specified in HORCM_INST for the S-VOL in the HORCM configuration file svolHORCMINSTHostName In the HORCM configuration file, if HORCM_INST is set to localhost, the loopback address is output.
Attribute Description ID of the pool containing the P-VOL pvolPoolID svolSerialNumber For Continuous Access Journal Software: Journal group ID For Snapshot, Fast Snap, or Continuous Access Asynchronous Software: Pool ID of a data pool Serial number of the storage system containing the S-VOL Type of the storage system containing the S-VOL svolArrayType If the storage system containing the S-VOL is not registered, Unknown is output.
Attribute Description Time when the S-VOL image is created by using the replication function splitTime The number of seconds elapsed from 00:00:00 on January 1, 1970, is output (the time setting is the storage system setting, not GMT). This item is valid when the copy type is Snapshot or Fast Snap. When the copy type differs from Snapshot, -1 is output.
ServerInfo instance Commands for which a ServerInfo instance is output • GetServerInfo, page 324 Table 153 ServerInfo instance attributes Attribute Description buildVersion Device Manager server version and build date serverURL Device Manager server URL upTime Length of time that the Device Manager server is active upSince Time and date that the server was started currentApiVersion Device Manager server API version License status • -1: Unknown • 0: Permanent license or meter-based term license •
Attribute Description serialNumber Serial number of the storage system groupID Snapshot group ID groupName Snapshot group name Copy type replicationFunction FastSnap is output. Consistency group ID ctGrp If the snapshot group is a consistency group, the consistency group ID is output.
• • • • • • • • • • • • • • • • GetStorageArray (subtarget=Pool) , page 178 GetStorageArray (subtarget=Port) , page 186 GetStorageArray (subtarget=PortController) , page 188 GetStorageArray (subtarget=ReplicationInfo) , page 190 GetStorageArray (subtarget=TieringPolicy) , page 197 GetTieredPoolStatus, page 203 GetZeroPageReclaimStatus, page 205 ModifyExternalTierRank, page 208 ModifyLogicalUnit, page 212 ModifyPool, page 215 ModifyPort, page 225 ModifyPortController, page 232 ModifyStorageArray, page 234 M
Attribute Description productName Product name controllerVersion The microcode version of the DKC numberOfControllers Number of storage system controllers capacityInGB#1 cacheInMB An attribute for compatibility. For details, see Table 156. Cache size (in MB) An attribute for compatibility. sharedMemoryInMB For details, see Table 156. Number of spare drives numberOfSpareDrives -1 is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, or SMI-S enabled storage systems.
Attribute Description totalFreeSpaceInKB largestFreeSpaceInKB An attribute for compatibility. For details, see Table 156. multipathSupport Security status of the storage system • -1: Unknown securityStatus • 0: No security • 2: LUN Manager Recognition ID of the storage system. sequenceNumber Serial number or part of the serial number of the storage system is output.
Attribute Description Total size of the open logical units reserved for Auto LUN Software (in KB) openAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 3. • devType is AutoLunReserved. Total size of the open logical units expanded on demand (in KB) openOnDemandCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 3.
Attribute Description mfUnallocatedCapacity numberOfOpenAllocatedLUs Number of open logical units to which paths are assigned Number of open logical units that satisfy the following conditions: numberOfOpenUnallocatedLUs • Paths are not assigned. numberOfImAllocatedLUs Number of intermediate logical units to which paths are assigned • Paths can be assigned by using Device Manager.
Attribute Description Indicates whether the actual configuration information of the target storage system matches the configuration information in the Device Manager database. One of the following values is output for P9500 and XP24000/XP20000 version 60-04-10-XX/XX or later: configUpdateStatus • 0: The configuration information matches. • 1: The configuration information does not match. Use the AddStorageArray command to update the configuration information of the storage system.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy both the following conditions (in KB): • Paths are not assigned. • Paths cannot be assigned by using Device Manager. openReservedCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2 or 3. • path is false. • The LDEV is used as a reserved volume#2 by storage system functions.
• thpType of the LDEV instance is 1 (a THP/Smart pool volume). • systemDisk of the LDEV instance is 1 (a volume used as a system drive). • devType of the LDEV instance is AutoLunReserved or OnDemandDevice (a volume reserved for Auto LUN Software or a volume used on demand). • snapshotVolumeType of the LogicalUnit instance associated with the LDEV is POOL (a Snapshot or Fast Snap pool volume).
Attribute Description Total size of the regions in which logical units can be created (regions of unused capacity) (in KB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
The value obtained by dividing xxxInKB by 1,024 x 1,024 and then truncating anything after the decimal point. The StorageArray instance contains the attributes related to capacity. The following figures show the major relationships of the attributes.
• ModifyTieringPolicy, page 237 Table 157 TieringPolicy instance attributes Attribute Description objectID Object ID of TieringPolicy Tiering Policy ID policyID This attribute is valid only when Smart volumes are used in P9500. For details about the output values, see the policyid parameter in Table 78.
Attribute Description Additional description of the URLLink description This item is output only when an additional description is registered.
VirtualDisk instance Commands for which a VirtualDisk instance is output • GetHost, page 287 Table 160 VirtualDisk instance attributes Attribute Description vmDiskID Virtual disk ID name Virtual disk name datastoreID Datastore ID VLDEV instance Commands for which a VLDEV instance is output • • • • AddVLDEVToVRPU, page 104 GetStorageArray (subtarget=LDEV) , page 158 GetStorageArray (subtarget=LogicalUnit) , page 163 GetStorageArray (subtarget=VResourcePartitionUnit), page 199 Table 161 VLDEV instan
Attribute Description Indicates whether a virtual LUSE is set for the LDEV. • 0: Non-LUSE volume vLUSE • 2 to 36: A LUSE volume (with the specified number of volumes) If there is no virtual information for the LDEV, -1 is output. Indicates whether the virtual CVS setting is set for the LDEV. • 0: CVS is not set. vCVS • 1: CVS is set. If there is no virtual information for the LDEV, -1 is output.
Attribute Description storage system type to which an external volume is mapped • P9500: P9500 • XP24000: XP24000 mappedArrayType • XP20000: XP20000 • XP12000: XP12000 • XP10000: XP10000/SVS200 mappedSerialNumber Serial number of the storage system to which an external volume is mapped mappedDevNum Device number of the internal volume to which an external volume is mapped externalArrayType storage system type consisting of external volumes externalSerialNumber Serial number of the storage system
Attribute Description resourcePartitionUnitID ID of the resource group to which the virtualized resources belong portID Port ID vArrayFamily Family of the virtual storage system vSerialNumber Serial number of the virtual storage system The ID of the resource group used for data migration using virtual IDs is output. Virtual port ID of the port vPortID If there is no virtual information for the port, -1 is output.
WWN instance Commands for which a WWN instance is output • • • • • • • • • • • AddLun, page 260 AddVirtualizationServer, page 280 AddWWNForHostStorageDomain, page 265 GetHost, page 287 GetStorageArray (subtarget=HostStorageDomain) , page 154 GetStorageArray (subtarget=LogicalUnit) , page 163 GetStorageArray (subtarget=Path) , page 172 GetStorageArray (subtarget=Port) , page 186 MergeHost, page 306 ModifyHost, page 307 ModifyPort, page 225 • ModifyVirtualizationServer, page 313 • RefreshVirtualizationServe
Output items
6 Batch functionality This chapter describes the commands that can be executed by using the batch functionality, how to create batch files, how to use the batch functionality, and the actions to be taken if an error occurs. About the batch functionality In the Device Manager CLI, the processing (commands) for a storage system can be specified in a batch file and efficiently executed at the same time. The batch functionality is useful when installing a new storage system.
• Input rules for command lines in batch files, page 444 • Conditions for parameters for processing a group of commands in a batch file, page 445 • Examples of batch file creation, page 451 Batch file format and input rules The batch file format is as follows: beginbatch hdvmcli command parameter hdvmcli command parameter . . . endbatch The input rules for batch files are as follows: • Only ASCII encoded characters can be used in batch files.
spaces ! " # $ % & ' ( ) * + < > ? @ [ \ ] ^ ` { | } ~ The following shows an example specification where Lun10 HOST2, a string containing a space, is specified for the name parameter. hdvmcli AddLun name=Lun10\ HOST2 model=XP12000 serialnum=14053 Conditions for parameters for processing a group of commands in a batch file To execute a group of commands in a batch file, the following conditions must be satisfied for parameter values and for combinations of parameters on consecutive command lines.
The tables below explain the conditions for specification of parameters for each command. Condition-n in the Specification conditions column corresponds to the above conditions.
Specification conditions Parameter domain hostmode No restrictions hostmodeoption name nickname Notes If a batch file has multiple AddHostStorageDomain command lines and one of them specifies the domain or nickname parameter, specify the command line that has the parameter first. Values are automatically set if these parameters are omitted.
Specification conditions Parameter capacity No restrictions capacitytype devnum lusubinfo Notes If a batch file has multiple AddLogicalUnit command lines and one of them specifies the devnum parameter, specify the command line that has the parameter first. A value is automatically set for this parameter when a value is omitted.
Specification conditions Condition-4 Parameter groupoption numoflus arraygroupname No restrictions capacity devnum threshold Notes -If a batch file has multiple AddVirtualVolume command lines and one of them specifies the arraygroupname or devnum parameter, specify the command line that has the parameter first. Values are automatically set if these parameters are omitted.
Specification conditions Parameter domain No restrictions domainnickname wwn wwnnickname Table 175 Conditions for specification of parameters for the DeleteHostStorageDomain command Specification conditions Parameter deletionoption Condition-1 model serialnum domain Condition-2 domainnickname port portname Table 176 Conditions for specification of parameters for the DeleteLun command Specification conditions Parameter deletionoption Condition-1 model serialnum Condition-2 port portname devnum
Specification conditions Parameter No restrictions devnum Table 179 Conditions for specification of parameters for the ModifyVirtualVolume command Specification conditions Parameter Notes assign Condition-1 model -- serialnum capacity clprNumber devnums No restrictions poolid threshold tieringpolicy tierrelocation For the devnums parameter, you can specify multiple device numbers for a THP/Smart volume. To specify five or more device numbers, write them separately on multiple command lines.
To use the batch functionality: • To use the batch functionality, specify the batch option (-b or --batch) and a batch file name. Specify the URL of the Device Manager server and options other than the -i (or --input) option on the command line or in the properties file. The following items cannot be specified with the batch option.
microcodeVersion=50-07-63/00 agentVersion=04_08_00 productName=RAID500 controllerVersion=50-07-63-00/00 numberOfControllers=1 capacityInGB=6,560 cacheInMB=65,536 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=4,877 allocatedCapacityInGB=1,605 autoLunCapacityInGB=77 onDemandCapacityInGB=0 totalFreeSpaceInGB=2,383 largestFreeSpaceInGB=778 capacityInKB=6,878,866,064 freeCapacityInKB=5,114,357,504 allocatedCapacityInKB=1,683,100,560 autoLunCapacityInKB=81,408,000 onDemandCapacityInKB=0 totalFreeSpa
openUnallocatedActualCapacity=5,803,543,936 openReservedCapacity=62,545,600 openReservedActualCapacity=62,545,600 numberOfReservedLUs=32 numberOfOpenReservedLUs=32 numberOfImReservedLUs=0 distributedMode=-1 List of 4 Path elements: An instance of Path objectID=***** devNum=816 displayDevNum=03:30 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=100 wwnSecurityValidity=true An instance of Path objectID=***** devNum=817 displayDevNum=03:31 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=101 wwnSecurityValidi
Addressing errors that occur during use of the batch functionality (if the target storage system is other than an XP24000/XP20000, or is an XP24000/XP20000 whose microcode version is earlier than 60-02-00-00/00) If an error occurs during batch processing, processing immediately stops, and subsequent commands are not processed. Check the point up to which the batch file content was processed. To handle the unprocessed commands, re-create the batch file, and then retry the batch operation.
Table 180 Corrective actions for Device Manager server error codes and storage system error codes Device Manager server error code Storage system error code "1005,1003", "1005,1005", "1005,1018", "1005,1021", "1005,1068", "1005,1135", "1005,1363", "1005,1600", "1005,1904", "1005,6036", "1005,1004", "1005,1007", "1005,1020", "1005,1025", "1005,1134", "1005,1350", "1005,1368", "1005,1600", "1005,6012", "1005,65660" "2005,1002", "2005,1009", "2005,1010", "2005,1012", "2005,1013", "2005,1015", "2005,1021",
Device Manager server error code Storage system error code Action Perform the following procedure: 1. Execute the AddStorageArray command or RefreshStorageArrays command. 2. Execute the GetStorageArray command to check which command lines in the batch file were applied to the storage system. The command processing during batch functionality execution is not performed in the order described in the batch file. All lines need to be checked to determine which command lines in the batch file were applied.
Batch functionality
7 Import functionality Hosts can be added and host information can be updated by importing host information files and mapping definition files via the Device Manager CLI. This chapter describes the import functionality that can be used by executing the ImportHosts command. For details about the format and parameters of the ImportHosts command, see “ImportHosts” on page 302. Overview of the import functionality The ImportHosts command can be used to import host information from files.
Figure 6 Flow of operations for importing host information (ImportHosts command) The following describes the files that the ImportHosts command uses or generates. Input files • Host information file (CSV file) The host information file contains host information in CSV format. If you are using spreadsheet software to manage hosts, you can use the spreadsheet software file to create the host information file.
NOTE: • If you add hosts, the imported hosts are registered as normal hosts or virtualization servers. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually (hosts that were registered by using the AddHost command or the HostScan command). The ImportHosts command only updates normal hosts or virtualization servers that were manually registered by using the Device Manager GUI or CLI.
5. Check the hosts that are newly imported. Related topics • • • • ImportHosts, page 302 Conventions for creating host information files (CSV files), page 462 Conventions for creating mapping definition files, page 463 Examples of input files, page 465 Conventions for creating host information files (CSV files) Follow the following conventions when creating host information files: • Use UTF-8 encoding. • Make sure that the host information file does not exceed the maximum of 10,250 records.
Item Description Specify a 16-digit hexadecimal number in one of the following formats: WWN 10000000C971BFD8, 10.00.00.00.C9.71.BF.D8, or 10:00:00:00:C9:71:BF:D8 Alphabetic characters are not case sensitive. To specify two or more entries, use a comma or line break as a separator. IP address (IPv4)# IP address (IPv6)# Specify an IP address in IPv4 format. Specify an IP address in IPv6 format. Alphabetic characters are not case sensitive. Specify the OS type value.
The following table describes the properties (and their values) that can be specified in a mapping definition file. Table 182 Properties that can be specified in a mapping definition file (import.properties) Property Description Specifies the import start record. import.host.line.start Specify the record number of the record from which import starts in the host information file (CSV file). You can specify a value from 1 to 10,250. This property is required. Specifies the position of the host name.
Property Description import.host.ostype.aix These five properties specify the character strings to be mapped to OS types. import.host.ostype.hpux The OS type values that are specified in the host information file are mapped to OS types. import.host.ostype.linux import.host.ostype.solaris Specify values in accordance with the following conventions: • Enclose each value in double quotation marks ("). • Alphabetic characters are not case sensitive. import.host.ostype.
Example of a host information file (CSV file) 1,2,3,4,5,6[CRLF] host,ip,ipv6,OS,description,wwn[CRLF] TEST1,10.0.0.1,,WINDOWS,Evaluation purpose,11.11.11.11.11.11.11.11[CRLF] TEST2,,,Windows 2008,DB server,22.22.22.22.22.22.22.22[CRLF] TEST3,,,Windows 7,File server,33.33.33.33.33.33.33.33[CRLF] TEST4,10.0.0.3,,LINUX,,44.44.44.44.44.44.44.44[CRLF] TEST5,,,VMware ESX,,55.55.55.55.55.55.55.
8 Device Manager CLI properties file This chapter describes the settings that can be specified in a Device Manager CLI properties file. About the Device Manager CLI properties file A Device Manager CLI properties file allows you to specify the values and settings, such as log file settings, that you want to not have to enter on command lines.
hdvmcli.tracefile=C:/DeviceManager/traffic.log # Set the server url. hdvmcli.serverurl=http://localhost:2001/service ##### OPTIONS #### user=khalsa # Password can be provided directly, or from a password file. password=khalsa #password=@D:\\DeviceManager\\.passwd # Provide a copy of the raw xml request & response # in MessageTrace.log file. messagetrace=true # Disable output of the results of successfully executed commands. # Output of commands whose names start with "Get" is not disabled.
Specification example This example shows how to specify C:\Temp\diag.log as the output destination. hdvmcli.logfile=C:/Temp/diag.log Related topics • Device Manager CLI log files, page 32 • Property for specifying the log level (hdvmcli.diaglevel), page 469 Property for specifying the log level (hdvmcli.diaglevel) Use the hdvmcli.diaglevel property to specify the level of logs that are output to the log file. You can set the hdvmcli.diaglevel property to DEBUG, INFO, WARN, or ERROR.
Related topics • Device Manager CLI message trace file, page 32 Property for specifying the URL of the Device Manager server (hdvmcli.serverurl) Use the hdvmcli.serverurl property to specify the URL of the Device Manager server. If you specify the URL in the properties file, you do not need to enter the URL at the command line. If the URL is specified both at the command line and in the properties file, the value specified at the command line takes precedence. Specification example hdvmcli.
#1 When you specify an option that does not have an argument, set the argument to true. When true is set in a properties file for an option without an argument, it cannot be overwritten to false from the command line. #2 This option and property can be specified only when the GetStorageArray command is used. Specification example output=redirect.
NOTE: You need to specify the URI correctly. The Device Manager CLI does not check whether the specified DTD URI is formatted correctly.
9 Troubleshooting This chapter describes how to take action if there is a problem with Device Manager CLI. Addressing Device Manager CLI problems This section explains what to do if a problem occurs during Device Manager CLI operation. To address a Device Manager CLI problem: 1. Make sure that the problem is not caused by a network or hardware error. 2. Make sure that the problem is not occurring at the Device Manager server.
Problem Description and recommended action hdvmcli.bat does not run. The error message says: CAUSE: The DeviceManagerCLI.jar file might have been moved or renamed. C:\hdvm>hdvmcli help GetStorageArray SOLUTION: Make sure that the DeviceManagerCLI.jar file has not been moved or renamed, and that you are executing from the directory where the hdvmcli.bat and DeviceManagerCLI.jar files reside. Exception in thread "main" Java.lang.NoClassDefFoundError CAUSE: The LU is allocated to CL1-A or LUN0.
Problem Description and recommended action CAUSE: Authenticate failed in the Device Manager. SOLUTION: Make sure that the user ID and password that you specified when executing the command are correct. If you are using the function for linking to an external authentication server, take the action specified below. If the external authentication server is an LDAP server: The following message is displayed when a Device Manager CLI command is executed#: [KAIC90084-E] HTTP Response: "HTTP/1.
Problem If an attempt to refresh the host that centrally manages copy pairs is performed, the following message is displayed and the attempt fails: [KAIC07792-E] An attempt to acquire pair volume information on the host "host-name" has failed. Error details: "error-detail".
10 Support and other resources Numerous support options are available. Contacting HP HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
Support and other resources
A Connecting to P9000 mainframe agent This appendix describes how to specify the information required for linking with P9000 mainframe agent.
Registering the mainframe host in Device Manager To use the AddHost command to register the mainframe host in Device Manager: 1. Execute the AddHost command to register the mainframe host in Device Manager. When you execute the command, specify the following parameters: • hostname: In this parameter, specify the host name that you specified when setting up the mainframe host environment. • hosttype: In this parameter, specify 2. 2.
name=toro2 hostID=1 capacityInKB=0 hostType=2 managedBy=2 statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Registering the P9000 mainframe agent running on the mainframe host in Device Manager To use the AddURLLink command to register the mainframe host in Device Manager: 1. Execute the AddURLLink command to register the P9000 mainframe agent running on the mainframe host in Device Manager.
Command format (for an IPv4 environment): hdvmcli AddURLLink "url=http://mainframe-host-IP-address:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.
1. Check whether P9000 mainframe agent is operating normally. If it is not operating normally, check the P9000 mainframe agent settings, and restart P9000 mainframe agent. 2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
If an error occurs during the execution of the AddHostRefresh command, perform the following procedure: 1. Check whether P9000 mainframe agent is operating normally. If it is not operating normally, check the P9000 mainframe agent settings, and restart P9000 mainframe agent. 2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
Example of executing the command: hdvmcli GetURLLink -o "D:\logs\GetURLLink.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.114:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI.
An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.100:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI. Deleting P9000 mainframe agent information registered in Device Manager To delete P9000 mainframe agent information registered in the Device Manager server, use the DeleteURLLink command. Use this command when you want to delete only P9000 mainframe agent registration information.
Example of executing the command: hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 capacityInKB=0 hostType=2 managedBy=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI.
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=snow hostID=1 capacityInKB=0 hostType=2 managedBy=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Deleting a mainframe host To delete a mainframe host registered in the Device Manager server, use the DeleteHost command.
B Output format of execution results of the GetStorageArray command This appendix describes the procedure for outputting the execution results of the GetStorageArray command in CSV or XML format. Outputting execution results of the GetStorageArray command in CSV format To output the execution results of the GetStorageArray command in CSV format, specify csv for the -f (or --format) option.
subtarget parameter value Parameter that cannot be specified HostStorageDomain hsdsubinfo LDEV ldevsubinfo • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo MFReplicationInfo mfreplicationsubinfo Path pathsubinfo Pool poolsubinfo Port portsubinfo PortController controllersubinfo ReplicationInfo replicationsubinfo SnapshotGroup snapshotgrpsubinfo VResourcePartitionUnit vrpusubinfo Related topics • Using the GetStorageArray parameter, page 132 CSV-formatted execution results (GetSto
An entry name and a line feed code are output. The entry name is output even if the entry does not have a value. Second and subsequent lines: A value and a line feed code are output. An end-of-file (EOF) code is output after the last line. NOTE: • Items output in the execution result differ depending on the parameters specified by the Device Manager CLI command.
When an execution result is output in XML format, an XML declaration, a DOCTYPE declaration, and XML elements are output. First line: An XML declaration and a line feed code are output. Device Manager CLI uses UTF-8 encoding to output the execution result according to the XML 1.0 specifications recommended by W3C. Second line: A DOCTYPE declaration and a line feed code are output.
PortController (IPAddress | PairedPortController)*> SnapshotGroup (ReplicationInfo)*> ReplicationInfo (LogicalUnit)*> VResourcePartitionUnit (VPort | VHostStorageDomain | VLDEV)*> CommParameters EMP
portID CDATA #IMPLIED> portName CDATA #IMPLIED> domainID CDATA #IMPLIED> scsiID CDATA #IMPLIED> lun CDATA #IMPLIED> devNum CDATA #IMPLIED> di
isStandardLDEV CDATA #IMPLIED> guardMode CDATA #IMPLIED> diskType CDATA #IMPLIED>
thpType CDATA #IMPLIED> consumedCapacityInKB CDATA #IMPLIED> thpPoolID CDATA #IMPLIED> threshold CDATA #IMPLIED> tcaPoolID CDATA #IMPLIED> thpPoolVolControlFlag CDATA #IMPLIED> managementAreaPoolI
resourcePartitionUnitID CDATA #IMPLIED> portID CDATA #IMPLIED> vArrayFamily CDATA #IMPLIED> vSerialNumber CDATA #IMPLIED> vPortID CDATA #IMPLIED> vPortName CDATA #IMPLIED> vWWPortName CDATA #IMPLIED> vFibreAd
Output format of execution results of the GetStorageArray command
C XML-API request file This appendix describes an XML-API request file, which is required when you specify the -i (or --input) option for a command. About XML-API request files An XML-API request file contains one or more XML-API requests to the Device Manager server. The file must contain a valid XML document in the correct form for a Device Manager request. To read in requests to the Device Manager server from the XML-API request file, specify the -i (or --input) option.
2. Check the output message trace file. The following shows an output example. >>> Request Submitted at: 18:52:31 CEST to: http://*****:2001/service/StorageManager ---- HTTP Header ---. . (HTTP header information is omitted.) . ---------------------- PAGE 507Glossary This glossary defines the special terms used in this document.
LDEV logical device LU logical unit LUN logical unit number LUSE Logical Unit Size Expansion (feature of XP1024/XP128) MB megabytes (1024 KB) MCU main control unit (for Continuous Access Software) MLC Multiple Level Cell OS operating system PDEV physical device P-VOL primary volume (for Business Copy Software or Continuous Access Software) RAID redundant array of independent disks RCU remote control unit (for Continuous Access Software) SCSI small computer system interface SLC Sin
Index A access control, 43 acquiring Device Manager server information GetServerInfo, 324 AddArrayReservation, 49 AddConfigFileForReplication, 327 AddExternalArrayGroup, 51 AddHost, 274 AddHostInfo, 276 AddHostRefresh, 278 AddHostStorageDomain, 56 AddLabel, 66 AddLogicalUnit, 68 AddLun, 260 AddLUSE, 74 AddPool, 78 AddReplication, 337 AddReplication (for Fast Snap), 350 AddStorageArray, 88 AddTieredPoolOperation, 93 AddURLLink, 319 AddVirtualizationServer, 280 AddVirtualVolume, 96 AddVLDEVToVRPU, 104 AddWWNF
copy pair AddConfigFileForReplication, 327 AddReplication, 337 AddReplication (for Fast Snap), 350 DeleteReplication, 355 ModifyReplication, 364 CSV file host information file, 460 ImportHosts, 462 CSV format execution results of GetStorageArray command, 490 parameters that cannot be specified for output, 489 D Datastore instance, 380 DeleteAlerts, 320 DeleteArrayReservation, 107 DeleteExternalArrayGroup, 108 DeleteHost, 285 DeleteHostInfo, 286 DeleteHostStorageDomain, 109 DeleteLabel, 111 DeleteLogicalUni
execution results output format, 30 outputting execution results of GetStorageArray command in CSV format, 489 outputting execution results of GetStorageArray command in XML format, 491 suppressing output, 30 external parity group AddExternalArrayGroup, 51 DeleteExternalArrayGroup, 108 ExternalPathInfo instance, 380 ExternalStorage instance, 381 F FormatLU, 121 FreeLUN instance, 381 FreeSpace instance, 382 G GetAlerts, 323 GetArrayReservation, 126 GetHost, 287 GetHostInfo, 299 GetLogicalGroup, 257 GetPool
I import functionality, 459 adding host information, 459 ImportHosts, 302, 459 input files, 460 migrating host information, 459 output files, 460 updating host information, 459 import.properties, 461 ImportHosts, 302, 459 ImportHosts command using, 460 input files example, 465 for ImportHosts, 460 host information file (CSV file), 460 import.
output files check results file, 460 error information file, 460 for ImportHosts, 460 output items Alert instance, 371 ArrayGroup instance, 372 ArrayReservation instance, 376 CommParameters instance, 377 Component instance, 379 ConfigFile instance, 380 Datastore instance, 380 ExternalPathInfo instance, 380 ExternalStorage instance, 381 FreeLUN instance, 381 FreeSpace instance, 382 Host instance, 382 HostInfo instance, 384 HostStorageDomain instance, 385 IPAddress instance, 386 LDEV instance, 387 LogicalDKC
public logical group, 258 R refreshing AddHostRefresh, 278 AddStorageArray, 88 AddVirtualizationServer, 280 RefreshPerformanceData, 248 RefreshStorageArrays, 249 RefreshVirtualizationServer, 317 RefreshPerformanceData, 248 RefreshStorageArrays, 249 RefreshVirtualizationServer, 317 registering storage system AddStorageArray, 88 DeleteStorageArray, 116 ModifyStorageArray, 234 RelatedDistributedArrayGroup instance, 417 replication controller pair GetReplicationControllerPair, 361 ReplicationControllerPair ins
virtual volume (Smart volume) AddVirtualVolume, 96 DeleteVirtualVolume, 117 GetStorageArray (subtarget=TieringPolicy), 197 GetZeroPageReclaimStatus, 205 ModifyTieringPolicy, 237 ModifyVirtualVolume, 239 RunZeroPageReclaim, 251 virtual volume (THP volume) AddVirtualVolume, 96 DeleteVirtualVolume, 117 GetZeroPageReclaimStatus, 205 ModifyVirtualVolume, 239 RunZeroPageReclaim, 251 VirtualDisk instance, 437 virtualization server AddVirtualizationServer, 280 DeleteHost, 285 Host Data Collector, 280 ModifyVirtuali