HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96363 Eleventh edition: October 2013
Legal and notice information © Copyright 2010, 2013 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 .............................................................................................................
ModifyVirtualVolume ........................................................................................................ RefreshPerformanceData .................................................................................................... RefreshStorageArrays ........................................................................................................ RunZeroPageReclaim ........................................................................................................ ShrinkPool ..
FreeSpace instance ................................................................................................................. Host instance ......................................................................................................................... HostInfo instance .................................................................................................................... HostStorageDomain instance .................................................................................
Overview of the import functionality .......................................................................................... Importing host information (using the ImportHosts command) ........................................................ Conventions for creating host information files (CSV files) ............................................................. Conventions for creating mapping definition files ........................................................................
About XML-API request files ...................................................................................................... 481 Creating an XML-API request file by using the message trace file ................................................... 481 Glossary .......................................................................................... 483 Index ...............................................................................................
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) ...................... 411 4 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 411 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 ............................................................................. 32 4 Storage system management commands and related storage systems ............................. 34 5 Commands related to logical groups ....................................
32 DeleteArrayReservation command parameters .......................................................... 107 33 DeleteExternalArrayGroup command parameters ...................................................... 108 34 DeleteHostStorageDomain command parameters ...................................................... 109 35 DeleteLabel command parameters ........................................................................... 111 36 DeleteLogicalUnit command parameters .......................................
69 ModifyArrayReservation command parameters ......................................................... 204 70 ModifyExternalTierRank command parameters .......................................................... 205 71 ModifyLabel command parameters ......................................................................... 207 72 ModifyLogicalUnit command parameters ................................................................. 209 73 ModifyPool command parameters ..........................................
105 AddURLLink command parameters .......................................................................... 310 106 DeleteAlerts command parameters .......................................................................... 311 107 DeleteURLLink command parameters ........................................................................ 312 108 GetAlerts command parameters .............................................................................. 313 109 GetURLLink command parameters ....................
2 PerformanceStatus instance attributes ....................................................................... 382 143 Pool instance attributes .......................................................................................... 383 144 PoolTier instance attributes ..................................................................................... 389 145 Port instance attributes ...........................................................................................
177 Corrective actions for Device Manager server error codes and storage system error codes .................................................................................................................. 432 178 Items that can be specified in a host information file (CSV file) .................................... 438 179 Properties that can be specified in a mapping definition file (import.properties) ............. 440 180 Options and their corresponding properties .......................................
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 GUI. 2. Copy the downloaded file to the computer on which the CLI is to be installed. 3. Decompress the copied file. Related topics • Setting up a Java environment, page 22 Java environment settings To use the Device Manager CLI, you need to set up a Java environment.
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 446 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. Executing the Device Manager CLI You can use the Device Manager CLI to perform storage system operations or manage storage resources from the command line. To execute the Device Manager CLI : 1. Change to the Device Manager CLI installation directory or folder. 2. Execute hdvmcli.bat or hdvmcli.sh.
NOTE: • The Device Manager CLI only supports ASCII code characters. If a request to the Device Manager server contains a character other than an ASCII character, an unexpected error might occur because the request cannot be processed correctly. • When you enter commands from the command line, you need to perform shell escapes in accordance with the platform. The following describes the Device Manager CLI arguments (URLs, options, and parameters).
command Commands that make processing requests to the Device Manager server, such as GetStorageArray or GetLogicalGroup. The command names specified in this argument are not case-sensitive. The command is not required when reading the request from an XML file. options Options control the behavior of the CLI application. Options are entered in the typical UNIX fashion. Options are case sensitive.
Option Argument for the option Status Description The Device Manager server login password or the path to the password file that contains the login password #1, #2, #3 pass-p or --password word#1 or passwordfile Required A password can either be specified directly, or a file containing a password can be specified. The application user needs to have access permissions for the password file. Do not grant access permissions to common users for the password file.
Option Argument for the option -b or batchfile- --batch name#2 Status Optional Description The commands specified in the batch file are executed together. You cannot specify this option together with either the -i (or --input) option or the -f (or --format) option. The flag for suppressing output of the command execution results This option suppresses the output of the execution results if the command is successfully executed.
Device Manager CLI return values The Device Manager CLI returns an execution result value at the end of each process. The following table lists and describes the CLI return values. Table 3 Device Manager CLI return values Return values Description 0 The CLI ended normally. 1 The CLI found errors within the process (for example, a parameter error). 2 The CLI found errors in the Device Manager server. Device Manager CLI log files Device Manager CLI logs are output to the hdvmcli.
The following describes how to display each type of Help. Unless otherwise specified, the examples below assume that Windows is used and that the Device Manager CLI is installed in C:\hdvm. • Basic Help Basic Help contains the format for Device Manager CLI commands, a list of commands, and a list of options. To display basic Help, execute the Device Manager CLI without any arguments. In Windows: C:\hdvm> hdvmcli.bat In Solaris, AIX, Linux, or HP-UX: # ./hdvmcli.
Commands related to storage system management You can use the storage system management commands to register, modify, and delete storage system information. Table 4 Storage system management commands and related storage systems XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y AddExternalArrayGroup Creates an external parity group. It also creates an LU for the external parity group that is created. Y Y -- -- AddHostStorageDomain Creates a host storage domain or host group.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- Unlocks a specified storage system 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.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- Obtains information about a storage system. Y Y Y Y GetTieredPoolStatus Obtains the execution status of manually-executed performance monitoring and hardware tier relocation for a Smart pool. Y -- -- -- GetZeroPageReclaimStatus 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.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- -- 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. 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.
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 292.
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) .
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 mfUniversalReplicatorVolum
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.
• If more than one logical unit is specified, all of them must have the same CLPR number. • 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 chas
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 143. 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.
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 existing virtual parity group: hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number groupoption=exist arraygroupname=name-of
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 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. arraygroupname Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command.
onDemandCapacity=0 totalFreeSpace=2,801,729,280 largestFreeSpace=2,801,729,280 substance=0 slprNumber=0 clprNumber=0 cuInfo= openTotalCapacity=419,430,400 openAllocatedCapacity=0 openFreeCapacity=419,430,400 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=0 openUnallocatedCapacity=41
snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=10 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V cylinders=0 isComposite=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 slprNu
commandDeviceEx=0 commandDeviceSecurity=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 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=10 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1
threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=***** sizeInKB=2,801,729,280 cylinders=0 fsControlIndex=0 *****: The values are encoded by the CLI. AddVLDEVToVRPU AddVLDEVToVRPU adds an LDEV to a resource group used for data migrations that use virtual IDs, and registers the LDEV virtual information. If LDEV virtual information is already registered, the LDEV virtual information is updated.
Parameters Table 31 AddVLDEVToVRPU command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system ID of the resource group used for data migrations that use virtual IDs vrpuid Required Specify the ID of the resource group to which an LDEV is to be added or that contains the LDEV whose virtual information is to be updated.
Parameter name Status Description Number of virtual LUSE elements of the LDEV The following are the specifiable numbers: vluse Optional • 0: Non-LUSE volume • 2 to 36: A LUSE volume (with the specified number of volumes) If this parameter is omitted, it is assumed that 0 is specified. Virtual CVS of the LDEV Specify whether the virtual CVS setting is set for the LDEV. Optional vcvs • 0: CVS is not set (the LDEV is the standard size). • 1: CVS is set (the LDEV is a custom size).
Command execution result RESPONSE: An instance of StorageArray . .(Attributes of StorageArray are omitted here) . List of 1 VResourcePartitionUnit elements: An instance of VResourcePartitionUnit . .(Attributes of VResourcePartitionUnit are omitted here) . List of 1 VLDEV elements: An instance of VLDEV objectID=***** resourcePartitionUnitID=2 devNum=11 vArrayFamily=R600 vSerialNumber=10007 vDevNum=201 vEmulation=OPEN-V vSSID=10 vLUSE=0 vCVS=0 *****: The values are encoded by the CLI.
Command execution result RESPONSE: (Command completed; empty list returned) DeleteExternalArrayGroup DeleteExternalArrayGroup deletes mapping of the volume (external volume) of an externally connected storage system (external storage system) that is mapped on a one-to-one basis to an internal volume, and deletes the parity group (external parity group). This command also deletes the LU that belongs to the deleted external parity group. NOTE: • This command can be used only with P9500 and XP24000/XP20000.
Command execution example hdvmcli DeleteExternalArrayGroup -o "D:\logs\DeleteExternalArrayGroup.log" "model=XP24000" "serialnum=10037" "arraygroupnames=E1-1,E1-2" Command execution result RESPONSE: (Command completed; empty list returned) DeleteHostStorageDomain DeleteHostStorageDomain deletes a host storage domain. This command deletes host groups from the storage system.
Parameter name Status deletionoption Optional Description For this parameter, you can specify only lusekeep. If this parameter is omitted, a LUSE is deleted. If you do not want to delete a LUSE, be sure to specify this parameter. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 35 DeleteLabel command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number of the logical unit 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.
DeleteLogicalUnit DeleteLogicalUnit deletes the LU and corresponding LDEV from the storage device. With P9500, XP24000/XP20000, and XP12000/XP10000/SVS200, you can delete multiple logical units at once. NOTE: • For P9500 or XP24000/XP20000, logical units cannot be deleted for parity groups with chassis numbers from 65 to 96, or from 16485 to 16516. Parity groups with chassis numbers from 65 to 96, or from 16485 to 16516 are indicated as V-VOLs.
Parameter name Status Description Device number of the LU For P9500 and XP24000/XP20000: Optional (P9500 XP24000 devnums XP20000 XP12000 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.
Parameters Table 37 DeleteLUSE command parameters Parameter name Status Description serialnum Required Serial number of the storage system from which the LUSE is to be deleted model Required Model of the storage system from which the LUSE is to be deleted Device number used to identify the LUSE to be deleted 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
DeletePool DeletePool deletes a THP/Smart pool, and releases the assignations to the pool volumes that made up the THP/Smart pool. NOTE: This command can be used only with P9500 and XP24000/XP20000. To delete a THP/Smart pool, all assignments between the THP/Smart pool and the THP/Smart volumes must be released. For details about releasing the assignations between the THP/Smart pool and the THP/Smart volumes, see “ModifyVirtualVolume” on page 235.
Command execution result RESPONSE: (Command completed; empty list returned) DeleteStorageArray DeleteStorageArray removes a storage system (including an SMI-S enabled storage system) so that it is no longer managed by the Device Manager server. This command only removes the storage system from Device Manager management control. The command does not change the configuration of the storage system.
Parameter name Status saobjid Optional# Description Object ID of the SMI-S enabled storage system to delete Specify the object ID obtained from another CLI response. The value is encoded by the CLI. # Always specify either the serialnum and model parameters together, or the saobjid parameter by itself. Do not specify saobjid together with serialnum and model. Doing so results in an error.
NOTE: • For P9500 and XP24000/XP20000, if you delete the specified virtual parity group, the virtual parity group and the THP/Smart volumes contained in that virtual parity group are also deleted. • For P9500, if you delete specified THP/Smart volumes, the virtual parity group that contains the THP/Smart volumes is also deleted. • For XP24000/XP20000, if you delete specified THP volumes, you cannot delete the virtual parity group that contains the THP volumes.
Parameter name Status Description model Required Model of the storage system Optional (XP24000 Specifies whether to delete THP volumes that have not been released from the THP pool. XP20000) To delete such THP volumes, specify force. deletionoption arraygroup# names Optional Name(s) of the virtual parity group(s). Use a comma to delimit multiple values. Device number(s) of the THP/Smart volume(s).
Command execution result RESPONSE: (Command completed; empty list returned) DeleteVLDEVFromVRPU DeleteVLDEVFromVRPU deletes an LDEV from a resource group used for data migrations that use virtual IDs, and then deletes the LDEV virtual information. NOTE: • This command can be used only with P9500 with a microcode version of 70-05-04-XX/XX or later. • To delete multiple LDEVs, use the batch function. For details about the batch function, see Chapter 6 on page 419.
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.
NOTE: • This command is available only for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200. The microcode version required for XP12000/XP10000/SVS200 is 50-09-00-XX/XX or later. • When formatting the LDEV, make sure that the value of the status attribute of the LDEV is Blocked. If the value of status is Normal, specify true in the force parameter when you format the LDEV.
Parameter name Status Description Specifies whether to format LDEVs whose status is Normal. You can specify the following values: force Optional • true: Format LDEVs whose status is Normal. • false: Do not format LDEVs whose status is Normal. If this parameter is omitted, false is set. Specifies whether to format the LU by using Quick Format. You can specify the following values: • true: Format the LU by using Quick Format. quickformat Optional • false: Do not format the LU by using Quick Format.
devNum=1,175 displayName=00:04:97 emulation=OPEN-V devCount=1 devType= capacityInKB=100,000 numberOfLBAs=200,000 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=0 arrayGroupName=1-1-1 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
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 objectID=***** devNum=1,176 displayName=00:04:98 emulation=OPEN-V devCount=1 devType= capacityInKB=100,000 numberOfLBAs=200,000 path=false commandDevice=false commandDeviceEx=0
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 status=Normal thpType=-1 consumedSizeInKB=100,000 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypte
*****: 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 result 1 This execution result indicates that the operation for shrinking the THP/Smart pool has not finished because the LogicalUnit instances corresponding to the THP/Smart pool volumes (devnum: 00:06:0B) specified by the ShrinkPool command are displayed. RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 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 externalVolum
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 values are encoded by the CLI.
migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable 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 30 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation
GetStorageArray GetStorageArray obtains information about storage systems managed by the Device Manager server. To acquire the information about a specific element or to narrow down the range of information acquired by specifying conditions, use the parameter subtarget, the subinfo parameters (such as the parameters arraygroupsubinfo and lusubinfo), and other parameters of the GetStorageArray command.
Value of subtarget Information that can be acquired Location CommParameters Information about how to access storage systems GetStorageArray (subtarget=CommParameters) , page 143 Component Information about the configuration of storage systems GetStorageArray (subtarget=Component) , page 144 ExternalStorage Information about the external connection of storage systems GetStorageArray (subtarget=ExternalStorage) , page 147 Filter Information about the storage system for a specific element GetStor
Value of subtarget Information that can be acquired Location VResourcePartitionUnit Information about resource groups used for data migration using virtual IDs GetStorageArray (subtarget=VResourcePartitionUnit), page 195 Table 45 Subinfo parameters that can be used together with the parameter subtarget Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information The following information about parity groups can be acquired:
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information Specify LDEV for the parameter lusubinfo when using this parameter.
The following table shows examples of specifying the parameter subtarget and the subinfo parameters.
Parameters Table 47 GetStorageArray (subtarget not specified) command parameters Parameter name Status Description Serial number of the storage system serialnum # Optional You cannot specify this parameter if you are obtaining information about a particular SMI-S enabled storage system. Model of the storage system # model Optional saobjid Optional# You cannot specify this parameter if you are obtaining information about a particular SMI-S enabled storage system.
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 largestFreeSpaceInKB=489,664,512 multipa
openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ArrayGroup) GetStorageArray (subtarget=ArrayGroup) obtains information about parity groups. Parameters Table 48 GetStorageArray (subtarget=ArrayGroup) command parameters Parameter name Status Description subtarget Required Specify ArrayGroup.
Parameter name Status Description 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. startElementNumFilter Optional When parity group information is ordered as shown below and numbered from 0 upward, specify the first number in the sequence of parity groups that you want to obtain. Order of parity groups: 1. Chassis numbers in ascending order 2.
Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
*****: 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). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_ArrayGroup.log" subtarget=ArrayGroup model=XP1024 serialnum=10001 objectid=***** *****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . .
mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=192,256,560 openUnallocatedCapacity=17,382,240 openUnallocatedActualCapacity=17,382,240 openReservedCapacity=0 openReservedActualCapacity=0 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 *****: The value is encoded by the CLI.
Parameter name Status Description model Optional# Model of the storage system You cannot specify this parameter if you are obtaining information about a particular SMI-S enabled storage system. Object ID of the SMI-S enabled storage system saobjid # Optional Specify the object ID obtained from another CLI response. The value is encoded by the CLI. # Do not set saobjid together with serialnum and model. Doing so results in an error.
Parameters Table 50 GetStorageArray (subtarget=Component) command parameters Parameter name Status Description subtarget Required Specify Component. 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.
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 largestFreeSpaceInKB=489,664,512 multipathSupport=1 securityStatus=2 sequenceNumber=10007 displayArrayFamily=R600 displayArrayType=R600 numberOfLUs=3,412 numberOfAllocatedLUs=1,739 numberOfUnallocatedLUs=1,671 slprStatus=0 openTotalCapacity=6,52
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 Fan value=1 description=Normal An instance of Component name=DKC Power Supply value=1 description=Normal An instance of Component name=DKC Processor value=4 description=Moderate An instance of Component name=DKC Shared Memory value=1 descript
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. Model 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 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=-1 threshold=-1 tcaPool
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 List of 1 Volu
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.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolFunction value appears under An instance of Pool. Use this value to specify the poolfunction parameter. 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.
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 elements: An instance of LogicalUnit objectID=***** devNum=3
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 chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPool
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 instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,033
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 chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVol
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.
and the value for subtarget=Port. In the execution result of this command, the required portID value appears under An instance of Port. Use this portID value to specify the port parameter. portname 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.
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. GetStorageArray (subtarget=PortController) GetStorageArray (subtarget=PortController) obtains the information about port controllers.
Parameter name Status Description Specific information about the port controller you intend to obtain controllersubinfo Optional Available values are IPAddress and PairedPortController. You can specify either one or both of these values. The information about IPAddress and PairedPortController is valid for the NAS configuration. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
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). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_PortController.
Parameters Table 64 GetStorageArray (subtarget=ReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify ReplicationInfo. 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. objectid Obtain this value from the execution result of the GetStorageArray (subtarget=ReplicationInfo) command. Execute this command by specifying only the model and serialnum parameters, and ReplicationInfo for the subtarget parameter.
devCount=1 devType= capacityInKB=2,403,360 numberOfLBAs=4,806,720 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=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 journalPoolID=-1 thpType=-1 consumedCapacityI
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=TieringPolicy) GetStorageArray (subtarget=TieringPolicy) obtains information about tiering policies that can be applied to Smart volumes of P9500. NOTE: If the microcode version of P9500 is not 70-05-00-XX/XX or later, some attributes cannot output valid values.
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.
Parameters Table 66 GetStorageArray (subtarget=VResourcePartitionUnit) command parameters Parameter name Status Description subtarget Required Specify VResourcePartitionUnit. 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.
Parameter name Status Description Virtual domain ID of the host storage domain Specify this parameter when you want to obtain information about a specific virtual host storage domain. vdomain Optional If you specify this parameter, you must also specify the vfamily, vserialnum, vport, and vrpusubinfo parameters. For the vrpusubinfo parameter, specify VHostStorageDomain. This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix.
Parameter name Status Description Number of the first LDEV for which information is obtained Specify this parameter when you want to obtain virtual information about only some of the LDEVs in a specific storage system. startVldevElementNumFilter Optional When LDEVs are ordered by device number from 0 upward, specify the number of the LDEV from which you want to start obtaining information.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
.(repeated for other VLDEV instances) . *****: The values are encoded by the CLI. GetTieredPoolStatus GetTieredPoolStatus obtains the execution status of performance monitoring and hardware tier relocation for a Smart pool executed by using the AddTieredPoolOperation command. NOTE: This command can be used only with P9500.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
GetZeroPageReclaimStatus GetZeroPageReclaimStatus obtains the execution status of a zero-page reclaim operation executed on THP/Smart volumes by the RunZeroPageReclaim command. If LogicalUnit instances are displayed in the execution result of the GetZeroPageReclaimStatus command, the zero-page reclaim operation is in progress. When the operation finishes, the LogicalUnit instances are no longer displayed.
RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
ModifyArrayReservation ModifyArrayReservation extends the interval before the target storage system is unlocked. Parameters Table 69 ModifyArrayReservation 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 70 ModifyExternalTierRank 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 of a THP/Smart pool Specify the device number of the logical unit of the THP/Smart pool volume whose external LDEV tier rank is changed to High.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. When you execute this command, specify values that have been obtained in advance for the serialnum and model parameters, and then specify 5 (Thin Provisioning) for the poolfilter parameter. In the execution result of this command, the poolID values appear under An instance of Pool.
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,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 capacit
Parameter name Status Description Device number of the logical unit 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.
targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device.
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. devnum Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit) command.
SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 *****: The value is encoded by the CLI. 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.
When changing only the settings related to the THP/Smart pool: hdvmcli [URL] ModifyPool [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] [overprovisioninglimit=over-provisioning-limit-threshold] [tiercontrol={enable|disable}] [automigration={enable|disable}] [migrationinterval={0|1|2|4|8|24}] [monitorstarttime=start-time-of-performanc
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. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: threshold#1, #2 Optional Specify a multiple of 5 in the range from 5 to 95. For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100.
Parameter name Status Description Over provisioning warning 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: overprovision#1, #2, ingwarning Optional #3 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Specify -1 to cancel an already set threshold value. For XP24000/XP20000: Specify an integer from 10 to 1000.
Parameter name Status Description Specify whether to automatically execute performance monitoring and hardware tier relocation. If you specify this parameter, you must also specify tiercontrol=enable. automigra#1, #5 tion Optional (P9500) This parameter can be specified when tiercontrol is set to enable. One of the following values can be specified. • enable: Performs automatic execution. • disable: Does not perform automatic execution.
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 chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortControl
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.
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 74 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 Optional List of host mode options (P9500 To specify two or more options, separate them with semicolons (;). XP24000 hostmodeoption XP20000 XP12000 XP10000 SVS200) For details about the values that you can specify, see Table 23. If you specify this parameter, an existing value is deleted and the new value is set. If you specify this parameter, you must also specify the domain or nickname parameter.
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 75 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 76 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 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. • If you are releasing a THP volume from a THP pool, it must not have a path.
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] ModifyVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-THP-volume threshold=usage-rate-threshold-of-THP-volumes Parameters Table 78 ModifyVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the stora
Parameter name Status Description Capacity of the THP/Smart volume after expansion You can use the capacitytype parameter to specify the unit used for capacity (KB or blocks). Optional capacity (P9500) The following values show the maximum capacity that can be specified: For P9500: - 64424505600 (in KB) - 128849011200 (in blocks) Tiering policy to be applied to Smart volumes.
Parameter name Status Optional capacitytype (P9500) Description Unit of the value specified in the capacity parameter. You can specify either KB or block. If this parameter is omitted, KB is set. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=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 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=15 tcaPoolID=-1 thpPoolVolControlF
emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=1,048,576 lba=-1 raidType=substance=0 volumeType=-1 slotSizeInKB=256 chassis=16,486 arrayGroup=99 arrayGroupName=X2148-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1
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) .
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. NOTE: This command can be used only when HP StorageWorks P9000 Performance Advisor Software is connected to.
Command execution example In this example, the RefreshPerformanceData command refreshes performance information for a specific storage system. hdvmcli RefreshPerformanceData -o "D:\logs\RefreshPerformanceData.
Parameter name Status Description Interval time in minutes from storage system re-discovery completion to start of next storage system re-discovery interval Optional Only specify this parameter when refreshmode=1 (when storage systems are refreshed sequentially). An error occurs if this parameter is specified when refreshmode=2. You can specify a value from 0 to 2147483647. The default is 0.
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) . RunZeroPageReclaim RunZeroPageReclaim performs a zero-page reclaim operation, which returns unused capacity in THP/Smart volumes (virtual volumes). NOTE: This command can be used only with P9500 and XP24000/XP20000.
Parameter Name Status Description 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. Use a comma to delimit multiple values.
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 CLI. ShrinkPool The ShrinkPool command shrinks the THP/Smart pool.
Parameter name Status Description 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. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values. The maximum number of device numbers that can be specified is 1,024.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
numberOfLBAs=20,972,160 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=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 tc
threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=1 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The value is encoded by the CLI. Commands related to logical groups The logical group commands can be used to obtain logical group information. When using the Core CLI/SMI-S license, you cannot use the logical group commands. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 19.
Parameter name Status Description Type of the logical group to be obtained One of the following values can be specified. The values are not case-sensitive. • public: Public Logical Groups Logical groups that can be viewed by all users targetoption Optional • private: Private Logical Groups Logical groups that can be viewed by only users who are assigned to the same user group as the user who executes the command If this parameter is omitted, public is set.
Command execution example 2 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=path" *****: The value is encoded by the CLI.
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 *****: The values are encoded by the CLI.
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 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.
ageDomain. 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. portname 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.
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 mfUniversalReplicatorVolumeType=Unknown
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 Required wwn 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 292.
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 86 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 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 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 88 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 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.
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: This command does not support virtualization servers. To register a virtualization server, use the AddVirtualizationServer command. Parameters Table 89 AddHost command parameters Parameter name Status Description Name of the new host hostname Required You can use a character string of 1-64 bytes for a name. Spaces at the beginning or end of a name are not registered.
hostID=279 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 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, 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 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: • Device Manager uses vMA or Host Data Collector to register a virtualization server. - vMA: Can be used in VMware ESX 4.x or VMware ESXi 4.x. - Host Data Collector: Can be used in 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. However, management cannot be switched from management using Host Data Collector to management using vMA.
Parameters Table 92 AddVirtualizationServer command parameters Parameter name Status Description IP address ipaddress Required For details about specifiable values, see Table 93. 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.
Command execution result 2 RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 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.
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. In the execution result of this command, the name value appears under An instance of Host. Use this name value to specify the hostname 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. 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.
Parameters Table 96 GetHost command parameters Parameter name Status Description Object ID of the host to return Omit this parameter to include all hosts. objectid Optional Do not specify the hostname and hostfilter parameter at the same time. If they are specified at the same time, an error occurs. Name of the host to obtain information about Omit this parameter to include all hosts. hostname Optional Do not specify the objectid and hostfilter parameter at the same time.
Parameter name Status Description Specify this parameter if you want to obtain path information (the Path instance) about logical units. lusubinfo Optional Path is the only value that you can specify. If you specify this parameter, you must also specify subtarget=LogicalUnit. Specify this parameter if you want to obtain HostInfo information (HostInfo instance) about a path. pathsubinfo Optional HostInfo is the only value that you can specify.
WWN=11.44.77.22.55.88.33.66 nickname=Jone List of 1 ConfigFile elements: An instance of ConfigFile objectID=***** instanceNumber=11 controlledBy=Device Manager portNumber=50000 valid=1 List of 1 ReplicationGroup elements: An instance of ReplicationGroup objectID=***** replicationGroupID=3 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.
svolSerialNumber=65010001 svolDevNum=102 displaySvolDevNum=00:66 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessCopy status=1 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 *****: The values are encoded by the CLI. Command execution example 2 In this example, specify MAINFRAME in the hostfilter parameter to obtain only the mainframe host information. hdvmcli GetHost hostfilter=MAINFRAME -o "D:\logs\GetHost.
Command execution result 3 RESPONSE: An instance of Host objectID=***** name=test hostID=1 capacityInKB=8,097,280 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 WWN elements: An instance of WWN WWN=10.00.00.00.C9.6F.EB.
objectID=***** devNum=1,008 portID=10 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true An instance of Path objectID=***** devNum=1,008 portID=11 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true List of 1 HostInfo elements: An instance of HostInfo objectID=***** name=test serialNumber=10037 arrayType=XP24000 mountPoint= portID=11 portName=CL7-E domainID=7 scsiID=15 lun=20 devNum=1,008 displayDevNum=00:03:F0 osScsiBus=1 osScsiID=4 osLun=20 portWWN=10.00.00.00.C9.6F.EB.
Command execution result 4-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 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 WWN elements: An instance of WWN WWN=10.00.00.00.C9.6F.E8.FD List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.
Command execution example 5 In this example, the command obtains information regarding the disk configuration of the virtualization server (hostname = ha8krs02). hdvmcli GetHost -o "D:\logs\GetHost_VM_Datastore.log" "hostname=ha8krs02" subtarget=VM,Datastore Command execution result 5 RESPONSE: An instance of Host objectID=***** name=ha8krs02 hostID=5 capacityInKB=0 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESXi 4.1.
An instance of Datastore datastoreID=[datastore-1191] vm2/vm2_1.vmdk name=[ds1] vm2/vm2_1.vmdk datastoreType=2 An instance of Datastore datastoreID=[datastore-1191] vm2/vm2_2.vmdk name=[ds1] vm2/vm2_2.vmdk datastoreType=2 An instance of Datastore datastoreID=datastore-1176 name=datastore1 datastoreType=1 An instance of Datastore datastoreID=datastore-1191 name=ds1 datastoreType=1 *****: The values are encoded by the CLI. GetHostInfo GetHostInfo returns the host-based information about a LUN.
Command execution result 1 RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.159 mountPoint=C: portID=7 portName=CL1-H domainID=0 scsiID=15 lun=3 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.
portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 . . (repeated for other HostInfo instances) . *****: The value is encoded by the CLI. HostScan HostScan registers (into the Device Manager server database) any host whose host name is the nickname of a host storage domain, and adds (to that host's information in the database) the WWN that was assigned to the host storage domain.
3. For each of the host storage domains (ordered as described in step 2), HostScan adds the WWNs detected in step 1 into the host information. The information is added for any host whose host name is the nickname of a host storage domain. However, if a corresponding host is not registered, the host is registered with a host name identical to a host storage domain nickname and then the information is added to the host information.
Command execution example hdvmcli HostScan -o "D:\logs\HostScan.log" model=XP12000 serialnum=14053 Command execution result RESPONSE: (Command completed; no data returned) ImportHosts ImportHosts imports information about hosts from the input files (CSV-format host information file and mapping definition file). This command also checks information in input files. The following describes the format of the ImportHosts command and its parameters.
hdvmcli [URL] ImportHosts [options] inputfile=host-information-file-name [mappingfile=mapping-definition-file-name] [resultfilepath=output-destination-of-error-information-file] function=import [overwrite={true|false}] Parameters Table 99 ImportHosts command parameters Parameter name Status Description Host information file name Use an absolute path or relative path to specify a CSV file that contains host information.
Parameter name Status Description Specifies whether to update (overwrite) information about a host already registered with Device Manager if another host that has the same name is specified. • true: Update • false: Do not update overwrite Optional If true is specified, only the hosts that were manually registered by using the Device Manager GUI or CLI (AddHost command or HostScan command) are updated. If this parameter is omitted, false is assumed.
• Number of hosts that can be imported but for which a warning was given Number of hosts that can be imported but for which a warning was issued Check the warnings issued to the error information output file, before importing hosts. Command execution example 2 In this example, the ImportHosts command with import specified for the function parameter imports information about hosts. hdvmcli ImportHosts "function=import" "inputfile=D:\work\hostImport.csv" "mappingfile=D:\work\import.
• External ports • Virtualization servers Parameters Table 100 MergeHost command parameters Parameter name Status Description targetname Required Name of the target host Names of the source hosts hostnames Required To specify multiple host names, separate them by commas. Commas contained in the host name are recognized as delimiters.
ModifyHost ModifyHost modifies information about a host server. NOTE: • This command cannot change WWN information for the external port of a host. • This command does not support virtualization servers. To modify information about a virtualization server, use the ModifyVirtualizationServer command.
Parameter name Status wwnlist Optional ipaddress Optional Description Comma-separated list of WWNs to replace existing WWNs If you omit this parameter, all WWNs in the host are deleted. New IPv4 IP address of an existing host Omit this parameter if you are not changing the IPv4 IP address of the host. New IPv6 IP address of an existing host ipv6address Optional Omit this parameter if you are not changing the IPv6 IP address of the host.
ModifyHostInfo ModifyHostInfo modifies a HostInfo record in the Device Manager server. NOTE: This command does not support virtualization servers. Parameters Table 102 ModifyHostInfo command parameters Parameter name Status objectid Required serialnum Optional model Optional Description Object ID of the HostInfo record to modify Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
Parameter name Status Description New domain ID of the path Omit this when no change is required. domain Optional 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. New device number of the path Omit this when no change is required.
domainID, and portID values appear under An instance of Path. Use these devNum, domainID, and portID values to specify the devnum, domain, and port parameters respectively. portname 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.
fileSystemType=NTFS1 fileSystemName=E: sizeInMB=156 percentUsed=50 lastUpdated=1039003476 *****: The value is encoded by the CLI. ModifyVirtualizationServer ModifyVirtualizationServer modifies information about virtualization servers. NOTE: • Device Manager uses vMA or Host Data Collector to manage information about virtualization servers. - vMA: Can be used in VMware ESX 4.x or VMware ESXi 4.x. - Host Data Collector: Can be used in VMware ESX 4.x, VMware ESXi 4.x, or VMware ESXi 5.x.
When switching the method of managing virtualization servers from using vMA to using Host Data Collector: hdvmcli [URL] ModifyVirtualizationServer [options] hostname=host-name-of-virtualization-server [ipaddress=IP-address-of-virtualization-server#] hostprotocol={Secure|Non-secure} [hostuserid=user-ID-of-virtualization-server#] [hostuserpassword=user-password-of-virtualization-server#] hdcipaddress=IP-address-of-Host Data Collector # Specify the value of VMware vCenter Server in a configuration in which VM
• To modify information about the virtualization servers managed by Host Data Collector, you need to specify at least one of the following parameters: ipaddress, hostprotocol, hostuserid, hostuserpassword, or hdcipaddress. #2 To switch the method of managing virtualization servers from using vMA to using Host Data Collector, you need to specify both the parameter hostprotocol and the parameter hdcipaddress.
Command execution result 1-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.boss hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.
Command execution example 1 This example updates a virtualization server (host name:boss.boss). The execution result of the command differs depending on which method is used to manage the virtualization server. hdvmcli RefreshVirtualizationServer -o "D:\logs\RefreshVirtualizationServer.log" "hostname=boss.boss" 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.
hdcIPAddress=10.208.119.110 ipAddress=10.208.119.113 portNumber=443 protocol=Secure userID=root *****: 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.
Parameters Table 105 AddURLLink command parameters Parameter name Status Description URL of the application or Web page Required url The complete URL is required to launch the application or web page. If you specify the URL as an IPv6 IP address, enclose the IP address in square brackets ([ ]). Required name Name of the URLLink Object ID of the Device Manager object for which the URLLink is set linkedid Required Must be a valid, existing the object ID.
DeleteAlerts DeleteAlerts deletes alerts present on the Device Manager server. You can either delete a specific alert by specifying the alert number, or delete all alerts originating from a specific source by specifying the source. Parameters Table 106 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.
Command execution result 2 RESPONSE (Command completed; no data returned) DeleteURLLink DeleteURLLink deletes the URLLinks that is set for a Device Manager object managed by the Device Manager server. NOTE: This command does not support virtualization servers.
Parameter name Status Description Type of the Device Manager object from which the URLLink is deleted One of the following values can be specified. The values are not case-sensitive. targetoption Optional • smi-s: SMI-S enabled storage system • other: Device Manager object other than an SMI-S enabled storage system If this parameter is omitted, other is set. #1 Specify either objectid or linkedid. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs.
Parameter name Status Description Request only messages newer than the date and time. timefilter Optional Required format is YYYY/MM/DD HH:MM:SS. If you omit this parameter, the number of obtainable alerts is unlimited. Parameter values to obtain in advance None. Command execution example hdvmcli GetAlerts -o D:\logs\GetAlerts.
Command execution example hdvmcli GetServerInfo -o "D:\logs\GetServerInfo.log" Command execution result RESPONSE: An instance of ServerInfo buildVersion=Build 0760-nn (Oct 16, 2013) serverURL=http://localhost:2001 upTime=3 hours 23 minutes 9 seconds upSince=Wed, 16 Oct 2013 23:21:45 GMT currentApiVersion=7.
GetURLLink GetURLLink obtains information about the URLLinks that are set for a Device Manager object managed by the Device Manager server.
Parameter name Status Description Type of the Device Manager object for which the URLLink is set targetoption Optional# One of the following values can be specified. The values are not case-sensitive. • smi-s: SMI-S enabled storage system • other: Device Manager object other than an SMI-S enabled storage system # • If objectid, linkedid, and targetoption are all omitted, all URLLink information is acquired for all of the Device Manager objects, regardless of the type.
AddConfigFileForReplication AddConfigFileForReplication creates the HORCM configuration file for RAID Manager that is required to create copy pairs for Business Copy Software, Continuous Access Synchronous Software, Continuous Access Asynchronous Software, Snapshot, and Continuous Access Journal Software. NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap.
|Snapshot|ContinuousAccessJournal} [munum=Mu-number] • Method 3: Creates a new RAID Manager configuration definition file.
Parameter name Status svolhostid Required Description Host ID for identifying the S-VOL When using Method 1, specify the host ID of the S-VOL of a group specified in the definition file. Instance number of the HORCM instance for managing the S-VOL svolinstancenum Optional When using Method 1, specify the instance number of the S-VOL of a group specified in the definition file. You must specify this parameter when you are using method 1 or 2.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the P-VOL is to be stored. For Snapshot: You must specify this parameter. For Continuous Access Asynchronous Software: pvolpoolid Optional You must specify this parameter. For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description Type of operation that is to be executed with the copy pair You can specify the following values: • BusinessCopy: Business Copy Software replicationfunction Required • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot • ContinuousAccessJournal: Continuous Access Journal Software MU number of the P-VOL This parameter can be specified only for Continuous Access Journal Softwa
See No. 2, No. 5, No. 6, and No. 7 in the table below. Table 111 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.
Journal Software. When you create a copy pair, the HORCM configuration file for RAID Manager, contained in the host, is rewritten. NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • 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. • You must specify a formatted LDEV.
[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 adds a copy pair to the copy group.
Parameter name Status Description 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. Port number of the HORCM instance that manages the P-VOL Depending on the host OS, specify the appropriate value: • For Solaris systems: Specify an integer in the range 0-65535.
Parameter name Status Description Port ID in the HORCM configuration file that manages the P-VOL paths pvolportid Optional If you specify this parameter, specify either pvolportid or pvolportname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Port name in the HORCM configuration file managing the P-VOL path pvolportname Optional If you specify this parameter, specify either pvolportid or pvolportname.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the S-VOL is to be stored For Continuous Access Asynchronous Software: You must specify this parameter. svolpoolid Optional For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description pairoption Optional The following value can be specified only when XP12000/XP10000/SVS200 is being used: suspend: Creates a delta resync pair. Parameter values to obtain in advance Parameter values to obtain in advance depend on how you will create a copy pair. • When Method 1 is used: See No. 1, No. 4, and No. 5 in the table below. • When Method 2 is used: See No. 2, No. 3, No. 4, No. 5, and No. 6 in the table below. • When Method 3 is used: See No. 2, No. 4, No.
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 To obtain the pvolhostid parameter value, specify the host on which the RAID Manager instance that manages the P-VOL is installed. To obtain the svolhostid parameter value, specify the host on which the RAID Manager instance that manages the S-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with LogicalUnit specified for the subtarget parameter and the name of the host that recognizes the P-VOL or the S-VOL specified for the hostname parameter. The execution result of the GetHost command displays the objectID value (object ID of the logical unit) and the devNum value under An instance of LogicalUnit.
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=Pool) with Pool specified for the subtarget parameter, the model name specified for the model parameter, and the serial number specified for the serialnum parameter. The execution result of the GetStorageArray (subtarget=Pool) command displays the values of poolFunction and PoolID under An instance of Pool. 6 pvolpoolid svolpoolid If you execute the command with the values of pvolarraytype and pvolserialnum recorded in No.
copyTrackSize=15 List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pairName=HCMD_CP0004 pvolSerialNumber=6501001 pvolArrayType=XP1024 pvolDevNum=5 displayPvolDevNum=00:05 pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=65010012 svolArrayType=XP1024 svolDevNum=10 displaySvolDevNum=00:0A svolObjectID=***** svolPoolID=-1 fenceLevel=Data replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=15 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngA
pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
Command execution result 3 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=2 groupName=HCMD_CG0002 pvolHostID=5 pvolInstanceNumber=15 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=4 svolInstanceNumber=15 svolPortNumber=50.002 pvolHORCMINSTHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • 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 Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum 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.
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.
GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair. In P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, replication controller pairs indicate paths between MCUs and RCUs.
• If you specify the mastermodel, remotefamily, or remotepathgroupid parameter, you also need to specify all other parameters (masterserialnum, mastercontrollerid, remoteserialnum, remotessid, mastermodel, remotefamily, and remotepathgroupid). If you do not specify them at the same time, an error occurs. • If you omit all the parameters, the command obtains the information about all replication controller pairs.
Command execution example 2 This example obtains the controller pair information in all storage systems that have been registered in the Device Manager database. hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
Parameters Table 116 ModifyReplication command parameters Parameter name Status Description replicationgroupid Required Number of the copy group 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 copy pair, the copy pair is split after the re-synchronization.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum# 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.
hdvmcli ModifyReplication -o "D:\logs\ModifyReplication.log" "replicationgroupid=12" "operation=split" "pvolserialnum=65010001" "pvoldevnum=20" "svolserialnum=65010001" "svoldevnum=21" Command execution result RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=12 groupName=HCMD_CG000d pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.
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 211 Table 118 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 274 GetHost, page 281 GetStorageArray (subtarget=CommParameters) , page 143 ModifyVirtualizationServer, page 304 RefreshStorageArrays, page 244 RefreshVirtualizationServer, page 307 Table 120 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: 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 93. For other cases, no value is output.
Component instance Commands for which a Component instance is output • GetStorageArray (subtarget=Component) , page 144 Table 121 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 281 Table 122 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 124 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 127 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 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.
Attribute Description ipAddress IPv4 IP address of the host ipv6Address IPv6 IP address of the host LUN mount point mountPoint A space is output for a virtualization server. portID Port ID domainID Domain ID of the host storage domain SCSI ID assigned to a channel in the storage system scsiID 15 is output for Fibre Channel.
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 Domain type of the host storage domain domainType 0 (host group) is output. portName Port name of the host storage domain IPAddress instance Commands for which an IPAddress instance is output • GetStorageArray (subtarget=PortController) , page 188 Table 131 IPAddress instance attribute Attribute Description IP address of the port controller ipAddress This item is output when NAS is created.
Attribute Description Device number of the LDEV 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. For XP12000/XP10000/SVS200 or XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output. displayName Display name of the LDEV Emulation mode emulation This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8).
Attribute Description Option information of the external volume For P9500, XP24000/XP20000 or XP12000/XP10000/SVS200, a 4-bit value is converted to decimal and is output.
Attribute Description SLPR number slprNumber This item is output for XP24000/XP20000 or XP12000/XP10000/SVS200. -1 is output for other storage systems. CLPR number clprNumber This item is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. -1 is output for other storage systems.
Attribute Description Type of the THP/Smart volume One of the following values is output for P9500 or XP24000/XP20000: • -1: Non-THP/Smart volume thpType • 0: THP/Smart volume • 1: THP/Smart pool volume -1 is output for other storage systems.
Attribute Description Pool ID of LDEV One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: mfUniversalReplicatorPoolID • When the LDEV is the P-VOL, S-VOL, or SP-VOL of Hitachi Universal Replicator for Mainframe Software: Pool ID of the pool used by the logical unit • When the LDEV is a pool volume: Pool ID of the pool to which the LDEV has been assigned In other cases, -1 is output.
Attribute Description Indicates whether the data that is stored in the LDEV is encrypted. One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: encrypted • 0: The data is not encrypted. • 1: The data is encrypted. -1 is output for other storage systems.
LogicalGroup instance Commands for which a LogicalGroup instance is output • GetLogicalGroup, page 252 Table 134 LogicalGroup instance attributes Attribute Description objectID Object ID of the logical group name Name of the logical group description Description of the logical group Object ID of the logical group that the logical group being queried belongs to. parentID This item is not output when the logical group is the highest level.
LogicalUnit instance Commands for which a LogicalUnit instance is output • • • • • • • • • • • AddExternalArrayGroup, page 51 AddLogicalUnit, page 68 AddLUSE, page 74 AddPool, page 78 AddVirtualVolume, page 96 FormatLU, page 121 GetHost, page 281 GetPoolShrinkStatus, page 127 GetStorageArray (subtarget=ArrayGroup) , page 139 GetStorageArray (subtarget=LogicalUnit) , page 163 GetStorageArray (subtarget=Pool) , page 178 • • • • • • • • GetStorageArray (subtarget=ReplicationInfo) , page 190 GetZeroPageRecla
Attribute Description Type of the LDEV contained in the logical unit devType This item indicates the purpose of the LDEV. CommandDevice: The LDEV is a command device. capacityInKB Volume size of the logical unit (in KB) numberOfLBAs Number of LBAs (capacity in blocks) Indicates whether a path is assigned to the logical unit: path • true: A path is assigned. • false: No path is assigned. Indicates whether the logical unit is used a command device: commandDevice • true: Used as a command device.
Attribute Description Volume type of Continuous Access Software • Unknown: Unknown continuousAccessVolumeType • Simplex: Not a Continuous Access Software volume • P-VOL • S-VOL Volume type of Business Copy Software • Unknown: Unknown businessCopyVolumeType • Simplex: Not a Business Copy Software volume • P-VOL • S-VOL • SP-VOL Volume type of Snapshot or Fast Snap • Unknown: Unknown • Simplex: Not a Snapshot or Fast Snap volume snapshotVolumeType • P-VOL • V-VOL • POOL Volume type of Continuous Access
Attribute Description Pool ID of logical unit One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: journalPoolID • When the logical unit is the P-VOL, S-VOL,or SP-VOL of Continuous Access Journal Software: Pool ID of the pool used by the logical unit • When the logical unit is a pool volume: Pool ID of the pool to which the logical unit has been assigned In other cases, -1 is output.
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 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. • For volumes other than THP/Smart volumes : -1 is output.
Attribute Description Device number of the P-VOL For P9500 or XP24000/XP20000: displayPvolDevNum 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: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description Copy status • -1: Unknown • 0: Simplex • 1: Pair • 8: Copying status • 9: Reverse-Copying • 16: Split • 17: Error • 18: Error in LUSE • 24: Suspending • 25: Deleting MU number of the P-VOL If the value of replicationFunction is UniversalReplicatorForMF: 0 to 3 muNumber -1 is output if the MU number is unknown. If the value of replicationFunction is not UniversalReplicatorForMF, this information is invalid.
PairedPool instance Commands for which a PairedPool instance is output • GetStorageArray (subtarget=Pool) , page 178 Table 138 PairedPool instance attributes Attribute Description muNumber The MU number of the paired pool pairedSerialNumber The serial number of the paired pool The type of paired pool storage system pairedArrayType A valid value is output for this item only when the storage system that contains the paired pool has been registered in Device Manager.
• GetStorageArray (subtarget=Port) , page 185 Table 140 Path instance attributes Attribute Description objectID Object ID of the path Path name name This item is output if it has been registered. Device number for identifying 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.
• ModifyPool, page 211 Table 141 PDEV instance attributes Attribute Description objectID Object ID of the physical device Drive name name This item is output if it has been registered. chassis Number of the chassis where the physical device exists Parity group containing the physical device arrayGroup -1 is output if the physical device does not belong to the parity group.
Attribute Description Drive revolutions per minute This information is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. rpm 0 or -1 is output if the drive revolutions are unknown. Drive type of the physical device • -1: Unknown • 0: FC diskType • 1: SATA • 4: SAS • 5: SSD formFactor Currently, this information does not apply to storage systems (-1 is output).
Pool instance Commands for which a Pool instance is output • • • • • • • • AddPool, page 78 AddTieredPoolOperation, page 93 GetPoolShrinkStatus, page 127 GetStorageArray (subtarget=Pool) , page 178 GetTieredPoolStatus, page 200 ModifyExternalTierRank, page 204 ModifyPool, page 211 ShrinkPool, page 248 NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.2, have changed to overProvisioningWarning and overProvisioningLimit, respectively.
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 diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • 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 204 ModifyPool, page 211 Table 144 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 diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • 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 bufSpaceForNewPageAssignment Percentage of buffer space for n
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 228 Table 146 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 147.
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 314 Table 151 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 •
• • • • • • • • • • • • • • • • GetPoolShrinkStatus, page 127 GetStorageArray (subtarget not specified) , page 136 GetStorageArray (subtarget=ArrayGroup) , page 139 GetStorageArray (subtarget=CommParameters) , page 143 GetStorageArray (subtarget=Component) , page 144 GetStorageArray (subtarget=ExternalStorage) , page 147 GetStorageArray (subtarget=Filter) , page 148 GetStorageArray (subtarget=FreeSpace) , page 150 GetStorageArray (subtarget=HostStorageDomain) , page 154 GetStorageArray (subtarget=LDEV) , p
Attribute Description Name of the storage system name This item is output if it has been registered. description Description of the storage system serialNumber Serial number of the storage system arrayFamily Family of the storage system arrayType Type of the storage system SVP microcode version microcodeVersion This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128.
Attribute Description Total value of the following sizes (in KB) • Total size of the logical units to which paths are not assigned (freeCapacityInKB) capacityInKB • Total size of the logical units to which paths are assigned (allocatedCapacityInKB) • Total size of the logical units reserved for Auto LUN Software (autoLunCapacityInKB) • Total size of the LDEVs expanded on demand (onDemandCapacityInKB) freeCapacityInKB Total size of the logical units to which paths are not assigned (in KB) allocatedCapa
Attribute Description Total value of the following sizes (in KB) • Total size of the open logical units to which paths are assigned (openAllocatedCapacity) openTotalCapacity • Total size of the open logical units to which paths are not assigned (openFreeCapacity) • Total size of the open logical units reserved for Auto LUN Software (openAutoLunCapacity) • Total size of the open logical units expanded on demand (openOnDemandCapacity) Total size of the open logical units to which paths are assigned (in KB)
Attribute Description An attribute for compatibility. imOnDemandCapacity For details, see Table 153. Total size of the mainframe logical devices (in KB) mfTotalCapacity Total value of the sizeInKB attributes of the LDEV instances whose volumeKind attribute is 1. Total size of the mainframe logical devices reserved for Auto LUN Software (in KB) mfAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 1.
Attribute Description This item indicates whether an unformatted logical unit can be created. One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: autoFormatLU • -1: Unknown • 0: Able to select whether to format a logical unit when it is created • 1: A logical unit is automatically formatted when it is created For other storage systems, -1 is output. Indicates whether the target storage system is consistent with the Device Manager database.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): • Paths are not assigned. • Paths can be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity. openUnallocatedActualCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • thpType is not 0. • path is false. • volumeKind is 2 or 3.
Attribute Description Number of intermediate logical units that satisfy both the following conditions: numberOfImReservedLUs • Paths are not assigned. distributedMode Currently, this information does not apply to storage systems (-1 is output). • Paths cannot be assigned by using Device Manager. #1 The value obtained by dividing xxxInKB by 1,024 x 1,024 and then truncating anything after the decimal point.
Attribute totalFreeSpaceInGB# largestFreeSpaceInGB# Description Total size of the regions in which logical units can be created (regions of unused capacity) (in GB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups. Size of the largest region of unused capacity in which logical units can be created (in GB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
Attribute mfAllocatedCapacity mfUnallocatedCapacity Description Total size of the mainframe logical devices to which paths are assigned (in KB) Currently, this information does not apply to storage systems (0 is output). Total size of the mainframe logical devices to which paths are not assigned (in KB) Currently, this information does not apply to storage systems (0 is output). # The value obtained by dividing xxxInKB by 1,024 x 1,024 and then truncating anything after the decimal point.
Figure 3 Relationship of attributes (total size of the volumes in the storage system) Figure 4 Relationship of attributes (size of the physical volumes and virtual volumes) Figure 5 Relationship of attributes (the sizes of the volumes) TieringPolicy instance Commands for which a TieringPolicy instance is output • GetStorageArray (subtarget=TieringPolicy) , page 194 • ModifyTieringPolicy, page 233 Table 154 TieringPolicy instance attributes Attribute Description objectID Object ID of TieringPolicy CLI
Attribute Description 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 77. allocationThresholdT1Max#1, #2 allocationThresholdT1Min#2 allocationThresholdT3Max#2 allocationThresholdT3Min#2 Maximum allocation threshold value (%) for Tier 1 If a tiering policy has been applied, the maximum capacity threshold value allocated for Tier 1 is output.
Attribute Description Type of the URLLink • -1: URLLink set for a Device Manager object other than SMI-S enabled storage system createdByUser • 0: URLLink set by he Device Manager server for an SMI-S enabled storage system • 1: URLLink set by a user for an SMI-S enabled storage system VHostStorageDomain instance Commands for which a VHostStorageDomain instance is output • GetStorageArray (subtarget=HostStorageDomain) , page 154 • GetStorageArray (subtarget=VResourcePartitionUnit), page 195 Table 156 VHo
Attribute Description 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 195 Table 158 VLDEV instance attributes Attribute Description objectID Object ID of the VLDEV resourcePartitionUnitID ID of the resource group to which the virtualized resources belon
VM instance Commands for which a VM instance is output • GetHost, page 281 Table 159 VM instance attributes Attribute Description vmID Virtual machine ID name Virtual machine name guestOSVersion Guest OS name VolumeConnection instance Commands for which a VolumeConnection instance is output • GetStorageArray (subtarget=LDEV) , page 158 • GetStorageArray (subtarget=LogicalUnit) , page 163 Table 160 VolumeConnection instance attributes Attribute Description objectID Object ID of VolumeConnection Na
Attribute Description Product name of the external volume productName The product name might not be the same as the product name of the storage system. vendor Vendor name of the external volume Display name of the device number of the internal volume to which the external volume is mapped For P9500 or XP24000/XP20000: displayMappedDevNum 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.
VResourcePartitionUnit instance Commands for which a VResourcePartitionUnit instance is output • AddVLDEVToVRPU, page 104 • GetStorageArray (subtarget=VResourcePartitionUnit), page 195 Table 162 VResourcePartitionUnit instance attributes Attribute Description objectID Object ID of the VResourcePartitionUnit name Name of a resource group used for data migrations that use virtual IDs resourcePartitionUnitID ID of a resource group used for data migrations that use virtual IDs vArrayFamily Family of th
• RefreshVirtualizationServer, page 307 Table 163 WWN instance attributes Attribute Description World Wide Name WWN A World Wide Name is usually assigned to the HBA in the server. WWN nickname nickname 418 Output items This item is output if it has been registered.
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 420 • Conditions for parameters for processing a group of commands in a batch file, page 421 • Examples of batch file creation, page 427 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 172 Conditions for specification of parameters for the DeleteHostStorageDomain command Specification conditions Parameter deletionoption Condition-1 model serialnum domain Condition-2 domainnickname port portname Table 173 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 176 Conditions for specification of parameters for the ModifyVirtualVolume command Specification conditions Parameter Notes assign Condition-1 model -- serialnum capacity 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 177 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 294. 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: • To add hosts, the hosts whose information you imported are registered as normal hosts. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually. The ImportHosts command only updates normal hosts that were manually registered by using the Device Manager GUI or CLI (AddHost command or HostScan command).
5. Check the hosts that are newly imported. Related topics • • • • ImportHosts, page 294 Conventions for creating host information files (CSV files), page 438 Conventions for creating mapping definition files, page 439 Examples of input files, page 441 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.
The following table describes the properties (and their values) that can be specified in a mapping definition file. Table 179 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.
Examples of input files This section shows examples of input files to be created when host information such as that shown below is to be imported. 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.
Import functionality
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 445 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.
dtd=D:/dtd/cli.dtd 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 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 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.log" "url=http://192.168.99.114:24042" "name=MainframeAgent" "linkedid=*****" *****: The value is encoded by the CLI.
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 they have not been registered correctly, register them correctly by using the procedures described in “Registering the mainframe host in Device Manager” on page 456 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 457.
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 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Changing mainframe host information To change the information of a mainframe host registered in the Device Manager server, use the ModifyHost command.
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=snow hostID=1 capacityInKB=0 hostType=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 VResourcePartitionUnit vrpusubinfo Related topics • Using the GetStorageArray parameter, page 132 CSV-formatted execution results (GetStorageArray) The following shows an e
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 you use different Device Manager CLI versions, the order and number of items output as the execution result might be different even if the specified parameters are the same.
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. In the DOCTYPE declaration, the URI (Uniform Resource Identifier) of the DTD (Document Type Definition) specified in the properties file is output. To include the DOCTYPE declaration and line feed code in the execution results, you must specify a DTD in the properties file. Third line: XML elements are output.
HostInfo EMPTY> IPAddress EMPTY> ISCSIName EMPTY> LogicalDKC EMPTY> PairedPool EMPTY> PairedPortController EMPTY> PDEV EMPTY> VolumeConnection EMPTY> WWN EMPTY> ObjectLabel EMPTY> RelatedDistributedArrayGroup EMPTY> ExternalPathInfo EMPTY> ExternalStorage EMPTY> TieringPolicy EMPTY> VHostStorageDomain EMPTY> VLDE
osLun CDATA #IMPLIED> portWWN CDATA #IMPLIED> fileSystemType CDATA #IMPLIED> fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percentUsed CDATA #IMPLIED> lastUpdated CDATA #IMPLIED> portISCSIName CDATA #IMPLIED>
mfUniversalReplicatorPoolID CDATA #IMPLIED> thpPoolID CDATA #IMPLIED> threshold CDATA #IMPLIED> systemDisk CDATA #IMPLIED> encrypted CDATA #IMPLIED> thpTier0ConsumedCapacityInKB CDATA #IMPLIED> thpTier1ConsumedCapacityInKB CDATA #IMPLIED> thpTier2ConsumedCapacityInKB
name CDATA #IMPLIED> devNum CDATA #IMPLIED> displayDevNum CDATA #IMPLIED> portID CDATA #IMPLIED> portName CDATA #IMPLIED> domainID CDATA #IMPLIED> scsiID CDATA #IMPLIED> LUN CDATA #IMPLIED> wwnSecurityValidity CDATA #IMPL
overProvisioningLimit CDATA #IMPLIED> overProvisioningLimitEnforcement CDATA #IMPLIED> rpm CDAT
externalWWN CDATA #IMPLIED> externalLun CDATA #IMPLIED> portID CDATA #IMPLIED> pathGroupID CDATA #IMPLIED> priority CDATA #IMPLIED>
resourcePartitionUnitID CDATA #IMPLIED> devNum CDATA #IMPLIED> vArrayFamily CDATA #IMPLIED> vSerialNumber CDATA #IMPLIED> vDevNum CDATA #IMPLIED> vEmulation C
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 483Glossary This glossary defines the special terms used in this document.
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) 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 SLPR Storage Logical Partition SMI-S Storage Manageme
Index A access control, 43 acquiring Device Manager server information GetServerInfo, 314 AddArrayReservation, 49 AddConfigFileForReplication, 318 AddExternalArrayGroup, 51 AddHost, 269 AddHostInfo, 270 AddHostRefresh, 272 AddHostStorageDomain, 56 AddLabel, 66 AddLogicalUnit, 68 AddLun, 255 AddLUSE, 74 AddPool, 78 AddReplication, 327 AddStorageArray, 88 AddTieredPoolOperation, 93 AddURLLink, 309 AddVirtualizationServer, 274 AddVirtualVolume, 96 AddVLDEVToVRPU, 104 AddWWNForHostStorageDomain, 260 alert Delet
copy pair AddConfigFileForReplication, 318 AddReplication, 327 DeleteReplication, 339 ModifyReplication, 345 CSV file host information file, 436 ImportHosts, 438 CSV format execution results of GetStorageArray command, 466 parameters that cannot be specified for output, 465 D Datastore instance, 358 DeleteAlerts, 311 DeleteArrayReservation, 107 DeleteExternalArrayGroup, 108 DeleteHost, 279 DeleteHostInfo, 280 DeleteHostStorageDomain, 109 DeleteLabel, 110 DeleteLogicalUnit, 112 DeleteLun, 263 DeleteLUSE, 11
execution results output format, 30 outputting execution results of GetStorageArray command in CSV format, 465 outputting execution results of GetStorageArray command in XML format, 467 suppressing output, 31 external parity group AddExternalArrayGroup, 51 DeleteExternalArrayGroup, 108 ExternalPathInfo instance, 358 ExternalStorage instance, 359 F FormatLU, 121 FreeLUN instance, 359 FreeSpace instance, 360 G GetAlerts, 313 GetArrayReservation, 126 GetHost, 281 GetHostInfo, 290 GetLogicalGroup, 252 GetPool
I import functionality, 435 adding host information, 435 ImportHosts, 294, 435 input files, 436 migrating host information, 435 output files, 436 updating host information, 435 import.properties, 437 ImportHosts, 294, 435 ImportHosts command using, 436 input files example, 441 for ImportHosts, 436 host information file (CSV file), 436 import.
output files check results file, 436 error information file, 436 for ImportHosts, 436 output items Alert instance, 349 ArrayGroup instance, 350 ArrayReservation instance, 354 CommParameters instance, 355 Component instance, 357 ConfigFile instance, 358 Datastore instance, 358 ExternalPathInfo instance, 358 ExternalStorage instance, 359 FreeLUN instance, 359 FreeSpace instance, 360 Host instance, 360 HostInfo instance, 361 HostStorageDomain instance, 363 IPAddress instance, 364 LDEV instance, 364 LogicalDKC
public logical group, 253 R refreshing AddHostRefresh, 272 AddStorageArray, 88 AddVirtualizationServer, 274 RefreshPerformanceData, 243 RefreshStorageArrays, 244 RefreshVirtualizationServer, 307 RefreshPerformanceData, 243 RefreshStorageArrays, 244 RefreshVirtualizationServer, 307 registering storage system AddStorageArray, 88 DeleteStorageArray, 116 ModifyStorageArray, 230 RelatedDistributedArrayGroup instance, 394 replication controller pair GetReplicationControllerPair, 343 ReplicationControllerPair ins
virtual volume (Smart volume) AddVirtualVolume, 96 DeleteVirtualVolume, 117 GetStorageArray (subtarget=TieringPolicy), 194 GetZeroPageReclaimStatus, 202 ModifyTieringPolicy, 233 ModifyVirtualVolume, 235 RunZeroPageReclaim, 246 virtual volume (THP volume) AddVirtualVolume, 96 DeleteVirtualVolume, 117 GetZeroPageReclaimStatus, 202 ModifyVirtualVolume, 235 RunZeroPageReclaim, 246 VirtualDisk instance, 413 virtualization server AddVirtualizationServer, 274 Host Data Collector, 274 ModifyVirtualizationServer, 30
