HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96083 Fifth edition: November 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 ...........................................................................................................
DeleteLUSE ........................................................................................................................ 96 DeletePool ......................................................................................................................... 98 DeleteStorageArray ............................................................................................................ 99 DeleteVirtualVolume ..........................................................................................
GetHost .......................................................................................................................... GetHostInfo ..................................................................................................................... HostScan ........................................................................................................................ MergeHost ...............................................................................................................
ReplicationControllerPair instance ............................................................................................. ReplicationGroup instance ....................................................................................................... ReplicationInfo instance ........................................................................................................... ServerInfo instance ....................................................................................................
Related information ................................................................................................................. 401 A Connecting to P9000 mainframe agent ............................................ 403 About connecting to P9000 mainframe agent ............................................................................ Setting up the mainframe host environment ................................................................................. Setting up the Device Manager environment .
Figures 1 Example of executing the AddExternalArrayGroup command ........................................ 46 2 Relationship of attributes (total size of the storage system) ........................................... 356 3 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 356 4 Relationship of attributes (the sizes of the volumes) ....................................................
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 17 2 hdvmcli variable syntax ........................................................................................... 24 3 hdvmcli options ...................................................................................................... 25 4 hdvmcli return values ...............................................................................................
33 DeleteHostStorageDomain command parameters ........................................................ 92 34 DeleteLabel command parameters ............................................................................. 94 35 DeleteLogicalUnit command parameters ..................................................................... 95 36 DeleteLUSE command parameters ............................................................................. 97 37 DeletePool command parameters ...............................
70 ModifyPortController command parameters .............................................................. 197 71 ModifyVirtualVolume command parameters ............................................................. 200 72 RefreshPerformanceData command parameter .......................................................... 204 73 RefreshStorageArrays command parameter .............................................................. 205 74 RunZeroPageReclaim Command Parameters .....................................
107 ModifyReplication command parameters ................................................................. 294 108 Alert instance attributes .......................................................................................... 299 109 ArrayGroup instance attributes ............................................................................... 300 110 ArrayReservation instance attributes .........................................................................
144 URLLink instance attributes ...................................................................................... 356 145 VirtualDisk instance attributes ................................................................................. 357 146 VM instance attributes ........................................................................................... 357 147 VolumeConnection instance attributes ......................................................................
Preface This guide describes HP StorageWorks P9000 Command View Advanced Edition Suite Software and how to set up and use the command line interface (CLI). Besides command syntax and parameters, topics include batch files, mainframe hosts, output formats, and troubleshooting. The intended audience is a storage administrator with independent knowledge of HP StorageWorks P9000 storage systems, SANs, and Java environments.
Preface
1 Overview This chapter provides an overview of the Device Manager CLI. This chapter also explains the differences between Device Manager licenses and provides a procedure for downloading the Device Manager CLI from the Device Manager server. Overview of the Device Manager CLI By issuing commands from a command line prompt, the Device Manager CLI communicates with the Device Manager server and issues requests to a storage system.
Item Functions available with the Core CLI/SMI-S license Storage systems Same as for a full license GUI If the Core CLI/SMI-S license is used to log in, only the items related to user management in the Administration tab are displayed. Users with the Core CLI/SMI-S license can use only the functions displayed in the Administration tab. Device Manager CLI The logical group command (GetLogicalGroup) cannot be used.
2 Environment settings This chapter provides the environment settings necessary to use the Device Manager CLI. Java environment settings To execute the Device Manager CLI, the Java environment must be properly configured for the Device Manager CLI execution environment. How to configure a Java environment It is assumed that a Java version supported by the Device Manager CLI is installed on the computer that executes the Device Manager CLI.
When using the same JRE as the Device Manager server When the Device Manager CLI uses the same JRE as the Device Manager server, specify the path of that JRE in the HDVM_CLI_JRE_PATH environment variable. The HP P9000 Command View Advanced Edition Suite Common Component (abbreviated hereafter as Common Component) installation directory is included in the JRE path.
Before setting up an environment on the management client, set up secure communication from the Device Manager server. If you reconfigure communication security from the Device Manager server, the Device Manager server certificate is changed. If this occurs, you need to replace the management client certificate. To set up an environment from the management client that the Device Manager CLI is executed from: 1.
• Use the server name set in the Device Manager server certificate as the host name for the Device Manager server URL. • Use the HTTPS port for the Device Manager server URL (2443, unless configured differently in the server's configuration file). Setting the HDVM_CLI_MEM_SIZE environment variable To ensure successful CLI execution, the HDVM_CLI_MEM_SIZE environment variable must be set to an appropriate value. The default value is 256 MB.
3 Executing commands This chapter explains how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Command syntax The Device Manager CLI provides a simple way to submit requests to the Device Manager server and examine responses from the server. The application is run from the command line. Each execution of the application sends one request to the server and receives a response to that request.
NOTE: • You can also set the URL, options, and parameters arguments in the properties file. If arguments are specified both in the properties file and from the command line, the arguments specified from the command line take precedence. For details about the properties file, see Chapter 7 on page 375. • The Device Manager CLI only supports ASCII code characters.
Variable options Function Options control the behavior of the CLI application. Options are entered in the typical UNIX fashion. Options are case sensitive. Each option has a single character representation and an alternate word representation; for the single character, prefix the character with a single dash; for the word, prefix the word with two dashes. For example: -t or --messagetrace. Some options require an argument, which follows the option. For example, the -u option is followed by a user ID.
Option Argument for the option Status Description An XML API request file. Takes input from the specified file, which must contain the Device Manager server request as a complete XML document. When this option is selected, the output of the server's response is an XML-formatted document. -i or --input file-name#2 Optional If you specify this option, the specification in the file overrides the equivalent specification from the command line.
If you execute a command other than the Help function by specifying a login user ID but not specifying the login password for the option or property, a message appears prompting you to enter the login password. #4 If you specify csv with the -f (or --format) option as one of the parameters for the GetStorageArray command, there are some parameters that you cannot specify.
In Solaris, AIX, Linux, or HP-UX: # ./hdvmcli.sh Basic Help includes the current Device Manager CLI version. • Command Help Command Help explains the functions of specific commands and the parameters that can be specified for those commands.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Creates a LUSE. Y Y Y Y AddPool Creates a THP pool. Y Y -- -- AddStorageArray Searches for storage systems and registers the storage system information into the Device Manager server database. For the registered storage systems, this command modifies the registered information, and refreshes (updates the configuration information of) the storage systems.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- -- Deletes a storage system as a management target of the Device Manager server. Y Y Y Y DeleteVirtualVolume Deletes THP volumes (virtual volumes). Y Y -- -- FormatLU Formats an LU. Y Y Y Y GetArrayReservation Obtains information about a locked storage system. Y Y Y Y GetPoolShrinkStatus Obtains the execution status of a THP-pool shrink operation.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 -- Y Y Y ModifyVirtualVolume Assigns THP volumes (virtual volumes) to a THP pool, releases such assignments, modifies the usage rate threshold of THP volumes, expands THP volumes, or modifies the tiering policy for volumes for Smart Tiers (virtual volumes).
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 XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y AddWWNForHostStorageDomain Sets the security of a LUN in the host storage domain by assigning its WWN in the host storage domain.
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.
Command name Description GetReplicationControllerPair Obtains RCU (remote path) information registered in the MCU in storage systems managed by the Device Manager server. ModifyReplication Changes copy pair statuses. XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y P9500 XP1024/ XP128 Legend: Y: Indicates that the particular storage system can be used to execute the command. -: Indicates that it cannot be used to execute the command.
To execute Device Manager commands, a user must belong to a user group to which resource groups and roles are assigned. The user can perform operations on only assigned resources and within the range of their assigned roles. Before executing commands, confirm what limitations there are (what resources can be accessed and what roles are assigned) with the administrator managing access control. NOTE: • There are Admin, Modify, and View roles.
Command name Role DeleteArrayReservation Admin or Modify DeleteExternalArrayGroup Admin or Modify DeleteHostStorageDomain Admin or Modify DeleteLabel Admin or Modify DeleteLogicalUnit Admin or Modify DeleteLUSE Admin or Modify DeletePool Admin or Modify DeleteStorageArray Admin#1 DeleteVirtualVolume Admin or Modify FormatLU Admin or Modify GetArrayReservation Admin or Modify GetPoolShrinkStatus Admin or Modify GetStorageArray Admin, Modify, or View GetTieredPoolStatus Admin or M
To you perform operations for SMI-S Enabled storage systems, All Resources must be assigned as a resource group.
All Resources must be assigned as a resource group. Table 16 Roles required to execute commands (server management commands) Command name Role AddURLLink Admin# or Modify# DeleteAlerts Admin or Modify DeleteURLLink Admin# or Modify# GetAlerts Admin, Modify, or View GetServerInfo Admin, Modify, or View GetURLLink Admin, Modify, or View # All Resources must be assigned as a resource group.
Item Description Related commands When setting up security for a LUN or host storage domain, make sure that I/O operations from the host to the LU of the corresponding port have stopped. Setting up security for a LUN or host storage domain If you set up security for a LUN or host storage domain, the LUN security for the corresponding port will take effect automatically.
Executing commands
4 Command reference This chapter describes the syntax and parameters of Device Manager CLI commands with execution examples. Storage system commands The storage system commands can be used to register, modify, and delete storage system information. AddArrayReservation AddArrayReservation locks the target storage system. When changing the storage system configuration, use this command to lock the target storage system in order to avoid conflicts with other users' operations.
• DeleteLUSE • DeletePool • DeleteVirtualVolume • DeleteWWN • DeleteWWNForHostStorageDomain • FormatLU • ModifyArrayReservation • ModifyLogicalUnit • ModifyPool • ModifyPort • ModifyPortController • ModifyVirtualVolume • RunZeroPageReclaim • ShrinkPool Parameters Table 19 AddArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model
AddExternalArrayGroup AddExternalArrayGroup performs one-to-one mapping of external volumes (volumes in an externally connected storage system) to internal volumes, and then creates a parity group. AddExternalArrayGroup also creates an LU in the created external parity group. When you perform mapping, you can specify multiple paths (alternate paths). NOTE: • This command can be used only with P9500 and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-02-40-XX/XX or later.
Parameter name Status Description Port WWN of the external storage system If you specify multiple (alternate) paths, use a comma to separate each entry. externalwwn Required When specifying paths, the parameters portname, externalwwn, and externallun must all be specified as a set. The order in which they are specified dictates the path priority. (The first parameter in the set will become the primary path.) Make sure that the order and number of the values specified for these parameters are correct.
Parameter name Status Description Option information that determines whether logical units are to be created at the same time an external parity group is created Either of the following values can be specified: luoption Optional • none: No logical unit is created. • create: Logical units are created. If this parameter is omitted, none is set. Number of logical units to be created The only valid value is 1. numoflus Optional If this parameter is omitted, 1 is set.
Then, for the portname parameter, specify the displayName value of the port whose portRole value is External. At this time, record the worldWidePortName value. externalwwn For external storage systems other than SMI-S Enabled storage systems, obtain this value from the execution results of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Then, select the port whose wwn value displayed below An instance of WWN matches the worldWidePortName value of the portname parameter.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
sizeInKB=1,048,576 cylinders=0 fsControlIndex=0 List of 2 ExternalPathInfo elements: An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.50 externalLun=1 portID=13 pathGroupID=23 priority=1 An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.52 externalLun=0 portID=15 pathGroupID=23 priority=2 *****: The values are encoded by the CLI. AddHostStorageDomain AddHostStorageDomain adds a host storage domain.
Parameter name Status Description Domain ID of the host storage domain This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional The specifiable values vary, depending on the storage system.
Parameter name Status Description Nickname of the host storage domain Specify the name used for the host group to be created in the storage system. If this parameter is omitted, it is set automatically. When adding a host storage domain, if you use the HostScan command to register a host in Device Manager, in the nickname parameter specify the name of the host that uses the host storage domain. For details about the HostScan command, see “HostScan” on page 248.
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 23 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.
objectID=***** portID=3 portName=CL7-A domainID=15 hostMode=Standard 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.
devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter. In the execution result of this command, the devNum value of an LDEV appears under An instance of LDEV. For the devnums parameter, specify the devNum value of the LDEV to which you want to add a label. Command execution example hdvmcli AddLabel -o "D:\logs\AddLabel.
NOTE: • For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, the capacity of LDEV to be created will be larger than the specified capacity. • For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, you cannot create an LDEV that is the same size as the unused capacity of the parity group, because the control area is created on the storage system side. • For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128, the SSID must be set before an LDEV and LU are created.
When creating multiple logical units in bulk by specifying their number: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number|arraygroupname=parity-group-name} [fsindex=index-number-of-region-of-unused-capacity] creationoption=dividebynum numoflus=number-of-logical-units-to-be-created [emulation=OPEN-V] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick#}] [capacitytype={KB|block}] # For the XP24000/XP20
Parameter name Status Description Display name for the parity group where the LU is added When this parameter is specified, do not specify chassis or groupnum. arraygroupname Optional Always specify either the chassis and groupnum parameters together, or the arraygroupname parameter by itself. Do not specify arraygroupname together with chassis and groupnum. Doing so will result in an error.
Parameter name Status Description Capacity of the LUs to be created This parameter must be specified if the creationoption parameter is not specified, or if bulk or dividebycap is specified for the creationoption parameter. This parameter cannot be specified if dividebynum is specified for the creationoption parameter. capacity Optional Desired capacity (in KB) for the new LU. The specified value is adjusted, depending on the minimum unit that is set to the volume size of each storage system.
Parameter name Status Description LU device number If omitted, the number is automatically generated. devnum Optional This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200 and XP1024/XP128, use the xx:yy format, where xx is the CU number, and yy is the LDEV number. For P9500 and XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional.
arraygroupname Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command. In the execution result of this command, displayName appears under An instance of ArrayGroup. Use this value to specify the arraygroupname parameter. fsindex Obtain this value from the execution result of the GetStorageArray (subtarget=FreeSpace) command. In the execution result of this command, fsControlIndex appears under An instance of FreeSpace.
differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI. AddLUSE AddLUSE adds a LUSE volume to a storage system. Make sure that you back up the data before creating a LUSE volume, because the data stored in the LDEV/LU to be connected might be lost during creation of the LUSE volume. When you create a LUSE volume, specify a formatted LDEV.
Parameter name Status Description An option for adding a LUSE volume to a volume for which a path is set luseoption Optional The value you can specify is force only. For XP1024/XP128, the microcode version must be 21-05-00/00 or later when this option is specified. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
defaultPortController=-1 isComposite=1 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,20
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=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolu
• It is not a LUSE volume. • It is not a paired volume created with Business Copy Software, Continuous Access Software, or Continuous Access Journal Software. • It is not an Auto LUN Software reserved volume. • It is not a pool volume or a journal volume. • It has a status of Normal or Normal(Quick Format). • • • • • • • • • It is not a Thin Provisioning Software virtual volume. It is not a system drive. It has a guard mode of Read/Write. It has an emulation type of OPEN-V. It is not a command device.
• If more than one logical unit is specified, internal volumes and external volumes cannot be mixed together. • If more than one internal volume is specified, all of them must have the same drive type. For external volumes, HP does not recommend that you use logical units with different drive types for a pool for Thin Provisioning Software. • If more than one logical unit is specified, all of their drives must have the same rotational speed.
Parameter name Status Description Pool ID Specify the pool ID of the THP pool to be created. poolid Optional You can specify an integer from 0 to 127. If this parameter is omitted, it is set automatically. Do not specify a pool ID that is already being used by Thin Provisioning Software. Threshold1 of the THP pool (%) The threshold1 of the THP pool is the usage rate of the THP pool. For P9500 whose microcode version is earlier than 70-014X-XX/XX: Specify a multiple of 5 in the range from 5 to 95.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#2 Specify a threshold value used to issue an advance warning. For P9500: overprovisioningwarning#1 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Optional If this parameter is omitted, -1 is set. -1 indicates that a threshold value is not set.
Parameter name Status Description 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. Specify whether to create the pool for Smart Tiers. One of the following values can be specified.
Parameter name Status Description End time of performance monitoring monitorendtime#3 Optional (P9500) If you specify this parameter, you must also specify migrationinterval=24. Specify a time in the range from 00:00 to 23:59 in HH:MM format. If this parameter is omitted, 23:59 is set. Performance monitoring mode. If you specify this parameter, you must also specify tiercontrol=enable. Specifiable values vary, depending on the microcode version.
unit that satisfies the conditions to be used as a pool volume in a THP pool to specify the devnums parameter. Command execution example In this example, the AddPool command creates a pool for Smart Tiers whose pool ID is 5 (poolid: 5) in the storage system (serialnum: 53039, model: P9500). In addition, this command also sets the usage rate threshold for the pool for Smart Tiers to 75% (threshold: 75). hdvmcli AddPool -o "D:\logs\AddPool.
relocationState=-1 relocationProgress=-1 numberOfTiers=1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simp
the configuration information). When you modify the registered information, you can modify the values other than the storage system type (whose parameter is family). When you execute the AddStorageArray command for SMI-S Enabled storage systems, note the following: • If one SMI-S provider manages multiple SMI-S Enabled storage systems, all of the SMI-S Enabled storage systems supported by Device Manager will be registered into the Device Manager server database at the same time.
Format for SMI-S Enabled storage systems When registering an SMI-S Enabled storage system: hdvmcli [URL] AddStorageArray [options] ipaddress={IP-address-of-SMI-S-provider|host-name-of-SMI-S-provider} family=SMI-S_Enabled displayfamily=SMI-S_Enabled userid=user-ID arraypasswd=user-password [protocol={Non-secure|Secure}] [portnumber=port-number-of-SMI-S-provider-service] When refreshing an SMI-S Enabled storage system: hdvmcli [URL] AddStorageArray [options] ipaddress={IP-address-of-SMI-S-provider|host-name-
Parameter name Status Description User ID For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: Specify the user ID used to access the storage system. userid# Required or optional You cannot omit this parameter when using the command to perform initial registration of information. However, you can omit this parameter when updating information, if you do not change the user ID. For an SMI-S Enabled storage system: Specify the user ID used to access the SMI-S provider.
# If P9000 Command View AE Suite products are used to manage copy groups defined in a device group, due to a RAID Manager limitation, be sure to specify character strings of 63 characters or less for userid and arraypasswd. Parameter values to obtain in advance family and displayfamily Obtain the values of these parameters from the execution results of the GetServerInfo command.
capacityInKB=4,025,592,720 freeCapacityInKB=2,442,665,520 allocatedCapacityInKB=1,578,120,480 autoLunCapacityInKB=4,806,720 onDemandCapacityInKB=0 totalFreeSpaceInKB=20,192,256 largestFreeSpaceInKB=3,796,992 multipathSupport=1 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayArrayType=XP1024 numberOfLUs=1,555 numberOfAllocatedLUs=565 numberOfUnallocatedLUs=990 slprStatus=-1 openTotalCapacity=4,025,592,720 openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoLu
AddTieredPoolOperation AddTieredPoolOperation manually monitors the performance of and relocates hardware tiers for a pool for Smart Tiers. To check the execution status of the AddTieredPoolOperation command, use the GetTieredPoolStatus command. NOTE: • This command can be used only with P9500. • This command can be used only when the automatic execution of performance monitoring and hardware tier relocation for the target pool for Smart Tiers is set to disable.
Parameter name Status Description Specify one of the following values: • startMonitor: Starts performance monitoring. • stopMonitor: Stops performance monitoring. operation Required • startRelocation: Starts hardware tier relocation. • stopRelocation: Stops hardware tier relocation. Specify stopRelocation when suspending hardware tier relocation performed by using the AddTieredPoolOperation command. List of pool IDs poolids Required Specify the pool ID of a pool for Smart Tiers.
An instance of Pool objectID=***** poolFunction=5 poolID=1 controllerID=-1 poolType=32 status=20 threshold=70 threshold2=80 threshold2Mode=0 capacityInKB=319,678,464 freeCapacityInKB=319,678,464 usageRate=0 numberOfPoolVols=31 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=131 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monito
For XP24000/XP20000, if no SSID is assigned to devNum of the created THP volumes, one is assigned automatically. For details about the SSID, see the storage system documentation. If you use this command with P9500, the virtual parity group and the virtual volumes must satisfy the following conditions: • When a THP pool is specified, its status must not be Blocked. • When a THP pool is specified, the over-provisioning percent must be less than the over provisioning limit threshold.
• The number of THP volumes that you can assign to a single THP pool • The number of virtual parity groups that you can create under a single disk controller Format for P9500 hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-virtual-volumes [numoflus=number-of-THP-volumes] [devnum=device-number-of-logical-unit] poolid=pool-ID-of-THP-pool Format for XP24000/XP20000 When the command is used to create a virtual parity group, and to populate the group with volum
Parameters Table 30 AddVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Specifies whether to create volumes for Thin Provisioning Software within an existing virtual parity group. Optional groupoption (XP24000/XP20000) Specify exist to create the volumes for Thin Provisioning Software in an existing virtual parity group.
Parameter name Status Description CLPR number clprNumber Optional If this parameter is omitted, 0 is set. (XP24000/XP20000) If you have specified the poolid parameter, the CLPR number of the pool for Thin Provisioning Software specific to that pool ID is set. Pool ID of a THP pool poolid Optional Specify the pool ID of the THP pool to which to assign the THP volumes to be created.
model=XP24000 serialnum=15065 arraygroupname=X200-1 capacity=209715200 numoflus=2 devnum=00:30:00 poolid=0 threshold=10 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
protectionLevel=-1 thpPoolID=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeTy
clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 An instance of LogicalUnit objectID=***** devNum=12,289 displayName=00:30:01 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecu
raidType=substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 List of 1 FreeS
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli DeleteArrayReservation -o "D:\logs\DeleteArrayReservation.
Obtain these values from the execution result of the GetStorageArray command. For the storage system where you want to delete an external parity group, specify either an arrayType value or a displayArrayType value for the model parameter. Use the serialNumber value to specify the serialnum parameter. arraygroupnames Obtain this value from the execution result of the GetStorageArray (subtarget=ArrayGroup) command. In the execution result of this command, displayName appears under An instance of ArrayGroup.
Parameter name Status Description The domain ID of the host storage domain to delete This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional Do not specify 0. A host storage domain whose domain ID is 0 cannot be deleted. You must specify either domain or domainnickname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
"serialnum=10001" "model=XP1024" "port=16" "domain=1" "deletionoption=lusekeep" Command execution result RESPONSE: (Command completed; no data returned) DeleteLabel DeleteLabel deletes a label from a logical unit.
Command execution example hdvmcli DeleteLabel -o "D:\logs\DeleteLabel.log" "serialnum=10037" "model=XP24000" "devnums=00:00:00,00:00:01" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLogicalUnit DeleteLogicalUnit deletes the LU and corresponding LDEV from the storage device. With P9500, XP24000/XP20000, and XP12000/XP10000/SVS200, you can delete multiple logical units at once.
Parameter name Status Description Device number of the LU devnums Optional This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, use the xx:yy format, where xx is the CU number and yy is the LDEV number. For P9500 and XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If you omit ww, the LDKC number is regarded as 0.
Parameters Table 36 DeleteLUSE command parameters Parameter name Status Description serialnum Required Serial number of the storage system from which the LUSE is to be deleted model Required Model of the storage system from which the LUSE is to be deleted Device number used to identify the LUSE to be deleted 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.
DeletePool DeletePool deletes a THP pool, and releases the assignations to the pool volumes that made up the DP pool. 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 198.
Command execution result RESPONSE: (Command completed; empty list returned) DeleteStorageArray DeleteStorageArray removes a storage system (including an SMI-S Enabled storage system) so that it is no longer managed by the Device Manager server. This command only removes the storage system from Device Manager management control. The command does not change the configuration of the storage system.
Parameter name Status saobjid Optional# Description Object ID of the SMI-S Enabled storage system to delete Specify the object ID obtained from another CLI response. The value is encoded by the CLI. # Always specify either the serialnum and model parameters together, or the saobjid parameter by itself. Do not specify saobjid together with serialnum and model. Doing so will result in an error.
NOTE: • For P9500 and XP24000/XP20000, if you delete the specified virtual parity group, the virtual parity group and the THP volumes contained in that virtual parity group are also deleted. • For P9500, if you delete specified THP volumes, the virtual parity group that contains the THP volumes is also deleted. • For XP24000/XP20000, if you delete specified volumes for Thin Provisioning Software, you cannot delete the virtual parity group that contains the volumes for Thin Provisioning Software.
Parameter name Status Description Device number(s) of the THP volume(s). devnums Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values. Always specify either the arraygroupnames parameter or the devnums parameter. Do not specify both parameters at the same time.
To check whether the LDEV was formatted properly if you omitted the wait parameter, or if you specified false in the wait parameter, first use the AddStorageArray command to refresh the storage system, and then execute the GetStorageArray (subtarget=LDEV) command and check the value of status in the execution results. If you specified true in the wait parameter, simply check the value of status in the execution results of the FormatLU command. CAUTION: This command erases data on the LU.
Parameter name Status Description Specifies whether to wait until formatting is complete before ending the command. You can specify the following values: Optional wait • true: Wait until formatting is complete before ending the command. • false: Do not wait until formatting is complete before ending the command. If this parameter is omitted, false is set. If you specify true for this parameter, you cannot specify true for the quickformat parameter at the same time.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
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=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 An instance of LogicalUnit objectID=***** devNum=1,176 displayName=00:04:98 emulation=OPEN-V devCoun
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 guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=100,000 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVol
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. If you execute this command, the information of the THP pool volumes that belong to the THP pool is displayed.
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.
relocationState=-1 relocationProgress=-1 numberOfTiers=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Si
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.
monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 List of 30 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D
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 131 HostStorageDomain Information about host storage domains “GetStorageArray (subtarget=HostStorageDomain) ” on page 135 LDEV Information about LDEVs “GetStorageArray (subtarget=LDEV) ” on page 138 LogicalDKC Information about the logical DKC “GetStorageArray (subtarget=LogicalDKC) ” on page 141 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 (including SMI-S Enabled storage systems) that are registered on the Device Manager server.
Obtain this value from the execution result of the GetStorageArray command. Set the value of objectID, obtained from the execution result, into the saobjid parameter. Command execution example In this example, the GetStorageArray command obtains information about the configuration of all the storage systems. hdvmcli GetStorageArray Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600@10.208.115.220 description=R600 (10007) at 10.208.115.
openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=418,309,920 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=1,739 numberOfOpenUnallocatedLUs=1,671 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 c
Parameter name Status Description Object ID of the parity group in a storage system Specify this parameter when you want to obtain the information about a specific parity group. If you specify this parameter, you must also specify the model and serialnum parameters. objectid Optional If you specify the model and serialnum parameters without specifying this parameter, the information about parity groups in the specified storage system is acquired.
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.
allocatedCapacity=266,772,960 freeCapacity=149,008,320 autoLunCapacity=2,403,360 onDemandCapacity=0 totalFreeSpace=1,847,952 largestFreeSpace=1,847,952 substance=0 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 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocat
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Format When obtaining information about all storage systems: hdvmcli [URL] GetStorageArray [options] subtarget=CommParameters When obtaining information about a storage system (other than an SMI-S Enabled storage system): hdvmcli [URL] GetStorageArray [options] subtarget=CommParameters serialnum=serial-number model=model When obtaining information about an SMI-S Enabled storage system: hdvmcli [URL] GetStorageArray [options] subtarget=CommParameters saobjid=object-ID-of-SMI-S-Enabled-storage-system Param
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) .
Command execution example In this example, the GetStorageArray (subtarget=Component) command obtains information about the configuration of a storage system (serial number: 10007, model: XP24000). 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.
imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=418,309,920 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=1,739 numberOfOpenUnallocatedLUs=1,671 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 o
value=1 description=Normal An instance of Component name=DKU Drive 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.
raidType=RAID5(3D+1P) emulation=OPEN-3 diskType=DKR2E-J146FC diskSize=146 diskSizeInKB=153,092,096 formFactor=-1 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 imAllo
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_FreeSpace.log" subtarget=FreeSpace model=XP1024 serialnum=10001 arraygroupobjid=***** *****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 List of 1 FreeSpace elements: An instance of FreeSpace 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.
Parameter name Status Description Nickname of the host storage domain If you omit this parameter, all the host storage domains become the target. If you specify this parameter, you must also specify the model and serialnum parameters. domainnickname Optional If you specify this parameter, you must specify the port or portname parameter. If neither is specified, this parameter will be ignored. Do not specify domain and domainnickname at the same time.
Parameter name Status Description Number of host storage domains for which information is to be obtained numOfElementsFilter Optional Specify this parameter when you want to obtain information for a part of host storage domains for a specific storage system. Specify the number of host storage domains for which information is to be obtained. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 HostStorageDomain elements: An instance of HostStorageDomain objectID=***** portID=23 portName=CL2-H domainID=1 hostMode=Standard displayName=CL1-A-0 domainType=0 nickname=1A-G00 List of 1 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane List of 7 FreeLUN elements: An instance of FreeLUN lun=9 An instance of FreeLUN lun=10 . .
Parameter name Status serialnum Optional model Optional Description Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target. 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.
Parameter name Status Description Number of logical devices for which information is to be obtained numOfElementsFilter Optional Specify this parameter when you want to obtain information for a part of logical devices in a specific storage system. Specify the number of logical devices for which information is to be obtained. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
emulation=OPEN-3 cylinders=0 isComposite=0 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=1 volumeType=3 slotSizeInKB=48 chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=true onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicato
Parameters Table 54 GetStorageArray (subtarget=LogicalDKC) command parameters Parameter name Status Description subtarget Required Specify LogicalDKC. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
autoLunCapacityInGB=30 onDemandCapacityInGB=0 totalFreeSpaceInGB=3,089 largestFreeSpaceInGB=492 capacityInKB=9,282,994,926 freeCapacityInKB=8,399,083,870 allocatedCapacityInKB=851,452,736 autoLunCapacityInKB=32,458,320 onDemandCapacityInKB=0 totalFreeSpaceInKB=3,239,433,148 largestFreeSpaceInKB=516,113,664 multipathSupport=1 securityStatus=2 sequenceNumber=10037 displayArrayFamily=XP24K displayArrayType=XP24000 numberOfLUs=4,443 numberOfAllocatedLUs=630 numberOfUnallocatedLUs=3,813 slprStatus=0 openTotalCap
*****: The value is encoded by the CLI. GetStorageArray (subtarget=LogicalUnit) GetStorageArray (subtarget=LogicalUnit) obtains the information about one or all logical units (LUs) in one or all storage systems. Parameters Table 55 GetStorageArray (subtarget=LogicalUnit) command parameters Parameter name Status Description subtarget Required Specify LogicalUnit. Serial number of the storage system serialnum Optional If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Object ID of the logical unit objectid Optional Specify this parameter when you want to obtain information about a specific logical unit. 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 objectid parameter, information about logical units in the specified storage system is obtained. Specify the object ID obtained from another CLI response.
Parameter name Status Description Device number of the logical unit displayname Optional Specify this parameter to acquire information about a particular logical unit. This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200 and XP1024/XP128, use the xx:yy format, where xx is the CU number and yy is the LDEV number.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
. (repeated for other Path instances) .
. . (repeated for other VolumeConnection instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=MFReplicationInfo) GetStorageArray (subtarget=MFReplicationInfo) obtains information about copy pairs consisting of mainframe volumes. NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes.
Parameter name Status Description Starting sequence number of the copy pair information of mainframe volumes for which information is to be obtained Specify this parameter to obtain information about copy pairs of some mainframe volumes from a specific storage system. startElementNumFilter Optional When mainframe-volume copy pair information is in the order shown below and starts from 0, specify the first number in the sequence of the mainframe-volume copy pair information that you want to obtain.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 An instance of LDEV objectID=***** devNum=3,333 displayName=00:0D:05 emulation=3390-3 cylinders=3,339 isComposite=0 sizeInKB=2,904,930 lba=5,809,860 raidType=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 volumeK
Parameters Table 57 GetStorageArray (subtarget=Path) command parameters Parameter name Status Description subtarget Required Specify Path. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Port name of the storage system portname Optional Specify this parameter to acquire information about a particular path. When you specify this parameter, you must also specify the model and serialnum parameters, either the domainnickname or domain parameter, and the devnum parameter. Do not specify this parameter together with the port parameter. If they are specified at the same time, an error will occur.
Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. objectid Obtain this value from the execution result of the GetStorageArray (subtarget=Path) command.
List of 256 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.00.02 nickname=Jone . . (repeated for other WWN instances) . *****: The values are encoded by the CLI. Command execution example 2 (when the objectid parameter is specified) In this example, the GetStorageArray (subtarget=Path) command obtains information about a path (object ID: *****) that is set for a storage system (serial number: 10001, model: XP1024).
GetStorageArray (subtarget=PDEV) GetStorageArray (subtarget=PDEV) obtains the information about PDEVs. Parameters Table 58 GetStorageArray (subtarget=PDEV) command parameters Parameter name Status Description subtarget Required Specify PDEV. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
and PDEV for the subtarget parameter. In the execution result of this command, use the pdevid value that appears under An instance of PDEV to specify the pdevid parameter. If a comma is included in the pdevid value, specify the value, excluding the comma. Command execution example In this example, the GetStorageArray (subtarget=PDEV) command obtains information about a PDEV (PDEV number: 1) belonging to a parity group (object ID: ARRAYGROUP.XP1024.10001.0.
GetStorageArray (subtarget=Pool) GetStorageArray (subtarget=Pool) obtains information about pools for Snapshot, Continuous Access Journal Software, or Thin Provisioning. NOTE: • When SLPR functionality is used in XP24000/XP20000 or XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain information about the pool even if he or she registers the storage system (SLPR) as a target to be managed by Device Manager.
Parameter name Status Description Type of function used to operate the pools You can specify the following values: For P9500: • 3: Snapshot • 4: Continuous Access Journal Software • 5: Thin Provisioning For XP24000/XP20000: • 3: Snapshot poolfunction Optional • 4: Continuous Access Journal Software • 5: Thin Provisioning Software For XP12000/XP10000/SVS200: • 3: Snapshot • 4: Continuous Access Journal Software If the model or serialnum parameter is omitted, the specification for this parameter becomes
Parameter name Status Description Filter for selecting the type of function used to operate the pools. You can specify the following values: • 3: Snapshot or Continuous Access Asynchronous Software poolfilter Optional • 4: Continuous Access Journal Software • 5: Thin Provisioning Use a comma to delimit multiple values. You cannot specify the poolfilter parameter if the model, serialnum, poolfunction, poolid, and poolsubinfo parameters are all specified.
. (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 monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=
remotePathGroupID=0 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,025 displayName=0B:D1 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 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 sysVolFla
Parameters Table 60 GetStorageArray (subtarget=Port) command parameters Parameter name Status Description subtarget Required Specify Port. 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.
portID value appears under An instance of Port. Use this portID value to specify the port parameter. 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.
portName=CL3-E domainID=1 hostMode=Standard hostModeOption= displayName=CL3-E-1 domainType=0 nickname=HP0900 List of 1 WWN elements: An instance of WWN WWN=21.00.00.E0.8B.0C.39.2F nickname= *****: The values are encoded by the CLI. GetStorageArray (subtarget=PortController) GetStorageArray (subtarget=PortController) obtains the information about port controllers.
Parameter name Status Description Specific information about the port controller you intend to obtain controllersubinfo Optional Available values are IPAddress and PairedPortController. You can specify either one or both of these values. The information about IPAddress and PairedPortController is valid for the NAS configuration. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
type=12 . . (repeated for other PortController instances) . *****: The value is encoded by the CLI. Command execution example 2 In this example, the GetStorageArray (subtarget=PortController) command obtains information about a port controller (controller ID: 1) used for a storage system (serial number: 10001, model: XP1024). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_PortController.
Parameters Table 62 GetStorageArray (subtarget=ReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify ReplicationInfo. 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.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. objectid Obtain this value from the execution result of the GetStorageArray (subtarget=ReplicationInfo) command. Execute this command by specifying only the model and serialnum parameters, and ReplicationInfo for the subtarget parameter.
capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=P-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=
thpPoolVolControlFlag=-1 . . (repeated for other ReplicationInfo instances) . *****: The values are encoded by the CLI. GetTieredPoolStatus GetTieredPoolStatus obtains the execution status of performance monitoring and hardware tier relocation for a pool for Smart Tiers executed by using the AddTieredPoolOperation command. NOTE: This command can be used only with P9500.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
will be displayed if a zero-page reclaim operation has not been executed by the RunZeroPageReclaim command. NOTE: This command can be used only with P9500 and XP24000/XP20000. The required microcode version is 60-07-00-XX/XX or later.
objectID=***** devNum=1,708 displayName=00:06:AC emulation=OPEN-V devCount=1 devType= capacityInKB=1,049,280 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPo
Parameters Table 65 ModifyArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
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 and XP1024/XP128, use the xx:yy format, where xx is the CU number, and yy is the LDEV number. For P9500 and XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional.
targetID=***** label=myLabel *****: The values are encoded by the CLI. ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device.
Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. devnum Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit) command.
journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI. ModifyPool ModifyPool expands a THP pool or changes the settings related to the THP pool. NOTE: • This command can be used only with P9500 and XP24000/XP20000.
When changing only the settings related to the THP pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID [threshold=THP-pool-threshold-1] [threshold2=DP-pool-threshold-2] [threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] [tiercontrol={enable|disable}] [automigration={enable|disable}] [migrationinterval={ [monitoringmode={0|1}]1|2|4|8|24}] [monitorstarttime=start-time-of-performa
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.
adddevnums Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit, lusubinfo=LDEV) command. Execute this command by specifying only the model and serialnum parameters, LogicalUnit for the subtarget parameter, and LDEV for the lusubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit.
diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 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 commandDeviceSe
commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 *****: The values are encoded by the
[wwn=WWN newwwnnickname=new-WWN-nickname] [wwnnickname=WWN-nickname newwwnnickname=new-WWN-nickname] NOTE: 8 Gbps can be specified only for P9500 or XP24000/XP20000.
Parameter name Status Description Port name Optional portname Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. New topology value for the port Possible values are as follows.
Parameter name Status Description Specify the nickname of the host storage domain. The value specified for this parameter differs depending on whether domain is specified. If domain is specified: Specify the new nickname of the host storage domain. If domain is not specified: Specify the nickname of the host storage domain. You can use the following characters: A-Z a-z 0-9 ! # $ % & ' ( ) + - . = @ [ ] ^ _ ` { } ~ and spaces nickname Optional A nickname cannot begin or end with spaces.
Parameter name Status Description The WWN that is used to provide security for the host storage domain To specify two or more WWNs, separate them with commas. 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.
Command execution example In this example, the ModifyPort command modifies the settings for a port (port number: 16) of a storage system (serial number: 10001, model: XP1024) as follows. The command: • changes the value for the hostmode parameter to Standard, for the port's host storage domain (domain ID: 0) • changes the topology to Fabric(off), FC-AL • sets the Fibre Channel address to 73 • disables LUN security by specifying false • sets the transmission speed of the Fibre Channel to 1.
WWN=11.33.22.33.44.33.22.22 nickname=Jone An instance of WWN WWN=55.66.77.88.44.33.22.22 nickname= *****: The values are encoded by the CLI. ModifyPortController ModifyPortController supports changing characteristics of a PortController. NOTE: This command can be used only with XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128.
parameters, and PortController for the subtarget parameter. In the execution result of this command, the controllerID value appears under An instance of PortController. Use this controllerID value to specify the ctrlid parameter. controllername Obtain this value from the execution results of the GetStorageArray (subtarget=PortController) command. In the execution results, displayName is displayed below An instance of PortController. Specify this value as controllername.
• If you are assigning a volume for Thin Provisioning Software to a pool for Thin Provisioning Software, the volume for Thin Provisioning Software must not already be assigned to a pool for Thin Provisioning Software. • If you are assigning a volume for Thin Provisioning Software to a pool for Thin Provisioning Software, the status of the pool for Thin Provisioning Software must not be Blocked.
hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=false devnums=device-number-of-volume-for-Thin-Provisioning-Software When the command is used to change the usage rate threshold of volumes for Thin Provisioning Software: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-volume-for-Thin-Provisioning-Software threshold=usage-rate-threshold-of-volumes-for-Thin-Provisioning-Software Parameters Table 71 ModifyVirtualVo
Parameter name Status Required capacity (P9500) Description Capacity of the THP volume after expansion (KB) Specify the capacity of the expanded volume. The maximum value that can be specified is 64424505600.
Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 Lu elements: An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) .
RefreshPerformanceData RefreshPerformanceData obtains storage system performance information collected by HP StorageWorks P9000 Performance Advisor Software, and refreshes the Device Manager server database with the most recent information. NOTE: This command can be used only when HP StorageWorks P9000 Performance Advisor Software is connected to.
Command execution example In this example, the RefreshPerformanceData command refreshes performance information for a specific storage system. hdvmcli RefreshPerformanceData -o "D:\logs\RefreshPerformanceData.
Parameter name Status Description Interval time in minutes from storage system re-discovery completion to start of next storage system re-discovery interval Optional Only specify this parameter when refreshmode=1 (when storage systems are refreshed sequentially). An error will occur if this parameter is specified when refreshmode=2. You can specify a value from 0 to 2147483647. The default is 0.
userID=root ] [An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters ipAddress=172.16.40.1 ] . . (repeated for other StorageArray instances) . RunZeroPageReclaim RunZeroPageReclaim performs a zero-page reclaim operation, which returns unused capacity in THP volumes (virtual volumes).
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LDEV) command. Execute this command by specifying only the model and serialnum parameters, and LDEV for the subtarget parameter.
thpPoolID=0 threshold=5 tcaPoolID=-1 thpPoolVolControlFlag=-1 *****: The value is encoded by the CLI. ShrinkPool The ShrinkPool command shrinks the THP pool. If the unused capacity of the THP pool is larger than the used capacity, you can use this command to exclude the THP pool volumes that compose the THP pool to decrease the THP pool capacity. To shrink the THP pool, you can only exclude the THP pool volumes that are in the status that enables a pool to be shrunk.
poolid Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. When you execute this command, specify values that have been obtained in advance for the serialnum and model parameters, and then specify 5 (Thin Provisioning) for the poolfilter parameter. In the execution result of this command, one or more of the poolID values appears under An instance of Pool. Select the THP pool to shrink, and then specify the corresponding poolID value for the poolid parameter.
clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=131 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 monitorEndTime=23:59 monitoringMode=0 externalMixCompatible=disable monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** d
displayName=00:06:0B emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 c
Parameters Table 76 GetLogicalGroup command parameters Parameter name Status Description Object ID of the desired logical group objectid Optional Omit this parameter to include all logical groups. Specify the object ID obtained from another CLI response. The value is encoded by the CLI. Do not specify the objectid and logicalpath parameters at the same time. If they are specified at the same time, an error will occur.
capacityInKB=0 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 List of 1 GroupElement elements: An instance of Path objectID=***** devNum=101 displayDevNum=00:65 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=8 wwnSecurityValidity=true . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. Command execution example 2 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=path" *****: The value is encoded by the CLI.
Command execution example 3 hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" Command execution result 3 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 . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI.
NOTE: When setting up a LUN (path) to an LU to which a LUSE is already set, like the following command, you must specify devnum of the representative LDEV which constitutes the LUSE, and run AddLun.
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.
and LDEV for the subtarget parameter. 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 devnum parameter. 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.
onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 An instance of LDEV objectID=***** devNum=1,002 displayName=03:EA emulation=OPEN-3 cylinders=0 isComposite=1 siz
encrypted=-1 tieringPolicy=-1 *****: The values are encoded by the CLI. 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) .
{domain=domain-ID|domainnickname=domain-nickname} wwn=WWN [wwnnickname=WWN nickname] Parameters Table 78 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 port Optional Specify either port or portname. Do not specify both parameters at the same time.
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 ! # $ % & ' ( ) + - .
of this command, the nickname value appears under An instance of HostStorageDomain. Use this value to specify the domainnickname parameter. 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 number of the path Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name of the path portname Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port and wwn Obtain these values from the execution result of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command.
Parameter name Status Description Port name of the host storage domain 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 This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. domain Optional The execution results are output in decimal. You must specify either domain or domainnickname.
Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter.
Parameters Table 82 AddHost command parameters Parameter name Status Description Name of the new host hostname Required 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. When used with the GUI, follow the GUI specification rules.
NOTE: This command does not support virtualization servers.
Parameter name Status Description portwwn Optional Port WWN on the host bus adapter filetype Optional Type of the file system filename Optional Name of the file system size Optional LUN size in MB percentused Optional Percent of the LUN in use Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
osscsibus=0 osscsiid=15 oslun=1 portwwn=11.22.33.44.55.66.77.88 filetype=NTFS filename=C: size=10 percentused=10 Command execution result RESPONSE: An instance of HostInfo objectID=***** name=MY_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.159 mountPoint=C: portID=7 portName=CL1-H domainID=0 scsiID=15 lun=2 devNum=2 displayDevNum=00:02 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.
hdvmcli [URL] AddHostRefresh [options] {objectid=object-ID-of-target-host|hostname=name-of-target-host} Parameters Table 84 AddHostRefresh command parameters Parameter name Status Description Object ID of the target host objectid Optional You must specify either objectid or hostname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Name of the target host hostname Optional You must specify either objectid or hostname.
hostType=-1 statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database. If the target virtualization server is already registered, this command updates the Device Manager server database with the most recent information.
Parameters Table 85 AddVirtualizationServer command parameters Parameter name Status Description IP address ipaddress Required Specify the IP address of the virtualization server or the virtualization-server management program. To specify the IP address of the virtualization server, use an IPv4 address. To specify the IP address of the virtualization-server management program, use either an IPv4 or IPv6 address. Value indicating the host type hosttype Required Specify 3.
name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.114 portNumber=5989 protocol=Secure userID=vi-admin *****: The value is encoded by the CLI. Command execution example 2 In this example, the command accesses the virtualization-server management program (IP address: 10.208.119.
List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.114 portNumber=5989 protocol=Secure userID=vi-admin *****: The values are encoded by the CLI. DeleteHost DeleteHost deletes information about a host server from the Device Manager server. NOTE: DeleteHost does not delete the host information from the external port.
Command execution result RESPONSE (Command completed; no data returned) DeleteHostInfo DeleteHostInfo deletes a HostInfo instance from the Device Manager server. NOTE: This command does not support virtualization servers. Parameters Table 87 DeleteHostInfo command parameter Parameter name Status objectid Required Description Object ID of the HostInfo record to remove Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
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.
Parameter name Status Description Object ID of the HORCM configuration definition file in the host configfileid Optional If you omit this parameter, the command acquires information about HORCM configuration definition files contained in the host. If you specify this parameter, you must also specify the objectid parameter. Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
Obtain these values from the execution result of the GetHost command without specifying any parameters.
svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
Command execution result 2 RESPONSE: An instance of Host objectID=***** name=testmf hostID=1 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 An instance of Host objectID=***** name=testmf2 hostID=2 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 *****: The values are encoded by the CLI. Command execution example 3 In this example, the command obtains information about the logical unit that is assigned to the host (hostname = test).
commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=0 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=2,000,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 List of 3 Path ele
lun=20 devNum=1,008 displayDevNum=00:03:F0 osScsiBus=1 osScsiID=4 osLun=20 portWWN=10.00.00.00.C9.6F.EB.D6 fileSystemType=Datastore fileSystemName= datastoreName=R600#2_1 sizeInMB=1,953 percentUsed=-1 lastUpdated=1254708417 An instance of LogicalUnit . . (Attributes of LogicalUnit are omitted here) . *****: The values are encoded by the CLI. Command execution example 4 In this example, the command obtains the information for accessing the virtualization server (hostname = boss.
Command execution example 5 In this example, the command obtains information regarding the disk configuration of the virtualization server (hostname = boss.boss). hdvmcli GetHost -o "D:\logs\GetHost_VM_Datastore.log" "hostname=boss.boss" subtarget=VM,Datastore Command execution result 5 RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=1 capacityInKB=4,097,280 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX Server 3.5.
GetHostInfo GetHostInfo returns the host-based information about a LUN. NOTE: If two or more paths are set from a virtualization server for a single volume, the values for the portID attribute, domainID attribute, and scsiID attribute for the HostInfo instance for the target volume might not be correct. Use the management client for the virtualization server to check this information.
devNum=3 displayDevNum=00:03 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 *****: The value is encoded by the CLI. Command execution example 2 hdvmcli GetHostInfo -o "D:\logs\GetHostInfo.log" Command execution result 2 RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.
that was assigned to the host storage domain. In an environment that satisfies the following conditions, the HostScan command can be used to easily register hosts into the Device Manager server: (1) all WWNs in one host storage domain must be assigned to one host only, and (2) that host name is set as the nickname of the host storage domain. The following lists the conditions for using the HostScan command: • LUN Manager is installed on the storage system.
Parameters Table 90 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 91 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.
ModifyHost ModifyHost modifies information about a host server. 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 wwnlist Optional ipaddress Optional Description Comma-separated list of WWNs to replace existing WWNs If you omit this parameter, all WWNs in the host will be deleted. New IPv4 IP address of an existing host Omit this parameter if you are not changing the IPv4 IP address of the host. New IPv6 IP address of an existing host ipv6address Optional Omit this parameter if you are not changing the IPv6 IP address of the host.
ModifyHostInfo ModifyHostInfo modifies a HostInfo record in the Device Manager server. NOTE: This command does not support virtualization servers. Parameters Table 93 ModifyHostInfo command parameters Parameter name Status objectid Required serialnum Optional model Optional Description Object ID of the HostInfo record to modify Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
Parameter name Status Description New domain ID of the path Omit this when no change is required. domain Optional This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. New device number of the path Omit this when no change is required. devnum Optional This parameter can be specified in decimal, and in colon-separated hexadecimal.
domainID, and portID values to specify the devnum, domain, and port parameters respectively. portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter. Command execution example In this example, the ModifyHostInfo command makes the following modifications to the host-based information (object ID: HOSTINFO.
fileSystemName=E: sizeInMB=156 percentUsed=50 lastUpdated=1039003476 *****: The value is encoded by the CLI. ModifyVirtualizationServer ModifyVirtualizationServer modifies information about virtualization servers.
You need to specify at least one of the following parameters: ipaddress, hostprotocol, hostuserid, or hostuserpassword. Parameter values to obtain in advance hostname Obtain this value from the execution result of the GetHost command. Execute this command by specifying VMWARE_ESX for the hostfilter parameter. In the execution result of this command, the name value appears under An instance of Host.
Parameters Table 95 RefreshVirtualizationServer command parameter Parameter name Status Description Host name hostname Required Specify the host name of the virtualization server whose information you want to refresh. Parameter values to obtain in advance hostname Obtain this value from the execution result of the GetHost command. Execute this command by specifying VMWARE_ESX for the hostfilter parameter. In the execution result of this command, the name value appears under An instance of Host.
AddURLLink AddURLLink allows a user to specify URL information (referred to as a URLLink) for a Device Manager object managed by the Device Manager server. AddURLLink is used for the following purposes: • To specify a URLLink for an SMI-S Enabled storage system The URL information of the software started from Element Manager of the GUI is modified. Note that a user can set only one URLLink for each SMI-S Enabled storage system.
Parameter name Status Description Type of the Device Manager object for which the URLLink is set One of the following values can be specified. The values are not case-sensitive. targetoption Optional • smi-s: SMI-S Enabled storage system • other: Device Manager object other than an SMI-S Enabled storage system If this parameter is omitted, other is set. Command execution example hdvmcli AddURLLink -o "D:\logs\AddURLLink.log" "url=http://10.208.184.
Specify either alertnum or source. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Parameter values to obtain in advance alertnum and source Obtain these values from the execution result of the GetAlerts command. In the execution result of this command, the number and source values appear under An instance of Alerts. Use these number and source values to specify the alertnum and source parameters respectively.
hdvmcli [URL] DeleteURLLink [options] {objectid=object-ID-of-the-URLLink |linkedid=object-ID-of-SMI-S-Enabled-storage-system} targetoption=smi-s When deleting a URLLink for a Device Manager object other than an SMI-S Enabled storage system: hdvmcli [URL] DeleteURLLink [options] {objectid=object-ID-of-the-URLLink |linkedid=object-ID-of-the-Device-Manager-object} [targetoption=other] Parameters Table 98 DeleteURLLink command parameters Parameter name Status Description The object ID of the URLLink to dele
*****: The value is encoded by the CLI. Command execution result RESPONSE (Command completed; empty list returned) GetAlerts GetAlerts returns the alert messages previously generated by the Device Manager server. The returned alerts can be limited by specifying a time and/or a number of messages. When no condition to limit the number of alert messages obtained is specified, information about all alerts is displayed in the execution results.
severity=3 component=DKU drive description=Serious error detected on DKU drive. actionToTake=Contact Customer Support. data=Component has stopped. timeOfAlert=2003/01/06 20:13:56 An instance of Alert number=1 type=Server source=***** severity=4 component=DKC processor description=Moderate error detected on DKC processor. actionToTake=Contact Customer Support. data=Component does not function fully. timeOfAlert=2003/01/06 20:13:51 *****: The values are encoded by the CLI.
arrayFamily=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 displayArrayFamily=XP1024/128 An instance of StorageArray arrayFamily=USP displayArrayFamily=XP12K/10K/SVS200 An instance of StorageArray arrayFamily=R600 displayArrayFamily=XP24K/20K An instance of StorageArray arrayFamily=SMI-S_Enabled displayArrayFamily=SMI-S_Enabled GetURLLink Get
Parameters Table 100 GetURLLink command parameters Parameter name Status Description The object ID of the URLLink for which you want to obtain information objectid Optional# Specify the object ID obtained from another CLI response. The value is encoded by the CLI. Do not specify this parameter with the linkedid parameter. If they are specified at the same time, an error will occur.
Command execution result RESPONSE: An instance of URLLink objectID=***** name=test url=http://10.208.184.97 linkedID=***** createdByUser=1 *****: The values are encoded by the CLI. Replication commands The Replication commands can be used to manage copy pairs.
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-ID replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] • Method 3: Creates a ne
Parameter name Status svolhostid Required Description Host ID for identifying the S-VOL When using Method 1, specify the host ID of the S-VOL of a group specified in the definition file. Instance number of the HORCM instance for managing the S-VOL svolinstancenum Optional When using Method 1, specify the instance number of the S-VOL of a group specified in the definition file. You must specify this parameter when you are using method 1 or 2.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the P-VOL is to be stored. pvolpoolid Optional You must specify this parameter when you are using method 2 or 3 with Continuous Access Journal Software, Snapshot Software, or Continuous Access Asynchronous Software. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description Type of operation that is to be executed with the copy pair You can specify the following values: • BusinessCopy: Business Copy Software replicationfunction Required • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot • ContinuousAccessJournal: Continuous Access Journal Software MU number of the P-VOL This parameter can be specified only for Continuous Access Journal Softwa
See No. 2, No. 5, No. 6, and No. 7 in the table below. Table 102 How to obtain parameter values (AddConfigFileForReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the P-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile, and the groupName value under An instance of ReplicationGroup.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile (configuration definition file information).
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=LogicalUnit) with LogicalUnit specified for the subtarget parameter and the object ID of the logical unit to be used as the P-VOL or the S-VOL (the object ID recorded in No. 5) specified for the objectID parameter. pvolarraytype 6 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"pvoldevnum=5" "svolarraytype=XP12000" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" Command execution result 1 RESPONSE (Command completed; empty list returned) Command execution example 2 This example creates a group in the configuration files, and then adds pairs to the group: hdvmcli AddConfigFileForReplication -o "D:\logs\AddConfigFileForReplication.
Journal Software. When you create a copy pair, the HORCM configuration file for RAID Manager, contained in the host, is rewritten. NOTE: • This command is not available for XP1024/XP128. • 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.
• Method 3: Create a new RAID Manager configuration definition file, creates a copy group, then adds a copy pair to the copy group.
Parameter name Status Description ID of the host that recognizes the secondary volume (S-VOL) svolhostid Optional If you are using method 2 or 3, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored. Number of the HORCM instance that manages the S-VOL svolinstancenum Optional If you are using method 2, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the P-VOL is to be stored pvolpoolid Optional You must specify this parameter when you are using method 2 or 3 with Continuous Access Journal Software, Snapshot Software, or Continuous Access Asynchronous Software. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description Type of operation that is to be executed with the copy pair You can specify the following values: • BusinessCopy: Business Copy Software replicationfunction Required • ContinuousAccessSync: Continuous Access Synchronous Software • ContinuousAccessAsync: Continuous Access Asynchronous Software • Snapshot: Snapshot • ContinuousAccessJournal: Continuous Access Journal Software MU number of the P-VOL munum Optional This parameter can be specified only for Continuous Acc
• When Method 2 is used: See No. 2, No. 3, No. 4, No. 5, and No. 6 in the table below. • When Method 3 is used: See No. 2, No. 4, No. 5, and No. 6 in the table below. Table 104 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.
"pvolarraytype=XP1024" "pvolserialnum=65010001" "pvoldevnum=5" "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.
the logical device with LDEV number 12 in the storage system with model number XP1024 and serial number 15001. The ID of the host that recognizes the secondary volume is 1, which is the same ID as that of the primary volume, and the instance number of the HORCM that manages the secondary volume is 12. 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.
fenceLevel=Never 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 Sequence number of the storage system that contains the S-VOL svolsequencenum Optional If you specify this parameter, specify either svolserialnum or svolsequencenum. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Device number of the S-VOL svoldevnum Optional This parameter can be specified in decimal, and in colon-separated hexadecimal.
replicationGroupID=7 groupName=HCMD_CG0007 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair. In P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, the pairs indicate paths between MCUs and RCUs.
• If you specify the mastermodel, remotefamily, or remotepathgroupid parameter, you also need to specify all other parameters (masterserialnum, mastercontrollerid, remoteserialnum, remotessid, mastermodel, remotefamily, and remotepathgroupid). If you do not specify them at the same time, an error will occur. • If you omit all the parameters, the command will obtain the information about all replication controller pairs.
Command execution example 2 This example obtains the controller pair information in all storage systems that have been registered in the Device Manager database. hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
Parameter name Status Description Specify one of the following values: • split: Split the copy pair. • resync: Re-synchronize the copy pair from the primary volume (P-VOL) to the secondary volume (S-VOL). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot copy pair, the copy pair is split after the re-synchronization. For this reason, the paired volume status is set to PAIR, and then changes toPSUS.
Parameter name Status Description Copy pace You can specify an integer from 1 to 15. copytracksize Optional When changing the copy pace for an identified copy pair, specify the parameters pvolserialnum, pvoldevnum, svolserialnum, and svoldevnum. When using one operation to change the copy paces of all copy pairs, omit these parameters. If split or resync is specified for the operation parameter, this parameter will be ignored.
objectID=***** replicationGroupID=12 groupName=HCMD_CG000d pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=3 svolInstanceNumber=12 svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
Command reference
5 Output items This chapter describes items that are output by Device Manager CLI commands. The items are output for each instance as attributes of Device Manager instances. The meaning of items that have the same name might differ for different instances. When you reference an output item, check the instance of the item. Alert instance The Alert instance is output when the GetAlerts command (see “GetAlerts” on page 264) is executed.
ArrayGroup instance The ArrayGroup instance is output when the following commands are executed: • • • • • • • • “AddExternalArrayGroup” on page 43 “AddPool” on page 66 “AddVirtualVolume” on page 82 “GetStorageArray (subtarget=ArrayGroup) ” on page 119 “GetStorageArray (subtarget=FreeSpace) ” on page 131 “GetStorageArray (subtarget=PDEV) ” on page 157 “GetStorageArray (subtarget=Pool) ” on page 159 “ModifyPool” on page 182 Table 109 ArrayGroup instance attributes Attribute Description objectID Object ID
Attribute Description diskSizeInKB Actual size (in KB) of physical drives that make up the parity group (example: 75,497,472) 0 is output for an external volume. formFactor Currently, this information does not apply to storage systems (-1 is output).
Attribute Description openOnDemandCapacity Total size of all open LDEVs expanded on demand in the parity group (in KB) imTotalCapacity Total size of all intermediate LDEVs in the parity group (in KB) imAllocatedCapacity Total size of all intermediate LDEVs assigned paths in the parity group (in KB) imFreeCapacity Total size of all intermediate LDEVs that are not assigned paths in the parity group (in KB) imAutoLunCapacity Total size of all intermediate LDEVs reserved for Auto LUN Software in the
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openReservedActualCapacity • Paths are not assigned. • Paths cannot be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity.
Attribute Description Protection level of the parity group For P9500 or XP24000/XP20000, one of the following values is output: • 0: Standard The parity group consists of drives other than SATA drives • 1: SATA-W/V The parity group consists of SATA drives • 2: SATA-E protectionLevel The parity group consists of SATA drives and the write performance is more enhanced than SATA-W/V -1 is output if any of the following conditions are satisfied: • The protection level of the parity group is unknown.
CommParameters instance The CommParameters instance is output when the following commands are executed: • • • • • “AddStorageArray” on page 74 “AddVirtualizationServer” on page 234 “GetHost” on page 238 “GetStorageArray (subtarget=CommParameters) ” on page 123 “RefreshStorageArrays” on page 205 Table 111 CommParameters instance attributes Attribute Description User ID For a storage system: userID User ID for accessing the storage system For a virtualization server: User ID for accessing the virtualizat
Component instance The Component instance is output when the GetStorageArray (subtarget=Component) command (see “GetStorageArray (subtarget=Component) ” on page 125) is executed.
ConfigFile instance The ConfigFile instance is output when the GetHost command (see “GetHost” on page 238) is executed. Table 113 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 • -1: None priority • 1: Primary path • 2 or greater: Alternate path ExternalStorage instance The ExternalStorage instance is output when GetStorageArray (subtarget=ExternalStorage) (see “GetStorageArray (subtarget=ExternalStorage) ” on page 128) is executed.
• “GetStorageArray (subtarget=FreeSpace) ” on page 131 Table 118 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 • -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. • 2: The Device Manager database is inconsistent.
Attribute Description 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. lun LUN of a logical unit in the storage system devNum Device number of the logical unit osScsiBus Number of the SCSI bus on the host SCSI ID assigned to a channel on the host osScsiID If this value is 64000, the values for osScsiID, osScsiBus, and osLun are invalid.
HostStorageDomain instance The HostStorageDomain instance is output when the following commands are executed: • • • • • “AddHostStorageDomain” on page 48 “AddWWNForHostStorageDomain” on page 220 “GetStorageArray (subtarget=HostStorageDomain) ” on page 135 “GetStorageArray (subtarget=Port) ” on page 165 “ModifyPort” on page 190 NOTE: In the Device Manager CLI, host storage domain information is output as the HostStorageDomain instance even if the LUN security for the port is disabled.
IPAddress instance The IPAddress instance is output when the GetStorageArray (subtarget=PortController) command (see “GetStorageArray (subtarget=PortController) ” on page 168) is executed. Table 122 IPAddress instance attribute Attribute Description IP address of the port controller ipAddress This item is output when NAS is created.
Attribute Description Number of cylinders in the LDEV For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128: cylinders • When a mainframe volume or intermediate volume is used: Number of cylinders in the LDEV • When an open volume is used: 0 Indicates whether the LDEV is used on a LUSE volume: isComposite • 0: Not a LUSE volume • 1: LUSE volume sizeInKB LDEV size (in KB) lba Number of LBAs RAID level of the LDEV RAID levels are output in the format RAIDx(yD+zP).
Attribute Description 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: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) • Blocked: Blocked status or unformatted. status • Format: The LDEV is being formatted.
Attribute Description Volume type of Hitachi TrueCopy for Mainframe Software or Hitachi TrueCopy Asynchronous for Mainframe Software • Unknown: Unknown mfTrueCopyVolumeType • Simplex: Not a Hitachi TrueCopy for Mainframe Software volume or Hitachi TrueCopy Asynchronous for Mainframe Software volume • P-VOL • S-VOL Volume type of Hitachi ShadowImage for Mainframe Software • Unknown: Unknown mfShadowImageVolumeType • Simplex: Not a Hitachi ShadowImage for Mainframe Software volume • P-VOL • S-VOL • SP-VO
Attribute Description Usage rate threshold of the virtual volume One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit consists of THP volumes: usage rate threshold value of the THP volumes#1, #2 • For volumes other than THP volumes : -1 is output. threshold #1 When the THP volumes are 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.
LogicalDKC instance The LogicalDKC instance is output when the GetStorageArray (subtarget=LogicalDKC) command (see “GetStorageArray (subtarget=LogicalDKC) ” on page 141) is executed.
Attribute Description Number of LUNs allocated to the logical group numberOfLUNs This item indicates the total number of LUNs allocated to the lower-level logical groups.
Attribute Description Emulation mode emulation This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128 (example: OPEN-8). Count of LDEV contained in the logical unit devCount For regular volumes, devCount is 1. Type of the LDEV contained in the logical unit devType This item indicates the purpose of the LDEV. CommandDevice: The LDEV is a command device.
Attribute Description Indicates whether the logical unit is a LUSE volume.
Attribute Description Pool ID of Snapshot • When the logical unit is the P-VOL or S-VOL of Snapshot: Pool ID of the pool used by the logical unit snapshotPoolID • When the logical unit is a pool volume: Pool ID of the pool to which the logical unit has been assigned In other cases, -1 is output.
Attribute Description Pool ID of the Thin Provisioning One of the following values is output for P9500 or XP24000/XP20000:: • When the logical unit consists of THP volumes: Pool ID of the THP pool to which the THP volumes are assigned.#1, #2 • When the logical unit consists of THP pool volumes: Pool ID of the THP pool that contains the THP pool volumes.#2 thpPoolID • For other volumes : -1 is output. #1 When the THP volumes are not assigned to a THP pool, -1 is displayed.
Attribute Description Type of the storage system containing the P-VOL pvolArrayType If the storage system containing the P-VOL is not registered, Unknown is output. pvolDevNum Device number of the P-VOL Device number of the P-VOL For P9500 or XP24000/XP20000: displayPvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number.
Attribute Description Copy status • -1: Unknown • 0: Simplex • 1: Pair • 8: Copying status • 9: Reverse-Copying • 16: Split • 17: Error • 18: Error in LUSE • 24: Suspending • 25: Deleting MU number of the P-VOL If the value of replicationFunction is UniversalReplicatorForMF: 0 to 3 muNumber -1 is output if the MU number is unknown. If the value of replicationFunction is not UniversalReplicatorForMF, this information is invalid.
Attribute Description pairedSerialNumber The serial number of the paired pool The type of paired pool storage system pairedArrayType A valid value is output for this item only when the storage system that contains the paired pool has been registered in Device Manager.
Attribute Description Device number for identifying the logical unit devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output. For XP12000/XP10000/SVS200 and XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output. portID Port ID domainID Domain ID of the host storage domain SCSI ID scsiID For Fibre Channel, 15 is output. LUN LUN that is assigned to the path.
Attribute Description Parity group containing the physical device arrayGroup -1 is output if the physical device does not belong to the parity group. Drive size of the physical device (in KB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: capacityInKB The capacity that is calculated by treating 1,024 bytes as 1 KB is output. For XP1024/XP128: The capacity that is calculated by treating 1,000 bytes as 1 KB is output.
Attribute Description arrayGroupName Name of the parity group to which the PDEV belongs diskModelSize Currently, this information does not apply to storage systems. encrypted Currently, this information does not apply to storage systems (-1 is output). PerformanceStatus instance The PerformanceStatus instance is output when the RefreshPerformanceData command (see “RefreshPerformanceData” on page 204) is executed.
NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.2, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script that you use in version 6.3 or later. Table 134 Pool instance attributes Attribute Description objectID Object ID of the Pool instance Name of the pool name This is output if the name has been registered. Outputs the function by which the pools are being used.
Attribute Description Indicates the pool type. The value output depends on the poolFunction value.
Attribute Description Indicates whether the value output to threshold2 is the value determined by the storage system. threshold2Mode If the storage system is P9500 and poolFunction is 5, either of the following values is output: • 0: Value determined by the storage system • 1: Value set by the user This information is unknown or invalid for other cases (-1 is output).
Attribute Description Over provisioning warning threshold (%) overProvisioningWarning If the storage system is P9500 or XP24000/XP20000 and poolFunction is 5, the threshold used to issue an advance warning for the over-provisioning percent is output. This information is invalid for other cases (-1 is output).
Attribute Description monitorEndTime#1 End time of performance monitoring (example: 23:59) This attribute is enabled only when migrationInterval is 24. Performance monitoring mode #1 monitoringMode • 0: Periodic • 1: Continuous externalMixCompatible Indicates whether a THP pool can be configured by mixing internal and external volumes.
• “ModifyPool” on page 182 Table 135 PoolTier instance attributes Attribute Description objectID Object ID of the hardware tier name Name of the hardware tier tierID ID of the hardware tier Capacity of the hardware tier (KB) capacityInKB This value does not match the total capacity of the pool volumes for Smart Tiers because the pool of Smart Tiers uses a control area.
Attribute Description Port name name This item is output if it has been registered.
PortController instance The PortController instance is output when the following commands are executed: • “GetStorageArray (subtarget=PortController) ” on page 168 • “ModifyPortController” on page 197 Table 137 PortController instance attributes Attribute Description objectID Object ID of the port controller Name of the port controller name This item is output if it has been registered.
Attribute Description Port type For P9500: • 100: ESCON (4 ports) (4 G) • 101: FICON (4 ports) (4 G) • 102: CHT (8 ports) (4 G) • 103: FICON (8 ports) (4 G) • 105: CHT (4 ports) (4 G) • 106: FICON (8 ports) (8 G) • 107: CHT (8 ports) (8 G) • 108: CHT (4 ports) (8 G) • 110: FCoE (4 ports) (10 G) For XP24000/XP20000: • 80: ESCON (4 ports) • 81: FICON (4 ports) • 82: CHT (8 ports) • 85: CHT (4 ports) • 88: CHT (4 ports) For XP12000/XP10000/SVS200: type • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-T
Attribute Description For XP1024/XP128: • 2: ESCON • 8: Fibre-Tachyon Shortwave (2 ports) • 12: Fibre-Tachyon Shortwave (4 ports) • 13: Fibre-Tachyon Shortwave (4 ports) • 14: Fibre-Tachyon Shortwave (8 ports) • 15: Fibre-Tachyon Longwave (4 ports) • 21: E-NAS • 25: iSCSI • 32: FICON Shortwave (4 ports) • 33: FICON Longwave (4 ports) RelatedDistributedArrayGroup instance The RelatedDistributedArrayGroup instance is output when GetStorageArray (subtarget=ArrayGroup) (see “GetStorageArray (subtarget=ArrayGr
Attribute Description remoteEndDevNum Maximum device number among the applicable LUs in the RCU remoteSerialNumber Serial number of the RCU SSID of the RCU remoteSSID 0 is displayed if there is no RCU.
#1 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the value for objectID will be invalid. #2 If the GetReplicationControllerPair command is executed by specifying only the masterserialnum, mastercontrollerid, remoteserialnum, and remotessid parameters, the remoteArrayFamily, remotePathGroupID, pairPortType, numOfMinConnection, and nickname attributes will not be output.
Attribute Description Value specified in HORCM_INST for the S-VOL in the HORCM configuration file svolHORCMINSTHostName In the HORCM configuration file, if HORCM_INST is set to localhost, the loopback address is output.
Attribute Description ID of the pool containing the P-VOL For Continuous Access Journal Software, a journal group ID is output. pvolPoolID For Snapshot, or Continuous Access Asynchronous Software, the pool ID of a data pool is output. -1 is output for other copy types. svolSerialNumber Serial number of the storage system containing the S-VOL Type of the storage system containing the S-VOL svolArrayType If the storage system containing the S-VOL is not registered, Unknown is output.
Attribute Description Time when the S-VOL image is created by using the replication function splitTime The number of seconds elapsed from 00:00:00 on January 1, 1970, is output (the time setting is the storage system setting, not GMT). This item is valid when the copy type is Snapshot. When the copy type differs from Snapshot, -1 is output.
Attribute Description upTime Length of time that the Device Manager server is active upSince Time and date that the server was started currentApiVersion Device Manager server API version License status • -1: Unknown • 0: Permanent license • 1: Temporary license license • 2: Emergency license • 100: Core CLI/SMI-S license • 200: A license has not been installed. • 201: A temporary license has expired. • 202: An emergency license has expired.
• • • • • • • • • • • • • • • • “GetStorageArray (subtarget=Path) ” on page 152 “GetStorageArray (subtarget=PDEV) ” on page 157 “GetStorageArray (subtarget=Pool) ” on page 159 “GetStorageArray (subtarget=Port) ” on page 165 “GetStorageArray (subtarget=PortController) ” on page 168 “GetStorageArray (subtarget=ReplicationInfo) ” on page 170 “GetTieredPoolStatus” on page 174 “GetZeroPageReclaimStatus” on page 175 “ModifyLogicalUnit” on page 180 “ModifyPool” on page 182 “ModifyPort” on page 190 “ModifyPortCont
Attribute Description numberOfControllers Number of storage system controllers capacityInGB#1 cacheInMB An attribute for compatibility. For details, see Table 143. Cache size (in MB) An attribute for compatibility. sharedMemoryInMB For details, see Table 143. Number of spare drives numberOfSpareDrives -1 is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, or SMI-S Enabled storage systems.
Attribute Description Recognition ID of the storage system. sequenceNumber Serial number or part of the serial number of the storage system is output.
Attribute Description Total size of the intermediate logical units to which paths are not assigned (in KB) imFreeCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2. • path is false. Total size of the intermediate logical units reserved for Auto LUN Software (in KB) imAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2.
Attribute Description numberOfUnallocatedMfLDEVs Number of mainframe logical devices to which paths are not assigned productCode Product code of the storage system Time when the storage system was last refreshed lastRefreshed The number of seconds elapsed from 00:00:00 on January 1, 1970 (world standard time) is displayed. This item indicates whether an unformatted logical unit can be created.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy both the following conditions (in KB): • Paths are not assigned. • Paths can be assigned by using Device Manager. openUnallocatedCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2 or 3. • path is false. • The LDEV is not used as a reserved volume#2 by storage system functions.
Attribute Description Number of open logical units and intermediate logical units that satisfy both the following conditions: numberOfReservedLUs • Paths are not assigned. • Paths cannot be assigned by using Device Manager. Number of open logical units that satisfy both the following conditions: numberOfOpenReservedLUs • Paths are not assigned. • Paths cannot be assigned by using Device Manager.
Attribute onDemandCapacityInGB# totalFreeSpaceInGB# largestFreeSpaceInGB# Description Total size of the LDEVs expanded on demand (in GB) Total size of the regions in which logical units can be created (regions of unused capacity) (in GB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
Attribute Description Total size of the intermediate logical units to which paths are not assigned (in KB) imFreeCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2. • path is false. Total size of the intermediate logical units expanded on demand (in KB) imOnDemandCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 2.
Figure 2 Relationship of attributes (total size of the storage system) Figure 3 Relationship of attributes (size of the physical volumes and virtual volumes) Figure 4 Relationship of attributes (the sizes of the volumes) URLLink instance The URLLink instance is output when the following commands are executed: • “AddURLLink” on page 260 • “GetURLLink” on page 266 Table 144 URLLink instance attributes Attribute Description objectID Object ID of URLLink name Name of the URLLink 356 Output items
Attribute Description Additional description of the URLLink description This item is output only when an additional description is registered.
• “GetStorageArray (subtarget=LogicalUnit) ” on page 144 Table 147 VolumeConnection instance attributes Attribute Description objectID Object ID of VolumeConnection Name of VolumeConnection name This item is output if it has been registered.
• • • • • • • • • “AddWWNForHostStorageDomain” on page 220 “GetHost” on page 238 “GetStorageArray (subtarget=HostStorageDomain) ” on page 135 “GetStorageArray (subtarget=LogicalUnit) ” on page 144 “GetStorageArray (subtarget=Path) ” on page 152 “GetStorageArray (subtarget=Port) ” on page 165 “MergeHost” on page 250 “ModifyHost” on page 252 “ModifyPort” on page 190 Table 148 WWN instance attributes Attribute Description World Wide Name wwn A World Wide Name is usually assigned to the HBA in the server.
Output items
6 Batch functionality This chapter describes the commands that can be executed by using the batch functionality, how to create batch files, how to use the batch functionality, and the actions to be taken if an error occurs. Commands that can be executed by using the batch functionality In the Device Manager CLI, commands can be specified in a batch file and executed at the same time. The batch option allows you to simultaneously execute many commands and is useful when installing a new storage system.
Creating batch files This section describes the input rules and conditions for creating batch files. Batch file format and input rules The batch file format is as follows: beginbatch hdvmcli command parameter hdvmcli command parameter . . endbatch The input rules for batch files are as follows: • Only ASCII encoded characters can be used in batch files. • A batch file must have beginbatch on the first line and endbatch on the last line. • Begin a new line after the character string endbatch.
Conditions for parameters to process commands together When commands are executed together, the following conditions must be satisfied for the parameter values and combinations on consecutive command lines. • Condition-1: Specify the same values as the previous lines. This means that the same parameters and parameters values as previous lines must be specified. If you specify the same parameter but use a different value, the commands will not be executed together.
Command name Parameter Specification conditions externalgrpnum externallun externalwwn inflowcontrol luoption model Y (condition-1) numoflus pathgroupid -portname serialnum Y (condition-1) domain#1 hostmode -- hostmodeoption model AddHostStorageDomain Y (condition-1) name nickname#1 -- port Y (condition-2) portname serialnum Y (condition-1) arraygroupname#2 Y (condition-2) capacity -capacitytype chassis#2 Y (condition-2) creationoption N devnum#1 -- emulation Y (condition-3#3) forma
Command name Parameter Specification conditions lusubinfo -- model Y (condition-1 and condition-3#4) numoflus N serialnum Y (condition-1) devnum domain Y (condition-2) domainnickname AddLun lun -- lusedevnums Y (condition-2) model Y (condition-1) name -- port Y (condition-2) portname scsi -- serialnum Y (condition-1) devnums -- luseoption AddLUSE model Y (condition-1) serialnum arraygroupname#1 -capacity capacitytype Y (condition-1) clprNumber Y (condition-2) devnum#1 --
Command name Parameter Specification conditions threshold -- deletionoption Y (condition-1) domain Y (condition-2) domainnickname DeleteHostStorageDomain model Y (condition-1) port Y (condition-2) portname serialnum Y (condition-1) deletionoption Y (condition-1) devnum domain -- domainnickname DeleteLun model Y (condition-1) port Y (condition-2) portname DeleteLUSE serialnum Y (condition-1) devnum -- model Y (condition-1) serialnum assign Y (condition-1) capacity devnums#5 -- mod
N: If this parameter is specified, the command cannot be executed together with other commands. The command is executed by itself. By omitting this parameter, the command can be executed together with other commands. --: This parameter does not affect whether the command is executed together with other commands. #1 If there is a command for which this parameter is specified and a command for which this parameter is omitted in the same batch file, specify the command with the parameter first.
• The -i or --input option • Commands • Command parameters • help NOTE: For details about displaying Help information when specifying the batch option, see “Help” on page 27. The following shows an example of an execution with the batch option specified, and an example of the command execution results. In this example, a batch file created in “Examples of batch file creation” on page 367 is specified as the file name batch.txt and is executed.
onDemandCapacityInGB=0 totalFreeSpaceInGB=2,383 largestFreeSpaceInGB=778 capacityInKB=6,878,866,064 freeCapacityInKB=5,114,357,504 allocatedCapacityInKB=1,683,100,560 autoLunCapacityInKB=81,408,000 onDemandCapacityInKB=0 totalFreeSpaceInKB=2,499,089,616 largestFreeSpaceInKB=816,324,096 multipathSupport=1 securityStatus=2 sequenceNumber=14053 displayArrayFamily=XP12K/10K/SVS200 displayArrayType=XP12000 numberOfLUs=2,504 numberOfAllocatedLUs=672 numberOfUnallocatedLUs=1,832 slprStatus=0 openTotalCapacity=5,34
portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=100 wwnSecurityValidity=true An instance of Path objectID=***** devNum=817 displayDevNum=03:31 portID=0 portName=CL1-A domainID=0 scsiID=15 LUN=101 wwnSecurityValidity=true An instance of Path objectID=***** devNum=816 displayDevNum=03:30 portID=4 portName=CL1-B domainID=0 scsiID=15 LUN=102 wwnSecurityValidity=true An instance of Path objectID=***** devNum=817 displayDevNum=03:31 portID=4 portName=CL1-B domainID=0 scsiID=15 LUN=103 wwnSecurityValidity=true *
2. Execute the GetStorageArray command to check which command lines in the batch file were applied to the storage system. The command processing during batch functionality execution is not performed in the order described in the batch file. All lines need to be checked to determine which command lines in the batch file were applied. 3. Delete the command lines applied to the storage system from the batch file. 4. Execute the batch functionality again.
2. Execute the GetStorageArray command to check whether there is an error in the batch file. 3. Correct any error in the batch file. 4. Execute the batch functionality again.
4. Execute the batch functionality again.
Batch functionality
7 Properties file This chapter describes how to specify options and parameters by using the Device Manager CLI properties file. This chapter also describes how to change certain properties by entering commands from the command line. Overview of the properties file The Device Manager server URL, command options, and parameters can be set in the properties file. When these items have been specified in the properties file, you do not need to enter them from the command line.
user=khalsa # Password can be provided directly, or from a password file. password=khalsa #password=@D:\\DeviceManager\\.passwd # Provide a copy of the raw xml request & response # in MessageTrace.log file. messagetrace=true ##### COMMAND PARAMETERS #### # Set the Array model, for commands that use this parameter. model=XP24000 Using the properties file to specify options Command options can be specified from the command line or in the properties file.
Encoding the password in the properties file or password file Specify a password in the properties file (hdvmcli.properties) or password file, to omit entering the password when using the Device Manager CLI. You can specify a plain text password for the properties file or password file. However, HP recommends that you use the hdvmaccount command to encode the password for better security. Environment settings for encoding a password There are two levels for encoding passwords, NORMAL and HIGH.
After the command completes, you do not need to specify the password when using the Device Manager CLI. After executing the hdvmaccount command, use the GetServerInfo or GetStorageArray command to make sure that the password is correctly set. Using the properties file to specify parameters Command parameters can be specified from the command line or in the properties file. When they have been specified in the properties file, you do not need to specify them from the command line.
hdvmcli.diaglevel=DEBUG • Information hdvmcli.diaglevel=INFO • Warnings hdvmcli.diaglevel=WARN • Errors hdvmcli.diaglevel=ERROR NOTE: As shown above, you can set the hdvmcli.diaglevel property to DEBUG, INFO, WARN, or ERROR. The default logging level is INFO. Message trace output The recording of the request messages sent to the Device Manager server and the received responses can be controlled using the -t or --messagetrace option. Like all options, the value can also be set in the properties file.
Inputting requests from XML documents CAUTION: To use the XML-API CLI feature, you need thorough knowledge of XML-API, and need to take great care in formulating commands. Rather than specifying the command and parameters from the command line, the request can originate from a file. The file must contain a valid XML document in the correct form for a Device Manager request. The command line option -i or --input specifies the input file. The other options are still valid.
PAGE 3826. 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 138 • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo GetStorageArray (subtarget=LogicalUnit) , page 144 MFReplicationInfo mfreplicationsubinfo GetStorageArray (subtarget=MFReplicationInfo) , page 149 Path pathsubinfo GetStorageArray (subtarget=Path) , page 152 Pool poolsubinfo GetStorageArray (subtarget=Pool) , page 159 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 386. 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>
fileSystemType CDATA #IMPLIED> fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percentUsed CDATA #IMPLIED> lastUpdated CDATA #IMPLIED> portISCSIName CDATA #IMPLIED>
threshold CDATA #IMPLIED> systemDisk CDATA #IMPLIED> encrypted CDATA #IMPLIED> thpTier0ConsumedCpacityInKB CDATA #IMPLIED> thpTier1ConsumedCpacityInKB CDATA #IMPLIED> thpTier2ConsumedCpacityInKB CDATA #IMPLIED> tieringPolicy CDATA #IMPLIED>
name CDATA #IMPLIED> devNum CDATA #IMPLIED> displayDevNum CDAT
volAlertNotice CDATA #IMPLIED> overProvisioningPercent CDATA #IMPLIED> overProvisioningWarning CDATA #IMPLIED> overProvisioningLimit CDATA #IMPLIED> rpm CDATA #IMPLIED> diskType CDATA #IMPLIED> tie
396 Properties file
8 Troubleshooting This chapter describes how to troubleshoot Device Manager CLI problems. Troubleshooting Device Manager CLI problems If there is a problem with the Device Manager CLI: • Make sure that the problem is not being caused by the PC or LAN hardware or software, and try restarting the PC. • Make sure that the problem is not occurring at the Device Manager server. • Check whether an error specific to the Device Manager CLI occurred. For details, see the table below.
Problem Description and recommended action CAUSE: The host used for creating the copy pair recognizes CL1-A or LUN0. SOLUTION: Assign another port to the LU or assign a LUN other than LUN0, and re-create the copy pair. SOLUTION: Collect the following information, and then contact your HP Technical Support representative. The following error message is displayed and the Device Manager CLI stops: • CLI log file An unspecified error was encountered in CLI.
Problem Description and recommended action CAUSE: Authenticate failed in the Device Manager. SOLUTION: Make sure that the user ID and password that you specified when executing the command are correct. If you are using the function for linking to an external authentication server, take the action specified below. If the external authentication server is an LDAP server: The following message is displayed when a Device Manager CLI command is executed: [KAIC90084-E] HTTP Response: "HTTP/1.
Problem Description and recommended action CAUSE: The settings of JRE do not allow using JSSE. An error occurs if SSL communication is used in AIX. SOLUTION: Add the following line to the JRE-installation-directory/lib/security/ java.security file: ssl.SocketFactory.provider=com.sun.net.ssl.internal.ssl.
9 Support and other resources Numerous support options are available. Contacting HP HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
Support and other resources
A Connecting to P9000 mainframe agent This appendix describes how to specify the information required to connect to P9000 mainframe agent.
Registering the mainframe host in Device Manager To use the AddHost command to register the mainframe host in Device Manager: 1. Execute the AddHost command to register the mainframe host in Device Manager. When you execute the command, specify the following parameters: • hostname: In this parameter, specify the host name that you specified when setting up the mainframe host environment. • hosttype: In this parameter, specify 2. 2.
name=toro2 hostID=1 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Registering the P9000 mainframe agent running on the mainframe host in Device Manager To use the AddURLLink command to register the mainframe host in Device Manager: 1. Execute the AddURLLink command to register the P9000 mainframe agent running on the mainframe host in Device Manager.
Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.log" "url=http://192.168.99.114:24042" "name=MainframeAgent" "linkedid=*****" *****: The value is encoded by the CLI.
2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again. If they have not been registered correctly, register them correctly by using the procedures described in “Registering the mainframe host in Device Manager” on page 404 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 405.
1. Check whether P9000 mainframe agent is operating normally. If it is not operating normally, check the P9000 mainframe agent settings, and restart P9000 mainframe agent. 2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again.
Example of executing the command: hdvmcli GetURLLink -o "D:\logs\GetURLLink.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.114:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI.
An instance of URLLink objectID=***** name=MainframeAgent url=http://192.168.99.100:24042 linkedID=***** createdByUser=-1 *****: The values are encoded by the CLI. Deleting P9000 mainframe agent information registered in Device Manager To delete P9000 mainframe agent information registered in the Device Manager server, use the DeleteURLLink command. Use this command when you want to delete only P9000 mainframe agent registration information.
Example of executing the command: hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****" *****: The value is encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=toro2 hostID=1 capacityInKB=0 hostType=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Changing mainframe host information To change the information of a mainframe host registered in the Device Manager server, use the ModifyHost command.
Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=snow hostID=1 capacityInKB=0 hostType=2 sysplexID=RSDPLEX statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Deleting a mainframe host To delete a mainframe host registered in the Device Manager server, use the DeleteHost command.
Glossary This glossary defines the special terms used in this document.
LUN logical unit number LUSE Logical Unit Size Expansion (feature of XP1024/XP128) MB megabytes (1024 KB) MCU main control unit (for Continuous Access Software) OS operating system PDEV physical device P-VOL primary volume (for Business Copy Software or Continuous Access Software) RAID redundant array of independent disks RCU remote control unit (for Continuous Access Software) SCSI small computer system interface SLPR Storage Logical Partition SMI-S Storage Management Initiative - Sp
Index A access control, 35 AddArrayReservation, 41 AddConfigFileForReplication, 268 AddExternalArrayGroup, 43 AddHost, 228 AddHostInfo, 229 AddHostRefresh, 232 AddHostStorageDomain, 48 AddLabel, 55 AddLogicalUnit, 56 AddLun, 215 AddLUSE, 63 AddPool, 66 AddReplication, 277 AddStorageArray, 74 AddTieredPoolOperation, 80 AddURLLink, 260 AddVirtualizationServer, 234 AddVirtualVolume, 82 AddWWNForHostStorageDomain, 220 B batch commands that can be executed, 361 execution example, 368 execution results, 368 C c
GetReplicationControllerPair, 292 GetServerInfo, 265 GetStorageArray, 112 GetStorageArray (subtarget not specified), 117 GetStorageArray (subtarget=ArrayGroup), 119 GetStorageArray (subtarget=CommParameters), 123 GetStorageArray (subtarget=Component), 125 GetStorageArray (subtarget=ExternalStorage), 128 GetStorageArray (subtarget=Filter), 129 GetStorageArray (subtarget=FreeSpace), 131 GetStorageArray (subtarget=HostStorageDomain), 135 GetStorageArray (subtarget=LDEV), 138 GetStorageArray (subtarget=LogicalD
user group, 34 V version Device Manager CLI, 28 CLI Reference Guide 417