HP P9000 Command View Advanced Edition Suite Software CLI Reference Guide Part number: TB581-96348 Tenth edition: May 2013
Legal and notice information © Copyright 2010, 2013 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 ...........................................................................................................
DeleteLabel ..................................................................................................................... DeleteLogicalUnit ............................................................................................................. DeleteLUSE ...................................................................................................................... DeletePool .................................................................................................................
DeleteWWNForHostStorageDomain ................................................................................... Host management commands .................................................................................................. AddHost ......................................................................................................................... AddHostInfo ....................................................................................................................
PairedPortController instance .................................................................................................... Path instance .......................................................................................................................... PDEV instance ........................................................................................................................ PerformanceStatus instance ..................................................................................
Setting up the execution environment ......................................................................................... Specifying the log file ....................................................................................................... Specifying a log level ....................................................................................................... Message trace output .......................................................................................................
Figures 1 Example of executing the AddExternalArrayGroup command ........................................ 50 2 Relationship of attributes (total size of the volumes in the storage system) ...................... 404 3 Relationship of attributes (size of the physical volumes and virtual volumes) ................... 404 4 Relationship of attributes (the sizes of the volumes) .................................................... 404 5 Flow of operations for importing host information (ImportHosts command) ......
Tables 1 Differences in functions between the Core CLI/SMI-S license and a full license ................ 18 2 Device Manager CLI variable syntax ......................................................................... 26 3 Device Manager CLI options .................................................................................... 27 4 Device Manager CLI return values ............................................................................. 30 5 Storage system commands and related storage systems ...
33 DeleteArrayReservation command parameters .......................................................... 103 34 DeleteExternalArrayGroup command parameters ...................................................... 104 35 DeleteHostStorageDomain command parameters ...................................................... 104 36 DeleteLabel command parameters ........................................................................... 106 37 DeleteLogicalUnit command parameters .......................................
70 ModifyArrayReservation command parameters ......................................................... 199 71 ModifyExternalTierRank command parameters .......................................................... 200 72 ModifyLabel command parameters ......................................................................... 203 73 ModifyLogicalUnit command parameters ................................................................. 205 74 ModifyPool command parameters ..........................................
106 AddURLLink command parameters .......................................................................... 304 107 DeleteAlerts command parameters .......................................................................... 305 108 DeleteURLLink command parameters ........................................................................ 306 109 GetAlerts command parameters .............................................................................. 307 110 GetURLLink command parameters ....................
143 PerformanceStatus instance attributes ....................................................................... 375 144 Pool instance attributes .......................................................................................... 376 145 PoolTier instance attributes ..................................................................................... 382 146 Port instance attributes ...........................................................................................
Preface This guide describes HP StorageWorks P9000 Command View Advanced Edition Suite Software and how to set up and use the command line interface (CLI). Besides command syntax and parameters, topics include batch files, mainframe hosts, output formats, and troubleshooting. The intended audience is a storage administrator with independent knowledge of HP StorageWorks P9000 storage systems, SANs, and Java environments.
Preface
1 Overview This chapter provides an overview of the Device Manager CLI. This chapter also explains the differences between Device Manager licenses and provides a procedure for downloading the Device Manager CLI from the Device Manager server. Overview of the Device Manager CLI By issuing commands from a command line prompt, the Device Manager CLI communicates with the Device Manager server and issues requests to a storage system.
Device Manager licenses Device Manager provides the following two licenses: Full license: A full license is required to use all Device Manager functions. The types of full licenses are as follows: permanent, temporary, and emergency. Core CLI/SMI-S license: The Core CLI/SMI-S license enables you to use only storage management functions that use the Device Manager CLI. With the Core CLI/SMI-S license, you cannot use storage management functions from the GUI.
3. Decompress the copied file. After modifying the hdvmcli.properties file as needed, you can run the Device Manager CLI. When you want to use the Device Manager CLI by downloading it from the GUI, check the Java version that the Device Manager CLI supports, and then specify an appropriate JRE. For details about how to specify a JRE, see “How to configure a Java environment” on page 21.
Overview
2 Environment settings This chapter provides the environment settings necessary to use the Device Manager CLI. Java environment settings To execute the Device Manager CLI, the Java environment must be properly configured for the Device Manager CLI execution environment. How to configure a Java environment It is assumed that a Java version supported by the Device Manager CLI is installed on the computer that executes the Device Manager CLI.
NOTE: If you use the Device Manager CLI on the same computer as the Device Manager server, HP recommends that you specify the same JRE that the Device Manager server uses (the JRE provided with HP P9000 Command View Advanced Edition Suite). However, when HTTPS is used to communicate with the Device Manager server, you cannot use the same JRE that the Device Manager server uses. In this case, prepare another JRE that is supported by the Device Manager CLI and configure a Java environment.
Setting up HTTPS communication To use HTTPS to communicate with the Device Manager server, you need to set up an environment on Device Manager server and the management client that executes the Device Manager CLI. For details about how to specify the security communication settings, see the HP P9000 Command View Advanced Edition Suite Software Administrator Guide. For details about examples of executing commands using HTTPS, see “Executing the Device Manager CLI by using HTTPS” on page 29.
Environment settings
3 Executing commands This chapter explains how to execute Device Manager CLI commands. This chapter also contains a command list and notes on executing commands. Command syntax The Device Manager CLI provides a simple way to submit requests to the Device Manager server and examine responses from the server. The application is run from the command line. Each execution of the application sends one request to the server and receives a response to that request.
NOTE: • You can also set the URL, options, and parameters arguments in the properties file. If arguments are specified both in the properties file and from the command line, the arguments specified from the command line take precedence. For details about the properties file, see Chapter 8 on page 435. • The Device Manager CLI only supports ASCII code characters.
Variable options Function Options control the behavior of the CLI application. Options are entered in the typical UNIX fashion. Options are case sensitive. Each option has a single character representation and an alternate word representation; for the single character, prefix the character with a single dash; for the word, prefix the word with two dashes. For example: -t or --messagetrace. Some options require an argument, which follows the option. For example, the -u option is followed by a user ID.
Option Argument for the option Status Description An XML API request file Takes input from the specified file, which must contain the Device Manager server request as a complete XML document. When this option is selected, the output of the server's response is an XML-formatted document. -i or --input file-name#2 Optional If you specify this option, the specification in the file overrides the equivalent specification from the command line.
If you execute a command other than the Help function by specifying a login user ID but not specifying the login password for the option or property, a message appears prompting you to enter the login password. #4 If you specify csv with the -f (or --format) option as one of the parameters for the GetStorageArray command, there are some parameters that you cannot specify.
Return values The Device Manager CLI returns an execution result value at the end of each process. The following table lists and describes the CLI return values. Table 4 Device Manager CLI return values Return values Description 0 The CLI ended normally. 1 The CLI found errors within the process (for example, a parameter error). 2 The CLI found errors in the Device Manager server. Help This section describes the various types of Device Manager CLI Help and how to display them.
To display Help for the batch function, specify the following: C:\hdvm> hdvmcli help batch List of commands Table 5 through Table 10 list the CLI commands and related storage systems. Note that if the Core CLI/SMI-S license is used, logical group commands (see Table 6) cannot be used. For details about the Core CLI/SMI-S license, see “Device Manager licenses” on page 18.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- AddVirtualVolume Creates THP/Smart volumes and assigns THP/Smart volumes to a THP/Smart pool. Y Y -- -- AddVLDEVToVRPU Adds an LDEV to a resource group used for data migrations that use virtual IDs, and registers the LDEV virtual information. If LDEV virtual information is already registered, the LDEV virtual information is updated.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- -- 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/Smartpool shrink operation. Y -- -- -- GetStorageArray# Obtains information about a storage system. Y Y Y Y GetTieredPoolStatus Obtains the execution status of manually-executed performance monitoring and hardware tier relocation for a Smart pool.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Modifies port controller attributes. -- Y Y Y ModifyStorageArray Modifies storage system names registered on the Device Manager server. Y Y Y Y ModifyTieringPolicy Modifies the tiering policy. Y -- -- -- ModifyVirtualVolume Modifies the settings related to a THP/Smart volume.
You can use the subtarget parameter to specify the device information you wish to obtain. For the values that can be specified for the subtarget parameter, see “Using the GetStorageArray parameter” on page 127 . Table 6 Logical group commands Command name Description GetLogicalGroup Obtains information about logical groups.
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. ImportHosts Imports host information from the input CSV host information file and mapping definition file.
XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y -- GetReplicationControllerPair Obtains RCU (remote path) information registered in the MCU in storage systems managed by the Device Manager server. Y Y Y Y ModifyReplication Changes copy pair statuses. Y Y Y Y Command name Description DeleteReplication Deletes copy pairs. P9500 XP1024/ XP128 Legend: Y: Indicates that the particular storage system can be used to execute the command.
Commands related to resources after a data migration that uses virtual IDs P9500, when virtual IDs are used to migrate data, migration source information is registered for the migration-destination resources as virtual information. The migration-source resources for which information is registered to migration-destination resources are called virtual resources (for example, virtual storage systems and virtual LDEVs).
Supported functions Command name Registration, modification, and deletion of virtual information AddVLDEVToVRPU DeleteVLDEVFromVRPU #1 LUN security settings cannot be changed. #2 Operations related to LUSE volumes cannot be performed. #3 The LUN security for the specified port must be enabled. Commands and roles In Device Manager, users are registered in user groups, and resources are registered in resource groups.
Command name Role AddLabel Admin or Modify AddLogicalUnit Admin or Modify AddLUSE Admin or Modify AddPool Admin or Modify AddStorageArray (When the storage system is not managed by the Device Manager server) Admin#1 AddStorageArray (When the storage system is managed by the Device Manager server) Admin#2 or Modify#2 AddTieredPoolOperation Admin or Modify AddVirtualVolume Admin or Modify AddVLDEVToVRPU Admin or Modify DeleteArrayReservation Admin or Modify DeleteExternalArrayGroup Admi
Command name Role ModifyLabel Admin or Modify ModifyLogicalUnit Admin or Modify ModifyPool Admin or Modify ModifyPort Admin or Modify ModifyPortController Admin or Modify ModifyStorageArray Admin#1 or Modify#1 ModifyTieringPolicy Admin#1 or Modify#1 ModifyVirtualVolume Admin or Modify RefreshPerformanceData Admin or Modify RefreshStorageArrays Admin#2 or Modify#2 RunZeroPageReclaim Admin or Modify ShrinkPool Admin or Modify #1 All Resources must be assigned as a resource group.
Command name Role AddHostInfo Admin or Modify AddHostRefresh Admin or Modify AddVirtualizationServer Admin or Modify DeleteHost Admin or Modify DeleteHostInfo Admin or Modify GetHost Admin, Modify, or View GetHostInfo Admin, Modify, or View HostScan Admin# or Modify# ImportHosts Admin or Modify MergeHost Admin# or Modify# ModifyHost Admin or Modify ModifyHostInfo Admin or Modify ModifyVirtualizationServer Admin or Modify RefreshVirtualizationServer Admin or Modify # All Resourc
Command name Role AddReplication Admin or Modify DeleteReplication Admin or Modify GetReplicationControllerPair Admin, Modify, or View ModifyReplication Admin or Modify Notes on executing CLI commands Note the following when you execute a CLI command: Table 19 Notes on executing commands Item Description Related commands When adding a LUN or host storage domain, make sure that I/O operations from the host to the corresponding port have stopped.
Item Description Using Disk/Cache Partition (when using XP12000/XP10000/SVS200) When you use Disk/Cache Partition to create a LUSE volume, path, or copy pair (Business Copy Software), specify the same storage logical partition. If you specify a different storage logical partition, the storage partition administrator cannot manage the created resource.
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.
• DeleteLun • DeleteLUSE • DeletePool • DeleteVirtualVolume • DeleteVLDEVFromVRPU • DeleteWWN • DeleteWWNForHostStorageDomain • FormatLU • ModifyArrayReservation • ModifyLogicalUnit • ModifyPool • ModifyPort • ModifyPortController • ModifyVirtualVolume • RunZeroPageReclaim • ShrinkPool Parameters Table 20 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 obta
loginID=dmuser beginTime=1,039,003,476 *****: The values are encoded by the CLI. 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.
Parameter name Status Description Port WWN of the external storage system If you specify multiple (alternate) paths, use a comma to separate each entry. externalwwn Required When specifying paths, the parameters portname, externalwwn, and externallun must all be specified as a set. The order in which they are specified dictates the path priority. (The first parameter in the set will become the primary path.) Make sure that the order and number of the values specified for these parameters are correct.
Parameter name Status Description Option information that determines whether logical units are to be created at the same time an external parity group is created Either of the following values can be specified: luoption Optional • none: No logical unit is created. • create: Logical units are created. If this parameter is omitted, none is set. Number of logical units to be created The only valid value is 1. numoflus Optional If this parameter is omitted, 1 is set.
externalwwn For external storage systems other than SMI-S Enabled storage systems, obtain this value from the execution results of the GetStorageArray (subtarget=Port, portsubinfo=WWN) command. Then, select the port whose wwn value displayed below An instance of WWN matches the worldWidePortName value of the portname parameter. Then, for the externalwwn parameter, specify the worldWidePortName value of that port. At this time, record the portID value.
Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
sizeInKB=1,048,576 cylinders=0 fsControlIndex=0 List of 2 ExternalPathInfo elements: An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.50 externalLun=1 portID=13 pathGroupID=23 priority=1 An instance of ExternalPathInfo objectID=***** externalWWN=50.06.0E.80.10.22.8B.52 externalLun=0 portID=15 pathGroupID=23 priority=2 *****: The values are encoded by the CLI. AddHostStorageDomain AddHostStorageDomain adds a host storage domain.
Parameter name Status Description Domain ID of the host storage domain This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. The execution results are output in decimal. domain Optional The specifiable values depend on the storage system.
Parameter name Status Description Nickname of the host storage domain Specify the name used for the host group to be created in the storage system. If this parameter is omitted, it is set automatically. When adding a host storage domain, if you use the HostScan command to register a host in Device Manager, in the nickname parameter specify the name of the host that uses the host storage domain. For details about the HostScan command, see “HostScan” on page 286.
Storage system Value of hostmode • Standard • Sequent • HP • Solaris • Netware • Windows XP12000/ XP10000/SVS200 • Windows Extension • Tru64 • AIX • OPEN-VMS The following value relies on the microcode version. For 50-03-0X-XX/XX or later: • UVM • Standard • Sequent • HP • Solaris • Netware • Windows • Tru64 • AIX • OPEN-VMS XP1024/XP128 The following value relies on the microcode version.
For details, see the documentation of the LUN management product for the storage system you are using. Table 24 Values that can be specified in the hostmodeoption parameter hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y Y Y Y P9500 VERITAS Database Edition/Advanced Cluster 2 Specify this value when using VERITAS Database Edition/Advanced Cluster for Real Application Clusters or VERITAS Cluster Server 4.0 or later (I/O fencing feature).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y Y Y Y Y Y Y Y -- -- Y Y Y Y Y Y Y P9500 SIM report at link failure 13 Specify this value when you want to get a SIM notification when the number of unsuccessful connections between ports exceeds a threshold. HP TruCluster with Continuous Access function Specify this value when both of the following conditions are satisfied: 14 • The host mode is set to Tru64 (mode 07).
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 -- -- Y -- -- Y Y Y -- Y Y -- P9500 2TB or Larger LUN Support Specify this value when both of the following conditions are satisfied: • The host accesses a volume that exceeds 2 TB. • The host OS is one of the following: - AIX 5L Version 5.2 TL08 or later, or AIX 5L Version 5.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y Y -- Y Y -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- P9500 V-Vol expansion Specify this value when both of the following conditions are satisfied: 40 • The host mode is set to Windows (mode 0C) or Windows Extension (mode 2C). • After increasing the THP volume capacity, you want to force that capacity to be automatically recognized.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y Y -- Y Y -- Y Y -- Y -- -- Y -- -- Y -- -- P9500 Round Trip Set Up Option 51 Specify this value when you want to use Round Trip to improve True Copy performance. ESAM and Cluster Software for SCSI-2 Reserve 52 Specify this value when cluster software is used that uses SCSI-2 Reserve in a configuration that uses External Storage Availability Manager.
hostmodeoption values Description XP24000/ XP20000 XP12000/ XP10000/ SVS200 Y -- -- Y -- -- Y -- -- Y -- -- P9500 Online LUSE expansion Specify this value when the expansion of the capacity of a LUSE volume is notified for a host. 69 Change the Unit Attention for Blocked Pool-VOLs Specify this value when a Unit Attention (UA) response for a closed pool volume is changed from NOT READY to MEDIUM ERROR.
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. nickname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. Execute this command by specifying only the model and serialnum parameters, Port for the subtarget parameter, and HostStorageDomain for the portsubinfo parameter.
Parameter name Status Description Device number of the logical unit to which a label is to be added For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution result RESPONSE: An instance of ObjectLabel targetID=***** label=myLabel An instance of ObjectLabel targetID=***** label=myLabel *****: The values are encoded by the CLI. AddLogicalUnit AddLogicalUnit creates an LDEV and LU. With P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, you can create multiple logical units at once. The LDEVs created by this command are formatted when they are created.
capacity=capacity-of-the-logical-unit [emulation=emulation-type] [devnum=logical-unit-device-number] [lusubinfo=LDEV] [format={none|normal|quick#}] [capacitytype={KB|block}] When creating multiple logical units in bulk by specifying their capacity and number: hdvmcli [URL] AddLogicalUnit [options] serialnum=serial-number model=model {chassis=chassis-number groupnum=parity-group-number |arraygroupname=parity-group-name} [fsindex=index-number-of-region-of-unused-capacity] creationoption=bulk capacity=capacit
Parameters Table 26 AddLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system where the LU is added model Required Model of the storage system where the LU is added Number of the chassis for the parity group where the LU is added If you specify this parameter, make sure that groupnum is also specified. chassis Optional Always specify either the chassis and groupnum parameters together, or the arraygroupname parameter by itself.
Parameter name Status Description LU creation method Specify a creation method for creating multiple LUs at once. One of the following values can be specified: • bulk: Creates LUs by specifying their capacity and number. Optional creationoption# (P9500, XP24000/XP20000, and XP12000/ XP10000/SVS200) If you specify bulk, also specify capacity and numoflus. • dividebynum: Creates LUs by specifying their number. If you specify dividebynum, also specify numoflus but do not specify capacity.
Parameter name Status Description Emulation type of the logical unit The following are the specifiable emulation types: • OPEN-3 • OPEN-8 • OPEN-9 • OPEN-E • OPEN-K • OPEN-V emulation Optional Specify the same emulation type as the parity group in which a logical unit is created. If no such emulation is present, parity group emulation is used. This parameter must be specified if the creationoption parameter is specified. In this case, OPEN-V is the only value you can specify.
Parameter name Status Description The unit for the value specified in the capacity parameter The values you can specify are KB or block. capacitytype Optional If this parameter is omitted, KB is set as the unit. block can be specified for P9500, XP24000/XP20000, and XP12000/XP10000/SVS200 only. # For P9500 and XP24000/XP20000, if you do not specify the fsindex and creationoption parameters, you can optimize the regions of unused capacity to create an LU.
An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: • When you add a LUSE volume with the luseoption parameter set, specify a LDEV in which a path is set as the first LDEV. If a LDEV without a path set is specified as the first LDEV, an error will occur. • When a LUSE volume is added with the luseoption parameter set, the extended LUSE volume might not be able to be recognized, based on the host. In this case, restart the host.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. Command execution example hdvmcli AddLUSE -o "D:\logs\AddLUSE.log" "serialnum=15001" "model=XP1024" "devnums=1001,1002" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown
clprNumber=-1 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 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. AddPool AddPool creates a THP/Smart pool in a targeted storage system.
• If more than one logical unit is specified, all of them must have the same CLPR number. • If more than one logical unit is specified, all of them must have the same cache mode. The following conditions apply only to P9500 with a microcode version earlier than 70-02-00-XX/XX: • If more than one logical unit is specified for a THP/Smart pool, internal volumes and external volumes cannot be mixed together.
NOTE: For details about the following conditions, see the Thin Provisioning documentation: • The number of pool volumes that can be specified in a THP/Smart pool • The total maximum number of THP/Smart pools, Snapshot pools, and Fast Snap pools Format for P9500 hdvmcli [URL] AddPool [options] model=model serialnum=serial-number [poolid=pool-ID] [threshold=THP/Smart-pool-threshold-1] [threshold2=THP/Smart-pool-threshold-2] [threshold2mode={0|1}] [overprovisioningwarning=over-provisioning-warning-threshold]
Parameter name Status Description Threshold1 of the THP/Smart pool (%) The threshold1 of the THP/Smart pool is the usage rate of the THP/Smart pool. For P9500 whose microcode version is earlier than 70-014X-XX/XX: Specify a multiple of 5 in the range from 5 to 95. threshold Optional For P9500 whose microcode version is 70-01-4X-XX/XX or later: Specify an integer in the range from 1 to 100. For XP24000/XP20000: Specify a multiple of 5 from 5 to 95.
Parameter name Status Description Over provisioning warning threshold (%) This is a threshold value related to the over-provisioning percent.#2 Specify a threshold value used to issue an advance warning. For P9500: overprovisioningwarning#1 Specify an integer from 0 to 65534. You need to specify a value smaller than the one specified for overprovisioninglimit. Optional If this parameter is omitted, -1 is set. -1 indicates that a threshold value is not set.
Parameter name Status Description Specify whether to create a Smart pool. Optional tiercontrol (P9500) One of the following values can be specified. • enable: Creates a Smart pool. • disable: Creates a THP pool. If this parameter is omitted, enable is set. Specify whether to automatically execute performance monitoring and hardware tier relocation. Optional automigration (P9500) If you specify this parameter, you must also specify tiercontrol=enable. One of the following values can be specified.
Parameter name Status Description Performance monitoring mode. If you specify this parameter, you must also specify tiercontrol=enable. Specifiable values vary, depending on the microcode version. Optional monitoringmode (P9500) If the microcode version is earlier than 70-02-XX-XX/XX: 0: Periodic If this parameter is omitted, 0 is set. If the microcode version is 70-02-XX-XX/XX or later: 0: Periodic 1: Continuous If this parameter is omitted, 1 is set.
Parameter name Status Description Buffer space for hardware tier relocation (%) Specify how much work space the storage system can use for data relocation for each hardware tier of a Smart pool. You can specify an integer from 2 to 40. If this parameter is omitted, 2 is set for all tiers. We recommend that you use the default values. The following uses a three-tier Smart pool as an example of how to specify this parameter.
unit that satisfies the conditions to be used as a pool volume in a THP/Smart pool to specify the devnums parameter. Command execution example In this example, the AddPool command creates a Smart pool 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 Smart pool to 75% (threshold: 75). hdvmcli AddPool -o "D:\logs\AddPool.
relocationState=-1 relocationProgress=-1 numberOfTiers=1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 1 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidTyp
*****: The values are encoded by the CLI. AddStorageArray AddStorageArray searches for storage systems (including SMI-S Enabled storage systems), and registers the storage system information (such as the IP address, user ID, and password) into the Device Manager server database. For the registered storage systems, AddStorageArray modifies the registered information, and refreshes the storage system configuration information (that is, updates the configuration information).
Format for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128 hdvmcli [URL] AddStorageArray [options] ipaddress=IP address family=storage-system-family [displayfamily=storage-system-family-to-be-displayed] [userid=user-ID arraypasswd=user-password] 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
Parameter name Status Description User ID For P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: Specify the user ID used to access the storage system. userid# Required or optional You cannot omit this parameter when using the command to perform initial registration of information. However, you can omit this parameter when updating information, if you do not change the user ID. For an SMI-S Enabled storage system: Specify the user ID used to access the SMI-S provider.
# If P9000 Command View AE Suite products are used to manage copy groups defined in a device group, due to a RAID Manager limitation, be sure to specify character strings of 63 characters or less for userid and arraypasswd. Parameter values to obtain in advance family and displayfamily Obtain the values of these parameters from the execution results of the GetServerInfo command.
capacityInKB=4,025,592,720 freeCapacityInKB=2,442,665,520 allocatedCapacityInKB=1,578,120,480 autoLunCapacityInKB=4,806,720 onDemandCapacityInKB=0 totalFreeSpaceInKB=20,192,256 largestFreeSpaceInKB=3,796,992 multipathSupport=1 securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayArrayType=XP1024 numberOfLUs=1,555 numberOfAllocatedLUs=565 numberOfUnallocatedLUs=990 slprStatus=-1 openTotalCapacity=4,025,592,720 openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoLu
AddTieredPoolOperation AddTieredPoolOperation manually monitors the performance of and relocates hardware tiers for a Smart pool. To check the execution status of the AddTieredPoolOperation command, use the GetTieredPoolStatus command. NOTE: • This command can be used only with P9500. • This command can be used only when the automatic execution of performance monitoring and hardware tier relocation for the target Smart pool is set to disable.
Parameter name Status Description Specify one of the following values: • startMonitor: Starts performance monitoring. • stopMonitor: Stops performance monitoring. operation Required • startRelocation: Starts hardware tier relocation. • stopRelocation: Stops hardware tier relocation. Specify stopRelocation when suspending hardware tier relocation performed by using the AddTieredPoolOperation command. List of pool IDs poolids Required Specify the pool ID of a Smart pool.
An instance of Pool objectID=***** poolFunction=5 poolID=1 controllerID=-1 poolType=32 status=20 threshold=70 threshold2=80 threshold2Mode=0 capacityInKB=319,678,464 freeCapacityInKB=319,678,464 usageRate=0 numberOfPoolVols=31 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=131 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monito
If you use the poolid parameter to specify the pool ID of a THP/Smart pool, the THP/Smart volumes that are created are assigned to that THP/Smart pool. For P9500 and XP24000/XP20000, AddVirtualVolume can be used to create a virtual parity group and populate it with THP/Smart volumes. For XP24000/XP20000, AddVirtualVolume can be used to create THP volumes in an existing virtual parity group.
• The number of THP/Smart volumes that you can create in a single virtual parity group • The number of THP/Smart volumes that you can assign to a single THP/Smart pool • The number of virtual parity groups that you can create under a single disk controller Format for P9500 hdvmcli [URL] AddVirtualVolume [options] model=model serialnum=serial-number capacity=capacity-of-THP/Smart-volumes [numoflus=number-of-THP/Smart-volumes] [devnum=device-number-of-logical-unit] poolid=pool-ID-of-THP/Smart-pool Format fo
Parameters Table 31 AddVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Optional groupoption (XP24000/ XP20000) Specifies whether to create THP volumes within an existing virtual parity group. Specify exist to create the THP volumes in an existing virtual parity group. If you specify this parameter, you must also specify the arraygroupname parameter.
Parameter name Status Description CLPR number clprNumber Optional If this parameter is omitted, 0 is set. (XP24000/ XP20000) For XP24000/XP20000, if the poolid parameter has been specified, the CLPR number of the THP pool identified by the pool ID is set. Pool ID of a THP/Smart pool poolid Optional Specify the pool ID of the THP/Smart pool to which to assign the THP/Smart volumes to be created. For P9500, always specify this poolid parameter.
model=XP24000 serialnum=15065 arraygroupname=X200-1 capacity=209715200 numoflus=2 devnum=00:30:00 poolid=0 threshold=10 Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
protectionLevel=-1 thpPoolID=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V devCount=1 devType= capacityInKB=209,715,200 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 raidType=Unknown currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeTy
slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-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=
isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=substance=0 volumeType=-1 slotSizeInKB=48 chassis=16,485 arrayGroup=199 arrayGroupName=X200-1 path=false onDemandDevice=false devType= isStandardLDEV=true diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=10 system
• • • • • • It is not a pool volume or a journal volume. It is not a LUSE volume. It does not have a path. It is not a command device It must be an open volume The emulation type must be OPEN-V. • If an LDEV is to be added to a resource group used for data migrations that use virtual IDs, the LDEV belongs to a resource group (meta_resource) that is managed by a storage system management tool and whose resource group ID is 0.
Parameter name Status Description Virtual emulation type of the LDEV The following are the specifiable emulation types: • OPEN-3 • OPEN-8 vemulation Optional • OPEN-9 • OPEN-E • OPEN-K • OPEN-L • OPEN-V If this parameter is omitted, it is assumed that OPEN-V is specified. Virtual SSID of the LDEV vssid Optional Specify an integer from 4 to 65533 for the virtual SSID of the LDEV.
An instance of VResourcePartitionUnit. Use this value to specify the vrpuid parameter. devnum Obtain this value from the execution results 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 results, the devNum value, which is required for the devnum parameter, is output after An instance of LDEV. Specify this devNum value for the devnum parameter.
Parameters Table 33 DeleteArrayReservation command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 34 DeleteExternalArrayGroup command parameters Parameter name Status Description serialnum Required Serial number of the storage system where you want to delete the external parity group model Required Model of the storage system where you want to delete the external parity group arraygroupnames Required List of external parity group names to be deleted Use a comma to delimit multiple values.
Parameter name Status Description model Required Model of the storage system for the host storage domain. The port ID of the host storage domain to delete port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name for the host storage domain to delete portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter. In the execution result of this command, the nickname value appears under An instance of HostStorageDomain. Use this value to specify the domainnickname parameter. Command execution example hdvmcli DeleteHostStorageDomain -o "D:\logs\DeleteHostStorageDomain.
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.
Parameter name Status Description Device number of the LU For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Command execution example hdvmcli DeleteLogicalUnit -o "D:\logs\DeleteLogicalUnit.log" "serialnum=10001" "model=XP12000" "devnum=1" Command execution result RESPONSE: (Command completed; empty list returned) DeleteLUSE DeleteLUSE deletes a LUSE volume on a storage system.
isComposite=1 and path=false indicates that it is a LUSE volume that does not have a path. In the execution result of this command, the devNum value of the relevant logical unit appears under An instance of LogicalUnit. Use this devNum value to specify the devnum parameter. Command execution example hdvmcli DeleteLUSE -o "D:\logs\DeleteLUSE.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter. Command execution example In this example, the DeletePool command deletes the THP pool whose pool ID is 0 (poolid: 0) from the storage system (serialnum: 15065, model: XP24000). hdvmcli DeletePool -o "D:\logs\DeletePool.
Parameters Table 40 DeleteStorageArray command parameters Parameter name Status Description Serial number of the storage system to delete serialnum # Optional You cannot specify this parameter if you are deleting an SMI-S Enabled storage system. Model of the storage system to delete # model Optional saobjid Optional# You cannot specify this parameter if you are deleting an SMI-S Enabled storage system.
NOTE: This command can be used only with P9500 and XP24000/XP20000. For P9500 and XP24000/XP20000, to delete a THP/Smart volume, the following conditions must be satisfied: • The THP/Smart volume does not have any paths. • To delete specified THP/Smart volumes, Open Volume Management must be installed in the storage system. • The THP/Smart volume has a guard mode of Read/Write.
hdvmcli [URL] DeleteVirtualVolume [options] model=model serialnum=serial-number [deletionoption=force] devnums=device-number-of-THP-volume # If the microcode version is 60-04-XX-XX/XX or later and the system option 726 is set to ON, you cannot specify this format. If you specify this format, an error will occur.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. Command execution example In this example, the DeleteVirtualVolume command deletes the virtual parity group (arraygroupnames: X200-1) containing THP volumes from the storage system (serialnum: 15065, model: XP24000). In addition, this command also deletes THP volumes whose assignations with THP pools have not been released by specifying force for the deletionoption parameter.
Parameter name vrpuid Status Required Description ID of the resource group used for data migrations that use virtual IDs Specify the ID of the resource group that contains the LDEV whose virtual information is to be deleted. Device number of the LDEV devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional.
FormatLU FormatLU formats an LU. To check whether the LDEV was formatted properly if you omitted the wait parameter, or if you specified false in the wait parameter, first use the AddStorageArray command to refresh the storage system, and then execute the GetStorageArray (subtarget=LDEV) command and check the value of status in the execution results. If you specified true in the wait parameter, simply check the value of status in the execution results of the FormatLU command.
Parameter name Status Description List of the device numbers of the LUs to be formatted For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colondelimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. devnums Obtain this value from the execution result of the GetStorageArray (subtarget=LogicalUnit, lusubinfo=LDEV) command.
thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=1,175 displayName=00:04:97 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=100,000 lba=200,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=256 chassis=1 arrayGroup=0 arrayGroupName=1-1-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1
arrayGroupName=1-1-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=100,000 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devN
tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. GetArrayReservation GetArrayReservation obtains information about a locked storage system. This command does not have parameters. Command execution example hdvmcli GetArrayReservation -o "D:\logs\GetArrayReservation.
NOTE: • This command can be used only with P9500. • While the THP/Smart-pool shrinking operation is being executed, if another operation is performed on the pool and the pool changes to a status in which the pool cannot shrink, the THP/Smart-pool shrinking operation fails. As a result, the THP/Smart pool volumes to be excluded might partially remain as they are, without being excluded. In this case, do not execute the FormatLU command for these volumes.
objectID=***** poolFunction=5 poolID=1 controllerID=-1 poolType=32 status=0 threshold=70 threshold2=80 threshold2Mode=0 capacityInKB=309,227,520 freeCapacityInKB=309,227,520 usageRate=0 numberOfPoolVols=30 numberOfVVols=1 capacityOfVVolsInKB=419,457,024 clprNumber=0 raidLevel=RAID5 combination=3D+1P volAlertNotice=-1 overProvisioningPercent=135 overProvisioningWarning=-1 overProvisioningLimit=500 rpm=10,000 diskType=4 tierControl=disable autoMigration=disable migrationInterval=24 monitorStartTime=00:00 moni
raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=1,547 displayName=00:06:0B emulation
Command execution result 2 This execution result indicates that the operation for shrinking the THP/Smart pool has finished because no LogicalUnit instances corresponding to the THP/Smart pool volumes (devnum: 00:06:0B) specified by the ShrinkPool command are displayed. RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1
NOTE: When you execute the GetStorageArray command with the subtarget parameter specified and without the model and serialnum parameters specified, if a value other than 0 is specified for statusOfDBInconsistency (which is displayed under An instance of StorageArray as the result of the GetStorageArray command), information of the component specified for the subtarget parameter might not be output to the command output.
Value of subtarget Information that can be acquired Location MFReplicationInfo Information about copy pairs consisting of mainframe volumes GetStorageArray (subtarget=MFReplicationInfo) , page 164 Path Information about paths GetStorageArray (subtarget=Path) , page 168 PDEV Information about PDEVs GetStorageArray (subtarget=PDEV) , page 172 Information about pools GetStorageArray (subtarget=Pool) , page 174 Pool (for Snapshot, Fast Snap, Continuous Access Journal Software, or Thin Provisionin
Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information The following information about host storage domains can be acquired: HostStorageDomain • FreeLUN: Information about LUNs that can be assigned to the host storage domains hsdsubinfo • Path: Path information • VHostStorageDomain: Virtual information about the host storage domains • WWN: WWN information The following information about LDEVs can be acquired: LDEV ldev
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
Information to acquire Command specification Information about paths and WWNs for those paths Information about pools and logical units for those pools GetStorageArray subtarget=Path pathsubinfo=WWN,HostInfo GetStorageArray subtarget=Pool poolsubinfo=LogicalUnit For details about parameters other than the parameter subtarget and the subinfo parameters, see “GetStorageArray (subtarget not specified) ” on page 132 to “GetStorageArray (subtarget=ReplicationInfo) ” on page 186.
# Do not set saobjid together with serialnum and model. Doing so will result in an error. Omitting all three parameters will cause all of the storage systems to be targeted. 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.
multipathSupport=1 securityStatus=2 sequenceNumber=10007 displayArrayFamily=R600 displayArrayType=R600 numberOfLUs=3,412 numberOfAllocatedLUs=1,739 numberOfUnallocatedLUs=1,671 slprStatus=0 openTotalCapacity=6,520,600,283 openAllocatedCapacity=2,990,258,073 openFreeCapacity=3,530,342,210 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=418,309,920 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocated
Parameters Table 49 GetStorageArray (subtarget=ArrayGroup) command parameters Parameter name Status Description subtarget Required Specify ArrayGroup. 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, you will obtain information about the models of all storage systems.
Parameter name Status Description Number of parity groups for which information is to be obtained numOfElementsFilter Optional Specify this parameter when you want to obtain information for a part of parity groups in a specific storage system. Specify the number of parity groups 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.
number=0 displayName=1-1-1 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 substance=0 slprNumber=-1 clprNumber=-1 cuInfo= openTotalCapacity=418,184,640 openAllocatedCapacity=266,772,960 openFreeCapacity=149,008,320 openAutoLunCapacity=2,403,360 openOnDe
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_ArrayGroup.log" subtarget=ArrayGroup model=XP1024 serialnum=10001 objectid=***** *****: The value is encoded by the CLI. Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 *****: The value is encoded by the CLI. GetStorageArray (subtarget=CommParameters) GetStorageArray (subtarget=CommParameters) obtains information about how to access storage systems (including SMI-S Enabled storage systems).
Do not set saobjid together with serialnum and model. Doing so will result in an error. Omitting all three parameters will cause all of the storage systems to be targeted. 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.
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter.
largestFreeSpaceInKB=489,664,512 multipathSupport=1 securityStatus=2 sequenceNumber=10007 displayArrayFamily=R600 displayArrayType=R600 numberOfLUs=3,412 numberOfAllocatedLUs=1,739 numberOfUnallocatedLUs=1,671 slprStatus=0 openTotalCapacity=6,520,600,283 openAllocatedCapacity=2,990,258,073 openFreeCapacity=3,530,342,210 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=418,309,920 mfAutoLunCapacity=0
name=DKC Environment value=3 description=Serious An instance of Component name=DKC Fan value=1 description=Normal An instance of Component name=DKC Power Supply value=1 description=Normal An instance of Component name=DKC Processor value=4 description=Moderate An instance of Component name=DKC Shared Memory value=1 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 F
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter.
Parameter values to obtain in advance None. Command execution example In this example, the GetStorageArray (subtarget=Filter) command obtains information about the storage system for the logical unit (object ID: *****). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Filter.log" subtarget=Filter objectID=***** *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP1024@172.16.45.
openAllocatedCapacity=1,578,120,480 openFreeCapacity=2,442,665,520 openAutoLunCapacity=4,806,720 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=563 numberOfOpenUnallocatedLUs=990 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=0 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 pro
Parameter name Status model Optional Description Model of the storage system If you omit this parameter, all the storage systems become the target. Object ID of a parity group that has unused capacity arraygroupobjid Optional Specify this parameter when you want to obtain information about the unused capacity of a specific parity group. If you specify this parameter, you must also specify the model and serialnum parameters.
Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
cylinders=0 fsControlIndex=85 . . (repeated for other ArrayGroup instances) . *****: The values are encoded by the CLI. Command execution example 2 In this example, the GetStorageArray (subtarget=FreeSpace) command obtains information about the unused capacity in a parity group (objectID: *****) that belongs to a storage system (serial number: 10001, model: XP1024). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_FreeSpace.
imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=134,588,160 openUnallocatedCapacity=76,943,520 openUnallocatedActualCapacity=76,943,520 openReservedCapacity=0 openReservedActualCapacity=0 type=0 volumeType=-1 encrypted=-1 protectionLevel=-1 thpPoolID=-1 List of 1 FreeSpace elements: An instance of FreeSpace objectID=***** sizeInKB=1,492,992 cyli
Parameter name Status Description Domain ID of the host storage domain If you omit this parameter, all the host storage domains become the target. If you specify this parameter, you must also specify the model and serialnum parameters. This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. domain Optional The execution results are output in decimal. If you specify this parameter, you must also specify the port or portname parameter.
Parameter name Status Description Starting sequence number of host storage domains for which information is to be obtained Specify this parameter when you want to obtain information for a part of host storage domains for a specific storage system. startElementNumFilter Optional When host storage domain information is ordered as shown below and numbered from 0 upward, specify the first number in the sequence of host storage domains that you want to obtain. Order of host storage domains: 1.
Command execution example In this example, the GetStorageArray (subtarget=HostStorageDomain) command obtains information about a host storage domain (port number: 3, domain ID: 1) in a storage system (serial number: 10001, model: XP1024). The information includes information about the paths, WWNs, and unused LUNs in the host storage domain. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_HostStorageDomain.
GetStorageArray (subtarget=LDEV) GetStorageArray (subtarget=LDEV) obtains the information about LDEVs. Parameters Table 56 GetStorageArray (subtarget=LDEV) command parameters Parameter name Status Description subtarget Required Specify LDEV. serialnum Optional model Optional Serial number of the storage system If you omit this parameter, all the storage systems become the target. Model of the storage system If you omit this parameter, all the storage systems become the target.
Parameter name Status Description Filter used for selecting the LDEV ldevfilter Optional Available values are OPEN, INTERMEDIATE, and MAINFRAME, which are not case-sensitive. To specify two or more values, separate them with semicolons (;). If you omit this parameter, all LDEVs are displayed. If you specify OPEN, the LDEVs for an open volume will be displayed. If you specify INTERMEDIATE, the LDEVs for an intermediate volume will be displayed.
devNum value appears under An instance of LDEV. Use this devNum value to specify the devnum parameter. Command execution example In this example, the GetStorageArray (subtarget=LDEV) command obtains information about a specific LDEV (device number: 0) in a storage system (serial number: 10001, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LDEV.
threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 List of 1 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=10001 mappedDevNum=0 displayMappedDevNum=00:00 externalArrayType=XP12000 externalSerialNumber=10002 externalDevNum=150 displayExternalDevNum=00:96 externalVolumeName=0096 productName=12000 vendor=HP *****: The values are encoded by the CLI.
hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_LogicalDKC.log" subtarget=LogicalDKC model=XP24000 serialnum=12345 Command execution result RESPONSE: An instance of StorageArray objectID=***** name=XP24000 @10.208.115.221 description=XP24000 (12345) at 10.208.115.
mfAutoLunCapacity=23,239,440 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=589 numberOfOpenUnallocatedLUs=3,799 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=14 numberOfMfLDEVs=327 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,176,711,367 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=0 openAllocatedActualCapacity=663,807,296 openUnallocatedCapacity=7,227,624,640 openUnallocatedActualCapacity=6,090,395,200
Parameter name Status Description Filter for selecting a logical unit Available values are ALL, ASSIGNED, FREE, UNASSIGNED, and RESERVED. If you omit this parameter or specify ALL, you will obtain information about all the logical units. If you specify ASSIGNED, you will obtain the information about the logical units that have a LUN assigned. lufilter Optional If you specify FREE, you will obtain the information about logical units that do not have a LUN assigned.
Parameter name Status Description Filter for selecting a THP/Smart volume Specify either the pool ID of a THP/Smart pool, or Unassigned. If you specify the pool ID of a THP/Smart pool, information about the THP/Smart volumes assigned to that THP/Smart pool is obtained. thpvolfilter Optional If you specify Unassigned, information about THP/Smart volumes not assigned to a THP/Smart pool is obtained. This information cannot be obtained by the partitioned storage administrator.
Parameter name Status Description Label name of logical units for which information is to be obtained label Optional Specify this parameter to obtain information about logical units for which a specific label is specified. You can specify only one label. If you specify this parameter, you must also specify lusubinfo=LDEV. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-1-17 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=1 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControl
chassis=1 arrayGroup=16 arrayGroupName=1-1-17 path=true onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=Simplex mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=-1 tieringPolicy=-1 resourcePartitionUnitID=-1 List of 1 VolumeConnection ele
NOTE: • For XP24000/XP20000 and XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain all the information about paired volumes and external volumes. • For XP24000/XP20000, if there is information about copy pairs consisting of mainframe volumes, microcode version 60-01-6X-XX/XX or later is required. Parameters Table 59 GetStorageArray (subtarget=MFReplicationInfo) command parameters Parameter name Status Description subtarget Required Specify MFReplicationInfo.
Parameter name Status Description Number of mainframe-volume copy pair information items to be obtained. numOfElementsFilter Optional Specify this parameter to obtain information for copy pairs of some mainframe volumes from a specific storage system. This parameter must be specified together with the startElementNumFilter, model, and serialnum parameters. The maximum recommended value is 16384.
displaySvolDevNum=00:0D:05 svolObjectID=***** svolPoolID=-1 replicationFunction=ShadowImageForMF status=1 muNumber=3 List of 2 Ldev elements: An instance of LDEV objectID=***** devNum=3,332 displayName=00:0D:04 emulation=3390-3 cylinders=3,339 isComposite=0 sizeInKB=2,904,930 lba=5,809,860 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=58 chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cac
chassis=2 arrayGroup=32 arrayGroupName=2-3-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=1 status=Normal thpType=-1 consumedSizeInKB=2,904,930 mfTrueCopyVolumeType=Simplex mfShadowImageVolumeType=S-VOL mfUniversalReplicatorVolumeType=Simplex mfUniversalReplicatorPoolID=-1 thpPoolID=-1 threshold=-1 systemDisk=0 encrypted=0 tieringPolicy=-1 resourcePartitionUnitID=-1 *****: The values are encode
Parameter name Status Description Object ID of the path objectid Optional Specify this parameter when you want to obtain information about a specific path. 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 paths for the specified storage system is obtained. Specify the object ID obtained from another CLI response. The value is encoded by the CLI.
Parameter name Status Description Port ID of the storage system Optional port 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 portname parameter. If they are specified at the same time, an error will occur.
Obtain this value from the execution result of the GetStorageArray (subtarget=Path) command. Execute this command by specifying only the model and serialnum parameters, and Path for the subtarget parameter. In the execution result of this command, the required objectID value appears under An instance of Path. Use this objectID value to specify the objectid parameter.
. (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). The information includes information about the WWNs of this path and the host. hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_Path.
Parameters Table 61 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.
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.0) that is in a storage system (serial number: 10001, model: XP1024). hdvmcli GetStorageArray -o "D:\logs\GetStorageArray_PDEV.log" subtarget=PDEV model=XP1024 serialnum=10001 pdevid=1 arraygroupobjid=***** *****: The value is encoded by the CLI.
NOTE: • When SLPR functionality is used in XP24000/XP20000 or XP12000/XP10000/SVS200, the partitioned storage administrator cannot obtain information about the pool even if he or she registers the storage system (SLPR) as a target to be managed by Device Manager. • Information about a journal volume to be stored in the pool appears as the LogicalUnit instance. This information can be obtained only when a journal volume is an open volume.
Parameter name Status Description Pool ID of the pool poolid Optional If the model or serialnum parameter is omitted, the specification for this parameter becomes invalid. You must specify the poolid and poolfunction parameters together. If the poolfunction parameter is omitted, the specification for this parameter becomes invalid. Information about the pool The values you can specify are LDEV, LogicalUnit, PairedPool, PoolTier, and ReplicationInfo. Use a comma to delimit multiple values.
Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolFunction value appears under An instance of Pool. Use this value to specify the poolfunction parameter. poolid Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter.
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 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,024 displayName=0B:D0 emul
emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 arrayGroupName=2-4-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=0 thpType=-1 consumedCapacityInKB=
monitoringState=-1 lastMonitorStartDate=-1 lastMonitorEndDate=-1 relocationState=-1 relocationProgress=-1 numberOfTiers=-1 thresholdRepDepAlert=-1 thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType=XP12000 pvolDevNum=3,033 displayPvolDevNum=0B:D9 pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053
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 sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=1 thpType=-1 con
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. Number of the port of the storage system Optional port Specify this parameter when you want to obtain information about a specific port. If port and portname are omitted, information about all ports is displayed.
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 GetStorageArray (subtarget=Port) command obtains information about a port (port number: 9) in a storage system (serial number: 10007, model: XP24000).
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. Parameters Table 64 GetStorageArray (subtarget=PortController) command parameters Parameter name Status Description subtarget Required Specify PortController.
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 65 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.
devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2-1 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=P-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 thr
thpPoolID=-1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 . . (repeated for other ReplicationInfo instances) . *****: The values are encoded by the CLI. GetStorageArray (subtarget=TieringPolicy) GetStorageArray (subtarget=TieringPolicy) obtains information about tiering policies that can be applied to Smart volumes of P9500. NOTE: If the microcode version of P9500 is not 70-05-00-XX/XX or later, some attributes cannot output valid values.
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 In this example, the GetStorageArray (subtarget=TieringPolicy) command obtains information about the tiering policy with ID 10 (policyid: 10) for a storage system (serial number: 53039; model: P9500).
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. ID of a resource group used for data migrations that use virtual IDs vrpuid Optional vfamily Optional vserialnum Optional Specify this parameter when you want to obtain information about a specific resource group.
Parameter name Status Description Virtual device number of the LDEV Specify this parameter when you want to obtain information about a specific virtual LDEV. vdevnum 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.
Parameter name Status Description Number of LDEVs for which information is to be obtained Specify this parameter when you want to obtain virtual information about only some of the LDEVs in a specific storage system. numOfVldevElementsFilter Optional If you specify this parameter, you must also specify the model, serialnum, vrpusubinfo, and startVldevElement NumFilter parameters. For the vrpusubinfo parameter, specify VLDEV. The maximum recommended value is 4096.
onDataMigration=true List of 1 VPort elements: An instance of VPort objectID=**** resourcePartitionUnitID=1 portID=138 vArrayFamily=**** vSerialNumber=10007 vPortID=64 vPortName=CL9-A vWWPortName=50060E8005271780 vFibreAddress=205 List of 255 VHostStorageDomain elements: An instance of VHostStorageDomain objectID=**** resourcePartitionUnitID=1 portID=138 domainID=0 vArrayFamily=**** vSerialNumber=10007 vPortID=-1 vDomainID=-1 An instance of VHostStorageDomain objectID=**** resourcePartitionUnitID=1 portID=1
NOTE: This command can be used only with P9500. Parameters Table 68 GetTieredPoolStatus command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system List of pool IDs poolids Required Specify the pool ID of a Smart pool. Use a comma to delimit multiple values. The maximum number of pool IDs that can be specified is 128.
List of 1 Pool elements: 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=enable autoMigration=disable mig
NOTE: This command can be used only with P9500 and XP24000/XP20000. The microcode version required for XP24000/XP20000 is 60-07-00-XX/XX or later.
devCount=1 devType= capacityInKB=1,049,280 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=16,485 arrayGroup=0 arrayGroupName=X1-1 raidType=currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=5 t
Parameter name Status Description model Required Model of the storage system Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. Command execution example hdvmcli ModifyArrayReservation -o "D:\logs\ModifyArrayReservation.
Parameter name Status Description Specify the device number of the logical unit of the THP/Smart pool volume whose external LDEV tier rank is changed to High. highdevnums Optional# Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0. Use a comma to delimit multiple values.
and serialnum parameters, Pool for the subtarget parameter, and LogicalUnit for the poolsubinfo parameter. In the execution result of this command, the devNum value of LogicalUnit appears under An instance of LogicalUnit. Specify the devNum value of a logical unit, for which the external LDEV tier rank is changed from the THP/Smart pool volume in a THP/Smart pool, to a parameter such as highdevnums, middledevnums, or lowdevnums.
journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,784 thpPoolID=57 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=0 managementAreaPoolID=-1 externalTierRank=High List of 1 PoolTier elements: An instance of PoolTier objectID=***** tierID=0 capacityInKB=6,150,144 freeCapacityInKB=6,064,128 usageRate=1 raidLevel=Unknown combination=Unknown rpm=-1 diskType=-1 substance=1 bufSpaceForNewPageAssignment=8 bufSpaceForTierRelocation=2 *****: The values are encoded by the CLI.
Parameter name Status Description Label character string You can use the following characters: label Required A-Z a-z 0-9 ! # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ] ^ _ ` { | } ~ and spaces You can use a character string of 1-64 bytes for a label. A label character string cannot begin or end with spaces. When used with the GUI, follow the GUI specification rules. Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Format hdvmcli [URL] ModifyLogicalUnit [options] serialnum=serial-number model=model devnum=device-number {commanddevice={true|false}|commanddevicesecurity={true|false}} Parameters Table 73 ModifyLogicalUnit command parameters Parameter name Status Description serialnum Required Serial number of the storage system of the LU model Required Model of the storage system of the LU Device number of the LU For P9500 and XP24000/XP20000: Required devnum Specify this parameter as a decimal number or colo
Command execution example hdvmcli ModifyLogicalUnit -o "D:\logs\ModifyLogicalUnit.log" "serialnum=10001" "model=XP1024" "devnum=1" "commanddevice=true" Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
NOTE: • This command can be used only with P9500 and XP24000/XP20000. • The attributes of the Pool instance, thresholdVolForewarn and thresholdVolOverwarn, which were output as the execution results of this command, have changed to overProvisioningWarning and overProvisioningLimit, respectively. Check and, if necessary, revise the script settings that you use in version 6.3 or later.
Format for XP24000/XP20000 When the command is used to expand a THP pool: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID adddevnums=device-number-of-logical-unit [threshold=THP-pool-threshold-1] [overprovisioningwarning=over-provisioning-warning-threshold] [overprovisioninglimit=over-provisioning-limit-threshold] When changing the thresholds only: hdvmcli [URL] ModifyPool [options] model=model serialnum=serial-number poolid=pool-ID [threshold=THP-pool-threshold-1] [ov
Parameter name Status Description Threshold2 of the THP/Smart pool (%) The threshold2 of the THP/Smart pool is the usage rate of the THP/Smart pool. The following values can be specified when modifying the threshold value: For P9500 whose microcode version is earlier than 70-014X-XX/XX: Optional threshold2#1 (P9500) A value cannot be specified for threshold2. For P9500 whose microcode version is 70-01-4X-XX/XX or later: If you specify this parameter, threshold2mode must be set to 1.
Parameter name Status Description Over provisioning limit threshold (%) This is a threshold value related to the over-provisioning percent.#4 The following values can be specified when modifying the threshold value: For P9500: Specify an integer from 0 to 65534. You need to specify a value larger than the one specified for overprovisioningwarning. Specify -1 to cancel an already set threshold value.
Parameter name Status Description Execution cycle of performance monitoring and hardware tier relocation This parameter can be specified when automigration is set to enable. One of the following values can be specified. migrationinter- Optional val#1, #5 (P9500) • 0: 30 minutes • 1: 1 hour • 2: 2 hours • 4: 4 hours • 8: 8 hours • 24: 24 hours You can specify 0 only when the microcode version is 70-02-XX-XX/XX or later.
Parameter name Status Description Buffer space for new page assignment (%) Specify the percent of the space prepared for assignment of new pages for each hardware tier of a Smart pool. Before you specify this parameter, check how many hardware tiers the Smart pool has. You can check the number of hardware tiers by using the GetStorageArray (subtarget=Pool) command. You can specify an integer from 0 to 50.
#1 For P9500, you need to specify at least one of the following parameters: threshold, threshold2, threshold2mode, overprovisioningwarning, overprovisioninglimit, adddevnums, tiercontrol, automigration, migrationinterval, monitorstarttime, monitorendtime, or monitoringmode. #2 For XP24000/XP20000, you need to specify at least one of the following parameters: threshold, overprovisioningwarning, overprovisioninglimit, or adddevnums.
hdvmcli ModifyPool -o "D:\logs\ModifyPool.log" model=P9500 serialnum=53039 poolid=5 adddevnums=00:07:CF Command execution result 1 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,998 displayName=00:07:CE emulation=OPEN-V devCount=1 devType= capacityInKB=10,485,760 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=16 arrayGroupName=2-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 co
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,485,760 thpPoolID=5 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=2 managementAreaPoolID=-1 *****: The values are encoded by the CLI.
raidLevel=RAID5 combination=3D+1P rpm=7,200 diskType=4 substance=0 bufSpaceForNewPageAssignment=30 bufSpaceForTierRelocation=20 An instance of PoolTier objectID=***** tierID=2 capacityInKB=8,386,560 freeCapacityInKB=8,386,560 usageRate=0 raidLevel=Unknown combination=Unknown rpm=-1 diskType=-1 substance=1 bufSpaceForNewPageAssignment=30 bufSpaceForTierRelocation=40 *****: The values are encoded by the CLI. ModifyPort ModifyPort modifies port attributes and host storage domain attributes.
[fibreaddr=new-fibre-channel-address-for-the-port] [channelspeed={0|1|2|4|8}] [lunsec={true|false}] [domain=domain-ID] [nickname={new-host-storage-domain-name|existing-host-storage-domain-name}] [newdomainnickname=new-host-storage-domain-name]] [hostmode=host-mode-for-port] [hostmodeoption=host-mode-option-list] [wwn=WWN wwnnickname=WWN nickname] [wwn=WWN newwwnnickname=new-WWN-nickname] [wwnnickname=WWN-nickname newwwnnickname=new-WWN-nickname] NOTE: 8 Gbps can be specified only for P9500 or XP24000/XP200
Parameter name Status Description model Required Model of the port's storage system Number of the port port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name portname Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. New topology value for the port Possible values are as follows.
Parameter name Status Description Specify the nickname of the host storage domain. The value specified for this parameter differs depending on whether domain is specified. If domain is specified: Specify the new nickname of the host storage domain. If domain is not specified: Specify the nickname of the host storage domain. You can use the following characters: A-Z a-z 0-9 ! # $ % & ' ( ) + - . = @ [ ] ^ _ ` { } ~ and spaces nickname Optional A nickname cannot begin or end with spaces.
Parameter name Status Description The WWN that is used to provide security for the host storage domain To specify two or more WWNs, separate them with commas. wwn Optional If you specify this parameter, you must also specify the domain or nickname parameter. If you specify this parameter, you must also specify the wwnnickname or newwwnnickname parameter. You must specify the same number of values for each parameter.
Parameter name Status Description New nickname of the WWN newwwnnickname Optional If you specify this parameter, you must also specify the domain or nickname parameter. If you specify this parameter, you must also specify the wwn or wwnnickname parameter. You must specify the same number of values for each parameter. # The topology and channelspeed parameters cannot be used when an FCoE connection is used.
Command execution example In this example, the ModifyPort command modifies the settings for a port (port number: 16) of a storage system (serial number: 10001, model: XP1024) as follows. The command: • changes the value for the hostmode parameter to Standard, for the port's host storage domain (domain ID: 0) • changes the topology to Fabric(off), FC-AL • sets the Fibre Channel address to 73 • disables LUN security by specifying false • sets the transmission speed of the Fibre Channel to 1.
nickname=Jane An instance of WWN WWN=11.33.22.33.44.33.22.22 nickname=Jone An instance of WWN WWN=55.66.77.88.44.33.22.22 nickname= *****: The values are encoded by the CLI. ModifyPortController ModifyPortController supports changing characteristics of a PortController. NOTE: This command can be used only with XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128.
Obtain this value from the execution result of the GetStorageArray (subtarget=PortController) command. Execute this command by specifying only the model and serialnum parameters, and PortController for the subtarget parameter. In the execution result of this command, the controllerID value appears under An instance of PortController. Use this controllerID value to specify the ctrlid parameter.
hdvmcli [URL] ModifyStorageArray [options] saobjid=object-ID-of-SMI-S-Enabled-storage-system name=new-storage-system-name Parameters Table 77 ModifyStorageArray command parameters Parameter name Status Description serialnum Optional# Serial number of the storage system. You cannot specify this parameter if the storage system is an SMI-S Enabled storage system. Model of the storage system model # Optional You cannot specify this parameter if the storage system is an SMI-S Enabled storage system.
Command execution result RESPONSE: An instance of StorageArray objectID=***** name=R600#1 description=R600 (10007) at 10.208.115.
numberOfImUnallocatedLUs=0 numberOfMfLDEVs=144 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,277,966,802 autoFormatLU=0 statusOfDBInconsistency=0 configUpdateStatus=1 openAllocatedActualCapacity=2,990,258,073 openUnallocatedCapacity=3,528,243,650 openUnallocatedActualCapacity=3,528,243,650 openReservedCapacity=2,098,560 openReservedActualCapacity=2,098,560 numberOfReservedLUs=2 numberOfOpenReservedLUs=2 numberOfImReservedLUs=0 distributedMode=-1 *****: The value is e
Parameter name Status Description Maximum allocation threshold value (%) for Tier 1 allocationthresholdt1max#1 Optional#2 Specify the maximum capacity threshold value to be allocated for Tier 1 of virtual volumes to which the tiering policy has been applied. You can specify 0 or a multiple of 10, in the range from 0 to 100.
• Changes the maximum allocation threshold for Tier 3 to 40 (allocationthresholdt3max: 40) • Changes the minimum allocation threshold for Tier 3 to 10 (allocationthresholdt3min: 10) hdvmcli ModifyTieringPolicy model=P9500 serialnum=53039 allocationthresholdt1max=50 allocationthresholdt3max=40 -o "D:\logs\ModifyTieringPolicy.log" policyid=10 allocationthresholdt1min=20 allocationthresholdt3min=10 Command execution result RESPONSE: An instance of StorageArray . .
• If you are assigning a THP volume to a THP pool, the status of the THP pool must not be Blocked. • If you are assigning a THP pool, the over-provisioning percent must be less than the over provisioning limit threshold. • If you are releasing a THP volume from a THP pool, or if you are only changing the threshold value, the THP volume must already be assigned to a THP pool. • If you are releasing a THP volume from a THP pool, it must not have a path.
hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number assign=false devnums=device-number-of-THP-volume When the command is used to change the usage rate threshold of THP volumes: hdvmcli [URL] ModifyVirtualVolume [options] model=model serialnum=serial-number devnums=device-number-of-THP-volume threshold=usage-rate-threshold-of-THP-volumes Parameters Table 79 ModifyVirtualVolume command parameters Parameter name Status Description serialnum Required Serial number of the stora
Parameter name Status Description Tiering policy to be applied to Smart volumes.
value of an LDEV appears under An instance of LDEV. Use this devNum value to specify the devnums parameter. poolid Obtain this value from the execution result of the GetStorageArray (subtarget=Pool) command. In the execution result of this command, the poolID value appears under An instance of Pool. Use this value to specify the poolid parameter.
thpPoolID=0 threshold=15 tcaPoolID=-1 thpPoolVolControlFlag=-1 managementAreaPoolID=-1 *****: The value is encoded by the CLI. Command execution example 2 In this example, the ModifyVirtualVolume command changes the tiering policy for Smart volumes to level 1. hdvmcli ModifyVirtualVolume -o "D:\logs\ModifyVirtualVolume.log" model=P9500 serialnum=15000 devnums=00:00:C4 tieringpolicy=1 Command execution result 2 RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=-1 systemDisk=0 encrypted=-1 thpTier0ConsumedCapacityInKB=0 thpTier1ConsumedCapacityInKB=0 thpTier2ConsumedCapacityInKB=-1 tieringPolicy=1 tierRelocation=enable resourcePartitionUnitID=0 *****: The value is encoded by the CLI.
slotSizeInKB=256 chassis=16,486 arrayGroup=99 arrayGroupName=X2148-1 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=-1 slprNumber=-1 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=0 consumedSizeInKB=0 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown mfUniversalReplicatorPoolID=-1 thpPoolID=0 threshold=-1 systemDisk=0 encrypted=-1 thpTier0ConsumedCapacityInKB=0 thpTier1ConsumedCapaci
When refreshing performance information for all storage systems: hdvmcli [URL] RefreshPerformanceData [options] option=all Parameters Table 80 RefreshPerformanceData command parameter Parameter name Status Description serialnum Optional# Serial number of the storage system model Optional# Model of the storage system option # Optional Parameter used to refresh performance information for all storage systems The value you can specify is all, which is not case-sensitive.
Execute this command regularly to keep the Device Manager server database up to date. For storage systems that are managed by Device Manager, configuration information that is created or modified from the Remote Console, Remote Web Console, or RAID Manager is added to or updated in the Device Manager server database each time this command is executed. NOTE: To specify a storage system and then refresh its configuration information, use the AddStorageArray command.
largest numberOfLUs and numberOfMfLDEVs values when added together and plug those values into the following formula to calculate the value to specify for maxldevs: (numberOfLUs + numberOfMfLDEVs) x number-of-storage-systems-to-refreshin-parallel Command execution example hdvmcli RefreshStorageArrays -o "D:\logs\RefreshStorageArrays.log" "interval=1440" Command execution result RESPONSE: [An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Zero-page reclaim operations can be performed on P9500 (with a microcode version of 70-0200-XX/XX or later), and XP24000/XP20000. • The THP/Smart volumes are in a Business Copy Software copy pair. Zero-page reclaim operations can be performed on P9500 (with a microcode version of 70-0502-XX/XX or later ) when the status of the pair volumes is Split (that is, status for the ReplicationInfo instance is 16).
. . (Attributes of StorageArray are omitted here) .
NOTE: This command can be used only with P9500. Parameters Table 83 ShrinkPool command parameters Parameter name Status Description serialnum Required Serial number of the storage system model Required Model of the storage system poolid Required Pool ID Specify the pool ID of the THP/Smart pool to be shrunk.
Command execution example In this example, the ShrinkPool command shrinks the THP/Smart pool for the pool volume (devnum: 00:06:0B) that belongs to the THP/Smart pool whose pool ID is 1 (poolid: 1) in the storage system (serial number: 53039, model: P9500). hdvmcli ShrinkPool -o "D:\logs\ShrinkPool.log" model=P9500 serialnum=53039 poolid=1 devnums=00:06:0B Command execution result RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
thresholdRepDataReleased=-1 userUsedCapacityInKB=-1 repDataCapacityInKB=-1 repManageCapacityInKB=-1 numberOfThpVols=-1 capacityOfThpVolsInKB=-1 List of 31 Lu elements: An instance of LogicalUnit objectID=***** devNum=1,546 displayName=00:06:0A emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 arrayGroupName=1-2 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 c
isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=1 consumedCapacityInKB=10,486,080 thpPoolID=1 threshold=-1 tcaPoolID=-1 thpPoolVolControlFlag=1 managementAreaPoolID=-1 . . (repeated for other LogicalUnit instances) . *****: The value is encoded by the CLI.
Parameter name subtarget Status Optional Description Specify this parameter if you want to obtain information about an element in addition to information about the logical group. The only value that can be specified is Path. This setting is not case sensitive. Parameter values to obtain in advance objectid Obtain this value from the execution result of the GetLogicalGroup command. In the execution result of this command, the objectID value appears under An instance of LogicalGroup.
. (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.
An instance of LogicalGroup objectID=***** name=snow description= parentID=***** logicalPath=root/snow capacity=2 capacityInKB=2,098,560 realCapacityInKB=2,098,560 percentUsed=0 numberOfLUNs=1 resourceType=2 specificationType=0 . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. LUN commands The LUN commands can be used to manage LUN groups, set up WWNs, and set paths from a host to a volume. AddLun AddLun sets paths from a host to a volume.
Parameters Table 85 AddLun command parameters Parameter name Status Description serialnum Required Serial number of the new path's storage system model Required Model of the new path's storage system Name of the new path Optional name You can use a character string of 1-64 bytes for a name. Spaces at the beginning or end of a name are not registered. Port number of the new path Optional port Specify either port or portname. Do not specify both parameters at the same time.
Parameter name Status Description Device number used to identify the new path (not provided when a LUSE is defined) For P9500 and XP24000/XP20000: Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
ageDomain. Use these portID values to specify the port parameter. Use the domainID value to specify the domain parameter, or use the nickname value to specify the domainnickname parameter. For the lun parameter, specify one of the lun values that appear under An instance of FreeLUN. portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port.
displayName=03:E9 emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 arrayGroupName=3-2-1 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=0 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 mfTrueCopyVolumeType=Unknown mfShadowImageVolumeType=Unknown mfUniversalReplicatorVolumeType=Unknown
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 resourcePartitionUnitID=-1 *****: The values are encoded by the CLI. Command execution example 2 hdvmcli AddLun -o "D:\logs\AddLun.
NOTE: When security is set for a host storage domain, the LUN security setting of a port to which the host storage domain belongs is automatically enabled. Make sure that the I/Os of the target port are stopped.
Parameter name Status Description Comma-separated list of WWNs to secure the host storage domain Required wwn If you use the HostScan command to register a host in Device Manager, every WWN that you specify in the wwn parameter must be a WWN used by that host only. In this case, the value specified for the domainnickname parameter is used as the name of the host. For details about the HostScan command, see “HostScan” on page 286.
serialnum parameters, Port for the subtarget parameter, and WWN for the portsubinfo parameter. In the execution result of this command, the wwn value appears under An instance of WWN. Use this wwn value to specify the wwn parameter. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command. Execute this command by specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter.
Parameters Table 87 DeleteLun command parameters Parameter name Status Description serialnum Required Serial number of the path's storage system model Required Model of the path's storage system Port number of the path Optional port Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name of the path portname Optional Specify either port or portname. Do not specify both parameters at the same time.
Obtain these values from the execution result of the GetStorageArray command. In the execution result, use the arrayType value or the displayArrayType value to specify the model parameter, and use the serialNumber value to specify the serialnum parameter. port, domain, and devnum Obtain these values from the execution result of the GetStorageArray (subtarget=Path) command. Execute this command by specifying only the model and serialnum parameters, and Path for the subtarget parameter.
Parameter name Status Description Port name portname Optional wwn Required Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. WWN to delete from the port Parameter values to obtain in advance serialnum and model Obtain these values from the execution result of the GetStorageArray command.
Parameters Table 89 DeleteWWNForHostStorageDomain command parameters Parameter name Status Description serialnum Required Serial number of the storage system for the host storage domain model Required Model of the storage system for the host storage domain Port ID of the host storage domain port Optional Specify either port or portname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur.
domain, port, and wwn Obtain these values from the execution result of the GetStorageArray (subtarget=HostStorageDomain, hsdsubinfo=WWN) command. Execute this command by specifying only the model and serialnum parameters, HostStorageDomain for the subtarget parameter, and WWN for the hsdsubinfo parameter. In the execution result of this command, the domainID and portID values appear under An instance of HostStorageDomain.
AddHost AddHost adds information about a host server to the Device Manager server. NOTE: This command does not support virtualization servers. To register a virtualization server, use the AddVirtualizationServer command. Parameters Table 90 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.
hostID=279 ipAddress=192.168.32.63 capacityInKB=0 hostType=-1 statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddHostInfo AddHostInfo adds host-based information about a LUN (information about storage used by hosts). NOTE: This command does not support virtualization servers.
Parameter name Status Description Device number of the path For P9500 and XP24000/XP20000: devnum Required Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
• HostInfo record name: MY_HOSTINFO_XP1024 • Host IP address: 172.16.64.159 • Mount point: C: • File system type: NTFS • File name: C: • SCSI bus number: 0 • Host LUN: 1 • HBA WWN: 11.22.33.44.55.66.77.88 • LUN size: 10MB • LUN in use: 10% hdvmcli AddHostInfo -o "D:\logs\AddHostInfo.log" serialnum=10001 model=XP1024 hostname=MY_HOSTINFO_XP1024 ipaddress=172.16.64.159 mountpoint=C: port=7 domain=0 devnum=2 osscsibus=0 osscsiid=15 oslun=1 portwwn=11.22.33.44.55.66.77.
NOTE: • This command does not support virtualization servers. To refresh the information of a virtualization server, use the RefreshVirtualizationServer command. • If the copy pair management host is unable to recognize a copy pair that was created on a host that is not the copy pair management host, the copy status of that copy pair cannot be refreshed even if the AddHostRefresh command is executed.
hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE: An instance of Host objectID=***** name=rise hostID=5 ipAddress=192.168.32.164 capacityInKB=0 hostType=-1 statusOfDBUpdating=0 *****: The value is encoded by the CLI. AddVirtualizationServer AddVirtualizationServer registers a virtualization server into the Device Manager server database by using vMA or Host Data Collector.
NOTE: • Device Manager uses vMA or Host Data Collector to register a virtualization server. - vMA: Can be used in VMware ESX 4.x or VMware ESXi 4.x. - Host Data Collector: Can be used in VMware ESX 4.x, VMware ESXi 4.x, or VMware ESXi 5.x. • The information collection method of a virtualization server that was registered with vMA can be switched to using Host Data Collector. However, management cannot be switched from management using Host Data Collector to management using vMA.
Parameters Table 93 AddVirtualizationServer command parameters Parameter name Status Description IP address ipaddress Required For details about specifiable values, see Table 94. You can specify an IPv4 or IPv6 IP address. Value indicating the host type hosttype Required Specify 3.
As shown in the following table, the values to be specified for the parameters ipaddress, hostprotocol, hostuserid, and hostuserpassword depend on the management environment of the virtualization server.
Command execution example 1 This example uses vMA (IP address: 10.208.119.114) to detect two virtualization servers (VMware ESX, host type: 3). The information about the detected virtualization servers will be registered into the Device Manager server database. hdvmcli AddVirtualizationServer -o "D:\logs\AddVirtualizationServer.log" ipaddress=10.208.119.
Command execution result 2 RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 2 WWN elements: An instance of WWN WWN=21.00.00.24.FF.2C.AE.19 An instance of WWN WWN=21.00.00.24.FF.2C.AE.18 List of 1 CommParameters elements: An instance of CommParameters hdcIPAddress=10.208.119.110 ipAddress=10.208.119.
Obtain this value from the execution result of the GetHost command. In the execution result of this command, the objectID value appears under An instance of Host. Use this objectID value to specify the objectid parameter. hostname Obtain this value from the execution result of the GetHost command. In the execution result of this command, the name value appears under An instance of Host. Use this name value to specify the hostname parameter.
Command execution example hdvmcli DeleteHostInfo -o "D:\logs\DeleteHostInfo.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result RESPONSE (Command completed; no data returned) GetHost GetHost returns the information about hosts. 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.
Parameters Table 97 GetHost command parameters Parameter name Status Description Object ID of the host to return Omit this parameter to include all hosts. objectid Optional Do not specify the hostname and hostfilter parameter at the same time. If they are specified at the same time, an error will occur. Name of the host to obtain information about Omit this parameter to include all hosts. hostname Optional Do not specify the objectid and hostfilter parameter at the same time.
Parameter name Status Description Specify this parameter if you want to obtain path information (the Path instance) about logical units. lusubinfo Optional Path is the only value that you can specify. If you specify this parameter, you must also specify subtarget=LogicalUnit. Specify this parameter if you want to obtain HostInfo information (HostInfo instance) about a path. pathsubinfo Optional HostInfo is the only value that you can specify.
WWN=11.44.77.22.55.88.33.66 nickname=Jone List of 1 ConfigFile elements: An instance of ConfigFile objectID=***** instanceNumber=11 controlledBy=Device Manager portNumber=50000 valid=1 List of 1 ReplicationGroup elements: An instance of ReplicationGroup objectID=***** replicationGroupID=3 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.
svolSerialNumber=65010001 svolDevNum=102 displaySvolDevNum=00:66 svolObjectID=***** svolPoolID=-1 replicationFunction=BusinessCopy status=1 muNumber=0 copyTrackSize=15 splitTime=-1 remotePathGroupID=0 pvolMngAreaPoolID=-1 svolMngAreaPoolID=-1 *****: The values are encoded by the CLI. Command execution example 2 In this example, specify MAINFRAME in the hostfilter parameter to obtain only the mainframe host information. hdvmcli GetHost hostfilter=MAINFRAME -o "D:\logs\GetHost.
Command execution result 3 RESPONSE: An instance of Host objectID=***** name=test hostID=1 capacityInKB=8,097,280 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 WWN elements: An instance of WWN WWN=10.00.00.00.C9.6F.EB.
devNum=1,008 portID=10 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true An instance of Path objectID=***** devNum=1,008 portID=11 domainID=7 scsiID=15 LUN=20 wwnSecurityValidity=true List of 1 HostInfo elements: An instance of HostInfo objectID=***** name=test serialNumber=10037 arrayType=XP24000 mountPoint= portID=11 portName=CL7-E domainID=7 scsiID=15 lun=20 devNum=1,008 displayDevNum=00:03:F0 osScsiBus=1 osScsiID=4 osLun=20 portWWN=10.00.00.00.C9.6F.EB.
Command execution result 4-1: when managing the virtualization server with vMA (IP address: 10.208.119.114) RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.0 build-171294 List of 1 WWN elements: An instance of WWN WWN=10.00.00.00.C9.6F.E8.FD List of 1 CommParameters elements: An instance of CommParameters ipAddress=10.208.119.
Command execution example 5 In this example, the command obtains information regarding the disk configuration of the virtualization server (hostname = ha8krs02). hdvmcli GetHost -o "D:\logs\GetHost_VM_Datastore.log" "hostname=ha8krs02" subtarget=VM,Datastore Command execution result 5 RESPONSE: An instance of Host objectID=***** name=ha8krs02 hostID=5 capacityInKB=0 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESXi 4.1.
An instance of Datastore datastoreID=[datastore-1191] vm2/vm2_1.vmdk name=[ds1] vm2/vm2_1.vmdk datastoreType=2 An instance of Datastore datastoreID=[datastore-1191] vm2/vm2_2.vmdk name=[ds1] vm2/vm2_2.vmdk datastoreType=2 An instance of Datastore datastoreID=datastore-1176 name=datastore1 datastoreType=1 An instance of Datastore datastoreID=datastore-1191 name=ds1 datastoreType=1 *****: The values are encoded by the CLI. GetHostInfo GetHostInfo returns the host-based information about a LUN.
Command execution result 1 RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.159 mountPoint=C: portID=7 portName=CL1-H domainID=0 scsiID=15 lun=3 devNum=3 displayDevNum=00:03 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 *****: The value is encoded by the CLI.
portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 . . (repeated for other HostInfo instances) . *****: The value is encoded by the CLI. HostScan HostScan registers (into the Device Manager server database) any host whose host name is the nickname of a host storage domain, and adds (to that host's information in the database) the WWN that was assigned to the host storage domain.
3. For each of the host storage domains (ordered as described in step 2), HostScan adds the WWNs detected in step 1 into the host information. The information is added for any host whose host name is the nickname of a host storage domain. However, if a corresponding host is not registered, the host is registered with a host name identical to a host storage domain nickname and then the information is added to the host information.
Command execution example hdvmcli HostScan -o "D:\logs\HostScan.log" model=XP12000 serialnum=14053 Command execution result RESPONSE: (Command completed; no data returned) ImportHosts ImportHosts imports information about hosts from the input files (CSV-format host information file and mapping definition file). This command also checks information in input files. The following describes the format of the ImportHosts command and its parameters.
hdvmcli [URL] ImportHosts [options] inputfile=host-information-file-name [mappingfile=mapping-definition-file-name] [resultfilepath=output-destination-of-error-information-file] function=import [overwrite={true|false}] Parameters Table 100 ImportHosts command parameters Parameter name Status Description Host information file name Use an absolute path or relative path to specify a CSV file that contains host information.
Parameter name Status Description Specifies whether to update (overwrite) information about a host already registered with Device Manager if another host that has the same name is specified. • true: Update • false: Do not update overwrite Optional If true is specified, only the hosts that were manually registered by using the Device Manager GUI or CLI (AddHost command or HostScan command) are updated. If this parameter is omitted, false is assumed.
• Number of hosts that can be imported but for which a warning was given Number of hosts that can be imported but for which a warning was issued Check the warnings issued to the error information output file, before importing hosts. Command execution example 2 In this example, the ImportHosts command with import specified for the function parameter imports information about hosts. hdvmcli ImportHosts "function=import" "inputfile=D:\work\hostImport.csv" "mappingfile=D:\work\import.
• External ports • Virtualization servers Parameters Table 101 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.
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 103 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.
domainID, and portID values appear under An instance of Path. Use these devNum, domainID, and portID values to specify the devnum, domain, and port parameters respectively. portname Obtain this value from the execution result of the GetStorageArray (subtarget=Port) command. In the execution result of this command, the displayName value appears under An instance of Port. Use this value to specify the portname parameter.
fileSystemType=NTFS1 fileSystemName=E: sizeInMB=156 percentUsed=50 lastUpdated=1039003476 *****: The value is encoded by the CLI. ModifyVirtualizationServer ModifyVirtualizationServer modifies information about virtualization servers. NOTE: • Device Manager uses vMA or Host Data Collector to manage information about virtualization servers. - vMA: Can be used in VMware ESX 4.x or VMware ESXi 4.x. - Host Data Collector: Can be used in VMware ESX 4.x, VMware ESXi 4.x, or VMware ESXi 5.x.
When switching the method of managing virtualization servers from using vMA to using Host Data Collector: hdvmcli [URL] ModifyVirtualizationServer [options] hostname=host-name-of-virtualization-server [ipaddress=IP-address-of-virtualization-server#] hostprotocol={Secure|Non-secure} [hostuserid=user-ID-of-virtualization-server#] [hostuserpassword=user-password-of-virtualization-server#] hdcipaddress=IP-address-of-Host Data Collector # Specify the value of VMware vCenter Server in a configuration in which VM
• To modify information about the virtualization servers managed by Host Data Collector, you need to specify at least one of the following parameters: ipaddress, hostprotocol, hostuserid, hostuserpassword, or hdcipaddress. #2 To switch the method of managing virtualization servers from using vMA to using Host Data Collector, you need to specify both the parameter hostprotocol and the parameter hdcipaddress.
Command execution result 1-2: when managing the virtualization server with Host Data Collector (IP address: 10.208.119.110) In the execution result, hdcIPAddress appears in the CommParameters instance, indicating that the virtualization server is being managed by Host Data Collector. RESPONSE: An instance of Host objectID=***** name=boss.boss hostID=13 capacityInKB=21,995,840 hostType=3 statusOfDBUpdating=0 virtualizationServerVersion=VMware ESX 4.0.
Command execution example 1 This example updates a virtualization server (host name:boss.boss). The execution result of the command differs depending on which method is used to manage the virtualization server. hdvmcli RefreshVirtualizationServer -o "D:\logs\RefreshVirtualizationServer.log" "hostname=boss.boss" Command execution result 1-1: when managing the virtualization server with vMA (IP address: 10.208.119.114) RESPONSE: An instance of Host objectID=***** name=boss.
hdcIPAddress=10.208.119.110 ipAddress=10.208.119.113 portNumber=443 protocol=Secure userID=root *****: The value is encoded by the CLI. Server management commands The Server Management commands provide some management support for the Device Manager server. 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.
Parameters Table 106 AddURLLink command parameters Parameter name Status Description URL of the application or Web page Required url The complete URL is required to launch the application or web page. If you specify the URL as an IPv6 IP address, enclose the IP address in square brackets ([ ]). Required name Name of the URLLink Object ID of the Device Manager object for which the URLLink is set linkedid Required Must be a valid, existing the object ID.
DeleteAlerts DeleteAlerts deletes alerts present on the Device Manager server. You can either delete a specific alert by specifying the alert number, or delete all alerts originating from a specific source by specifying the source. Parameters Table 107 DeleteAlerts command parameters Parameter name Status Description alertnum Optional# The number identifying the alert to delete source Optional# Identifies a source of alerts; all alerts from this source are deleted.
Command execution result 2 RESPONSE (Command completed; no data returned) DeleteURLLink DeleteURLLink deletes the URLLinks that is set for a Device Manager object managed by the Device Manager server. NOTE: This command does not support virtualization servers.
Parameter name Status Description Type of the Device Manager object from which the URLLink is deleted 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. #1 Specify either objectid or linkedid. Do not specify both parameters at the same time.
Parameter name Status Description Request only messages newer than the date and time. timefilter Optional Required format is YYYY/MM/DD HH:MM:SS. If you omit this parameter, the number of obtainable alerts is unlimited. Parameter values to obtain in advance None. Command execution example hdvmcli GetAlerts -o D:\logs\GetAlerts.
Command execution example hdvmcli GetServerInfo -o "D:\logs\GetServerInfo.log" Command execution result RESPONSE: An instance of ServerInfo buildVersion=Build 0750-nn (May 16, 2013) serverURL=http://localhost:2001 upTime=3 hours 23 minutes 9 seconds upSince=Thu, 16 May 2013 23:21:45 GMT currentApiVersion=7.
GetURLLink GetURLLink obtains information about the URLLinks that are set for a Device Manager object managed by the Device Manager server.
Parameter name Status Description Type of the Device Manager object for which the URLLink is set targetoption Optional# One of the following values can be specified. The values are not case-sensitive. • smi-s: SMI-S Enabled storage system • other: Device Manager object other than an SMI-S Enabled storage system # • If objectid, linkedid, and targetoption are all omitted, all URLLink information will be acquired for all of the Device Manager objects, regardless of the type.
AddConfigFileForReplication AddConfigFileForReplication creates the HORCM configuration file for RAID Manager that is required to create copy pairs for Business Copy Software, Continuous Access Synchronous Software, Continuous Access Asynchronous Software, Snapshot, and Continuous Access Journal Software. NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap.
|Snapshot|ContinuousAccessJournal} [munum=Mu-number] • Method 3: Creates a new RAID Manager configuration definition file.
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. For Snapshot: You must specify this parameter. For Continuous Access Asynchronous Software: pvolpoolid Optional You must specify this parameter. For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description 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 112 How to obtain parameter values (AddConfigFileForReplication command) No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management Specify the host on which the RAID Manager instance that manages the P-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile, and the groupName value under An instance of ReplicationGroup.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management First, execute the GetHost command with the host that manages the PVOL specified. The execution result of the GetHost command displays the values of valid and instanceNumber under An instance of ConfigFile (configuration definition file information).
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=LogicalUnit) with LogicalUnit specified for the subtarget parameter and the object ID of the logical unit to be used as the P-VOL or the S-VOL (the object ID recorded in No. 5) specified for the objectID parameter. pvolarraytype 6 pvolserialnum svolarraytype svolserialnum The execution result of the GetStorageArray (subtarget=LogicalUnit) command displays the specified object ID under An instance of LogicalUnit.
"pvoldevnum=5" "svolarraytype=XP12000" "svolserialnum=65010012" "svoldevnum=10" "replicationfunction=ContinuousAccessSync" Command execution result 1 RESPONSE (Command completed; empty list returned) Command execution example 2 This example creates a group in the configuration files, and then adds pairs to the group: hdvmcli AddConfigFileForReplication -o "D:\logs\AddConfigFileForReplication.
Journal Software. When you create a copy pair, the HORCM configuration file for RAID Manager, contained in the host, is rewritten. NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • Device Manager does not support a configuration in which both P-VOLs and S-VOLs exist in a single HORCM instance. Make sure all the volumes in a single HORCM instance are either all PVOLs or all S-VOLs. • You must specify a formatted LDEV.
[pvolpoolid=pool-ID] svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=port-number|svolportname=port-name] [svolpoolid=pool-ID] replicationfunction={BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync |Snapshot|ContinuousAccessJournal} [munum=Mu-number] [fencelevel=fence-level] [copytracksize=copy-pace] [pairoption=suspend] • Method 3: Create a new RAID Manager configuration definition file, creates a copy group, then adds a copy pair to the copy group.
Parameter name Status Description Number of the HORCM instance that manages the P-VOL pvolinstancenum Optional If you are using method 2, you must specify this parameter. If the replicationgroupid parameter is specified, this parameter is ignored. Port number of the HORCM instance that manages the P-VOL Depending on the host OS, specify the appropriate value: • For Solaris systems: Specify an integer in the range 0-65535.
Parameter name Status Description Port ID in the HORCM configuration file that manages the P-VOL paths pvolportid Optional If you specify this parameter, specify either pvolportid or pvolportname. Do not specify both parameters at the same time. If they are specified at the same time, an error will occur. Port name in the HORCM configuration file managing the P-VOL path pvolportname Optional If you specify this parameter, specify either pvolportid or pvolportname.
Parameter name Status Description Pool ID of the pool in which the differential data and journal data for the S-VOL is to be stored For Continuous Access Asynchronous Software: You must specify this parameter. svolpoolid Optional For Continuous Access Journal Software: You must specify this parameter when you are using method 2 or 3. For other cases, this parameter value is invalid even if you specify a value.
Parameter name Status Description pairoption Optional The following value can be specified only when XP12000/XP10000/SVS200 is being used: suspend: Creates a delta resync pair. Parameter values to obtain in advance Parameter values to obtain in advance depend on how you will create a copy pair. • When Method 1 is used: See No. 1, No. 4, and No. 5 in the table below. • When Method 2 is used: See No. 2, No. 3, No. 4, No. 5, and No. 6 in the table below. • When Method 3 is used: See No. 2, No. 4, No.
No. Parameter name How to obtain Execute the GetHost command with the host name indicated below specified for the hostname parameter. • When managing copy pairs by using local management To obtain the pvolhostid parameter value, specify the host on which the RAID Manager instance that manages the P-VOL is installed. To obtain the svolhostid parameter value, specify the host on which the RAID Manager instance that manages the S-VOL is installed.
No. Parameter name How to obtain Execute the GetHost command with LogicalUnit specified for the subtarget parameter and the name of the host that recognizes the P-VOL or the S-VOL specified for the hostname parameter. The execution result of the GetHost command displays the objectID value (object ID of the logical unit) and the devNum value under An instance of LogicalUnit.
No. Parameter name How to obtain Execute the GetStorageArray (subtarget=Pool) with Pool specified for the subtarget parameter, the model name specified for the model parameter, and the serial number specified for the serialnum parameter. The execution result of the GetStorageArray (subtarget=Pool) command displays the values of poolFunction and PoolID under An instance of Pool. 6 pvolpoolid svolpoolid If you execute the command with the values of pvolarraytype and pvolserialnum recorded in No.
copyTrackSize=15 List of 1 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pairName=HCMD_CP0004 pvolSerialNumber=6501001 pvolArrayType=XP1024 pvolDevNum=5 displayPvolDevNum=00:05 pvolObjectID=***** pvolPoolID=-1 svolSerialNumber=65010012 svolArrayType=XP1024 svolDevNum=10 displaySvolDevNum=00:0A svolObjectID=***** svolPoolID=-1 fenceLevel=Data replicationFunction=ContinuousAccessSync status=1 muNumber=-1 copyTrackSize=15 splitTime=-1 remotePathGroupID=-1 pvolMngAreaPoolID=-1 svolMngA
pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
Command execution result 3 RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=2 groupName=HCMD_CG0002 pvolHostID=5 pvolInstanceNumber=15 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=4 svolInstanceNumber=15 svolPortNumber=50.002 pvolHORCMINSTHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
NOTE: • This command is not available for XP1024/XP128. • You cannot perform any operations for Fast Snap. • To delete a specific copy pair from a copy group, you must specify pvolserialnum, pvoldevnum, svolserialnum (or svolsequencenum), and svoldevnum. If you omit all of these parameters, the system deletes all copy pairs in the specified copy group.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,002 pvolHORCMMONHostName=192.168.32.63 svolHORCMINSTHostName=192.168.32.
GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair. In P9500, XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128, replication controller pairs indicate paths between MCUs and RCUs.
• If you specify the mastermodel, remotefamily, or remotepathgroupid parameter, you also need to specify all other parameters (masterserialnum, mastercontrollerid, remoteserialnum, remotessid, mastermodel, remotefamily, and remotepathgroupid). If you do not specify them at the same time, an error will occur. • If you omit all the parameters, the command will obtain the information about all replication controller pairs.
Command execution example 2 This example obtains the controller pair information in all storage systems that have been registered in the Device Manager database. hdvmcli GetReplicationControllerPair -o "D:\logs\GetReplicationControllerPair.
Parameters Table 117 ModifyReplication command parameters Parameter name Status Description replicationgroupid Required Number of the copy group Specify one of the following values: • split: Split the copy pair. • resync: Re-synchronize the copy pair from the primary volume (P-VOL) to the secondary volume (S-VOL). operation Required • restore: Re-synchronize the copy pair from the S-VOL to the P-VOL. If you re-synchronize a Snapshot copy pair, the copy pair is split after the re-synchronization.
Parameter name Status Description Device number of the S-VOL For P9500 and XP24000/XP20000: svoldevnum# Optional Specify this parameter as a decimal number or colon-delimited hexadecimal number in the format ww:xx:yy, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number. ww is optional. If ww is omitted, LDKC is assumed to be 0.
65010001. The secondary volume is the logical device with LDEV number 21 in the storage system with serial number 65010001. hdvmcli ModifyReplication -o "D:\logs\ModifyReplication.
5 Output items This chapter describes items that are output by Device Manager CLI commands. The items are output for each instance as attributes of Device Manager instances. The meaning of items that have the same name might differ for different instances. When you reference an output item, check the instance of the item. Alert instance The Alert instance is output when the GetAlerts command (see “GetAlerts” on page 307) is executed.
ArrayGroup instance The ArrayGroup instance is output when the following commands are executed: • • • • • • • • AddExternalArrayGroup, page 47 AddPool, page 74 AddVirtualVolume, page 91 GetStorageArray (subtarget=ArrayGroup) , page 134 GetStorageArray (subtarget=FreeSpace) , page 146 GetStorageArray (subtarget=PDEV) , page 172 GetStorageArray (subtarget=Pool) , page 174 ModifyPool, page 206 Table 119 ArrayGroup instance attributes Attribute Description objectID Object ID of the parity group Parity grou
Attribute Description diskSizeInKB Actual size (in KB) of physical drives that make up the parity group (example: 75,497,472) 0 is output for an external volume. formFactor Currently, this information does not apply to storage systems (-1 is output).
Attribute Description openOnDemandCapacity Total size of all open LDEVs expanded on demand in the parity group (in KB) imTotalCapacity Total size of all intermediate LDEVs in the parity group (in KB) imAllocatedCapacity Total size of all intermediate LDEVs assigned paths in the parity group (in KB) imFreeCapacity Total size of all intermediate LDEVs that are not assigned paths in the parity group (in KB) imAutoLunCapacity Total size of all intermediate LDEVs reserved for Auto LUN Software in the
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): openReservedActualCapacity • Paths are not assigned. • Paths cannot be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity.
Attribute Description Protection level of the parity group For P9500 or XP24000/XP20000, one of the following values is output: • 0: Standard The parity group consists of drives other than SATA drives • 1: SATA-W/V The parity group consists of SATA drives • 2: SATA-E protectionLevel The parity group consists of SATA drives and the write performance is more enhanced than SATA-W/V -1 is output if any of the following conditions are satisfied: • The protection level of the parity group is unknown.
CommParameters instance The CommParameters instance is output when the following commands are executed: • • • • • • • AddStorageArray, page 84 AddVirtualizationServer, page 268 GetHost, page 275 GetStorageArray (subtarget=CommParameters) , page 139 ModifyVirtualizationServer, page 298 RefreshStorageArrays, page 238 RefreshVirtualizationServer, page 301 Table 121 CommParameters instance attributes Attribute Description User ID For a storage system: User ID for accessing the storage system For SMI-S Enable
Attribute Description Protocol For SMI-S Enabled storage systems: Data transfer protocol of the SMI-S provider - Non-secure: HTTP communication - Secure: HTTPS communication For a virtualization server: protocol Communication protocol for acquiring information about the virtualization server - Non-secure: HTTP communication - Secure: HTTPS communication For details about output values, see the description about parameter hostprotocol in Table 94. For other cases, no value is output.
Component instance The Component instance is output when the GetStorageArray (subtarget=Component) command (see “GetStorageArray (subtarget=Component) ” on page 140) is executed.
ConfigFile instance The ConfigFile instance is output when the GetHost command (see “GetHost” on page 275) is executed. Table 123 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 Path group ID 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 143) is executed.
• GetStorageArray (subtarget=FreeSpace) , page 146 Table 128 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, page 52 AddWWNForHostStorageDomain, page 254 GetStorageArray (subtarget=HostStorageDomain) , page 150 GetStorageArray (subtarget=Port) , page 181 ModifyPort, page 217 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 184) is executed. Table 132 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 type of the LDEV The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]).
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 for : • -1: Unknown volumeKind • 1: Mainframe volume • 2: Intermediate volume • 3: Open volume LDEV status One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: • Unknown: Unknown • Normal: Normal status • Normal(Quick Format): Normal status (Quick Format) • Blocked: Blocked status or unformatted. status • Format: The LDEV is being formatted.
Attribute Description Volume type of Hitachi TrueCopy for Mainframe Software or Hitachi TrueCopy Asynchronous for Mainframe Software • Unknown: Unknown mfTrueCopyVolumeType • Simplex: Not a Hitachi TrueCopy for Mainframe Software volume or Hitachi TrueCopy Asynchronous for Mainframe Software volume • P-VOL • S-VOL Volume type of Hitachi ShadowImage for Mainframe Software • Unknown: Unknown mfShadowImageVolumeType • Simplex: Not a Hitachi ShadowImage for Mainframe Software volume • P-VOL • S-VOL • SP-VO
Attribute Description Usage rate threshold of the THP/Smart volumes. One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit consists of THP/Smart volumes: usage rate threshold value of the THP/Smart volumes#1, #2 • For volumes other than THP/Smart volumes : -1 is output. threshold #1 When the THP/Smart volumes are not assigned to a THP/Smart pool, -1 is displayed. #2 When the operator is a partitioned storage administrator, -1 is displayed.
Attribute Description ID of the resource group to which the LDEV belongs resourcePartitionUnitID The ID of a resource group managed by a storage system management tool is output. This item is output for P9500. -1 is output for all other storage systems. LogicalDKC instance The LogicalDKC instance is output when the GetStorageArray (subtarget=LogicalDKC) command (see “GetStorageArray (subtarget=LogicalDKC) ” on page 157) is executed.
Attribute Description Type of logical group. • 0: Folder resourceType • 1: Host logical group • 2: Volume logical group Method for specifying a resource. Indicates the method for specifying a resource (a host or volume) managed by a logical group. specificationType • 0: Direct specification • 1: Conditional specification -1 is output if the logical group type is a folder. # The values of the lower logical groups are also added.
Attribute Description Number of the LDEV contained in the logical unit devNum For P9500 or XP24000/XP20000, a combination of a logical DKC number, a CU number, and an LDEV number (=logical-DKC-number*65536+CU*256+LDEV) is output. For XP12000/XP10000/SVS200 and XP1024/XP128, a combination of a CU number and an LDEV number (=CU*256+LDEV) is output.
Attribute Description RAID type of the logical unit The RAID type is output in the format RAIDx(yD[+zP]) or RAIDx(yD[+yD]). • RAIDx: RAID level raidType • yD: Number of data drives • zP: Number of parity drives For example, RAID5(3D+1P) indicates a RAID5 configuration consisting of three data drives and one parity drive. currentPortController Currently, this information does not apply to storage systems (-1 is output).
Attribute Description sysVolFlag This item is output only for XP12000/XP10000/SVS200 or XP1024/XP128. 0 is output for other storage systems. Indicates whether the logical unit is used as an external volume. externalVolume • 0: Not used as an external volume. • 1: Used as an external volume. Indicates whether the logical unit is used for differential management. differentialManagement • true: Used for difference management. • false: Not used for difference management.
Attribute Description Usage of on the THP/Smart volume (KB) One of the following values is output for P9500 or XP24000/XP20000: • When the logical unit does not consist of THP/Smart volumes: The same value as capacityInKB. • When the logical unit consists of THP/Smart volumes: Usage of on the THP/Smart volumes. -1 is output for other storage systems.
Attribute Description The status of a THP/Smart pool volume. One of the following values is output for P9500: • 2 : The THP/Smart pool can shrink. thpPoolVolControlFlag • 1 : The THP/Smart pool is shrinking. • 0 : The THP/Smart pool cannot shrink (for example, the initial THP/Smart pool volume). • -1 : The volume is normal (includes the volumes that became normal volumes after the THP/Smart pool finishes shrinking). -1 is output for other storage systems.
Attribute Description svolSerialNumber Serial number of the storage system containing the S-VOL Type of the storage system containing the S-VOL svolArrayType If the storage system containing the S-VOL is not registered, Unknown is output. svolDevNum Device number of the S-VOL Device number of the S-VOL For P9500 or XP24000/XP20000: displaySvolDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number.
ObjectLabel instance The ObjectLabel instance is output when one of the following commands is executed: • • • • • GetStorageArray (subtarget=ArrayGroup) , page 134 GetStorageArray (subtarget=LDEV) , page 154 GetStorageArray (subtarget=LogicalUnit) , page 159 AddLabel, page 62 ModifyLabel, page 203 Table 138 ObjectLabel instance attributes Attribute Description targetID Object ID of the label label Label name PairedPool instance The PairedPool instance is output when the GetStorageArray (subtarget=Po
Path instance The Path instance is output when the following commands are executed: • • • • • • • AddLun, page 249 GetLogicalGroup, page 246 GetStorageArray (subtarget=ArrayGroup) , page 134 GetStorageArray (subtarget=HostStorageDomain) , page 150 GetStorageArray (subtarget=LogicalUnit) , page 159 GetStorageArray (subtarget=Path) , page 168 GetStorageArray (subtarget=Port) , page 181 Table 141 Path instance attributes Attribute Description objectID Object ID of the path Path name name This item is ou
PDEV instance The PDEV instance is output when the following commands are executed: • • • • • AddPool, page 74 GetStorageArray (subtarget=ArrayGroup) , page 134 GetStorageArray (subtarget=PDEV) , page 172 GetStorageArray (subtarget=Pool) , page 174 ModifyPool, page 206 Table 142 PDEV instance attributes Attribute Description objectID Object ID of the physical device Drive name name This item is output if it has been registered.
Attribute Description Serial number of the drive serialNumber This item is not output. Type of the storage system containing the physical device • P9500: P9500 dkuType • XP24K: XP24000/XP20000 • XP12K/10K/SVS200: XP12000/XP10000/SVS200 • XP1024/128: XP1024/XP128 Drive revolutions per minute rpm This information is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200. 0 or -1 is output if the drive revolutions are unknown.
Pool instance The Pool instance is output when the following commands are executed: • • • • • • • • AddPool, page 74 AddTieredPoolOperation, page 89 GetPoolShrinkStatus, page 122 GetStorageArray (subtarget=Pool) , page 174 GetTieredPoolStatus, page 195 ModifyExternalTierRank, page 200 ModifyPool, page 206 ShrinkPool, page 242 NOTE: The attributes thresholdVolForewarn and thresholdVolOverwarn, which were supported in version 6.
Attribute Description Indicates the pool type. The value output depends on the poolFunction value.
Attribute Description Threshold2 of the pool (%) threshold2 If poolFunction is 5, the threshold2 of the THP/Smart pool is output. This information is invalid for other cases (-1 is output). Indicates whether the value output to threshold2 is the value determined by the storage system.
Attribute Description Combination of data drives and parity drives in a RAID configuration. For P9500, if the pool is a THP pool, this item is output in the format xD+yP or xD+xD. • xD: Number of data drives • yP: Number of parity drives combination Unknown is output if the combination is unknown.
Attribute Description Type of the drive If the storage system is P9500 and a THP pool is used, one of the following values is output: • 1: SATA • 4: SAS • 5: SSD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • Drives with different drive speeds are mixed This information is invalid for other cases (-1 is output). Indicates whether the pool is a Smart pool.
Attribute Description Execution status of performance monitoring #2 monitoringState • 0: Stopped • 1: Executing lastMonitorStartDate#2 lastMonitorEndDate#2 Date and time at which performance monitoring started If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output. Date and time at which performance monitoring ended If the date and time is valid, it is output in YYYY/MM/DD hh:mm:ss format. If it is invalid, -1 is output.
• • • • AddPool, page 74 GetStorageArray (subtarget=Pool) , page 174 ModifyExternalTierRank, page 200 ModifyPool, page 206 Table 145 PoolTier instance attributes Attribute Description objectID Object ID of the hardware tier name Name of the hardware tier tierID ID of the hardware tier Capacity of the hardware tier (KB) capacityInKB This value does not match the total capacity of the Smart pool volumes because the pool of Smart Tiers uses a control area.
Attribute Description Type of the drive • 1: SATA • 4: SAS • 5: SSD diskType • -1: If any of the following conditions are satisfied • The drive type is unknown • Drive types are mixed • Drives with different drive speeds are mixed Indicates whether the volumes that make up the hardware tier are internal or external volumes: substance • 0: Internal volume • 1: External volume • -1: Unknown, or internal volumes and external volumes are mixed bufSpaceForNewPageAssignment Percentage of buffer space for n
Attribute Description Indicates whether LUN security is valid for the port. lunSecurityEnabled • true: Valid • false: Not valid controllerID Port controller ID Port option portOption No value is output if the option is invalid. WWN of the port worldWidePortName This item is valid when the port is a Fibre port or an FCoE port.
Attribute Description Name of the port controller name This item is output if it has been registered.
Attribute Description Port type type For details about the output values, see Table 148.
Storage system Values output for the type attribute • 2: ESCON • 8: Fibre-Tachyon Shortwave (2 ports) • 12: Fibre-Tachyon Shortwave (4 ports) • 13: Fibre-Tachyon Shortwave (4 ports) XP1024/XP128 • 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 “GetStor
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 pvolPoolID svolSerialNumber For Continuous Access Journal Software: Journal group ID For Snapshot, Fast Snap, or Continuous Access Asynchronous Software: Pool ID of a data pool 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 or Fast Snap. When the copy type differs from Snapshot, -1 is output.
ServerInfo instance The ServerInfo instance is output when the GetServerInfo command (see “GetServerInfo” on page 308) is executed.
• • • • • • • • • • • • • • • • GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray GetStorageArray (subtarget=CommParameters) , page 139 (subtarget=Component) , page 140 (subtarget=ExternalStorage) , page 143 (subtarget=Filter) , page 144 (subtarget=FreeSpace) , page 146 (subtarget=HostStorageDomain) , page 150 (subtarg
Attribute Description description Description of the storage system serialNumber Serial number of the storage system arrayFamily Family of the storage system arrayType Type of the storage system SVP microcode version microcodeVersion This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128. SNMP agent version agentVersion This item is output for P9500, XP24000/XP20000, XP12000/XP10000/SVS200, or XP1024/XP128.
Attribute Description Total value of the following sizes (in KB) • Total size of the logical units to which paths are not assigned (freeCapacityInKB) capacityInKB • Total size of the logical units to which paths are assigned (allocatedCapacityInKB) • Total size of the logical units reserved for Auto LUN Software (autoLunCapacityInKB) • Total size of the LDEVs expanded on demand (onDemandCapacityInKB) freeCapacityInKB Total size of the logical units to which paths are not assigned (in KB) allocatedCapa
Attribute Description Total value of the following sizes (in KB) • Total size of the open logical units to which paths are assigned (openAllocatedCapacity) openTotalCapacity • Total size of the open logical units to which paths are not assigned (openFreeCapacity) • Total size of the open logical units reserved for Auto LUN Software (openAutoLunCapacity) • Total size of the open logical units expanded on demand (openOnDemandCapacity) Total size of the open logical units to which paths are assigned (in KB)
Attribute Description An attribute for compatibility. imOnDemandCapacity For details, see Table 154. Total size of the mainframe logical devices (in KB) mfTotalCapacity Total value of the sizeInKB attributes of the LDEV instances whose volumeKind attribute is 1. Total size of the mainframe logical devices reserved for Auto LUN Software (in KB) mfAutoLunCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • volumeKind is 1.
Attribute Description This item indicates whether an unformatted logical unit can be created. One of the following values is output for P9500, XP24000/XP20000, or XP12000/XP10000/SVS200: autoFormatLU • -1: Unknown • 0: Able to select whether to format a logical unit when it is created • 1: A logical unit is automatically formatted when it is created For other storage systems, -1 is output. Indicates whether the target storage system is consistent with the Device Manager database.
Attribute Description Total size of the open logical units and the intermediate logical units that satisfy all the following conditions (in KB): • Paths are not assigned. • Paths can be assigned by using Device Manager. • The logical unit is a real volume that has physical capacity. openUnallocatedActualCapacity Total value of the sizeInKB attributes of the LDEV instances that satisfy all of the following conditions: • thpType is not 0. • path is false. • volumeKind is 2 or 3.
Attribute Description Number of intermediate logical units that satisfy both the following conditions: numberOfImReservedLUs • Paths are not assigned. distributedMode Currently, this information does not apply to storage systems (-1 is output). • Paths cannot be assigned by using Device Manager. #1 The value obtained by dividing xxxInKB by 1,024 x 1,024 and then truncating anything after the decimal point.
Attribute totalFreeSpaceInGB# largestFreeSpaceInGB# Description 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. Size of the largest region of unused capacity in which logical units can be created (in GB) For P9500, XP24000/XP20000, or XP12000/XP10000/SVS200, this calculation is also performed for external volume parity groups.
Attribute mfAllocatedCapacity mfUnallocatedCapacity Description Total size of the mainframe logical devices to which paths are assigned (in KB) Currently, this information does not apply to storage systems (0 is output). Total size of the mainframe logical devices to which paths are not assigned (in KB) Currently, this information does not apply to storage systems (0 is output). # The value obtained by dividing xxxInKB by 1,024 x 1,024 and then truncating anything after the decimal point.
Figure 2 Relationship of attributes (total size of the volumes in the storage system) Figure 3 Relationship of attributes (size of the physical volumes and virtual volumes) Figure 4 Relationship of attributes (the sizes of the volumes) TieringPolicy instance The TieringPolicy instance is output when the following commands are executed: • GetStorageArray (subtarget=TieringPolicy) , page 190 • ModifyTieringPolicy, page 228 Table 155 TieringPolicy instance attributes Attribute Description objectID Object
Attribute allocationThresholdT1Max#1, #2 allocationThresholdT1Min#2 allocationThresholdT3Max#2 allocationThresholdT3Min#2 Description Maximum allocation threshold value (%) for Tier 1 If a tiering policy has been applied, the maximum capacity threshold value allocated for Tier 1 is output. Minimum allocation threshold value (%) for Tier 1 If a tiering policy has been applied, the minimum capacity threshold value allocated for Tier 1 is output.
Attribute Description Type of the URLLink • -1: URLLink set for a Device Manager object other than SMI-S Enabled storage system createdByUser • 0: URLLink set by he Device Manager server for an SMI-S Enabled storage system • 1: URLLink set by a user for an SMI-S Enabled storage system VHostStorageDomain instance The VHostStorageDomain instance is output when the following commands are executed: • GetStorageArray (subtarget=HostStorageDomain) , page 150 • GetStorageArray (subtarget=VResourcePartitionUnit
VLDEV instance The VLDEV instance is output when the following commands are executed: • • • • AddVLDEVToVRPU, page 99 GetStorageArray (subtarget=LDEV) , page 154 GetStorageArray (subtarget=LogicalUnit) , page 159 GetStorageArray (subtarget=VResourcePartitionUnit), page 191 Table 159 VLDEV instance attributes Attribute Description objectID Object ID of the VLDEV resourcePartitionUnitID ID of the resource group to which the virtualized resources belong The ID of the resource group used for data migrati
VM instance The VM instance is output when the GetHost command (see “GetHost” on page 275) is executed.
Attribute Description vendor Vendor name of the external volume Display name of the device number of the internal volume to which the external volume is mapped For P9500 or XP24000/XP20000: displayMappedDevNum The value is output in the ww:xx:yy format, where ww is the logical DKC number, xx is the CU number, and yy is the LDEV number. For XP12000/XP10000/SVS200 or XP1024/XP128: The value is output in the xx:yy format, where xx is the CU number and yy is the LDEV number.
• AddVLDEVToVRPU, page 99 • GetStorageArray (subtarget=VResourcePartitionUnit), page 191 Table 163 VResourcePartitionUnit instance attributes Attribute Description objectID Object ID of the VResourcePartitionUnit name Name of a resource group used for data migrations that use virtual IDs resourcePartitionUnitID ID of a resource group used for data migrations that use virtual IDs vArrayFamily Family of the virtual storage system vSerialNumber Serial number of the virtual storage system Whether or
Attribute Description WWN nickname nickname This item is output if it has been registered.
Output items
6 Batch functionality This chapter describes the commands that can be executed by using the batch functionality, how to create batch files, how to use the batch functionality, and the actions to be taken if an error occurs. Commands that can be executed by using the batch functionality In the Device Manager CLI, commands can be specified in a batch file and executed at the same time. The batch option allows you to simultaneously execute many commands and is useful when installing a new storage system.
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 -- devnum -- model overwrite Y (condition-1) serialnum vcvs AddVLDEVToVRPU vdevnum#1 -vemulation vluse vrpuid Y (condition-1) vssid#1 -- 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) por
Command name Parameter Specification conditions devnum -- model DeleteVLDEVFromVRPU serialnum Y (condition-1) vrpuid assign Y (condition-1) capacity devnums#5 ModifyVirtualVolume -- model Y (condition-1) poolid -- serialnum Y (condition-1) threshold tieringpolicy -- tierrelocation Legend: Y (condition-n): If the specification conditions for the parameter, condition-n, are satisfied, the command can be executed together with other commands when this parameter is specified.
For this parameter, you can specify multiple THP/Smart volume device numbers. To specify five or more device numbers, write them separately on multiple command lines. If you specify five or more device numbers on one command line and then perform batch processing, an error might occur with the error message KAIC90084-E that has the response value 413 Request Entity Too Large.
Command execution results example: In the execution results, the start line number and the end line number, which are the numbers counted from the top of the batch file and indicate the start and end line number of the batch processing, are displayed following the executed command name. In the following output example, AddLun(2-5) indicates that the AddLun commands on lines 2 to 5 of the batch file have processed together. NOTE: A blank line is also counted as a line.
imAllocatedCapacity=0 imFreeCapacity=769,305,600 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=769,305,600 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 numberOfOpenAllocatedLUs=672 numberOfOpenUnallocatedLUs=1,752 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=80 numberOfMfLDEVs=80 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=2 lastRefreshed=1,153,456,561 autoFormatLU=1 statusOfDBInconsistency=0 configUpdateStatus=-1 openAllocate
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 *****: The values are encoded by the CLI. When an error occurs during batch functionality execution This section explains how to take action if an error occurs during batch functionality execution.
Check the Device Manager server error code that is output in place of code and the storage system error code that is output in place of description, and then take one of the following actions: When the Device Manager server error code is other than 6400: Perform the following procedure: 1. Execute the GetStorageArray command to check whether there is an error in the batch file. 2. Correct any error in the batch file. 3. Execute the batch functionality again.
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.
Batch functionality
7 Import functionality Hosts can be added and host information can be updated by importing host information files and mapping definition files via the Device Manager CLI. This chapter describes the import functionality that can be used by executing the ImportHosts command. For details about the format and parameters of the ImportHosts command, see “ImportHosts” on page 288. Overview of the import functionality The ImportHosts command can be used to import host information from files.
Figure 5 Flow of operations for importing host information (ImportHosts command) The following describes the files that the ImportHosts command uses or generates. Input files • Host information file (CSV file) The host information file contains host information in CSV format. If you are using spreadsheet software to manage hosts, you can use the spreadsheet software file to create the host information file.
NOTE: • To add hosts, the hosts whose information you imported are registered as normal hosts. • To update (overwrite) host information, use the GUI to confirm that the hosts to be updated have been registered manually. The ImportHosts command only updates normal hosts that were manually registered by using the Device Manager GUI or CLI (AddHost command or HostScan command).
See also • • • • Conventions for creating host information files (CSV files), page 430 Conventions for creating mapping definition files, page 431 Examples of input files, page 432 ImportHosts, page 288 Conventions for creating host information files (CSV files) Follow the following conventions when creating host information files: • Use UTF-8 encoding. • Make sure that the host information file does not exceed the maximum of 10,250 records.
Item Description IP address (IPv4)# Specify an IP address in IPv4 format. IP address (IPv6)# Specify an IP address in IPv6 format. Alphabetic characters are not case sensitive. Specify the OS type. Alphabetic characters are not case sensitive. OS type If the character string specified as this item is defined in the mapping definition file as a property value, the corresponding OS type is displayed in the GUI.
Property Description Specifies the position of the host name. import.host.column.hostname Specify the field number (the leftmost field is 1) of the field that specifies the host name. You can specify a value from 1 to 256. This property is required. import.host.column.wwn These five properties specify the positions of items other than the host name. import.host.column.iscsiname# Specify the field number (the leftmost field is 1) of the field that specifies the corresponding item.
Example of a host information file (CSV file) 1,2,3,4,5,6[CRLF] host,ip,ipv6,OS,description,wwn[CRLF] TEST1,10.0.0.1,,WINDOWS,Evaluation purpose,11.11.11.11.11.11.11.11[CRLF] TEST2,,,Windows 2008,DB server,22.22.22.22.22.22.22.22[CRLF] TEST3,,,Windows 7,File server,33.33.33.33.33.33.33.33[CRLF] TEST4,10.0.0.3,,LINUX,,44.44.44.44.44.44.44.
Import functionality
8 Properties file This chapter describes how to specify options and parameters by using the Device Manager CLI properties file. This chapter also describes how to change certain properties by entering commands from the command line. Overview of the properties file The Device Manager server URL, command options, and parameters can be set in the properties file. When these items have been specified in the properties file, you do not need to enter them from the command line.
user=khalsa # Password can be provided directly, or from a password file. password=khalsa #password=@D:\\DeviceManager\\.passwd # Provide a copy of the raw xml request & response # in MessageTrace.log file. messagetrace=true ##### COMMAND PARAMETERS #### # Set the Array model, for commands that use this parameter. model=XP24000 Using the properties file to specify options Command options can be specified from the command line or in the properties file.
Encoding the password in the properties file or password file Specify a password in the properties file (hdvmcli.properties) or password file, to omit entering the password when using the Device Manager CLI. You can specify a plain text password for the properties file or password file. However, HP recommends that you use the hdvmaccount command to encode the password for better security.
After the command completes, you do not need to specify the password when using the Device Manager CLI. After executing the hdvmaccount command, use the GetServerInfo or GetStorageArray command to make sure that the password is correctly set. Using the properties file to specify parameters Command parameters can be specified from the command line or in the properties file. When they have been specified in the properties file, you do not need to specify them from the command line.
hdvmcli.diaglevel=DEBUG • Information hdvmcli.diaglevel=INFO • Warnings hdvmcli.diaglevel=WARN • Errors hdvmcli.diaglevel=ERROR NOTE: As shown above, you can set the hdvmcli.diaglevel property to DEBUG, INFO, WARN, or ERROR. The default logging level is INFO. Message trace output The recording of the request messages sent to the Device Manager server and the received responses can be controlled using the -t or --messagetrace option. Like all options, the value can also be set in the properties file.
Inputting requests from XML documents CAUTION: To use the XML-API CLI feature, you need thorough knowledge of XML-API, and need to take great care in formulating commands. Rather than specifying the command and parameters from the command line, the request can originate from a file. The file must contain a valid XML document in the correct form for a Device Manager request. The command line option -i or --input specifies the input file. The other options are still valid.
PAGE 4426. 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 154 • lusubinfo LogicalUnit • ldevsubinfo • pathsubinfo GetStorageArray (subtarget=LogicalUnit) , page 159 MFReplicationInfo mfreplicationsubinfo GetStorageArray (subtarget=MFReplicationInfo) , page 164 Path pathsubinfo GetStorageArray (subtarget=Path) , page 168 Pool poolsubinfo GetStorageArray (subtarget=Pool) , page 174 Port portsubinfo GetStor
Second and subsequent lines: A value and a line feed code are output. An end-of-file (EOF) code is output after the last line. 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 (").
A DOCTYPE declaration and a line feed code are output. 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 446. Third line: XML elements are output.
ReplicationInfo (LogicalUnit)*> VResourcePartitionUnit (VPort | VHostStorageDomain | VLDEV)*> CommParameters EMPTY> Component EMPTY> FreeLUN EMPTY> FreeSpace EMPTY> HostInfo EMPTY> IPAddress EMPTY> ISCSIName EMPTY> Logi
devNum CDATA #IMPLIED> displayDevNum CDATA #IMPLIED> osScsiBus CDATA #IMPLIED> osScsiID CDATA #IMPLIED> osLun CDATA #IMPLIED> portWWN CDATA #IMPLIED> fileSystemType CDATA #IMPLIED> fileSystemName CDATA #IMPLIED> sizeInMB CDATA #IMPLIED> percen
consumedSizeInKB CDATA #IMPLIED> mfTrueCopyVolumeType CDATA #IMPLIED> mfShadowImageVolumeType CDATA #IMPLIED> mfUniversalReplicatorVolumeType CDATA #IMPLIED> mfUniversalReplicatorPoolID CDATA #IMPLIED> thpPoolID CDATA #IMPLIED> thr
name CDATA #IMPLIED> devNum CDATA #IMPLIED> displayDevNum CDATA #IMPLIED> portID CDATA #IMPLIED> portName CDATA #IM
overProvisioningPercent CDATA #IMPLIED> overProvisioningWarning CDATA #IMP
externalVolumeName CDATA #IMPLIED> productName CDATA #IMPLIED> vendor CDATA #IMPLIED>
externalWWN CDATA #IMPLIED> externalLun CDATA #IMPLIED> portID CDATA #IMPLIED> pathGroupID CDATA #IMPLIED> priority CDATA #IMPLIED>
vArrayFamily CDATA #IMPLIED> vSerialNumber CDATA #IMPLIED> vPortID CDATA #IMPLIED> vDomainID CDATA #IMPLIED> objectID CDATA #IMPLIED> resourcePartitionUnitID CDATA #IMPLIED> dev
Properties file
9 Troubleshooting This chapter describes how to troubleshoot Device Manager CLI problems. Troubleshooting Device Manager CLI problems If there is a problem with the Device Manager CLI: • Make sure that the problem is not being caused by the PC or LAN hardware or software, and try restarting the PC. • Make sure that the problem is not occurring at the Device Manager server. • Check for errors specific to the Device Manager CLI, and if there are any, take appropriate action. For details, see the table below.
Problem Description and recommended action CAUSE: The host used for creating the copy pair recognizes CL1-A or LUN0. SOLUTION: Assign another port to the LU or assign a LUN other than LUN0, and re-create the copy pair. SOLUTION: Collect the following information, and then contact your HP Technical Support representative. The following error message is displayed and the Device Manager CLI stops: • CLI log file An unspecified error was encountered in CLI.
Problem Description and recommended action CAUSE: Authenticate failed in the Device Manager. SOLUTION: Make sure that the user ID and password that you specified when executing the command are correct. If you are using the function for linking to an external authentication server, take the action specified below. If the external authentication server is an LDAP server: The following message is displayed when a Device Manager CLI command is executed#: [KAIC90084-E] HTTP Response: "HTTP/1.
Problem Description and recommended action CAUSE: The settings of JRE do not allow using JSSE. An error occurs if SSL communication is used in AIX. SOLUTION: Add the following line to the JRE-installation-directory/lib/security/ java.security file: ssl.SocketFactory.provider=com.sun.net.ssl.internal. ssl.
10 Support and other resources Numerous support options are available. Contacting HP HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
Support and other resources
A Connecting to P9000 mainframe agent This appendix describes how to specify the information required to connect to P9000 mainframe agent.
Registering the mainframe host in Device Manager To use the AddHost command to register the mainframe host in Device Manager: 1. Execute the AddHost command to register the mainframe host in Device Manager. When you execute the command, specify the following parameters: • hostname: In this parameter, specify the host name that you specified when setting up the mainframe host environment. • hosttype: In this parameter, specify 2. 2.
name=toro2 hostID=1 capacityInKB=0 hostType=2 statusOfDBUpdating=-1 *****: The value is encoded by the CLI. Registering the P9000 mainframe agent running on the mainframe host in Device Manager To use the AddURLLink command to register the mainframe host in Device Manager: 1. Execute the AddURLLink command to register the P9000 mainframe agent running on the mainframe host in Device Manager.
Command format (for an IPv6 environment): hdvmcli AddURLLink "url=http://IBM-HTTP-Server-IP-address#:port-number" "name=MainframeAgent" "linkedid=mainframe-host-object-ID" # Enclose the IP address in square brackets ([ and ]). Example of executing the command (for an IPv4 environment): hdvmcli AddURLLink -o "D:\logs\AddURLLink.log" "url=http://192.168.99.114:24042" "name=MainframeAgent" "linkedid=*****" *****: The value is encoded by the CLI.
2. Check whether the mainframe host and P9000 mainframe agent have been registered correctly. If they have been registered correctly, use the AddHostRefresh command to acquire the information again. If they have not been registered correctly, register them correctly by using the procedures described in “Registering the mainframe host in Device Manager” on page 466 and “Registering the P9000 mainframe agent running on the mainframe host in Device Manager” on page 467.
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, 39 AddArrayReservation, 45 AddConfigFileForReplication, 312 AddExternalArrayGroup, 47 AddHost, 263 AddHostInfo, 264 AddHostRefresh, 266 AddHostStorageDomain, 52 AddLabel, 62 AddLogicalUnit, 64 AddLun, 249 AddLUSE, 70 AddPool, 74 AddReplication, 321 AddStorageArray, 84 AddTieredPoolOperation, 89 AddURLLink, 303 AddVirtualizationServer, 268 AddVirtualVolume, 91 AddVLDEVToVRPU, 99 AddWWNForHostStorageDomain, 254 B batch commands that can be executed, 413 execution example, 420 executio
E example of creating host information file (CSV file), 433 mapping definition file, 433 F FormatLU, 117 G GetAlerts, 307 GetArrayReservation, 122 GetHost, 275 GetHostInfo, 284 GetLogicalGroup, 246 GetPoolShrinkStatus, 122 GetReplicationControllerPair, 337 GetServerInfo, 308 GetStorageArray, 127 GetStorageArray (subtarget not specified), 132 GetStorageArray (subtarget=ArrayGroup), 134 GetStorageArray (subtarget=CommParameters), 139 GetStorageArray (subtarget=Component), 140 GetStorageArray (subtarget=Exte
ModifyPool, 206 ModifyPort, 217 ModifyPortController, 224 ModifyReplication, 339 ModifyStorageArray, 225 ModifyTieringPolicy, 228 ModifyVirtualizationServer, 298 ModifyVirtualVolume, 230 N notes Device Manager CLI, 43 O U URL, 26 User Account Control function, 26 user group, 39 V version Device Manager CLI, 30 virtual ID, 38 virtual information, 38 virtualization server Host Data Collector, 268 vMA, 268 vMA, 268 optimization of regions of unused capacity, 64 options, 27 output files check results file,
