HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96326 Eighth edition: November 2012
Legal and notice information © Copyright 2010, 2012 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents Preface .............................................................................................. 15 1 Overview ........................................................................................ 17 Overview of the Device Manager CLI .......................................................................................... 17 Device Manager licenses ...........................................................................................................
DeleteLUSE ...................................................................................................................... DeletePool ....................................................................................................................... DeleteStorageArray .......................................................................................................... DeleteVirtualVolume .........................................................................................................
AddHostRefresh ............................................................................................................... AddVirtualizationServer .................................................................................................... DeleteHost ...................................................................................................................... DeleteHostInfo .................................................................................................................
Pool instance .......................................................................................................................... PoolTier instance ..................................................................................................................... Port instance .......................................................................................................................... PortController instance ..............................................................................
Outputting execution results in CSV format ........................................................................... Outputting execution results in XML format ........................................................................... Specifying a DTD ............................................................................................................. Using a DTD with the Device Manager CLI ..........................................................................
Figures 1 Example of executing the AddExternalArrayGroup command ........................................ 48 2 Relationship of attributes (total size of the volumes in the storage system) ...................... 380 3 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 380 4 Relationship of attributes (the sizes of the volumes) .................................................... 380 5 Flow of operations for importing host information (ImportHosts command) ......
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 18 2 Device Manager CLI variable syntax ......................................................................... 26 3 Device Manager CLI options .................................................................................... 27 4 Device Manager CLI return values ............................................................................. 30 5 Storage system commands and related storage systems ...
33 DeleteHostStorageDomain command parameters ........................................................ 98 34 DeleteLabel command parameters ........................................................................... 100 35 DeleteLogicalUnit command parameters ................................................................... 101 36 DeleteLUSE command parameters ........................................................................... 103 37 DeletePool command parameters ..................................
70 ModifyPool command parameters ........................................................................... 194 71 ModifyPort command parameters ............................................................................ 202 72 ModifyPortController command parameters .............................................................. 208 73 ModifyStorageArray command parameters .............................................................. 210 74 ModifyTieringPolicy command parameters .........................
107 How to obtain parameter values (AddConfigFileForReplication command) .................... 295 108 AddReplication command parameters ..................................................................... 301 109 How to obtain parameter values (AddReplication command) ...................................... 305 110 DeleteReplication command parameters ................................................................... 312 111 GetReplicationControllerPair command parameters ..................................
144 ReplicationControllerPair instance attributes .............................................................. 364 145 ReplicationGroup instance attributes ........................................................................ 366 146 ReplicationInfo instance attributes ............................................................................ 367 147 ServerInfo instance attributes ..................................................................................
Preface This guide describes HP StorageWorks P9000 Command View Advanced Edition Suite Software and how to set up and use the command line interface (CLI). Besides command syntax and parameters, topics include batch files, mainframe hosts, output formats, and troubleshooting. The intended audience is a storage administrator with independent knowledge of HP StorageWorks P9000 storage systems, SANs, and Java environments.
Preface
1 Overview This chapter provides an overview of the Device Manager CLI. This chapter also explains the differences between Device Manager licenses and provides a procedure for downloading the Device Manager CLI from the Device Manager server. Overview of the Device Manager CLI By issuing commands from a command line prompt, the Device Manager CLI communicates with the Device Manager server and issues requests to a storage system.
Device Manager licenses Device Manager provides the following two licenses: Full license: A full license is required to use all Device Manager functions. The types of full licenses are as follows: permanent, temporary, and emergency. 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.
3. Decompress the copied file. After modifying the hdvmcli.properties file as needed, you can run the Device Manager CLI. When you want to use the Device Manager CLI by downloading it from the GUI, check the Java version that the Device Manager CLI supports, and then specify an appropriate JRE. For details about how to specify a JRE, see “How to configure a Java environment” on page 21.
Overview
2 Environment settings This chapter provides the environment settings necessary to use the Device Manager CLI. Java environment settings To execute the Device Manager CLI, the Java environment must be properly configured for the Device Manager CLI execution environment. How to configure a Java environment It is assumed that a Java version supported by the Device Manager CLI is installed on the computer that executes the Device Manager CLI.
NOTE: If you use the Device Manager CLI on the same computer as the Device Manager server, HP recommends that you specify the same JRE that the Device Manager server uses (the JRE provided with HP P9000 Command View Advanced Edition Suite). However, when HTTPS is used to communicate with the Device Manager server, you cannot use the same JRE that the Device Manager server uses. In this case, prepare another JRE that is supported by the Device Manager CLI and configure a Java environment.
Setting up HTTPS communication To use HTTPS to communicate with the Device Manager server, you need to set up an environment on Device Manager server and the management client that executes the Device Manager CLI. For details about how to specify the security communication settings, see the HP P9000 Command View Advanced Edition Suite Software Administrator Guide. For details about examples of executing commands using HTTPS, see “Executing the Device Manager CLI by using HTTPS” on page 29.
NOTE: • If the Device Manager server is managing multiple storage systems, CLI memory requirements will be increased. Be sure to contact your HP Technical Support for further information. • If the value of HDVM_CLI_MEM_SIZE is less than what is required by a CLI command, CLI terminates, and the following error message is displayed: KAIC90574-E The memory for the CLI became insufficient while this operation was being performed.
3 Executing commands This chapter explains how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Command syntax The Device Manager CLI provides a simple way to submit requests to the Device Manager server and examine responses from the server. The application is run from the command line. Each execution of the application sends one request to the server and receives a response to that request.
NOTE: • 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. For details about the properties file, see Chapter 8 on page 407. • The Device Manager CLI only supports ASCII code characters.
Variable options Function Options control the behavior of the CLI application. Options are entered in the typical UNIX fashion. Options are case sensitive. Each option has a single character representation and an alternate word representation; for the single character, prefix the character with a single dash; for the word, prefix the word with two dashes. For example: -t or --messagetrace. Some options require an argument, which follows the option. For example, the -u option is followed by a user ID.
Option Argument for the option Status Description An XML API request file Takes input from the specified file, which must contain the Device Manager server request as a complete XML document. When this option is selected, the output of the server's response is an XML-formatted document. -i or --input file-name#2 Optional If you specify this option, the specification in the file overrides the equivalent specification from the command line.
If you execute a command other than the Help function by specifying a login user ID but not specifying the login password for the option or property, a message appears prompting you to enter the login password. #4 If you specify csv with the -f (or --format) option as one of the parameters for the GetStorageArray command, there are some parameters that you cannot specify.
Return values The Device Manager CLI returns an execution result value at the end of each process. The following table lists and describes the CLI return values. Table 4 Device Manager CLI return values Return values Description 0 The CLI ended normally. 1 The CLI found errors within the process (for example, a parameter error). 2 The CLI found errors in the Device Manager server. Help This section describes the various types of Device Manager CLI Help and how to display them.
To display Help for the batch function, specify the following: C:\hdvm> hdvmcli help batch List of commands Table 5 through Table 10 list the CLI commands and related storage systems. Note that if the Core CLI/SMI-S license is used, logical group commands (see Table 6) cannot be used. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 18.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- AddVirtualVolume Creates THP/Smart volumes and assigns THP/Smart volumes to a THP/Smart pool. Y Y -- -- DeleteArrayReservation Unlocks a specified storage system Y Y Y Y DeleteExternalArrayGroup Deletes an external parity group. Also, deletes the LUs that belong to the deleted external parity group. Y Y -- -- DeleteHostStorageDomain Deletes a host storage domain or host group. Y Y Y Y DeleteLabel Deletes a label.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- Obtains the execution status of a zero-page reclaim operation. Y Y -- -- ModifyArrayReservation Extends the maximum period for which a specified storage system is locked. Y Y Y Y ModifyExternalTierRank Modifies the external LDEV tier rank of the THP/Smart pool volume. Y -- -- -- ModifyLabel Modifies a label. Y Y Y Y ModifyLogicalUnit Modifies the settings of the logical units and the corresponding LDEVs.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y RefreshStorageArrays Refreshes the configuration information for all of the storage systems that are managed by the Device Manager server with the most recent information. Y Y Y Y RunZeroPageReclaim Releases unused capacity in THP/Smart volumes. Y Y -- -- ShrinkPool Shrinks a THP/Smart pool.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Deletes the path to a volume from the host. Y Y Y Y DeleteWWN Deletes a WWN from a port. Y Y Y Y DeleteWWNForHostStorageDomain Releases the security set to a LUN in the specified host storage domain. Y Y Y Y Command name Description AddWWNForHostStorageDomain Sets the security of a LUN in the host storage domain by assigning its WWN in the host storage domain.
Command name Description ModifyHostInfo Modifies host-based information about a LUN. ModifyVirtualizationServer Modifies information about a virtualization server. RefreshVirtualizationServer Refreshes information about a virtualization server.
Legend: Y: Indicates that the particular storage system can be used to execute the command. --: Indicates that it cannot be used to execute the command. Commands related to SMI-S Enabled storage systems Device Manager CLI supports functions that allow you to use, as external storage systems, storage systems (SMI-S Enabled storage systems) managed by an SMI-S provider. The table below lists and describes the supported functions and commands.
NOTE: • There are Admin, Modify, and View roles. The Admin role has the Admin, Modify, and View permissions, the Modify role has the Modify and View permissions, and the View role has the View permission. • For commands that change resource information (commands that perform operations such as Add, Modify, or Delete), a role that has the Modify or Admin permission is required for the target resources (the resources to be specified by parameter values and the resources whose information is to be updated).
Command name Role DeleteLabel Admin or Modify DeleteLogicalUnit Admin or Modify DeleteLUSE Admin or Modify DeletePool Admin or Modify DeleteStorageArray Admin#1 DeleteVirtualVolume Admin or Modify FormatLU Admin or Modify GetArrayReservation Admin or Modify GetPoolShrinkStatus Admin or Modify GetStorageArray Admin, Modify, or View GetTieredPoolStatus Admin or Modify GetZeroPageReclaimStatus Admin or Modify ModifyArrayReservation Admin or Modify ModifyExternalTierRank Admin or Mo
To you perform operations for SMI-S Enabled storage systems, All Resources must be assigned as a resource group.
All Resources must be assigned as a resource group. Table 16 Roles required to execute commands (server management commands) Command name Role AddURLLink Admin# or Modify# DeleteAlerts Admin or Modify DeleteURLLink Admin# or Modify# GetAlerts Admin, Modify, or View GetServerInfo Admin, Modify, or View GetURLLink Admin, Modify, or View # All Resources must be assigned as a resource group.
Item Description Related commands 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 will take effect automatically.
4 Command reference This chapter describes the syntax and parameters of Device Manager CLI commands with execution examples. Storage system commands The storage system commands can be used to register, modify, and delete storage system information. AddArrayReservation AddArrayReservation locks the target storage system. When changing the storage system configuration, use this command to lock the target storage system in order to avoid conflicts with other users' operations.
• DeleteLUSE • DeletePool • DeleteVirtualVolume • DeleteWWN • DeleteWWNForHostStorageDomain • FormatLU • ModifyArrayReservation • ModifyLogicalUnit • ModifyPool • ModifyPort • ModifyPortController • ModifyVirtualVolume • RunZeroPageReclaim • ShrinkPool Parameters Table 19 AddArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model
AddExternalArrayGroup AddExternalArrayGroup performs one-to-one mapping of external volumes (volumes in an externally connected storage system) to internal volumes, and then creates a parity group. AddExternalArrayGroup also creates an LU in the created external parity group. When you perform mapping, you can specify multiple paths (alternate paths). NOTE: • This command can be used only with P9500 and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-02-40-XX/XX or later.
Parameter name Status Description Port WWN of the external storage system If you specify multiple (alternate) paths, use a comma to separate each entry. externalwwn Required When specifying paths, the parameters portname, externalwwn, and externallun must all be specified as a set. The order in which they are specified dictates the path priority. (The first parameter in the set will become the primary path.) Make sure that the order and number of the values specified for these parameters are correct.
Parameter name Status Description Option information that determines whether logical units are to be created at the same time an external parity group is created Either of the following values can be specified: luoption Optional • none: No logical unit is created. • create: Logical units are created. If this parameter is omitted, none is set. Number of logical units to be created The only valid value is 1. numoflus Optional If this parameter is omitted, 1 is set.
externalwwn For external storage systems other than SMI-S Enabled storage systems, obtain this value from the execution results of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Then, select the port whose wwn value displayed below An instance of WWN matches the worldWidePortName value of the portname parameter. Then, for the externalwwn parameter, specify the worldWidePortName value of that port. At this time, record the portID value.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
sizeInKB=1,048,576 cylinders=0 fsControlIndex=0 List of 2 ExternalPathInfo elements: An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.50 externalLun=1 portID=13 pathGroupID=23 priority=1 An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.52 externalLun=0 portID=15 pathGroupID=23 priority=2 *****: The values are encoded by the CLI. AddHostStorageDomain AddHostStorageDomain adds a host storage domain.
Parameter name Status Description Domain ID of the host storage domain This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional The specifiable values depend on the storage system.
Parameter name Status Description Nickname of the host storage domain Specify the name used for the host group to be created in the storage system. If this parameter is omitted, it is set automatically. When adding a host storage domain, if you use the HostScan command to register a host in Device Manager, in the nickname parameter specify the name of the host that uses the host storage domain. For details about the HostScan command, see “HostScan” on page 267.
Storage system Value of hostmode • Standard • Sequent • HP • Solaris • Netware • Windows XP12000/ XP10000/SVS200 • Windows Extension • 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 • OPEN-VMS XP1024/XP128 The following value relies on the microcode version.
For details, see the documentation of the LUN management product for the storage system you are using. Table 23 Values that can be specified in the hostmodeoption parameter hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y Y Y Y P9500 VERITAS Database Edition/Advanced Cluster 2 Specify this value when using VERITAS Database Edition/Advanced Cluster for Real Application Clusters or VERITAS Cluster Server 4.0 or later (I/O fencing feature).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y -- -- Y Y Y Y Y Y Y P9500 SIM report at link failure 13 Specify this value when you want to get a SIM notification when the number of unsuccessful connections between ports exceeds a threshold. HP TruCluster with Continuous Access function Specify this value when both of the following conditions are satisfied: 14 • The host mode is set to Tru64 (mode 07).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 -- -- Y -- -- Y Y Y -- Y Y -- P9500 2TB or Larger LUN Support Specify this value when both of the following conditions are satisfied: • The host accesses a volume that exceeds 2 TB. • The host OS is one of the following: - AIX 5L Version 5.2 TL08 or later, or AIX 5L Version 5.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- Y Y -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- P9500 V-Vol expansion Specify this value when both of the following conditions are satisfied: 40 • The host mode is set to Windows (mode 0C) or Windows Extension (mode 2C). • After increasing the THP volume capacity, you want to force that capacity to be automatically recognized.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- Y -- -- P9500 Round Trip Set Up Option 51 Specify this value when you want to use Round Trip to improve True Copy performance. ESAM and Cluster Software for SCSI-2 Reserve 52 Specify this value when cluster software is used that uses SCSI-2 Reserve in a configuration that uses External Storage Availability Manager.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y -- -- Y -- -- P9500 Online LUSE expansion Specify this value when the expansion of the capacity of a LUSE volume is notified for a host. 69 Change the Unit Attention for Blocked Pool-VOLs Specify this value when a Unit Attention (UA) response for a closed pool volume is changed from NOT READY to MEDIUM ERROR.
Port for the subtarget parameter, and HostStorageDomain for the portsubinfo parameter. In the execution result of this command, the value of nickname appears as An instance of HostStorageDomain. Command execution example hdvmcli AddHostStorageDomain -o "D:\logs\AddHostStorageDomain.log" "serialnum=10037" "model=XP24000" "port=3" "domain=15" "hostmodeoption=7;40" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Parameter name Status Description Device number of the logical unit to which a label is to be added For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution result RESPONSE: An instance of ObjectLabel targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. AddLogicalUnit AddLogicalUnit creates an LDEV and LU. With P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, you can create multiple logical units at once. The LDEVs created by this command are formatted when they are created.
capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick#}] [capacitytype={KB|block}] When creating multiple logical units in bulk by specifying their capacity and number: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number |arraygroupname=parity-group-name} [fsindex=index-number-of-region-of-unused-capacity] creationoption=bulk capacity=capacit
Parameters Table 25 AddLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system where the LU is added model Required Model of the storage system where the LU is added Number of the chassis for the parity group where the LU is added If you specify this parameter, make sure that groupnum is also specified. chassis Optional Always specify either the chassis and groupnum parameters together, or the arraygroupname parameter by itself.
Parameter name Status Description LU creation method Specify a creation method for creating multiple LUs at once. One of the following values can be specified: • bulk: Creates LUs by specifying their capacity and number. Optional creationoption# (P9500, XP24000/XP20000, and XP12000/ XP10000/SVS200) If you specify bulk, also specify capacity and numoflus. • dividebynum: Creates LUs by specifying their number. If you specify dividebynum, also specify numoflus but do not specify capacity.
Parameter name Status Description Emulation type of the logical unit The following are the specifiable emulation types: • OPEN-3 • OPEN-8 • OPEN-9 • OPEN-E • OPEN-K • OPEN-V emulation Optional Specify the same emulation type as the parity group in which a logical unit is created. If no such emulation is present, parity group emulation is used. This parameter must be specified if the creationoption parameter is specified. In this case, OPEN-V is the only value you can specify.
Parameter name Status Description The unit for the value specified in the capacity parameter The values you can specify are KB or block. capacitytype Optional If this parameter is omitted, KB is set as the unit. block can be specified for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200 only. # For P9500 and XP24000/XP20000, if you do not specify the fsindex and creationoption parameters, you can optimize the regions of unused capacity to create an LU.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: • When you add a LUSE volume with the luseoption parameter set, specify a LDEV in which a path is set as the first LDEV. If a LDEV without a path set is specified as the first LDEV, an error will occur. • When a LUSE volume is added with the luseoption parameter set, the extended LUSE volume might not be able to be recognized, based on the host. In this case, restart the host.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. Command execution example hdvmcli AddLUSE -o "D:\logs\AddLUSE.log" "serialnum=15001" "model=XP1024" "devnums=1001,1002" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown
clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 *****: The values are encoded by the CLI. AddPool AddPool creates a THP/Smart pool in a targeted storage system. NOTE: • This command can be used only with P9500 and XP24000/XP20000.
• If more than one logical unit is specified for a THP/Smart pool, internal volumes and external volumes cannot be mixed together. • If more than one logical unit is specified for a THP/Smart pool, all of them must have the same RAID level. • If more than one internal volume is specified for a THP/Smart pool, up to three types of logical units with different drive types or rotational speeds can be used.
Format for P9500 hdvmcli [URL] AddPool [options] model=model serialnum=serial-number [poolid=pool-ID] [threshold=THP/Smart-pool-threshold-1] [threshold2=THP/Smart-pool-threshold-2] [threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] devnums=device-number-of-logical-unit [tiercontrol={enable|disable}] [automigration={enable|disable}] [migrationinterval={0|1|2|4|8|24}] [monitorstarttime=start-time-of-performance-monitor
Parameter name Status Description Threshold1 of the THP/Smart pool (%) The threshold1 of the THP/Smart pool is the usage rate of the THP/Smart pool. For P9500 whose microcode version is earlier than 70-014X-XX/XX: Specify a multiple of 5 in the range from 5 to 95. threshold Optional For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100. For XP24000/XP20000: Specify a multiple of 5 from 5 to 95.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#2 Specify a threshold value used to issue an advance warning. For P9500: overprovisioningwarning#1 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Optional If this parameter is omitted, -1 is set. -1 indicates that a threshold value is not set.
Parameter name Status Description Specify whether to create a Smart pool. Optional tiercontrol (P9500) One of the following values can be specified. • enable: Creates a Smart pool. • disable: Creates a THP pool. If this parameter is omitted, enable is set. Specify whether to automatically execute performance monitoring and hardware tier relocation. Optional automigration (P9500) If you specify this parameter, you must also specify tiercontrol=enable. One of the following values can be specified.
Parameter name Status Description Performance monitoring mode. If you specify this parameter, you must also specify tiercontrol=enable. Specifiable values vary, depending on the microcode version. Optional monitoringmode (P9500) If the microcode version is earlier than 70-02-XX-XX/XX: 0: Periodic If this parameter is omitted, 0 is set. If the microcode version is 70-02-XX-XX/XX or later: 0: Periodic 1: Continuous If this parameter is omitted, 1 is set.
hdvmcli AddPool -o "D:\logs\AddPool.log" model=P9500 serialnum=53039 poolid=5 threshold=75 devnums=00:07:CE Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sy
the configuration information). When you modify the registered information, you can modify the values other than the storage system type (whose parameter is family). When you execute the AddStorageArray command for SMI-S Enabled storage systems, note the following: • If one SMI-S provider manages multiple SMI-S Enabled storage systems, all of the SMI-S Enabled storage systems supported by Device Manager will be registered into the Device Manager server database at the same time.
Format for SMI-S Enabled storage systems When registering an SMI-S Enabled storage system: hdvmcli [URL] AddStorageArray [options] ipaddress={IP-address-of-SMI-S-provider|host-name-of-SMI-S-provider} family=SMI-S_Enabled displayfamily=SMI-S_Enabled userid=user-ID arraypasswd=user-password [protocol={Non-secure|Secure}] [portnumber=port-number-of-SMI-S-provider-service] When refreshing an SMI-S Enabled storage system: hdvmcli [URL] AddStorageArray [options] ipaddress={IP-address-of-SMI-S-provider|host-name-
Parameter name Status Description User ID For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: Specify the user ID used to access the storage system. userid# Required or optional You cannot omit this parameter when using the command to perform initial registration of information. However, you can omit this parameter when updating information, if you do not change the user ID. For an SMI-S Enabled storage system: Specify the user ID used to access the SMI-S provider.
# If P9000 Command View AE Suite products are used to manage copy groups defined in a device group, due to a RAID Manager limitation, be sure to specify character strings of 63 characters or less for userid and arraypasswd. Parameter values to obtain in advance family and displayfamily Obtain the values of these parameters from the execution results of the GetServerInfo command.
capacityInKB=4,025,592,720 freeCapacityInKB=2,442,665,520 allocatedCapacityInKB=1,578,120,480 autoLunCapacityInKB=4,806,720 onDemandCapacityInKB=0 totalFreeSpaceInKB=20,192,256 largestFreeSpaceInKB=3,796,992 multipathSupport=1 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayArrayType=XP1024 numberOfLUs=1,555 numberOfAllocatedLUs=565 numberOfUnallocatedLUs=990 slprStatus=-1 openTotalCapacity=4,025,592,720 openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoLu
AddTieredPoolOperation AddTieredPoolOperation manually monitors the performance of and relocates hardware tiers for a Smart pool. To check the execution status of the AddTieredPoolOperation command, use the GetTieredPoolStatus command. NOTE: • This command can be used only with P9500. • This command can be used only when the automatic execution of performance monitoring and hardware tier relocation for the target Smart pool is set to disable.
Parameter name Status Description Specify one of the following values: • startMonitor: Starts performance monitoring. • stopMonitor: Stops performance monitoring. operation Required • startRelocation: Starts hardware tier relocation. • stopRelocation: Stops hardware tier relocation. Specify stopRelocation when suspending hardware tier relocation performed by using the AddTieredPoolOperation command. List of pool IDs poolids Required Specify the pool ID of a Smart pool.
An instance of Pool objectID=***** poolFunction=5 poolID=1 controllerID=-1 poolType=32 status=20 threshold=70 threshold2=80 threshold2Mode=0 capacityInKB=319,678,464 freeCapacityInKB=319,678,464 usageRate=0 numberOfPoolVols=31 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=131 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monito
If you use the poolid parameter to specify the pool ID of a THP/Smart pool, the THP/Smart volumes that are created are assigned to that THP/Smart pool. For P9500 and XP24000/XP20000, AddVirtualVolume can be used to create a virtual parity group and populate it with THP/Smart volumes. For XP24000/XP20000, AddVirtualVolume can be used to create THP volumes in an existing virtual parity group.
• The number of THP/Smart volumes that you can create in a single virtual parity group • The number of THP/Smart volumes that you can assign to a single THP/Smart pool • The number of virtual parity groups that you can create under a single disk controller Format for P9500 hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-THP/Smart-volumes [numoflus=number-of-THP/Smart-volumes] [devnum=device-number-of-logical-unit] poolid=pool-ID-of-THP/Smart-pool Format fo
Parameters Table 30 AddVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Specifies whether to create THP volumes within an existing virtual parity group. Optional groupoption (XP24000/XP20000) Specify exist to create the THP volumes in an existing virtual parity group. If you specify this parameter, you must also specify the arraygroupname parameter.
Parameter name Status Description CLPR number clprNumber Optional If this parameter is omitted, 0 is set. (XP24000/XP20000) For XP24000/XP20000, if the poolid parameter has been specified, the CLPR number of the THP pool identified by the pool ID is set. Pool ID of a THP/Smart pool poolid Optional Specify the pool ID of the THP/Smart pool to which to assign the THP/Smart volumes to be created. For P9500, always specify this poolid parameter.
model=XP24000 serialnum=15065 arraygroupname=X200-1 capacity=209715200 numoflus=2 devnum=00:30:00 poolid=0 threshold=10 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
protectionLevel=-1 thpPoolID=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeTy
slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 An instance of LogicalUnit objectID=***** devNum=12,289 displayName=00:30:01 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 com
sizeInKB=209,715,200 lba=419,430,400 raidType=substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypt
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli DeleteArrayReservation -o "D:\logs\DeleteArrayReservation.
Obtain these values from the execution result of the GetStorageArray command. For the storage system where you want to delete an external parity group, specify either an arrayType value or a displayArrayType value for the model parameter. Use the serialNumber value to specify the serialnum parameter. arraygroupnames Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command. In the execution result of this command, displayName appears under An instance of ArrayGroup.
Parameter name Status Description The domain ID of the host storage domain to delete This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional Do not specify 0. A host storage domain whose domain ID is 0 cannot be deleted. You must specify either domain or domainnickname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
"serialnum=10001" "model=XP1024" "port=16" "domain=1" "deletionoption=lusekeep" Command execution result RESPONSE: (Command completed; no data returned) DeleteLabel DeleteLabel deletes a label from a logical unit.
Command execution example hdvmcli DeleteLabel -o "D:\logs\DeleteLabel.log" "serialnum=10037" "model=XP24000" "devnums=00:00:00,00:00:01" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLogicalUnit DeleteLogicalUnit deletes the LU and corresponding LDEV from the storage device. With P9500, XP24000/XP20000, and XP12000/XP10000/SVS200, you can delete multiple logical units at once.
Parameter name Status Description Device number of the LU For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution example hdvmcli DeleteLogicalUnit -o "D:\logs\DeleteLogicalUnit.log" "serialnum=10001" "model=XP12000" "devnum=1" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLUSE DeleteLUSE deletes a LUSE volume on a storage system.
isComposite=1 and path=false indicates that it is a LUSE volume that does not have a path. In the execution result of this command, the devNum value of the relevant logical unit appears under An instance of LogicalUnit. Use this devNum value to specify the devnum parameter. Command execution example hdvmcli DeleteLUSE -o "D:\logs\DeleteLUSE.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter. Command execution example In this example, the DeletePool command deletes the THP pool whose pool ID is 0 (poolid: 0) from the storage system (serialnum: 15065, model: XP24000). hdvmcli DeletePool -o "D:\logs\DeletePool.
Parameters Table 38 DeleteStorageArray command parameters Parameter name Status Description Serial number of the storage system to delete serialnum # Optional You cannot specify this parameter if you are deleting an SMI-S Enabled storage system. Model of the storage system to delete # model Optional saobjid Optional# You cannot specify this parameter if you are deleting an SMI-S Enabled storage system.
NOTE: This command can be used only with P9500 and XP24000/XP20000. For P9500 and XP24000/XP20000, to delete a THP/Smart volume, the following conditions must be satisfied: • The THP/Smart volume does not have any paths. • To delete specified THP/Smart volumes, Open Volume Management must be installed in the storage system. • The THP/Smart volume has a guard mode of Read/Write.
hdvmcli [URL] DeleteVirtualVolume [options] model=model serialnum=serial-number [deletionoption=force] devnums=device-number-of-THP-volume # If the microcode version is 60-04-XX-XX/XX or later and the system option 726 is set to ON, you cannot specify this format. If you specify this format, an error will occur.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. Command execution example In this example, the DeleteVirtualVolume command deletes the virtual parity group (arraygroupnames: X200-1) containing THP volumes from the storage system (serialnum: 15065, model: XP24000). In addition, this command also deletes THP volumes whose assignations with THP pools have not been released by specifying force for the deletionoption parameter.
Parameters Table 40 FormatLU command parameters Parameter name Status Description serialnum Required Serial number of the storage system of the LU to be formatted model Required Model of the storage system of the LU to be formatted List of the device numbers of the LUs to be formatted For 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.
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.
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= isStandardLDEV=false guardMode= diskType=0 slprNumb
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 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of L
systemDisk=0 encrypted=0 tieringPolicy=-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.
NOTE: • This command can be used only with 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.
objectID=***** poolFunction=5 poolID=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 monitorStartTime=00:00 moni
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 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=1,547 displayName=00:06:0B emulation
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) .
objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1
NOTE: When you execute the GetStorageArray command with the subtarget parameter specified and without the model and serialnum parameters specified, if a value other than 0 is specified for statusOfDBInconsistency (which is displayed under An instance of StorageArray as the result of the GetStorageArray command), information of the component specified for the subtarget parameter might not be output to the command output.
Value of subtarget Information that can be acquired Location MFReplicationInfo Information about copy pairs consisting of mainframe volumes GetStorageArray (subtarget=MFReplicationInfo) , page 155 Path Information about paths GetStorageArray (subtarget=Path) , page 159 PDEV Information about PDEVs GetStorageArray (subtarget=PDEV) , page 163 Information about pools GetStorageArray (subtarget=Pool) , page 165 Pool (for Snapshot, Fast Snap, Continuous Access Journal Software, or Thin Provisionin
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information LDEV ldevsubinfo VolumeConnection: Mapping information of external volumes for LDEVs The following information about logical units can be acquired: • LDEV: LDEV information lusubinfo • Path: Path information • VolumeConnection: Mapping information of external volumes for LDEVs Specify Path for the parameter lusubinfo when using this parameter.
The following table shows examples of specifying the parameter subtarget and the subinfo parameters.
Parameters Table 45 GetStorageArray (subtarget not specified) command parameters Parameter name Status Description Serial number of the storage system serialnum # Optional You cannot specify this parameter if you are obtaining information about a particular SMI-S Enabled storage system. Model of the storage system # model Optional saobjid Optional# You cannot specify this parameter if you are obtaining information about a particular SMI-S Enabled storage system.
productName=RAID600 controllerVersion=60-06-21-00/00 numberOfControllers=2 capacityInGB=6,617 cacheInMB=65,536 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=3,765 allocatedCapacityInGB=2,851 autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,438 largestFreeSpaceInGB=466 capacityInKB=6,938,910,203 freeCapacityInKB=3,948,652,130 allocatedCapacityInKB=2,990,258,073 autoLunCapacityInKB=0 onDemandCapacityInKB=0 totalFreeSpaceInKB=3,605,150,982 largestFreeSpaceInKB=489,664,512 multipa
openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ArrayGroup) GetStorageArray (subtarget=ArrayGroup) obtains information about parity groups. Parameters Table 46 GetStorageArray (subtarget=ArrayGroup) command parameters Parameter name Status Description subtarget Required Specify ArrayGroup.
Parameter name Status Description Starting sequence number of parity groups for which information is to be obtained Specify this parameter when you want to obtain information for a part of parity groups in a specific storage system. startElementNumFilter Optional When parity group information is ordered as shown below and numbered from 0 upward, specify the first number in the sequence of parity groups that you want to obtain. Order of parity groups: 1. Chassis numbers in ascending order 2.
Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
*****: The value is encoded by the CLI. Command execution example 2 In this example, the GetStorageArray (subtarget=ArrayGroup) command obtains information only about one parity group (object ID: *****) in a storage system (serial number: 10001, model: XP1024). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_ArrayGroup.log" subtarget=ArrayGroup model=XP1024 serialnum=10001 objectid=***** *****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . .
mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=192,256,560 openUnallocatedCapacity=17,382,240 openUnallocatedActualCapacity=17,382,240 openReservedCapacity=0 openReservedActualCapacity=0 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 *****: The value is encoded by the CLI.
Parameter name Status Description model Optional# Model of the storage system You cannot specify this parameter if you are obtaining information about a particular SMI-S Enabled storage system. Object ID of the SMI-S Enabled storage system saobjid # Optional Specify the object ID obtained from another CLI response. The value is encoded by the CLI. # Do not set saobjid together with serialnum and model. Doing so will result in an error.
Parameters Table 48 GetStorageArray (subtarget=Component) command parameters Parameter name Status Description subtarget Required Specify Component. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,438 largestFreeSpaceInGB=466 capacityInKB=6,938,910,203 freeCapacityInKB=3,948,652,130 allocatedCapacityInKB=2,990,258,073 autoLunCapacityInKB=0 onDemandCapacityInKB=0 totalFreeSpaceInKB=3,605,150,982 largestFreeSpaceInKB=489,664,512 multipathSupport=1 securityStatus=2 sequenceNumber=10007 displayArrayFamily=R600 displayArrayType=R600 numberOfLUs=3,412 numberOfAllocatedLUs=1,739 numberOfUnallocatedLUs=1,671 slprStatus=0 openTotalCapacity=6,52
description=Moderate An instance of Component name=DKC Cache value=1 description=Normal An instance of Component name=DKC Cache Switch value=1 description=Normal An instance of Component name=DKC Environment value=3 description=Serious An instance of Component name=DKC Fan value=1 description=Normal An instance of Component name=DKC Power Supply value=1 description=Normal An instance of Component name=DKC Processor value=4 description=Moderate An instance of Component name=DKC Shared Memory value=1 descript
Parameters Table 49 GetStorageArray (subtarget=ExternalStorage) command parameters Parameter name Status Description subtarget Required Specify ExternalStorage. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameters Table 50 GetStorageArray (subtarget=Filter) command parameters Parameter name Status Description subtarget Required Specify Filter. Object ID for a component (such as a path, port, or logical unit) of the storage system objectid Required Information is displayed about the storage system for the component identified by the object ID you specify with this parameter. Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
capacityInKB=4,025,592,720 freeCapacityInKB=2,442,665,520 allocatedCapacityInKB=1,578,120,480 autoLunCapacityInKB=4,806,720 onDemandCapacityInKB=0 totalFreeSpaceInKB=20,192,256 largestFreeSpaceInKB=3,796,992 multipathSupport=1 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayArrayType==XP1024 numberOfLUs=1,555 numberOfAllocatedLUs=565 numberOfUnallocatedLUs=990 slprStatus=-1 openTotalCapacity=4,025,592,720 openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoL
Parameters Table 51 GetStorageArray (subtarget=FreeSpace) command parameters Parameter name Status Description subtarget Required Specify FreeSpace. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Command execution example 1 In this example, the GetStorageArray (subtarget=FreeSpace) command obtains information about the unused capacity in a storage system (serial number: 14010, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_FreeSpace.log" subtarget=FreeSpace model=XP12000 serialnum=14010 Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=***** sizeInKB=1,847,952 cylinders=0 fsControlIndex=85 . . (repeated for other ArrayGroup instances) . *****: The values are encoded by the CLI.
totalFreeSpace=1,492,992 largestFreeSpace=1,492,992 substance=0 slprNumber=-1 clprNumber=-1 openTotalCapacity=211,531,680 openAllocatedCapacity=134,588,160 openFreeCapacity=76,943,520 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=134,588,160 openUnallocatedCapacity=76,943,520 openU
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Domain ID of the host storage domain If you omit this parameter, all the host storage domains become the target. If you specify this parameter, you must also specify the model and serialnum parameters. This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix.
Parameter name Status Description Starting sequence number of host storage domains for which information is to be obtained Specify this parameter when you want to obtain information for a part of host storage domains for a specific storage system. startElementNumFilter Optional When host storage domain information is ordered as shown below and numbered from 0 upward, specify the first number in the sequence of host storage domains that you want to obtain. Order of host storage domains: 1.
Command execution example In this example, the GetStorageArray (subtarget=HostStorageDomain) command obtains information about a host storage domain (port number: 3, domain ID: 1) in a storage system (serial number: 10001, model: XP1024). The information includes information about the paths, WWNs, and unused LUNs in the host storage domain. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_HostStorageDomain.
GetStorageArray (subtarget=LDEV) GetStorageArray (subtarget=LDEV) obtains the information about LDEVs. Parameters Table 53 GetStorageArray (subtarget=LDEV) command parameters Parameter name Status Description subtarget Required Specify LDEV. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Starting sequence number of logical devices for which information is to be obtained Specify this parameter when you want to obtain information for a part of logical devices in a specific storage system. startElementNumFilter Optional When logical device information is ordered by device number (in ascending order) from 0, specify the first number in the sequence of logical devices that you want to obtain.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LDEV.log" subtarget=LDEV model=XP12000 serialnum=10001 devnum=0 "ldevsubinfo=VolumeConnection" "ldevfilter=open" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
mappedSerialNumber=10001 mappedDevNum=0 displayMappedDevNum=00:00 externalArrayType=XP12000 externalSerialNumber=10002 externalDevNum=150 displayExternalDevNum=00:96 externalVolumeName=0096 productName=12000 vendor=HP *****: The values are encoded by the CLI. GetStorageArray (subtarget=LogicalDKC) GetStorageArray (subtarget=LogicalDKC) obtains the information about the logical DKC in one or all storage systems.
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP24000 @10.208.115.221 description=XP24000 (12345) at 10.208.115.
numberOfImUnallocatedLUs=14 numberOfMfLDEVs=327 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,176,711,367 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=0 openAllocatedActualCapacity=663,807,296 openUnallocatedCapacity=7,227,624,640 openUnallocatedActualCapacity=6,090,395,200 openReservedCapacity=254,005,440 openReservedActualCapacity=254,005,440 numberOfReservedLUs=41 numberOfOpenReservedLUs=41 numberOfImReservedLUs=0 distributedMode=-1 List of 1 Logical
Parameter name Status Description Filter for selecting a logical unit Available values are ALL, ASSIGNED, FREE, UNASSIGNED, and RESERVED. If you omit this parameter or specify ALL, you will obtain information about all the logical units. If you specify ASSIGNED, you will obtain the information about the logical units that have a LUN assigned. lufilter Optional If you specify FREE, you will obtain the information about logical units that do not have a LUN assigned.
Parameter name Status Description Filter for selecting a THP/Smart volume Specify either the pool ID of a THP/Smart pool, or Unassigned. If you specify the pool ID of a THP/Smart pool, information about the THP/Smart volumes assigned to that THP/Smart pool is obtained. thpvolfilter Optional If you specify Unassigned, information about THP/Smart volumes not assigned to a THP/Smart pool is obtained. This information cannot be obtained by the partitioned storage administrator.
Parameter name Status Description Label name of logical units for which information is to be obtained label Optional Specify this parameter to obtain information about logical units for which a specific label is specified. You can specify only one label. If you specify this parameter, you must also specify lusubinfo=LDEV. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-1-17 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=1 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControl
chassis=1 arrayGroup=16 arrayGroupName=1-1-17 path=true onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 List of 1 VolumeConnection elements: An instance of Volum
NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes. • For XP24000/XP20000, if there is information about copy pairs consisting of mainframe volumes, microcode version 60-01-6X-XX/XX or later is required. Parameters Table 56 GetStorageArray (subtarget=MFReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify MFReplicationInfo.
Parameter name Status Description Number of mainframe-volume copy pair information items to be obtained. numOfElementsFilter Optional Specify this parameter to obtain information for copy pairs of some mainframe volumes from a specific storage system. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
displaySvolDevNum=00:0D:05 svolObjectID=***** svolPoolID=-1 replicationFunction=ShadowImageForMF status=1 muNumber=3 List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=3,332 displayName=00:0D:04 emulation=3390-3 cylinders=3,339 isComposite=0 sizeInKB=2,904,930 lba=5,809,860 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=58 chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cac
arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=1 status=Normal thpType=-1 consumedSizeInKB=2,904,930 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=S-VOL mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 *****: The values are encoded by the CLI.
Parameter name Status pathsubinfo Optional Description Specific information about the path The values you can specify are HostInfo and WWN. If you specify multiple values at the same time, separate the values by commas. Starting sequence number of paths for which information is to be obtained Specify this parameter when you want to obtain information for a part of paths for a specific storage system.
Parameter name Status Description Nickname of the host storage domain domainnickname Optional Specify this parameter to acquire information about a particular path. When you specify this parameter, you must also specify the model and serialnum parameters, either the portname or port parameter and the devnum parameter. Do not specify this parameter together with the domain parameter. If they are specified at the same time, an error will occur.
Command execution example 1 (when the objectid parameter is not specified) In this example, the GetStorageArray (subtarget=Path) command obtains information about paths to a storage system (serial number: 10001, model: XP1024). The information includes information about the WWNs of these paths and the host. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Path.log" subtarget=Path model=XP1024 serialnum=10001 pathsubinfo=WWN,HostInfo Command execution result 1 RESPONSE: An instance of StorageArray . .
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). The information includes information about the WWNs of this path and the host. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Path.
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. Object ID of the parity group containing the PDEVs to be returned arraygroupobjid Optional Specify this parameter when you want to obtain information about the PDEVs in a specific parity group.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_PDEV.log" subtarget=PDEV model=XP1024 serialnum=10001 pdevid=1 arraygroupobjid=***** *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 ArrayGroup elements: . . (Attributes of ArrayGroup are omitted here) .
NOTE: • When SLPR functionality is used in XP24000/XP20000 or XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain information about the pool even if he or she registers the storage system (SLPR) as a target to be managed by Device Manager. • Information about a journal volume to be stored in the pool appears as the LogicalUnit instance. This information can be obtained only when a journal volume is an open volume.
Parameter name Status Description Pool ID of the pool poolid Optional If the model or serialnum parameter is omitted, the specification for this parameter becomes invalid. You must specify the poolid and poolfunction parameters together. If the poolfunction parameter is omitted, the specification for this parameter becomes invalid. Information about the pool poolsubinfo Optional The values you can specify are LDEV, LogicalUnit, PairedPool, PoolTier, and ReplicationInfo.
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 Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. In the execution result of this command, the clprNumber value appears under An instance of LDEV. Use this value to specify the clprfilter parameter.
monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,024 displayName=0B:D0 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=
commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=0 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1
thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,033 displayPvolDevNum=0B:D9 pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053 svolArrayType=Unknown svolDevNum=3,033 displaySvolDevNum=0B:D9 svolPoolID=1 replicationFunction=ContinuousAccessJournal st
commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 mana
Parameter name Status Description Number of the port of the storage system port Optional Specify this parameter when you want to obtain information about a specific port. 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. Do not specify port and portname at the same time. If they are specified at the same time, an error will occur.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Port.log" subtarget=Port model=XP24000 serialnum=10007 port=9 portsubinfo=WWN,HostStorageDomain Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Port elements: An instance of Port objectID=***** portID=9 portType=Fibre fibreAddress=CC topology=Fabric(off), FC-AL displayName=CL3-E lunSecurityEnabled=true controllerID=2 worldWidePortName=50.06.0E.80.05.27.17.
GetStorageArray (subtarget=PortController) GetStorageArray (subtarget=PortController) obtains the information about port controllers. Parameters Table 61 GetStorageArray (subtarget=PortController) command parameters Parameter name Status Description subtarget Required Specify PortController. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target.
controllernum 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 the value for subtarget=PortController. In the execution result of this command, the controllerID value appears under An instance of PortController. Use this controllerID value to specify the controllernum parameter.
Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ReplicationInfo) GetStorageArray (subtarget=ReplicationInfo) obtains information about copy pairs.
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.
Command execution example hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_ReplicationInfo.log" subtarget=ReplicationInfo model=XP1024 serialnum=10001 replicationsubinfo=LogicalUnit Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
continuousAccessVolumeType=Simplex businessCopyVolumeType=P-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 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=101 displayName=00:65 emulation=OPEN-3 devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0
GetStorageArray (subtarget=TieringPolicy) GetStorageArray (subtarget=TieringPolicy) obtains information about tiering policies that can be applied to Smart volumes of P9500. NOTE: If the microcode version of P9500 is not 70-05-XX-XX/XX or later, some attributes cannot output valid values. For details about output items, see “TieringPolicy instance” on page 380.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_TieringPolicy.log" subtarget=TieringPolicy model=P9500 serialnum=53039 policyid=10 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 TieringPolicy elements: An instance of TieringPolicy objectID=***** policyID=10 allocationThresholdT1Max=50 allocationThresholdT1Min=20 allocationThresholdT3Max=40 allocationThresholdT3Min=10 numberOfVVols=4 *****: The values are encoded by the CLI.
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.
externalMixCompatible=disable monitoringState=1 lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationProgress=-1 numberOfTiers=1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 *****: The value is encoded by the CLI.
Command execution example In this example, the GetZeroPageReclaimStatus command is used to check whether a zero-page reclaim operation on the THP volumes specified in the RunZeroPageReclaim command has finished. hdvmcli GetZeroPageReclaimStatus -o "D:\logs\GetZeroPageReclaimStatus.log" model=XP24000 serialnum=10007 devnums=06:AC Command execution result 1 This execution result indicates that the zero-page reclaim operation has not finished, because LogicalUnit instances are displayed.
Command execution result 2 This execution result indicates that the zero-page reclaim operation has finished, because no LogicalUnit instances are displayed. RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . ModifyArrayReservation ModifyArrayReservation extends the interval before the target storage system is unlocked.
ModifyExternalTierRank The ModifyExternalTierRank command changes the external LDEV tier rank, if the THP/Smart pool volume is an external volume. NOTE: This command can only be used with P9500 with a microcode version of 70-04-00-00/00 or later.
You need to specify at least one of the following parameters: highdevnums, middledevnums, or lowdevnums. 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.
emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,784 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=121 arrayGroup=5 arrayGroupName=E21-6 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=1 consumedCapacityInKB=10,486,784
Parameter name Status Description model Required Model of the storage system Device number of the logical unit For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
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.
# For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, if you change an LU for which security is enabled to a command device, always specify both the commanddevice and commanddevicesecurity parameters. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
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 *****: The value is encoded by the CLI. ModifyPool ModifyPool expands a THP/Smart pool or changes the settings related to the THP/Smart pool. NOTE: • This command can be used only with P9500 and XP24000/XP20000.
[automigration={enable|disable}] [migrationinterval={0|1|2|4|8|24}] [monitorstarttime=start-time-of-performance-monitoring] [monitorendtime=end-time-of-performance-monitoring] [monitoringmode={0|1}] When changing only the settings related to the THP/Smart pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID [threshold=THP/Smart-pool-threshold-1] [threshold2=THP/Smart-pool-threshold-2] [threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold]
Parameter name Status Description Threshold1 of the THP/Smart pool (%) The threshold1 of the THP/Smart pool is the usage rate of the THP/Smart pool. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: threshold#1, #2 Optional Specify a multiple of 5 in the range from 5 to 95. For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: overprovision#1, #2, ingwarning Optional #3 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Specify -1 to cancel an already set threshold value. For XP24000/XP20000: Specify an integer from 10 to 1000.
Parameter name Status Description Specify whether to automatically execute performance monitoring and hardware tier relocation. If you specify this parameter, you must also specify tiercontrol=enable. automigra#1, #5 tion Optional (P9500) This parameter can be specified when tiercontrol is set to enable. One of the following values fsindexcan be specified. • enable: Performs automatic execution. • disable: Does not perform automatic execution.
For P9500, you need to specify at least one of the following parameters: threshold, threshold2, threshold2mode, overprovisioningwarning, overprovisioninglimit, adddevnums, tiercontrol, automigration, migrationinterval, monitorstarttime, monitorendtime, or monitoringmode. #2 For XP24000/XP20000, you need to specify at least one of the following parameters: threshold, overprovisioningwarning, overprovisioninglimit, or adddevnums.
hdvmcli ModifyPool -o "D:\logs\ModifyPool.log" model=P9500 serialnum=53039 poolid=5 adddevnums=00:07:CF Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 co
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 *****: The values are encoded by the CLI. ModifyPort ModifyPort modifies port attributes and host storage domain attributes.
[nickname={new-host-storage-domain-name|existing-host-storage-domain-name}] [newdomainnickname=new-host-storage-domain-name]] [hostmode=host-mode-for-port] [hostmodeoption=host-mode-option-list] [wwn=WWN wwnnickname=WWN nickname] [wwn=WWN newwwnnickname=new-WWN-nickname] [wwnnickname=WWN-nickname newwwnnickname=new-WWN-nickname] NOTE: 8 Gbps can be specified only for P9500 or XP24000/XP20000.
Parameter name Status Description Number of the port port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name portname 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 will occur. New topology value for the port Possible values are as follows.
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 nickname Optional A nickname cannot begin or end with spaces.
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. wwn 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 wwnnickname or newwwnnickname parameter. You must specify the same number of values for each parameter.
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.
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.
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.
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.
hdvmcli [URL] ModifyStorageArray [options] saobjid=object-ID-of-SMI-S-Enabled-storage-system name=new-storage-system-name Parameters Table 73 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.
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600#1 description=R600 (10007) at 10.208.115.
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is e
Parameter name Status Description Maximum allocation threshold value (%) for Tier 1 allocationthresholdt1max#1 Optional#2 Specify the maximum capacity threshold value to be allocated for Tier 1 of virtual volumes to which the tiering policy has been applied. You can specify 0 or a multiple of 10, in the range from 0 to 100.
• Changes the maximum allocation threshold for Tier 3 to 40 (allocationthresholdt3max: 40) • Changes the minimum allocation threshold for Tier 3 to 10 (allocationthresholdt3min: 10) hdvmcli ModifyTieringPolicy model=P9500 serialnum=53039 allocationthresholdt1max=50 allocationthresholdt3max=40 -o "D:\logs\ModifyTieringPolicy.log" policyid=10 allocationthresholdt1min=20 allocationthresholdt3min=10 Command execution result RESPONSE: An instance of StorageArray . .
• If you are assigning a THP volume to a THP pool, the status of the THP pool must not be Blocked. • If you are assigning a THP pool, the over-provisioning percent must be less than the over provisioning limit threshold. • If you are releasing a THP volume from a THP pool, or if you are only changing the threshold value, the THP volume must already be assigned to a THP pool. • If you are releasing a THP volume from a THP pool, it must not have a path.
hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=false devnums=device-number-of-THP-volume When the command is used to change the usage rate threshold of THP volumes: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-THP-volume threshold=usage-rate-threshold-of-THP-volumes Parameters Table 75 ModifyVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the stora
Parameter name Status Description Tiering policy to be applied to Smart volumes.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums 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.
thpPoolID=0 threshold=15 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 *****: The value is encoded by the CLI. Command execution example 2 In this example, the ModifyVirtualVolume command changes the tiering policy for Smart volumes to level 1. hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=P9500 serialnum=15000 devnums=00:00:C4 tieringpolicy=1 Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=-1 systemDisk=0 encrypted=-1 thpTier0ConsumedCapacityInKB=0 thpTier1ConsumedCapacityInKB=0 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=enable *****: The value is encoded by the CLI.
chassis=16,486 arrayGroup=99 arrayGroupName=X2148-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=-1 systemDisk=0 encrypted=-1 thpTier0ConsumedCapacityInKB=0 thpTier1ConsumedCapacityInKB=0 thpTier2
hdvmcli [URL] RefreshPerformanceData [options] option=all Parameters Table 76 RefreshPerformanceData command parameter Parameter name Status Description serialnum Optional# Serial number of the storage system model Optional# Model of the storage system option # Optional Parameter used to refresh performance information for all storage systems The value you can specify is all, which is not case-sensitive. # Always specify either the serialnum and model parameters together, or option=all.
Execute this command regularly to keep the Device Manager server database up to date. For storage systems that are managed by Device Manager, configuration information that is created or modified from the Remote Console, Remote Web Console, or RAID Manager is added to or updated in the Device Manager server database each time this command is executed. NOTE: To specify a storage system and then refresh its configuration information, use the AddStorageArray command.
largest numberOfLUs and numberOfMfLDEVs values when added together and plug those values into the following formula to calculate the value to specify for maxldevs: (numberOfLUs + numberOfMfLDEVs) x number-of-storage-systems-to-refreshin-parallel Command execution example hdvmcli RefreshStorageArrays -o "D:\logs\RefreshStorageArrays.log" "interval=1440" Command execution result RESPONSE: [An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: This command can be used only with P9500 and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-07-00-XX/XX or later.
An instance of LogicalUnit objectID=***** devNum=1,708 displayName=00:06:AC emulation=OPEN-V devCount=1 devType= capacityInKB=1,049,280 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=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
Parameters Table 79 ShrinkPool command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system poolid Required Pool ID Specify the pool ID of the THP/Smart pool to be shrunk. Device number of the logical unit(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number.
hdvmcli ShrinkPool -o "D:\logs\ShrinkPool.log" model=P9500 serialnum=53039 poolid=1 devnums=00:06:0B Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex s
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. Logical group commands The logical group commands can be used to obtain logical group information. When using the Core CLI/SMI-S license, you cannot use the logical group commands.
Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetLogicalGroup command. In the execution result of this command, the objectID value appears under An instance of LogicalGroup. Use this objectID value to specify the objectid parameter. logicalpath Obtain this value from the execution result of the GetLogicalGroup command. In the execution result of this command, the logicalPath value appears under An instance of LogicalGroup.
Command execution example 2 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=path" *****: The value is encoded by the CLI.
capacity=2 capacityInKB=2,098,560 realCapacityInKB=2,098,560 percentUsed=0 numberOfLUNs=1 resourceType=2 specificationType=0 . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. LUN commands The LUN commands can be used to manage LUN groups, set up WWNs, and set paths from a host to a volume. AddLun AddLun sets paths from a host to a volume. A LUN expanded (LUSE) logical unit can be specified when the path is set.
Parameters Table 81 AddLun command parameters Parameter name Status Description serialnum Required Serial number of the new path's storage system model Required Model of the new path's storage system Name of the new path Optional name 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. Port number of the new path Optional port Specify either port or portname. Do not specify both parameters at the same time.
Parameter name Status Description Device number used to identify the new path (not provided when a LUSE is defined) For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
ageDomain. Use these portID values to specify the port parameter. Use the domainID value to specify the domain parameter, or use the nickname value to specify the domainnickname parameter. For the lun parameter, specify one of the lun values that appear under An instance of FreeLUN. portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port.
displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown
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 *****: The values are encoded by the CLI. Command execution example 2 hdvmcli AddLun -o "D:\logs\AddLun.
NOTE: When security is set for a host storage domain, the LUN security setting of a port to which the host storage domain belongs is automatically enabled. Make sure that the I/Os of the target port are stopped.
Parameter name Status Description Comma-separated list of WWNs to secure the host storage domain Required wwn If you use the HostScan command to register a host in Device Manager, every WWN that you specify in the wwn parameter must be a WWN used by that host only. In this case, the value specified for the domainnickname parameter is used as the name of the host. For details about the HostScan command, see “HostScan” on page 267.
serialnum parameters, Port for the subtarget parameter, and WWN for the portsubinfo parameter. In the execution result of this command, the wwn value appears under An instance of WWN. Use this wwn value to specify the wwn parameter. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter.
Parameters Table 83 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 will occur. Port name of the path portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port, domain, and devnum Obtain these values from the execution result of the GetStorageArray (subtarget=Path) command. Execute this command by specifying only the model and serialnum parameters, and Path for the subtarget parameter.
Parameter name Status Description Port name portname Optional wwn Required Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. WWN to delete from the port Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 85 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 will occur.
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.
Manager agents produce HostInfo records, they can be manually created by these commands. Some commands require a host's server-generated object ID. AddHost AddHost adds information about a host server to the Device Manager server. NOTE: This command does not support virtualization servers. To register a virtualization server, use the AddVirtualizationServer command.
An instance of Host objectID=***** name=toro2 hostID=279 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddHostInfo AddHostInfo adds host-based information about a LUN (information about storage used by hosts). NOTE: This command does not support virtualization servers.
Parameter name Status Description Device number of the path For P9500 and XP24000/XP20000: devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
• HostInfo record name: MY_HOSTINFO_XP1024 • Host IP address: 172.16.64.159 • Mount point: C: • File system type: NTFS • File name: C: • SCSI bus number: 0 • Host LUN: 1 • HBA WWN: 11.22.33.44.55.66.77.88 • LUN size: 10MB • LUN in use: 10% hdvmcli AddHostInfo -o "D:\logs\AddHostInfo.log" serialnum=10001 model=XP1024 hostname=MY_HOSTINFO_XP1024 ipaddress=172.16.64.159 mountpoint=C: port=7 domain=0 devnum=2 osscsibus=0 osscsiid=15 oslun=1 portwwn=11.22.33.44.55.66.77.
NOTE: • This command does not support virtualization servers. To refresh the information of a virtualization server, use the RefreshVirtualizationServer command. • If the copy pair management host is unable to recognize a copy pair that was created on a host that is not the copy pair management host, the copy status of that copy pair cannot be refreshed even if the AddHostRefresh command is executed.
hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of Host objectID=***** name=rise hostID=5 ipAddress=192.168.32.164 capacityInKB=0 hostType=-1 statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database.
Format When registering information about a virtualization server: hdvmcli [URL] AddVirtualizationServer [options] ipaddress=IP-address hosttype=3 hostprotocol={Secure|Non-secure} hostuserid=user-ID hostuserpassword=user-password Parameters Table 89 AddVirtualizationServer command parameters Parameter name Status Description IP address ipaddress Required Specify the IP address of the virtualization-server management program. You can specify an IPv4 or IPv6 IP address.
Command execution result RESPONSE: An instance of Host objectID=***** name=boss.boss1 hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.114 portNumber=5989 protocol=Secure userID=vi-admin An instance of Host objectID=***** name=boss.boss2 hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.
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 will occur. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetHost command. In the execution result of this command, the objectID value appears under An instance of Host. Use this objectID value to specify the objectid parameter. hostname Obtain this value from the execution result of the GetHost command.
Obtain this value from the execution result of the GetHostInfo command. In the execution result of this command, the objectID value appears under An instance of HostInfo. Use this objectID value to specify the objectid parameter. Command execution example hdvmcli DeleteHostInfo -o "D:\logs\DeleteHostInfo.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE (Command completed; no data returned) GetHost GetHost returns the information about hosts.
Parameters Table 92 GetHost command parameters Parameter name Status Description Object ID of the host to return Omit this parameter to include all hosts. objectid Optional Do not specify the hostname and hostfilter parameter at the same time. If they are specified at the same time, an error will occur. Name of the host to obtain information about Omit this parameter to include all hosts. hostname Optional Do not specify the objectid and hostfilter parameter at the same time.
Parameter name Status Description Specify this parameter if you want to obtain information about an element in addition to information about the host. You can specify the following values: • CommParameters: CommParameters instance subtarget Optional If you specify this value for a virtualization server that uses Host Data Collector as the virtualization-server management program, the CommParameters instance is not displayed.
Command execution result 1 RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 statusOfDBUpdating=0 List of 2 WWN elements: An instance of WWN WWN=00.99.66.33.88.55.22.77 nickname=Jane An instance of WWN WWN=11.44.77.22.55.88.33.
status=8 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 An instance of ReplicationInfo objectID=***** pairName=HCMD_CP0002 pvolSerialNumber=65010001 pvolArrayType=XP1024 pvolDevNum=101 displayPvolDevNum=00:65 pvolObjectID=***** pvolPoolID=-1 svolArrayType=XP1024 svolSerialNumber=65010001 svolDevNum=102 displaySvolDevNum=00:66 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessCopy status=1 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGr
capacityInKB=0 hostType=2 statusOfDBUpdating=-1 *****: The values are encoded by the CLI. Command execution example 3 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.
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 Path objectID=***** devNum=1,008 portID=11 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true List of
. (Attributes of LogicalUnit are omitted here) . *****: The values are encoded by the CLI. Command execution example 4 In this example, the command obtains the information for accessing the virtualization-server management program in which the virtualization server is registered. Because the CommParameters instance is displayed in the execution result, you can understand that the virtualization-server management program that manages the virtualization server (hostname = boss.boss) is vMA.
Command execution result 5 RESPONSE: An instance of Host objectID=***** name=ha8krs02 hostID=5 capacityInKB=0 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESXi 4.1.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.
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.
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.
*****: 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.
To perform a host scan for all storage systems, use the following format: hdvmcli [URL] HostScan [options] option=all Parameters Table 94 HostScan command parameters Parameter name serialnum model option Status Description Optional Parameter used to specify the serial numbers of the storage systems for which a host scan is to be performed. Optional#1, #2 Parameter used to specify the models of the storage systems for which a host scan is to be performed.
The following describes the format of the ImportHosts command and its parameters. For details about how to create input files and how to use the ImportHosts command to use the import function, see Chapter 7 on page 399: NOTE: • To add hosts, the hosts whose information you imported are registered as normal hosts. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually.
Parameters Table 95 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.
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.
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.
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.
NOTE: • This command cannot change WWN information for the external port of a host. • This command does not support virtualization servers. To modify information about a virtualization server, use the ModifyVirtualizationServer command.
Parameter name Status ipv6address Optional Description New IPv6 IP address of an existing host Omit this parameter if you are not changing the IPv6 IP address of the host. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetHost command. In the execution result of this command, the objectID value appears under An instance of Host. Use this objectID value to specify the objectid parameter.
NOTE: This command does not support virtualization servers. Parameters Table 98 ModifyHostInfo command parameters Parameter name Status objectid Required serialnum Optional model Optional Description Object ID of the HostInfo record to modify Specify the object ID obtained from another CLI response. The value is encoded by the CLI. New serial number of the path's storage system Omit this when no change is required. New model of the path's storage system Omit this when no change is required.
Parameter name Status Description New domain ID of the path Omit this when no change is required. domain Optional This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. New device number of the path Omit this when no change is required.
domainID, and portID values appear under An instance of Path. Use these devNum, domainID, and portID values to specify the devnum, domain, and port parameters respectively. portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter.
fileSystemType=NTFS1 fileSystemName=E: sizeInMB=156 percentUsed=50 lastUpdated=1039003476 *****: The value is encoded by the CLI. ModifyVirtualizationServer ModifyVirtualizationServer modifies information about virtualization servers. NOTE: This command does not support configurations that use Host Data Collector as the virtualization-server management program. • If you are using VMware ESX 4.x or VMware ESXi 4.
Parameter name Status Description hostuserid Optional# User ID Specify this parameter if you want to modify the user ID used to access the virtualization-server management program. User password hostuserpassword # Optional Specify this parameter if you want to modify the password for the user ID specified in hostuserid. # You need to specify at least one of the following parameters: ipaddress, hostprotocol, hostuserid, or hostuserpassword.
Parameters Table 100 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. Parameter values to obtain in advance hostname Obtain this value from the execution result of the GetHost command. Execute this command by specifying VMWARE_ESX for the hostfilter parameter. In the execution result of this command, the name value appears under An instance of Host.
AddURLLink AddURLLink allows a user to specify URL information (referred to as a URLLink) for a Device Manager object managed by the Device Manager server. AddURLLink is used for the following purposes: • To specify a URLLink for an SMI-S Enabled storage system The URL information of the software started from Element Manager of the GUI is modified. Note that a user can set only one URLLink for each SMI-S Enabled storage system.
Parameter name Status Description Type of the Device Manager object for which the URLLink is set 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. Command execution example hdvmcli AddURLLink -o "D:\logs\AddURLLink.log" "url=http://10.208.184.
Specify either alertnum or source. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Parameter values to obtain in advance alertnum and source Obtain these values from the execution result of the GetAlerts command. In the execution result of this command, the number and source values appear under An instance of Alerts. Use these number and source values to specify the alertnum and source parameters respectively.
hdvmcli [URL] DeleteURLLink [options] {objectid=object-ID-of-the-URLLink |linkedid=object-ID-of-SMI-S-Enabled-storage-system} targetoption=smi-s When deleting a URLLink for a Device Manager object other than an SMI-S Enabled storage system: hdvmcli [URL] DeleteURLLink [options] {objectid=object-ID-of-the-URLLink |linkedid=object-ID-of-the-Device-Manager-object} [targetoption=other] Parameters Table 103 DeleteURLLink command parameters Parameter name Status Description The object ID of the URLLink to del
*****: The value is encoded by the CLI. Command execution result RESPONSE (Command completed; empty list returned) GetAlerts GetAlerts returns the alert messages previously generated by the Device Manager server. The returned alerts can be limited by specifying a time and/or a number of messages. When no condition to limit the number of alert messages obtained is specified, information about all alerts is output to the execution results.
severity=3 component=DKU drive description=Serious error detected on DKU drive. actionToTake=Contact Customer Support. data=Component has stopped. timeOfAlert=2003/01/06 20:13:56 An instance of Alert number=1 type=Server source=***** severity=4 component=DKC processor description=Moderate error detected on DKC processor. actionToTake=Contact Customer Support. data=Component does not function fully. timeOfAlert=2003/01/06 20:13:51 *****: The values are encoded by the CLI.
arrayFamily=P9500 displayArrayFamily=P9500 An instance of StorageArray arrayFamily=XP12K/10K/SVS200 displayArrayFamily=USP An instance of StorageArray arrayFamily=XP24K/20K displayArrayFamily=USP_V An instance of StorageArray arrayFamily=P9500 displayArrayFamily=VSP An instance of StorageArray arrayFamily=HM700 displayArrayFamily=HUS VM An instance of StorageArray arrayFamily=XP1024/128 displayArrayFamily=XP1024/128 An instance of StorageArray arrayFamily=XP12K/10K/SVS200 displayArrayFamily=XP12K/10K/SVS200
Parameters Table 105 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 will occur.
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. Replication commands The Replication commands can be used to manage copy pairs.
• Method 2: Adds a copy group to the RAID Manager configuration definition file, and adds a copy pair definition to the copy group.
Parameter name Status pvolhostid Required Description Host ID for identifying the P-VOL When using Method 1, specify the host ID of the P-VOL in a group specified in the definition file. Instance number of the HORCM instance for managing the P-VOL pvolinstancenum Optional When using Method 1, specify the instance number of the P-VOL of a group specified in the definition file. You must specify this parameter when you are using method 1 or 2.
Parameter name Status Description Port number in the HORCM configuration file that manages the P-VOL path. pvolportid Optional If you specify this parameter, specify either pvolportid or pvolportname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name in the HORCM configuration file that manages the P-VOL path. pvolportname Optional If you specify this parameter, specify either pvolportid or pvolportname.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the S-VOL is to be stored. For Continuous Access Asynchronous Software: You must specify this parameter. svolpoolid Optional For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
See No. 2, No. 4, No. 5, No. 6, and No. 7 in the table below. • When using Method 3: See No. 2, No. 5, No. 6, and No. 7 in the table below. Table 107 How to obtain parameter values (AddConfigFileForReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the P-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile, and the groupName value under An instance of ReplicationGroup.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile (configuration definition file information).
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=LogicalUnit) with LogicalUnit specified for the subtarget parameter and the object ID of the logical unit to be used as the P-VOL or the S-VOL (the object ID recorded in No. 5) specified for the objectID parameter. pvolarraytype 6 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"pvoldevnum=5" "svolarraytype=XP12000" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" Command execution result 1 RESPONSE (Command completed; empty list returned) Command execution example 2 This example creates a group in the configuration files, and then adds pairs to the group: hdvmcli AddConfigFileForReplication -o "D:\logs\AddConfigFileForReplication.
Journal Software. When you create a copy pair, the HORCM configuration file for RAID Manager, contained in the host, is rewritten. NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs. • You must specify a formatted LDEV.
[pvolpoolid=pool-ID] svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=port-number|svolportname=port-name] [svolpoolid=pool-ID] replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] [fencelevel=fence-level] [copytracksize=copy-pace] [pairoption=suspend] • Method 3: Create a new RAID Manager configuration definition file, creates a copy group, then adds a copy pair to the copy group.
Parameter name Status Description Number of the HORCM instance that manages the P-VOL pvolinstancenum Optional If you are using method 2, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored. Port number of the HORCM instance that manages the P-VOL Depending on the host OS, specify the appropriate value: • For Solaris systems: Specify an integer in the range 0-65535.
Parameter name Status Description Port ID in the HORCM configuration file that manages the P-VOL paths pvolportid Optional If you specify this parameter, specify either pvolportid or pvolportname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name in the HORCM configuration file managing the P-VOL path pvolportname Optional If you specify this parameter, specify either pvolportid or pvolportname.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the S-VOL is to be stored For Continuous Access Asynchronous Software: You must specify this parameter. svolpoolid Optional For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description pairoption Optional The following value can be specified only when XP12000/XP10000/SVS200 is being used: suspend: Creates a delta resync pair. Parameter values to obtain in advance Parameter values to obtain in advance depend on how you will create a copy pair. • When Method 1 is used: See No. 1, No. 4, and No. 5 in the table below. • When Method 2 is used: See No. 2, No. 3, No. 4, No. 5, and No. 6 in the table below. • When Method 3 is used: See No. 2, No. 4, No.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management To obtain the pvolhostid parameter value, specify the host on which the RAID Manager instance that manages the P-VOL is installed. To obtain the svolhostid parameter value, specify the host on which the RAID Manager instance that manages the S-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with LogicalUnit specified for the subtarget parameter and the name of the host that recognizes the P-VOL or the S-VOL specified for the hostname parameter. The execution result of the GetHost command displays the objectID value (object ID of the logical unit) and the devNum value under An instance of LogicalUnit.
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=Pool) with Pool specified for the subtarget parameter, the model name specified for the model parameter, and the serial number specified for the serialnum parameter. The execution result of the GetStorageArray (subtarget=Pool) command displays the values of poolFunction and PoolID under An instance of Pool. 6 pvolpoolid svolpoolid If you execute the command with the values of pvolarraytype and pvolserialnum recorded in No.
copyTrackSize=15 List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pairName=HCMD_CP0004 pvolSerialNumber=6501001 pvolArrayType=XP1024 pvolDevNum=5 displayPvolDevNum=00:05 pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=65010012 svolArrayType=XP1024 svolDevNum=10 displaySvolDevNum=00:0A svolObjectID=***** svolPoolID=-1 fenceLevel=Data replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=15 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngA
pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
Command execution result 3 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=2 groupName=HCMD_CG0002 pvolHostID=5 pvolInstanceNumber=15 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=4 svolInstanceNumber=15 svolPortNumber=50.002 pvolHORCMINSTHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • To delete a specific copy pair from a copy group, you must specify pvolserialnum, pvoldevnum, svolserialnum (or svolsequencenum), and svoldevnum. If you omit all of these parameters, the system deletes all copy pairs in the specified copy group.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair. In P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, replication controller pairs indicate paths between MCUs and RCUs.
• If you specify the mastermodel, remotefamily, or remotepathgroupid parameter, you also need to specify all other parameters (masterserialnum, mastercontrollerid, remoteserialnum, remotessid, mastermodel, remotefamily, and remotepathgroupid). If you do not specify them at the same time, an error will occur. • If you omit all the parameters, the command will obtain the information about all replication controller pairs.
Command execution example 2 This example obtains the controller pair information in all storage systems that have been registered in the Device Manager database. hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
Parameters Table 112 ModifyReplication command parameters Parameter name Status Description replicationgroupid Required Number of the copy group Specify one of the following values: • split: Split the copy pair. • resync: Re-synchronize the copy pair from the primary volume (P-VOL) to the secondary volume (S-VOL). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot copy pair, the copy pair is split after the re-synchronization.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum# Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
65010001. The secondary volume is the logical device with LDEV number 21 in the storage system with serial number 65010001. hdvmcli ModifyReplication -o "D:\logs\ModifyReplication.
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. Alert instance The Alert instance is output when the GetAlerts command (see “GetAlerts” on page 286) is executed.
ArrayGroup instance The ArrayGroup instance is output when the following commands are executed: • • • • • • • • AddExternalArrayGroup, page 45 AddPool, page 72 AddVirtualVolume, page 88 GetStorageArray (subtarget=ArrayGroup) , page 126 GetStorageArray (subtarget=FreeSpace) , page 137 GetStorageArray (subtarget=PDEV) , page 163 GetStorageArray (subtarget=Pool) , page 165 ModifyPool, page 193 Table 114 ArrayGroup instance attributes Attribute Description objectID Object ID of the parity group Parity grou
Attribute Description diskSizeInKB Actual size (in KB) of physical drives that make up the parity group (example: 75,497,472) 0 is output for an external volume. formFactor Currently, this information does not apply to storage systems (-1 is output).
Attribute Description openOnDemandCapacity Total size of all open LDEVs expanded on demand in the parity group (in KB) imTotalCapacity Total size of all intermediate LDEVs in the parity group (in KB) imAllocatedCapacity Total size of all intermediate LDEVs assigned paths in the parity group (in KB) imFreeCapacity Total size of all intermediate LDEVs that are not assigned paths in the parity group (in KB) imAutoLunCapacity Total size of all intermediate LDEVs reserved for Auto LUN Software in the
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openReservedActualCapacity • Paths are not assigned. • Paths cannot be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity.
Attribute Description Protection level of the parity group For P9500 or XP24000/XP20000, one of the following values is output: • 0: Standard The parity group consists of drives other than SATA drives • 1: SATA-W/V The parity group consists of SATA drives • 2: SATA-E protectionLevel The parity group consists of SATA drives and the write performance is more enhanced than SATA-W/V -1 is output if any of the following conditions are satisfied: • The protection level of the parity group is unknown.
CommParameters instance The CommParameters instance is output when the following commands are executed: • • • • • • • AddStorageArray, page 80 AddVirtualizationServer, page 252 GetHost, page 256 GetStorageArray (subtarget=CommParameters) , page 130 ModifyVirtualizationServer, page 279 RefreshStorageArrays, page 222 RefreshVirtualizationServer, page 280 Table 116 CommParameters instance attributes Attribute Description User ID For a storage system: User ID for accessing the storage system userID For SMI
Attribute Description Port number For SMI-S Enabled storage systems: Port number of the SMI-S provider service portNumber For a virtualization server: Port number of the virtualization-server management program For other cases, no value is output. Component instance The Component instance is output when the GetStorageArray (subtarget=Component) command (see “GetStorageArray (subtarget=Component) ” on page 131) is executed.
Attribute Description 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 The ConfigFile instance is output when the GetHost command (see “GetHost” on page 256) is executed.
ExternalPathInfo instance The ExternalPathInfo instance is output when either of the following commands is executed: • GetStorageArray (subtarget=ArrayGroup) , page 126 • AddExternalArrayGroup, page 45 Table 120 ExternalPathInfo instance attributes Attribute Description objectID Object ID of the external path information externalWWN Port WWN of the external storage system externalLun LUN of the external volume portID Port ID of the port to which the external storage system is connected pathGroupID
FreeSpace instance The FreeSpace instance is output when the following commands are executed: • AddExternalArrayGroup, page 45 • AddVirtualVolume, page 88 • GetStorageArray (subtarget=FreeSpace) , page 137 Table 123 FreeSpace instance attributes Attribute Description objectID Object ID of a region of unused capacity in the parity group sizeInKB Size of a region of unused capacity in the parity group (in KB) Number of cylinders in a region of unused capacity in the parity group cylinders 0 is output f
Attribute Description Size of the LDEV allocated to the host (in KB) capacityInKB For mainframe hosts, the value output for this attribute is 0. Host type • -1: Normal host hostType • 1: External port • 2: Mainframe host • 3: Virtualization server (VMware ESX or VMware ESXi) 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.
Attribute Description ipv6Address IPv6 IP address of the host LUN mount point mountPoint A space is output for a virtualization server. portID Port ID domainID Domain ID of the host storage domain SCSI ID assigned to a channel in the storage system scsiID 15 is output for Fibre Channel.
Attribute Description Display name of the logical unit device number For P9500 or XP24000/XP20000: displayDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description Domain type of the host storage domain domainType 0 (host group) is output. portName Port name of the host storage domain IPAddress instance The IPAddress instance is output when the GetStorageArray (subtarget=PortController) command (see “GetStorageArray (subtarget=PortController) ” on page 175) is executed. Table 127 IPAddress instance attribute Attribute Description IP address of the port controller ipAddress This item is output when NAS is created.
Attribute Description displayName Display name of the LDEV Emulation mode emulation This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8).
Attribute Description Indicates whether a path is assigned to the LDEV: path • true: A path is assigned. • false: No path is assigned. Indicates whether the LDEV is used as a device that is expanded on demand: onDemandDevice • true: The LDEV is expanded on demand. • false: The LDEV is not expanded on demand. Indicates the purpose of the LDEV: devType • AutoLunReserved: The LDEV is reserved for Auto LUN Software. • OnDemandDevice: The LDEV is expanded on demand.
Attribute Description LDEV type One of the following values is output for : • -1: Unknown volumeKind • 1: Mainframe volume • 2: Intermediate volume • 3: Open volume LDEV status One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) • Blocked: Blocked status or unformatted. status • Format: The LDEV is being formatted.
Attribute Description Volume type of Hitachi TrueCopy for Mainframe Software or Hitachi TrueCopy Asynchronous for Mainframe Software • Unknown: Unknown mfTrueCopyVolumeType • Simplex: Not a Hitachi TrueCopy for Mainframe Software volume or Hitachi TrueCopy Asynchronous for Mainframe Software volume • P-VOL • S-VOL Volume type of Hitachi ShadowImage for Mainframe Software • Unknown: Unknown mfShadowImageVolumeType • Simplex: Not a Hitachi ShadowImage for Mainframe Software volume • P-VOL • S-VOL • SP-VO
Attribute Description Usage rate threshold of the THP/Smart volumes. One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit consists of THP/Smart volumes: usage rate threshold value of the THP/Smart volumes#1, #2 • For volumes other than THP/Smart volumes : -1 is output. threshold #1 When the THP/Smart volumes are not assigned to a THP/Smart pool, -1 is displayed. #2 When the operator is a partitioned storage administrator, -1 is displayed.
LogicalDKC instance The LogicalDKC instance is output when the GetStorageArray (subtarget=LogicalDKC) command (see “GetStorageArray (subtarget=LogicalDKC) ” on page 148) is executed.
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.
Attribute Description Number of the LDEV contained in the logical unit devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output. For XP12000/XP10000/SVS200 and XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output.
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).
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.
Attribute Description Usage of on the THP/Smart volume (KB) One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit does not consist of THP/Smart volumes: The same value as capacityInKB. • When the logical unit consists of THP/Smart volumes: Usage of on the THP/Smart volumes. -1 is output for other storage systems.
Attribute Description The status of a THP/Smart pool volume. One of the following values is output for P9500: • 2 : The THP/Smart pool can shrink. thpPoolVolControlFlag • 1 : The THP/Smart pool is shrinking. • 0 : The THP/Smart pool cannot shrink (for example, the initial THP/Smart pool volume). • -1 : The volume is normal (includes the volumes that became normal volumes after the THP/Smart pool finishes shrinking). -1 is output for other storage systems.
Attribute Description svolSerialNumber Serial number of the storage system containing the S-VOL Type of the storage system containing the S-VOL svolArrayType If the storage system containing the S-VOL is not registered, Unknown is output. svolDevNum Device number of the S-VOL Device number of the S-VOL For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number.
ObjectLabel instance The ObjectLabel instance is output when one of the following commands is executed: • • • • • GetStorageArray (subtarget=ArrayGroup) , page 126 GetStorageArray (subtarget=LDEV) , page 145 GetStorageArray (subtarget=LogicalUnit) , page 150 AddLabel, page 60 ModifyLabel, page 189 Table 133 ObjectLabel instance attributes Attribute Description targetID Object ID of the label label Label name PairedPool instance The PairedPool instance is output when the GetStorageArray (subtarget=Po
Path instance The Path instance is output when the following commands are executed: • • • • • • • AddLun, page 233 GetLogicalGroup, page 230 GetStorageArray (subtarget=ArrayGroup) , page 126 GetStorageArray (subtarget=HostStorageDomain) , page 141 GetStorageArray (subtarget=LogicalUnit) , page 150 GetStorageArray (subtarget=Path) , page 159 GetStorageArray (subtarget=Port) , page 172 Table 136 Path instance attributes Attribute Description objectID Object ID of the path Path name name This item is ou
PDEV instance The PDEV instance is output when the following commands are executed: • • • • • AddPool, page 72 GetStorageArray (subtarget=ArrayGroup) , page 126 GetStorageArray (subtarget=PDEV) , page 163 GetStorageArray (subtarget=Pool) , page 165 ModifyPool, page 193 Table 137 PDEV instance attributes Attribute Description objectID Object ID of the physical device Drive name name This item is output if it has been registered.
Attribute Description Serial number of the drive serialNumber This item is not output. Type of the storage system containing the physical device • P9500: P9500 dkuType • XP24K: XP24000/XP20000 • XP12K/10K/SVS200: XP12000/XP10000/SVS200 • XP1024/128: XP1024/XP128 Drive revolutions per minute This information is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. rpm 0 or -1 is output if the drive revolutions are unknown.
Pool instance The Pool instance is output when the following commands are executed: • • • • • • • • AddPool, page 72 AddTieredPoolOperation, page 86 GetPoolShrinkStatus, page 114 GetStorageArray (subtarget=Pool) , page 165 GetTieredPoolStatus, page 182 ModifyExternalTierRank, page 187 ModifyPool, page 193 ShrinkPool, page 226 NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.
Attribute Description Indicates the pool type. The value output depends on the poolFunction value.
Attribute Description Threshold2 of the pool (%) threshold2 If poolFunction is 5, the threshold2 of the THP/Smart pool is output. This information is invalid for other cases (-1 is output). Indicates whether the value output to threshold2 is the value determined by the storage system.
Attribute Description Combination of data drives and parity drives in a RAID configuration. For P9500, if the pool is a THP pool, this item is output in the format xD+yP or xD+xD. • xD: Number of data drives • yP: Number of parity drives combination Unknown is output if the combination is unknown.
Attribute Description Type of the drive If the storage system is P9500 and a THP pool is used, one of the following values is output: • 1: SATA • 4: SAS • 5: SSD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • Drives with different drive speeds are mixed This information is invalid for other cases (-1 is output). Indicates whether the pool is a Smart pool.
Attribute Description Execution status of performance monitoring #2 monitoringState • 0: Stopped • 1: Executing lastMonitorStartDate#2 lastMonitorEndDate#2 Date and time at which performance monitoring started If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output. Date and time at which performance monitoring ended If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output.
• • • • AddPool, page 72 GetStorageArray (subtarget=Pool) , page 165 ModifyExternalTierRank, page 187 ModifyPool, page 193 Table 140 PoolTier instance attributes Attribute Description objectID Object ID of the hardware tier name Name of the hardware tier tierID ID of the hardware tier Capacity of the hardware tier (KB) capacityInKB This value does not match the total capacity of the Smart pool volumes because the pool of Smart Tiers uses a control area.
Attribute Description Type of the drive • 1: SATA • 4: SAS • 5: SSD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • Drives with different drive speeds are mixed Indicates whether the volumes that make up the hardware tier are internal or external volumes: substance • 0: Internal volume • 1: External volume • -1: Unknown, or internal volumes and external volumes are mixed Port instance The Port instance is output when the following c
Attribute Description Port option portOption No value is output if the option is invalid. WWN of the port worldWidePortName This item is valid when the port is a Fibre port or an FCoE port. Channel speed • -1: None • 0: Automatic channelSpeed • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps • 8: 8 Gbps Port attribute • Target • RCU Target • Initiator portRole • LCP • RCP • External: External port • No value: Unknown SLPR number slprNumber -1 is output for storage systems that do not support SLPR.
Attribute Description controllerID Port controller ID displayName Display name of the port controller Mode of the port controller For P9500: • 1: Normal mode For XP24000/XP20000: • 1: Normal mode • 2: High-speed mode (all ports) • 3: Unknown • 4: Reserve mode • 5: High-speed mode (upper 4 ports) • 6: High-speed mode (lower 4 ports) For XP12000/XP10000/SVS200: • 1: Normal mode mode • 2: High-speed mode (all ports) • 3: Unknown • 4: Reserve mode • 5: High-speed mode (upper 4 ports) • 6: High-speed mode
Storage system Values output for the type attribute • 80: ESCON (4 ports) • 81: FICON (4 ports) XP24000/XP20000 • 82: CHT (8 ports) • 85: CHT (4 ports) • 88: CHT (4 ports) • 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 (
The attributes of the RelatedDistributedArrayGroup instance that are output are the same as those of the ArrayGroup instance. For details about the attributes of the RelatedDistributedArrayGroup instance, see “ArrayGroup instance” on page 322. ReplicationControllerPair instance The ReplicationControllerPair instance is output when the GetReplicationControllerPair command (see “GetReplicationControllerPair” on page 315) is executed.
Attribute Description Display name of the highest device number among the applicable LUs in the MCU For 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.
• ModifyReplication, page 317 Table 145 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
ReplicationInfo instance The ReplicationInfo instance is output when the following commands are executed: • • • • • • AddReplication, page 299 DeleteReplication, page 311 GetHost, page 256 GetStorageArray (subtarget=Pool) , page 165 GetStorageArray (subtarget=ReplicationInfo) , page 177 ModifyReplication, page 317 Table 146 ReplicationInfo instance attributes Attribute Description objectID Object ID of ReplicationInfo Name of the copy pair used by the RAID Manager pairName This item is output if it h
Attribute Description Copy type • BusinessCopy: Business Copy Software • ContinuousAccessSync: Continuous Access Synchronous Software replicationFunction • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot • FastSnap: Fast Snap • ContinuousAccessJournal: Continuous Access Journal Software 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
Attribute Description Device number of the S-VOL For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description License status • -1: Unknown • 0: Permanent license • 1: Temporary license license • 2: Emergency license • 100: Core CLI/SMI-S license • 200: A license has not been installed. • 201: A temporary license has expired. • 202: An emergency license has expired.
• • • • • • • • • • • • • • • • GetStorageArray (subtarget=PortController) , page 175 GetStorageArray (subtarget=ReplicationInfo) , page 177 GetStorageArray (subtarget=TieringPolicy) , page 181 GetTieredPoolStatus, page 182 GetZeroPageReclaimStatus, page 184 ModifyExternalTierRank, page 187 ModifyLogicalUnit, page 191 ModifyPool, page 193 ModifyPort, page 201 ModifyPortController, page 208 ModifyStorageArray, page 209 ModifyTieringPolicy, page 212 ModifyVirtualVolume, page 214 RefreshStorageArrays, page 22
Attribute Description numberOfControllers Number of storage system controllers capacityInGB#1 cacheInMB An attribute for compatibility. For details, see Table 149. Cache size (in MB) An attribute for compatibility. sharedMemoryInMB For details, see Table 149. Number of spare drives numberOfSpareDrives -1 is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, or SMI-S Enabled storage systems.
Attribute Description largestFreeSpaceInKB multipathSupport Security status of the storage system • -1: Unknown securityStatus • 0: No security • 2: LUN Manager Recognition ID of the storage system. sequenceNumber Serial number or part of the serial number of the storage system is output.
Attribute Description Total size of the open logical units reserved for Auto LUN Software (in KB) openAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 3. • devType is AutoLunReserved. Total size of the open logical units expanded on demand (in KB) openOnDemandCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 3.
Attribute Description mfUnallocatedCapacity numberOfOpenAllocatedLUs Number of open logical units to which paths are assigned Number of open logical units that satisfy the following conditions: numberOfOpenUnallocatedLUs • Paths are not assigned. numberOfImAllocatedLUs Number of intermediate logical units to which paths are assigned • Paths can be assigned by using Device Manager.
Attribute Description Indicates whether the actual configuration information of the target storage system matches the configuration information in the Device Manager database. One of the following values is output for P9500 and XP24000/XP20000 version 60-04-10-XX/XX or later: configUpdateStatus • 0: The configuration information matches. • 1: The configuration information does not match. Use the AddStorageArray command to update the configuration information of the storage system.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy both the following conditions (in KB): • Paths are not assigned. • Paths cannot be assigned by using Device Manager. openReservedCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2 or 3. • path is false. • The LDEV is used as a reserved volume#2 by storage system functions.
• snapshotVolumeType of the LogicalUnit instance associated with the LDEV is POOL (a Snapshotor Fast Snap pool volume). • journalVolumeType of the LogicalUnit instance associated with the LDEV is JNL-VOL or MF-JNL (a Continuous Access Journal Software journal volume). • differentialManagement of the LogicalUnit instance associated with the LDEV is true (a volume used for differential management).
Attribute Description Size of the largest region of unused capacity in which logical units can be created (in KB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: largestFreeSpaceInKB Largest value of the largestFreeSpace attributes of the ArrayGroup instances whose type attribute is 0 or 1 For other storage systems: Largest value of the largestFreeSpace attributes of all ArrayGroup instances Path support option multipathSupport • For a non-SMI-S Enabled storage system: 1 • For an SMI-S Enabled s
Figure 2 Relationship of attributes (total size of the volumes in the storage system) Figure 3 Relationship of attributes (size of the physical volumes and virtual volumes) Figure 4 Relationship of attributes (the sizes of the volumes) TieringPolicy instance The TieringPolicy instance is output when the following commands are executed: • GetStorageArray (subtarget=TieringPolicy) , page 181 • ModifyTieringPolicy, page 212 Table 150 TieringPolicy instance attributes Attribute Description objectID Object
Attribute allocationThresholdT1Max#1, #2 allocationThresholdT1Min#2 allocationThresholdT3Max#2 allocationThresholdT3Min#2 Description 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. Minimum allocation threshold value (%) for Tier 1 If a tiering policy has been applied, the minimum capacity threshold value allocated for Tier 1 is output.
Attribute Description Type of the URLLink • -1: URLLink set for a Device Manager object other than SMI-S Enabled storage system createdByUser • 0: URLLink set by he Device Manager server for an SMI-S Enabled storage system • 1: URLLink set by a user for an SMI-S Enabled storage system VirtualDisk instance The VirtualDisk instance is output when the GetHost command (see “GetHost” on page 256) is executed.
Attribute Description Name of VolumeConnection name This item is output if it has been registered.
• • • • • GetStorageArray (subtarget=Path) , page 159 GetStorageArray (subtarget=Port) , page 172 MergeHost, page 272 ModifyHost, page 273 ModifyPort, page 201 Table 155 WWN instance attributes Attribute Description World Wide Name WWN A World Wide Name is usually assigned to the HBA in the server. WWN nickname nickname 384 Output items This item is output if it has been registered.
6 Batch functionality This chapter describes the commands that can be executed by using the batch functionality, how to create batch files, how to use the batch functionality, and the actions to be taken if an error occurs. Commands that can be executed by using the batch functionality In the Device Manager CLI, commands can be specified in a batch file and executed at the same time. The batch option allows you to simultaneously execute many commands and is useful when installing a new storage system.
Creating batch files This section describes the input rules and conditions for creating batch files. Batch file format and input rules The batch file format is as follows: beginbatch hdvmcli command parameter hdvmcli command parameter . . endbatch The input rules for batch files are as follows: • Only ASCII encoded characters can be used in batch files. • A batch file must have beginbatch on the first line and endbatch on the last line. • Begin a new line after the character string endbatch.
Conditions for parameters to process commands together When commands are executed together, the following conditions must be satisfied for the parameter values and combinations on consecutive command lines. • Condition-1: Specify the same values as the previous lines. This means that the same parameters and parameters values as previous lines must be specified. If you specify the same parameter but use a different value, the commands will not be executed together.
Command name Parameter Specification conditions externalgrpnum externallun externalwwn inflowcontrol luoption model Y (condition-1) numoflus pathgroupid -portname serialnum Y (condition-1) domain#1 hostmode -- hostmodeoption model AddHostStorageDomain Y (condition-1) name nickname#1 -- port Y (condition-2) portname serialnum Y (condition-1) arraygroupname#2 Y (condition-2) capacity -capacitytype chassis#2 Y (condition-2) creationoption N devnum#1 -- emulation Y (condition-3#3) forma
Command name Parameter Specification conditions lusubinfo -- model Y (condition-1 and condition-3#4) numoflus N serialnum Y (condition-1) devnum domain Y (condition-2) domainnickname AddLun lun -- lusedevnums Y (condition-2) model Y (condition-1) name -- port Y (condition-2) portname scsi -- serialnum Y (condition-1) devnums -- luseoption AddLUSE model Y (condition-1) serialnum arraygroupname#1 -capacity capacitytype Y (condition-1) clprNumber Y (condition-2) devnum#1 --
Command name Parameter Specification conditions threshold -- deletionoption Y (condition-1) domain Y (condition-2) domainnickname DeleteHostStorageDomain model Y (condition-1) port Y (condition-2) portname serialnum Y (condition-1) deletionoption Y (condition-1) devnum domain -- domainnickname DeleteLun model Y (condition-1) port Y (condition-2) portname DeleteLUSE serialnum Y (condition-1) devnum -- model Y (condition-1) serialnum assign Y (condition-1) capacity devnums#5 ModifyV
Y (condition-n): If the specification conditions for the parameter, condition-n, are satisfied, the command can be executed together with other commands when this parameter is specified. N: If this parameter is specified, the command cannot be executed together with other commands. The command is executed by itself. By omitting this parameter, the command can be executed together with other commands. --: This parameter does not affect whether the command is executed together with other commands.
The following items cannot be specified with the batch option, as this will cause an error: • The -i or --input option • Commands • Command parameters • help NOTE: For details about displaying Help information when specifying the batch option, see “Help” on page 30. The following shows an example of an execution with the batch option specified, and an example of the command execution results.
allocatedCapacityInGB=1,605 autoLunCapacityInGB=77 onDemandCapacityInGB=0 totalFreeSpaceInGB=2,383 largestFreeSpaceInGB=778 capacityInKB=6,878,866,064 freeCapacityInKB=5,114,357,504 allocatedCapacityInKB=1,683,100,560 autoLunCapacityInKB=81,408,000 onDemandCapacityInKB=0 totalFreeSpaceInKB=2,499,089,616 largestFreeSpaceInKB=816,324,096 multipathSupport=1 securityStatus=2 sequenceNumber=14053 displayArrayFamily=XP12K/10K/SVS200 displayArrayType=XP12000 numberOfLUs=2,504 numberOfAllocatedLUs=672 numberOfUnall
devNum=816 displayDevNum=03:30 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=100 wwnSecurityValidity=true An instance of Path objectID=***** devNum=817 displayDevNum=03:31 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=101 wwnSecurityValidity=true An instance of Path objectID=***** devNum=816 displayDevNum=03:30 portID=4 portName=CL1-B domainID=0 scsiID=15 LUN=102 wwnSecurityValidity=true An instance of Path objectID=***** devNum=817 displayDevNum=03:31 portID=4 portName=CL1-B domainID=0 scsiID=15 LUN=
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. 3. Delete the command lines applied to the storage system from the batch file. 4. Execute the batch functionality again.
2. Execute the GetStorageArray command to check whether there is an error in the batch file. 3. Correct any error in the batch file. 4. Execute the batch functionality again.
4. Execute the batch functionality again.
Batch functionality
7 Import functionality Hosts can be added and host information can be updated by importing host information files and mapping definition files via the Device Manager CLI. This chapter describes the import functionality that can be used by executing the ImportHosts command. For details about the format and parameters of the ImportHosts command, see “ImportHosts” on page 268. Overview of the import functionality The ImportHosts command can be used to import host information from files.
Figure 5 Flow of operations for importing host information (ImportHosts command) The following describes the files that the ImportHosts command uses or generates. Input files • Host information file (CSV file) The host information file contains host information in CSV format. If you are using spreadsheet software to manage hosts, you can use the spreadsheet software file to create the host information file.
NOTE: • To add hosts, the hosts whose information you imported are registered as normal hosts. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually. The ImportHosts command only updates normal hosts that were manually registered by using the Device Manager GUI or CLI (AddHost command or HostScan command).
See also • • • • Conventions for creating host information files (CSV files), page 402 Conventions for creating mapping definition files, page 403 Examples of input files, page 404 ImportHosts, page 268 Conventions for creating host information files (CSV files) Follow the following conventions when creating host information files: • Use UTF-8 encoding. • Make sure that the host information file does not exceed the maximum of 10,250 records.
Item Description IP address (IPv4)# Specify an IP address in IPv4 format. IP address (IPv6)# Specify an IP address in IPv6 format. Alphabetic characters are not case sensitive. Specify the OS type. Alphabetic characters are not case sensitive. OS type If the character string specified as this item is defined in the mapping definition file as a property value, the corresponding OS type is displayed in the GUI.
Property Description Specifies the position of the host name. import.host.column.hostname Specify the field number (the leftmost field is 1) of the field that specifies the host name. You can specify a value from 1 to 256. This property is required. import.host.column.wwn These five properties specify the positions of items other than the host name. import.host.column.iscsiname# Specify the field number (the leftmost field is 1) of the field that specifies the corresponding item.
Example of a host information file (CSV file) 1,2,3,4,5,6[CRLF] host,ip,ipv6,OS,description,wwn[CRLF] TEST1,10.0.0.1,,WINDOWS,Evaluation purpose,11.11.11.11.11.11.11.11[CRLF] TEST2,,,Windows 2008,DB server,22.22.22.22.22.22.22.22[CRLF] TEST3,,,Windows 7,File server,33.33.33.33.33.33.33.33[CRLF] TEST4,10.0.0.3,,LINUX,,44.44.44.44.44.44.44.
Import functionality
8 Properties file This chapter describes how to specify options and parameters by using the Device Manager CLI properties file. This chapter also describes how to change certain properties by entering commands from the command line. Overview of the properties file The Device Manager server URL, command options, and parameters can be set in the properties file. When these items have been specified in the properties file, you do not need to enter them from the command line.
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 ##### COMMAND PARAMETERS #### # Set the Array model, for commands that use this parameter. model=XP24000 Using the properties file to specify options Command options can be specified from the command line or in the properties file.
Encoding the password in the properties file or password file Specify a password in the properties file (hdvmcli.properties) 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.
After the command completes, you do not need to specify the password when using the Device Manager CLI. After executing the hdvmaccount command, use the GetServerInfo or GetStorageArray command to make sure that the password is correctly set. Using the properties file to specify parameters Command parameters can be specified from the command line or in the properties file. When they have been specified in the properties file, you do not need to specify them from the command line.
hdvmcli.diaglevel=DEBUG • Information hdvmcli.diaglevel=INFO • Warnings hdvmcli.diaglevel=WARN • Errors hdvmcli.diaglevel=ERROR NOTE: As shown above, you can set the hdvmcli.diaglevel property to DEBUG, INFO, WARN, or ERROR. The default logging level is INFO. Message trace output The recording of the request messages sent to the Device Manager server and the received responses can be controlled using the -t or --messagetrace option. Like all options, the value can also be set in the properties file.
Inputting requests from XML documents CAUTION: To use the XML-API CLI feature, you need thorough knowledge of XML-API, and need to take great care in formulating commands. Rather than specifying the command and parameters from the command line, the request can originate from a file. The file must contain a valid XML document in the correct form for a Device Manager request. The command line option -i or --input specifies the input file. The other options are still valid.
PAGE 4146. At the CLI prompt, type: do GetStorageArray Following is sample output: RESPONSE: (Command completed; empty list returned) NOTE: The XML for this command is now in the MessageTrace.log file. 7. View the content of the MessageTrace.log file. Following is sample output: C:\hdvm>more MessageTrace.log >>> Request Submitted at: 12:46:07 CEST to: http://193.36.40.55:2001/service/ServerAdmin ---- HTTP Header ---User-Agent = HiCommandClient Accept = */* Host = 193.36.40.
9. To execute the getary.inp XML file on a storage system, type the following command at the CLI prompt: do -i getary.inp You will see results similar to the following example: C:\hdvm>do -i getary.inp RESPONSE: 10.
subtarget parameter value Parameter that cannot be specified Section where described# LDEV ldevsubinfo GetStorageArray (subtarget=LDEV) , page 145 • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo GetStorageArray (subtarget=LogicalUnit) , page 150 MFReplicationInfo mfreplicationsubinfo GetStorageArray (subtarget=MFReplicationInfo) , page 155 Path pathsubinfo GetStorageArray (subtarget=Path) , page 159 Pool poolsubinfo GetStorageArray (subtarget=Pool) , page 165 Port portsubinfo GetStor
The execution result is output in UTF-8 encoding. If you want to use the execution result in application software, such as spreadsheet software, you need to convert the encoding to the one supported by that application software. Item names and values output in the execution result are enclosed in double quotation marks ("). Two successive commas in the execution result indicate that the corresponding item between the two commas has no value.
In the DOCTYPE declaration, the URI (Uniform Resource Identifier) of the DTD (Document Type Definition) specified in the properties file is output. To include the DOCTYPE declaration and line feed code in the execution results, you must specify a DTD in the properties file. For details about specifying a DTD, see “Specifying a DTD” on page 418. Third line: XML elements are output.
Component EMPTY> FreeLUN EMPTY> FreeSpace EMPTY> HostInfo EMPTY> IPAddress EMPTY> ISCSIName EMPTY> LogicalDKC EMPTY> PairedPool EMPTY> PairedPortController EMPTY> PDEV EMPTY> VolumeConnection EMPTY> WWN EMPTY> ObjectLabel EMPTY> RelatedDistributedArrayGroup EMPTY> ExternalPathInfo EMPTY> ExternalStorage EMPT
fileSystemType CDATA #IMPLIED> fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percentUsed CDATA #IMPLIED> lastUpdated CDATA #IMPLIED> portISCSIName CDATA #IMPLIED>
threshold CDATA #IMPLIED> systemDisk CDATA #IMPLIED> encrypted CDATA #IMPLIED> thpTier0ConsumedCapacityInKB CDATA #IMPLIED> thpTier1ConsumedCapacityInKB CDATA #IMPLIED> thpTier2ConsumedCapacityInKB CDATA #IMPLIED> tieringPolicy CDATA #IMPLIED> tierRelocation CDATA #IMPLIED> externalTierRank CDATA #IMPLIED>
devNum CDATA #IMPLIED> displayDevNum CDATA #IMPLIED> portID CDATA #IMPLIED> portName CDATA #IMPLIED> domainID CDATA #IMPLIED> scsiID CDATA #IMPLIED> LUN CDATA #IMPLIED> wwnSecurityValidity CDATA #IMPLIED>
migrationInterval CDATA #IMPLIED> monitorStartTime CDATA #IMPLIED> monitorEndTime CDATA #IMPLIED> monitoringMode CDATA #IMPLIED> externalMixCompatible CDATA #IMPLIED> monitoringState CDATA #IMPLI
gatewayAddressStatus CDATA #IMPLIED> portNumber CDATA #IMPLIED> keepAliveTime CDATA #IMPLIED> mtu CDATA #IMPLIED> vlanSettingMode CDATA #IMPLIED> vlanID CDATA #IMPLIED>
9 Troubleshooting This chapter describes how to troubleshoot Device Manager CLI problems. Troubleshooting Device Manager CLI problems If there is a problem with the Device Manager CLI: • Make sure that the problem is not being caused by the PC or LAN hardware or software, and try restarting the PC. • Make sure that the problem is not occurring at the Device Manager server. • Check for errors specific to the Device Manager CLI, and if there are any, take appropriate action. For details, see the table below.
Problem Description and recommended action CAUSE: The host used for creating the copy pair recognizes CL1-A or LUN0. SOLUTION: Assign another port to the LU or assign a LUN other than LUN0, and re-create the copy pair. SOLUTION: Collect the following information, and then contact your HP Technical Support representative. The following error message is displayed and the Device Manager CLI stops: • CLI log file An unspecified error was encountered in CLI.
Problem Description and recommended action CAUSE: Authenticate failed in the Device Manager. SOLUTION: Make sure that the user ID and password that you specified when executing the command are correct. If you are using the function for linking to an external authentication server, take the action specified below. If the external authentication server is an LDAP server: The following message is displayed when a Device Manager CLI command is executed: [KAIC90084-E] HTTP Response: "HTTP/1.
Problem Description and recommended action CAUSE: The settings of JRE do not allow using JSSE. An error occurs if SSL communication is used in AIX. SOLUTION: Add the following line to the JRE-installation-directory/lib/security/ java.security file: ssl.SocketFactory.provider=com. sun.net.ssl.internal.ssl.
10 Support and other resources Numerous support options are available. Contacting HP HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
Support and other resources
A Connecting to P9000 mainframe agent This appendix describes how to specify the information required to connect to P9000 mainframe agent.
Registering the mainframe host in Device Manager To use the AddHost command to register the mainframe host in Device Manager: 1. Execute the AddHost command to register the mainframe host in Device Manager. When you execute the command, specify the following parameters: • hostname: In this parameter, specify the host name that you specified when setting up the mainframe host environment. • hosttype: In this parameter, specify 2. 2.
name=toro2 hostID=1 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Registering the P9000 mainframe agent running on the mainframe host in Device Manager To use the AddURLLink command to register the mainframe host in Device Manager: 1. Execute the AddURLLink command to register the P9000 mainframe agent running on the mainframe host in Device Manager.
Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.log" "url=http://192.168.99.114:24042" "name=MainframeAgent" "linkedid=*****" *****: The value is encoded by the CLI.
2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again. If they have not been registered correctly, register them correctly by using the procedures described in “Registering the mainframe host in Device Manager” on page 436 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 437.
1. Check whether P9000 mainframe agent is operating normally. If it is not operating normally, check the P9000 mainframe agent settings, and restart P9000 mainframe agent. 2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
Example of executing the command: hdvmcli GetURLLink -o "D:\logs\GetURLLink.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.114:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI.
An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.100:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI. Deleting P9000 mainframe agent information registered in Device Manager To delete P9000 mainframe agent information registered in the Device Manager server, use the DeleteURLLink command. Use this command when you want to delete only P9000 mainframe agent registration information.
Example of executing the command: hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 capacityInKB=0 hostType=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Changing mainframe host information To change the information of a mainframe host registered in the Device Manager server, use the ModifyHost command.
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=snow hostID=1 capacityInKB=0 hostType=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Deleting a mainframe host To delete a mainframe host registered in the Device Manager server, use the DeleteHost command.
Glossary This glossary defines the special terms used in this document.
LUN logical unit number LUSE Logical Unit Size Expansion (feature of XP1024/XP128) MB megabytes (1024 KB) MCU main control unit (for Continuous Access Software) OS operating system PDEV physical device P-VOL primary volume (for Business Copy Software or Continuous Access Software) RAID redundant array of independent disks RCU remote control unit (for Continuous Access Software) SCSI small computer system interface SLPR Storage Logical Partition SMI-S Storage Management Initiative - Sp
Index A access control, 37 AddArrayReservation, 43 AddConfigFileForReplication, 290 AddExternalArrayGroup, 45 AddHost, 247 AddHostInfo, 248 AddHostRefresh, 250 AddHostStorageDomain, 50 AddLabel, 60 AddLogicalUnit, 62 AddLun, 233 AddLUSE, 68 AddPool, 72 AddReplication, 299 AddStorageArray, 80 AddTieredPoolOperation, 86 AddURLLink, 282 AddVirtualizationServer, 252 AddVirtualVolume, 88 AddWWNForHostStorageDomain, 238 B batch commands that can be executed, 385 execution example, 392 execution results, 392 C c
E example of creating host information file (CSV file), 405 mapping definition file, 405 F FormatLU, 109 G GetAlerts, 286 GetArrayReservation, 114 GetHost, 256 GetHostInfo, 265 GetLogicalGroup, 230 GetPoolShrinkStatus, 114 GetReplicationControllerPair, 315 GetServerInfo, 287 GetStorageArray, 119 GetStorageArray (subtarget not specified), 123 GetStorageArray (subtarget=ArrayGroup), 126 GetStorageArray (subtarget=CommParameters), 130 GetStorageArray (subtarget=Component), 131 GetStorageArray (subtarget=Exte
ModifyLogicalUnit, 191 ModifyPool, 193 ModifyPort, 201 ModifyPortController, 208 ModifyReplication, 317 ModifyStorageArray, 209 ModifyTieringPolicy, 212 ModifyVirtualizationServer, 279 ModifyVirtualVolume, 214 U URL, 26 User Account Control function, 26 user group, 37 V version Device Manager CLI, 30 N notes Device Manager CLI, 41 O optimization of regions of unused capacity, 62 options, 27 output files check results file, 400 error information file, 400 for ImportHosts, 400 output format CSV format, 41
