HP StorageWorks P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96066 Fourth edition: August 2011
Legal and notice information © Copyright 2010-2011 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 ...........................................................................................................
DeletePool ......................................................................................................................... 90 DeleteStorageArray ............................................................................................................ 91 DeleteVirtualVolume ............................................................................................................ 92 FormatLU ........................................................................................................
HostScan ........................................................................................................................ MergeHost ...................................................................................................................... ModifyHost ..................................................................................................................... ModifyHostInfo .............................................................................................................
ServerInfo instance .................................................................................................................. StorageArray instance ............................................................................................................. URLLink instance ..................................................................................................................... VirtualDisk instance .........................................................................................
A Connecting to P9000 mainframe agent ............................................ 385 About connecting to P9000 mainframe agent ............................................................................ Setting up the mainframe host environment ................................................................................. Setting up the Device Manager environment ............................................................................... Registering the mainframe host in Device Manager ...........
Figures 1 Example of executing the AddExternalArrayGroup command ........................................ 45 2 Relationship of attributes (total size of the storage system) ........................................... 338 3 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 338 4 Relationship of attributes (the sizes of the volumes) ....................................................
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 17 2 hdvmcli variable syntax ........................................................................................... 24 3 hdvmcli options ...................................................................................................... 25 4 hdvmcli return values ...............................................................................................
33 DeleteLabel command parameters ............................................................................. 87 34 DeleteLogicalUnit command parameters ..................................................................... 88 35 DeleteLUSE command parameters ............................................................................. 90 36 DeletePool command parameters .............................................................................. 91 37 DeleteStorageArray command parameters ..............
70 ModifyVirtualVolume command parameters ............................................................. 189 71 RefreshStorageArrays command parameter .............................................................. 191 72 RunZeroPageReclaim Command Parameters ............................................................. 193 73 ShrinkPool command parameters ............................................................................ 195 74 GetLogicalGroup command parameters ....................................
107 ArrayReservation instance attributes ......................................................................... 288 108 CommParameters instance attributes ........................................................................ 288 109 Component instance attributes ................................................................................ 289 110 ConfigFile instance attributes .................................................................................. 290 111 Datastore instance attributes ..
144 WWN instance attributes ...................................................................................... 341 145 Specification conditions for parameters .................................................................... 345 146 Options and their corresponding properties ............................................................. 358 147 Parameters that cannot be specified in the GetStorageArray command when CSV output is specified ...............................................................
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.
Item Functions available with the Core CLI/SMI-S license Storage systems Same as for a full license GUI If the Core CLI/SMI-S license is used to log in, only the items related to user management in the Administration tab are displayed. Users with the Core CLI/SMI-S license can use only the functions displayed in the Administration tab. Device Manager CLI The logical group command (GetLogicalGroup) cannot be used.
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.
When using the same JRE as the Device Manager server When the Device Manager CLI uses the same JRE as the Device Manager server, specify the path of that JRE in the HDVM_CLI_JRE_PATH environment variable. The HP P9000 Command View Advanced Edition Suite Common Component (abbreviated hereafter as Common Component) installation directory is included in the JRE path.
Before setting up an environment on the management client, set up secure communication from the Device Manager server. If you reconfigure communication security from the Device Manager server, the Device Manager server certificate is changed. If this occurs, you need to replace the management client certificate. To set up an environment from the management client that the Device Manager CLI is executed from: 1.
• Use the server name set in the Device Manager server certificate as the host name for the Device Manager server URL. • Use the HTTPS port for the Device Manager server URL (2443, unless configured differently in the server's configuration file). Setting the HDVM_CLI_MEM_SIZE environment variable To ensure successful CLI execution, the HDVM_CLI_MEM_SIZE environment variable must be set to an appropriate value. The default value is 256 MB.
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 7 on page 357. • The Device Manager CLI only supports ASCII code characters.
Variable Function Parameters that are passed to the server as part of a request. The required and optional parameters depend on the command requested. Each parameter is represented as a combination of a parameter name and a parameter value, such as parameter-name = parameter-value. The parameter name is not case sensitive. If you want to specify a value that includes spaces, enclose the value in double quotation marks ("), as in hostmode="Windows Extension, Solaris Extension".
Option Argument for the option Status Description The file for storing the execution results Sends output to the specified file, instead of the console. -o or #2 --output file-name Optional When this option is specified, the command does not send the execution results to the standard output. If you specify an existing file, that file is overwritten. The format in which the execution results are output. You can use this option only when you execute the GetStorageArray command.
ipaddress=192.168.2.2 Whenever a parameter value requires one or more space characters, double quotes can be used to enclose the parameter value, as follows: description="Our Newest Array" Each command might have required parameters, optional parameters, or both, and you can specify any parameter in the application's properties file. If a parameter is specified both from the command line and in the properties file, the value from the command line is used.
C:\hdvm> hdvmcli help command-name For example, to display command Help for the GetServerInfo command, specify the following: C:\hdvm> hdvmcli help GetServerInfo • Help for the batch function The Device Manager CLI contains a batch function. Help for the batch function displays the format for specifying batch files from the command line, the commands that can be specified in batch files, and the format used in batch files.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y TBD Y -- -- -- AddVirtualVolume Creates virtual volumes and assigns THP volumes (virtual volumes) to a THP 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.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Obtains the execution status of a THP-pool shrink operation. Y -- -- -- GetTieredPoolStatus TBD Y -- -- -- GetStorageArray# Obtains information about a storage system. Y Y Y Y GetZeroPageReclaimStatus Obtains the execution status of a zero-page reclaim operation. Y Y -- -- ModifyArrayReservation Extends the maximum period for which a specified storage system is locked. Y Y Y Y ModifyLabel Modifies a label.
Command name Description RunZeroPageReclaim Releases unused capacity in THP volumes (virtual volumes). ShrinkPool Shrinks a THP pool. XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- -- Y -- -- -- P9500 XP1024/ XP128 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. # You can use the subtarget parameter to specify the device information you wish to obtain.
--: 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. AddHostInfo Registers host-based information about a LUN into the Device Manager server database. AddHostRefresh Refreshes information that can be acquired from the Device Manager agent, about a host managed by the Device Manager server.
Command name Description GetURLLink Obtains information about the URLLinks that are set for a Device Manager object managed by the Device Manager server. Table 10 Replication commands and related storage systems XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y -- Creates copy pairs. Y Y Y -- DeleteReplication Deletes copy pairs. Y Y Y -- GetReplicationControllerPair Obtains RCU (remote path) information registered in the MCU in storage systems managed by the Device Manager server.
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# 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 ModifyLabel Admin or Modify Modify
All Resources must be assigned as a resource group.
All Resources must be assigned as a resource group. Table 15 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 a storage system is locked, you can execute storage system commands and LUN commands. You can execute the GetStorageArray command even if another user has locked the storage system.
NOTE: You cannot use the GUI to operate a storage system when it is locked. If you want to operate a locked storage system, use Device Manager CLI commands.
Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli AddArrayReservation -o "D:\logs\AddArrayReservation.
Parameter name Status Description Group number of the external parity group externalgrpnum Optional Specify the group number of the external parity group to be created. You can specify an integer from 1 to 16384. If this parameter is omitted, a value is automatically set by Device Manager. Port name of the port to which the external storage system is connected If you specify multiple (alternate) paths, use a comma to separate each entry.
Parameter name Status Description Option information (cache mode) of the logical unit Either of the following values can be specified: • true: Valid • false: Invalid cachemode Optional If the cachemode parameter is omitted, the following values are set: • When the inflowcontrol parameter is specified, true is set. • When the inflowcontrol parameter is omitted If the external volume is a command device, false is set. If the external volume is not a command device, true is set.
Parameter name Status Description Unit for the value to be specified in the capacity parameter Either of the following values can be specified: • KB capacitytype Optional • block If this parameter is omitted, KB is set. This parameter cannot be specified if none is specified in the luoption parameter or if the luoption parameter is omitted. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
Command execution example Figure 1 Example of executing the AddExternalArrayGroup command The following shows an example of executing the AddExternalArrayGroup command to set up the configuration shown in Figure 1: hdvmcli AddExternalArrayGroup -o "D:\logs\AddExternalArrayGroup.log" model=XP20000 serialnum=25011 portname=CL3-F,CL7-F externalwwn=50.06.0E.80.10.22.8B.50,50.06.0E.80.10.22.8B.52 externallun=1,0 externalgrpnum=27 Command execution result RESPONSE: An instance of StorageArray . .
cuInfo= openTotalCapacity=0 openAllocatedCapacity=0 openFreeCapacity=0 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=0 openUnallocatedCapacity=0 openUnallocatedActualCapacity=0 openReservedCapacity=0 openReservedActualCapacity=0 type=1 volumeType=1 encrypted=-1 protectionLevel=-1 t
NOTE: When AddHostStorageDomain adds a host storage domain, LUN security for the target port is automatically enabled. Make sure that the I/Os of the target port are stopped.
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 233.
Storage system Value of hostmode Possible values are: • 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 Possible values are: • Standard • Sequent • HP • Solaris • Netware • Windows • Tru64 • AIX XP1024/XP128 • OPEN-VMS The following value relies on the microcode version.
For details, see the documentation of the LUN management product for the storage system you are using. Table 22 Values that can be specified in the hostmodeoption parameter hostmodeoption values Description 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 Specify this value when you are using XP12000/XP10000/SVS200 and 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.3 TL04 or later 24 - Windows Server 2003 SP1 - Red Hat Enterprise Linux AS 4 Update 1 or later OSs other than above cannot access volumes that exceed 2 TB.
hostmodeoption values Description 51 Specify this value when you are using XP24000/XP20000 and want to use Round Trip to improve True Copy performance. 54 Specify this value when you are using P9500 with a microcode version of 70-014X-XX/XX or later and want to use the VMware ESX Server. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
hostModeOption=7;40 displayName=CL7-A-15 domainType=0 nickname=HCMD0030f *****: The value is encoded by the CLI. 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, or 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: h
groupnum=parity-group-number|arraygroupname=parity-group-name} capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] Parameters Table 24 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 paramet
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 Status Optional numoflus (P9500, XP24000/XP20000, and XP12000/ XP10000/SVS200) Description Number of LUs to be created 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: Optional format (P9500, XP24000/XP20000, and XP12000/ XP10000/SVS200) • none: Creates an unformatted LDEV. • 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.
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) .
NOTE: • When you add a LUSE volume with the luseoption parameter set, specify a LDEV in which a path is set as the first LDEV. If a LDEV without a path set is specified as the first LDEV, an error will occur. • When a LUSE volume is added with the luseoption parameter set, the extended LUSE volume might not be able to be recognized, based on the host. In this case, restart the host.
Command execution example hdvmcli AddLUSE -o "D:\logs\AddLUSE.log" "serialnum=15001" "model=XP1024" "devnums=1001,1002" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted
consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 *****: The values are encoded by the CLI. AddPool AddPool creates a THP pool in a targeted storage system. NOTE: • This command can be used only with P9500 and XP24000/XP20000.
• If more than one internal volume is specified for a THP pool, up to three types of logical units with different drive types or rotational speeds can be used.# However, if the microcode version is earlier than 70-01-40-XX/XX, logical units that have different drive types or rotational speeds cannot be used for a THP pool. • To specify more than one logical unit for a pool for Smart Tiers, external volumes cannot be used.
[threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] devnums=device-number-of-logical-unit [tiercontrol={enable|disable}] [automigration={enable|disable}] [migrationinterval={0|1|2|4|8|24}] [monitorstarttime=start-time-of-performance-monitoring] [monitorendtime=end-time-of-performance-monitoring] [monitoringmode={0|1}] Format for XP24000/XP20000 hdvmcli [URL] AddPool [options] model=model serialnum=serial-number [pool
Parameter name Status Description Threshold2 of the THP pool (%) The threshold2 of the THP pool is the usage rate of the THP pool. For P9500 whose microcode version is earlier than 70-014X-XX/XX: A value cannot be specified for threshold2. Optional threshold2 (P9500) For P9500 whose microcode version is 70-01-4X-XX/XX or later: If you specify this parameter, threshold2mode must be set to 1. Specify an integer in the range from 1 to 100.
Parameter name Status Description Over provisioning limit threshold (%) This is a threshold value related to the over-provisioning percent.#2 Specify a threshold value used to issue an excess limit warning. For P9500: Specify an integer from 0 to 65534. You need to specify a value larger than the one specified for overprovisioningwarning. If this parameter is omitted, -1 is set. -1 indicates that a threshold value is not set.
Parameter name Status Description Execution cycle of performance monitoring and hardware tier relocation. If you specify this parameter, you must also specify automigration=enable. One of the following values can be specified. • 0: 30 minutes • 1: 1 hour migrationinterval Optional • 2: 2 hours (P9500) • 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.
#2 The over-provisioning percent is the percentage of the total size of all THP volumes with respect to the THP pool size. For example, if the pool size for Thin Provisioning Software is 500 GB and the total size of all volumes for Thin Provisioning Software is 400 GB, the threshold value will be 80 %. #3 There must be an interval of at least one hour between the times specified for monitorstarttime and monitorendtime. The same time cannot be specified for monitorstarttime and monitorendtime.
freeCapacityInKB=6,150,144 usageRate=0 numberOfPoolVols=1 numberOfVVols=0 capacityOfVVolsInKB=0 clprNumber=0 raidLevel=combination= volAlertNotice=-1 overProvisioningPercent=-1 overProvisioningWarning=-1 overProvisioningLimit=-1 rpm=-1 diskType=-1 tierControl=enable autoMigration=enable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPE
capacityInKB=6,150,144 freeCapacityInKB=6,150,144 usageRate=0 raidLevel=RAID5 combination=3D+1P rpm=15,000 diskType=4 substance=0 *****: The values are encoded by the CLI. AddStorageArray AddStorageArray searches for storage systems, and registers the storage system information (such as the IP address, user ID, and password) into the Device Manager server database.
Parameters Table 27 AddStorageArray command parameters Parameter name Status Description IP address ipaddress Required family Required displayfamily Required or optional Specify the IP address of the storage system. For P9500 and XP24000/XP20000, this parameter can be specified by using an IPv6 IP address. Family of the storage system Display name of the storage system family You cannot omit this parameter when using the command to perform initial registration of information.
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP1024@172.16.45.1 description=XP1024 (10001) at 172.16.45.
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=0 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,039,003,476 autoFormatLU=-1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocatedActualCapacity=1,578,120,480 openUnallocatedCapacity=2,442,665,520 openUnallocatedActualCapacity=2,442,665,520 openReservedCapacity=4,806,720 openReservedActualCapacity=4,806,720 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 List of 1 CommParamete
*****: The value is encoded by the CLI. AddVirtualVolume AddVirtualVolume creates THP volumes (virtual volumes) in a target storage system. This command also assigns the THP volumes to be added to a target THP pool. NOTE: This command can be used only with P9500 and XP24000/XP20000. If you use the poolid parameter to specify the pool ID of a THP pool, the THP volumes that are created are assigned to that THP pool.
NOTE: Note the following when using this command with XP24000/XP20000: • HP recommends that you do not create more than one volume for Thin Provisioning Software in a virtual parity group. Also, if the microcode version is 60-04-XX-XX/XX or later and the system option 726 is set to ON, you cannot create more than one volume for Thin Provisioning Software in a virtual parity group.
hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-virtual-volumes [numoflus=number-of-volumes-for-Thin-Provisioning-Software] [devnum=device-number-of-logical-unit] [clprNumber=CLPR-number] [poolid=pool-ID-of-pool-for-Thin-Provisioning-Software [threshold=usage-rate-threshold-of-volumes-for-Thin-Provisioning-Software]] [capacitytype={KB|block}] When the command is used to create volumes for Thin Provisioning Software in an existing virtual parity group: hdvmc
Parameter name Status Description Capacity of THP volumes (KB). You can specify the following values: For P9500: You can use the capacitytype parameter to change the unit of capacity to blocks. - 48000 to 64424505600 (in KB) - 96000 to 128849011200 (in blocks) capacity Required For XP24000/XP20000: You can use the capacitytype parameter to change the unit of capacity to blocks.
Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. arraygroupname: Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command.
substance=0 slprNumber=0 clprNumber=0 cuInfo= openTotalCapacity=419,430,400 openAllocatedCapacity=0 openFreeCapacity=419,430,400 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=0 openUnallocatedCapacity=419,430,400 openUnallocatedActualCapacity=0 openReservedCapacity=0 openReservedAc
thpPoolID=0 threshold=10 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpTy
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=10 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=12,289 displayName=00:30:01 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=subst
*****: The values are encoded by the CLI. DeleteArrayReservation DeleteArrayReservation unlocks the target storage system. Parameters Table 30 DeleteArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 31 DeleteExternalArrayGroup command parameters Parameter name Status Description serialnum Required Serial number of the storage system where you want to delete the external parity group model Required Model of the storage system where you want to delete the external parity group arraygroupnames Required List of external parity group names to be deleted Use a comma to delimit multiple values.
Parameter name Status Description The port ID of the host storage domain to delete Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name for the host storage domain to delete portname Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
Command execution example hdvmcli DeleteHostStorageDomain -o "D:\logs\DeleteHostStorageDomain.log" "serialnum=10001" "model=XP1024" "port=16" "domain=1" "deletionoption=lusekeep" Command execution result RESPONSE: (Command completed; no data returned) DeleteLabel DeleteLabel deletes a label from a logical unit.
Command execution example hdvmcli DeleteLabel -o "D:\logs\DeleteLabel.log" "serialnum=10037" "model=XP24000" "devnums=00:00:00,00:00:01" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLogicalUnit DeleteLogicalUnit deletes the LU and corresponding LDEV from the storage device. With P9500, XP24000/XP20000, and XP12000/XP10000/SVS200, you can delete multiple logical units at once.
Parameter name Status Description Device number of the LU devnums Optional This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, use the xx:yy format, where xx is the CU number and yy is the LDEV number. For P9500 and XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If you omit ww, the LDKC number is regarded as 0.
Parameters Table 35 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 The LUSE device number must be valid in the storage system. devnum Required This parameter can be specified in decimal, and in colon-separated hexadecimal.
NOTE: This command can be used only with P9500 and XP24000/XP20000. To delete a THP pool, all assignments between the THP pool and the THP volumes (virtual volumes) must be released. For details about releasing the assignations between the THP pool and the THP volumes, see “ModifyVirtualVolume” on page 187.
NOTE: If execution of the DeleteStorageArray command results in an error, take appropriate action according to the error message, and then re-execute the DeleteStorageArray command. When the DeleteStorageArray command is executed, the configuration information of the target storage system is divided into transactions, and then deleted from the Device Manager database.
NOTE: This command can be used only with P9500 and XP24000/XP20000. For P9500 and XP24000/XP20000, to delete a THP volume, the following conditions must be satisfied: • The THP volume does not have any paths. • To delete specified THP volumes, Open Volume Management must be installed in the storage system. • The THP volume has a guard mode of Read/Write.
Parameter name deletionoption Status Description Optional Specifies whether to delete virtual volumes that have not been released from the pool for Thin Provisioning Software. (XP24000/XP20000) To delete such volumes for Thin Provisioning Software, specify force. Name(s) of the virtual parity group(s). arraygroupnames Use a comma to delimit multiple values. Optional Always specify either the arraygroupnames parameter or the devnums parameter. Do not specify both parameters at the same time.
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 When you specify multiple device numbers, separate the numbers by using a comma as a delimiter. devnums Required This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, use the xx:yy format, where xx is the CU number, and yy is the LDEV number.
only the model and serialnum parameters, LogicalUnit for the subtarget parameter, and LDEV for the lusubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit. Use this devNum value to specify the devnums parameter. Command execution example hdvmcli -t FormatLU model=XP24000 serialnum=10007 devnums=00:04:97,00:04:98 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=100,000 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simpl
differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=100,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=1,176 displayName=00:04:98 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=100,000 lba=200,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=256 chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMo
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. GetPoolShrinkStatus The GetPoolShrinkStatus command obtains the execution status of the THP-pool shrinking operation that was executed by the ShrinkPool command.
Parameter name Status Description model Required Model of the storage system poolid Required Pool ID Parameter values to obtain in advance None. Command execution example In this example, the GetPoolShrinkStatus command obtains the execution status of the operation for shrinking the THP pool whose pool ID is 1 (poolid: 1) in the storage system (serial number: 53039, model: P9500). hdvmcli GetPoolShrinkStatus -o "D:\logs\GetPoolShrinkStatus.
rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable 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 defaultP
currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=1 . . (repeated for other LogicalUnit instances) . *****: The values are encoded by the CLI.
overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable List of 30 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) current
the parameters arraygroupsubinfo and lusubinfo), and other parameters of the GetStorageArray command. Using the GetStorageArray parameter This section describes how to acquire various information by combining the parameter subtarget and the subinfo parameters of the GetStorageArray command. The parameter subtarget: Use this parameter to acquire more specific information about an element than the basic storage system-related information that can be obtained by the GetStorageArray command.
Value of subtarget Information that can be acquired Location FreeSpace Information about the unused capacity in parity groups “GetStorageArray (subtarget=FreeSpace) ” on page 122 HostStorageDomain Information about host storage domains “GetStorageArray (subtarget=HostStorageDomain) ” on page 126 LDEV Information about LDEVs “GetStorageArray (subtarget=LDEV) ” on page 129 LogicalDKC Information about the logical DKC “GetStorageArray (subtarget=LogicalDKC) ” on page 132 LogicalUnit Information
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information Specify LogicalUnit for the parameter arraygroupsubinfo when using this parameter.
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information The following information about pools can be acquired: • LDEV: LDEV information • LogicalUnit: Logical unit information Pool poolsubinfo • PairedPool: Information about the pool on the other side of the copy pair (if a copy pair is set for the pool) • PoolTier: Hardware tier information • ReplicationInfo: Copy pair information The following information about ports ca
GetStorageArray (subtarget not specified) By executing GetStorageArray without specifying the subtarget parameter, you can obtain basic information about all the storage systems that are registered on the Device Manager server.
arrayFamily=XP24K/20K arrayType=XP24000 microcodeVersion=60-06-20/00 agentVersion=05_06_00 productName=RAID600 controllerVersion=60-06-21-00/00 numberOfControllers=2 capacityInGB=6,617 cacheInMB=65,536 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=3,765 allocatedCapacityInGB=2,851 autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,438 largestFreeSpaceInGB=466 capacityInKB=6,938,910,203 freeCapacityInKB=3,948,652,130 allocatedCapacityInKB=2,990,258,073 autoLunCapacityInKB=0 onDem
openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ArrayGroup) GetStorageArray (subtarget=ArrayGroup) obtains information about parity groups.
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 . .
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. GetStorageArray (subtarget=CommParameters) GetStorageArray (subtarget=CommParameters) obtains information about how to access storage systems.
Command execution example In this example, the GetStorageArray (subtarget=CommParameters) command obtains information about how to access a storage system (serial number: 10001, model: XP1024). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_CommParameters.log" subtarget=CommParameters model=XP1024 serialnum=10001 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Component.log" subtarget=Component model=XP24000 serialnum=10007 Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600@10.208.115.220 description=R600 (10007) at 10.208.115.
mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=1,739 numberOfOpenUnallocatedLUs=1,671 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openR
value=3 description=Serious An instance of Component name=DKU Environment value=1 description=Normal An instance of Component name=DKU Fan value=1 description=Normal An instance of Component name=DKU Power Supply value=1 description=Normal *****: The value is encoded by the CLI. GetStorageArray (subtarget=ExternalStorage) GetStorageArray (subtarget=ExternalStorage) acquires information about the external connection of storage systems.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 ExternalStorage elements: An instance of ExternalStorage numOfExternalVolume=112 externalCapacityInKB=251,590,622 GetStorageArray (subtarget=Filter) GetStorageArray (subtarget=Filter) obtains information about the storage system for a specific component.
objectID=***** name=XP1024@172.16.45.
lastRefreshed=1,039,003,476 autoFormatLU=-1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocatedActualCapacity=1,578,120,480 openUnallocatedCapacity=2,442,665,520 openUnallocatedActualCapacity=2,442,665,520 openReservedCapacity=4,806,720 openReservedActualCapacity=4,806,720 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is encoded by the CLI.
Parameter name Status Description Parity group name The following value specification formats can be used: • n • n-n • n-n-n arraygroupname Optional • En-n • V n -1 • X n -1 Here, n is an integer of 1 or greater, while E, V, and X are fixed. If this parameter is specified, the model parameter must also be specified. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
diskSize=146 diskSizeInKB=153,092,096 controllerID=1 totalCapacity=418,184,640 allocatedCapacity=266,772,960 freeCapacity=149,008,320 autoLunCapacity=2,403,360 onDemandCapacity=0 totalFreeSpace=1,847,952 largestFreeSpace=1,847,952 slprNumber=-1 clprNumber=-1 cuInfo= openTotalCapacity=418,184,640 openAllocatedCapacity=266,772,960 openFreeCapacity=149,008,320 openAutoLunCapacity=2,403,360 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 m
*****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
objectID=***** sizeInKB=1,492,992 cylinders=0 fsControlIndex=85 *****: The values are encoded by the CLI. GetStorageArray (subtarget=HostStorageDomain) GetStorageArray (subtarget=HostStorageDomain) obtains the information about host storage domains. Parameters Table 51 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter name Status Description subtarget Required Specify HostStorageDomain.
Parameter name Status Description Specific information about the host storage domain hsdsubinfo Optional The values you can specify are WWN, Path, and FreeLUN. If you specify multiple values at the same time, separate the values by commas. Number of the port containing the host storage domain If port and portname are omitted, information about all ports is displayed. If you specify this parameter, you must also specify the model and serialnum parameters.
Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. domain and port: Obtain these values from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command.
List of 7 FreeLUN elements: An instance of FreeLUN lun=9 An instance of FreeLUN lun=10 . . (repeated for other FreeLUN instances) . List of 1 Path elements: An instance of Path objectID=***** devNum=10 displayDevNum=00:0A portID=23 portName=CL2-H domainID=1 scsiID=15 LUN=10 wwnSecurityValidity=true *****: The values are encoded by the CLI. GetStorageArray (subtarget=LDEV) GetStorageArray (subtarget=LDEV) obtains the information about LDEVs.
Parameter name Status Description Device number of the LDEV that you intend to obtain Specify this parameter when you want to obtain information about a specific LDEV. 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 devnum parameter, information about LDEVs in the specified storage system is obtained. devnum Optional This parameter can be specified in decimal, and in colon-separated hexadecimal.
Parameter name Status Description Label name of logical units for which information is to be obtained label Optional Specify this parameter when you want to obtain information about logical devices for which a specific label is specified. You can specify only one label. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 List of 1 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=100
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter.
securityStatus=2 sequenceNumber=10037 displayArrayFamily=XP24K displayArrayType=XP24000 numberOfLUs=4,443 numberOfAllocatedLUs=630 numberOfUnallocatedLUs=3,813 slprStatus=0 openTotalCapacity=7,934,066,016 openAllocatedCapacity=851,452,736 openFreeCapacity=7,073,394,400 openAutoLunCapacity=9,218,880 openOnDemandCapacity=0 imTotalCapacity=399,016,800 imAllocatedCapacity=0 imFreeCapacity=399,016,800 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=949,912,110 mfAutoLunCapacity=23,239,440 mfOnDemandCapa
Parameters Table 54 GetStorageArray (subtarget=LogicalUnit) command parameters Parameter name Status Description subtarget Required Specify LogicalUnit. 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. Filter for selecting a logical unit Available values are ALL, ASSIGNED, FREE, UNASSIGNED, and RESERVED.
Parameter name Status Description Specific information about the logical unit path pathsubinfo Optional The value you can specify is HostInfo or WWN. If you specify this parameter, you must also specify lusubinfo=Path. Information about the LDEV ldevsubinfo Optional The value you can specify is VolumeConnection. If you specify this parameter, you must also specify the lusubinfo=LDEV. Filter for selecting a volume for Thin Provisioning Software Specify either the pool ID of a THP pool, or Unassigned.
Parameter name Status Description Label name of logical units for which information is to be obtained label Optional Specify this parameter to obtain information about logical units for which a specific label is specified. You can specify only one label. If you specify this parameter, you must also specify lusubinfo=LDEV. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-1-17 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=1 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 3 Path elements: An instance of
onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 List of 1 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=100
Parameters Table 55 GetStorageArray (subtarget=MFReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify MFReplicationInfo. 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 values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. objectid: Obtain this value from the execution result of the GetStorageArray (subtarget=MFReplicationInfo) command.
raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=58 chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=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 An instan
mfShadowImageVolumeType=S-VOL mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 *****: The values are encoded by the CLI. GetStorageArray (subtarget=Path) GetStorageArray (subtarget=Path) obtains the information about paths. Parameters Table 56 GetStorageArray (subtarget=Path) command parameters Parameter name Status Description subtarget Required Specify Path.
Parameter name Status Description Starting sequence number of paths for which information is to be obtained Specify this parameter when you want to obtain information for a part of paths for a specific storage system. startElementNumFilter Optional When path information is ordered as shown below and numbered from 0 upward, specify the first number in the sequence of paths that you want to obtain. Order of paths: 1. Port IDs in ascending order 2. Domain IDs in ascending order 3.
Parameter name Status Description Domain ID of the host storage domain domain Optional Specify this parameter to acquire information about a particular path. You can specify a decimal or hexadecimal value. When you specify this parameter, you must also specify the model and serialnum parameters, either the portname or port parameter, and the devnum parameter. Do not specify this parameter together with the domainnickname parameter. If they are specified at the same time, an error will occur.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 554 Path elements: An instance of Path objectID=***** devNum=0 displayDevNum=00:00 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=0 wwnSecurityValidity=true . . (repeated for other Path instances) . 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.
Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Path elements: 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.
Parameter name Status Description Object ID of the parity group containing the PDEVs to be returned arraygroupobjid Optional Specify this parameter when you want to obtain information about the PDEVs in a specific parity group. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and omit the arraygroupobjid parameter, information about the PDEVs in parity groups of the specified storage system is obtained.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 ArrayGroup elements: . . (Attributes of ArrayGroup are omitted here) . 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 . .
NOTE: • When SLPR functionality is used in XP24000/XP20000 or XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain information about the pool even if he or she registers the storage system (SLPR) as a target to be managed by Device Manager. • Information about a journal volume to be stored in the pool appears as the LogicalUnit instance. This information can be obtained only when a journal volume is an open volume.
Parameter name Status Description Type of function used to operate the pools You can specify the following values: For P9500: • 3: Snapshot • 4: Continuous Access Journal Software • 5: Thin Provisioning For XP24000/XP20000: • 3: Snapshot poolfunction Optional • 4: Continuous Access Journal Software • 5: Thin Provisioning Software For XP12000/XP10000/SVS200: • 3: Snapshot • 4: Continuous Access Journal Software If the model or serialnum parameter is omitted, the specification for this parameter becomes
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.
poolFunction=4 poolID=0 controllerID=-1 poolType=2 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 List of 2 Lu elements: An instance of LogicalUnit objectID=***** de
tcaPoolID=-1 thpPoolVolControlFlag=-1 An instance of LogicalUnit objectID=***** devNum=3,028 displayName=0B:D4 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 e
diskType=-1 migrationInterval=-1 monitorStartTime=-1 monitorEndTime=-1 monitoringMode=-1 List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,033 displayPvolDevNum=0B:D9 pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053 svolArrayType=Unknown svolDevNum=3,033 displaySvolDevNum=0B:D9 svolPoolID=1 replicationFunction=ContinuousAccessJournal status=17 muNumber=0 copyTrackSize=-1 splitTime=-1 remotePathGroupID=0 An instanc
raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 1 PairedPool elements: An instance of PairedPool muNumber=0 pairedArrayType=Unknown pairedSerialNumber=1405
Parameter name Status Description Number of the port of the storage system port Optional Specify this parameter when you want to obtain information about a specific port. If port and portname are omitted, information about all ports is displayed. If you specify this parameter, you must also specify the model and serialnum parameters. Do not specify port and portname at the same time. If they are specified at the same time, an error will occur.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Port elements: An instance of Port objectID=***** portID=9 portType=Fibre fibreAddress=CC topology=Fabric(off), FC-AL displayName=CL3-E lunSecurityEnabled=true controllerID=2 worldWidePortName=50.06.0E.80.05.27.17.
Parameters Table 60 GetStorageArray (subtarget=PortController) command parameters Parameter name Status Description subtarget Required Specify PortController. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
controllername: Obtain this value from the execution results of the GetStorageArray (subtarget=PortController) command. In the execution results, displayName is displayed below An instance of PortController. Specify this value as controllername. Command execution example 1 In this example, the GetStorageArray (subtarget=PortController) command obtains information about port controllers used for a storage system (serial number: 10001, model: XP1024).
. List of 1 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ReplicationInfo) GetStorageArray (subtarget=ReplicationInfo) obtains information about copy pairs. NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes.
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.
. List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=10001 pvolArrayType=XP1024 pvolDevNum=100 displayPvolDevNum=00:64 pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=10001 svolArrayType=XP1024 svolDevNum=101 displaySvolDevNum=00:65 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessCopy status=1 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=100 displayName=00:64
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 sysVolFlag=0 externalVolume=0 differrentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 cons
Command execution example TBD Command execution result TBD *****: The value is encoded by the CLI. GetZeroPageReclaimStatus GetZeroPageReclaimStatus obtains the execution status of a zero-page reclaim operation executed on THP volumes (virtual volumes) by the RunZeroPageReclaim command. If LogicalUnit instances are displayed in the execution result of the GetZeroPageReclaimStatus command, the zero-page reclaim operation is in progress.
Command execution example In this example, the GetZeroPageReclaimStatus command is used to check whether a zero-page reclaim operation on the volumes for Thin Provisioning Software specified in the RunZeroPageReclaim command has finished. hdvmcli GetZeroPageReclaimStatus -o "D:\logs\GetZeroPageReclaimStatus.
Command execution result 2 This execution result indicates that the zero-page reclaim operation has finished, because no LogicalUnit instances are displayed. RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . ModifyArrayReservation ModifyArrayReservation extends the interval before the target storage system is unlocked.
ModifyLabel ModifyLabel modifies the label of a logical unit. Parameters Table 65 ModifyLabel 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 devnums Required This parameter can be specified in decimal, and in colon-separated hexadecimal.
Command execution result RESPONSE: An instance of ObjectLabel targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device.
Parameter name Status commanddevice Optional commanddevicesecurity Optional Description New setting for command device Specify true to set the specified LU as a command device, and false to release the setting. Security mode setting for the command device Specify true to enable security, and false to disable it. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI. ModifyPool ModifyPool expands a THP pool or changes the settings related to the THP pool.
[threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] [tiercontrol={enable|disable}] [automigration={enable|disable}] [migrationinterval={0|1|2|4|8|24}] [monitorstarttime=start-time-of-performance-monitoring] [monitorendtime=end-time-of-performance-monitoring] [monitoringmode={0|1}] When changing only the settings related to the THP pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=poo
Parameter name Status poolid Required Description Pool ID Specify the pool ID of the THP pool that you plan to expand or whose settings you plan to change. Threshold1 of the THP pool (%) The threshold1 of the THP pool is the usage rate of the THP pool. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: Specify a multiple of 5 in the range from 5 to 95.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: overprovision#1, #2, ingwarning Optional #3 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Specify -1 to cancel an already set threshold value. For XP24000/XP20000: Specify an integer from 10 to 1000.
Parameter name Status Description Specify this parameter when you change the type of the THP pool. tiercontrol#1, Optional #5 (P9500) One of the following values can be specified. • enable: Changes the pool to a pool for Smart Tiers. • disable: Changes the pool to a pool for Thin Provisioning Software. Specify whether to automatically execute performance monitoring and hardware tier relocation. If you specify this parameter, you must also specify tiercontrol=enable.
Parameter name Status Description Performance monitoring mode. This parameter can be specified when tiercontrol is set to enable. monitoring- Optional mode#1, #5 (P9500) Specifiable values vary, depending on the microcode version.
only the model and serialnum parameters, LogicalUnit for the subtarget parameter, and LDEV for the lusubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit. Use the devNum value of a logical unit that satisfies the conditions to be used as a pool volume in a THP pool, to specify the adddevnums parameter.
monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeTy
snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 *****: The values are encoded by the CLI. ModifyPort ModifyPort supports changing of port attributes and host storage domain attributes.
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.
• 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. hdvmcli ModifyPort -o "D:\logs\ModifyPort.log" serialnum=10001 model=XP1024 port=16 domain=0 hostmode=Standard "topology=Fabric(off), FC-AL" fibreaddr=73 lunsec=false channelspeed=1 "wwn=22.33.44.55.44.55.44.33,11.33.22.33.44.33.22.22,55.66.77.88.44.33.22.
ModifyPortController ModifyPortController supports changing characteristics of a PortController. NOTE: This command can be used only with XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128.
Command execution example hdvmcli ModifyPortController -o "D:\logs\ModifyPortController.log" "serialnum=10001" "model=XP1024" "ctrlid=1" "adaptermode=1" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI.
NOTE: If you execute this command when the threshold values related to the over-provisioning percent (the over provisioning warning threshold and over provisioning limit threshold) are set, make sure that the Device Manager server database is consistent. These threshold values are specific thresholds managed by the Device Manager server.
Parameters Table 70 ModifyVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Optional assign (XP24000/XP20000) Specify true to assign volumes for Thin Provisioning Software to a pool for Thin Provisioning Software. Specify false to release volumes for Thin Provisioning Software from a pool for Thin Provisioning Software. Omit this parameter if you are changing the threshold value.
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. poolid: Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command.
journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=15 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI. Command execution example 2 TBD TBD Command execution result 2 TBD *****: The value is encoded by the CLI. RefreshStorageArrays The RefreshStorageArrays command refreshes storage system configuration information.
Parameter name Status Description Interval time in minutes from storage system re-discovery completion to start of next storage system re-discovery interval Optional Only specify this parameter when refreshmode=1 (when storage systems are refreshed sequentially). An error will occur if this parameter is specified when refreshmode=2. You can specify a value from 0 to 2147483647. The default is 0.
List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.40.1 ] . . (repeated for other StorageArray instances) . RunZeroPageReclaim RunZeroPageReclaim performs a zero-page reclaim operation, which returns unused capacity in THP volumes (virtual volumes). Zero-page reclaim can be performed for THP volumes that satisfy either of the following conditions: • The volumes do not constitute a copy pair.
Command execution example hdvmcli RunZeroPageReclaim -o "D:\logs\RunZeroPageReclaim.log" model=XP24000 serialnum=10007 devnums=06:AC Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
If the unused capacity of the THP pool is larger than the used capacity, you can use this command to exclude the THP pool volumes that compose the THP pool to decrease the THP pool capacity. To shrink the THP pool, you can only exclude the THP pool volumes that are in the status that enables a pool to be shrunk. Use the GetPoolShrinkStatus command to make sure that the operation for shrinking the THP pool has finished.
LogicalUnit. Specify for the devnums parameter the devNum value of a logical unit corresponding to the THP volumes that satisfy the condition for shrinking the THP pool. The logical units that satisfy the condition for shrinking the pool are the logical units whose thpType value is 1 (THP pool volumes), and whose thpPoolVolControlFlag value is 2 (the THP pool can be shrunk).
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 sysVolFlag=0 externalVolume=0 differentialManageme
snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=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. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 17.
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 result 2 RESPONSE: An instance of LogicalGroup objectID=***** name=toro parentID=***** logicalPath=root/toro icon=group12.gif capacity=0 capacityInKB=0 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 List of 1 GroupElement elements: An instance of Path objectID=***** devNum=101 displayDevNum=00:65 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=8 wwnSecurityValidity=true *****: 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. NOTE: When AddLun adds a LUN whose domain ID is not 0 to the host storage domain, the LUN security of the target port is automatically enabled. Make sure that the I/Os of the target port are stopped.
Parameter name Status Description Port number of the new path Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name of the new path Optional portname 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.
The LUSE is created using the LDEVs of the specified device numbers. The new LUSE is created using only those LDEVs that have the same emulation, sizeInKB, and raidType attributes. Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter.
devNum=1,001 displayDevNum=03:E9 portID=1 portName=CL1-B domainID=4 scsiID=15 LUN=114 wwnSecurityValidity=true List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyM
chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 *****: The values are encoded by the CLI.
AddWWNForHostStorageDomain AddWWNForHostStorageDomain allocates one or more WWNs to a host storage domain LUN, and performs security settings. 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 233.
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. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain. Use this value to specify the domainnickname parameter.
Parameter name Status Description 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. If they are specified at the same time, an error will occur.
portname: Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter. domainnickname: Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain.
port and wwn: Obtain these values from the execution result of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Execute this command by specifying only the model and serialnum parameters, Port for the subtarget parameter, and WWN for the portsubinfo parameter. In the execution result of this command, the portID value appears under An instance of Port. Use this portID value to specify the port parameter.
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. domain Optional The execution results are output in decimal. 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.
wwnnickname: Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain, hsdsubinfo=WWN) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter and WWN for the hsdsubinfo parameter. In the execution result of this command, the nickname value appears under An instance of WWN. Use this value to specify the wwnnickname parameter.
Parameter name Status Description wwnlist Optional Comma-separated list of WWNs ipaddress Optional IPv4 IP address of the new host ipv6address Optional IPv6 IP address of the new host Value indicating the host type When you register a normal host, omit this parameter. hosttype Optional When you register a mainframe host, specify 2. For details about registering a mainframe host, see Appendix A on page 385. Parameter values to obtain in advance None.
Parameters Table 81 AddHostInfo 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 hostname Required ipaddress Optional IPv4 IP address of the host ipv6address Optional IPv6 IP address of the host mountpoint Optional Mount point on the host file system corresponding to the path Name of the HostInfo You can use a character string of 1-50 bytes for the name.
Parameter name Status Description size Optional LUN size in MB percentused Optional Percent of the LUN in use Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter.
objectID=***** name=MY_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.159 mountPoint=C: portID=7 portName=CL1-H domainID=0 scsiID=15 lun=2 devNum=2 displayDevNum=00:02 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003476 *****: The value is encoded by the CLI.
Parameters Table 82 AddHostRefresh command parameters Parameter name Status Description Object ID of the target host objectid Optional 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. Name of the target host hostname Optional 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.
AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database. If the target virtualization server is already registered, this command updates the Device Manager server database with the most recent information. In addition, any virtualization server information that is removed from the virtualization-server management program is deleted from the Device Manager server database.
Parameter name Status Description Value indicating the host type hosttype Required Specify 3.
protocol=Secure userID=vi-admin *****: The value is encoded by the CLI. Command execution example 2 In this example, the command accesses the virtualization-server management program (IP address: 10.208.119.114) to detect two instances of the VMware ESX (host type: 3) that are registered in the virtualization-server management program. For the command, the following parameters are specified: the protocol of the virtualization-server management program (Secure), user ID (vi-admin), and password (boss!).
DeleteHost DeleteHost deletes information about a host server from the Device Manager server. NOTE: DeleteHost does not delete the host information from the external port. Parameters Table 84 DeleteHost command parameters Parameter name Status Description objectid Optional# Object ID of the host to remove hostname Optional# Name of the host to remove # You must specify either objectid or hostname. Do not specify both parameters at the same time.
NOTE: This command does not support virtualization servers. Parameters Table 85 DeleteHostInfo command parameter Parameter name Status objectid Required Description Object ID of the HostInfo record to remove Specify the objectID obtained from another CLI response. The value is encoded by the CLI. Parameter values to obtain in advance objectid: Obtain this value from the execution result of the GetHostInfo command.
hdvmcli [URL] GetHost [options] [hostfilter=type-of-host-for-which-information-is-obtained] When obtaining information about a specific host: hdvmcli [URL] GetHost [options] {objectid=object-ID-of-host-for-which-information-is-obtained |hostname=name-of-host-for-which-information-is-obtained} When obtaining information about a particular HORCM configuration file on the host, or information for a particular copy group related to the host: hdvmcli [URL] GetHost [options] objectid=object-ID-of-host-for-which
Parameter name Status Description Type of the host that acquires information Omit this parameter when all hosts are the target. You can specify the following values: • NORMAL: Normal host • EXT_PORT: External port hostfilter Optional • MAINFRAME: Mainframe host • VMWARE_ESX: Virtualization server (VMware ESX or VMware ESXi) To specify two or more values, separate them with semicolons (;). Do not specify the objectid and hostname parameters at the same time.
NOTE: If you do not know the object ID of the required host, you can obtain information about hosts by executing the GetHost command without specifying this parameter. Command execution example 1 This example obtains the pair information defined in the RAID Manager configuration definition file whose configFileID is CONFIGFILE.1.11 in the host whose objectID is HOST.1. hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****" configFileID=CONFIGFILE.1.11 *****: The value is encoded by the CLI.
svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
Command execution result 2 RESPONSE: An instance of Host objectID=***** name=testmf hostID=1 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 An instance of Host objectID=***** name=testmf2 hostID=2 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).
commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=0 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=2,000,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 3 Path ele
lun=20 devNum=1,008 displayDevNum=00:03:F0 osScsiBus=1 osScsiID=4 osLun=20 portWWN=10.00.00.00.C9.6F.EB.D6 fileSystemType=Datastore fileSystemName= datastoreName=R600#2_1 sizeInMB=1,953 percentUsed=-1 lastUpdated=1254708417 An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) . *****: The values are encoded by the CLI. Command execution example 4 In this example, the command obtains the information for accessing the virtualization server (hostname = boss.
Command execution example 5 In this example, the command obtains information regarding the disk configuration of the virtualization server (hostname = boss.boss). hdvmcli GetHost -o "D:\logs\GetHost_VM_Datastore.log" "hostname=boss.boss" subtarget=VM,Datastore Command execution result 5 RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=1 capacityInKB=4,097,280 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX Server 3.5.
GetHostInfo GetHostInfo returns the host-based information about a LUN. NOTE: If two or more paths are set from a virtualization server for a single volume, the values for the portID attribute, domainID attribute, and scsiID attribute for the HostInfo instance for the target volume might not be correct. Use the management client for the virtualization server to check this information.
devNum=3 displayDevNum=00:03 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 *****: The value is encoded by the CLI. Command execution example 2 hdvmcli GetHostInfo -o "D:\logs\GetHostInfo.log" Command execution result 2 RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.
that was assigned to the host storage domain. In an environment that satisfies the following conditions, the HostScan command can be used to easily register hosts into the Device Manager server: (1) all WWNs in one host storage domain must be assigned to one host only, and (2) that host name is set as the nickname of the host storage domain. The following lists the conditions for using the HostScan command: • LUN Manager is installed on the storage system.
Parameters Table 88 HostScan command parameters Parameter name serialnum model option Status Description #1, #2 Optional #1, #2 Optional Optional#1 Parameter used to specify the serial numbers of the storage systems for which a host scan is to be performed. Use a comma to delimit multiple values. Parameter used to specify the models of the storage systems for which a host scan is to be performed. Use a comma to delimit multiple values. Parameter used to perform a host scan for all storage systems.
Parameters Table 89 MergeHost command parameters Parameter name Status Description targetname Required Name of the target host Names of the source hosts hostnames Required To specify multiple host names, separate them by commas. Commas contained in the host name are recognized as delimiters. 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.
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.
Parameters Table 91 ModifyHostInfo command parameters Parameter name Status Description Object ID of the HostInfo record to modify objectid Required serialnum Optional model Optional Specify the objectID 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 device number of the path Omit this when no change is required. devnum Optional This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200 or XP1024/XP128, use the xx:yy format, where xx is the CU number, and yy is the LDEV number. For P9500 or XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional.
• The HostInfo record name is changed to MY_HOSTINFO_XP1024. • The new IP address is 111.111.111.111. • E: is the new mount point of the host file system. • The LUN that is used is identified as follows: port number: 7, domain ID: 0, device number: 2. • The new WWN for the HBA is 11.33.55.77.99.BB.DD.FF. • The new file system name is oo, and the new file system type is NTFS1. • 156 MB is secured for the new LUN, and the new percentage of use is set to 50% of the LUN size.
Format When modifying information about a virtualization server: hdvmcli [URL] ModifyVirtualizationServer [options] hostname=host-name-of-virtualization-server [ipaddress=IP-address] [hostprotocol={Secure|Non-secure}] [hostuserid=user-ID] [hostuserpassword=user-password] Parameters Table 92 ModifyVirtualizationServer command parameters Parameter name Status Description hostname Required Host name of the virtualization server whose information is to be modified IP address ipaddress Optional# Specify
Command execution example hdvmcli ModifyVirtualizationServer -o "D:\logs\ModifyVirtualizationServer.log" "hostname=boss.boss" "hostuserpassword=boss!" Command execution result RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=1 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.
command, the name value appears under An instance of Host. In the hostname parameter, specify the name value for the virtualization server whose information you want to refresh. Command execution example hdvmcli RefreshVirtualizationServer -o "D:\logs\RefreshVirtualizationServer.log" "hostname=boss.boss" Command execution result RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=1 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.
DeleteAlerts DeleteAlerts deletes one or more alerts present on the Device Manager server. You can either delete a specific alert by specifying the alert number, or delete all alerts originating from a specific source by specifying the source. Parameters Table 94 DeleteAlerts command parameters Parameter name Status Description alertnum Optional# The number identifying the alert to delete source Optional# Identifies a source of alerts; all alerts from this source are deleted.
Command execution result 2 RESPONSE (Command completed; no data returned) DeleteURLLink DeleteURLLink deletes the URLLinks that is set for a Device Manager object managed by the Device Manager server. NOTE: This command does not support virtualization servers.
Command execution result 1 RESPONSE (Command completed; empty list returned) Command execution example 2 hdvmcli DeleteURLLink -o "D:\logs\DeleteURLLink.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result 2 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.
Command execution result RESPONSE An instance of Alerts Contains 2Alert instances: An instance of Alert number=2 type=Server source=***** severity=3 component=DKU drive description=Serious error detected on DKU drive. actionToTake=Contact Customer Support. data=Component has stopped. timeOfAlert=2003/01/06 20:13:56 An instance of Alert number=1 type=Server source=***** severity=4 component=DKC processor description=Moderate error detected on DKC processor. actionToTake=Contact Customer Support.
displayArrayFamily=AMS/WMS/SMS An instance of StorageArray arrayFamily=HDS9500V displayArrayFamily=HDS9500V An instance of StorageArray arrayFamily=HDS9900V displayArrayFamily=HDS9900V An instance of StorageArray arrayFamily=R700 displayArrayFamily=P9500 An instance of StorageArray arrayFamily=USP displayArrayFamily=USP An instance of StorageArray arrayFamily=R600 displayArrayFamily=USP_V An instance of StorageArray arrayFamily=R700 displayArrayFamily=VSP An instance of StorageArray arrayFamily=HDS9900V dis
Parameters Table 97 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.
*****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of URLLink objectID=***** name=AUTO description=xxxxx url=http://192.168.99.AA/ 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=pool-I
Parameter name Status Description Port number of the HORCM instance for managing the P-VOL Depending on the host OS, specify the appropriate value: • In Solaris, specify an integer from 0 to 65535. pvolportnum Optional • In AIX, Windows, HP-UX, and Linux, specify an integer from 1 to 65535. This parameter is invalid when the pvolinstancenum is specified. You must specify this parameter when you are using method 3.
Parameter name Status Description 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. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Pool ID of the pool in which the differential data and journal data for the P-VOL is to be stored.
Parameter name Status Description Type of operation that is to be executed with the copy pair You can specify the following values: • BusinessCopy: Business Copy Software • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot replicationfunction Optional • ContinuousAccessJournal: Continuous Access Journal Software The default of this parameter differs depending on the condition as shown below.
• When using Method 1 (when adding a copy pair definition to a copy group in which no copy pair has been defined): See No. 2, No. 3, No. 5, 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 99 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.
hdvmcli [URL] AddReplication [options] [groupname=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]] pvolpoolid=pool-ID [replicationfu
Parameter name Status Description ID of the host that recognizes the secondary volume (S-VOL) svolhostid Optional If you are using method 2 or 3, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored. Number of the HORCM instance that manages the S-VOL svolinstancenum Optional If you are using method 2, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the P-VOL is to be stored pvolpoolid Optional You must specify this parameter when you are using method 2 or 3 with Continuous Access Journal Software, Snapshot Software, or Continuous Access Asynchronous Software. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description Type of operation that is to be executed with the copy pair You can specify the following values: • BusinessCopy: Business Copy Software • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot replicationfunction Optional • ContinuousAccessJournal: Continuous Access Journal Software The default value is as follows: • When the P-VOL and S-VOL are located in the same storage syst
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 *****: The values are encode
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 values to obtain in advance replicationgroupid, pvolserialnum, pvoldevnum, svolserialnum, and svoldevnum: Obtain the parameter values from the execution result of the GetHost command.
displayPvolDevNum=00:0C pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=65010012 svolArrayType=XP1024 svolDevNum=25 displaySvolDevNum=00:19 svolObjectID=***** svolPoolID=-1 fenceLevel=Never replicationFunction=ContinuousAccessSync status=8 muNumber=-1 copyTrackSize=15 splitTime=-1 remotePathGroupID=-1 *****: The values are encoded by the CLI. Command execution example 2 This example deletes copy group 7 and all copy pairs defined in this copy group.
hdvmcli [URL] GetReplicationControllerPair Parameters Table 103 GetReplicationControllerPair command parameters Parameter name Status Description masterserialnum Optional# Serial number of the storage system that contains the main control unit (MCU) mastercontrollerid Optional# CU number of the MCU remoteserialnum Optional# Serial number of the storage system that contains the remote control unit (RCU) remotessid Optional# SSID of the RCU mastermodel Optional# Model of the storage system t
Command execution example 1 This example obtains controller pair information for the MCU with CU number 10 in the storage system with serial number 35001 and for the RCU with SSID 65534 in the storage system with serial number 15001. hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
displayMasterStartDevNum=00:00 masterEndDevNum=16,383 displayMasterEndDevNum=3F:FF remoteArrayFamily=XP12K/10K/SVS200 remoteArrayType=Unknown remoteSerialNumber=14050 remoteSSID=0 remoteControllerID=0 remotePathGroupID=165 remoteStartDevNum=-1 remoteEndDevNum=-1 pairType=0 bandwidth=-1 numOfMinConnection=1 . . (repeated for other ReplicationControllerPair instances) . *****: The value is encoded by the CLI. ModifyReplication The ModifyReplication command is used to change the status of a copy pair.
Parameter name Status Description Serial number of the storage system that contains the S-VOL svolserialnum# Optional If you specify this parameter, specify either svolserialnum or svolsequencenum. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Sequence number of the storage system that contains the S-VOL svolsequencenum# Optional If you specify this parameter, specify either svolserialnum or svolsequencenum.
Command execution example This example changes to the suspend status (split) the status of the copy pair for Business Copy Software that is defined in the copy group with copy group number 12. The primary volume (P-VOL) of the copy pair is the logical device with LDEV number 20 in the storage system with serial number 65010001. The secondary volume is the logical device with LDEV number 21 in the storage system with serial number 65010001. hdvmcli ModifyReplication -o "D:\logs\ModifyReplication.
Command reference
5 Output items This chapter describes items that are output by Device Manager CLI commands. The items are output for each instance as attributes of Device Manager instances. The meaning of items that have the same name might differ for different instances. When you reference an output item, check the instance of the item. Alert instance The Alert instance is output when the GetAlerts command (see “GetAlerts” on page 247) is executed.
ArrayGroup instance The ArrayGroup instance is output when the following commands are executed: • • • • • • • • “AddExternalArrayGroup” on page 41 “AddPool” on page 64 “AddVirtualVolume” on page 76 “GetStorageArray (subtarget=ArrayGroup) ” on page 111 “GetStorageArray (subtarget=FreeSpace) ” on page 122 “GetStorageArray (subtarget=PDEV) ” on page 147 “GetStorageArray (subtarget=Pool) ” on page 149 “ModifyPool” on page 171 Table 106 ArrayGroup instance attributes Attribute Description objectID Object ID
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.
Attribute Description 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 parity group (in KB) imOnDemandCapacity Total size of all intermediate LDEVs expanded on demand i
Attribute Description Type of the parity group For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, one of the following values is output: • -1: None type • 0: Normal parity group • 1: External volume parity group • 2: Snapshot V-VOL parity group • 3: Thin Provisioning Software volume parity group -1 is output for other storage systems. Option information of the external parity group For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, a 3-bit value is converted to decimal and is output.
ArrayReservation instance The ArrayReservation instance is output when the following commands are executed: • “AddArrayReservation” on page 39 • “GetArrayReservation” on page 99 • “ModifyArrayReservation” on page 167 Table 107 ArrayReservation instance attributes Attribute Description objectID Object ID of the locked object target Object ID of the locked storage system serialNumber Serial number of the storage system arrayType Type of the storage system loginID Login ID of the user who locked the
Attribute Description IP address For a storage system: ipAddress IP address of the storage system For a virtualization server: IP address of the virtualization server or the virtualization-server management program ipAddress2 Second IP address of the storage system Protocol For a virtualization server: Protocol of the virtualization server or virtualization server management program protocol - Non-secure: HTTP communication - Secure: HTTPS communication For other cases, no value is output.
Attribute Description Current status of the component • 1: Normal • 2: Acute value • 3: Serious • 4: Moderate • 5: Service Current status of the component One of the following values is output depending on the value of value: • Normal • Acute description • Serious • Moderate • Service • Unknown ConfigFile instance The ConfigFile instance is output when the GetHost command (see “GetHost” on page 223) is executed.
Attribute Description name Datastore name Datastore type • 0: Unknown datastoreType • 1: VMFS • 2: Raw Device Mapping ExternalPathInfo instance The ExternalPathInfo instance is output when either of the following commands is executed: • “GetStorageArray (subtarget=ArrayGroup) ” on page 111 • “AddExternalArrayGroup” on page 41 Table 112 ExternalPathInfo instance attributes Attribute Description objectID Object ID of the external path information externalWWN Port WWN of the external storage system
FreeLUN instance The FreeLUN instance is output when the GetStorageArray (subtarget=HostStorageDomain) command (see “GetStorageArray (subtarget=HostStorageDomain) ” on page 126) is executed.
• “RefreshVirtualizationServer” on page 243 Table 116 Host instance attributes Attribute Description objectID Object ID of the host Host name name If EXSP_xxxx_xxxx_xxxx is output as this value, the value indicates an XP12000/XP10000/SVS200 port connected to an external storage system.
• “ModifyHostInfo” on page 238 Table 117 HostInfo instance attributes Attribute Description objectID Object ID of HostInfo arrayType Type (model) of the storage system connected to the host serialNumber Serial number of the storage system connected to the host Display name of the HostInfo object name This item is output if it has been registered.
Attribute Description sizeInMB LUN size (in MB) percentUsed Rate of LUN usage (%) Latest update time of data lastUpdated The number of seconds elapsed from 00:00:00 on January 1, 1970 (world standard time) is displayed. portName Port name 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.
Attribute Description Host mode option. hostModeOption This item is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. For details about the output values, see Table 22. displayName Display name of the host storage domain. Nickname of the host storage domain. nickname The name specified for the host group of the storage system is output. Domain type of the host storage domain domainType 0 (host group) is output.
Attribute Description LDEV name name This item is output if it has been registered. Device number of the LDEV devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output. For XP12000/XP10000/SVS200 or XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output.
Attribute Description Option information of the external volume For P9500, XP24000/XP20000 or XP12000/XP10000/SVS200, a 3-bit value is converted to decimal and is output. • Bit 0 (0x01): Whether or not the cache mode is enabled • Bit 1 (0x02): Whether or not the I/O suppression mode is enabled volumeType • Bit 2 (0x04): Whether or not the cache inflow control mode is enabled For each of these bits, 1 means enabled and 0 means disabled.
Attribute Description CLPR number clprNumber This item is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. -1 is output for other storage systems. Cache residency mode One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: • -1: Unknown cacheResidencyMode • 0: None • 1: Bind mode • 2: Priority mode -1 is output for other storage systems. stripeSizeInKB Currently, this information does not apply to storage systems (-1 is output).
Attribute Description Usage of the THP volume (KB) One of the following values is output for P9500 or XP24000/XP20000: • When the LDEV is not a THP volume: The same value as sizeInKB • When the LDEV is a THP volume: Usage of the Thin Provisioning volume For P9500 or XP24000/XP20000, note the following points on the value that is output for THP volume usage: • When the THP volume has not been assigned to a THP pool, 0 is displayed.
Attribute Description Pool ID of the Thin Provisioning One of the following values is output for P9500 or XP24000/XP20000:: • When the logical unit consists of THP volumes: Pool ID of the THP pool to which the THP volumes are assigned.#1, #2 • When the logical unit consists of THP pool volumes: Pool ID of the THP pool that contains the THP pool volumes.#2 thpPoolID • For other volumes : -1 is output. #1 When the THP volumes are not assigned to a THP pool, -1 is displayed.
Attribute Description tieringPolicy TBD LogicalDKC instance The LogicalDKC instance is output when the GetStorageArray (subtarget=LogicalDKC) command (see “GetStorageArray (subtarget=LogicalDKC) ” on page 132) is executed.
Attribute Description percentUsed Percentage of the size used by the host in regards to the total size of logical units allocated to the logical group Number of LUNs allocated to the logical group numberOfLUNs This item indicates the total number of LUNs allocated to the lower-level logical groups.
Attribute Description Emulation mode emulation This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8). Count of LDEV contained in the logical unit devCount For regular volumes, devCount is 1. Type of the LDEV contained in the logical unit devType This item indicates the purpose of the LDEV. CommandDevice: The LDEV is a command device.
Attribute Description Indicates whether the logical unit is a LUSE volume.
Attribute Description Pool ID of Snapshot • When the logical unit is the P-VOL or S-VOL of Snapshot: Pool ID of the pool used by the logical unit snapshotPoolID • When the logical unit is a pool volume: Pool ID of the pool to which the logical unit has been assigned In other cases, -1 is output.
Attribute Description Pool ID of the Thin Provisioning One of the following values is output for P9500 or XP24000/XP20000:: • When the logical unit consists of THP volumes: Pool ID of the THP pool to which the THP volumes are assigned.#1, #2 • When the logical unit consists of THP pool volumes: Pool ID of the THP pool that contains the THP pool volumes.#2 thpPoolID • For other volumes : -1 is output. #1 When the THP volumes are not assigned to a THP pool, -1 is displayed.
Attribute Description Type of the storage system containing the P-VOL pvolArrayType If the storage system containing the P-VOL is not registered, Unknown is output. pvolDevNum Device number of the P-VOL Device number of the P-VOL For P9500 or XP24000/XP20000: displayPvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number.
Attribute Description Copy status • -1: Unknown • 0: Simplex • 1: Pair • 8: Copying status • 9: Reverse-Copying • 16: Split • 17: Error • 18: Error in LUSE • 24: Suspending • 25: Deleting MU number of the P-VOL If the value of replicationFunction is UniversalReplicatorForMF: 0 to 3 muNumber -1 is output if the MU number is unknown. If the value of replicationFunction is not UniversalReplicatorForMF, this information is invalid.
Attribute Description pairedSerialNumber The serial number of the paired pool The type of paired pool storage system pairedArrayType A valid value is output for this item only when the storage system that contains the paired pool has been registered in Device Manager.
Attribute Description Device number for identifying the logical unit devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output. For XP12000/XP10000/SVS200 and XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output. portID Port ID domainID Domain ID of the host storage domain SCSI ID scsiID For Fibre Channel, 15 is output. LUN LUN that is assigned to the path.
Attribute Description Parity group containing the physical device arrayGroup -1 is output if the physical device does not belong to the parity group. Drive size of the physical device (in KB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: capacityInKB The capacity that is calculated by treating 1,024 bytes as 1 KB is output. For XP1024/XP128: The capacity that is calculated by treating 1,000 bytes as 1 KB is output.
Attribute Description arrayGroupName Name of the parity group to which the PDEV belongs diskModelSize Currently, this information does not apply to storage systems. encrypted Currently, this information does not apply to storage systems (-1 is output).
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 Over provisioning warning threshold (%) overProvisioningWarning If the storage system is P9500 or XP24000/XP20000 and poolFunction is 5, the threshold used to issue an advance warning for the over-provisioning percent is output. This information is invalid for other cases (-1 is output).
Attribute Description Start time of performance monitoring (example: 00:00) monitorStartTime This attribute is valid only when a pool for Smart Tiers is used, and migrationInterval is 24. End time of performance monitoring (example: 23:59) monitorEndTime This attribute is enabled only when a pool for Smart Tiers is used, and migrationInterval is 24. Performance monitoring mode This attribute is valid only when a pool for Smart Tiers is used.
Attribute Description Capacity of the hardware tier (KB) capacityInKB This value does not match the total capacity of the pool volumes for Smart Tiers because the pool of Smart Tiers uses a control area. freeCapacityInKB Unused capacity of the hardware tier (KB) usageRate Usage rate of the hardware tier raidLevel RAID level (example: RAID6 or RAID1+0) Combination of data drives and parity drives in a RAID configuration. This item is output as xD+yP or as xD+xD.
Attribute Description Address of the Fibre port (AL_PA) fibreAddress For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, either of the following values is output: • 00 or no value: Neither a Fibre port nor an FCoE port • 01 - EF: Valid address (two-digit hexadecimal number) topology Fibre topology displayName Display name of the port Indicates whether LUN security is valid for the port.
• “ModifyPortController” on page 186 Table 133 PortController instance attributes Attribute Description objectID Object ID of the port controller Name of the port controller name This item is output if it has been registered.
Attribute Description Port type For P9500: • 100: ESCON (4 ports) (4 G) • 101: FICON (4 ports) (4 G) • 102: CHT (8 ports) (4 G) • 103: FICON (8 ports) (4 G) • 105: CHT (4 ports) (4 G) • 106: FICON (8 ports) (8 G) • 107: CHT (8 ports) (8 G) • 108: CHT (4 ports) (8 G) • 110: FCoE (4 ports) (10 G) For XP24000/XP20000: • 80: ESCON (4 ports) • 81: FICON (4 ports) • 82: CHT (8 ports) • 85: CHT (4 ports) • 88: CHT (4 ports) For XP12000/XP10000/SVS200: type • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-T
Attribute Description For XP1024/XP128: • 2: ESCON • 8: Fibre-Tachyon Shortwave (2 ports) • 12: Fibre-Tachyon Shortwave (4 ports) • 13: Fibre-Tachyon Shortwave (4 ports) • 14: Fibre-Tachyon Shortwave (8 ports) • 15: Fibre-Tachyon Longwave (4 ports) • 21: E-NAS • 25: iSCSI • 32: FICON Shortwave (4 ports) • 33: FICON Longwave (4 ports) RelatedDistributedArrayGroup instance The RelatedDistributedArrayGroup instance is output when GetStorageArray (subtarget=ArrayGroup) (see “GetStorageArray (subtarget=ArrayGr
Attribute Description remoteEndDevNum Maximum device number among the applicable LUs in the RCU remoteSerialNumber Serial number of the RCU SSID of the RCU remoteSSID 0 is displayed if there is no RCU.
#1 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the value for objectID will be invalid. #2 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the remoteArrayFamily, remotePathGroupID, pairPortType, numOfMinConnection, and nickname attributes will not be output.
Attribute Description Value specified in HORCM_INST for the S-VOL in the HORCM configuration file svolHORCMINSTHostName In the HORCM configuration file, if HORCM_INST is set to localhost, the loopback address is output.
Attribute Description ID of the pool containing the P-VOL For Continuous Access Journal Software, a journal group ID is output. pvolPoolID For Snapshot, or Continuous Access Asynchronous Software, the pool ID of a data pool is output. -1 is output for other copy types. 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.
Attribute Description Time when the S-VOL image is created by using the replication function splitTime The number of seconds elapsed from 00:00:00 on January 1, 1970, is output (the time setting is the storage system setting, not GMT). This item is valid when the copy type is Snapshot. When the copy type differs from Snapshot, -1 is output.
Attribute Description upTime Length of time that the Device Manager server is active upSince Time and date that the server was started currentApiVersion Device Manager server API version License status • -1: Unknown • 0: Permanent license • 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=Path) ” on page 143 “GetStorageArray (subtarget=PDEV) ” on page 147 “GetStorageArray (subtarget=Pool) ” on page 149 “GetStorageArray (subtarget=Port) ” on page 156 “GetStorageArray (subtarget=PortController) ” on page 158 “GetStorageArray (subtarget=ReplicationInfo) ” on page 161 GetTieredPoolStatus, page 164 “GetZeroPageReclaimStatus” on page 165 “ModifyLogicalUnit” on page 169 “ModifyPool” on page 171 “ModifyPort” on page 179 “ModifyPortControll
Attribute Description An attribute for compatibility. sharedMemoryInMB For details, see Table 139. Number of spare drives numberOfSpareDrives -1 is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128. freeCapacityInGB#1 allocatedCapacityInGB#1 autoLunCapacityInGB#1 onDemandCapacity- An attribute for compatibility. For details, see Table 139.
Attribute Description numberOfLUs Number of logical units numberOfAllocatedLUs Number of logical units to which paths are assigned numberOfUnallocatedLUs Number of logical units to which paths can be assigned by using Device Manager, but to which no paths are assigned SLPR status of the storage system • -1: None slprStatus • 0: The storage system has all the resources. • 1: The storage system has some of the resources divided by using the SLPR.
Attribute Description Total size of the intermediate logical units reserved for Auto LUN Software (in KB) imAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2. • devType is AutoLunReserved. An attribute for compatibility. imOnDemandCapacity For details, see Table 139.
Attribute Description Time when the storage system was last refreshed lastRefreshed The number of seconds elapsed from 00:00:00 on January 1, 1970 (world standard time) is displayed. This item indicates whether an unformatted logical unit can be created.
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 can be assigned by using Device Manager. openUnallocatedCapacity 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 not used as a reserved volume#2 by storage system functions.
Attribute Description Number of open logical units and intermediate logical units that satisfy both the following conditions: numberOfReservedLUs • Paths are not assigned. • Paths cannot be assigned by using Device Manager. Number of open logical units that satisfy both the following conditions: numberOfOpenReservedLUs • Paths are not assigned. • Paths cannot be assigned by using Device Manager.
Attribute onDemandCapacityInGB# totalFreeSpaceInGB# largestFreeSpaceInGB# Description Total size of the LDEVs expanded on demand (in GB) Total size of the regions in which logical units can be created (regions of unused capacity) (in GB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
Attribute Description Total size of the intermediate logical units to which paths are not assigned (in KB) imFreeCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2. • path is false. Total size of the intermediate logical units expanded on demand (in KB) imOnDemandCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2.
Figure 2 Relationship of attributes (total size of 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” on page 244 • “GetURLLink” on page 249 Table 140 URLLink instance attributes Attribute Description objectID Object ID of URLLink name Name of the URLLink description Additional
Attribute Description Type of the URLLink createdByUser -1 is output. VirtualDisk instance The VirtualDisk instance is output when the GetHost command (see “GetHost” on page 223) is executed. Table 141 VirtualDisk instance attributes Attribute Description vmDiskID Virtual disk ID name Virtual disk name datastoreID Datastore ID VM instance The VM instance is output when the GetHost command (see “GetHost” on page 223) is executed.
Attribute Description storage system type to which an external volume is mapped • P9500: P9500 • XP24000: XP24000 mappedArrayType • XP20000: XP20000 • XP12000: XP12000 • XP10000: XP10000/SVS200 mappedSerialNumber Serial number of the storage system to which an external volume is mapped mappedDevNum Device number of the internal volume to which an external volume is mapped externalArrayType storage system type consisting of external volumes externalSerialNumber Serial number of the storage system
• “MergeHost” on page 235 • “ModifyHost” on page 236 • “ModifyPort” on page 179 Table 144 WWN instance attributes Attribute Description World Wide Name wwn A World Wide Name is usually assigned to the HBA in the server. WWN nickname nickname This item is output if it has been registered.
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.
• Write commands so that the devnum follows the order of the serial number. 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.
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 ModifyVi
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. #1 If there is a command for which this parameter is specified and a command for which this parameter is omitted in the same batch file, specify the command with the parameter first.
• 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 27. The following shows an example of an execution with the batch option specified, and an example of the command execution results. In this example, a batch file created in “Examples of batch file creation” on page 349 is specified as the file name batch.txt and is executed.
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 numberOfUnallocatedLUs=1,832 slprStatus=0 openTotalCapacity=5,34
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=103 wwnSecurityValidity=true *
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 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.
# 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. When they have been specified in the properties file, you do not need to specify them from the command line. • If you specify options from the command line when they have been specified in the properties file, the values of the options specified from the command line have precedence.
Environment settings for encoding a password There are two levels for encoding passwords, NORMAL and HIGH. For details about how to change the level to HIGH in order to generate a safer and more secure character string, see the HP StorageWorks P9000 Command View Advanced Edition Suite Software Administrator Guide. How to use the hdvmaccount command This section describes the hdvmaccount command, which encodes a password and outputs it to the properties file or password file.
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. • If you specify parameters from the command line when they have been specified in the properties file, the values of the parameters specified from the command line have precedence.
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 3646. 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 129 • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo GetStorageArray (subtarget=LogicalUnit) , page 134 MFReplicationInfo mfreplicationsubinfo GetStorageArray (subtarget=MFReplicationInfo) , page 139 Path pathsubinfo GetStorageArray (subtarget=Path) , page 143 Pool poolsubinfo GetStorageArray (subtarget=Pool) , page 149 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 368. Third line: XML elements are output.
Component EMPTY> FreeLUN EMPTY> FreeSpace EMPTY> HostInfo EMPTY> IPAddress EMPTY> ISCSIName EMPTY> LogicalDKC EMPTY> LogicalGroup EMPTY> PairedPool EMPTY> PairedPortController EMPTY> PDEV EMPTY> VolumeConnection EMPTY> WWN EMPTY> ObjectLabel EMPTY> RelatedDistributedArrayGroup EMPTY> ExternalPathInfo EMPTY>
fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percentUsed CDATA #IMPLIED> lastUpdated CDATA #IMPLIED> portISCSIName CDATA #IMPLIED>
name CDATA #IMPLIED> devNum CDATA #IMPLIED> displayDevNum CDATA #IMPLIED> portID CDATA #IMPLIED> portName CDATA #IMPLIED> domainID CDATA #IMPLIED> scsiID CDATA #IMPLIED> LUN CDATA #IMPLIED> wwnSecurityValidity CDATA #IMPLIED>
diskType CDATA #IMPLIED> tierControl CDATA #IMPLIED> autoMigration CDATA #IMPLIED> migrationInterval CDATA #IMPLIED> monitorStartTime CDATA #IMPLIED> monitorEndTime CDATA #IMPLIED> monitoringMode CDATA #IMPLIED> externalMixCompatible CDATA #IMPLIED>
Properties file
8 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 whether an error specific to the Device Manager CLI occurred. 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.
9 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 386 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 387.
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 SNMP simple network management protocol
Index A access control, 33 AddArrayReservation, 39 AddConfigFileForReplication, 251 AddExternalArrayGroup, 41 AddHost, 213 AddHostInfo, 214 AddHostRefresh, 217 AddHostStorageDomain, 46 AddLabel, 53 AddLogicalUnit, 54 optimization of regions of unused capacity, 54 AddLun, 201 AddLUSE, 60 AddPool, 64 AddReplication, 261 AddStorageArray, 72 AddTieredPoolOperation, 75 AddURLLink, 244 AddVirtualizationServer, 219 AddVirtualVolume, 76 AddWWNForHostStorageDomain, 206 B batch commands that can be executed, 343 exe
GetLogicalGroup, 198 GetPoolShrinkStatus, 100 GetReplicationControllerPair, 276 GetServerInfo, 248 GetStorageArray, 104 GetStorageArray (subtarget not specified), 109 GetStorageArray (subtarget=ArrayGroup), 111 GetStorageArray (subtarget=CommParameters), 115 GetStorageArray (subtarget=Component), 116 GetStorageArray (subtarget=ExternalStorage), 119 GetStorageArray (subtarget=Filter), 120 GetStorageArray (subtarget=FreeSpace), 122 GetStorageArray (subtarget=HostStorageDomain), 126 GetStorageArray (subtarget=
URLLink, 244 user group, 33 V version Device Manager CLI, 27 CLI Reference Guide 399