HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96313 Seventh edition: August 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 .........................................................................................................
DeleteHostInfo ................................................................................................................. GetHost .......................................................................................................................... GetHostInfo ..................................................................................................................... HostScan .................................................................................................................
PortController instance ............................................................................................................. RelatedDistributedArrayGroup instance ...................................................................................... ReplicationControllerPair instance ............................................................................................. ReplicationGroup instance ..................................................................................................
9 Troubleshooting ............................................................................. 423 Troubleshooting Device Manager CLI problems ........................................................................... 423 10 Support and other resources .......................................................... 427 Contacting HP ........................................................................................................................ HP technical support .....................................
Figures 1 Example of executing the AddExternalArrayGroup command ........................................ 48 2 Relationship of attributes (total size of the volumes in the storage system) ...................... 374 3 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 374 4 Relationship of attributes (the sizes of the volumes) .................................................... 374 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 ........................................................ 97 34 DeleteLabel command parameters ............................................................................. 99 35 DeleteLogicalUnit command parameters ................................................................... 100 36 DeleteLUSE command parameters ........................................................................... 102 37 DeletePool command parameters .................................
70 ModifyPort command parameters ............................................................................ 200 71 ModifyPortController command parameters .............................................................. 206 72 ModifyVirtualVolume command parameters ............................................................. 209 73 RefreshPerformanceData command parameter .......................................................... 215 74 RefreshStorageArrays command parameter ...............................
107 DeleteReplication command parameters ................................................................... 306 108 GetReplicationControllerPair command parameters ................................................... 309 109 ModifyReplication command parameters ................................................................. 311 110 Alert instance attributes .......................................................................................... 315 111 ArrayGroup instance attributes ....................
144 ServerInfo instance attributes .................................................................................. 363 145 StorageArray instance attributes .............................................................................. 365 146 StorageArray instance attributes (attributes for maintaining compatibility) ..................... 372 147 URLLink instance attributes ...................................................................................... 374 148 VirtualDisk 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 401. • 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 Releases unused capacity in THP/Smart volumes. Y Y -- -- Shrinks a THP/Smart pool. Y -- -- -- Command name Description RefreshStorageArrays Refreshes the configuration information for all of the storage systems that are managed by the Device Manager server with the most recent information. RunZeroPageReclaim ShrinkPool P9500 XP1024/ XP128 Legend: Y: Indicates that the particular storage system can be used to execute the command.
Command name Description DeleteWWNForHostStorageDomain Releases the security set to a LUN in the specified host storage domain. P9500 Y XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y XP1024/ XP128 Y Legend: Y: Indicates that the particular storage system can be used to execute the command. --: Indicates that it cannot be used to execute the command. Table 8 Host management commands Command name Description AddHost Registers information about a host into the Device Manager server database.
Command name Description RefreshVirtualizationServer Refreshes information about a virtualization server. Table 9 Server management commands Command name Description AddURLLink For Device Manager objects managed by the Device Manager server (referred to as mainframe hosts), this command sets information regarding links to the URLs of the P9000 mainframe agent instances running on mainframe hosts (referred to as URLLinks).
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. For details about command specifications, see Chapter 4 on page 43.
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 260.
Storage system Value of hostmode • Standard • Sequent • HP • Solaris • Netware XP12000 /XP10000/ SVS200 • Windows • 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 -- -- 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.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port and domain Obtain these values from the execution result of the GetStorageArray (subtarget=Port, portsubinfo=HostStorageDomain) command.
AddLabel AddLabel adds a label to a logical unit.
Command execution example hdvmcli AddLabel -o "D:\logs\AddLabel.log" "serialnum=10037" "model=XP24000" "devnums=00:00:00,00:00:01" "label=myLabel" Command execution result RESPONSE: An instance of ObjectLabel targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. AddLogicalUnit AddLogicalUnit creates an LDEV and LU. With P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, you can create multiple logical units at once.
Format for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200 When creating a single LU: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number |arraygroupname=parity-group-name} 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:
|arraygroupname=parity-group-name} capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] 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
Parameter name Status Description Index number of the region of unused capacity to be used for creating an LU Specify the index number of a region of unused capacity in a parity group. If you specify this parameter, also specify the creationoption parameter.
Parameter name numoflus Status Description Optional Number of LUs to be created (P9500, XP24000/XP20000, and XP12000 /XP10000/ SVS200) This parameter must be specified if bulk or dividebynum is specified for the creationoption parameter. Do not specify this parameter if the creationoption parameter is not specified, or dividebycap is specified for the creationoption parameter.
Parameter name Status Description Format status of LDEVs that constitute an LU You can specify the following values: format Optional • none: Creates an unformatted LDEV. (P9500, XP24000/XP20000, and XP12000 /XP10000 /SVS200) • normal: Creates a formatted LDEV. • quick: Creates an LDEV formatted by using Quick Format. If omitted, a formatted LDEV will be created. If you specify this value, make sure that the value of the autoFormatLU attribute of the StorageArray instance is 0.
hdvmcli AddLogicalUnit -o "D:\logs\AddLogicalUnit.log" serialnum=10001 model=XP1024 chassis=4 groupnum=32 capacity=1000080 emulation=OPEN-3 lusubinfo=LDEV devnum=176 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Make sure that you back up the data before creating a LUSE volume, because the data stored in the LDEV/LU to be connected might be lost during creation of the LUSE volume. When you create a LUSE volume, specify a formatted LDEV. If you include an unformatted LDEV during creation of the LUSE volume, the LUSE volume will not be recognized from the hosts. 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.
devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter. In the execution result of this command, the devNum 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.
managementAreaPoolID=-1 List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfT
isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 *****: The values are encoded by the CLI. AddPool AddPool creates a THP/Smart pool in a targeted storage system.
• It does not have a path. • If more than one logical unit is specified, all of them must have the same CLPR number. • If more than one logical unit is specified, all of them must have the same cache mode. The following conditions apply only to P9500 with a microcode version earlier than 70-02-00-XX/XX: • If more than one logical unit is specified for a THP/Smart pool, internal volumes and external volumes cannot be mixed together.
NOTE: For details about the following conditions, see the Thin Provisioning documentation: • The number of pool volumes that can be specified in a THP/Smart pool • The total maximum number of THP/Smart pools 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-provision
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 Optional clprNumber (XP24000 /XP20000) Description CLPR number If this parameter is omitted, 0 is set. If you have specified the poolid parameter, the CLPR number of the THP pool specific to that 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.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPo
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 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 ra
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 encrypted=0 tieringPolicy=-1 List of 1 FreeSpace elements: An instance of FreeS
Command execution example hdvmcli DeleteArrayReservation -o "D:\logs\DeleteArrayReservation.log" "model=XP12000" "serialnum=14009" Command execution result RESPONSE: (Command completed; empty list returned) DeleteExternalArrayGroup DeleteExternalArrayGroup deletes mapping of the volume (external volume) of an externally connected storage system (external storage system) that is mapped on a one-to-one basis to an internal volume, and deletes the parity group (external parity group).
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. Use this value to specify the arraygroupnames parameter. Command execution example hdvmcli DeleteExternalArrayGroup -o "D:\logs\DeleteExternalArrayGroup.
Parameter name Status Description Nickname of the host storage domain to delete domainnickname Optional deletionoption Optional 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. For this parameter, you can specify only lusekeep. If this parameter is omitted, a LUSE is deleted. If you do not want to delete a LUSE, be sure to specify this parameter.
DeleteLabel DeleteLabel deletes a label from a logical unit. Parameters Table 34 DeleteLabel command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number of the logical unit For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number.
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. NOTE: • For P9500 or XP24000/XP20000, logical units cannot be deleted for parity groups with chassis numbers from 65 to 96, or from 16485 to 16516.
Parameter name Status Description Device number of the LU For P9500 and XP24000/XP20000: Optional devnums (P9500, XP24000/XP20000, and XP12000 /XP10000 /SVS200) Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Parameters Table 36 DeleteLUSE command parameters Parameter name Status Description serialnum Required Serial number of the storage system from which the LUSE is to be deleted model Required Model of the storage system from which the LUSE is to be deleted Device number used to identify the LUSE to be deleted For P9500 and XP24000/XP20000: devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the
DeletePool DeletePool deletes a THP/Smart pool, and releases the assignations to the pool volumes that made up the THP/Smart pool. NOTE: This command can be used only with P9500 and XP24000/XP20000. To delete a THP/Smart pool, all assignments between the THP/Smart pool and the THP/Smart volumes must be released. For details about releasing the assignations between the THP/Smart pool and the THP/Smart volumes, see “ModifyVirtualVolume” on page 207.
Command execution result RESPONSE: (Command completed; empty list returned) DeleteStorageArray DeleteStorageArray removes a storage system (including an SMI-S Enabled storage system) so that it is no longer managed by the Device Manager server. This command only removes the storage system from Device Manager management control. The command does not change the configuration of the storage system.
Parameter name Status saobjid Optional# Description Object ID of the SMI-S Enabled storage system to delete Specify the object ID obtained from another CLI response. The value is encoded by the CLI. # Always specify either the serialnum and model parameters together, or the saobjid parameter by itself. Do not specify saobjid together with serialnum and model. Doing so will result in an error.
NOTE: • For P9500 and XP24000/XP20000, if you delete the specified virtual parity group, the virtual parity group and the THP/Smart volumes contained in that virtual parity group are also deleted. • For P9500, if you delete specified THP/Smart volumes, the virtual parity group that contains the THP/Smart volumes is also deleted. • For XP24000/XP20000, if you delete specified THP volumes, you cannot delete the virtual parity group that contains the THP volumes.
Parameter name Status Description model Required Model of the storage system Optional Specifies whether to delete THP volumes that have not been released from the THP pool. deletionoption arraygroup# names (XP24000/XP20000) Optional To delete such THP volumes, specify force. Name(s) of the virtual parity group(s). Use a comma to delimit multiple values. Device number(s) of the THP/Smart volume(s).
Command execution result RESPONSE: (Command completed; empty list returned) FormatLU FormatLU formats an LU. To check whether the LDEV was formatted properly if you omitted the wait parameter, or if you specified false in the wait parameter, first use the AddStorageArray command to refresh the storage system, and then execute the GetStorageArray (subtarget=LDEV) command and check the value of status in the execution results.
Parameter name Status Description 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. ww is optional. If ww is omitted, LDKC is assumed to be 0.
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.
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 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-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 LDEV objectID=***** devNum=1,176 displayName=
*****: 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.log" Command execution result An instance of ArrayReservation objectID=***** target=***** serialNumber=14009 arrayType=XP12000 loginID=dmuser beginTime=1,039,003,476 *****: The values are encoded by the CLI.
Parameters Table 41 GetPoolShrinkStatus 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 Parameter values to obtain in advance None.
raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=135 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repD
threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=1,547 displayName=00:06:0B 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 jo
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 . . (repeated for other LogicalUnit instances) .
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 154 Path Information about paths GetStorageArray (subtarget=Path) , page 158 PDEV Information about PDEVs GetStorageArray (subtarget=PDEV) , page 162 Information about pools GetStorageArray (subtarget=Pool) , page 164 Pool (for Snapshot, Continuous Access Journal Software, or Thin Provisioning Software)
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information The following information about logical units can be acquired: • LDEV: LDEV information lusubinfo • Path: Path information • VolumeConnection: Mapping information of external volumes for LDEVs Specify Path for the parameter lusubinfo when using this parameter.
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.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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. Parameters Table 54 GetStorageArray (subtarget=LogicalDKC) command parameters Parameter name Status Description subtarget Required Specify LogicalDKC.
arrayType=XP24000 microcodeVersion=60-00-32/00 agentVersion=05_00_00 productName=RAID600 controllerVersion=60-00-32-00/00 numberOfControllers=2 capacityInGB=8,852 cacheInMB=65,536 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=8,009 allocatedCapacityInGB=812 autoLunCapacityInGB=30 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,089 largestFreeSpaceInGB=492 capacityInKB=9,282,994,926 freeCapacityInKB=8,399,083,870 allocatedCapacityInKB=851,452,736 autoLunCapacityInKB=32,458,320 onDemandCapacityInKB=
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 LogicalDKC elements: An instance of LogicalDKC logicalDKCNumber=00 mfLogicalSerialNumber=12345 *****: The value is encoded by the CLI.
Parameter name Status Description Filter for selecting a logical unit lufilterchildid Specify the object ID of the LDEV. Optional Only the logical units corresponding to the LDEV of the specified object ID are returned. Specify the object ID obtained from another CLI response. The value is encoded by the CLI. Specific information about the logical unit lusubinfo Optional The values you can specify are Path, LDEV, and VolumeConnection.
Parameter name Status Description Number of logical units for which information is to be obtained numOfElementsFilter Optional Specify this parameter when you want to obtain information for a part of logical units in a specific storage system. Specify the number of logical units for which information is to be obtained. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
includes information about the paths to the logical units, the LDEVs used in the logical units, the WWNs of the path, and the host. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LogicalUnit.log" "subtarget=LogicalUnit" "model=XP12000" "serialnum=10001" "lufilter=all" "lusubinfo=Path,LDEV,VolumeConnection" "pathsubinfo=WWN,HostInfo" "ldevsubinfo=VolumeConnection" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
An instance of Path . . (Attributes of Path are omitted here) . List of 2 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.3F.04 nickname=Jone . . (repeated for other Path instances) .
displayMappedDevNum=00:64 externalArrayType=XP12000 externalSerialNumber=10002 externalDevNum=150 displayExternalDevNum=00:96 externalVolumeName=0096 productName=12000 vendor=HP List of 1 ObjectLabel elements: An instance of ObjectLabel targetID=***** label=myLabel . . (repeated for other VolumeConnection instances) . *****: The values are encoded by the CLI.
Parameter name Status Description ID of the mainframe volume copy pair information (MFReplicationInfo instance) Specify this parameter to obtain information about a copy pair of a specific mainframe volume. objectid Optional mfreplicationsubinfo Optional If you specify this parameter, you must also specify the model and serialnum parameters.
execution result of this command, an objectID value appears under An instance of MFReplicationInfo. Use this objectID value to specify the objectid parameter. Command execution example hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_MFReplicationInfo.log" "subtarget=MFReplicationInfo" "model=XP24000" "serialnum=10037" "mfreplicationsubinfo=LDEV" "startElementNumFilter=0" "numOfElementsFilter=1" Command execution result RESPONSE: An instance of StorageArray . .
guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=1 status=Normal thpType=-1 consumedSizeInKB=2,904,930 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=P-VOL mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 An instance of LDEV objectID=***** devNum=3,333 displayName=00:0D:05 emulation=3390-3 cylinders=3,339 isComposite=0 sizeInKB=2,904,930 lba=5,809,860 raidType=RAID
GetStorageArray (subtarget=Path) GetStorageArray (subtarget=Path) obtains the information about paths. Parameters Table 57 GetStorageArray (subtarget=Path) command parameters Parameter name Status Description subtarget Required Specify Path. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Number of paths for which information is to be obtained numOfElementsFilter Optional Specify this parameter when you want to obtain information for a part of paths for a specific storage system. Specify the number of paths for which information is to be obtained. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
Parameter name Status Description Device number of the logical unit For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
objectID=***** devNum=0 displayDevNum=00:00 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=0 wwnSecurityValidity=true . . (repeated for other Path instances) . An instance of Path objectID=***** devNum=99 displayDevNum=00:63 portID=7 portName=CL1-H domainID=0 scsiID=15 LUN=99 wwnSecurityValidity=true List of 256 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.00.02 nickname=Jone . . (repeated for other WWN instances) .
An instance of Path objectID=***** devNum=99 displayDevNum=00:63 portID=7 portName=CL1-H domainID=0 scsiID=15 LUN=99 wwnSecurityValidity=true List of 2 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.00.02 nickname=Jone *****: The value is encoded by the CLI. GetStorageArray (subtarget=PDEV) GetStorageArray (subtarget=PDEV) obtains the information about PDEVs.
Parameter name pdevid Status Description Optional Specify this parameter when you want to obtain information about a specific PDEV. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and omit the pdevid parameter, information about PDEVs in the specified storage system is obtained. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
List of 4 PDEV elements: An instance of PDEV objectID=***** chassis=1 arrayGroup=0 arrayGroupName=1-1-1 capacityInKB=75,497,472 row=-1 column=-1 denseNumber=-1 densePosition=-1 depth=-1 role= vendor= model=DKR2D-J072FC firmwareVersion= serialNumber= dkuType=XP1024 rpm=-1 diskType=-1 formFactor=-1 pdevid=1 encrypted=-1 . . (repeated for other PDEV instances) . *****: The value is encoded by the CLI.
Parameters Table 59 GetStorageArray (subtarget=Pool) command parameters Parameter name Status Description subtarget Required Specify Pool. 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 Filter for selecting the type of function used to operate the pools. You can specify the following values: • 3: Snapshot or Continuous Access Asynchronous Software poolfilter Optional • 4: Continuous Access Journal Software • 5: Thin Provisioning Use a comma to delimit multiple values. You cannot specify the poolfilter parameter if the model, serialnum, poolfunction, poolid, and poolsubinfo parameters are all specified.
. (Attributes of StorageArray are omitted here) .
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 An instance of LogicalUnit objectID=***** devNum=3,028 displayName=0B:
controllerID=-1 poolType=0 status=-1 threshold=-1 threshold2=-1 threshold2Mode=-1 capacityInKB=-1 freeCapacityInKB=-1 usageRate=-1 numberOfPoolVols=-1 numberOfVVols=-1 capacityOfVVolsInKB=-1 clprNumber=-1 raidLevel=combination= volAlertNotice=-1 overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocat
An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,034 displayPvolDevNum=0B:DA pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053 svolArrayType=Unknown svolDevNum=3,034 displaySvolDevNum=0B:DA svolPoolID=1 replicationFunction=ContinuousAccessJournal status=17 muNumber=0 copyTrackSize=-1 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,025 displayName=0B:
pairedArrayType=Unknown pairedSerialNumber=14053 pairedPoolID=1 . . (repeated for other Pool instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=Port) GetStorageArray (subtarget=Port) obtains the information about ports. Parameters Table 60 GetStorageArray (subtarget=Port) command parameters Parameter name Status Description subtarget Required Specify Port.
Parameter name Status Description Type of port about which you want to obtain information portfilter Optional The values you can specify are LCP, Fibre, SCSI, FICON, NAS, ISCSI, and FCoE. If you specify multiple values at the same time, separate the values by semicolons (;). Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
displayName=CL3-E lunSecurityEnabled=true controllerID=2 worldWidePortName=50.06.0E.80.05.27.17.
Parameter name Status Description Controller ID of the port controller in the storage system controllernum Optional Specify this parameter when you want to obtain information about a specific port controller. If you specify this parameter, you must also specify the model and serialnum parameters. If controllernum and controllername are omitted, port controller information is obtained for the specified storage system. Do not specify controllernum and controllername at the same time.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_PortController.log" subtarget=PortController model=XP1024 serialnum=10001 Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 4 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 . . (repeated for other PortController instances) . *****: The value is encoded by the CLI.
*****: The value is encoded by the CLI. GetStorageArray (subtarget=ReplicationInfo) GetStorageArray (subtarget=ReplicationInfo) obtains information about copy pairs. NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes. • For XP24000/XP20000, if there is information about copy pairs consisting of mainframe volumes, microcode version 60-01-6X-XX/XX or later is required.
Parameter name Status Description Starting sequence number of copy pair information to be obtained Specify this parameter to obtain information for some copy pairs from a specific storage system. When copy pair information is in the order shown below and starts from 0, specify the first number in the sequence of copy pair information that you want to obtain. startElementNumFilter Optional Order of copy pair information: 1. Serial numbers of P-VOLs in ascending order 2.
. . (Attributes of StorageArray are omitted here) .
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 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=S-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFl
Parameter name Status Description model Required Model of the storage system List of pool IDs poolids Required Specify the pool ID of a Smart pool. Use a comma to delimit multiple values. The maximum number of pool IDs that can be specified is 128. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
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=enable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=1 lastMonitorStartDate=2011/07/14 07:48:00 lastMonitorEndDate=-1 relocationState=0 relocationPr
Parameters Table 64 GetZeroPageReclaimStatus Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP/Smart volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=5 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 *****: The value is encoded by the CLI.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli ModifyArrayReservation -o "D:\logs\ModifyArrayReservation.
Parameter name Status Description Specify the device number of the logical unit of the THP/Smart pool volume whose external LDEV tier rank is changed to High. highdevnums Optional# Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values.
and serialnum parameters, Pool for the subtarget parameter, and LogicalUnit for the poolsubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit. Specify the devNum value of a logical unit, for which the external LDEV tier rank is changed from the THP/Smart pool volume in a THP/Smart pool, to a parameter such as highdevnums, middledevnums, or lowdevnums.
journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,784 thpPoolID=57 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=0 managementAreaPoolID=-1 externalTierRank=High List of 1 PoolTier elements: An instance of PoolTier objectID=***** tierID=0 capacityInKB=6,150,144 freeCapacityInKB=6,064,128 usageRate=1 raidLevel=Unknown combination=Unknown rpm=-1 diskType=-1 substance=1 *****: The values are encoded by the CLI. ModifyLabel ModifyLabel modifies the label of a logical unit.
Parameter name Status Description Label character string You can use the following characters: label Required A-Z a-z 0-9 ! # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ] ^ _ { | } ~ and spaces You can use a character string of 1-64 bytes for a label. A label character string cannot begin or end with spaces. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Format hdvmcli [URL] ModifyLogicalUnit [options] serialnum=serial-number model=model devnum=device-number {commanddevice={true|false}|commanddevicesecurity={true|false}} Parameters Table 68 ModifyLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system of the LU model Required Model of the storage system of the LU Device number of the LU For P9500 and XP24000/XP20000: Required devnum Specify this parameter as a decimal number or colo
Command execution example hdvmcli ModifyLogicalUnit -o "D:\logs\ModifyLogicalUnit.log" "serialnum=10001" "model=XP1024" "devnum=1" "commanddevice=true" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: • This command can be used only with P9500 and XP24000/XP20000. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.3 or later.
Format for XP24000/XP20000 When the command is used to expand a THP pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID adddevnums=device-number-of-logical-unit [threshold=THP-pool-threshold-1] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] When changing the thresholds only: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID [threshold=THP-pool-threshold-1] [ov
Parameter name Status Description Threshold2 of the THP/Smart pool (%) The threshold2 of the THP/Smart pool is the usage rate of the THP/Smart pool. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: Optional threshold2#1 (P9500) A value cannot be specified for threshold2. For P9500 whose microcode version is 70-01-4X-XX/XX or later: If you specify this parameter, threshold2mode must be set to 1.
Parameter name Status Description Over provisioning limit threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: Specify an integer from 0 to 65534. You need to specify a value larger than the one specified for overprovisioningwarning. Specify -1 to cancel an already set threshold value.
Parameter name Status Description Execution cycle of performance monitoring and hardware tier relocation This parameter can be specified when automigration is set to enable. One of the following values can be specified. migrationinter- Optional val#1, #5 (P9500) • 0: 30 minutes • 1: 1 hour • 2: 2 hours • 4: 4 hours • 8: 8 hours • 24: 24 hours You can specify 0 only when the microcode version is 70-02-XX-XX/XX or later.
XP24000/XP20000, these threshold values are specific to and managed by the Device Manager server. #4 The over-provisioning percent is the percentage of the total size of all THP/Smart volumes with respect to the THP/Smart pool size. For example, if the THP pool size is 500 GB and the total size of all THP volumes is 400 GB, the threshold value will be 80 %.
. RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tc
tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 *****: The values are encoded by the CLI. ModifyPort ModifyPort modifies port attributes and host storage domain attributes. NOTE: • Even if the topology value is changed, the change might not be immediately applied. In such cases, refresh the storage system by using the AddStorageArray command after waiting for about a minute. • Even if the value for fibre channel is changed, the change might not be immediately applied.
Format for P9500 (when an FCoE connection is used) hdvmcli [URL] ModifyPort [options] serialnum=serial-number model=model {port=port-number|portname=port-name} [fibreaddr=new-fibre-channel-address-for-the-port] [lunsec={true|false}] [domain=domain-ID] [nickname={new-host-storage-domain-name|existing-host-storage-domain-name}] [newdomainnickname=new-host-storage-domain-name]] [hostmode=host-mode-for-port] [hostmodeoption=host-mode-option-list] [wwn=WWN wwnnickname=WWN nickname] [wwn=WWN newwwnnickname=new-WW
Parameter name Status Description 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.
NOTE: This command can be used only with P9500 and XP24000/XP20000. For XP24000/XP20000, the following conditions must be satisfied when specifying a THP volume: • If you are assigning a THP volume to a THP pool, the THP volume must not already be assigned to a THP pool. • If you are assigning a THP volume to a THP pool, the status of the THP pool must not be Blocked. • If you are assigning a THP pool, the over-provisioning percent must be less than the over provisioning limit threshold.
poolid=pool-ID-of-THP-pool [threshold=usage-rate-threshold-of-THP-volumes] When the command is used to release the assignation between THP volumes and a THP pool: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=false devnums=device-number-of-THP-volume When the command is used to change the usage rate threshold of THP volumes: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-THP-volume threshold=usage-rate-thres
Parameter name Status Optional capacity (P9500) Description Capacity of the THP/Smart volume after expansion (KB) Specify the capacity of the expanded volume. The maximum value that can be specified is 64424505600.
Command execution example 1 In this example, the ModifyVirtualVolume command changes the usage rate threshold for the THP volume (devNum: 00:30:00) to 15% (threshold: 15) in the storage system (serialnum: 15065, model: XP24000). hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=XP24000 serialnum=15065 devnums=00:30:00 threshold=15 Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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) . List of 1 Lu elements: An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
threshold=-1 systemDisk=0 encrypted=-1 thpTier0ConsumedCapacityInKB=0 thpTier1ConsumedCapacityInKB=0 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=enable *****: The value is encoded by the CLI. Command execution example 3 In this example, the ModifyVirtualVolume command makes the Smart volumes (devNum: 00:00:C4) in the storage system (serial number: 15000, model: P9500) not subject to the hardware tier relocation. hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.
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 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=disable *****: The value is encoded by the CLI.
Parameters Table 73 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.
NOTE: To specify a storage system and then refresh its configuration information, use the AddStorageArray command. When the storage system already exists, the AddStorageArray command performs a re-discovery operation on the storage system and refreshes the registered information on the Device Manager server database.
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) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.116.106 userID=root ] [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.40.1 ] . .
Parameters Table 75 RunZeroPageReclaim Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP/Smart volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
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 snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=5 tcaPoolID=-1 thpPoolVolControlFlag=-1 manage
Parameters Table 76 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 78 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 name Optional 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 port Optional 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 wwn Required If you use the HostScan command to register a host in Device Manager, every WWN that you specify in the wwn parameter must be a WWN used by that host only. In this case, the value specified for the domainnickname parameter is used as the name of the host. For details about the HostScan command, see “HostScan” on page 260.
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 80 DeleteLun command parameters Parameter name Status Description serialnum Required Serial number of the path's storage system model Required Model of the path's storage system Port number of the path port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error 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 82 DeleteWWNForHostStorageDomain command parameters Parameter name Status Description serialnum Required Serial number of the storage system for the host storage domain model Required Model of the storage system for the host storage domain Port ID of the host storage domain Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error 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 86 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 89 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 91 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 393: 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 92 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 95 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 97 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 100 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=XP1024/128 displayArrayFamily=XP1024/128 An instance of StorageArray arrayFamily=XP12K/10K/SVS200 displayArrayFamily=XP12K/10K/SVS200 An instance of StorageArray arrayFamily=XP24K/20K displayArrayFamily=XP
Parameters Table 102 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.
hdvmcli [URL] AddConfigFileForReplication [options] [groupname=copy-group-name] pvolhostid=host-ID pvolinstancenum=instance-number [pvolportnum=port-number] svolhostid=host-ID svolinstancenum=instance-number [svolportnum=port-number] pvolarraytype=model pvolserialnum=serial-number pvoldevnum=device-number [pvolportid=port-number|pvolportname=port-name] [pvolpoolid=pool-ID] svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=port-number|svolportname=port-name] [svolpoolid=poo
Parameter name Status Description 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. Port number of the HORCM instance for managing the P-VOL Depending on the host OS, specify the appropriate value: pvolportnum Optional • In Solaris, specify an integer from 0 to 65535.
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.
• When using Method 1 (when adding a copy pair definition to a copy group in which no copy pair has been defined): See No. 2, No. 3, No. 5, and No. 6 in the table below. • When using Method 2: 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 104 How to obtain parameter values (AddConfigFileForReplication command) 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 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. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs. • You must specify a formatted LDEV. If you specify an unformatted LDEV, a copy pair is not created.
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. • 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.
Parameter name Status Description Specify one of the following values: • split: Split the copy pair. • resync: Re-synchronize the copy pair from the primary volume (P-VOL) to the secondary volume (S-VOL). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot copy pair, the copy pair is split after the re-synchronization. For this reason, the paired volume status is set to PAIR, and then changes toPSUS.
Parameter name Status Description Copy pace You can specify an integer from 1 to 15. copytracksize Optional When changing the copy pace for an identified copy pair, specify the parameters pvolserialnum, pvoldevnum, svolserialnum, and svoldevnum. When using one operation to change the copy paces of all copy pairs, omit these parameters. If split or resync is specified for the operation parameter, this parameter will be ignored.
objectID=***** replicationGroupID=12 groupName=HCMD_CG000d pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=3 svolInstanceNumber=12 svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
5 Output items This chapter describes items that are output by Device Manager CLI commands. The items are output for each instance as attributes of Device Manager instances. The meaning of items that have the same name might differ for different instances. When you reference an output item, check the instance of the item. Alert instance The Alert instance is output when the GetAlerts command (see “GetAlerts” on page 279) is executed.
ArrayGroup instance The ArrayGroup instance is output when the following commands are executed: • • • • • • • • AddExternalArrayGroup, page 45 AddPool, page 71 AddVirtualVolume, page 87 GetStorageArray (subtarget=ArrayGroup) , page 125 GetStorageArray (subtarget=FreeSpace) , page 136 GetStorageArray (subtarget=PDEV) , page 162 GetStorageArray (subtarget=Pool) , page 164 ModifyPool, page 190 Table 111 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 79 AddVirtualizationServer, page 245 GetHost, page 249 GetStorageArray (subtarget=CommParameters) , page 129 ModifyVirtualizationServer, page 272 RefreshStorageArrays, page 215 RefreshVirtualizationServer, page 273 Table 113 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 130) 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 249) is executed.
ExternalPathInfo instance The ExternalPathInfo instance is output when either of the following commands is executed: • GetStorageArray (subtarget=ArrayGroup) , page 125 • AddExternalArrayGroup, page 45 Table 117 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 87 • GetStorageArray (subtarget=FreeSpace) , page 136 Table 120 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 173) is executed. Table 124 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 147) 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 125 GetStorageArray (subtarget=LDEV) , page 144 GetStorageArray (subtarget=LogicalUnit) , page 149 AddLabel, page 60 ModifyLabel, page 187 Table 130 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 226 GetLogicalGroup, page 223 GetStorageArray (subtarget=ArrayGroup) , page 125 GetStorageArray (subtarget=HostStorageDomain) , page 140 GetStorageArray (subtarget=LogicalUnit) , page 149 GetStorageArray (subtarget=Path) , page 158 GetStorageArray (subtarget=Port) , page 171 Table 133 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 71 GetStorageArray (subtarget=ArrayGroup) , page 125 GetStorageArray (subtarget=PDEV) , page 162 GetStorageArray (subtarget=Pool) , page 164 ModifyPool, page 190 Table 134 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 71 AddTieredPoolOperation, page 85 GetPoolShrinkStatus, page 113 GetStorageArray (subtarget=Pool) , page 164 GetTieredPoolStatus, page 179 ModifyExternalTierRank, page 184 ModifyPool, page 190 ShrinkPool, page 219 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 Indicates whether the value output to threshold2 is the value determined by the storage system. threshold2Mode If the storage system is P9500 and poolFunction is 5, either of the following values is output: • 0: Value determined by the storage system • 1: Value set by the user This information is unknown or invalid for other cases (-1 is output).
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.
• GetStorageArray (subtarget=Pool) , page 164 • ModifyExternalTierRank, page 184 • ModifyPool, page 190 Table 137 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 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 commands are executed: • GetStorageArray (subtarget=Port) , page 171 • ModifyPort, page 199 Table 138 Port instance attributes Attribute Description objectID Object ID of the port Port name name This item is
Attribute Description 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. portNumber Currently, this information does not apply to storage systems (-1 is output). keepAliveTime Currently, this information does not apply to storage systems (-1 is output).
Attribute Description 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 (lower 4 ports) • 7: High-speed mode is set by the 32HS package.
Storage system Values output for the type attribute • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-Tachyon (4 ports) • 44: Fibre-Tachyon (8 ports) • 45: Fibre-Tachyon (16 ports) • 46: NAS (2 ports) • 48: NAS (4 ports) • 49: FICON (4 ports) • 50: FICON (8 ports) XP12000/XP10000/SVS200 • 51: iSCSI (4 ports) • 52: iSCSI (4 ports) • 55: Fibre-Tachyon (8 ports) • 56: Fibre-Tachyon (16 ports) • 57: Fibre-Tachyon (4 ports) • 58: Fibre-Tachyon (8 ports) • 59: Fibre-Tachyon (16 ports) • 60: Fibre-Tachyon (
ReplicationControllerPair instance The ReplicationControllerPair instance is output when the GetReplicationControllerPair command (see “GetReplicationControllerPair” on page 309) 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 311 Table 142 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 293 DeleteReplication, page 305 GetHost, page 249 GetStorageArray (subtarget=Pool) , page 164 GetStorageArray (subtarget=ReplicationInfo) , page 176 ModifyReplication, page 311 Table 143 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 • 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 LUSE • 24: Suspending
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 173 GetStorageArray (subtarget=ReplicationInfo) , page 176 GetTieredPoolStatus, page 179 GetZeroPageReclaimStatus, page 181 ModifyExternalTierRank, page 184 ModifyLogicalUnit, page 188 ModifyPool, page 190 ModifyPort, page 199 ModifyPortController, page 206 ModifyVirtualVolume, page 207 RefreshStorageArrays, page 215 RunZeroPageReclaim, page 217 ShrinkPool, page 219 NOTE: For SMI-S Enabled storage systems, valid information is out
Attribute capacityInGB#1 cacheInMB Description An attribute for compatibility. For details, see Table 146. Cache size (in MB) An attribute for compatibility. sharedMemoryInMB For details, see Table 146. Number of spare drives numberOfSpareDrives -1 is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, or SMI-S Enabled storage systems. freeCapacityInGB#1 allocatedCapacityInGB#1 autoLunCapacityInGB#1 onDemandCapacity- An attribute for compatibility. For details, see Table 146.
Attribute Description 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 Snapshot 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) URLLink instance The URLLink instance is output when the following commands are executed: • AddURLLink, page 275 • GetURLLink, page 281 Table 147 URLLink instance attributes Attribute Description objectID Object ID of URLLink name Name of the URLLink 374 Output item
Attribute Description Additional description of the URLLink description This item is output only when an additional description is registered.
• GetStorageArray (subtarget=LogicalUnit) , page 149 Table 150 VolumeConnection instance attributes Attribute Description objectID Object ID of VolumeConnection Name of VolumeConnection name This item is output if it has been registered.
• • • • • • • • • AddWWNForHostStorageDomain, page 231 GetHost, page 249 GetStorageArray (subtarget=HostStorageDomain) , page 140 GetStorageArray (subtarget=LogicalUnit) , page 149 GetStorageArray (subtarget=Path) , page 158 GetStorageArray (subtarget=Port) , page 171 MergeHost, page 265 ModifyHost, page 266 ModifyPort, page 199 Table 151 WWN instance attributes Attribute Description World Wide Name WWN A World Wide Name is usually assigned to the HBA in the server.
Output items
6 Batch functionality This chapter describes the commands that can be executed by using the batch functionality, how to create batch files, how to use the batch functionality, and the actions to be taken if an error occurs. 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 261. 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 396 Conventions for creating mapping definition files, page 397 Examples of input files, page 398 ImportHosts, page 261 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 4086. 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 144 • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo GetStorageArray (subtarget=LogicalUnit) , page 149 MFReplicationInfo mfreplicationsubinfo GetStorageArray (subtarget=MFReplicationInfo) , page 154 Path pathsubinfo GetStorageArray (subtarget=Path) , page 158 Pool poolsubinfo GetStorageArray (subtarget=Pool) , page 164 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 412. 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 EMPTY>
fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percentUsed CDATA #IMPLIED> lastUpdated CDATA #IMPLIED> portISCSIName 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>
displayDevNum CDATA #IMPLIED> portID CDATA #IMPLIED> portName CDATA #IMPLIED> domainID CDATA #IMPLIED> scsiID CDATA #IMPLIED> LUN CDATA #IMPLIED> wwnSecurityValidity CDATA #IMPLIED>
monitorStartTime CDATA #IMPLIED> monitorEndTime CDATA #IMPLIED> monitoringMode CDATA #IMPLIED> externalMixCompatible CDATA #IMPLIED> monitoringState CDATA #IMPLIED> lastMonitorStartDate CDATA #IMPLIED> last
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 430 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 431.
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, 283 AddExternalArrayGroup, 45 AddHost, 240 AddHostInfo, 241 AddHostRefresh, 243 AddHostStorageDomain, 50 AddLabel, 60 AddLogicalUnit, 61 AddLun, 226 AddLUSE, 67 AddPool, 71 AddReplication, 293 AddStorageArray, 79 AddTieredPoolOperation, 85 AddURLLink, 275 AddVirtualizationServer, 245 AddVirtualVolume, 87 AddWWNForHostStorageDomain, 231 B batch commands that can be executed, 379 execution example, 386 execution results, 386 C c
E example of creating host information file (CSV file), 399 mapping definition file, 399 F FormatLU, 108 G GetAlerts, 279 GetArrayReservation, 113 GetHost, 249 GetHostInfo, 258 GetLogicalGroup, 223 GetPoolShrinkStatus, 113 GetReplicationControllerPair, 309 GetServerInfo, 280 GetStorageArray, 118 GetStorageArray (subtarget not specified), 122 GetStorageArray (subtarget=ArrayGroup), 125 GetStorageArray (subtarget=CommParameters), 129 GetStorageArray (subtarget=Component), 130 GetStorageArray (subtarget=Exte
ModifyLogicalUnit, 188 ModifyPool, 190 ModifyPort, 199 ModifyPortController, 206 ModifyReplication, 311 ModifyVirtualizationServer, 272 ModifyVirtualVolume, 207 V version Device Manager CLI, 30 N notes Device Manager CLI, 41 O optimization of regions of unused capacity, 61 options, 27 output files check results file, 394 error information file, 394 for ImportHosts, 394 output format CSV format, 409 execution results, 409 XML format, 411 overview Device Manager CLI, 17 Device Manager licenses, 18 P param