HP StorageWorks P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96051 Third edition: April 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 ...........................................................................................................
DeleteStorageArray ............................................................................................................ 91 DeleteVirtualVolume ............................................................................................................ 92 FormatLU ........................................................................................................................... 95 GetArrayReservation .............................................................................................
ModifyHost ..................................................................................................................... ModifyHostInfo ................................................................................................................ ModifyVirtualizationServer ................................................................................................ RefreshVirtualizationServer .................................................................................................
VM instance .................................................................................................................... 332 VolumeConnection instance ............................................................................................... 332 WWN instance ............................................................................................................... 333 Using batch files to execute commands ......................................................................................
Support and other resources ............................................................ 383 Contacting HP ........................................................................................................................ HP technical support ......................................................................................................... Subscription service .......................................................................................................... Documentation feedback ....
Figures 1 Example of executing the AddExternalArrayGroup command ........................................
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 Return values ..........................................................................................................
33 DeleteLogicalUnit command parameters ..................................................................... 88 34 DeleteLUSE command parameters ............................................................................. 90 35 DeletePool command parameters .............................................................................. 91 36 DeleteStorageArray command parameters .................................................................. 92 37 DeleteVirtualVolume command parameters .................
70 RunZeroPageReclaim Command Parameters ............................................................. 192 71 ShrinkPool command parameters ............................................................................ 193 72 GetLogicalGroup command parameters ................................................................... 197 73 AddLun command parameters ................................................................................ 201 74 AddWWNForHostStorageDomain command parameters ..................
107 Component instance attributes ................................................................................ 287 108 ConfigFile instance attributes .................................................................................. 288 109 Datastore instance attributes ................................................................................... 288 110 ExternalPathInfo instance attributes ..........................................................................
144 Parameters that cannot be specified in the GetStorageArray command when CSV output is specified ........................................................................................................... 365 145 Device Manager CLI troubleshooting information ......................................................
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 Device Manager CLI 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 Device Manager CLI commands This chapter explains how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Device Manager CLI 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. For details about the properties file, see Chapter 5 on page 357. • When you enter commands from the command line, you need to perform shell escapes in accordance with the platform. • When you use Windows Vista, execute the Device Manager CLI from a command prompt initiated as an administrator.
Variable Function Options control the behavior of the CLI application. Options are entered in the typical UNIX fashion. Options are case sensitive. Each option has a single character representation and an alternate word representation; for the single character, prefix the character with a single dash; for the word, prefix the word with two dashes. For example: -t or --messagetrace. Some options require an argument, which follows the option. For example, the -u option is followed by a user ID.
Option Argument for the option Status Description The Device Manager server login password or the path to the password file that contains the login password. #1, #2, #3 -p or --password password or password-file Required A password can either be specified directly, or a file containing a password can be specified. The application user needs to have access permissions for the password file. Do not grant access permissions to common users for the password file.
Option Argument for the option Status Description The flag for enabling message tracing -t or --messagetrace No argument Optional When this option is specified, the command outputs the requests and responses sent to or received from the Device Manager server in XML to the MessageTrace.log file. The commands specified in the batch file are executed together. -b or batch-file- --batch name#2 Optional For example usages of this option, see “Using batch files to execute commands” on page 334.
Device Manager CLI return values The Device Manager CLI returns an execution result value at the end of each process. The following table lists and describes the CLI return values. Table 4 Return values Return values Description 0 The CLI ended normally. 1 The CLI found errors within the process (for example, a parameter error). 2 The CLI found errors in the Device Manager server. Device Manager CLI Help This section describes the various types of Device Manager CLI Help and how to display them.
To display Help for the batch function, specify the following: C:\hdvm> hdvmcli help batch List of Device Manager CLI commands Table 5 through Table 10 list the CLI commands and related storage systems. Note that if the Core CLI/SMI-S license is used, logical group commands (see Table 6) cannot be used. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 17.
XP12000/ XP10000/ SVS200 XP1024/ XP128 Description DeleteArrayReservation Unlocks a specified storage system Y Y Y Y DeleteExternalArrayGroup Deletes an external parity group. Also, deletes the LUs that belong to the deleted external parity group. Y Y -- -- DeleteHostStorageDomain Deletes a host storage domain or host group. Y Y Y Y DeleteLabel Deletes a label. Y Y Y Y DeleteLogicalUnit Deletes one or more LUs and the corresponding LDEVs.
P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 Command name Description ModifyArrayReservation Extends the maximum period for which a specified storage system is locked. Y Y Y Y ModifyLabel Modifies a label. Y Y Y Y ModifyLogicalUnit Modifies the settings of the logical units and the corresponding LDEVs. Y Y Y Y ModifyPool Modifies the settings related to a THP pool or the expansion of a THP pool. Y Y -- -- ModifyPort Modifies port attributes.
LogicalUnit, MFReplicationInfo, Path, PDEV, Pool, Port, PortController, and ReplicationInfo. Table 6 Logical group commands Command name Description GetLogicalGroup Obtains information about logical groups. Table 7 LUN commands and related storage systems P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 Command name Description AddLun Defines a path to a volume from the host.
Command name Description GetHost Obtains information about hosts. GetHostInfo Obtains host-based information about a LUN. HostScan Registers (into the Device Manager server database) any host whose host name is the nickname of a host storage domain, and adds (to that host's information in the database) the WWN that was assigned to the host storage domain. MergeHost Merges the WWNs assigned to multiple hosts into one host. ModifyHost Modifies information about a host.
P9500 XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 Command name Description GetReplicationControllerPair Obtains RCU (remote path) information registered in the MCU in storage systems managed by the Device Manager server. Y Y Y Y ModifyReplication Changes copy pair statuses. Y Y Y Y Legend: Y: Indicates that the particular storage system can be used to execute the command. -: Indicates that it cannot be used to execute the command.
The following table lists and describes the roles required for each command.
Command name Role ModifyLabel Admin or Modify ModifyLogicalUnit Admin or Modify ModifyPool Admin or Modify ModifyPort Admin or Modify ModifyPortController Admin or Modify ModifyVirtualVolume Admin or Modify RefreshStorageArrays Admin or Modify RunZeroPageReclaim Admin or Modify ShrinkPool Admin or Modify # All Resources must be assigned as a resource group.
Command name Role GetHost Admin, Modify, or View GetHostInfo Admin, Modify, or View HostScan Admin# or Modify# MergeHost Admin# or Modify# ModifyHost Admin or Modify ModifyHostInfo Admin or Modify ModifyVirtualizationServer Admin or Modify RefreshVirtualizationServer Admin or Modify # All Resources must be assigned as a resource group.
Notes on executing Device Manager CLI commands Note the following when you execute a CLI command: Table 17 Notes on executing CLI commands Item Description Adding a LUN or host storage domain (for XP24000/XP20000, XP12000/XP10000/SVS200 and XP1024/XP128) Related commands When adding a LUN or host storage domain, make sure that I/O operations from the host to the corresponding port have stopped.
Item Description Related commands Notes on account locking When the user account-locking feature is enabled in Common Component, if you have failed to log in a specific number of times, the user account will be locked. As such, for operations in which commands are sequentially executed, such as when multiple CLI commands are executed sequentially in batch, make sure beforehand that the correct password is set for options and properties.
Executing Device Manager CLI commands
4 Device Manager CLI 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.
Parameters Table 18 AddArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 19 AddExternalArrayGroup command parameters Parameter name Status Description serialnum Required Serial number of the storage system where you want to create the external parity group model Required Model of the storage system where you want to create the external parity group 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.
Parameter name Status Description Emulation type of the logical unit emulation Optional OPEN-V is the only value that can be specified. If this parameter is omitted, OPEN-V is set. clprnumber Optional CLPR number If this parameter is omitted, 0 is set.
Parameter name Status Description Volume size of the logical unit capacity Optional If this parameter is omitted, a logical unit having the same size as the external volume is created. This parameter cannot be specified if none is specified in the luoption parameter or if the luoption parameter is omitted. 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.
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, and XP12000/XP10000/SVS200, you can create multiple logical units at once.
Format for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200 When creating a single LU: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number|arraygroupname=parity-group-name} capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick#}] [capacitytype={KB|block}] When creating multiple logical units in bulk by specifying their capacity and number:
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 parameter, make sure that groupnum is also specified. chassis Optional Either specify chassis and groupnum at the same time, or specify arraygroupname.
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.
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 result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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 An instance of LDEV objectID=***** devNum=1,002 displayName=03:EA emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=
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. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.
• If external volumes are used for a pool for Smart Tiers, the cache mode for the volumes must be ON. • If both internal and external volumes are used for a THP pool, the cache mode for the external volumes must be ON. However, if a THP pool was created when the microcode version was earlier than 70-02-00-XX/XX, the THP pool cannot contain both internal and external volumes, even if the microprogram is upgraded to 70-02-00-XX/XX or later.
Format for XP24000/XP20000 hdvmcli [URL] AddPool [options] model=model serialnum=serial-number [poolid=pool-ID] [threshold=Thin-Provisioning-Software-pool-threshold-1] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] devnums=device-number-of-logical-unit Parameters Table 26 AddPool command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage syste
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
If you use this command with XP24000/XP20000, the virtual parity group and the virtual volumes must satisfy the following conditions: • They must have an emulation type of OPEN-V. • The unused capacity on the virtual volume must be larger than the capacity of the volumes for Thin Provisioning Software. • If you are creating virtual volumes in an existing virtual group, the CLPR number of any pool for Thin Provisioning Software that you specify must be the same as the CLPR number of the virtual parity group.
hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number arraygroupname=name-of-virtual-parity-group 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 as many virtual parity groups as the
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 29 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 30 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 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. If you omit ww, the LDKC number is regarded as 0.
Parameters Table 34 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 186.
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 50 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 53 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 54 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 55 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.
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 pdevid Status Description Optional Specify this parameter when you want to obtain information about a specific PDEV. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and omit the pdevid parameter, information about PDEVs in the specified storage system is obtained.
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 pdevid=1 encrypted=-1 . . (repeated for other PDEV instances) . *****: The value is encoded by the CLI. GetStorageArray (subtarget=Pool) GetStorageArray (subtarget=Pool) obtains information about pools for Snapshot, Continuous Access Journal Software, or Thin Provisioning.
Parameters Table 57 GetStorageArray (subtarget=Pool) command parameters Parameter name Status Description subtarget Required Specify Pool. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameter name Status Description CLPR number When Continuous Access Journal Software is specified as the type of function used to operate the journal pools, specify the CLPR number of the journal volumes. Optional clprfilter (P9500 or XP24000/ XP20000) When Thin Provisioning Software is specified as the type of function used to operate the journal pools, specify the CLPR number of the journal pool.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=0 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 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=RAI
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 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,033 displayPvolDevNum=0B:D9 pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053
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 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=1 thpType=-1 consumedCapacityInKB=
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Number of the port of the storage system Optional port 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.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Port.log" subtarget=Port model=XP24000 serialnum=10007 port=9 portsubinfo=WWN,HostStorageDomain Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Port elements: An instance of Port objectID=***** portID=9 portType=Fibre fibreAddress=CC topology=Fabric(off), FC-AL displayName=CL3-E lunSecurityEnabled=true controllerID=2 worldWidePortName=50.06.0E.80.05.27.17.
GetStorageArray (subtarget=PortController) GetStorageArray (subtarget=PortController) obtains the information about port controllers. Parameters Table 59 GetStorageArray (subtarget=PortController) command parameters Parameter name Status Description subtarget Required Specify PortController. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target.
controllernum: Obtain this value from the execution result of the GetStorageArray (subtarget=PortController) command. Execute this command by specifying only the model and serialnum parameters, and the value for subtarget=PortController. In the execution result of this command, the controllerID value appears under An instance of PortController. Use this controllerID value to specify the controllernum parameter.
Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI. GetStorageArray (subtarget=ReplicationInfo) GetStorageArray (subtarget=ReplicationInfo) obtains information about copy pairs.
Parameter name Status Description ID of the copy pair information (ReplicationInfo instance) objectid Optional replicationsubinfo Optional Specify this parameter if you want to obtain specific copy pair information. If you specify this parameter, you must also specify the model and serialnum parameters. If you specify the model and serialnum parameters and do not specify the objectid parameter, information about copy pairs of the specified storage system is obtained.
subtarget=ReplicationInfo model=XP1024 serialnum=10001 replicationsubinfo=LogicalUnit Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 An instance of LogicalUnit objectID=***** devNum=101 displayName=00:65 emulation=OPEN-3 devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousA
NOTE: This command can be used only with P9500 and XP24000/XP20000. The required microcode version is 60-07-00-XX/XX or later.
emulation=OPEN-V devCount=1 devType= capacityInKB=1,049,280 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolI
Parameter name Status Description 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. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli ModifyArrayReservation -o "D:\logs\ModifyArrayReservation.
Parameter name Status Description Device number of the logical unit devnums Required 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.
ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device. Format hdvmcli [URL] ModifyLogicalUnit [options] serialnum=serial-number model=model devnum=device-number {commanddevice={true|false}|commanddevicesecurity={true|false}} NOTE: For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, if you change an LU for which security is enabled to a command device, specify both the commanddevice and commanddevicesecurity parameters.
devnum: Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit) command. Execute this command by specifying only the model and serialnum parameters, and LogicalUnit for the subtarget parameter. In the execution result of this command, the devNum value appears under An instance of LogicalUnit. Use this devNum value to specify the devnum parameter. Command execution example hdvmcli ModifyLogicalUnit -o "D:\logs\ModifyLogicalUnit.
ModifyPool ModifyPool expands a THP pool or changes the settings related to the THP pool. NOTE: • This command can be used only with P9500 and XP24000/XP20000. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.3 or later.
[migrationinterval={ [monitoringmode={0|1}]1|2|4|8|24}] [monitorstarttime=start-time-of-performance-monitoring] [monitorendtime=end-time-of-performance-monitoring] [monitoringmode={0|1}] Format for XP24000/XP20000 When the command is used to expand a pool for Thin Provisioning Software: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID adddevnums=device-number-of-logical-unit [threshold=Thin-Provisioning-Software-pool-threshold] [overprovisioningwarning=over-provisioning
Parameter name Status Description 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. For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: overprovision#1, #2, ingwarning Optional #3 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Specify -1 to cancel an already set threshold value. For XP24000/XP20000: Specify an integer from 10 to 1000.
Parameter name Status Description Specify 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 fibreaddr Optional New fibre channel address for the port (the hex string representation) New transmission speed for a Fibre Channel connection to a port You can specify the following values: For P9500 and XP24000/XP20000: • 0: Automatic • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps • 8: 8 Gbps # channelspeed Optional For XP12000/XP10000/SVS200: • 0: Automatic • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps For XP1024/ XP128: • 0: Automatic • 1: 1 Gbps • 2: 2 Gbps lunsec Optional New
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. Optional wwn If you specify this parameter, you must also specify the domain or nickname parameter. If you specify this parameter, you must also specify the wwnnickname or newwwnnickname parameter. You must specify the same number of values for each parameter.
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.
Parameter name Status Description 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.
Command execution example In this example, the ModifyVirtualVolume command changes the usage rate threshold for the volume for Thin Provisioning Software (devNum: 00:30:00) to 15% (threshold: 15) in the storage system (serialnum: 15065, model: XP24000). hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=XP24000 serialnum=15065 devnums=00:30:00 threshold=15 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
RefreshStorageArrays The RefreshStorageArrays command refreshes storage system configuration information. For storage systems that are managed by Device Manager, configuration information that is created or modified from the Remote Console, Remote Web Console, or RAID Manager is added to or updated in the Device Manager server database each time this command is executed. Execute this command regularly to keep the Device Manager server database up to date.
(numberOfLUs + numberOfMfLDEVs) x number-of-storage-systems-to-refresh-in-parallel Command execution example hdvmcli RefreshStorageArrays -o "D:\logs\RefreshStorageArrays.log" "interval=1440" Command execution result RESPONSE: [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.116.106 userID=root ] [An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Parameters Table 70 RunZeroPageReclaim Command Parameters Parameter Name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Device number(s) of THP volume(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
commandDeviceSecurity=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=5 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI.
Parameter name Status poolid Required Description Pool ID Specify the pool ID of the THP pool to be shrunk. Device number of the logical unit(s) devnums Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values.
. . (Attributes of StorageArray are omitted here) .
sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 An instance of LogicalUnit objectID=***** devNum=1,547 displayName=00:06:0B emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPor
GetLogicalGroup GetLogicalGroup obtains information about logical groups. By default, the characteristics of the group are provided, but not the group's content. If you specify subtarget, the group's content of the specified types can be obtained. If a logical group contains other groups, the contained groups cannot be obtained with the group. Instead, the relationship between containing and contained groups is determined by the parent attribute of contained groups.
Command execution result 1 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 3 GroupElement elements: An instance of Host objectID=***** name=hit hostID=1 ipAddress=192.168.32.
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 3 GroupElement elements: An instance of Host objectID=***** name=hit hostID=1 ipAddress=192.168.32.
objectID=***** name=toro parentID=***** logicalPath=root/toro icon=group12.gif capacity=0 capacityInKB=0 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. LUN commands The LUN commands can be used to manage LUN groups, set up WWNs, and set paths from a host to a volume. AddLun AddLun sets paths from a host to a volume. A LUN expanded (LUSE) logical unit can be specified when the path is set.
Parameters Table 73 AddLun command parameters Parameter name Status Description serialnum Required Serial number of the new path's storage system model Required Model of the new path's storage system Name of the new path name Optional You can use a character string of 1-64 bytes for a name. Spaces at the beginning or end of a name are not registered. Port number of the new path port Optional Specify either port or portname. Do not specify both parameters at the same time.
Parameter name Status Description Device number used to identify the new path (not provided when a LUSE is defined) 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.
lusedevnums: Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. In the execution result of this command, the devNum values of the LDEVs appear in an LDEV. Use the devNum value of the LDEV for which path=false and onDemandDevice=false to specify the lusedevnums parameter. Choose only the LDEVs that share the same emulation, sizeInKB, and raidType attributes, and specify them in the form of a comma-separated list.
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 An instance of LDEV objectID=***** devNum=1,002 displayName=03:EA emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB
Command execution example 2 hdvmcli AddLun -o "D:\logs\AddLun.log" "serialnum=10001" "model=XP1024" "name=hp" "port=1" "domain=4" "scsi=15" "lun=120" "devnum=1006" 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=***** name=hp devNum=1,006 displayDevNum=03:EE portID=1 portName=CL1-B domainID=4 scsiID=15 LUN=120 wwnSecurityValidity=true *****: The value is encoded by the CLI.
Parameters Table 74 AddWWNForHostStorageDomain command parameters Parameter name Status Description serialnum Required Serial number of the storage system for the host storage domain model Required Model of the storage system for the host storage domain Port ID of the host storage domain Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
Parameter name Status Description The nickname of the WWN Specify this parameter to register the WWN nickname. To specify two or more WWN nicknames, separate them with commas. The number of wwn parameters must match the number of wwnnickname parameters. Paired wwn parameters and wwnnickname parameters must be specified in the same sequence. You can use the following characters: wwnnickname Optional A-Z a-z 0-9 ! # $ % & ' ( ) + - .
Command execution example hdvmcli AddWWNForHostStorageDomain -o "D:\logs\AddWWNForHostStorageDomain.log" "serialnum=10001" "model=XP1024" "port=1" "domain=1" "wwn=22.33.44.55.44.55.44.33,11.33.22.33.44.33.22.22" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Parameter name Status Description 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. Domain ID of the host storage domain to which the path belongs 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.
Command execution example hdvmcli DeleteLun -o "D:\logs\DeleteLun.log" "serialnum=10001" "model=XP1024" "port=1" "domain=1" "devnum=1" "deletionoption=lusekeep" Command execution result RESPONSE: (Command completed; no data returned) DeleteWWN DeleteWWN removes a WWN from a port.
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. Command execution example hdvmcli DeleteWWN -o "D:\logs\DeleteWWN.log" "serialnum=10001" "model=XP1024" "port=0" "wwn=11.22.33.22.44.55.33.
Parameter name Status Description The nickname of the host storage domain domainnickname Optional You must specify either domain or domainnickname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Comma-separated list of WWNs to unsecure the host storage domain Optional wwn To specify two or more options, separate them with commas. You must specify either wwn or wwnnickname. Do not specify both parameters at the same time.
of (nn) WWN elements, where nn indicates the number of WWNs. Select the target WWN from this list, and use it to specify the wwnnickname parameter. Command execution example hdvmcli DeleteWWNForHostStorageDomain -o "D:\logs\DeleteWWNForHostStorageDomain.log" "serialnum=10001" "model=XP1024" "port=1" "domain=1" "wwn=AA.AA.AA.AA.AA.AA.AA.
Parameter name Status Description 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 “Managing mainframe hosts” on page 346. Parameter values to obtain in advance None. Command execution example hdvmcli AddHost -o "D:\logs\AddHost.log" "hostname=toro2" "wwnlist=AA.CC.CC.CC.CC.CC.CC.CC,00.CC.CC.CC.CC.CC.CC.CC" "ipaddress=192.168.32.
Parameter name Status Description 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. Port that the path is on port Optional Specify either port or portname. Do not specify both parameters at the same time.
Parameter values to obtain in advance serialnum and model: Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port, domain, and devnum: Obtain these values from the execution result of the GetStorageArray (subtarget=Path) command.
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. AddHostRefresh AddHostRefresh refreshes the information about the hosts that Device Manager manages, which is obtained from the Device Manager agent. NOTE: • This command does not support virtualization servers.
Parameter name Status Description 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. Parameter values to obtain in advance objectid: Obtain this value from the execution result of the GetHost command. In the execution result of this command, the objectID value appears under An instance of Host. Use this objectID value to specify the objectid parameter.
NOTE: Notes for registering a virtualization server with a structure that monitors VMware vCenter Server with vMA are described below. • Virtualization servers registered in VMware vCenter Server for a particular IP address of a virtualization server are registered on the Device Manager server with the IP address as the host name. This is because the name of a virtualization server registered on a VMware vCenter Server is registered as the Device Manager server host name .
Parameter name Status Description Protocol of the virtualization server or virtualization server management program hostprotocol Required Specify either of the following: • Non-secure: HTTP communication • Secure: HTTPS communication User ID hostuserid Required hostuserpassword Required Specify the user ID used to access the virtualization server or the virtualization-server management program. User password Specify the password for the user ID specified in hostuserid.
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!).
NOTE: DeleteHost does not delete the host information from the external port. Parameters Table 82 DeleteHost command parameters Parameter name Status Description objectid Optional# Object ID of the host to remove hostname Optional# Name of the host to remove # You must specify either objectid or hostname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
Parameters Table 83 DeleteHostInfo command parameter Parameter name Status Description Object ID of the HostInfo record to remove objectid Required 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. In the execution result of this command, the objectID value appears under An instance of HostInfo.
hdvmcli [URL] GetHost [options] {objectid=object-ID-of-host-for-which-information-is-obtained |hostname=name-of-host-for-which-information-is-obtained} When obtaining information about a particular HORCM configuration file on the host, or information for a particular copy group related to the host: hdvmcli [URL] GetHost [options] objectid=object-ID-of-host-for-which-information-is-obtained {configfileid=object-ID-of-HORCM-configuration-file-of-RAID-Manager-of-host |configfileid=object-ID-of-HORCM-configura
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. NOTE: The HostScan command operates by using the information in the Device Manager server database.
Parameters Table 86 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 87 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 89 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 90 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 92 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 95 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 replicationfunction Optional • Snapshot: Snapshot • ContinuousAccessJournal: Continuous Access Journal Software The default of this parameter differs depending on the condition as shown 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 97 How to obtain parameter values (AddConfigFileForReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter.
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.
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.
NOTE: • This command is not available for XP1024/XP128. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs. • You must specify a formatted LDEV. If you specify an unformatted LDEV, a copy pair is not created. To check whether an LDEV is formatted, for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, use the GetStorageArray command.
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 [replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal}] [munum=Mu-number] [fencelevel=fence-lev
Parameter name Status Description 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. Port number of the HORCM instance that manages the S-VOL Depending on the host OS, specify the appropriate value: • Solaris systems: Specify an integer in the range 0-65535.
Parameter name Status Description Device number of the S-VOL svoldevnum 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. 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. If you omit ww, the LDKC number is regarded as 0.
Parameter name Status Description MU number of the P-VOL munum Optional This parameter can be specified only for Continuous Access Journal Software. If this parameter is not specified, Device Manager automatically specifies the value. Fence level of the P-VOL The fence level is ignored for Business Copy Software, Continuous Access Asynchronous Software, Snapshot, and Continuous Access Journal Software.
See No. 2, No. 4, No. 5, and No. 6 in the table below. Table 99 How to obtain parameter values (AddReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the PVOL 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 P-VOL 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. 4) specified for the objectID parameter. pvolarraytype 5 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"svolarraytype=XP1024" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" "fencelevel=Data" Command execution result 1 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=0 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
number 15001. The ID of the host that recognizes the secondary volume is 1, which is the same ID as that of the primary volume, and the instance number of the HORCM that manages the secondary volume is 12. hdvmcli AddReplication -o "D:\logs\AddReplication.
Command execution example 3 This example creates a RAID Manager configuration definition file and a copy group and then creates a copy pair for Continuous Access Synchronous Software in the copy group. As the primary volume (P-VOL), specify the logical device with LDEV number 11 in the storage system with model number XP1024 and serial number 15001.
replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=14 splitTime=-1 remotePathGroupID=-1 *****: The values are encoded by the CLI. DeleteReplication DeleteReplication deletes copy pair information from a RAID Manager configuration definition file, and then releases the copy pair from the storage system. NOTE: • This command is not available for XP1024/XP128.
Parameter name Status Description Device number of the S-VOL svoldevnum 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 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. If you omit ww, the LDKC number is regarded as 0.
svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
Format When obtaining information about a replication controller pair: hdvmcli [URL] GetReplicationControllerPair [options] masterserialnum=serial-number-of-the-storage-system-containing-the-MCU mastercontrollerid=CU-number-of-the-MCU remoteserialnum=serial-number-of-the-storage-system-containing-the-RCU remotessid=SSID-of-the-RCU [mastermodel=model-of-the-storage-system-containing-the-MCU remotefamily=family-of-the-storage-system-containing-the-RCU remotepathgroupid=path-group-ID-of-the-RCU] When obtainin
Parameter values to obtain in advance Execute the GetReplicationControllerPair command without specifying any parameters, and then obtain the values from the execution result.
Command execution result 2 RESPONSE An instance of ReplicationControllerPair objectID=***** masterArrayType=XP12000 masterSerialNumber=14053 masterControllerID=0 masterStartDevNum=0 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 . .
Parameter name Status Description Device number of the P-VOL pvoldevnum# 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.
Parameter values to obtain in advance replicationgroupid, pvolserialnum, pvoldevnum, svolserialnum, and svoldevnum: Obtain the values of these parameters from the execution result of the GetHost command.
pvolPoolID=-1 svolSerialNumber=65010001 svolArrayType=XP1024 svolDevNum=21 displaySvolDevNum=00:15 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessCopy status=16 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 *****: The values are encoded by the CLI. Items output as command execution results This section lists the items that are output when Device Manager CLI commands are executed. The following items are output for each instance as attributes of Device Manager instances.
Attribute Description Component where the alert occurred component For details about the component, see the attribute name of the instance Component. description Alert description (example: Serious error detected on DKU drive.) actionToTake Action to be taken for the alert (example: Contact Customer Support.) Data required to analyze the alert data When the value of type is Trap, the SIM data required by the customer service is output.
Attribute Description RAID level of the parity group RAID levels are output in the format RAIDx(yD+zP). • RAIDx: RAID level raidType • yD: Number of data drives • zP: Number of parity drives For example, RAID5(3D+1P) indicates a RAID5 configuration consisting of three data drives and one parity drive. Emulation mode emulation This item is output for the XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8).
Attribute Description List of CU numbers related to the parity group cuInfo A list of numbers separated by spaces or semicolons (;) is output when the storage system is XP24000/XP20000 or XP12000/XP10000/SVS200 and the operator is the partitioned storage administrator. This item is not output when the storage system is XP24000/XP20000 or XP12000/XP10000/SVS200 and the operator is the storage administrator, or when other storage systems are being used, as it is not relevant.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openUnallocatedActualCapacity • Paths are not assigned. • Paths can be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity. openReservedCapacity Total size of the open logical units and the intermediate logical units that satisfy both the following conditions (in KB): • Paths are not assigned.
Attribute Description Protection level of the parity group For P9500 or XP24000/XP20000, one of the following values is output: • 0: Standard The parity group consists of drives other than SATA drives • 1: SATA-W/V The parity group consists of SATA drives • 2: SATA-E protectionLevel The parity group consists of SATA drives and the write performance is more enhanced than SATA-W/V -1 is output if any of the following conditions are satisfied: • The protection level of the parity group is unknown.
• • • • • “AddStorageArray” on page 73 “AddVirtualizationServer” on page 218 “GetHost” on page 223 “GetStorageArray (subtarget=CommParameters) ” on page 115 “RefreshStorageArrays” on page 190 Table 106 CommParameters instance attributes Attribute Description User ID One of the following values is output: For a storage system: userID User ID for accessing the storage system For a virtualization server: User ID for accessing the virtualization server or the virtualization-server management program IP add
Component instance The Component instance is output when the GetStorageArray (subtarget=Component) command (see “GetStorageArray (subtarget=Component) ” on page 116) is executed.
ConfigFile instance The ConfigFile instance is output when the GetHost command (see “GetHost” on page 223) is executed. Table 108 ConfigFile instance attributes Attribute Description objectID Object ID of the configuration definition file for RAID Manager instanceNumber Instance number of the HORCM instance. controlledBy Name of the program that defines the configuration of the copy pair portNumber Port number of the HORCM instance Indicates whether HORCM instance can operate.
Attribute Description externalWWN Port WWN of the external storage system externalLun LUN of the external volume portID Port ID of the port to which the external storage system is connected pathGroupID Group ID of the path Path priority One of the following values is output: priority • -1: None • 1: Primary path • 2 or greater: Alternate path ExternalStorage instance The ExternalStorage instance is output when GetStorageArray (subtarget=ExternalStorage) (see “GetStorageArray (subtarget=ExternalS
• “GetStorageArray (subtarget=FreeSpace) ” on page 122 Table 113 FreeSpace instance attributes Attribute Description objectID Object ID of a region of unused capacity in the parity group sizeInKB Size of a region of unused capacity in the parity group (in KB) Number of cylinders in a region of unused capacity in the parity group cylinders 0 is output for open volumes.
Attribute Description Host type One of the following values is output: • -1: Normal host hostType • 1: External port • 2: Mainframe host • 3: Virtualization server (VMware ESX or VMware ESXi) sysplexID Mainframe host sysplexID Status of the processing to update the Device Manager database If the value of hostType is -1 or 3, one of the following values is output: • 0: The Device Manager database is consistent. statusOfDBUpdating • 1: The Device Manager database is being updated.
Attribute Description LUN mount point mountPoint A space is output for a virtualization server. portID Port ID domainID Domain ID of the host storage domain SCSI ID assigned to a channel in the storage system scsiID 15 is output for Fibre Channel.
Attribute Description Display name of the logical unit device number This value is output in one of the following formats: For P9500 or XP24000/XP20000: The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. displayDevNum For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description Domain type of the host storage domain domainType 0 (host group) is output. portName Port name of the host storage domain IPAddress instance The IPAddress instance is output when the GetStorageArray (subtarget=PortController) command (see “GetStorageArray (subtarget=PortController) ” on page 158) is executed. Table 117 IPAddress instance attribute Attribute Description IP address of the port controller ipAddress This item is output when NAS is created.
Attribute Description Emulation mode emulation This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8).
Attribute Description Indicates whether a path is assigned to the LDEV: • true: A path is assigned. path • false: No path is assigned. Indicates whether the LDEV is used as a device that is expanded on demand: onDemandDevice • true: The LDEV is expanded on demand. • false: The LDEV is not expanded on demand. Indicates the purpose of the LDEV: devType • AutoLunReserved: The LDEV is reserved for Auto LUN Software. • OnDemandDevice: The LDEV is expanded on demand.
Attribute Description LDEV type One of the following values is output: • -1: Unknown volumeKind • 1: Mainframe volume • 2: Intermediate volume • 3: Open volume LDEV status One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: For Virtual Storage Platform, Universal Storage Platform V/VM, or Hitachi USP: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) status • Blocked: Blocked status or unformatted.
Attribute Description Volume type of Hitachi TrueCopy for Mainframe Software or Hitachi TrueCopy Asynchronous for Mainframe Software One of the following values is output: mfTrueCopyVolumeType • Unknown: Unknown • Simplex: Not a Hitachi TrueCopy for Mainframe Software volume or Hitachi TrueCopy Asynchronous for Mainframe Software volume • P-VOL • S-VOL Volume type of Hitachi ShadowImage for Mainframe Software One of the following values is output: • Unknown: Unknown mfShadowImageVolumeType • Simplex: N
Attribute Description Usage rate threshold of the virtual volume One of the following values is output for P9500 or XP24000/XP20000: When the LDEV is a THP volume: usage rate threshold value of the THP volume#1, #2 threshold -1 is output for volumes other than THP volumes. #1 When the THP volume is not assigned to a THP pool, -1 is displayed. #2 When the operator is a partitioned storage administrator, -1 is displayed. -1 is output for other storage systems.
LogicalGroup instance The LogicalGroup instance is output when the GetLogicalGroup command (see “GetLogicalGroup” on page 197) is executed: Table 120 LogicalGroup instance attributes Attribute Description objectID Object ID of the logical group name Name of the logical group Object ID of the parent group parentID This item is not output when the logical group is the highest level.
• • • • • • • • • • • “GetPoolShrinkStatus” on page 100 “GetStorageArray (subtarget=ArrayGroup) ” on page 111 “GetStorageArray (subtarget=LogicalUnit) ” on page 134 “GetStorageArray (subtarget=Pool) ” on page 149 “GetStorageArray (subtarget=ReplicationInfo) ” on page 160 “GetZeroPageReclaimStatus” on page 163 “ModifyLogicalUnit” on page 168 “ModifyPool” on page 170 “ModifyVirtualVolume” on page 186 “RunZeroPageReclaim” on page 191 “ShrinkPool” on page 193 Table 121 LogicalUnit instance attributes Attribut
Attribute commandDeviceSecurity Description Indicates whether command device security is set when the logical unit is used as a command device: • true: Set. • false: Not set. Indicates the usage status of the logical unit. • 0: Not a command device. commandDeviceEx • 1: Command device. • 2: Remote command device.
Attribute Description Volume type of Snapshot One of the following types is output: • Unknown: Unknown snapshotVolumeType • Simplex: Not a Snapshot volume • P-VOL • V-VOL • POOL Volume type of Continuous Access Journal Software One of the following types is output: • Unknown: Unknown • Simplex: Not a Continuous Access Journal Software volume journalVolumeType • P-VOL • S-VOL • SP-VOL • JNL-VOL: Continuous Access Journal Software JNL-VOL • MF-JNL: Hitachi Universal Replicator for Mainframe Software JNL-
Attribute Description Type of the Thin Provisioning volume One of the following values is output for P9500 or XP24000/XP20000: • -1: Non-THP volume thpType • 0: THP volume • 1: THP pool volume -1 is output for other storage systems. Usage of on the THP volume (KB) One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit does not consist of THP volumes: The same value as capacityInKB. • When the logical unit consists of THP volumes: Usage of on the THP volumes.
Attribute Description The status of a THP pool volume. One of the following values is output for P9500: • 2 : The THP pool can shrink. thpPoolVolControlFlag • 1 : The THP pool is shrinking. • 0 : The THP pool cannot shrink (for example, the initial THP pool volume). • -1 : The volume is normal (includes the volumes that became normal volumes after the THP pool finishes shrinking). -1 is output for other storage systems.
Attribute Description Device number of the S-VOL This value is output in one of the following formats: For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
ObjectLabel instance The ObjectLabel instance is output when one of the following commands is executed: • • • • • “GetStorageArray (subtarget=ArrayGroup) ” on page 111 “GetStorageArray (subtarget=LDEV) ” on page 129 “GetStorageArray (subtarget=LogicalUnit) ” on page 134 “AddLabel” on page 54 “ModifyLabel” on page 166 Table 123 ObjectLabel instance attributes Attribute Description targetID Object ID of the label label Label name PairedPool instance The PairedPool instance is output when the GetStorag
Path instance The Path instance is output when the following commands are executed: • • • • • • • “AddLun” on page 200 “GetLogicalGroup” on page 197 “GetStorageArray (subtarget=ArrayGroup) ” on page 111 “GetStorageArray (subtarget=HostStorageDomain) ” on page 126 “GetStorageArray (subtarget=LogicalUnit) ” on page 134 “GetStorageArray (subtarget=Path) ” on page 143 “GetStorageArray (subtarget=Port) ” on page 155 Table 126 Path instance attributes Attribute Description objectID Object ID of the path Path
PDEV instance The PDEV instance is output when the following commands are executed: • • • • • “AddPool” on page 65 “GetStorageArray (subtarget=ArrayGroup) ” on page 111 “GetStorageArray (subtarget=PDEV) ” on page 147 “GetStorageArray (subtarget=Pool) ” on page 149 “ModifyPool” on page 170 Table 127 PDEV instance attributes Attribute Description objectID Object ID of the physical device Drive name name This item is output if it has been registered.
Attribute Description Serial number of the drive serialNumber This item is not output. Type of the storage system containing the physical device One of the following values is output: • P9500: P9500 dkuType • XP24K: XP24000/XP20000 • XP12K/10K/SVS200: XP12000/XP10000/SVS200 • XP1024/128: XP1024/XP128 Drive revolutions per minute This information is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. rpm 0 or -1 is output if the drive revolutions are unknown.
Attribute Description Outputs the function by which the pools are being used. • 3: Snapshot poolFunction • 4: Continuous Access Journal Software • 5: Thin Provisioning ID of the Pool poolID The ID is output for the pool that corresponds to the function type output to poolFunction. ID of the disk controller Valid for P9500 and XP24000/XP20000. When poolFunction is 3: ID of the controller to which the pool belongs controllerID When poolFunction is 4: Logical DKC number -1 is output for other cases.
Attribute Description Status of the pool Valid for P9500 and XP24000/XP20000. • 0: Normal • 1: PFUS • 16: Blocked status • 17: Over threshold • 18: Regressed • 19: Warning • 20: Shrinking -1 is output if no information can be acquired. Threshold1 of the pool (%) The value output depends on the poolFunction value. threshold • When poolFunction is 3: Threshold1 of the Snapshot pool • When poolFunction is 5: Threshold1 of the THP pool This information is invalid for other cases (-1 is output).
Attribute Description Number of virtual volumes assigned to the pool numberOfVVols For example, for XP24000/XP20000, when poolFunction is 5, the number of volumes for Thin Provisioning Software assigned to the pool for Thin Provisioning Software is output.
Attribute Description Type of the drive If the storage system is P9500 and a pool for Thin Provisioning Software is used, one of the following values is output: • -1: Unknown or a different drive type diskType • 1: SATA • 4: SAS • 5: SSD This information is invalid for other cases (-1 is output). Indicates whether the pool is a pool for Smart Tiers.
Attribute Description Indicates whether a THP pool can be configured by mixing internal and external volumes.
Attribute Description Indicates whether the volumes that make up the hardware tier are internal or external volumes: substance • -1: Unknown • 0: Internal volume • 1: External volume Port instance The Port instance is output when the following commands are executed: • “GetStorageArray (subtarget=Port) ” on page 155 • “ModifyPort” on page 178 Table 130 Port instance attributes Attribute Description objectID Object ID of the port Port name name This item is output if it has been registered.
Attribute Description Channel speed One of the following values is output: • -1: None • 0: Automatic channelSpeed • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps • 8: 8 Gbps • 10: 10 Gbps Port attribute One of the following values is output: • Target • RCU Target portRole • Initiator • LCP • RCP • External: External port • No value: Unknown SLPR number slprNumber -1 is output for storage systems that do not support SLPR.
Attribute Description Mode of the port controller One of the following values is output: For P9500: • 1: Normal mode For XP24000/XP20000: • 1: Normal mode • 2: High-speed mode (all ports) • 3: Unknown • 4: Reserve mode • 5: High-speed mode (upper 4 ports) • 6: High-speed mode (lower 4 ports) For XP12000/XP10000/SVS200: mode • 1: Normal mode • 2: High-speed mode (all ports) • 3: Unknown • 4: Reserve mode • 5: High-speed mode (upper 4 ports) • 6: High-speed mode (lower 4 ports) • 7: High-speed mode is set
Attribute Description For XP12000/XP10000/SVS200: • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-Tachyon (4 ports) • 44: Fibre-Tachyon (8 ports) • 45: Fibre-Tachyon (16 ports) • 46: NAS (2 ports) • 48: NAS (4 ports) • 49: FICON (4 ports) • 50: FICON (8 ports) • 51: iSCSI (4 ports) • 52: iSCSI (4 ports) • 55: Fibre-Tachyon (8 ports) • 56: Fibre-Tachyon (16 ports) • 57: Fibre-Tachyon (4 ports) • 58: Fibre-Tachyon (8 ports) • 59: Fibre-Tachyon (16 ports) • 60: Fibre-Tachyon (4 ports) • 61: FICON (8 por
ReplicationControllerPair instance The ReplicationControllerPair instance is output when the GetReplicationControllerPair command (see “GetReplicationControllerPair” on page 274) is executed.
Attribute Description Display name of the highest device number among the applicable LUs in the MCU This value is output in one of the following formats: For P9500 or XP24000/XP20000: The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. displayMasterEndDevNum For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
• “ModifyReplication” on page 277 Table 133 ReplicationGroup instance attributes Attribute Description objectID Object ID of the copy group replicationGroupID Group ID of the copy group groupName Name of the copy group used by the RAID Manager pvolHostID Host ID of the host that recognizes the P-VOL pvolInstanceNumber Instance number of the HORCM instance that manages the P-VOL pvolPortNumber Port number of the HORCM instance that manages the P-VOL pvolHORCMMONHostName In the HORCM configurat
ReplicationInfo instance The ReplicationInfo instance is output when the following commands are executed: • • • • • • “AddReplication” on page 260 “DeleteReplication” on page 272 “GetHost” on page 223 “GetStorageArray (subtarget=Pool) ” on page 149 “GetStorageArray (subtarget=ReplicationInfo) ” on page 160 “ModifyReplication” on page 277 Table 134 ReplicationInfo instance attributes Attribute Description objectID Object ID of ReplicationInfo Name of the copy pair used by the RAID Manager pairName Thi
Attribute Description Copy type One of the following values is output: • BusinessCopy: Business Copy Software replicationFunction • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot • ContinuousAccessJournal: Continuous Access Journal Software fenceLevel Fence level of the P-VOL (example: Data) Copy status One of the following values is output: • -1: Unknown • 0: Simplex • 1: Pair • 8: Copying status • 9:
Attribute Description Device number of the S-VOL This value is output in one of the following formats: For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
Attribute Description License status One of the following values is output: • -1: Unknown • 0: Permanent license • 1: Temporary license license • 2: Emergency license • 100: Core CLI/SMI-S license • 200: A license has not been installed. • 201: A temporary license has expired. • 202: An emergency license has expired.
• • • • • • • • • • • “GetStorageArray (subtarget=PortController) ” on page 158 “GetStorageArray (subtarget=ReplicationInfo) ” on page 160 “GetZeroPageReclaimStatus” on page 163 “ModifyLogicalUnit” on page 168 “ModifyPool” on page 170 “ModifyPort” on page 178 “ModifyPortController” on page 185 “ModifyVirtualVolume” on page 186 “RefreshStorageArrays” on page 190 “RunZeroPageReclaim” on page 191 “ShrinkPool” on page 193 Table 136 StorageArray instance attributes Attribute Description objectID Object ID o
Attribute Description freeCapacityInGB Total size of the logical units to which paths are not assigned (in GB) allocatedCapacityInGB Total size of the logical units to which paths are assigned (in GB) autoLunCapacityInGB Total size of the logical units reserved for Auto LUN Software (in GB) onDemandCapacityInGB Total size of the LDEVs expanded on demand (in GB) Total size of the areas (free areas) that are not logical units (in GB) totalFreeSpaceInGB largestFreeSpaceInGB For P9500, XP24000/XP200
Attribute Description 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 One of the following values is output: • -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. -1 is output for storage systems other than XP12000/XP10000/SVS200 and XP24000/XP20000.
Attribute Description Number of intermediate logical units that satisfy the following conditions: numberOfImUnallocatedLUs • Paths are not assigned. numberOfMfLDEVs Number of mainframe logical devices numberOfAllocatedMfLDEVs Number of mainframe logical devices to which paths are assigned numberOfUnallocatedMfLDEVs Number of mainframe logical devices to which paths are not assigned productCode Product code of the storage system • Paths can be assigned by using Device Manager.
Attribute openUnallocatedCapacity 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. Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openUnallocatedActualCapacity • Paths are not assigned. • Paths can be assigned by using Device Manager.
Attribute Description name Name of the URLLink description Additional description of the URLLink url URL required for starting an application or a Web page linkedID Object ID of the Device Manager object for which URLLink is set 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.
Attribute Description name This item is output if it has been registered.
• • • • • • • “GetStorageArray (subtarget=HostStorageDomain) ” on page 126 “GetStorageArray (subtarget=LogicalUnit) ” on page 134 “GetStorageArray (subtarget=Path) ” on page 143 “GetStorageArray (subtarget=Port) ” on page 155 “MergeHost” on page 235 “ModifyHost” on page 236 “ModifyPort” on page 178 Table 141 WWN instance attributes Attribute Description World Wide Name wwn A World Wide Name is usually assigned to the HBA in the server.
storage system allocation. For details about the AddArrayReservation command, see “AddArrayReservation” on page 41. If an error has occurred and the processing has stopped, you should check which parts of the batch file have been executed. The checking process is easier if you create the batch file as follows: • Write commands that have the same port or portname on consecutive lines. • Write commands so that the devnum follows the order of the serial number.
• Command parameters and specified values cannot be enclosed in " and '. • Aside from parameter specifications, a \ must be specified to escape the following characters: spaces ! " # $ % & ' ( ) * + < > ? @ [ \ ] ^ ` { | } ~ The following shows an example specification where Lun10 HOST2, a string containing a space, is specified for the name parameter.
satisfied by the parameter). Condition-n in the Specification conditions column corresponds to the above conditions.
Command name Parameter Specification conditions capacitytype chassis#2 Y (condition-2) creationoption N devnum#1 -- emulation Y (condition-3#3) format Y (condition-1) fsindex N groupnum#2 Y (condition-2) 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-
Command name Parameter Specification conditions capacitytype Y (condition-1) clprNumber Y (condition-2) devnum#1 -- groupoption N model Y (condition-1) numoflus N poolid Y (condition-2) serialnum Y (condition-1) 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 (c
Command name Parameter Specification conditions devnums#5 model Y (condition-1) poolid -- serialnum Y (condition-1) threshold -- Legend: Y (condition-n): If the specification conditions for the parameter, condition-n, are satisfied, the command can be executed together with other commands when this parameter is specified. N: If this parameter is specified, the command cannot be executed together with other commands. The command is executed by itself.
hdvmcli ADDLUN model=XP12000 serialnum=14053 portname=CL1-A domain=0 devnum=817 lun=101 hdvmcli ADDLUN model=XP12000 serialnum=14053 portname=CL1-B domain=0 devnum=816 lun=102 hdvmcli ADDLUN model=XP12000 serialnum=14053 portname=CL1-B domain=0 devnum=817 lun=103 endbatch Executing batch function of commands This section explains how to execute the batch function of commands by using a created batch file: When specifying the batch option (-b or --batch), specify the following items from the command line or
objectID=***** name=XP12000@10.208.116.108 description=XP12000 (14053) at 10.208.116.
lastRefreshed=1,153,456,561 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocatedActualCapacity=1,683,100,560 openUnallocatedCapacity=5,803,543,936 openUnallocatedActualCapacity=5,803,543,936 openReservedCapacity=62,545,600 openReservedActualCapacity=62,545,600 numberOfReservedLUs=32 numberOfOpenReservedLUs=32 numberOfImReservedLUs=0 distributedMode=-1 List of 4 Path elements: An instance of Path objectID=***** devNum=816 displayDevNum=03:30 portID=0 portName=CL1-A domainID=0 scsiID=1
When an error occurs during batch functionality execution This section explains how to take action if an error occurs during batch functionality execution. When the target storage system is other than XP24000/XP20000, or is an XP24000/XP20000 whose microcode version is earlier than 60-02-00-00/00 If an error occurs during the batch functionality execution, perform the following procedure to check up to what point the batch file content was processed.
"1005,1003", "1005,1021", "1005,1363", "1005,6036", "1005,1004", "1005,1005", "1005,1007", "1005,1018", "1005,1020", "1005,1025", "1005,1068", "1005,1134", "1005,1135", "1005,1350", "1005,1368", "1005,1600", "1005,1600", "1005,1904", "1005,6012", "1005,65660" "2005,1002", "2005,1021", "2005,1185", "2005,1601", "2005,6036", "2005,1009", "2005,1010", "2005,1012", "2005,1028", "2005,1050", "2005,1126", "2005,1187", "2005,1196", "2005,1362", "2005,1904", "2005,1905", "2005,1921", "2005,65660", "2005,65672"
• Batch file • Device Manager server log files When the error code of the storage system is not one of the values listed above: Perform the following procedure: 1. Execute the AddStorageArray command or RefreshStorageArrays command. 2. Execute the GetStorageArray command to check which command lines in the batch file were applied to the storage system. The command processing during batch functionality execution is not performed in the order described in the batch file.
Setting up the Device Manager environment The following procedure shows how to set up a Device Manager environment that enables the GUI to display mainframe volume information and logical DKC serial numbers of storage systems. 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.
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** 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 IPv4 environment): hdvmcli AddURLLink "url=http://mainframe-host-IP-address:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.
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 347 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 348.
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 347 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 348.
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. Changing P9000 mainframe agent information registered in Device Manager To change P9000 mainframe agent information registered in the Device Manager server, use the AddURLLink command.
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. For example, you might want to execute the command if you specified the name parameter incorrectly. Example of executing the command: hdvmcli DeleteURLLink -o "D:\logs\DeleteURLLink.
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. You can change the name of a mainframe host by specifying the new host name in the hostname parameter.
Deleting a mainframe host To delete a mainframe host registered in the Device Manager server, use the DeleteHost command. NOTE: If you delete a mainframe host, the P9000 mainframe agent information registered in Device Manager is also deleted, and the mainframe volume information and the logical DKC serial number of the storage system displayed in the GUI are no longer displayed. Example of executing the command: hdvmcli DeleteHost -o "D:\logs\DeleteHost.
Device Manager CLI command reference
5 Device Manager CLI 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.
When you specify the saved file that contains the preceding message, you can create multiple LUNs using one command, as follows: hdvmcli -t -i xmlcommand.
6. 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>
tierControl CDATA #IMPLIED> autoMigration CDATA #IMPLIED> migrationInterval CDATA #IMPLIED> monitorStartTime CDATA #IMPLIED> monitorEndTime CDATA #IMPLIED> monitoringMode CDATA #IMPLIED> externalMixCompatible CDATA #IMPLIED>
Device Manager CLI properties file
6 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. • For troubleshooting information specific to the Device Manager CLI, see Table 145.
Problem Description and recommended action SOLUTION: Collect the following information, and then contact your HP Technical Support representative. The following error message is displayed and the Device Manager CLI stopps: • CLI log file An unspecified error was encountered in CLI. • Command line input • CLI properties file • An executed batch file if a batch was executed. • Device Manager server log. Text is omitted from the displayed error message.
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.
7 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
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, 34 AddArrayReservation, 41 AddConfigFileForReplication, 251 AddExternalArrayGroup, 42 AddHost, 213 AddHostInfo, 214 AddHostRefresh, 217 AddHostStorageDomain, 47 AddLabel, 54 AddLogicalUnit, 55 optimization of regions of unused capacity, 55 AddLun, 200 AddLUSE, 61 AddPool, 65 AddReplication, 260 AddStorageArray, 73 AddURLLink, 244 AddVirtualizationServer, 218 AddVirtualVolume, 76 AddWWNForHostStorageDomain, 205 B batch execution example, 341 execution results, 341 batch file to execu
GetHostInfo, 232 GetLogicalGroup, 197 GetPoolShrinkStatus, 100 GetReplicationControllerPair, 274 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 GetStorage