HP XP7 Command View Advanced Edition CLI Reference Guide (TK981-96006, May 2014)

ManualsBrandsHP ManualsSoftwareHP XP Array Manager Enterprise Media Kit

HP XP7 Command View Advanced Edition

CLI Reference Guide

Part number: TK981-96006

First edition: April 2014

Summary of content (580 pages)

PAGE 1
HP XP7 Command View Advanced Edition CLI Reference Guide Part number: TK981-96006 First edition: April 2014
PAGE 2
Legal and notice information © Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
PAGE 3
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 ................
PAGE 4
Commands related to storage system management ........................................................................ 61 AddArrayReservation .......................................................................................................... 61 AddExternalArrayGroup ...................................................................................................... 63 AddHostStorageDomain ......................................................................................................
PAGE 5
GetStorageArray (subtarget=ReplicationInfo) ....................................................................... GetStorageArray (subtarget=SnapshotGroup) ...................................................................... GetStorageArray (subtarget=TieringPolicy) .......................................................................... GetStorageArray (subtarget=VResourcePartitionUnit) ............................................................. GetTieredPoolStatus .................................
PAGE 6
Commands related to replication .............................................................................................. AddConfigFileForReplication .............................................................................................. AddReplication ................................................................................................................ AddReplication (For Fast Snap) ..........................................................................................
PAGE 7
VHostStorageDomain instance .................................................................................................. VirtualDisk instance ................................................................................................................. VLDEV instance ...................................................................................................................... VM instance ........................................................................................................
PAGE 8
Related information ................................................................................................................. 541 A Connecting to XP7 mainframe agent ................................................ 543 About connecting to XP7 mainframe agent ................................................................................. Setting up the mainframe host environment .................................................................................
PAGE 9
Figures 1 Device Manager CLI execution environment ................................................................ 21 2 Example of executing the AddExternalArrayGroup command ........................................ 67 3 Relationship of attributes (total size of the volumes in the storage system) ...................... 494 4 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 494 5 Relationship of attributes (the sizes of the volumes) ..........................
PAGE 10
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 20 2 Device Manager CLI options .................................................................................... 29 3 Device Manager CLI return values ............................................................................. 31 4 List of commands related to storage system management .............................................. 33 5 Storage systems related to storage system management commands .
PAGE 11
32 AddPLDEVToPRPU command parameters .................................................................... 97 33 AddPool command parameters ............................................................................... 101 34 AddPPortToPRPU command parameters .................................................................... 111 35 AddStorageArray command parameters .................................................................. 115 36 AddTieredPoolOperation command parameters .........................
PAGE 12
69 GetStorageArray (subtarget=LogicalDKC) command parameters ................................. 200 70 GetStorageArray (subtarget=LogicalUnit) command parameters .................................. 202 71 GetStorageArray (subtarget=MFReplicationInfo) command parameters ......................... 208 72 GetStorageArray (subtarget=Path) command parameters ............................................ 212 73 GetStorageArray (subtarget=PDEV) command parameters ..........................................
PAGE 13
106 DeleteWWN command parameters ........................................................................ 327 107 DeleteWWNForHostStorageDomain command parameters ........................................ 329 108 AddHost command parameters ............................................................................... 331 109 AddHostInfo command parameters ......................................................................... 333 110 AddHostRefresh command parameters ......................................
PAGE 14
3 ExternalPathInfo instance attributes .......................................................................... 436 144 ExternalStorage instance attributes .......................................................................... 437 145 FreeLUN instance attribute ...................................................................................... 437 146 FreeSpace instance attributes .................................................................................. 437 147 Host instance attributes .
PAGE 15
180 TieringPolicy instance attributes ............................................................................... 494 181 URLLink instance attributes ...................................................................................... 495 182 VHostStorageDomain instance attributes .................................................................. 496 183 VirtualDisk instance attributes ................................................................................. 497 184 VLDEV instance attributes .
PAGE 16
213 Conditions for specification of parameters for the ModifyVirtualVolume command ......... 513 214 Conditions for specification of parameters for the ModifyVLDEV command ................... 514 215 Corrective actions for Device Manager server error codes and storage system error codes .................................................................................................................. 519 216 Items that can be specified in a host information file (CSV file) ...................................
PAGE 17
Preface This guide describes HP XP7 Command View Advanced Edition 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 peripheral storage systems, SANs, and Java environments.
PAGE 18
Preface
PAGE 19
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 XP7 Command View Advanced Edition 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.
PAGE 20
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.
PAGE 21
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 HP XP7 Command View Advanced Edition products are used via a GUI or CLI.
PAGE 22
Installing the Device Manager CLI To install the Device Manager CLI, download the Device Manager CLI file from the HP XP7 Command View Advanced Edition GUI. To install the Device Manager CLI: 1. Download the Device Manager CLI file from the HP XP7 Command View Advanced Edition GUI. 2. Copy the downloaded file to the computer on which the CLI is to be installed. 3. Decompress the copied file. 4. Configure the execution environment and the properties file.
PAGE 23
Setting up a Java environment The following section also explains the recommended settings for a Java environment. Operations to complete in advance • Check the Java versions that are supported by the Device Manager CLI. • Install the Oracle JRE. To set up a Java environment (recommended settings): • For the HDVM_CLI_JRE_PATH environment variable, specify the path to a different JRE from the one used on the Device Manager server.
PAGE 24
To specify the memory heap size of the Device Manager CLI: 1. Calculate the memory heap size required for the GetStorageArray command to obtain information about all logical units, paths, and LDEVs at the same time. The following is the formula. memory-heap-size (megabytes) = number-of-LDEVs x 0.03 + total-number-of-paths x 0.03 + 140 2. Use method 1 or 2 below to specify the memory heap size.
PAGE 25
About encoding the password in the properties file or in the password file You can improve security by encoding passwords specified in the properties file (hdvmcli.properties) or password file. Specify a password in the properties file or password file, to omit entering the password when using the Device Manager CLI. You can specify a plain text password for the properties file or password file. However, HP recommends that you use the hdvmaccount command to encode the password for better security.
PAGE 26
Format of the hdvmaccount command The hdvmaccount command encodes passwords specified in the properties file and password file. The format of the hdvmaccount command is as follows: hdvmaccount { -u user-ID [ -f absolute-path-name-of-the-password-file] | help } -u Specify the Device Manager user ID that executes the Device Manager CLI. If a user ID has been set for the user property in the properties file, specify the same user ID for the -u option.
PAGE 27
3 Executing commands This chapter describes how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Command syntax This section describes the Device Manager CLI command syntax. • In Windows: In the following example, the Device Manager CLI has been installed in the C:\hdvmcli folder. C:\hdvmcli>hdvmcli.bat [URL] [command] [options] [parameters] • In Solaris, AIX, Linux, or HP-UX: # ./hdvmcli.
PAGE 28
• Port number • When using HTTP: The HTTP port for the Device Manager server (default is 2001) • When using HTTPS: The HTTPS port for the Device Manager server (default is 2443) If a firewall is set up between the computer on which the Device Manager CLI is running and the Device Manager server, set the firewall so the Device Manager server port number can be used.
PAGE 29
For usable parameters, see Chapter 4 on page 61. TIP: You can also set the URL, options, and parameters arguments in the properties file. If arguments are specified both in the properties file and from the command line, the arguments specified from the command line take precedence.
PAGE 30
Option Argument for the option Status Description The format in which the execution results are output You can use this option only when you execute the GetStorageArray (or GetVStorageArray) command. The execution results of the GetStorageArray (or GetVStorageArray) command can be output in the following formats: -f or --format csv or xml Optional • csv: CSV format#4 • xml: XML format Note: Specify csv or xml by using lowercase letters.
PAGE 31
“Parameters that cannot be specified when outputting execution results of the GetStorageArray (GetVStorageArray) command in CSV format” on page 553. #5 If you specify the -i (or --input) option to read requests to the Device Manager server from the XML API request file, if the XML API contains , the execution results are not suppressed.
PAGE 32
Device Manager CLI log files Device Manager CLI logs are output to the hdvmcli.log file in the Device Manager CLI execution directory or folder. In the properties file, you can specify the output destination, file name, and log level. Related topics • Property for specifying the output destination of log files (hdvmcli.logfile), page 530 • Property for specifying the log level (hdvmcli.
PAGE 33
Basic Help includes the current Device Manager CLI version. • Command Help Command Help explains the functions of specific commands and the parameters that can be specified for those commands. You can display command Help from the Device Manager CLI as follows: C:\hdvm> hdvmcli help command-name For example, to display command Help for the GetServerInfo command, specify the following: C:\hdvm> hdvmcli help GetServerInfo • Help for the batch function The Device Manager CLI contains a batch function.
PAGE 34
Command name Description AddLUSE Creates a LUSE. AddPArrayGroupToPRPU Registers, into a specific physical resource group, a parity group that belongs to a physical resource group. AddPHSDToPRPU Registers, into a specific physical resource group, a host storage domain that belongs to a physical resource group. AddPLDEVToPRPU Registers, into a specific physical resource group, an LDEV that belongs to a physical resource group. AddPool Creates a THP/Smart pool.
PAGE 35
Command name Description DeletePPortFromPRPU Deletes a port that belongs to a physical resource group from a specific physical resource group. DeleteStorageArray Deletes a storage system as a management target of the Device Manager server. DeleteVirtualVolume Deletes THP/Smart volumes. DeleteVLDEVFromVRPU Deletes a virtual LDEV from a virtual resource group and deletes the virtual information (virtual emulation, virtual SSID number, virtual LUSE, and virtual CVS) for the virtual LDEV.
PAGE 36
Command name Description ModifyVResourcePartitionUnit Renames a virtual resource group. RefreshPerformanceData Obtains storage system performance information collected by Performance Advisor, and refreshes the Device Manager server database with the most recent information. RefreshResourceLabels Refreshes labels by obtaining the labels set in a storage system and then applying them to the Device Manager server database.
PAGE 37
Command name XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 HP XP7 P9500 AddPLDEVToPRPU Y -- -- -- -- AddPool Y Y Y -- -- AddPPortToPRPU Y -- -- -- -- AddStorageArray Y Y Y Y Y AddTieredPoolOperation Y Y -- -- -- AddVirtualVolume Y Y Y -- -- AddVLDEVToVRPU Y Y -- -- -- AddVResourcePartitionUnit Y -- -- -- -- DeleteArrayReservation Y Y Y Y Y DeleteExternalArrayGroup Y Y Y -- -- DeleteHostStorageDomain Y Y Y Y Y DeleteLabel Y Y
PAGE 38
Command name XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 HP XP7 P9500 FormatLU Y Y Y Y Y GetArrayReservation Y Y Y Y Y GetPoolShrinkStatus Y Y -- -- -- GetStorageArray Y Y Y Y Y GetTieredPoolStatus Y Y -- -- -- GetVStorageArray Y -- -- -- -- GetZeroPageReclaimStatus Y Y Y -- -- ModifyArrayReservation Y Y Y Y Y ModifyExternalTierRank Y Y -- -- -- ModifyLabel Y Y Y Y Y ModifyLogicalUnit Y Y Y Y Y ModifyPool Y Y Y -- -- M
PAGE 39
Command name XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 HP XP7 P9500 RefreshStorageArrays Y Y Y Y Y RunZeroPageReclaim Y Y Y -- -- ShrinkPool Y 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.
PAGE 40
Command name Description DeleteWWN Deletes a WWN from a port. DeleteWWNForHostStorageDomain Releases the security set to a LUN in the specified host storage domain.
PAGE 41
Command name Description AddHostRefresh Refreshes information about the hosts managed by the Device Manager server. AddVirtualizationServer Registers information about a virtualization server into the Device Manager server database by using Host Data Collector. DeleteHost Deletes information about a host from the Device Manager server database. DeleteHostInfo Deletes host-based information about a LUN from the Device Manager server database. GetHost Obtains information about hosts.
PAGE 42
Command name Description DeleteAlerts Deletes information about the alerts managed by the Device Manager server. DeleteURLLink Deletes a URLLink that is set for a Device Manager object managed by the Device Manager server. GetAlerts Obtains information about the alerts managed by the Device Manager server. GetServerInfo Obtains information including the version and URL of the Device Manager server, a list of supported storage system families, and the status of the license.
PAGE 43
Storage systems related to replication commands Table 12 Storage systems related to replication commands Command name XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 HP XP7 P9500 AddConfigFileForReplication Y Y Y Y -- AddReplication Y Y Y Y -- DeleteReplication Y Y Y Y -- GetReplicationControllerPair Y Y Y Y Y ModifyReplication Y Y Y Y Y Legend: Y: Indicates that the particular storage system can be used to execute the command.
PAGE 44
Supported functions Command name AddURLLink Registration, deletion, and information acquisition of URLLinks DeleteURLLink GetURLLink Related topics • Chapter 4, page 61 Commands related to resources used for data migrations that use virtual information For HP XP7 storage systems in which the Online Migration function is used to migrate data, migration-source information is registered in the migration-destination resources as virtual information.
PAGE 45
Supported functions Command name Changing of the settings related to a THP/Smart volume ModifyVirtualVolume Zero-page reclaim operations for THP/Smart volumes RunZeroPageReclaim Definition and deletion of a path to a volume from the host#2, #3 AddLun Assignment and release of a WWN in a host storage domain#3 AddWWNForHostStorageDomain DeleteLun DeleteWWNForHostStorageDomain GetStorageArray (subtarget=HostStorageDomain) GetStorageArray (subtarget=LDEV) Acquisition of virtual information GetStora
PAGE 46
NOTE: • Executing commands that change resource information (commands that perform operations such as Add, Modify, or Delete) requires a role that can update the target resources (resources to be specified by parameter values and resources for which information is to be updated). However, executing commands that change host information only requires a role that can update any one of the resource groups assigned to the user.
PAGE 47
Command name Role Custom role AddPLDEVToPRPU#1 Admin -- • Admin Storage Administrator (Provisioning) AddPool • Modify AddPPortToPRPU#1 Admin -- Admin -- AddStorageArray#1 (When the storage system is not managed by the Device Manager server) • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) AddStorageArray#2 (When the storage system is managed by the Device Manager server) • Admin • Modify • Storage Administrator (Local Copy) • Storage Administrator (R
PAGE 48
Command name Role • Admin DeleteLogicalUnit • Modify • Admin DeleteLUSE DeletePArrayGroup- • Modify Custom role Storage Administrator (Provisioning) -- FromPRPU#1 Admin -- DeletePHSDFromPRPU#1 Admin -- DeletePLDEVFromPRPU#1 Admin -- • Admin Storage Administrator (Provisioning) DeletePool • Modify DeletePPortFromPRPU#1 Admin -- DeleteStorageArray#1 Admin -- • Admin DeleteVirtualVolume • Modify • Admin#3 DeleteVLDEVFromVRPU DeleteVResourcePartitionUnit#1 • Modify#3 Admin • Admi
PAGE 49
Command name Role Custom role • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Storage Administrator (Local Copy) • Storage Administrator (Remote Copy) • Storage Administrator (Initial Configuration) • Admin GetStorageArray • Modify • Storage Administrator (System Resource Management) • View • Security Administrator (View & Modify) • Security Administrator (View Only) • Audit Log Administrator (View & Modify) • Audit Log Administrator (View Only) • Support Per
PAGE 50
Command name Role • Admin ModifyLogicalUnit • Modify • Admin ModifyPool • Modify Custom role Storage Administrator (Provisioning) Storage Administrator (Provisioning) To change port attributes: • Storage Administrator (System Resource Management) • Admin ModifyPort • Storage Administrator (Provisioning) • Modify LUN security change is the only operation that can be performed with this role.
PAGE 51
Command name Role • Admin ShrinkPool • Modify Custom role Storage Administrator (Provisioning) Legend: --: No role can execute this command. #1 All Resources must be assigned as a resource group. #2 To perform operations for SMI-S enabled storage systems, All Resources must be assigned as a resource group. #3 To perform operations for HP XP7, All Resources must be assigned as a resource group, and Admin must be assigned as a role.
PAGE 52
Command name Role • Admin DeleteWWN • Modify DeleteWWNForHostStorageDomain • Admin • Modify Custom role Storage Administrator (Provisioning) Storage Administrator (Provisioning) Legend: --: No role can execute this command.
PAGE 53
Command name Role Custom role • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Admin DeleteHost • Modify • Storage Administrator (Local Copy) • Storage Administrator (Remote Copy) • Storage Administrator (Initial Configuration) • Storage Administrator (System Resource Management) • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Admin DeleteHostInfo • Modify • Storage Administrator (Local Copy) • Storage Administrator (
PAGE 54
Command name Role Custom role • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Admin ImportHosts • Modify • Storage Administrator (Local Copy) • Storage Administrator (Remote Copy) • Storage Administrator (Initial Configuration) • Storage Administrator (System Resource Management) MergeHost# • Admin • Modify -• Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Admin ModifyHost • Modify • Storage Administrator (Local Co
PAGE 55
All Resources must be assigned as a resource group.
PAGE 56
Command name Role Custom role • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Storage Administrator (Local Copy) • Storage Administrator (Remote Copy) • Storage Administrator (Initial Configuration) • Admin GetURLLink • Modify • Storage Administrator (System Resource Management) • View • Security Administrator (View & Modify) • Security Administrator (View Only) • Audit Log Administrator (View & Modify) • Audit Log Administrator (View Only) • Support Personne
PAGE 57
Command name Role Custom role • Storage Administrator (Provisioning) • Storage Administrator (Performance Management) • Storage Administrator (Local Copy) • Storage Administrator (Remote Copy) • Storage Administrator (Initial Configuration) • Admin GetReplicationControllerPair • Modify • Storage Administrator (System Resource Management) • View • Security Administrator (View & Modify) • Security Administrator (View Only) • Audit Log Administrator (View & Modify) • Audit Log Administrator (View Only)
PAGE 58
Item Description When setting up security for a LUN or host storage domain, make sure that I/O operations from the host to the LU of the corresponding port have stopped. Setting up security for a LUN or host storage domain If you set up security for a LUN or host storage domain, the LUN security for the corresponding port takes effect automatically.
PAGE 59
Item Description If the attribute value -1 is output, possible causes are as follows: • The attribute is invalid. Notes on when the attribute value -1 is output • No value can be acquired. • No value has been set.
PAGE 60
Executing commands
PAGE 61
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.
PAGE 62
• AddVResourcePartitionUnit • AddWWNForHostStorageDomain • DeleteArrayReservation • DeleteExternalArrayGroup • DeleteHostStorageDomain • DeleteLogicalUnit • DeleteLun • DeleteLUSE • DeletePArrayGroupFromPRPU • DeletePHSDFromPRPU • DeletePLDEVFromPRPU • DeletePool • DeletePPortFromPRPU • DeleteVirtualVolume • DeleteVLDEVFromVRPU • DeleteVResourcePartitionUnit • DeleteWWN • DeleteWWNForHostStorageDomain • FormatLU • ModifyArrayReservation • ModifyLogicalUnit • ModifyPool • ModifyPort • ModifyPortController •
PAGE 63
Command execution example hdvmcli AddArrayReservation -o "D:\logs\AddArrayReservation.log" "model=XP12000" "serialnum=14009" Command execution result An instance of ArrayReservation objectID=***** target=***** serialNumber=14009 arrayType=XP12000 loginID=dmuser beginTime=1,039,003,476 *****: The values are encoded by the CLI.
PAGE 64
Parameter name Status Description Port name of the port to which the external storage system is connected If you specify multiple (alternate) paths, use a comma to separate each entry. portname 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.
PAGE 65
Parameter name Status Description Option information (cache mode) of the logical unit Either of the following values can be specified: • true: Valid • false: Invalid cachemode Optional If the cachemode parameter is omitted, the following values are set: • When the inflowcontrol parameter is specified, true is set. • When the inflowcontrol parameter is omitted If the external volume is a command device, false is set. If the external volume is not a command device, true is set.
PAGE 66
Parameter name Status Description Unit for the value to be 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. This parameter cannot be specified if none is specified in the luoption parameter or if the luoption parameter is omitted. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
PAGE 67
Command execution example Figure 2 Example of executing the AddExternalArrayGroup command The following shows an example of executing the AddExternalArrayGroup command to set up the configuration shown in Figure 2: hdvmcli AddExternalArrayGroup -o "D:\logs\AddExternalArrayGroup.log" model=XP20000 serialnum=25011 portname=CL3-F,CL7-F externalwwn=50.06.0E.80.10.22.8B.50,50.06.0E.80.10.22.8B.52 externallun=1,0 externalgrpnum=27 Command execution result RESPONSE: An instance of StorageArray . .
PAGE 68
clprNumber=0 cuInfo= openTotalCapacity=0 openAllocatedCapacity=0 openFreeCapacity=0 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=0 openUnallocatedCapacity=0 openUnallocatedActualCapacity=0 openReservedCapacity=0 openReservedActualCapacity=0 type=1 volumeType=1 encrypted=-1 protect
PAGE 69
NOTE: When AddHostStorageDomain adds a host storage domain, LUN security for the target port is automatically enabled. Make sure that the I/Os of the target port are stopped.
PAGE 70
Parameter name Status Description Name of the host storage domain Optional name Specify any name. The value specified for this parameter is used only by Device Manager to identify the host storage domain. 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. 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.
PAGE 71
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.
PAGE 72
For details, see the documentation for the LUN management product for the storage system you are using. Table 26 Values that can be specified in the hostmodeoption parameter Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 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).
PAGE 73
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 No display for ghost LUN Specify this value when both of the following conditions are satisfied: 12 • The host mode is set to HP (mode 03). Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y -- -- -- Y • You want to prevent devices to which no paths have been defined from creating a device file when the HP-UX host is connected.
PAGE 74
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 Veritas Cluster Server Specify this value when both of the following conditions are satisfied: 22 • The host mode is set to AIX (mode 0F). Y Y Y Y Y Y Y Y -- -- -- Y -- -- -- Y • VERITAS Cluster Server is in use. REC command support 23 Specify this value when you want to run the REC (READ Exchange Concise) command.
PAGE 75
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 Set/Report Device Identifier enable Specify this value when both of the following conditions are satisfied: 33 • The host mode is set to HP (mode 03), OpenVMS (mode 05), or Tru64 (mode 07). Y Y Y -- Y Y Y -- Y Y Y -- Y Y Y -- -- Y Y -- Y Y Y -- • You want to enable the commands that set a nickname for a device.
PAGE 76
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 ESAM Svol Read Option Specify this value when both of the following conditions are satisfied: • External Storage Access Manager is used. 48 • You do not want a failover to occur from the MCU to the RCU when an application is executed, for which the number of Read commands to be issued to the secondary volume is equal to or more than the threshold value.
PAGE 77
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 ESAM Response Change 57 Specify this value when the host mode is set to Windows (mode 0C), Windows Extension (mode 2C), VMware (mode 01), or VMwares Extension (mode 21) in a configuration that uses External Storage Access Manager. Y Y Y -- Y Y Y -- -- Y -- -- Y Y -- -- -- Y -- -- Y Y -- -- LUN0 Change Guard 60 Specify this value when you use HP-UX 11.
PAGE 78
Values Description HP XP7 P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 Support Page Reclamation for Linux Specify this value when the Page Reclamation functionality is used from an environment connected to a Linux host. 68 Y Y -- -- -- Y -- -- Y Y -- -- Y Y -- -- Y Y -- -- Online LUSE expansion Specify this value when the expansion of the capacity of a LUSE volume is notified for a host.
PAGE 79
Obtain these values from the execution result of the GetStorageArray (subtarget=Port, portsubinfo=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, Port for the subtarget parameter, and HostStorageDomain for the portsubinfo parameters. In the execution result of this command, the portID value appears in a Port. Use this portID value to specify the port parameter.
PAGE 80
NOTE: For HP XP7, the label is applied to the storage system. For P9500, you can select whether to apply the label to the storage system. For other storage systems, the label is not applied to the storage system.
PAGE 81
Parameter name Status Description Specify whether to apply the LDEV label information to the storage system. Optional reflectoption (P9500) One of the following values can be specified. The values are not case-sensitive. • true: Apply the label information to the storage system • false: Do not apply the label information to the storage system If this parameter is omitted, it is assumed that false is specified.
PAGE 82
The LDEVs created by this command are formatted when they are created. However, if you are using HP XP7, P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, you can use the format parameter to specify whether to format the LDEVs and also the format type.
PAGE 83
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=dividebycap capacity=capacity-of-the-logical-unit [emulation=OPEN-V] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick}] [capacitytype={KB|block}] When creating multiple logical units in bulk by specifying their number: hdvmcli [URL] AddLogicalUnit [o
PAGE 84
Parameter name Status Description Display name for the parity group where the LU is added When this parameter is specified, do not specify chassis or groupnum. arraygroupname Optional Always specify either the chassis and groupnum parameters together, or the arraygroupname parameter by itself. Do not specify arraygroupname together with chassis and groupnum. Doing so results in an error.
PAGE 85
Parameter name Status Description Capacity of the LUs to be created This parameter must be specified if the creationoption parameter is not specified, or if bulk or dividebycap is specified for the creationoption parameter. capacity Optional This parameter cannot be specified if dividebynum is specified for the creationoption parameter. The specified value is adjusted depending on the minimum number of units set for the volume size of each storage system.
PAGE 86
Parameter name Status Description LU device number For HP XP7, P9500 and XP24000/XP20000: devnum 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.
PAGE 87
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. chassis and groupnum Obtain these values from the execution result of the GetStorageArray (subtarget=ArrayGroup) command. Execute this command by specifying only the model and serialnum parameters, and ArrayGroup for the subtarget parameter.
PAGE 88
chassis=4 arrayGroup=32 arrayGroupName=4-3-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=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV
PAGE 89
Parameters Table 29 AddLUSE command parameters Parameter name Status Description serialnum Required Serial number of the storage system from which LUSE is added model Required Model of the storage system from which the LUSE is added Comma-separated list of LDEV device numbers to create the LUSE For P9500 and XP24000/XP20000: devnums Required Specify this parameter as a decimal number or colondelimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and
PAGE 90
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 91
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 mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LDEV objectID=
PAGE 92
mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. AddPArrayGroupToPRPU The AddPArrayGroupToPRPU command registers a parity group that belongs to a physical resource group to a specific physical resource group. The parity group is registered from a physical resource group (meta_resource) whose resource group ID is 0.
PAGE 93
Parameter name Status Description Number of the chassis containing the parity group that belongs to the physical resource group chassis Optional This parameter must be specified together with the groupnum parameter. You must specify chassis and groupnum together, or specify arraygroupname. Do not specify the combination of chassis and groupnum together with arraygroupname. If they are specified at the same time, an error occurs.
PAGE 94
Command execution example In this example, the AddPArrayGroupToPRPU command registers a parity group (chassis number: 1, parity group number: 96) that belongs to a physical resource group in a storage system (model: XP7, serial number: 10139) to the specified physical resource group (resource group ID: 43). hdvmcli AddPArrayGroupToPRPU -o "D:\logs\AddPArrayGroupToPRPU.log" "model=XP7" "serialnum=10139" "chassis=1" "groupnum=96" "rpuid=43" Command execution result RESPONSE: An instance of StorageArray . .
PAGE 95
Format hdvmcli [URL] AddPHSDToPRPU [options] model=model serialnum=serial-number rpuid=physical-resource-group-ID {port=port-number|portname=port-name} domain=domain-ID Parameters Table 31 AddPHSDToPRPU command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system rpuid Required Specify the resource group ID of the physical resource group at the registration destination.
PAGE 96
num parameters, and then HostStorageDomain for the subtarget parameters. In the execution results of this command, the domainID and portID values appear under An instance of HostStorageDomain. Use these domainID and portID values to specify the domain and port parameters. 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.
PAGE 97
NOTE: • You can use this command only when you are using HP XP7. • If an LDEV has not been created (the volume does not exist), you can use this command to reserve an LDEV for a specific physical resource group. • Only the physical resource groups that belong to the default virtual storage machine can be registered. To register an LDEV to a physical resource group that does not belong to the default virtual storage machine, you need to virtualize the LDEV.
PAGE 98
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. rpuid Obtain this value from the execution results of the GetStorageArray (subtarget=PResourcePartitionUnit) command. Execute this command by specifying only the model and serialnum parameters, and PResourcePartitionUnit for the subtarget parameter.
PAGE 99
AddPool AddPool creates a THP/Smart pool in a targeted storage system. NOTE: • This command can be used only with HP XP7, P9500, and XP24000/XP20000. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.3 or later.
PAGE 100
• If both internal and external volumes are used for a THP/Smart pool, the cache mode for the external volumes must be ON. However, if a THP/Smart pool was created when the microcode version was earlier than 70-0200-XX/XX, the THP/Smart pool cannot contain both internal and external volumes, even if the microprogram is upgraded to 70-02-00-XX/XX or later.
PAGE 101
[monitoringmode={0|1}] [bufspacesfornewpageassignment=buffer-space-for-new-page-assignment] [bufspacesfortierrelocation=buffer-space-for-hardware-tier-relocation] [name=label-of-THP/Smart-pool]#1 [reflectoption={true|false}]#2 [relocationspeed={1|2|3|4|5}]#3 #1 This must be specified for HP XP7. #2 This can be specified only for P9500. #3 This can be specified only for HP XP7.
PAGE 102
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 HP XP7 or P9500 (with a microcode version of 70-014X-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.
PAGE 103
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 HP XP7 and 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.
PAGE 104
Parameter name Status Description Specify whether to create a Smart pool. tiercontrol Optional One of the following values can be specified. (HP XP7 • enable: Creates a Smart pool. P9500) • disable: Creates a THP pool. If this parameter is omitted, enable is set. Specify whether to automatically execute performance monitoring and hardware tier relocation. automigration Optional If you specify this parameter, you must also specify tiercontrol=enable.
PAGE 105
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 If P9500 (with a microcode version is earlier than 7002-XX-XX/XX): (HP XP7 0: Periodic P9500) If this parameter is omitted, 0 is set. If HP XP7 or P9500 (with a microcode version is 7002-XX-XX/XX or later): 0: Periodic 1: Continuous If this parameter is omitted, 1 is set.
PAGE 106
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.
PAGE 107
Parameter name Status Description Specify whether to apply the label information about the THP/Smart pool to the storage system. Optional reflectoption (P9500) One of the following values can be specified. The values are not case-sensitive. • true: Apply the label information to the storage system • false: Do not apply the label information to the storage system If this parameter is omitted, it is assumed that false is specified. Specify the speed for hardware tier relocation.
PAGE 108
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 1 In this example, the AddPool command creates a Smart pool whose pool ID is 5 (poolid: 5) in the storage system (serial number: 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.
PAGE 109
lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 relocationSpeed=-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 command
PAGE 110
rpm=15,000 diskType=4 substance=0 bufSpaceForNewPageAssignment=8 bufSpaceForTierRelocation=2 *****: The values are encoded by the CLI. Command execution example 2 In this example, the AddPool command creates a THP pool whose pool ID is 5 (poolid: 5) and whose label is MyPool (name: MyPool) in the storage system (serial number: 53039, model: P9500). In addition, the label information about the THP pool is applied to the storage system. hdvmcli AddPool -o "D:\logs\AddPool.
PAGE 111
migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=enable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 relocationSpeed=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfDpVols=-1 capacityOfDpVolsInKB=-1 List of 1 Lu elements: An instance of LogicalUnit . .
PAGE 112
Parameter name Status Description model Required Model of the storage system rpuid Required Specify the resource group ID of the physical resource group at the registration destination. Number of the port that belongs to the physical resource group 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.
PAGE 113
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 PResourcePartitionUnit elements: An instance of PResourcePartitionUnit objectID=***** name=RG43 resourcePartitionUnitID=43 numberOfPArrayGroups=1 numberOfPPorts=1 numberOfPHostStorageDomains=5 numberOfPLDEVs=0 List of 1 PPort elements: An instance of PPort objectID=***** portID=1 *****: The values are encoded by the CLI.
PAGE 114
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.
PAGE 115
Parameters Table 35 AddStorageArray command parameters Parameter name Status Description IP address For HP XP7, 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 HP XP7, P9500 and XP24000/XP20000, this parameter can be specified by using an IPv6 IP address.
PAGE 116
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.
PAGE 117
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP1024@172.16.45.1 description=XP1024 (10001) at 172.16.45.
PAGE 118
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
PAGE 119
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 166. 4. Start hardware tier relocation. Execute the AddTieredPoolOperation command with startRelocation specified for the operation parameter.
PAGE 120
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.
PAGE 121
monitoringState=1 lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationProgress=-1 relocationSpeed=-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.
PAGE 122
• 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.
PAGE 123
When the command is used to create as many virtual parity groups as the THP volumes to be created, and to populate each group with a THP volume: hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-THP-volumes [numoflus=number-of-THP-volumes] [devnum=device-number-of-logical-unit] [clprNumber=CLPR-number] [poolid=pool-ID-of-THP-pool [threshold=usage-rate-threshold-of-THP-volumes]] [capacitytype={KB|block}] When the command is used to create THP volumes in an exi
PAGE 124
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).
PAGE 125
Parameter name Status Description Pool ID of a THP/Smart pool poolid Optional Specify the pool ID of the THP/Smart pool to which to assign the THP/Smart volumes to be created. For HP XP7 and P9500, always specify this poolid parameter. Usage rate threshold for the THP volumes (%) threshold Optional Specify a multiple of 5 from 5 to 300. (XP24000 If omitted, 5 is set. XP20000) If the poolid parameter is omitted, the specification for this parameter becomes invalid.
PAGE 126
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 127
objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalV
PAGE 128
cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LogicalUnit objectID=***** devNum=12,289 displayName=00:30:01 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=fa
PAGE 129
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 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 system
PAGE 130
NOTE: • This command can be used only with HP XP7 and P9500 (with a microcode version of 70-0504-XX/XX or later). • If the virtual LDEV is a pool volume, all pool volumes that belong to the pool ID must belong to the same virtual resource group. If the virtual LDEV to be specified is a pool volume, specify all the pool volumes that have the same pool ID.
PAGE 131
Parameters Table 38 AddVLDEVToVRPU command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Resource group ID of the virtual resource group vrpuid Required Specify the resource group ID of the virtual resource group to which a virtual LDEV is to be added or that contains a virtual LDEV whose virtual information is to be updated.
PAGE 132
Parameter name Status Description Virtual SSID of the virtual LDEV Specify an integer in the range from 4 to 65533 for the virtual SSID of the virtual LDEV. vssid Optional If this parameter is omitted, an SSID is automatically assigned in the virtual resource group. This parameter is ignored if withoutvid or withoutvattr is specified for the vldevoperation parameter.
PAGE 133
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. In the execution results of this command, the required resourcePartitionUnitID value appears under An instance of VResourcePartitionUnit. Use this value to specify the vrpuid parameter.
PAGE 134
vLUSE=0 vCVS=0 operationMode=0 hasSubstance=1 *****: The values are encoded by the CLI. Command execution example 2 In this example, the AddVLDEVToVRPU command adds a virtual LDEV that has neither virtual device number nor virtual information to a virtual resource group (resource group ID: 62) in a storage system (model: XP7, serial number: 10139). hdvmcli AddVLDEVToVRPU -o "D:\logs\AddVLDEVToVRPU.
PAGE 135
AddVResourcePartitionUnit The AddVResourcePartitionUnit command creates a virtual resource group. When a virtual resource group is created, the corresponding physical resource group is also created. NOTE: • You can use this command only when you are using HP XP7. • If there is no virtual storage machine to which the created virtual resource group belongs, a virtual storage machine is also created.
PAGE 136
Parameter name Status Description Serial number of the virtual storage machine vserialnum Optional This parameter must be specified together with the vfamily parameter. If you omit this parameter, a virtual resource group is created on the default virtual storage machine. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
PAGE 137
serialNumber=10139 vArrayFamily=XP7 vSerialNumber=10051 virtualStorageMode=enable onDataMigration=false vDisplayArrayFamily=XP7 numberOfVPorts=0 numberOfVHostStorageDomains=0 numberOfVLDEVs=0 *****: The values are encoded by the CLI. DeleteArrayReservation DeleteArrayReservation unlocks the target storage system.
PAGE 138
NOTE: • This command can be used only with HP XP7, P9500, and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-06-00-XX/XX or later. • Before you can execute this command, both the storage system in which to create an external parity group and the externally connected storage system must be registered as Device Manager management targets.
PAGE 139
DeleteHostStorageDomain DeleteHostStorageDomain deletes a host storage domain. This command deletes host groups from the storage system. Parameters Table 42 DeleteHostStorageDomain 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. The port ID of the host storage domain to delete port Optional Specify either port or portname.
PAGE 140
num parameters, and HostStorageDomain for the subtarget parameter. In the execution result of this command, the domainID and portID values appear under An instance of HostStorageDomain. Use these domainID and portID values to specify the 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.
PAGE 141
Parameter name Status Description Device number of the logical unit For HP XP7, 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.
PAGE 142
Command execution result RESPONSE: (Command completed; empty list returned) DeleteLogicalUnit DeleteLogicalUnit deletes the LU and corresponding LDEV from the storage device. With HP XP7, P9500, XP24000/XP20000, and XP12000/XP10000/SVS200, you can delete multiple logical units at once. NOTE: • For HP XP7, P9500, or XP24000/XP20000, logical units cannot be deleted for parity groups with chassis numbers from 65 to 96, or from 16485 to 16516.
PAGE 143
Parameter name Status Description Device number of the LU For HP XP7, P9500, and XP24000/XP20000: Optional (HP XP7 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.
PAGE 144
NOTE: This command is not available for HP XP7.
PAGE 145
Command execution result RESPONSE: (Command completed; empty list returned) DeletePArrayGroupFromPRPU The DeletePArrayGroupFromPRPU command deletes a parity group that belongs to a physical resource group from a specific physical resource group, and then moves the parity group to a physical resource group (meta_resource) whose resource group ID is 0. NOTE: • You can use this command only when you are using HP XP7.
PAGE 146
Parameter name Status Description Number of the parity group that belongs to the physical resource group groupnum Optional This parameter must be specified together with the chassis parameter. You must specify chassis and groupnum together, or specify arraygroupname. Do not specify the combination of chassis and groupnum together with arraygroupname. If they are specified at the same time, an error occurs.
PAGE 147
Command execution result RESPONSE: (Command completed; empty list returned) DeletePHSDFromPRPU The DeletePHSDFromPRPU command deletes a host storage domain that belongs to a physical resource group from a specific physical resource group, and then moves the host storage domain to a physical resource group (meta_resource) whose resource group ID is 0. NOTE: • You can use this command only when you are using HP XP7.
PAGE 148
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. port and domain Obtain these values from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command.
PAGE 149
NOTE: • You can use this command only when you are using HP XP7. • Only the LDEVs in the physical resource groups that belong to the default virtual storage machine can be deleted. To delete an LDEV from a physical resource group that does not belong to the default virtual storage machine, use “DeleteVLDEVFromVRPU” on page 157 to delete the LDEV because the LDEV is virtualized.
PAGE 150
Obtain this value from the execution results of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter. In the execution results, the devNum value, which is required for the devnum parameter, is output after An instance of LDEV. Specify this devNum value for the devnum parameter.
PAGE 151
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. 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.
PAGE 152
Parameter name Status Description model Required Model of the storage system Number of the port that belongs to the physical resource group 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. Name of the port that belongs to the physical resource group portname Optional Specify either port or portname. Do not specify both parameters at the same time.
PAGE 153
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. NOTE: If execution of the DeleteStorageArray command results in an error, take appropriate action according to the error message, and then re-execute the DeleteStorageArray command.
PAGE 154
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. saobjid Obtain this value from the execution result of the GetStorageArray command. Set the value of objectID, obtained from the execution result, into the saobjid parameter.
PAGE 155
Format for HP XP7 and P9500 When the command is used to specify a virtual parity group, and delete both the virtual parity group and the THP/Smart volumes in that virtual parity group: hdvmcli [URL] DeleteVirtualVolume [options] model=model serialnum=serial-number arraygroupnames=name-of-virtual-parity-group When the command is used to delete specified THP/Smart volumes only: hdvmcli [URL] DeleteVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-THP/Smart-volume Format fo
PAGE 156
Parameter name Status Description Device number(s) of the THP/Smart volume(s). devnums# Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values. # Always specify either the arraygroupnames parameter or the devnums parameter. Do not specify both parameters at the same time.
PAGE 157
DeleteVLDEVFromVRPU The DeleteVLDEVFromVRPU command deletes a virtual LDEV from a virtual resource group, and then deletes the virtual information for the virtual LDEV. NOTE: • This command can be used only with HP XP7 and P9500 (with a microcode version of 70-0504-XX/XX or later). • If a virtual LDEV is a pool volume, all the pool volumes that belong to the pool ID must belong to the same virtual resource group.
PAGE 158
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. vrpuid Obtain this value from the execution results of the GetStorageArray (subtarget=VResourcePartitionUnit) command.
PAGE 159
Format hdvmcli [URL] DeleteVResourcePartitionUnit [options] model=model serialnum=serial-number vrpuid=virtual-resource-group-ID [deletionoption=force] Parameters Table 54 DeleteVResourcePartitionUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system vrpuid Required Specify the resource group ID of the virtual resource group to be deleted.
PAGE 160
FormatLU FormatLU formats an LU. To check whether the LDEV was formatted properly if you omitted the wait parameter, or if you specified false in the wait parameter, first use the AddStorageArray command to refresh the storage system, and then execute the GetStorageArray (subtarget=LDEV) command and check the value of status in the execution results. If you specified true in the wait parameter, simply check the value of status in the execution results of the FormatLU command.
PAGE 161
Parameter name Status Description List of the device numbers of the LUs to be formatted For HP XP7, P9500, and XP24000/XP20000: Specify this parameter as a decimal number or colondelimited 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.
PAGE 162
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. devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit, lusubinfo=LDEV) command.
PAGE 163
differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=100,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=1,175 displayName=00:04:97 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=100,000 lba=200,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=256 chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=false onDemandDevice=false devType= isSt
PAGE 164
path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=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=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=100,000 thpPoolID=-1 threshold=-1 tc
PAGE 165
mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. GetArrayReservation GetArrayReservation obtains information about a locked storage system. This command does not have parameters. Command execution example hdvmcli GetArrayReservation -o "D:\logs\GetArrayReservation.
PAGE 166
NOTE: • This command can be used only with HP XP7 and P9500. • While the THP/Smart-pool shrinking operation is being executed, if another operation is performed on the pool and the pool changes to a status in which the pool cannot shrink, the THP/Smart-pool shrinking operation fails. As a result, the THP/Smart pool volumes to be excluded might partially remain as they are, without being excluded. In this case, do not execute the FormatLU command for these volumes.
PAGE 167
objectID=***** name=MyPool poolFunction=5 poolID=1 encrypted=-1 controllerID=-1 poolType=32 status=0 threshold=70 threshold2=80 threshold2Mode=0 capacityInKB=309,227,520 freeCapacityInKB=309,227,520 usageRate=0 numberOfPoolVols=30 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=135 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 mo
PAGE 168
commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementArea
PAGE 169
thpPoolVolControlFlag=1 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The values are encoded by the CLI. Command execution result 2 This execution result indicates that the operation for shrinking the THP/Smart pool has finished because no 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) .
PAGE 170
relocationProgress=-1 relocationSpeed=-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=OPEN-V devCount=1 devType= capacityInKB=10,486,080 numberOfLBAs=20,972,160 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false
PAGE 171
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.
PAGE 172
Value of subtarget Information that can be acquired Location ExternalStorage Information about the external connection of storage systems GetStorageArray (subtarget=ExternalStorage) , page 187 Filter Information about the storage system for a specific element GetStorageArray (subtarget=Filter) , page 188 FreeSpace Information about the unused capacity in parity groups GetStorageArray (subtarget=FreeSpace) , page 190 HostStorageDomain Information about host storage domains GetStorageArray (subt
PAGE 173
Value of subtarget Information that can be acquired Location VResourcePartitionUnit Information about virtual resource groups GetStorageArray (subtarget=VResourcePartitionUnit), page 242 Table 58 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: • ExternalPathInfo: External path
PAGE 174
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.
PAGE 175
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information SnapshotGroup snapshotgrpsubinfo ReplicationInfo: Information about Fast Snap copy pairs that belong to a snapshot group The following information about virtual resource groups can be acquired: VResourcePartitionUnit vrpusubinfo • VHostStorageDomain: Information about the virtual host storage domains • VLDEV: Information about the virtual LDEVs • VPort: Informatio
PAGE 176
hdvmcli [URL] GetStorageArray [options] When obtaining information about a storage system (other than an SMI-S enabled storage system): hdvmcli [URL] GetStorageArray [options] serialnum=serial-number model=model When obtaining information about an SMI-S enabled storage system: hdvmcli [URL] GetStorageArray [options] saobjid=object-ID-of-SMI-S-enabled-storage-system Parameters Table 60 GetStorageArray (subtarget not specified) command parameters Parameter name Status Description serialnum Optional# m
PAGE 177
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600@10.208.115.220 description=R600 (10007) at 10.208.115.
PAGE 178
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is e
PAGE 179
Parameter name Status Description Information about a logical unit lusubinfo Optional The values you can specify are Path and LDEV. If you specify multiple values at the same time, separate the values by commas. If you specify this parameter, you must also specify arraygroupsubinfo=LogicalUnit. Starting sequence number of parity groups for which information is to be obtained Specify this parameter when you want to obtain information for a part of parity groups in a specific storage system.
PAGE 180
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example 1 In this example, the GetStorageArray (subtarget=ArrayGroup) command obtains information about parity groups in a storage system (serial number: 14010, model: XP12000).
PAGE 181
mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=266,772,960 openUnallocatedCapacity=149,008,320 openUnallocatedActualCapacity=149,008,320 openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 resourcePartitionUnitID=-1 . . (repeated for other ArrayGroup instances) . *****: The value is encoded by the CLI.
PAGE 182
onDemandCapacity=0 totalFreeSpace=3,223,296 largestFreeSpace=1,545,984 substance=0 slprNumber=-1 clprNumber=-1 openTotalCapacity=209,638,800 openAllocatedCapacity=192,256,560 openFreeCapacity=17,382,240 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=192,256,560 openUnallocatedCapaci
PAGE 183
hdvmcli [URL] GetStorageArray [options] subtarget=CommParameters saobjid=object-ID-of-SMI-S-enabled-storage-system Parameters Table 62 GetStorageArray (subtarget=CommParameters) command parameters Parameter name Status Description subtarget Required Specify CommParameters. 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.
PAGE 184
An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters userID=root ipAddress=172.16.45.1 GetStorageArray (subtarget=Component) GetStorageArray (subtarget=Component) obtains information about the configuration of storage systems. Parameters Table 63 GetStorageArray (subtarget=Component) command parameters Parameter name Status Description subtarget Required Specify Component.
PAGE 185
name=R600@10.208.115.220 description=R600 (10007) at 10.208.115.
PAGE 186
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 List of 12 Component elements: An instance of Component name=DKC Battery value=4 description=Moderate An instance of Component name=DKC Cache value=1 description=Norma
PAGE 187
value=1 description=Normal *****: The value is encoded by the CLI. GetStorageArray (subtarget=ExternalStorage) GetStorageArray (subtarget=ExternalStorage) acquires information about the external connection of storage systems. Parameters Table 64 GetStorageArray (subtarget=ExternalStorage) command parameters Parameter name Status Description subtarget Required Specify ExternalStorage.
PAGE 188
GetStorageArray (subtarget=Filter) GetStorageArray (subtarget=Filter) obtains information about the storage system for a specific component. Parameters Table 65 GetStorageArray (subtarget=Filter) command parameters Parameter name Status Description subtarget Required Specify Filter.
PAGE 189
numberOfSpareDrives=-1 freeCapacityInGB=2,329 allocatedCapacityInGB=1,505 autoLunCapacityInGB=4 onDemandCapacityInGB=0 totalFreeSpaceInGB=19 largestFreeSpaceInGB=3 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 numberOfAl
PAGE 190
GetStorageArray (subtarget=FreeSpace) GetStorageArray (subtarget=FreeSpace) obtains the information about the unused capacity in parity groups. Parameters Table 66 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.
PAGE 191
Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command. Execute this command by specifying only the model and serialnum parameters, and ArrayGroup for subtarget=ArrayGroup. In the execution result of this command, the objectID value appears under An instance of ArrayGroup. Use this objectID value to specify the arraygroupobjid parameter.
PAGE 192
mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=266,772,960 openUnallocatedCapacity=149,008,320 openUnallocatedActualCapacity=149,008,320 openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 resourcePartitionUnitID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=***** sizeInKB=1,847,952 cylinders=0 fsControlIndex=85 . .
PAGE 193
diskSizeInKB=75,497,472 formFactor=-1 controllerID=1 totalCapacity=211,531,680 allocatedCapacity=134,588,160 freeCapacity=76,943,520 autoLunCapacity=0 onDemandCapacity=0 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
PAGE 194
Parameters Table 67 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter name Status Description subtarget Required Specify HostStorageDomain. 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.
PAGE 195
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.
PAGE 196
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. 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.
PAGE 197
objectID=***** devNum=10 displayDevNum=00:0A portID=23 portName=CL2-H domainID=1 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 68 GetStorageArray (subtarget=LDEV) command parameters Parameter name Status Description subtarget Required Specify LDEV.
PAGE 198
Parameter name Status Description Information about the LDEV ldevsubinfo Optional The values you can specify are VolumeConnection and VLDEV. If you specify multiple values at the same time, separate the values by commas. You can specify VLDEV only for HP XP7 or P9500 (with a microcode version of 70-03-30-XX/XX or later). Filter used for selecting the LDEV ldevfilter Optional Available values are OPEN, INTERMEDIATE, and MAINFRAME, which are not case-sensitive.
PAGE 199
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=LDEV) command.
PAGE 200
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 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=10001 mappedDevNum=0 displayMappedDevNum=00:0
PAGE 201
Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example In this example, the GetStorageArray (subtarget=LogicalDKC) command obtains information about the logical DKC in a storage system (serial number: 12345, model: XP24000).
PAGE 202
slprStatus=0 openTotalCapacity=7,934,066,016 openAllocatedCapacity=851,452,736 openFreeCapacity=7,073,394,400 openAutoLunCapacity=9,218,880 openOnDemandCapacity=0 imTotalCapacity=399,016,800 imAllocatedCapacity=0 imFreeCapacity=399,016,800 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=949,912,110 mfAutoLunCapacity=23,239,440 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=589 numberOfOpenUnallocatedLUs=3,799 numberOfImAllocatedLUs=0 numberOfImUnallocate
PAGE 203
Parameter name Status serialnum Optional model Optional Description 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. 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.
PAGE 204
Parameter name Status Description Information about the LDEV ldevsubinfo Optional You can specify VolumeConnection or VLDEV. To specify multiple values at the same time, separate each value with a comma. You can specify VLDEV only for HP XP7 or P9500 (with a microcode version of 70-03-30-XX/XX or later). If you specify this parameter, you must also specify the lusubinfo=LDEV. Filter for selecting a THP/Smart volume Specify either the pool ID of a THP/Smart pool, or Unassigned.
PAGE 205
Parameter name Status Description Device number of the logical unit Specify this parameter to acquire information about a particular logical unit. For HP XP7, P9500, and XP24000/XP20000: displayname 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.
PAGE 206
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 207
WWN=88.77.77.77.77.77.3F.04 nickname=Jone . . (repeated for other Path instances) .
PAGE 208
List of 1 ObjectLabel elements: An instance of ObjectLabel targetID=***** label=myLabel . . (repeated for other VolumeConnection instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=MFReplicationInfo) GetStorageArray (subtarget=MFReplicationInfo) obtains information about copy pairs consisting of mainframe volumes.
PAGE 209
Parameter name Status Description Starting sequence number of the copy pair information of mainframe volumes for which information is to be obtained Specify this parameter to obtain information about copy pairs of some mainframe volumes from a specific storage system. startElementNumFilter Optional When mainframe-volume copy pair information is in the order shown below and starts from 0, specify the first number in the sequence of the mainframe-volume copy pair information that you want to obtain.
PAGE 210
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 211
mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 An instance of LDEV objectID=***** devNum=3,333 displayName=00:0D:05 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 cacheResidencyMode=
PAGE 212
Parameters Table 72 GetStorageArray (subtarget=Path) command parameters Parameter name Status Description subtarget Required Specify Path. 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.
PAGE 213
Parameter name Status Description Port name of the storage system portname 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 domainnickname or domain parameter, and the devnum parameter. Do not specify this parameter together with the port parameter. If they are specified at the same time, an error occurs.
PAGE 214
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. objectid Obtain this value from the execution result of the GetStorageArray (subtarget=Path) command.
PAGE 215
List of 256 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.00.02 nickname=Jone . . (repeated for other WWN instances) . *****: The values are encoded by the CLI. Command execution example 2 (when the objectid parameter is specified) In this example, the GetStorageArray (subtarget=Path) command obtains information about a path (object ID: *****) that is set for a storage system (serial number: 10001, model: XP1024).
PAGE 216
GetStorageArray (subtarget=PDEV) GetStorageArray (subtarget=PDEV) obtains the information about PDEVs. Parameters Table 73 GetStorageArray (subtarget=PDEV) command parameters Parameter name Status Description subtarget Required Specify PDEV. 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.
PAGE 217
and PDEV for the subtarget parameter. In the execution result of this command, use the pdevid value that appears under An instance of PDEV to specify the pdevid parameter. If a comma is included in the pdevid value, specify the value, excluding the comma. Command execution example In this example, the GetStorageArray (subtarget=PDEV) command obtains information about a PDEV (PDEV number: 1) belonging to a parity group (object ID: ARRAYGROUP.XP1024.10001.0.
PAGE 218
GetStorageArray (subtarget=Pool) GetStorageArray (subtarget=Pool) obtains information about pools for Snapshot, Fast Snap, Continuous Access Journal, or Thin Provisioning. 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.
PAGE 219
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.
PAGE 220
poolid Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter. clprfilter • If the function type that is used to operate the pools is Continuous Access Journal: Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command.
PAGE 221
raidLevel=combination= volAlertNotice=-1 overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 relocationSpeed=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfT
PAGE 222
threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=3,028 displayName=0B:D4 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 numberOfLBAs=3,277,440 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVo
PAGE 223
raidLevel=combination= volAlertNotice=-1 overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 relocationSpeed=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfT
PAGE 224
svolArrayType=Unknown svolDevNum=3,034 displaySvolDevNum=0B:DA svolPoolID=1 replicationFunction=ContinuousAccessJournal status=17 muNumber=0 copyTrackSize=-1 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 confPvolDevNum=-1 confSvolDevNum=-1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,025 displayName=0B:D1 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 numberOfLBAs=3,277,440 path=false commandDevice=false commandDeviceE
PAGE 225
. (repeated for other Pool instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=Port) GetStorageArray (subtarget=Port) obtains the information about ports. Parameters Table 75 GetStorageArray (subtarget=Port) command parameters Parameter name Status Description subtarget Required Specify Port. Serial number of the storage system serialnum Optional model Optional If you omit this parameter, all the storage systems become the target.
PAGE 226
Parameter name rpuidfilter Status Optional Description Filter used to select ports that belong to a specific physical resource group Specify the ID of the physical resource group that contains the ports. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
PAGE 227
controllerID=2 worldWidePortName=50.06.0E.80.05.27.17.
PAGE 228
Parameter name Status Description Controller ID of the port controller in the storage system controllernum Optional Specify this parameter when you want to obtain information about a specific port controller. If you specify this parameter, you must also specify the model and serialnum parameters. If controllernum and controllername are omitted, port controller information is obtained for the specified storage system. Do not specify controllernum and controllername at the same time.
PAGE 229
Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 4 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 . . (repeated for other PortController instances) . *****: The value is encoded by the CLI.
PAGE 230
GetStorageArray (subtarget=PResourcePartitionUnit) The GetStorageArray (subtarget=PResourcePartitionUnit) command obtains information about physical resource groups. NOTE: You can use this command only when you are using HP XP7. Parameters Table 77 GetStorageArray (subtarget=PResourcePartitionUnit) command parameters Parameter name Status Description subtarget Required Specify PResourcePartitionUnit.
PAGE 231
Parameter name Status Description Filter used to select LDEVs that belong to the physical resource group pldevfilter Optional The values you can specify are ASSIGNED (exists) or UNASSIGNED (does not exist). If you specify this parameter, you must also specify PLDEV for the prpusubinfo parameter. If you omit this parameter, operations are performed on all LDEVs.
PAGE 232
Parameter name Status Description Starting sequence number of host storage domains that belong to a physical resource group and from which you want to obtain information Specify this parameter when you want to obtain information for a part of host storage domains for a specific storage system.
PAGE 233
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. rpuid Obtain this value from the execution results of the GetStorageArray (subtarget=PResourcePartitionUnit) command.
PAGE 234
An instance of VLDEV objectID=***** resourcePartitionUnitID=1 devNum=747 vArrayFamily=P9500 vSerialNumber=53038 vDevNum=0 vEmulation=OPEN-V vSSID=4 vLUSE=0 vCVS=1 operationMode=0 hasSubstance=0 *****: The values are encoded by the CLI. GetStorageArray (subtarget=ReplicationInfo) GetStorageArray (subtarget=ReplicationInfo) obtains information about copy pairs.
PAGE 235
Parameter name Status Description ID of the copy pair information (ReplicationInfo instance) objectid Optional replicationsubinfo Optional Specify this parameter if you want to obtain specific copy pair information. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and do not specify the objectid parameter, information about copy pairs of the specified storage system is obtained.
PAGE 236
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. objectid Obtain this value from the execution result of the GetStorageArray (subtarget=ReplicationInfo) command.
PAGE 237
status=1 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 confPvolDevNum=-1 confSvolDevNum=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=100 displayName=00:64 emulation=OPEN-3 devCount=1 devType= capacityInKB=2,403,360 numberOfLBAs=4,806,720 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) c
PAGE 238
commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=S-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolI
PAGE 239
Parameter name Status Description Model of the storage system model Optional If you omit this parameter, all the storage systems become the target. You must specify this parameter if you specify the snapshotgroupid or snapshotgroupname parameter. ID of the snapshot group snapshotgroupid Optional Specify this parameter if you want to obtain information about a specific snapshot group. Do not specify this parameter together with the snapshotgroupname parameter.
PAGE 240
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 241
remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=1 confPvolSerialNumber= confPvolDevNum=-1 confSvolSerialNumber= confSvolDevNum=-1 *****: 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 HP XP7 and P9500. NOTE: If the storage system is other than the following, valid values are not output to some attributes.
PAGE 242
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.
PAGE 243
Parameters Table 81 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.
PAGE 244
Parameter name Status Description ID of the virtual 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.
PAGE 245
Parameter name Status Description Starting sequence number of virtual LDEVs for which you want to obtain information Specify this parameter if you want to obtain virtual information about some of the virtual LDEVs in a specific storage system. startVldevElementNumFilter Optional When virtual LDEVs are ordered by device number from 0 upward, specify the sequence number of the LDEV from which you want to start obtaining information.
PAGE 246
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_VResourcePartitionUnit.log" "subtarget=VResourcePartitionUnit" "model=P9500" "serialnum=53038" "vrpuid=1" "vrpusubinfo=VPort,VHostStorageDomain,VLDEV" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 247
. .(repeated for other VHostStorageDomain instances) . List of 102 VLDEV elements: An instance of VLDEV objectID=***** resourcePartitionUnitID=1 devNum=1 vArrayFamily=***** vSerialNumber=10007 vDevNum=1 vEmulation=OPEN-V vSSID=5 vLUSE=0 vCVS=0 operationMode=0 hasSubstance=1 . .(repeated for other VLDEV instances) . *****: The values are encoded by the CLI.
PAGE 248
poolids 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 results of this command, the values of poolID and tierControl appear under An instance of Pool.
PAGE 249
monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=1 lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationProgress=-1 relocationSpeed=-1 numberOfTiers=1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 *****: The value is encoded by the CLI.
PAGE 250
Parameter name Status Description subtarget Optional Specify VResourcePartitionUnit if you want to obtain information about virtual resource groups. Specify this parameter if you want to obtain virtual information about virtual LDEVs and virtual ports. vrpusubinfo Optional The values you can specify are VLDEV and VPort. To specify multiple values, separate them by using commas (,). If you specify this parameter, you must also specify VResourcePartitionUnit for the subtarget parameter.
PAGE 251
Command execution result 2 RESPONSE: An instance of VStorageArray objectID=***** name=XP7#10139 vArrayFamily=XP7 vSerialNumber=10139 vDisplayArrayFamily=XP7 List of 1 VResourcePartitionUnit elements: An instance of VResourcePartitionUnit objectID=***** name=meta_resource resourcePartitionUnitID=0 arrayType=XP7 serialNumber=10139 vArrayFamily=XP7 vSerialNumber=10139 virtualStorageMode=enable onDataMigration=false vDisplayArrayFamily=XP7 numberOfVPorts=0 numberOfVHostStorageDomains=0 numberOfVLDEVs=19 List o
PAGE 252
NOTE: This command can be used only with HP XP7, P9500, and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-07-00-XX/XX or later.
PAGE 253
devCount=1 devType= capacityInKB=1,049,280 numberOfLBAs=2,098,560 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 c
PAGE 254
Parameters Table 85 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.
PAGE 255
Parameters Table 86 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.
PAGE 256
under An instance of Pool. Select the THP/Smart pool that the THP/Smart pool volume belongs to, and then specify the corresponding poolID value for the poolid parameter. highdevnums, middledevnums, and lowdevnums Obtain this value from the execution result of the GetStorageArray (subtarget=Pool, poolsubinfo=LogicalUnit) command. Execute this command by specifying only the model and serialnum parameters, Pool for the subtarget parameter, and LogicalUnit for the poolsubinfo parameter.
PAGE 257
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 capacityInKB=6,150,144 freeCapacityInKB=6,064,128 usageRate=1 raidLevel
PAGE 258
Parameter name Status Description Device number of the logical unit For HP XP7, 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.
PAGE 259
Command execution example hdvmcli ModifyLabel -o "D:\logs\ModifyLabel.log" "serialnum=10037" "model=XP24000" "devnums=00:00:00,00:00:01" "label=myLabel" 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. ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device.
PAGE 260
Parameter name Status Description Device number of the LU For HP XP7, P9500, and XP24000/XP20000: Required devnum 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.
PAGE 261
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 262
To expand a THP/Smart pool, the following conditions must be satisfied: • The conditions on logical units to be specified as pool volumes, which are listed in “AddPool” on page 99. • For HP XP7, P9500, and XP24000/XP20000, the status of the THP/Smart pool is not Blocked and the usage rate is not 100%.
PAGE 263
#1 This can be specified only for P9500. #2 This can be specified only for HP XP7.
PAGE 264
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 Optional Specify a multiple of 5 in the range from 5 to 95. For HP XP7 or P9500 (with a microcode version of 70-014X-XX/XX or later): Specify an integer in the range from 1 to 100.
PAGE 265
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#2 The following values can be specified when modifying the threshold value: For HP XP7 and P9500: overprovisioningwarning#1 Optional 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.
PAGE 266
Parameter name Status Description Specify whether to automatically execute performance monitoring and hardware tier relocation. Optional automigration#3 (HP XP7 P9500) If you specify this parameter, you must also specify tiercontrol=enable. 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.
PAGE 267
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.
PAGE 268
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. 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 2 to 40.
PAGE 269
Parameter name Status Description Specify whether to apply the label information about the THP/Smart pool to the storage system. reflectoption Optional One of the following values can be specified. The values are not case-sensitive. (P9500) • true: Apply the label information to the storage system • false: Do not apply the label information to the storage system If this parameter is omitted, false is assumed to be specified. Specify the speed for hardware tier relocation.
PAGE 270
Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit, lusubinfo=LDEV) command. Execute this command by specifying only the model and serialnum parameters, LogicalUnit for the subtarget parameter, and LDEV for the lusubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit.
PAGE 271
rpm=15,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 relocationSpeed=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An
PAGE 272
managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=1,999 displayName=00:07:CF emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 numberOfLBAs=20,971,520 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex jour
PAGE 273
Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Pool elements: An instance of Pool . . (Attributes of Pool are omitted here) .
PAGE 274
NOTE: • Even if the topology value is changed, the change might not be immediately applied. In such cases, refresh the storage system by using the AddStorageArray command after waiting for about a minute. • Even if the value for Fibre Channel is changed, the change might not be immediately applied. In such cases, after confirming that the target port has been connected to the fibre network, refresh of the storage system by using the AddStorageArray command.
PAGE 275
Format for XP1024/XP128 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=new-transmission-speed-for-Fibre-Channel-connection-to-port] [lunsec={true|false}] [domain=domain-ID] [nickname={new-host-storage-domain-name|existing-host-storage-domain-name}] [newdomainnickname=new-host-storage-domain-name] [hostmode=host-mode-for-port] [wwn=WWN wwnnickname=WWN nic
PAGE 276
Parameter name Status Description New transmission speed for a Fibre Channel connection to a port • 0: Automatic • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps • 8: 8 Gbps channelspeed# Optional • 16: 16Gbps The specifiable values depend on the storage system. • HP XP7: 0, 2, 4, 8, 16 16 (16 Gbps) can be specified only when the value of the topology parameter is Fabric(on), Point-to-Point.
PAGE 277
Parameter name Status Description Specify the nickname of the host storage domain. The value specified for this parameter differs depending on whether domain is specified. If domain is specified: Specify the new nickname of the host storage domain. If domain is not specified: Specify the nickname of the host storage domain. You can use the following characters: A-Z a-z 0-9 ! # $ % & ' ( ) + - . = @ [ ] ^ _ ` { } ~ and spaces A nickname cannot begin or end with spaces.
PAGE 278
Parameter name Status Description The WWN that is used to provide security for the host storage domain To specify two or more WWNs, separate them with commas. Optional wwn If you specify this parameter, you must also specify the domain or nickname parameter. If you specify this parameter, you must also specify the wwnnickname or newwwnnickname parameter. You must specify the same number of values for each parameter.
PAGE 279
Parameter name Status Description New nickname of the WWN newwwnnickname Optional If you specify this parameter, you must also specify the domain or nickname parameter. If you specify this parameter, you must also specify the wwn or wwnnickname parameter. You must specify the same number of values for each parameter. # The topology and channelspeed parameters cannot be used when an FCoE connection is used.
PAGE 280
Command execution example In this example, the ModifyPort command modifies the settings for a port (port number: 16) of a storage system (serial number: 10001, model: XP1024) as follows. The command: • changes the value for the hostmode parameter to Standard, for the port's host storage domain (domain ID: 0) • changes the topology to Fabric(off), FC-AL • sets the Fibre Channel address to 73 • disables LUN security by specifying false • sets the transmission speed of the Fibre Channel to 1.
PAGE 281
An instance of WWN WWN=22.33.44.55.44.55.44.33 nickname=Jane An instance of WWN WWN=11.33.22.33.44.33.22.22 nickname=Jone An instance of WWN WWN=55.66.77.88.44.33.22.22 nickname= *****: The values are encoded by the CLI. ModifyPortController ModifyPortController supports changing characteristics of a PortController. NOTE: This command can be used only with XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128.
PAGE 282
ctrlid Obtain this value from the execution result of the GetStorageArray (subtarget=PortController) command. Execute this command by specifying only the model and serialnum parameters, and PortController for the subtarget parameter. In the execution result of this command, the controllerID value appears under An instance of PortController. Use this controllerID value to specify the ctrlid parameter.
PAGE 283
hdvmcli [URL] ModifyStorageArray [options] saobjid=object-ID-of-SMI-S-enabled-storage-system name=new-storage-system-name Parameters Table 92 ModifyStorageArray command parameters Parameter name Status Description serialnum Optional# Serial number of the storage system. You cannot specify this parameter if the storage system is an SMI-S enabled storage system. Model of the storage system model # Optional You cannot specify this parameter if the storage system is an SMI-S enabled storage system.
PAGE 284
Command execution example hdvmcli ModifyStorageArray –o "D:\logs\ModifyStorageArray.log" serialnum=10007 model=XP24000 name=R600#1 Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600#1 description=R600 (10007) at 10.208.115.
PAGE 285
mfTotalCapacity=418,309,920 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=1,739 numberOfOpenUnallocatedLUs=1,671 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActual
PAGE 286
Parameter name Status Description model Required Model of the storage system Tiering policy ID policyid Required Specify the tiering policy ID to be modified. You can specify from 6 to 31. You cannot specify a tiering policy ID from 0 to 5. Maximum allocation threshold value (%) for Tier 1 allocationthresholdt1max# Optional Specify the maximum capacity threshold value to be allocated for Tier 1 of virtual volumes to which the tiering policy has been applied.
PAGE 287
• Changes the maximum allocation threshold for Tier 1 to 50 (allocationthresholdt1max: 50) • Changes the minimum allocation threshold for Tier 1 to 20 (allocationthresholdt1min: 20) • 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.
PAGE 288
NOTE: This command can be used only with HP XP7, P9500, and XP24000/XP20000. For XP24000/XP20000, the following conditions must be satisfied when specifying a THP volume: • If you are assigning a THP volume to a THP pool, the THP volume must not already be assigned to a THP pool. • If you are assigning a THP volume to a THP pool, the status of the THP pool must not be Blocked. • If you are assigning a THP pool, the over-provisioning percent must be less than the over provisioning limit threshold.
PAGE 289
NOTE: The values specifiable for the tieringpolicy parameter vary depending on the microcode version. For details about the specifiable values, see the parameter descriptions.
PAGE 290
Parameter name poolid Status Description Optional Pool ID of the THP pool (XP24000 You need specify this parameter only if true is specified for the assign parameter. XP20000) Usage rate threshold for the THP volumes (%) Specify this parameter when you are assigning THP volumes to a THP pool, or when you are changing the threshold value. Specify a multiple of 5 from 5 to 300.
PAGE 291
Parameter name Status Description Tiering policy to be applied to Smart volumes.
PAGE 292
Parameter name Status Description New CLPR number You can specify this parameter if a path has not been assigned to the THP/Smart volume. This parameter cannot be specified concurrently with the following parameters: • capacity • tieringpolicy Optional clprNumber • tierrelocation (HP XP7 • capacitytype P9500) • newpageassignmenttier • relocationpriority You can specify this parameter only for HP XP7 or P9500 (microcode version 70-06-09-XX/XX or later).
PAGE 293
Parameter name Status Description Relocation priority Specify whether to execute hardware tier relocation preferentially. Optional relocationpriority (HP XP7 P9500) One of the following values can be specified. The values are not case-sensitive. • Default: Do not relocate data preferentially. • Prioritized: Relocate data preferentially when executing hardware tier relocation. For P9500, the microcode version must be 70-03-30-XX/XX or later when this option is specified.
PAGE 294
objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 numberOfLBAs=419,430,400 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalV
PAGE 295
An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
PAGE 296
hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=P9500 serialnum=15000 devnums=00:00:C4 tierrelocation=disable Command execution result 3 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Lu elements: An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
PAGE 297
thpTier1ConsumedCapacityInKB=0 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=disable resourcePartitionUnitID=0 newPageAssignmentTier=Middle relocationPriority=Default *****: The value is encoded by the CLI. ModifyVLDEV The ModifyVLDEV command registers or deletes the virtual device number and virtual information (virtual emulation, virtual SSID, virtual LUSE, and virtual CVS) for a virtual LDEV that belongs to a virtual resource group.
PAGE 298
Parameters Table 95 ModifyVLDEV command parameters Parameter name Status Description Specify an operation to be performed to the virtual LDEV. The following are the specifiable values: • mapvid: The virtual device number is registered in the virtual LDEV. • unmapvid: The virtual device number is deleted from the virtual LDEV. • mapvattr: Virtual information is registered in the virtual LDEV. vldevoperation Required • unmapvattr: Virtual information is deleted from the virtual LDEV.
PAGE 299
Parameter name Status Description Virtual emulation type of the virtual LDEV The following are the specifiable emulation types: • OPEN-3 • OPEN-8 • OPEN-9 • OPEN-E vemulation Optional • OPEN-K • OPEN-L • OPEN-V If you specify this parameter, you must also specify mapvattr for the vldevoperation parameter. If you specify mapvattr for the vldevoperation parameter and omit the vemulation parameter, OPEN-V is assumed.
PAGE 300
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. In the execution results of this command, the required resourcePartitionUnitID value appears under An instance of VResourcePartitionUnit. Use this value to specify the vrpuid parameter.
PAGE 301
vDevNum=128 vEmulation=OPEN-V vSSID=5 vLUSE=10 vCVS=1 operationMode=0 hasSubstance=0 *****: The values are encoded by the CLI. Command execution example 2 In this example, the ModifyVLDEV command deletes virtual information from a virtual LDEV (device number: 65264) that belongs to a virtual resource group (resource group ID: 60) in a storage system (model: XP7, serial number: 10182). hdvmcli ModifyVLDEV -o "D:\logs\ModifyVLDEV.
PAGE 302
*****: The values are encoded by the CLI. ModifyVResourcePartitionUnit The ModifyVResourcePartitionUnit command renames a virtual resource group. When a virtual resource group is renamed, the corresponding physical resource group is also renamed. NOTE: You can use this command only when you are using HP XP7.
PAGE 303
num parameters, and VResourcePartitionUnit for the subtarget parameter. In the execution results of this command, the required resourcePartitionUnitID value appears under An instance of VResourcePartitionUnit. Use this value to specify the vrpuid parameter. Command execution example In this example, the ModifyVResourcePartitionUnit command changes the name of a virtual resource group (resource group ID: 31) in a storage system (model: XP7, serial number: 10139) to vrsg1.
PAGE 304
Format When refreshing performance information for a specific storage system: hdvmcli [URL] RefreshPerformanceData [options] serialnum=serial-number model=model When refreshing performance information for all storage systems: hdvmcli [URL] RefreshPerformanceData [options] option=all Parameters Table 97 RefreshPerformanceData command parameter Parameter name Status Description serialnum Optional# Serial number of the storage system model Optional# Model of the storage system option # Optional P
PAGE 305
serialNumber=10037 status=SUCCEEDED RefreshResourceLabels The RefreshResourceLabels command obtains multiple labels that are set to the storage system, and then applies them to the database on the Device Manager server (to refresh the labels). NOTE: • This command can be used for P9500 only. • This command overwrites all of the label information of Device Manager with the label information of the specified storage system.
PAGE 306
Command execution result 1 RESPONSE: An instance of LabelInfo arrayType=P9500 serialNumber=54440 target=All numberOfPoolNames=5 numberOfVolumeLabels=2,335 Command execution example 2 This example obtains label information about THP/Smart pools from the storage system, and then applies the information to Device Manager. hdvmcli RefreshResourceLabels -o "D:\logs\ RefreshResourceLabels.
PAGE 307
Parameters Table 99 RefreshStorageArrays command parameter Parameter name Status Description Either of the following values can be specified to determine how storage systems are refreshed: refreshmode Optional • 1: Refreshes storage systems sequentially. • 2: Refreshes multiple storage system in parallel.# The default is 1.
PAGE 308
Command execution result RESPONSE: [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.116.106 userID=root ] [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.40.1 ] . . (repeated for other StorageArray instances) .
PAGE 309
Parameters Table 100 RunZeroPageReclaim command parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP/Smart volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
PAGE 310
numberOfLBAs=2,098,560 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold
PAGE 311
Parameters Table 101 ShrinkPool command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system poolid Required Pool ID Specify the pool ID of the THP/Smart pool to be shrunk. Device number of the logical unit(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number.
PAGE 312
hdvmcli ShrinkPool -o "D:\logs\ShrinkPool.log" model=P9500 serialnum=53039 poolid=1 devnums=00:06:0B Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
PAGE 313
repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 numberOfLBAs=20,972,160 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false commandDeviceAuth=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 conti
PAGE 314
currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=1 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The value is encoded by the CLI.
PAGE 315
Parameter name subtarget Status Optional Description Specify this parameter if you want to obtain information about an element in addition to information about the logical group. The only value that can be specified is Path. This setting is not case-sensitive. Type of the logical group to be obtained One of the following values can be specified. The values are not case-sensitive.
PAGE 316
. . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. Command execution example 2 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=path" *****: The value is encoded by the CLI.
PAGE 317
Command execution result 3 RESPONSE: An instance of LogicalGroup objectID=***** name=UG-B1 description=UG-B1 logicalPath=~UG-B1 capacity=3 capacityInKB=3,191,728 realCapacityInKB=3,191,728 percentUsed=0 numberOfLUNs=4 resourceType=0 specificationType=-1 An instance of LogicalGroup objectID=***** name=Volumes@UG-B1 description= parentID=***** logicalPath=~UG-B1/Volumes@UG-B1 capacity=3 capacityInKB=3,191,728 realCapacityInKB=3,191,728 percentUsed=0 numberOfLUNs=4 resourceType=2 specificationType=1 *****: T
PAGE 318
domain=domain-ID [scsi=SCSI-ID] lun=valid-LUN {devnum=device-number|lusedevnums=list-of-LDEV-numbers} NOTE: When setting up a LUN (path) to an LU to which a LUSE is already set, like the following command, you must specify devnum of the representative LDEV which constitutes the LUSE, and run AddLun.
PAGE 319
Parameter name Status Description lun Required Actual LUN used for new path Device number used to identify the new path (not provided when a LUSE is defined) For HP XP7, P9500, and XP24000/XP20000: Optional devnum (Required for HP XP7) 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.
PAGE 320
Obtain these values from the execution result of the GetStorageArray (subtarget=HostStorageDomain, hsdsubinfo=freelun) command. Execute this command by specifying only the model and serialnum parameters, HostStorageDomain for the subtarget parameter, and freelun for the hsdsubinfo parameter. In the execution result of this command, the portID, domainID and nickname values appear under An instance of HostStorageDomain. Use these portID values to specify the port parameter.
PAGE 321
wwnSecurityValidity=true List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mf
PAGE 322
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 mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI.
PAGE 323
AddWWNForHostStorageDomain AddWWNForHostStorageDomain assigns a WWN to a host storage domain LUN to sets up LUN security. 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.
PAGE 324
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 355.
PAGE 325
Obtain this value from the execution result of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Execute this command by specifying only the model and 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.
PAGE 326
Parameters Table 105 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.
PAGE 327
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.
PAGE 328
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.
PAGE 329
Parameters Table 107 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.
PAGE 330
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.
PAGE 331
AddHost AddHost adds information about a host server to the Device Manager server. NOTE: To register a virtualization server by using Host Data Collector, use the AddVirtualizationServer command.
PAGE 332
Parameter name Status Description OS type of the host One of the following values can be specified. The values are not case-sensitive. If you register a normal host: - AIX - HP-UX - Linux - SunOS - Windows ostype Optional - Others If you register a virtualization server: VMware If you specify this parameter, the host type is automatically set to normal host or virtualization server. Do not specify this parameter and the hosttype parameter at the same time.
PAGE 333
objectID=***** name=toro2 hostID=279 ipAddress=192.168.32.63 capacityInKB=0 hostType=3 managedBy=-1 osType=VMware statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddHostInfo AddHostInfo adds host-based information about a LUN (information about storage used by hosts). NOTE: This command does not support virtualization servers.
PAGE 334
Parameter name Status Description Device number of the path For HP XP7, 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.
PAGE 335
• 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.
PAGE 336
NOTE: • This command does not support virtualization servers. To refresh the information of a virtualization server that was registered with Host Data Collector, use the RefreshVirtualizationServer command. • If the copy pair management host is unable to recognize a copy pair that was created on a host that is not the copy pair management host, the copy status of that copy pair cannot be refreshed even if the AddHostRefresh command is executed.
PAGE 337
hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of Host objectID=***** name=rise hostID=5 ipAddress=192.168.32.164 capacityInKB=0 hostType=-1 managedBy=-1 osType=Windows statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database by using Host Data Collector.
PAGE 338
Format hdvmcli [URL] AddVirtualizationServer [options] ipaddress=IP-address-of-virtualization-server# hosttype=3 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 VMware vCenter Server is used to perform integrated management on virtualization servers.
PAGE 339
Command execution example This example uses Host Data Collector (IP address: 10.208.119.110) to accesses a virtualization server (IP address: 10.208.119.113 and detect 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.113 hosttype=3 hostprotocol=Secure hostuserid=root "hostuserpassword=boss!" hdcipaddress=10.208.119.
PAGE 340
Parameters Table 112 DeleteHost command parameters Parameter name Status Description objectid Optional# Object ID of the host to remove hostname Optional# Name of the host to remove # You must specify either objectid or hostname. Do not specify both parameters at the same time. If they are specified at the same time, an error occurs. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetHost command.
PAGE 341
Parameters Table 113 DeleteHostInfo command parameter Parameter name Status Description Object ID of the HostInfo record to remove objectid Required Specify the object ID obtained from another CLI response. The value is encoded by the CLI. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetHostInfo command. In the execution result of this command, the objectID value appears under An instance of HostInfo.
PAGE 342
hdvmcli [URL] GetHost [options] {objectid=object-ID-of-host-for-which-information-is-obtained |hostname=name-of-host-for-which-information-is-obtained} When obtaining information about a particular HORCM configuration file on the host, or information for a particular copy group related to the host: hdvmcli [URL] GetHost [options] objectid=object-ID-of-host-for-which-information-is-obtained {configfileid=object-ID-of-HORCM-configuration-file-of-RAID-Manager-of-host |configfileid=object-ID-of-HORCM-configura
PAGE 343
Parameter name Status Description 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. If they are specified at the same time, an error occurs. Object ID of the HORCM configuration definition file in the host configfileid Optional If you omit this parameter, the command acquires information about HORCM configuration definition files contained in the host.
PAGE 344
Parameter name Status Description Specify this parameter if you want to obtain information about logical units. You can specify the following values: lusubinfo Optional • LDEV: LDEV instance • Path: Path instance If you specify multiple values, separate them with commas. 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.
PAGE 345
Obtain these values from the execution result of the GetHost command without specifying any parameters.
PAGE 346
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.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
PAGE 347
svolArrayType=XP1024 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 snapshotGroupID=-1 confPvolSerialNumber=65010001 confPvolDevNum=101 confSvolSerialNumber=65010001 confSvolDevNum=102 *****: The values are encoded by the CLI.
PAGE 348
groupID=1 groupName=test1 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=770 displayPvolDevNum=00:03:02 pvolPoolID=1 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=667 displaySvolDevNum=00:02:9B svolPoolID=1 replicationFunction=FastSnap status=16 muNumber=6 copyTrackSize=-1 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=1 confP
PAGE 349
hostID=2 capacityInKB=0 hostType=2 managedBy=2 statusOfDBUpdating=-1 *****: The values are encoded by the CLI. Command execution example 4 In this example, the command obtains information about the logical unit that is assigned to the host (hostname = test). The information contains information about the paths that are assigned to the logical unit and about the HostInfo information that is related to the paths. hdvmcli GetHost -o "D:\logs\GetHost_LogicalUnit.
PAGE 350
journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=2,000,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 3 Path elements: An instance of Path objectID=***** devNum=1,008 portID=9 domainID=15 scsiID=15 LUN=12 wwnSecurityValidity=true An instance of Path objectID=***** devNum=1,008 portID=10 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true An instance of
PAGE 351
percentUsed=-1 lastUpdated=1254708417 An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) . *****: The values are encoded by the CLI. Command execution example 5 This example obtains information about the virtualization server (hostname = boss.boss) that was registered with Host Data Collector. This example also obtains information required to connect to the virtualization server. hdvmcli GetHost -o "D:\logs\GetHost_CommParameters.log" "hostname=boss.
PAGE 352
Command execution result 6 RESPONSE: An instance of Host objectID=***** name=ha8krs02 hostID=5 capacityInKB=0 hostType=3 managedBy=1 osType=VMware statusOfDBUpdating=0 virtualizationServerVersion=VMware ESXi 4.1.0 build-260247 List of 2 WWN elements: An instance of WWN WWN=10.00.00.00.C9.95.30.81 An instance of WWN WWN=10.00.00.00.C9.95.30.
PAGE 353
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. 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.
PAGE 354
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. Command execution example 2 hdvmcli GetHostInfo -o "D:\logs\GetHostInfo.
PAGE 355
. (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.
PAGE 356
hdvmcli [URL] HostScan [options] serialnum=serial-number model=model To perform a host scan for all storage systems, use the following format: hdvmcli [URL] HostScan [options] option=all Parameters Table 116 HostScan command parameters Parameter name serialnum model option Status Description #1, #2 Optional #1, #2 Optional Optional#1 Parameter used to specify the serial numbers of the storage systems for which a host scan is to be performed. Use a comma to delimit multiple values.
PAGE 357
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.
PAGE 358
Parameters Table 117 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. inputfile Required If a host that cannot be registered with Device Manager is specified, the record for that host is ignored and the subsequent records are registered. However, if there are multiple records for the same host name in the host information file, only the first record is registered.
PAGE 359
Parameter values to obtain in advance None. Command execution example 1 In this example, the ImportHosts command with check specified for the function parameter checks the input files. hdvmcli ImportHosts "function=check" "inputfile=D:\work\hostImport.csv" "mappingfile=D:\work\import.properties" "resultfilepath= D:\work" Command execution result 1 RESPONSE: Verification of records from 1 to 15 in "D:\work\hostImport.csv" is complete.
PAGE 360
Command execution result 2 RESPONSE: The import of records from 1 to 10 in "D:\work\hostImport.csv" is complete. Number of hosts added = 5 Number of hosts updated = 2 Number of hosts that failed = 3 Number of hosts added or updated with a warning = 2 See "D:\work\ImportHostsResult-20120515113355.log" for details about errors and warnings. The command execution result is output to the standard output.
PAGE 361
Parameter name Status Description 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. Therefore, if the host name contains a comma, use the ModifyHost command to change the host name so that it does not contain a comma before executing the MergeHost command. You can migrate a maximum of 100 WWNs at one time.
PAGE 362
NOTE: • This command cannot change WWN information or the OS type for the external port of a host. • This command cannot change the OS type for a mainframe host. • This command does not support virtualization servers that were registered with Host Data Collector. To modify information about a virtualization server that was registered with Host Data Collector, use the ModifyVirtualizationServer command.
PAGE 363
Parameter name Status ipaddress Optional ipv6address Optional Description 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 Omit this parameter if you are not changing the IPv6 IP address of the host. OS type of the host after modification One of the following values can be specified. The values are not case-sensitive.
PAGE 364
Command execution example hdvmcli ModifyHost -o "D:\logs\ModifyHost.log" "objectid=*****" "hostname=snow" "wwnlist=12.34.56.78.90.AB.CD.EF,01.23.45.67.89.AB.CD.EF" "ipaddress=172.18.32.9" "ostype=VMware" "takeoverwwn=true" *****: The value is encoded by the CLI. Command execution result RESPONSE An instance of Host objectID=***** name=snow hostID=1 ipAddress=172.18.32.9 capacityInKB=0 hostType=3 managedBy=-1 osType=VMware statusOfDBUpdating=0 List of 2 WWN elements: An instance of WWN WWN=12.34.56.78.
PAGE 365
Parameter name Status model Optional Description New model of the path's storage system Omit this when no change is required. New name of the HostInfo hostname Optional Omit this when no change is required. You can use a character string of 1-50 bytes for the name. New IPv4 IP address of the host ipaddress Optional Omit this parameter if you are not changing the IPv4 IP address of the host.
PAGE 366
Parameter name Status portwwn Optional filetype Optional filename Optional size Optional percentused Optional Description New Port WWN on the host bus adapter Omit this when no change is required. New type of the file system Omit this when no change is required. New name of the file system Omit this when no change is required. New LUN size in MB Omit this when no change is required. New percentage of the LUN in use Omit this when no change is required.
PAGE 367
• The new file system name is oo, and the new file system type is NTFS1. • 156 MB is secured for the new LUN, and the new percentage of use is set to 50% of the LUN size. hdvmcli ModifyHostInfo -o "D:\logs\ModifyHostInfo.log" "objectid=*****" "model=XP1024" "serialnum=10001" "hostname=MY_HOSTINFO_XP1024" "ipAddress=111.111.111.111" "mountPoint=E:" "port=7" "domain=0" "devnum=2" "portwwn=11.33.55.77.99.BB.DD.
PAGE 368
NOTE: • To change the information of a virtualization server that was not registered with Host Data Collector, use the ModifyHost command. • The instance of Host Data Collector to be specified must be set in the hostdatacollectors.properties file, which contains the properties for linking with Host Data Collector. For details about setting up Host Data Collector, see the manual HP XP7 Command View Advanced Edition Administrator Guide.
PAGE 369
Parameter name Status Description Specify this parameter if you want to change the IP address of the instance of Host Data Collector to be connected. IP address (IPv4 or IPv6) or host name can be specified. hdcipaddress Optional Specify the value that is set for hostdatacollectors.properties. If a version of Device Manager earlier than 8.0 is used to register a virtualization server that is being managed by vMA, you need to specify both the hostprotocol and hdcipaddress parameters.
PAGE 370
ipAddress=10.208.119.113 portNumber=443 protocol=Secure userID=root *****: The value is encoded by the CLI. RefreshVirtualizationServer RefreshVirtualizationServer refreshes information about virtualization servers that were registered with Host Data Collector. Parameters Table 122 RefreshVirtualizationServer command parameter Parameter name Status Description Host name hostname Required Specify the host name of the virtualization server whose information you want to refresh.
PAGE 371
An instance of WWN WWN=21.00.00.24.FF.2C.AE.19 An instance of WWN WWN=21.00.00.24.FF.2C.AE.18 List of 1 CommParameters elements: An instance of CommParameters hdcIPAddress=10.208.119.110 ipAddress=10.208.119.113 portNumber=443 protocol=Secure userID=root *****: The value is encoded by the CLI. Commands related to server management The Server Management commands provide some management support for the Device Manager server.
PAGE 372
Parameters Table 123 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.
PAGE 373
DeleteAlerts The DeleteAlerts command deletes alerts that are managed by 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 124 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.
PAGE 374
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.
PAGE 375
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.
PAGE 376
Parameters Table 126 GetAlerts command parameters Parameter name Status sourcefilter# Optional timefilter# Optional countfilter# Optional Description Source of the alerts to be obtained Specify the object ID of the storage system. Obtain only alerts newer than the specified date and time. Specify the date and time in the format YYYY/MM/DD HH:MM:SS.
PAGE 377
severity=4 component=DKC processor description=Moderate error detected on DKC processor. actionToTake=Contact Customer Support. data=Component does not function fully. timeOfAlert=2003/01/06 20:13:51 *****: The values are encoded by the CLI. GetServerInfo GetServerInfo acquires information, such as the Device Manager server's version and URL, a list of supported storage system families, and the status of the license in use. This command has no parameters.
PAGE 378
displayArrayFamily=VSP An instance of StorageArray arrayFamily=HM700 displayArrayFamily=HUS VM An instance of StorageArray arrayFamily=R800 displayArrayFamily=VSP G1000 An instance of StorageArray arrayFamily=R800 displayArrayFamily=VX7 An instance of StorageArray arrayFamily=XP1024/128 displayArrayFamily=XP1024/128 An instance of StorageArray arrayFamily=XP12K/10K/SVS200 displayArrayFamily=XP12K/10K/SVS200 An instance of StorageArray arrayFamily=XP24K/20K displayArrayFamily=XP24K/20K An instance of Storage
PAGE 379
Parameters Table 127 GetURLLink command parameters Parameter name Status Description The object ID of the URLLink for which you want to obtain information objectid Optional# Specify the object ID obtained from another CLI response. The value is encoded by the CLI. Do not specify this parameter with the linkedid parameter. If they are specified at the same time, an error occurs.
PAGE 380
Command execution result RESPONSE: An instance of URLLink objectID=***** name=test url=http://10.208.184.97 linkedID=***** createdByUser=1 *****: The values are encoded by the CLI. Commands related to replication The Replication commands can be used to manage copy pairs.
PAGE 381
replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] • Method 2: Adds a copy group to the RAID Manager configuration definition file, and adds a copy pair definition to the copy group.
PAGE 382
Parameters Table 128 AddConfigFileForReplication command parameters Parameter name Status Description Group name used in the RAID Manager groupname Optional You can use a maximum of 31 bytes. You cannot specify a name that begins with a hash mark (#) or hyphen (-). When using Method 1, specify a group name that is specified in the definition file. You must specify this parameter when you are using method 1.
PAGE 383
Parameter name Status Description Device number of the P-VOL For HP XP7, P9500, and XP24000/XP20000: pvoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
PAGE 384
Parameter name Status Description Device number of the storage system in the HORCM configuration file that manages the P-VOL. To define a copy pair configuration by using a virtual ID, specify a virtual device number. Optional confpvoldevnum (HP XP7) The confpvolserialnum and confpvoldevnum parameters must be specified at the same time.
PAGE 385
Parameter name Status Description Serial number of the storage system in the HORCM configuration file that manages the S-VOL. confsvolserialnum Optional (HP XP7) To define a copy pair configuration by using a virtual ID, specify a virtual serial number. The confsvolserialnum and confsvoldevnum parameters must be specified at the same time. Device number of the storage system in the HORCM configuration file that manages the S-VOL.
PAGE 386
• When using Method 1 (when adding a copy pair definition to a copy group in which another copy pair has been defined): See No. 1, No. 5, No. 6, and No. 8 in the table below. • When using Method 1 (when adding a copy pair definition to a copy group in which no copy pair has been defined): See No. 2, No. 3, No. 5, No. 6, and No. 8 in the table below. • When using Method 2: See No. 2, No. 4, No. 5, No. 6, No. 7, and No. 8 in the table below. • When using Method 3: See No. 2, No. 5, No. 6, No. 7, and No.
PAGE 387
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.
PAGE 388
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.
PAGE 389
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).
PAGE 390
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.
PAGE 391
No. Parameter name How to obtain For the GetHost command, specify LogicalUnit for the subtarget parameter, LDEV for the lusubinfo parameter, and VLDEV for the ldevsubinfo parameter. Specify the name of the host that recognizes the P-VOL or S-VOL for the hostname parameter, and then execute the command. confpvolserialnum 8 confpvoldevnum confsvolserialnum confsvoldevnum The execution result of the GetHost command displays the vSerialNumber and vDevNum values appear below An instance of VLDEV.
PAGE 392
Command execution result 2 RESPONSE (Command completed; empty list returned) Command execution example 3 This example creates configuration files and a group, and then adds pairs to the group: hdvmcli AddConfigFileForReplication -o "D:\logs\AddConfigFileForReplication.
PAGE 393
NOTE: • This command is not available for XP1024/XP128. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs. • You must specify a formatted LDEV. If you specify an unformatted LDEV, a copy pair is not created. To check whether an LDEV is formatted, for HP XP7, P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, use the GetStorageArray command.
PAGE 394
[pvolpoolid=pool-ID] [confpvolserialnum=serial-number] [confpvoldevnum=device-number] svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=port-number|svolportname=port-name] [svolpoolid=pool-ID] [confsvolserialnum=serial-number] [confsvoldevnum=device-number] replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] [fencelevel=fence-level] [copytracksize=copy-pace] [pairoption=suspend] • Method 3: Crea
PAGE 395
Parameter name Status Description Group name used in the RAID Manager Use a maximum of 31 bytes for a group name. The group name cannot begin with a hash mark (#) or a hyphen (-). groupname Optional For details about the characters that can be used in group names, follow the rules for RAID Manager. If the replicationgroupid parameter is specified, this parameter is ignored.
PAGE 396
Parameter name Status Description Device number of the P-VOL For HP XP7, P9500, and XP24000/XP20000: pvoldevnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
PAGE 397
Parameter name Status Description Device number of the storage system in the HORCM configuration file that manages the P-VOL. To define a copy pair configuration by using a virtual ID, specify a virtual device number. Optional confpvoldevnum (HP XP7) The confpvolserialnum and confpvoldevnum parameters must be specified at the same time.
PAGE 398
Parameter name Status Description Serial number of the storage system in the HORCM configuration file that manages the S-VOL. confsvolserialnum Optional (HP XP7) To define a copy pair configuration by using a virtual ID, specify a virtual serial number. The confsvolserialnum and confsvoldevnum parameters must be specified at the same time. Device number of the storage system in the HORCM configuration file that manages the S-VOL.
PAGE 399
Parameter name Status Description Copy pace (number of tracks copied at one time during initial copy) You can specify an integer from 1 to 15. copytracksize If you omit this parameter, 3 is specified. Optional If Snapshot or ContinuousAccessJournal is specified for the replicationfunction parameter, this parameter is ignored. pairoption The following value can be specified only when XP12000/XP10000/SVS200 is being used: Optional suspend: Creates a delta resync pair.
PAGE 400
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.
PAGE 401
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.
PAGE 402
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.
PAGE 403
Command execution result 1 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=0 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
PAGE 404
ID of the host that recognizes the primary volume is 1 and the instance number of the HORCM that manages the primary volume is 11. Similarly, as the secondary volume (S-VOL), specify the logical device with LDEV number 12 in the storage system with model number XP1024 and serial number 15001. The ID of the host that recognizes the secondary volume is 1, which is the same ID as that of the primary volume, and the instance number of the HORCM that manages the secondary volume is 12.
PAGE 405
svolMngAreaPoolID=-1 snapshotGroupID=-1 confPvolSerialNumber=15001 confPvolDevNum=11 confSvolSerialNumber=15001 confSvolDevNum=12 *****: The values are encoded by the CLI. Command execution example 3 This example creates a RAID Manager configuration definition file and a copy group and then creates a copy pair for Continuous Access Synchronous in the copy group.
PAGE 406
pvolDevNum=11 displayPvolDevNum=00:0B pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=35001 svolArrayType=XP128 svolDevNum=128 displaySvolDevNum=00:80 svolObjectID=***** svolPoolID=-1 fenceLevel=Never replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=14 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=-1 confPvolSerialNumber=15001 confPvolDevNum=11 confSvolSerialNumber=35001 confSvolDevNum=128 *****: The values are encoded by the CLI.
PAGE 407
pvolarraytype=model pvolserialnum=serial-number pvoldevnum=device-number [pvolpoolid=pool-ID] svoldevnum=device-number {snapshotgroupid=snapshot-group-ID|snapshotgroupname=snapshot-group-name} replicationfunction=FastSnap • Method 2: Create a snapshot group, and then add a copy pair to that snapshot group.
PAGE 408
Parameter name Status Description Snapshot group ID snapshotgroupid Optional If you are using method 1, specify either the snapshotgroupid or snapshotgroupname parameter. If you are using method 2, do not specify this parameter. If you specify this parameter, method 1 is applied. Snapshot group name Use a maximum of 32 bytes for a group name. The group name cannot begin with a hyphen (-).
PAGE 409
(the objectID value recorded when the pvoldevnum value was obtained) specified for the objectID parameter. The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit. See the values of arrayType, displayArrayType, and serialNumber under An instance of StorageArray that includes below it An instance of LogicalUnit for which the specified objectID is displayed.
PAGE 410
groupID=5 groupName=test5 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=5 displayPvolDevNum=00:00:05 pvolPoolID=7 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=10 displaySvolDevNum=00:00:0A svolPoolID=7 replicationFunction=FastSnap status=16 muNumber=6 copyTrackSize=-1 splitTime=1,385,028,155 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID
PAGE 411
ipv6Address=fec0:0:0:7076:b036:e7e8:bdd9:9e34%1 capacityInKB=408,103,872 hostType=-1 managedBy=2 osType=Windows statusOfDBUpdating=0 List of 1 SnapshotGroup elements: An instance of SnapshotGroup objectID=***** arrayType=P9500 serialNumber=10001 groupID=1 groupName=test1 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=5 displayPvolDevNum=00:00:05 pvolPoolID=7 svolSerialNumber=100
PAGE 412
NOTE: • This command is not available for XP1024/XP128. • You cannot execute any operations for Fast Snap copy pairs defined in the HORCM configuration file. • For Fast Snap, you cannot use the Device Manager CLI to perform any operations for consistency groups. • To delete a specific copy pair from a copy group, you must specify pvolserialnum, pvoldevnum, svolserialnum (or svolsequencenum), and svoldevnum. If you omit all of these parameters, the system deletes all copy pairs in the specified copy group.
PAGE 413
Parameter name Status Description Serial number of the storage system that contains the S-VOL svolserialnum Optional svolsequencenum Optional If you specify this parameter, do not specify the svolsequencenum parameter. If they are specified at the same time, an error occurs. Sequence number of the storage system that contains the S-VOL If you specify this parameter, do not specify the svolserialnum parameter. If they are specified at the same time, an error occurs.
PAGE 414
pvolDevNum in the pvoldevnum parameter, the value of svolSerialNumber in the svolserialnum parameter, and the value of svolDevNum in the svoldevnum parameter. svolsequencenum Obtain the parameter value from the execution result of the GetStorageArray command for the storage system that contains the S-VOL. Specify the value of sequenceNumber that is displayed as An instance of StorageArray in the svolsequencenum parameter.
PAGE 415
An instance of ReplicationGroup objectID=***** replicationGroupID=7 groupName=HCMD_CG0007 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
PAGE 416
Command execution result 2 RESPONSE (Command completed; empty list returned) Command execution example 3 This example deletes a Fast Snap copy pair that belongs to the snapshot group 8. The primary volume (P-VOL) of the copy pair is the logical device with LDEV number 10 in the storage system with model number P9500 and serial number 10001. The secondary volume (S-VOL) is the logical device with LDEV number 11 in the storage system with model number P9500 and serial number 10001.
PAGE 417
svolPoolID=38 replicationFunction=FastSnap status=16 muNumber=988 copyTrackSize=-1 splitTime=1,385,186,735 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 snapshotGroupID=8 confPvolSerialNumber= confPvolDevNum=-1 confSvolSerialNumber= confSvolDevNum=-1 *****: The values are encoded by the CLI. Command execution example 4 This example deletes snapshot group 8 and all the copy pairs that are defined in the snapshot group. hdvmcli DeleteReplication -o "D:\logs\DeleteReplication.
PAGE 418
Parameters Table 134 GetReplicationControllerPair command parameters Parameter name Status Description masterserialnum Optional# Serial number of the storage system that contains the main control unit (MCU) mastercontrollerid Optional# CU number of the MCU remoteserialnum Optional# Serial number of the storage system that contains the remote control unit (RCU) remotessid Optional# SSID of the RCU mastermodel Optional# Model of the storage system that contains the MCU remotefamily Optional
PAGE 419
hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
PAGE 420
remoteSSID=0 remoteControllerID=0 remotePathGroupID=165 remoteStartDevNum=-1 remoteEndDevNum=-1 pairType=0 bandwidth=-1 numOfMinConnection=1 . . (repeated for other ReplicationControllerPair instances) . *****: The value is encoded by the CLI. ModifyReplication The ModifyReplication command is used to change the status of a copy pair. NOTE: • You cannot execute any operations for Fast Snap copy pairs defined in the HORCM configuration file.
PAGE 421
Parameter name Status Description Specify one of the following values: • split: Split the copy pair. • resync: Re-synchronize the copy pair from the primary volume (P-VOL) to the secondary volume (S-VOL). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot or Fast Snap copy pair, the copy pair is split after the re-synchronization. For this reason, the paired volume status is set to PAIR, and then changes toPSUS.
PAGE 422
Parameter name Status Description Copy pace You can specify an integer from 1 to 15. copytracksize Optional When changing the copy pace for an identified copy pair, specify the parameters pvolserialnum, pvoldevnum, svolserialnum, and svoldevnum. When using one operation to change the copy paces of all copy pairs, omit these parameters. If split or resync is specified for the operation parameter, this parameter is ignored.
PAGE 423
hostid Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the raidcom command for RAID Manager (raidcom command) that manages the P-VOL is installed. The execution results of the GetHost command displays the hostID value under An instance of Host. Use the hostID value to specify the hostid parameter.
PAGE 424
svolHORCMINSTHostName=192.168.32.
PAGE 425
capacityInKB=408,103,872 hostType=-1 managedBy=2 osType=Windows statusOfDBUpdating=0 List of 1 SnapshotGroup elements: An instance of SnapshotGroup objectID=***** arrayType=P9500 serialNumber=10001 groupID=12 groupName=test12 replicationFunction=FastSnap ctGrp=NotCTG List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=P9500 pvolDevNum=20 displayPvolDevNum=00:00:14 pvolPoolID=1 svolSerialNumber=10001 svolArrayType=P9500 svolDevNum=21 displayS
PAGE 426
Command reference
PAGE 427
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.
PAGE 428
Attribute Description Time at which the alert occurred (example: 2008/04/06 20:13:56) timeOfAlert If type is Server, the time at which the Device Manager server obtained the alert is output, and if type is Trap, the time at which the alert occurred on the storage system is output.
PAGE 429
Attribute Description diskType Type of physical drives that make up the parity group (example: DKR2E-J146FC) 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).
PAGE 430
Attribute Description openFreeCapacity Total size of all open LDEVs that are not assigned paths in the parity group (in KB) openAutoLunCapacity Total size of all open LDEVs reserved for Auto LUN 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)
PAGE 431
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.
PAGE 432
Attribute Description Protection level of the parity group For HP XP7, 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.
PAGE 433
CommParameters instance Commands for which a CommParameters instance is output • • • • • • • AddStorageArray, page 113 AddVirtualizationServer, page 337 GetHost, page 341 GetStorageArray (subtarget=CommParameters) , page 182 ModifyVirtualizationServer, page 367 RefreshStorageArrays, page 306 RefreshVirtualizationServer, page 370 Table 139 CommParameters instance attributes Attribute Description User ID For a storage system: User ID for accessing the storage system userID For SMI-S enabled storage syste
PAGE 434
Attribute Description Port number For SMI-S enabled storage systems: Port number of the SMI-S provider service portNumber For a virtualization server managed by Host Data Collector#: Port number of the virtualization server or VMware vCenter Server For other cases, no value is output. IP address of Host Data Collector hdcIPAddress For a virtualization server managed by Host Data Collector, the IP address of Host Data Collector is output. For other cases, no value is output.
PAGE 435
Attribute Description Current status of the component • 1: Normal • 2: Acute value • 3: Serious • 4: Moderate • 5: Service Current status of the component One of the following values is output depending on the value of value: • Normal • Acute description • Serious • Moderate • Service • Unknown ConfigFile instance Commands for which a ConfigFile instance is output • GetHost, page 341 Table 141 ConfigFile instance attributes Attribute Description objectID Object ID of the configuration definition fi
PAGE 436
Datastore instance Commands for which a Datastore instance is output • GetHost, page 341 Table 142 Datastore instance attributes Attribute Description datastoreID Datastore ID name Datastore name Datastore type • 0: Unknown datastoreType • 1: VMFS • 2: Raw Device Mapping ExternalPathInfo instance Commands for which an ExternalPathInfo instance is output • GetStorageArray (subtarget=ArrayGroup) , page 178 • AddExternalArrayGroup, page 63 Table 143 ExternalPathInfo instance attributes Attribute Descr
PAGE 437
ExternalStorage instance Commands for which an ExternalStorage instance is output • GetStorageArray (subtarget=ExternalStorage) , page 187 Table 144 ExternalStorage instance attributes Attribute Description numOfExternalVolume Number of external volumes externalCapacityInKB External volume capacity (KB) FreeLUN instance Commands for which a FreeLUN instance is output • GetStorageArray (subtarget=HostStorageDomain) , page 193 Table 145 FreeLUN instance attribute Attribute Description lun LUN that ca
PAGE 438
Host instance Commands for which a Host instance is output • • • • • • • • • • • AddHost, page 331 AddHostRefresh, page 335 AddReplication (For Fast Snap), page 406 AddVirtualizationServer, page 337 DeleteReplication, page 411 GetHost, page 341 MergeHost, page 360 ModifyHost, page 361 ModifyReplication, page 420 ModifyVirtualizationServer, page 367 RefreshVirtualizationServer, page 370 Table 147 Host instance attributes Attribute Description objectID Object ID of the host Host name name If EXSP_xxxx_
PAGE 439
Attribute Description OS type of the host • AIX • HP-UX • Linux ostype • SunOS • Windows • VMware • Others This item is output if the value of hostType is -1 or 3. sysplexID Mainframe host sysplexID Status of the processing to update the Device Manager database If the value of hostType is -1 or 3, one of the following values is output: • 0: The Device Manager database is consistent. statusOfDBUpdating • 1: The Device Manager database is being updated. • 2: The Device Manager database is inconsistent.
PAGE 440
Attribute Description Display name of the HostInfo object name This item is output if it has been registered. 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.
PAGE 441
Attribute Description portName Port name Display name of the logical unit device number For HP XP7, 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.
PAGE 442
Attribute Description Nickname of the host storage domain. nickname The name specified for the host group of the storage system is output. Domain type of the host storage domain domainType 0 (host group) is output.
PAGE 443
• • • • • • • • • • AddLun, page 317 AddLUSE, page 88 AddVirtualVolume, page 121 FormatLU, page 160 GetStorageArray (subtarget=ArrayGroup) , page 178 GetStorageArray (subtarget=LDEV) , page 197 GetStorageArray (subtarget=LogicalUnit) , page 202 GetStorageArray (subtarget=MFReplicationInfo) , page 208 GetStorageArray (subtarget=Pool) , page 218 ModifyVirtualVolume, page 287 Table 152 LDEV instance attributes Attribute Description objectID Object ID of the LDEV LDEV name name This item is output if it
PAGE 444
Attribute Description RAID type of the LDEV The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]). • RAIDx: RAID level raidType • yD: Number of data drives • zP: Number of parity drives For example, RAID5(3D+1P) indicates a RAID5 configuration consisting of three data drives and one parity drive.
PAGE 445
Attribute Description Guard mode guardMode A space is output when the guard mode is invalid. When multiple modes are set, the modes are separated by semicolons (;) when they are output (example: Protect). Type of the drive • -1: Unknown • 0: FC • 1: SATA diskType • 4: SAS • 5: SSD • 8: FMD If a storage system is connected externally and an external volume is mapped to the internal volume, a value different from the actual drive type might be output.
PAGE 446
Attribute Description LDEV status One of the following values is output for HP XP7, P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) • Blocked: Blocked status or unformatted. status • Format: The LDEV is being formatted. • Correction Access: The access attribute is being modified. • Copying: Data is being copied. • ReadOnly: Read-only • Shredding: The LDEV is being shredded.
PAGE 447
Attribute Description Volume type of Business Copy for Mainframe • Unknown: Unknown mfShadowImageVolumeType • Simplex: Not a Business Copy for Mainframe volume • P-VOL • S-VOL • SP-VOL Volume type of Continuous Access Journal for Mainframe • Unknown: Unknown mfUniversalReplicatorVolumeType • Simplex: Not a Continuous Access Journal for Mainframe volume • P-VOL • S-VOL • MF-JNL: Journal volume Pool ID of LDEV One of the following values is output for HP XP7, P9500, XP24000/XP20000, or XP12000/XP10000/SV
PAGE 448
Attribute Description Indicates whether the data that is stored in the LDEV is encrypted. One of the following values is output for HP XP7, 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.
PAGE 449
LogicalDKC instance Commands for which a LogicalDKC instance is output • GetStorageArray (subtarget=LogicalDKC) , page 200 Table 153 LogicalDKC instance attributes Attribute Description logicalDKCNumber Logical DKC number mfLogicalSerialNumber Serial number of the logical DKC recognized by a mainframe host LogicalGroup instance Commands for which a LogicalGroup instance is output • GetLogicalGroup, page 314 Table 154 LogicalGroup instance attributes Attribute Description objectID Object ID of the l
PAGE 450
Attribute Description Method for specifying a resource. Indicates the method for specifying a resource (a host or volume) managed by a logical group. specificationType • 0: Direct specification • 1: Conditional specification -1 is output if the logical group type is a folder. # The values of the lower logical groups are also added.
PAGE 451
Attribute Description Number of the LDEV contained in the logical unit devNum For HP XP7, 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 and XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output.
PAGE 452
Attribute Description RAID type of the logical unit The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]). • RAIDx: RAID level raidType • yD: Number of data drives • zP: Number of parity drives For example, RAID5(3D+1P) indicates a RAID5 configuration consisting of three data drives and one parity drive. currentPortController Currently, this information does not apply to storage systems (-1 is output).
PAGE 453
Attribute Description sysVolFlag This item is output only for XP12000/XP10000/SVS200 or XP1024/XP128. 0 is output for other storage systems. Indicates whether the logical unit is used as an external volume. externalVolume • 0: Not used as an external volume. • 1: Used as an external volume. Indicates whether the logical unit is used for differential management. differentialManagement • true: Used for difference management. • false: Not used for difference management.
PAGE 454
Attribute Description Usage of on the THP/Smart volume (KB) One of the following values is output for HP XP7, P9500, or XP24000/XP20000: • When the logical unit does not consist of THP/Smart volumes: The same value as capacityInKB. • When the logical unit consists of THP/Smart volumes: Usage of on the THP/Smart volumes. -1 is output for other storage systems.
PAGE 455
Attribute Description managementAreaPoolID Currently, this information does not apply to storage systems (-1 is output). External LDEV tier rank externalTierRank This attribute is output only when the THP/Smart pool volume is used as an external volume in HP XP7 or P9500 (with a microcode version 70-04-00-XX/XX or later). #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.
PAGE 456
Attribute Description svolDevNum Device number of the S-VOL Device number of the S-VOL For HP XP7, P9500, or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. 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.
PAGE 457
ObjectLabel instance Commands for which an ObjectLabel instance is output • • • • • GetStorageArray (subtarget=ArrayGroup) , page 178 GetStorageArray (subtarget=LDEV) , page 197 GetStorageArray (subtarget=LogicalUnit) , page 202 AddLabel, page 79 ModifyLabel, page 257 Table 157 ObjectLabel instance attributes Attribute Description targetID Object ID of the label label LDEV label PairedPool instance Commands for which a PairedPool instance is output • GetStorageArray (subtarget=Pool) , page 218 Table
PAGE 458
Attribute Description Name of the paired port controller name This item is output if it has been registered.
PAGE 459
Attribute Description Display name of the logical unit device number For HP XP7, P9500, or XP24000/XP20000: 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. displayDevNum 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.
PAGE 460
Attribute Description Parity group containing the physical device arrayGroup -1 is output if the physical device does not belong to the parity group. Drive size of the physical device (in KB) For HP XP7, P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: capacityInKB The capacity that is calculated by treating 1,024 bytes as 1 KB is output. For XP1024/XP128: The capacity that is calculated by treating 1,000 bytes as 1 KB is output.
PAGE 461
Attribute Description Drive type of the physical device • -1: Unknown • 0: FC diskType • 1: SATA • 4: SAS • 5: SSD • 8: FMD formFactor Currently, this information does not apply to storage systems (-1 is output). pdevid ID of the PDEV arrayGroupName Name of the parity group to which the PDEV belongs diskModelSize Currently, this information does not apply to storage systems. encrypted Currently, this information does not apply to storage systems (-1 is output).
PAGE 462
PHostStorageDomain instance Commands for which a PHostStorageDomain instance is output • AddPHSDToPRPU, page 94 • GetStorageArray (subtarget=PResourcePartitionUnit), page 230 Table 164 PHostStorageDomain instance attributes Attribute Description objectID Object ID of the PHostStorageDomain portID Port ID of the host storage domain that belongs to the physical resource group domainID Domain ID of the host storage domain that belongs to the physical resource group Indicates whether a host storage domai
PAGE 463
• • • • • • GetPoolShrinkStatus, page 165 GetStorageArray (subtarget=Pool) , page 218 GetTieredPoolStatus, page 247 ModifyExternalTierRank, page 254 ModifyPool, page 261 ShrinkPool, page 310 NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.2, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script that you use in version 6.3 or later.
PAGE 464
Attribute Description Indicates the pool type. The value output depends on the poolFunction value.
PAGE 465
Attribute Description Indicates whether the value output to threshold2 is the value determined by the storage system. threshold2Mode If the storage system is HP XP7 and P9500 and poolFunction is 5, either of the following values is output: • 0: Value determined by the storage system • 1: Value set by the user This information is unknown or invalid for other cases (-1 is output).
PAGE 466
Attribute Description Combination of data drives and parity drives in a RAID configuration. For HP XP7 or 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.
PAGE 467
Attribute Description Type of the drive If the storage system is HP XP7 or P9500 and a THP pool is used, one of the following values is output: • 1: SATA • 4: SAS • 5: SSD or FMD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive drive types are mixed (except for SSD and FMD) • Drives with different drive speeds are mixed This information is invalid for other cases (-1 is output). Indicates whether the pool is a Smart pool.
PAGE 468
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.
PAGE 469
#1 This attribute is valid only when a Smart pool is used, and autoMigration is enable. #2 This attribute is valid only when a Smart pool is used, and autoMigration is disable. This information is invalid for other cases (-1 is output).
PAGE 470
Attribute Description Drive revolutions per minute -1 is output if any of the following conditions are satisfied: • The drive speed is unknown rpm • Drives with different drive speeds are mixed • Drive types are mixed Type of the drive • 1: SATA • 4: SAS • 5: SSD or FMD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive drive types are mixed (except for SSD and FMD) • Drives with different drive speeds are mixed Indicates whether the volumes that make up
PAGE 471
Attribute Description Address of the Fibre port (AL_PA) fibreAddress For HP XP7, P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, either of the following values is output: • 00 or no value: Neither a Fibre port nor an FCoE port • 01 - EF: Valid address (two-digit hexadecimal number) topology Fibre topology displayName Display name of the port Indicates whether LUN security is valid for the port.
PAGE 472
PortController instance Commands for which a PortController instance is output • GetStorageArray (subtarget=PortController) , page 227 • ModifyPortController, page 281 Table 169 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.
PAGE 473
Attribute Description Port type type For details about the output values, see Table 170.
PAGE 474
Storage system Values output for the type attribute • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-Tachyon (4 ports) • 44: Fibre-Tachyon (8 ports) • 45: Fibre-Tachyon (16 ports) • 46: NAS (2 ports) • 48: NAS (4 ports) • 49: FICON (4 ports) • 50: FICON (8 ports) XP12000/XP10000/SVS200 • 51: iSCSI (4 ports) • 52: iSCSI (4 ports) • 55: Fibre-Tachyon (8 ports) • 56: Fibre-Tachyon (16 ports) • 57: Fibre-Tachyon (4 ports) • 58: Fibre-Tachyon (8 ports) • 59: Fibre-Tachyon (16 ports) • 60: Fibre-Tachyon (
PAGE 475
PResourcePartitionUnit instance Commands for which a PResourcePartitionUnit instance is output • • • • • • AddPArrayGroupToPRPU, page 92 AddPHSDToPRPU, page 94 AddPLDEVToPRPU, page 96 AddPPortToPRPU, page 111 AddVResourcePartitionUnit, page 135 GetStorageArray (subtarget=PResourcePartitionUnit), page 230 Table 172 PResourcePartitionUnit instance attributes Attribute Description objectID Object ID of the PResourcePartitionUnit name Name of the physical resource group resourcePartitionUnitID Resource
PAGE 476
ReplicationControllerPair instance Commands for which a ReplicationControllerPair instance is output • GetReplicationControllerPair, page 417 Table 173 ReplicationControllerPair instance attributes Attribute Description objectID#1 Object ID of ReplicationControllerPair masterArrayType MCU model masterControllerID CU number of the MCU masterEndDevNum Maximum device number among the applicable LUs in the MCU masterSerialNumber Serial number of the MCU masterStartDevNum Minimum device number among
PAGE 477
Attribute Description Display name of the highest device number among the applicable LUs in the MCU For HP XP7, P9500, or XP24000/XP20000: displayMasterEndDevNum 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.
PAGE 478
• ModifyReplication, page 420 Table 174 ReplicationGroup instance attributes Attribute Description objectID Object ID of the copy group replicationGroupID Group ID of the copy group groupName Name of the copy group used by the RAID Manager pvolHostID Host ID of the host that recognizes the P-VOL pvolInstanceNumber Instance number of the HORCM instance that manages the P-VOL pvolPortNumber Port number of the HORCM instance that manages the P-VOL Value specified in HORCM_MON for the P-VOL in the
PAGE 479
ReplicationInfo instance Commands for which a ReplicationInfo instance is output • • • • • • • AddReplication, page 392 AddReplication (For Fast Snap), page 406 DeleteReplication, page 411 GetHost, page 341 GetStorageArray (subtarget=Pool) , page 218 GetStorageArray (subtarget=ReplicationInfo) , page 234 ModifyReplication, page 420 Table 175 ReplicationInfo instance attributes Attribute Description objectID Object ID of ReplicationInfo Name of the copy pair used by the RAID Manager pairName This item
PAGE 480
Attribute Description Copy type • BusinessCopy: Business Copy • ContinuousAccessSync: Continuous Access Synchronous replicationFunction • ContinuousAccessAsync: Continuous Access Asynchronous • Snapshot: Snapshot • FastSnap: Fast Snap • ContinuousAccessJournal: Continuous Access Journal fenceLevel Fence level of the P-VOL (example: Data) 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
PAGE 481
Attribute Description Device number of the S-VOL For HP XP7, P9500, or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. 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.
PAGE 482
ServerInfo instance Commands for which a ServerInfo instance is output • GetServerInfo, page 377 Table 176 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 •
PAGE 483
Attribute Description serialNumber Serial number of the storage system groupID Snapshot group ID groupName Snapshot group name Copy type replicationFunction FastSnap is output. Consistency group ID ctGrp If the snapshot group is a consistency group, the consistency group ID is output.
PAGE 484
• • • • • • • • • • • • • • • • GetStorageArray (subtarget=LogicalDKC) , page 200 GetStorageArray (subtarget=LogicalUnit) , page 202 GetStorageArray (subtarget=MFReplicationInfo) , page 208 GetStorageArray (subtarget=Path) , page 211 GetStorageArray (subtarget=PDEV) , page 216 GetStorageArray (subtarget=Pool) , page 218 GetStorageArray (subtarget=Port) , page 225 GetStorageArray (subtarget=PortController) , page 227 GetStorageArray (subtarget=PResourcePartitionUnit), page 230 GetStorageArray (subtarget=Rep
PAGE 485
Attribute Description arrayFamily Family of the storage system arrayType Type of the storage system SVP microcode version microcodeVersion This item is output for HP XP7, P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128. SNMP agent version agentVersion This item is output for HP XP7, P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128.
PAGE 486
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 (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) allocatedCapacityInKB
PAGE 487
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 (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) openAll
PAGE 488
Attribute Description An attribute for compatibility. imOnDemandCapacity For details, see Table 179. 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 (in KB) mfAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 1.
PAGE 489
Attribute Description This item indicates whether an unformatted logical unit can be created. One of the following values is output for HP XP7, 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.
PAGE 490
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.
PAGE 491
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. A list of CLPR numbers of the storage system All the CLPR numbers of the storage system are separated by semicolons (;) and output.
PAGE 492
Attribute totalFreeSpaceInGB# largestFreeSpaceInGB# Description Total size of the regions in which logical units can be created (regions of unused capacity) (in GB) For HP XP7, P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
PAGE 493
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.
PAGE 494
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 241 • ModifyTieringPolicy, page 285 Table 180 TieringPolicy instance attributes Attribute Description objectID Object ID of TieringPolicy 494
PAGE 495
Attribute Description Tiering Policy ID policyID This attribute is valid only when Smart volumes are used in HP XP7 or P9500. For details about the output values, see the policyid parameter in Table 93. 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.
PAGE 496
Attribute Description linkedID Object ID of the Device Manager object for which URLLink is set 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 193 •
PAGE 497
VirtualDisk instance Commands for which a VirtualDisk instance is output • GetHost, page 341 Table 183 VirtualDisk instance attributes Attribute Description vmDiskID Virtual disk ID name Virtual disk name datastoreID Datastore ID VLDEV instance Commands for which a VLDEV instance is output • • • • • • • AddVLDEVToVRPU, page 129 GetStorageArray (subtarget=LDEV) , page 197 GetStorageArray (subtarget=LogicalUnit) , page 202 GetStorageArray (subtarget=PResourcePartitionUnit), page 230 GetStorageArray (
PAGE 498
Attribute Description Virtual emulation mode of the virtual LDEV vEmulation If there is no virtual information for the LDEV, a null character is output. Virtual SSID of the virtual LDEV vSSID If there is no virtual information for the LDEV, -1 is output. Indicates whether a virtual LUSE is set for the virtual LDEV. • 0: Non-LUSE volume vLUSE • 2 to 36: A LUSE volume (with the specified number of volumes) If there is no virtual information for the LDEV, -1 is output.
PAGE 499
• GetStorageArray (subtarget=LogicalUnit) , page 202 Table 186 VolumeConnection instance attributes Attribute Description objectID Object ID of VolumeConnection Name of VolumeConnection name This item is output if it has been registered.
PAGE 500
VPort instance Commands for which a VPort instance is output • GetStorageArray (subtarget=Port) , page 225 • GetStorageArray (subtarget=VResourcePartitionUnit), page 242 • GetVStorageArray, page 249 Table 187 VPort instance attributes Attribute Description objectID Object ID of the VPort resourcePartitionUnitID Resource group ID of the virtual resource group portID Port ID vArrayFamily Family of the virtual storage machine vSerialNumber Serial number of the virtual storage machine Virtual port ID
PAGE 501
• ModifyVResourcePartitionUnit, page 302 Table 188 VResourcePartitionUnit instance attributes Attribute Description objectID Object ID of the VResourcePartitionUnit name Name of the virtual resource group resourcePartitionUnitID Resource group ID of the virtual resource group arrayType Type of the storage system serialNumber Serial number of the storage system vArrayFamily Family of the virtual storage machine vSerialNumber Serial number of the virtual storage machine Whether or not the virtu
PAGE 502
Attribute Description vDisplayArrayFamily Display name of the virtual storage machine family WWN instance Commands for which a WWN instance is output • • • • • • • • • • • • • AddLun, page 317 AddVirtualizationServer, page 337 AddWWNForHostStorageDomain, page 323 GetHost, page 341 GetStorageArray (subtarget=HostStorageDomain) , page 193 GetStorageArray (subtarget=LogicalUnit) , page 202 GetStorageArray (subtarget=Path) , page 211 GetStorageArray (subtarget=Port) , page 225 MergeHost, page 360 ModifyHos
PAGE 503
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.
PAGE 504
• ModifyVLDEV About the creation of batch files To use the batch functionality to execute commands, you need to create a batch file that follows the input rules and satisfies the conditions for parameters. There are two types of input rules: Input rules for the batch files themselves, and input rules for the command lines in batch files. In addition, there are batch-processing conditions for command parameters that must be satisfied.
PAGE 505
Input rules for command lines in batch files The commands that you want to execute together must be specified between beginbatch and endbatch in a batch file. The input rules for each command line are as follows: • Only the command to be executed and the command parameters can be specified on each command line. URLs, options, or help cannot be specified. • Parameters common to each command line cannot be specified in a properties file.
PAGE 506
• Condition-3: Specify values. This means that a parameter value must be specified. If a parameter value is specified for which the command cannot be executed together with other commands, the command is executed by itself. • Condition-4: Omit the parameter. This means that the parameter must not be specified. If this parameter is specified, the command cannot be executed together with other commands. The command is executed by itself.
PAGE 507
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.
PAGE 508
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.
PAGE 509
Specification conditions Parameter arraygroupname Condition-2 chassis groupnum Table 197 Conditions for specification of parameters for the AddPHSDToPRPU command Specification conditions Parameter model Condition-1 rpuid serialnum port Condition-2 portname No restrictions domain Table 198 Conditions for specification of parameters for the AddPLDEVToPRPU command Specification conditions Parameter model Condition-1 rpuid serialnum No restrictions devnum Table 199 Conditions for specification
PAGE 510
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.
PAGE 511
Specification conditions Parameter vfamily No restrictions vrpuname vserialnum Table 203 Conditions for specification of parameters for the AddWWNForHostStorageDomain command Specification conditions Condition-1 Condition-2 Parameter model serialnum port portname domain No restrictions domainnickname wwn wwnnickname Table 204 Conditions for specification of parameters for the DeleteHostStorageDomain command Specification conditions Parameter deletionoption Condition-1 model serialnum domain Con
PAGE 512
Specification conditions Parameter devnum No restrictions domain domainnickname Table 206 Conditions for specification of parameters for the DeleteLUSE command Specification conditions Condition-1 No restrictions Parameter model serialnum devnum Table 207 Conditions for specification of parameters for the DeletePArrayGroupFromPRPU command Specification conditions Condition-1 Parameter model serialnum arraygroupname Condition-2 chassis groupnum Table 208 Conditions for specification of parameters f
PAGE 513
Specification conditions Parameter No restrictions devnum Table 210 Conditions for specification of parameters for the DeletePPortFromPRPU command Specification conditions Parameter model Condition-1 serialnum port Condition-2 portname Table 211 Conditions for specification of parameters for the DeleteVLDEVFromVRPU command Specification conditions Parameter deletionoption model Condition-1 serialnum vrpuid No restrictions devnum Table 212 Conditions for specification of parameters for the De
PAGE 514
Specification conditions Parameter Notes capacity clprNumber devnums poolid No restrictions threshold tieringpolicy tierrelocation newpageassignmenttier 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.
PAGE 515
Operations to complete in advance • Lock the target storage system. When the batch functionality is executed, HP recommends using the AddArrayReservation command to lock the target storage system in advance, and prevent other users from performing a storage system allocation. To use the batch functionality: • To use the batch functionality, specify the batch option (-b or --batch) and a batch file name.
PAGE 516
RESPONSE OF ADDLUN(2-5): An instance of StorageArray objectID=***** name=XP12000@10.208.116.108 description=XP12000 (14053) at 10.208.116.
PAGE 517
numberOfMfLDEVs=80 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=2 lastRefreshed=1,153,456,561 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocatedActualCapacity=1,683,100,560 openUnallocatedCapacity=5,803,543,936 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
PAGE 518
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.
PAGE 519
Table 215 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",
PAGE 520
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.
PAGE 521
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 357. Overview of the import functionality The ImportHosts command can be used to import host information from files.
PAGE 522
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.
PAGE 523
NOTE: • If you add hosts, the imported hosts are registered as normal hosts or virtualization servers. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually (hosts that were registered by using the AddHost command or the HostScan command). The ImportHosts command only updates normal hosts or virtualization servers that were manually registered by using the Device Manager GUI or CLI.
PAGE 524
5. Check the hosts that are newly imported. Related topics • • • • ImportHosts, page 357 Conventions for creating host information files (CSV files), page 524 Conventions for creating mapping definition files, page 525 Examples of input files, page 527 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.
PAGE 525
Item Description Specify a 16-digit hexadecimal number in one of the following formats: WWN 10000000C971BFD8, 10.00.00.00.C9.71.BF.D8, or 10:00:00:00:C9:71:BF:D8 Alphabetic characters are not case sensitive. To specify two or more entries, use a comma or line break as a separator. IP address (IPv4)# IP address (IPv6)# Specify an IP address in IPv4 format. Specify an IP address in IPv6 format. Alphabetic characters are not case sensitive. Specify the OS type value.
PAGE 526
The following table describes the properties (and their values) that can be specified in a mapping definition file. Table 217 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.
PAGE 527
Property Description import.host.ostype.aix These five properties specify the character strings to be mapped to OS types. import.host.ostype.hpux The OS type values that are specified in the host information file are mapped to OS types. import.host.ostype.linux import.host.ostype.solaris Specify values in accordance with the following conventions: • Enclose each value in double quotation marks ("). • Alphabetic characters are not case sensitive. import.host.ostype.
PAGE 528
Example of a host information file (CSV file) 1,2,3,4,5,6[CRLF] host,ip,ipv6,OS,description,wwn[CRLF] TEST1,10.0.0.1,,WINDOWS,Evaluation purpose,11.11.11.11.11.11.11.11[CRLF] TEST2,,,Windows 2008,DB server,22.22.22.22.22.22.22.22[CRLF] TEST3,,,Windows 7,File server,33.33.33.33.33.33.33.33[CRLF] TEST4,10.0.0.3,,LINUX,,44.44.44.44.44.44.44.44[CRLF] TEST5,,,VMware ESX,,55.55.55.55.55.55.55.
PAGE 529
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.
PAGE 530
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.
PAGE 531
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 531 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.
PAGE 532
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.
PAGE 533
#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 (or GetVStorageArray) command is used. Specification example output=redirect.
PAGE 534
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.
PAGE 535
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.
PAGE 536
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.
PAGE 537
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.
PAGE 538
Problem Description and recommended action CAUSE: The size of the request to be sent to the Device Manager server might be too large because many targets for operations were specified in a single command line. SOLUTION: Take the following actions: An OutOfMemoryError occurred during execution of a Device Manager CLI command. 1. Increase the memory heap size of the Device Manager CLI. 2. Increase the memory heap size of the Device Manager server.
PAGE 539
If an HTTP status code other than 401 or 413 is output, wait a while and then retry the operation. If the error occurs even after you retry the operation, contact the HP Technical Support.
PAGE 540
Troubleshooting
PAGE 541
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.
PAGE 542
Support and other resources
PAGE 543
A Connecting to XP7 mainframe agent This appendix describes how to specify the information required for linking with XP7 mainframe agent.
PAGE 544
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.
PAGE 545
name=toro2 hostID=1 capacityInKB=0 hostType=2 managedBy=2 statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Registering the XP7 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 XP7 mainframe agent running on the mainframe host in Device Manager.
PAGE 546
Command format (for an IPv4 environment): hdvmcli AddURLLink "url=http://mainframe-host-IP-address:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.
PAGE 547
1. Check whether XP7 mainframe agent is operating normally. If it is not operating normally, check the XP7 mainframe agent settings, and restart XP7 mainframe agent. 2. Check whether the mainframe host and XP7 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
PAGE 548
If an error occurs during the execution of the AddHostRefresh command, perform the following procedure: 1. Check whether XP7 mainframe agent is operating normally. If it is not operating normally, check the XP7 mainframe agent settings, and restart XP7 mainframe agent. 2. Check whether the mainframe host and XP7 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
PAGE 549
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.
PAGE 550
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 XP7 mainframe agent information registered in Device Manager To delete XP7 mainframe agent information registered in the Device Manager server, use the DeleteURLLink command. Use this command when you want to delete only XP7 mainframe agent registration information.
PAGE 551
Example of executing the command: hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 capacityInKB=0 hostType=2 managedBy=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI.
PAGE 552
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=snow hostID=1 capacityInKB=0 hostType=2 managedBy=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Deleting a mainframe host To delete a mainframe host registered in the Device Manager server, use the DeleteHost command.
PAGE 553
B Output format of execution results of the GetStorageArray (GetVStorageArray) command This appendix describes the procedure for outputting the execution results of the GetStorageArray (or GetVStorageArray) command in CSV or XML format. Outputting execution results of the GetStorageArray (GetVStorageArray) command in CSV format To output the execution results of the GetStorageArray (or GetVStorageArray) command in CSV format, specify csv for the -f (or --format) option.
PAGE 554
The following table lists the parameters that you cannot specify with this option.
PAGE 555
StorageArray.attr-name: Entry name attr-value: Value [CRLF]: Line feed code [EOF]: End-of-file code The execution results are encoded in UTF-8. If you use the execution results in an application, such as spreadsheet software, that does not support UTF-8 encoding, you must convert the character encoding. First line: An entry name and a line feed code are output. The entry name is output even if the entry does not have a value. Second and subsequent lines: A value and a line feed code are output.
PAGE 556
[CRLF] [CRLF] ... Legend: attr-name: Entry name attr-value: Value [CRLF]: Line feed code When an execution result is output in XML format, an XML declaration, a DOCTYPE declaration, and XML elements are output.
PAGE 557
PAGE 558
PAGE 559
PAGE 560
protocol CDATA #IMPLIED> portNumber CDATA #IMPLIED> hostName CDATA #IMPLIED> hostName2 CDATA #IMPLIED>
PAGE 561
PAGE 562
PAGE 563
row CDATA #IMPLIED> column CDATA #IMPLIED> denseNumber CDATA #IMPLIED> densePosition CDATA #IMPLIED> depth CDATA #IMPLIED> role CDATA #IMPLIED> vendor CDATA #IMPLIED> model CDATA #IMPLIED> firmwar
PAGE 564
PAGE 565
name CDATA #IMPLIED> cluster CDATA #IMPLIED> card CDATA #IMPLIED> controllerID CDATA #IMPLIED> displayName CDATA #IMPLIED> mode CDATA #IMPLIED> type CDATA #IMPLIED>
PAGE 566
PAGE 567
PAGE 568
resourcePartitionUnitID CDATA #IMPLIED> devNum CDATA #IMPLIED> vArrayFamily CDATA #IMPLIED> vSerialNumber CDATA #IMPLIED> vDevNum CDATA #IMPLIED> vEmulation CDATA #IMPLIED> vSSID CDATA #IMPLIED> vLUSE CDATA #IMPLIED> vCVS CDATA #IMPLIED> operationMode CDATA #IMPLIED> hasSubstance CDATA #IMPLI
PAGE 569
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.
PAGE 570
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 571
Glossary This glossary defines the special terms used in this document.
PAGE 572
LDEV logical device LU logical unit LUN logical unit number LUSE Logical Unit Size Expansion MB megabytes (1024 KB) MCU main control unit (for Continuous Access) MLC Multiple Level Cell OS operating system PDEV physical device P-VOL primary volume (for Business Copy or Continuous Access) RAID redundant array of independent disks RCU remote control unit (for Continuous Access) SCSI small computer system interface SLC Single Level Cell SLPR Storage Logical Partition SMI-S Storag
PAGE 573
Index A access control, 45 acquiring Device Manager server information GetServerInfo, 377 AddArrayReservation, 61 AddConfigFileForReplication, 380 AddExternalArrayGroup, 63 AddHost, 331 AddHostInfo, 333 AddHostRefresh, 335 AddHostStorageDomain, 68 AddLabel, 79 AddLogicalUnit, 81 AddLun, 317 AddLUSE, 88 AddPArrayGroupToPRPU, 92 AddPHSDToPRPU, 94 AddPLDEVToPRPU, 96 AddPool, 99 AddPPortToPRPU, 111 AddReplication, 392 AddReplication (for Fast Snap), 406 AddStorageArray, 113 AddTieredPoolOperation, 118 AddURLLin
PAGE 574
conventions of creating host information file (CSV file), 524 mapping definition file, 525 copy pair AddConfigFileForReplication, 380 AddReplication, 392 AddReplication (for Fast Snap), 406 DeleteReplication, 411 ModifyReplication, 420 CSV file host information file, 522 ImportHosts, 524 CSV format execution results of GetStorageArray command, 554 parameters that cannot be specified for output, 553 D Datastore instance, 436 DeleteAlerts, 373 DeleteArrayReservation, 137 DeleteExternalArrayGroup, 137 DeleteH
PAGE 575
execution results output format, 30 outputting execution results of GetStorageArray (GetVStorageArray) command in CSV format, 553 outputting execution results of GetStorageArray (GetVStorageArray) command in XML format, 555 suppressing output, 30 external parity group AddExternalArrayGroup, 63 DeleteExternalArrayGroup, 137 ExternalPathInfo instance, 436 ExternalStorage instance, 437 F FormatLU, 160 FreeLUN instance, 437 FreeSpace instance, 437 G GetAlerts, 375 GetArrayReservation, 165 GetHost, 341 GetHost
PAGE 576
I import functionality, 521 adding host information, 521 ImportHosts, 357, 521 input files, 522 migrating host information, 521 output files, 522 updating host information, 521 import.properties, 523 ImportHosts, 357, 521 ImportHosts command using, 522 input files example, 527 for ImportHosts, 522 host information file (CSV file), 522 import.
PAGE 577
options, 28 output files check results file, 522 error information file, 522 for ImportHosts, 522 output items Alert instance, 427 ArrayGroup instance, 428 ArrayReservation instance, 432 CommParameters instance, 433 Component instance, 434 ConfigFile instance, 435 Datastore instance, 436 ExternalPathInfo instance, 436 ExternalStorage instance, 437 FreeLUN instance, 437 FreeSpace instance, 437 Host instance, 438 HostInfo instance, 439 HostStorageDomain instance, 441 IPAddress instance, 442 LabelInfo instanc
PAGE 578
overview Device Manager licenses, 19 execution environment, 21 P PairedPool instance, 457 PairedPortController instance, 457 parameters, 28 parity group GetStorageArray (subtarget=ArrayGroup), 178 PArrayGroup instance, 459 password, 29 encoding, 25 path (LUN path) AddLun, 317 DeleteLun, 325 Path instance, 458 PDEV instance, 459 PerformanceStatus instance, 461 PHostStorageDomain instance, 462 physical resource group AddPArrayGroupToPRPU, 92 AddPHSDToPRPU, 94 AddPLDEVToPRPU, 96 AddPPortToPRPU, 111 DeletePArr
PAGE 579
shrinking a pool GetPoolShrinkStatus, 165 ShrinkPool, 310 ShrinkPool, 310 Smart pool AddPool, 99 AddTieredPoolOperation, 118 DeletePool, 150 GetPoolShrinkStatus, 165 GetStorageArray (subtarget=Pool), 218 GetTieredPoolStatus, 247 ModifyPool, 261 ShrinkPool, 310 Smart volume AddVirtualVolume, 121 DeleteVirtualVolume, 154 GetStorageArray (subtarget=TieringPolicy), 241 GetZeroPageReclaimStatus, 251 ModifyVirtualVolume, 287 RunZeroPageReclaim, 308 SMI-S enabled storage system, 43 SnapshotGroup instance, 482 Stor
PAGE 580
W WWN AddWWNForHostStorageDomain, 323 DeleteWWN, 327 DeleteWWNForHostStorageDomain, 328 WWN instance, 502 X XML format DTD used for outputting execution results, 556 execution results of GetStorageArray command, 555 XML-API request files about XML-API request files, 569 create an XML-API request file, 569 XP7 mainframe agent, 543 Z zero-page reclaim GetZeroPageReclaimStatus, 251 RunZeroPageReclaim, 308 580