HP StorageWorks XP Command View Advanced Edition software Device Manager CLI user guide Reference number: T1780-96080 Tenth edition: February 2008
Legal notices © Copyright 2005, 2008 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.
This product includes altered versions of software originally developed by Henry Spencer.
Contents Contents Figures and Tables Figures ................................................................................................................................................................. 8 Tables................................................................................................................................................................... 8 About this guide Revision history ...............................................................................................
Contents 4-4-6 AddStorageArray ................................................................................................................................. 72 4-4-7 AddVirtualVolume................................................................................................................................ 76 4-4-8 DeleteArrayReservation ...................................................................................................................... 82 4-4-9 DeleteHostStorageDomain..............
Contents 4-7-1 AddHost............................................................................................................................................. 189 4-7-2 AddHostInfo....................................................................................................................................... 190 4-7-3 AddHostRefresh ................................................................................................................................ 192 4-7-4 DeleteHost.................
Contents 4-10-37 Items output when instance is WWNGroup................................................................................... 271 4-11 Using batch files to execute commands................................................................................................... 272 4-11-1 Creating batch files.......................................................................................................................... 272 4-11-1-1 Batch file format and input rules ..........................
Figures and Tables Figures and Tables Figures Figure 3-1 Example of CLI help for the AddLun command ....................................................................................... 39 Figure 3-2 CLI help ................................................................................................................................................... 42 Figure 4-1 Merging WWN information...................................................................................................................
Figures and Tables Table 4-28 FormatLU command parameters ........................................................................................................... 88 Table 4-29 Element information that can be acquired by using the parameter subtarget.................................... 92 Table 4-30 subinfo parameters that can be used together with the parameter subtarget.................................... 93 Table 4-31 Examples of using the GetStorageArray command ......................................
Figures and Tables Table 4-80 AddHost command parameters............................................................................................................ 190 Table 4-81 AddHostInfo command parameters...................................................................................................... 190 Table 4-82 AddHostRefresh command parameter................................................................................................. 193 Table 4-83 DeleteHost command parameters..........
Figures and Tables Table 4-133 Items output when instance is ServerInfo .......................................................................................... 265 Table 4-134 Items output when instance is StorageArray...................................................................................... 266 Table 4-135 Items output when instance is URLLink .............................................................................................
About this guide About this guide This document describes and provides instructions for using the Command Line Interface (CLI) for HP StorageWorks XP Command View Advanced Edition Device Manager.
About this guide Table 1 Revisions Date Edition November 2006 Fifth Revision • The following OSs are now supported (command line interface only): ○ Windows Server 2003 R2 (x86 only) ○ Windows Server 2003 R2 x64 Edition • In Windows, JRE (Java Runtime Environment) version 5.0 (Update 7 or later) is now supported. • In HP-UX, JRE (Java Runtime Environment) version 5.0.xx (xx is 03 or later) is now supported. • Information about changing the memory heap size is now described.
About this guide Table 1 Revisions Date Edition February 2007 Sixth Revision • Device Manager CLI now supports HP-UX 11i v3 as a new operating system. • The domainnickname parameter has been added. • The explanation for the domain parameter has been corrected. • Device Manager CLI now supports GetStorageArray (subtarget=JournalPool) as a new command. • • • • • • • • • • • • • • • • • The format parameter has been added. Device Manager CLI now supports FormatLU as a new command.
About this guide Table 1 Revisions Date Edition Revision Edition or Windows Server 2003 R2 x64 Edition, Device Manager CLI must be used on the same machine as the Device Manager server. • Device Manager CLI now supports XP24000 as a new storage subsystem. • The message displayed when a memory shortage occurs in Device Manager CLI has been changed.
About this guide Table 1 Revisions Date Edition Revision • The value that indicates the array group of a THP volume has been added to the displayName attribute of the ArrayGroup instance.
About this guide Table 1 Revisions Date Edition Revision ○ openReservedCapacity ○ openReservedActualCapacity ○ numberOfReservedLUs ○ numberOfOpenReservedLUs ○ numberOfImReservedLUs • The output value R600 has been added to the explanation of the mappedArrayType attribute of the VolumeConnection instance. • Descriptions have been added that explain the display, in the web client, of mainframe hosts and mainframe volume information.
About this guide Table 1 Revisions Date Edition Revision ○ svolHORCMMONHostName ○ svolHORCMINSTHostName • The license attribute has been added to the ServerInfo instance. • Explanations have been added about the actions to be taken when the statusOfDBInconsistency attribute of the StorageArray instance is other than 0. • The output values XP20000 and XP10000 have been added to the explanation of the mappedArrayType attribute of the VolumeConnection instance.
About this guide Table 1 Revisions Date Edition Revision ○ force ○ quickformat • In Device Manager CLI, descriptions have been added that explain how to use the subtarget and subinfo parameters of the GetStorageArray command. • In Device Manager CLI, the explanation for executing the GetStorageArray command without specifying the subtarget parameter is now described in section 4-4-17-2 .
About this guide Table 1 Revisions Date Edition Revision ○ threshold ○ systemDisk • The following attributes have been added to the LogicalUnit instance: ○ thpType ○ consumedCapacityInKB ○ thpPoolID ○ threshold ○ tcaPoolID • The description of the rpm attribute of the PDEV instance has been changed.
About this guide • Reviewing the Release Notes on the CD for any last-minute announcements Document conventions and symbols Table 2 Document conventions Convention Element Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
About this guide Table 3 Conventions: Abbreviations Abbreviation Full name or meaning XP Business Copy Software This abbreviation is used when it is not necessary to distinguish the following products: • XP Business Copy Software • Business Copy XP XP Cache Residency Manager This abbreviation is used when it is not necessary to distinguish the following products: • XP Cache Residency Manager • Cache LUN XP XP Continuous Access Asynchronous Software This abbreviation is used when it is not necessary
About this guide HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support. Collect the following information before calling: • • • • • • Technical support registration number (if applicable) Product serial numbers Product model names and numbers Error messages Operating system type and revision level Detailed questions For continuous quality improvement, calls may be recorded or monitored.
XP Command View Advanced Edition Device Manager overview 1 XP Command View Advanced Edition Device Manager overview This chapter provides an overview of XP Command View Advanced Edition Device Manager and describes its components. 1-1 Overview of XP Command View Advanced Edition Device Manager HP StorageWorks XP Command View AE Device Manager (called Device Manager in this guide) is another name for HP StorageWorks XP Command View Advanced Edition software.
XP Command View Advanced Edition Device Manager overview 1-2 XP Command View Advanced Edition Device Manager components XP Command View Advanced Edition has the following components: • Command Line Interface (CLI). The Device Manager CLI enables you to perform client operations by issuing commands from the system command-line prompt. Table 1-1 describes the functions supported by Device Manager CLI for each storage subsystem.
XP Command View Advanced Edition Device Manager overview Table 1-1 Functions supported by Device Manager CLI Function Storage Subsystem XP24000/ XP20000 XP12000/ XP10000/ SVS200 XP1024/ XP128 XP512/ XP48 Viewing of XP Continuous Access Journal Software copy pair information Y Y -- -- Creation, status modification, and deletion of XP Continuous Access Journal Software copy pairs Y Y -- -- Viewing of CLPR information Y Y -- -- Modification of CLPR information N N -- -- Viewing of SLP
XP Command View Advanced Edition Device Manager overview HP StorageWorks XP Command View Advanced Edition software Device Manager web client user guide. • Agent. Device Manager agents run on host computers that are attached to StorageWorks XP Disk Array storage subsystems under management by the Device Manager. The agent collects data on the configuration and utilization of the attached storage and sends this information to the Device Manager server.
XP Command View Advanced Edition Device Manager overview To download the Device Manager CLI from the Device Manager server: 1. In the web client global tasks bar area, choose Go and then Download. 2. Click the Download link corresponding to the OS of the machine where the CLI is to be installed. The Device Manager agent and Device Manager CLI can be downloaded. 3. Copy the downloaded file to the machine where the Device Manager CLI is to be installed. 4. Decompress the downloaded file.
Setting up command line interface 2 Setting up command line interface This chapter describes the system requirements and startup instructions for Device Manager CLI. It discusses the following: • • • Requirements for CLI operations (section 2-1 ) Java environment settings (section 2-2 ) Executing Device Manager CLI commands over HTTPS (section 2-3 ) 2-1 Requirements for CLI operations The following gives requirements for Device Manager CLI operations.
Setting up command line interface Table 2-1 Platform, Java Runtime Environment, and IPv6 environment support for Device Manager CLI OS OS version Java Runtime Environment IPv6 environment support Windows 2000 Windows 2000 Professional SP4 Windows 2000 Server SP4 Windows 2000 Advanced Server SP4 Windows 2000 Datacenter Server SP4 JRE version 1.4.2_xx (xx is 06 or later)1 or JRE version 5.
Setting up command line interface Table 2-1 Platform, Java Runtime Environment, and IPv6 environment support for Device Manager CLI OS OS version Java Runtime Environment IPv6 environment support Windows Server 2003 R2 x64 Edition Windows Server 2003 R2, Standard x64 Edition Windows Server 2003 R2, Enterprise x64 Edition Windows Server 2003 R2, Datacenter x64 Edition Use the JRE used for the Device Manager server. For details about how to set up the JRE, see section 2-2-2 .
Setting up command line interface NOTE: If the system on which HP-UX operates uses a Dual-Core Intel(R) Itanium(R) 2 Processor for the CPU, use JRE version 1.4.2_xx (xx is 10 or later) or JRE version 5.0.03 or later, which comes with HP-UX (released in June 2006 or September 2006) that supports the processor. NOTE: If you run Device Manager CLI using a time zone for the U.S. and Canada, set up the OS so that the OS will support the new Daylight Saving Time (DST) rules introduced in 2007.
Setting up command line interface NOTE: If the value of HDVM_CLI_MEM_SIZE is less than what is required by a CLI command, CLI terminates, and the following error message is displayed: KAIC90574-E The memory for the CLI became insufficient while this operation was being performed. 2-2 Java environment settings To execute the Device Manager CLI, the Java environment must be configured for the Device Manager CLI.
Setting up command line interface If you do not know the installation directory for the Common Component, you can check the directory in the server.base.home property of the server.properties file for the Device Manager server. For details about the property file, see the HP StorageWorks XP Command View Advanced Edition software Device Manager server installation and configuration guide. NOTE: A forward slash (/) is used as a delimiter for directories in the server.base.home property.
Setting up command line interface \DeviceManagerCerts ○ In Solaris, Linux or HP-UX: /DeviceManagerCerts The following examples execute a Device Manager CLI command over HTTPS. To execute the GetServerInfo command, use the following format ○ In Windows: > dvmcli.bat -s https://:2443/service GetServerInfo ○ In Solaris, Linux or HP-UX: # ./hdvmcli.
Command line interface syntax and parameters 3 Command line interface syntax and parameters This chapter discusses the following: • • • • Command line syntax CLI return responses Displaying CLI help Guidelines for executing CLI commands 3-1 Command line syntax To execute the Device Manager CLI, move to the folder or directory in which the Device Manager CLI is installed, then execute hdvmcli.bat or hdvmcli.sh. The general format for the command line values is: • For Windows: c:\hdvmcli>hdvmcli.
Command line interface syntax and parameters NOTE: When you specify options in the properties file, you can omit them on the command line. For details about how to specify options in the properties file, see section 5-2 . NOTE: If you specify a parameter in the command line although the parameter has been specified in the properties file, the value of the parameter specified in the command line has precedence. NOTE: When the same parameter is specified multiple times, the value specified last is used.
Command line interface syntax and parameters Table 3-1 hdvmcli options Option -o or --output Argument Filename 2 Status Description Optional The file for storing the execution results Sends output to the specified file, instead of the console. NOTE: When this option is specified, the command does not send the execution results to the standard output. NOTE: If you specify an existing file, that file is overwritten.
Command line interface syntax and parameters Each command may have required parameters, optional parameters, or both, and you can specify any parameter in the application's properties file. If a parameter is specified both on the command line and in the properties file, the value from the command line is used. For more information on Device Manager properties, see the HP StorageWorks XP Command View Advanced Edition software Device Manager server installation and configuration guide.
Command line interface syntax and parameters Table 3-2 Return values Return Values Description 1 CLI found errors within its process (for example, parameter error). 2 CLI found errors in the Device Manager server. 3-3 Displaying CLI help The Device Manager CLI provides three help modes: • Basic Help Information for the Device Manager CLI Displays the Device Manager CLI command format, a list of commands, and a list of options.
Command line interface syntax and parameters DeleteLun AddHostStorageDomain DeleteHostStorageDomain AddWWNForLun DeleteWWNForLun AddWWNForHostStorageDomain DeleteWWNForHostStorageDomain AddISCSINameForHostStorageDomain DeleteISCSINameForHostStorageDomain DeleteWwn DeleteWwnGroup AddHost DeleteHost ModifyHost GetHost AddHostRefresh AddHostInfo DeleteHostInfo ModifyHostInfo GetHostInfo GetServerInfo GetLogFile ModifyDebugLevel GetDebugLevel GetAlerts DeleteAlerts AddArrayGroup DeleteArrayGroup AddLogicalUnit
Command line interface syntax and parameters GetArrayReservation FOR COMMAND-SPECIFIC HELP, TYPE: "hdvmcli help {server-command}" FOR BATCH HELP, TYPE: "hdvmcli help batch" AVAILABLE OPTIONS: -u {userid} or --user {userid} -p -s -i -o -b -t -f login user ID for Device Manager Server {password} or --password {password} login password for Device Manager Server or --secure presence indicates secure connection (https) {filename} or --input {filename} take input from the specified file, which must contain the
Command line interface syntax and parameters scsi lun devnum (optional) (required) (optional) lusedevnums (optional) wwn (optional) required; others, optional. Domain Number of the new Path, can not be set with parameter wwn together.
Command line interface syntax and parameters Table 3-3 Notes on executing CLI commands Item Description Related Commands Changing the security or When changing the security or deleting LUNs that deleting storage that belong to LUN groups, perform operations on belongs to a LUN group. each LUN group. If you want to delete or change security for only some LUNs in a LUN group, use the ModifyLunGroup command to release the target LUNs from the LUN group, and then perform the operation for each LUN.
Command line interface commands 4 Command line interface commands This chapter discusses the following topics: • • • • • • • • • • • • • Extracting parameter values (section 4-1 ) Supported CLI commands (section 4-2 ) Restrictions for use of Device Manager CLI commands and resources (section 4-3 ) Storage array commands (section 4-4 ) Logical group commands (section 4-5 ) LUN commands (section 4-6 ) Host management commands (section 4-7 ) Server management commands (section 4-8 ) Replication commands (s
Command line interface commands Table 4-1 describes which CLI commands can be used to find which parameter values. Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: alertnum Execute the GetAlerts command. Use the value displayed as alert number under An instance of Alerts. arraygroupname Execute the GetStorageArray (subtarget=ArrayGroup) command, specifying only the model and serialnum parameters, and ArrayGroup for the subtarget parameter.
Command line interface commands Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: domain Execute the GetStorageArray (subtarget=HostStorageDomain) command, specifying only the model and serialnum parameters, and HostStorageDomain for the subtarget parameter. Use the domainID value. domainnickname Obtain this value from the execution result of the GetStorageArray (subtarget=HostStorageDomain) command.
Command line interface commands Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: munum Obtain this value from the execution result of the GetHost command. In the execution result of this command, the muNumber value appears under An instance of ReplicationInfo. Use this value to specify the munum parameter.
Command line interface commands Table 4-1 Extracting parameter values To Find This Parameter Value: Do This: pvolpoolid Obtain this value from the execution result of the GetHost command. In the execution result of this command, the pvolPoolID value appears under An instance of ReplicationInfo. Use this value to specify the pvolpoolid parameter. pvolserialnum Execute the GetHost command. The pvolSerialNum is displayed as An instance of ReplicationInfo.
Command line interface commands 4-2 Supported CLI commands Table 4-2 through Table 4-7 give details about Device Manager CLI commands. • • Y : Indicates that the particular storage subsystem can be used to execute the command. -- : Indicates that it cannot be used to execute the command. Note that if the Core CLI/SMI-S license is used, logical group commands (see Table 4-3) cannot be used.
Command line interface commands Table 4-2 Storage array commands Command Name Description Storage Subsystems Subsection XP24000/ XP12000/ XP512/ XP20000 XP10000/ XP48 SVS200 XP1024/ XP128 DeleteStorageArray Excludes a storage subsystem from the group of storage subsystems managed by the Device Manager server Y Y Y 4-4-13 DeleteVirtualVolume Deletes THP volumes (virtual Y volumes) -- -- 4-4-14 FormatLU Formats an LU.
Command line interface commands NOTE: You can use the subtarget parameter to specify the device information.
Command line interface commands Table 4-4 LUN commands Command Name Description Storage Subsystems Subsection XP24000/ XP12000/ XP512/ XP20000 XP10000/ XP48 SVS200 XP1024/ XP128 AddWWNForHostStorageDom Sets the security of a LUN in Y ain the host storage domain by assigning its WWN in the host storage domain Y Y 4-6-3 AddWWNForLun Sets the security of a path by -assigning its WWN -- Y 4-6-4 AddWWNForLunGroup Sets the security of a LUN in a LUN group by assigning a WWN in the LUN group -- --
Command line interface commands Table 4-5 Host management commands Command Name Description Subsection DeleteHostInfo Deletes host-based information about a LUN from the Device Manager server database 4-7-5 GetHost Obtains information about a host 4-7-6 GetHostInfo Obtains host-based information about a LUN 4-7-7 ModifyHost Modifies information about a host 4-7-8 ModifyHostInfo Modifies host-based information about a LUN 4-7-9 Table 4-6 Server management commands Command Name Description
Command line interface commands Table 4-7 Replication commands Command Name Description Storage Subsystems Subsection XP24000/ XP12000/ XP512/ XP20000 XP10000/ XP48 SVS200 XP1024/ XP128 GetReplicationControlle Obtains RCU (remote path) rPair information registered in the MCU (main control unit) in storage subsystems managed by the Device Manager server ModifyReplication Changes copy pair status Y Y Y 4-9-4 Y Y Y 4-9-5 4-3 Restrictions for use of Device Manager CLI commands and resources The u
Command line interface commands Table 4-8, Table 4-9, Table 4-10, Table 4-11, Table 4-12, and Table 4-13 list commands and show their availability for each combination of resource group and user permission. The following symbols are used in the table: • • • Y : The command can be used for all resources. -- : The command cannot be used. R : Restrictions apply. The command can be used only for the resources that are defined in the assigned resource group.
Command line interface commands Table 4-9 Availability of logical group commands based on resource group and user permission Command name All Resources User-defined resource group Modify permission View permission Modify permission View permission AddLogicalGroup Y -- R -- AddLunScan Y -- -- -- AddObjectForLogicalGroup Y -- R -- DeleteLogicalGroup Y -- R -- DeleteObjectForLogicalGroup Y -- R -- GetLogicalGroup Y Y R R ModifyLogicalGroup Y -- R -- Table 4-10 Availab
Command line interface commands Table 4-11 Availability of host management commands based on resource group and user permission Command name All Resources User-defined resource group Modify permission View permission Modify permission View permission AddHost Y -- Y -- AddHostInfo Y -- R -- AddHostRefresh Y -- R -- DeleteHost Y -- R -- DeleteHostInfo Y -- R -- GetHost Y Y R R GetHostInfo Y Y R R ModifyHost Y -- R -- ModifyHostInfo Y -- R -- Table 4-12 Avai
Command line interface commands Table 4-13 Availability of replication commands based on resource group and user permission Command name All Resources User-defined resource group Modify permission View permission Modify permission View permission GetReplicationControllerPair Y Y Y Y ModifyReplication Y -- R -- 4-4 Storage array commands The storage array commands can be used to register, modify, and delete storage subsystem information.
Command line interface commands • • • • • • • • AddWWNForLunGroup DeleteWWNForLunGroup AddLogicalUnit DeleteLogicalUnit ModifyLogicalUnit FormatLU ModifyPort ModifyPortController A user who has only View permission cannot execute this command. A user to whom user-defined resource groups are assigned and who also has Modify permission can specify only storage subsystems that containing accessible LDEVs. If any other storage subsystems are specified, an error occurs.
Command line interface commands Table 4-15 AddHostStorageDomain command parameters Parameter Name Status domain Optional Description DomainID of the host storage domain This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. NOTE: The execution results are output in decimal.
Command line interface commands Table 4-15 AddHostStorageDomain command parameters Parameter Name Status Description • Sequent • HP • Solaris • Netware • Windows • Windows Extension • Tru64 • HI-UX • AIX • OPEN-VMS The following value relies on the DKC microcode version.
Command line interface commands Table 4-15 AddHostStorageDomain command parameters Parameter Name Status XP10000/ SVS200, and XP1024/ XP128) Description NOTE: A nickname cannot begin or end with spaces.
Command line interface commands NOTE: For XP12000/XP10000/SVS200, logical units cannot be created in array groups with chassis numbers from 65 to 96. Array groups with chassis numbers from 65 to 96 are indicated as V-VOLs. NOTE: For XP24000/XP20000, logical units cannot be created in array groups with chassis numbers from 65 to 96, or from 16485 to 16516. Array groups with chassis numbers from 65 to 96, or from 16485 to 16516 are indicated as V-VOLs.
Command line interface commands Table 4-16 AddLogicalUnit command parameters Parameter Name Status Description capacity Required Desired capacity (in KB) for the new LU The specified value is adjusted, depending on the minimum unit that is set to the volume size of each storage subsystem. Therefore, the size of the logical unit that was actually created might exceed the specified value.
Command line interface commands Command execution example: In this example, the CLI command creates a logical unit (capacity: 1,000,080KB, emulation type: OPEN-3) for an array group (chassis number: 4, array group number: 32) in a storage subsystem (serial number: 10001, model: XP1024). The LDEVs used to create the logical unit are obtained from the execution result. hdvmcli AddLogicalUnit -o "D:\logs\XP1024 AddLogicalUnit.
Command line interface commands using logical devices that the user is permitted to access. If LDEVs that are not allowed are specified, an error occurs. Make sure that you back up the data before creating a LUSE volume, because the data stored in the LDEV/LU to be connected might be lost during creation of the LUSE volume. When you create a LUSE volume, specify a formatted LDEV. If you include an unformatted LDEV during creation of the LUSE volume, the LUSE volume will not be recognized from the hosts.
Command line interface commands path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=3 arrayGroup=16 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=1 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 List o
Command line interface commands systemDisk=0 An instance of LDEV objectID=***** devNum=1,002 displayName=3:EA emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=-1 slprNumber=-1 clprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 t
Command line interface commands • • • • • • • • • It has a guard mode of Read/Write. • If the THP pool consists of internal volumes, the logical units must have the same disk drive type. • It is not a system disk. It has an emulation type of OPEN-V. It is not an XP Thin Provisioning Software virtual volume. It is not a command device. It does not have an XP Cache Residency Manager set. It does not have a path. If more than one logical unit is specified, all of them must have the same CLPR number.
Command line interface commands Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands thpPoolID=0 threshold=-1 tcaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=2,370 displayName=00:09:42 emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=64 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex
Command line interface commands NOTE: When using the AddStorageArray command to register storage subsystem information, HP recommends that, for the parameter userid, you specify a different user ID from user IDs that other subsystem management tools use. NOTE: If execution of the AddStorageArray command results in an error, take appropriate action according to the error message, and then re-execute the AddStorageArray command.
Command line interface commands Table 4-19 AddStorageArray command parameters Parameter Name Status Description searchcommunity Optional SNMP Community string, used for identifying device elements via SNMP (for XP512/ (XP512/XP48 array) XP48) Default is public.
Command line interface commands Command execution result: RESPONSE: An instance of StorageArray objectID=***** name=XP1024@172.16.45.1 description=XP1024 (10001) at 172.16.45.
Command line interface commands numberOfOpenUnallocatedLUs=990 numberOfImAllocatedLUs=0 numberOfImUnallocatedLUs=0 numberOfMfLDEVs=0 numberOfAllocatedMfLDEVs=0 numberOfUnallocatedMfLDEVs=0 productCode=1 lastRefreshed=1,039,003,476 autoFormatLU=-1 statusOfDBInconsistency=0 openAllocatedActualCapacity=1,578,120,480 openUnallocatedCapacity=2,442,665,520 openUnallocatedActualCapacity=2,442,665,520 openReservedCapacity=4,806,720 openReservedActualCapacity=4,806,720 numberOfReservedLUs=2 numberOfOpenReservedLUs=2
Command line interface commands Format when the command is used to create THP volumes in an existing virtual volume group: hdvmcli [URL] AddVirtualVolume model=model serialnum=serial-number groupoption=exist arraygroupname=name-of-virtual-volume-group capacity=capacity-of-virtualvolumes [numoflus=number-of-THP-volumes] [devnum=device-number-of-logical-unit] [poolid=pool-ID-of-THP-pool [threshold=usage-rate-threshold-of-THP-volumes]] [capacitytype={BK|block}] If you use the poolid parameter to specify the p
Command line interface commands Table 4-20 AddVirtualVolume command parameters Parameter Name Status Description numoflus Optional Number of THP volumes Specify the number of THP volumes to be created. If this parameter is omitted, 1 is set. devnum Optional Device number of the logical unit 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.
Command line interface commands diskType= diskSize=-1 diskSizeInKB=-1 controllerID=-1 totalCapacity=419,430,400 allocatedCapacity=0 freeCapacity=419,430,400 autoLunCapacity=0 onDemandCapacity=0 totalFreeSpace=2,801,729,280 largestFreeSpace=2,801,729,280 substance=0 slprNumber=0 clprNumber=0 cuInfo= openTotalCapacity=419,430,400 openAllocatedCapacity=0 openFreeCapacity=419,430,400 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDem
Command line interface commands businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=-1 thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=10 tcaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***** devNum=12,288 displayName=00:30:00 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=209,715,200 lba=419,430,400 raidType=substance=0 volumeType=-1 slotSizeInKB=48 chass
Command line interface commands commandDeviceSecurity=false chassis=16,485 arrayGroup=199 raidType=Unknown 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=10 tcaPoolID=-1 List of 1 Ldev elements: An instance of LDEV objectID=***
Command line interface commands sizeInKB=2,801,729,280 cylinders=0 fsControlIndex=0 *****: The value is encoded by the CLI. 4-4-8 DeleteArrayReservation DeleteArrayReservation unlocks the target storage subsystem (see Table 4-21). A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned, and who also has Modify permission, can execute this command for any resources.
Command line interface commands Table 4-22 DeleteHostStorageDomain command parameters Parameter Name Status domain Optional Description The domain ID of the host storage domain to be deleted This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. NOTE: The execution results are output in decimal. NOTE: Do not specify 0. You cannot delete host domain 0. NOTE: You must specify either domain or domainnickname.
Command line interface commands Table 4-23 DeleteLogicalUnit command parameters Parameter Name Status devnum Required Description This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48, use the xx:yy format, where xx is the CU number, and yy is the LDEV number. For XP24000/XP20000, use the ww:xx:yy format, where ww is the LDKC number, xx is the CU number, and yy is the LDEV number.
Command line interface commands Command execution result: RESPONSE: (Command completed; empty list returned) 4-4-12 DeletePool DeletePool deletes a THP pool, and releases the assignations to the pool volumes that made up the THP pool (see Table 4-25). A user who has only View permission cannot execute this command. A user to whom user-defined resource groups are assigned, and who also has Modify permission, can execute this command for any resources.
Command line interface commands NOTE: If execution of the DeleteStorageArray command results in an error, take appropriate action according to the error message, and then re-execute the DeleteStorageArray command. When the DeleteStorageArray command is executed, the configuration information of the target storage subsystem is divided into transactions, and then deleted from the Device Manager database.
Command line interface commands Table 4-27 DeleteVirtualVolume command parameters Parameter Name Status Description model Required Model of the storage subsystem serialnum Required Serial number of the storage subsystem deletionoption Optional Specifies whether to delete virtual volumes that have not been released from the THP pool. To delete such THP volumes, specify force. arraygroupnames Optional Name(s) of the virtual volume group(s). Use a comma to delimit multiple values.
Command line interface commands NOTE: When formatting the LDEV, make sure that the value of the status attribute of the LDEV is Blocked. If the value of status is Normal, specify true in the force parameter when you format the LDEV. NOTE: If the LUSE volume you want to specify includes an LDEV whose status is not Blocked, delete that LUSE volume, and then execute the command. NOTE: If you execute this command while LDEVs are being formatted in the target storage subsystem, an error occurs.
Command line interface commands Command execution example: hdvmcli -t formatlu model=XP12000 serialnum=82893 devnums=3:E8,3:E9 Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands slotSizeInKB=64 chassis=1 arrayGroup=144 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=-1 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Format thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1 systemDisk=0 An instance of LogicalUnit objectID=***** devNum=1,001 displayName=03:E9 emulation=OPEN-V devCount=1 devType= capacityInKB=48,000 path=false commandDevice=false commandDeviceEx=0 commandDevice
Command line interface commands displayName=03:E9 emulation=OPEN-V cylinders=0 isComposite=0 sizeInKB=48,000 lba=24,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=64 chassis=1 arrayGroup=144 path=false onDemandDevice=false devType= isStandardLDEV=false guardMode= diskType=-1 slprNumber=0 clprNumber=0 cacheResidencyMode=0 stripeSizeInKB=-1 volumeKind=3 status=Format thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1 systemDisk=0 *****: The values are encoded by the CLI.
Command line interface commands 4-4-17 GetStorageArray GetStorageArray obtains information about storage subsystems managed by the Device Manager server. To acquire the information about a specific element or to narrow down the range of information acquired by specifying conditions, use the parameter subtarget, the subinfo parameters (such as the parameters arraygroupsubinfo and lusubinfo), and other parameters of the GetStorageArray command.
Command line interface commands Table 4-29 Element information that can be acquired by using the parameter subtarget Value of subtarget Information that can be acquired Location LogicalUnit Information about logical units (LUs) 4-4-17-12 Path Information about paths 4-4-17-13 PDEV Information about PDEVs 4-4-17-14 Pool Information about journal pools (for XP Snapshot, XP Continuous Access Journal Software, or XP Thin Provisioning Software) 4-4-17-15 Port Information about ports 4-4-17-16
Command line interface commands Table 4-30 subinfo parameters that can be used together with the parameter subtarget Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information LogicalUnit lusubinfo The following information about logical units can be acquired: • LDEV: LDEV information • Path: Path information • VolumeConnection: Mapping information of external volumes for LDEVs pathsubinfo Specify Path for the parameter l
Command line interface commands Table 4-30 subinfo parameters that can be used together with the parameter subtarget Value of the parameter subtarget Specifiable subinfo parameter Value to be specified for the subinfo parameter and acquirable information Port portsubinfo The following information about ports can be acquired: • HostStorageDomain: Host storage domain information • LUNGroup: LUN group information • WWN: WWN information • WWNGroup: WWN group information wwngroupsubinfo You can specify
Command line interface commands Table 4-31 shows examples of specifying the parameter subtarget and the subinfo parameters.
Command line interface commands microcodeVersion=01-13-56/00 agentVersion=02-01-06/00 productName=XP512 controllerVersion=01-18-01-00/00 numberOfControllers=1 capacityInGB=1,329 cacheInMB=7,168 sharedMemoryInMB=-1 numberOfSpareDrives=-1 freeCapacityInGB=338 allocatedCapacityInGB=990 autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=110 largestFreeSpaceInGB=63 capacityInKB=1,393,925,040 freeCapacityInKB=355,420,800 allocatedCapacityInKB=1,038,504,240 autoLunCapacityInKB=0 onDemandCapacityInKB=0
Command line interface commands statusOfDBInconsistency=0 openAllocatedActualCapacity=1,038,504,240 openUnallocatedCapacity=355,420,800 openUnallocatedActualCapacity=355,420,800 openReservedCapacity=0 openReservedActualCapacity=0 numberOfReservedLUs=0 numberOfOpenReservedLUs=0 numberOfImReservedLUs=0 *****: The value is encoded by the CLI.
Command line interface commands Table 4-33 GetStorageArray (subtarget=ArrayGroup) command parameters Parameter Name Status Description startElementNumF Optional ilter Starting sequence number of array groups for which information is to be obtained Specify this parameter when you want to obtain information for a part of array groups in a specific storage subsystem.
Command line interface commands clprNumber=-1 cuInfo= openTotalCapacity=418,184,640 openAllocatedCapacity=266,772,960 openFreeCapacity=149,008,320 openAutoLunCapacity=2,403,360 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=266,772,960 openUnallocatedCapacity=149,008,320 openUnallocatedActualCapacity=149
Command line interface commands autoLunCapacity=0 onDemandCapacity=0 totalFreeSpace=3,223,296 largestFreeSpace=1,545,984 substance=0 slprNumber=-1 clprNumber=-1 openTotalCapacity=209,638,800 openAllocatedCapacity=192,256,560 openFreeCapacity=17,382,240 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocat
Command line interface commands Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters userID=root ipAddress=172.16.45.1 4-4-17-5 GetStorageArray (subtarget=Component) GetStorageArray (subtarget=Component) obtains information about the configuration of one or all storage subsystems (see parameters in Table 4-35).
Command line interface commands autoLunCapacityInGB=0 onDemandCapacityInGB=0 totalFreeSpaceInGB=110 largestFreeSpaceInGB=63 capacityInKB=1,393,925,040 freeCapacityInKB=355,420,800 allocatedCapacityInKB=1,038,504,240 autoLunCapacityInKB=0 onDemandCapacityInKB=0 totalFreeSpaceInKB=115,723,440 largestFreeSpaceInKB=67,096,800 multipathSupport=1 securityStatus=1 sequenceNumber=10011 displayArrayFamily=XP512/48 displayArrayType=XP512 numberOfLUs=643 numberOfAllocatedLUs=453 numberOfUnallocatedLUs=190 slprStatus=-
Command line interface commands name=DKC Battery value=1 description=Normal An instance of Component name=DKC Cache value=1 description=Normal An instance of Component name=DKC Cache Switch value=1 description=Normal An instance of Component name=DKC Environment value=1 description=Normal 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=1 description=Normal An instance
Command line interface commands Table 4-36 GetStorageArray (subtarget=Filter) command parameters Parameter Name Status Description model Optional Model of the storage subsystem If you omit this parameter, you will obtain information about the models of all storage subsystems. serialnum Optional Serial number of the storage subsystem If you omit this parameter, all the storage subsystems become the target. subtarget Required Specify Filter.
Command line interface commands securityStatus=2 sequenceNumber=10001 displayArrayFamily=XP1024/128 displayerrayType=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 openAutoLunCapacity=4,806,720 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapaci
Command line interface commands Table 4-37 GetStorageArray (subtarget=Freespace) command parameters Parameter Name Status Description model Optional Model of the storage subsystem If you omit this parameter, all the storage subsystems become the target. serialnum Optional Serial number of the storage subsystem If you omit this parameter, all the storage subsystems become the target. subtarget Required Specify FreeSpace.
Command line interface commands openAutoLunCapacity=2,403,360 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocatedCapacity=0 openAllocatedActualCapacity=266,772,960 openUnallocatedCapacity=149,008,320 openUnallocatedActualCapacity=149,008,320 openReservedCapacity=2,403,360 openReservedActualCapacity=2,403,360 type=0 List of 1 FreeSpace elements: A
Command line interface commands freeCapacity=76,943,520 autoLunCapacity=0 onDemandCapacity=0 totalFreeSpace=1,492,992 largestFreeSpace=1,492,992 substance=0 slprNumber=-1 clprNumber=-1 openTotalCapacity=211,531,680 openAllocatedCapacity=134,588,160 openFreeCapacity=76,943,520 openAutoLunCapacity=0 openOnDemandCapacity=0 imTotalCapacity=0 imAllocatedCapacity=0 imFreeCapacity=0 imAutoLunCapacity=0 imOnDemandCapacity=0 mfTotalCapacity=0 mfAutoLunCapacity=0 mfOnDemandCapacity=0 mfAllocatedCapacity=0 mfUnallocat
Command line interface commands Table 4-38 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter Name Status Description domain Optional 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.
Command line interface commands Table 4-38 GetStorageArray (subtarget=HostStorageDomain) command parameters Parameter Name Status Description startElementNumF Optional ilter 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 subsystem.
Command line interface commands . . (repeated for other FreeLUN instances) . List of 1 Path elements: An instance of Path objectID=***** devNum=10 portID=23 domainID=1 scsiID=15 LUN=10 wwnSecurityValidity=true *****: The values are encoded by the CLI. 4-4-17-9 GetStorageArray (subtarget=JournalPool) GetStorageArray (subtarget=JournalPool) obtains information about journal pools for XP Snapshot or XP Continuous Access Journal Software (see parameters in Table 4-39).
Command line interface commands Table 4-39 GetStorageArray (subtarget=JournalPool) command parameters Parameter Name Status Description subtarget Required Specify JournalPool. model Optional Model of the storage subsystem If you omit this parameter, all the storage subsystems become the target. serialnum Optional Serial number of the storage subsystem If you omit this parameter, all the storage subsystems become the target.
Command line interface commands List of 256 JournalPool elements: An instance of JournalPool objectID=***** poolFunction=4 poolID=0 controllerID=-1 poolType=2 List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=3,024 displayName=B:D0 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousA
Command line interface commands defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=0 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 An instance of JournalPool objectID=***** poolFunction=4 poolID=1 controllerID=-1 poolType=0 List of 2 ReplicationInfo elements: An instance of Replication
Command line interface commands An instance of LogicalUnit objectID=***** devNum=3,025 displayName=B:D1 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=Simplex snapshotVolumeType=Simplex journalVolumeType=JNL-VOL sysVolFlag=0 externalVolume=0 differential
Command line interface commands Table 4-40 GetStorageArray (subtarget=LDEV) command parameters Parameter Name Status Description model Optional Model of the storage subsystem If you omit this parameter, all the storage subsystems become the target. serialnum Optional Serial number of the storage subsystem If you omit this parameter, all the storage subsystems become the target. subtarget Required Specify LDEV.
Command line interface commands Command execution example: In this example, the CLI command obtains information about a specific LDEV (device number: 0) in a storage subsystem (serial number: 10001, model: XP12000). hdvmcli GetStorageArray -o "D:\logs\XP12000 GetStorageArray_LDEV.log" subtarget=LDEV model=XP12000 serialnum=10001 devnum=0 "ldevsubinfo=VolumeConnection" "ldevfilter=open" Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands productName=1024 vendor= HP . . (repeated for other LDEV instances) . *****: The values are encoded by the CLI. 4-4-17-11 GetStorageArray (subtarget=LogicalDKC) GetStorageArray (subtarget=LogicalDKC) obtains the information about the logical DKC in one or all storage subsystems (see parameters in Table 4-41). Table 4-41 GetStorageArray (subtarget=LogicalDKC) command parameters Parameter Name Status Description subtarget Required Specify LogicalDKC.
Command line interface commands onDemandCapacityInKB=0 totalFreeSpaceInKB=3,239,433,148 largestFreeSpaceInKB=516,113,664 multipathSupport=1 securityStatus=2 sequenceNumber=10037 displayArrayFamily=XP24K displayArrayType= XP24000 numberOfLUs=4,443 numberOfAllocatedLUs=630 numberOfUnallocatedLUs=3,813 slprStatus=0 openTotalCapacity=7,934,066,016 openAllocatedCapacity=851,452,736 openFreeCapacity=7,073,394,400 openAutoLunCapacity=9,218,880 openOnDemandCapacity=0 imTotalCapacity=399,016,800 imAllocatedCapacity=
Command line interface commands 4-4-17-12 GetStorageArray (subtarget=LogicalUnit) GetStorageArray (subtarget=LogicalUnit) obtains the information about one or all logical units (LUs) in one or all storage subsystems (see parameters in Table 4-42). A user to whom a user-defined resource group is assigned can obtain information about one or all logical units in one or all storage subsystems that the user is permitted to access.
Command line interface commands Table 4-42 GetStorageArray (subtarget=LogicalUnit) command parameters Parameter Name Status Description ldevsubinfo Optional Information about the LDEV The value you can specify is VolumeConnection. If you specify this parameter, you must also specify the lusubinfo=LDEV. thpvolfilter Optional Filter for selecting a THP volume Specify either the pool ID of a THP pool, or Unassigned.
Command line interface commands devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 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 thp
Command line interface commands raidType=RAID5(3D+1P) substance=1 volumeType=3 slotSizeInKB=48 chassis=1 arrayGroup=16 path=true onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=-1 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Normal thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1 systemDisk=0 List of 1 VolumeConnection elements: An instance of VolumeConnection objectid=***** mappedArrayType=XP12000 mappedSerialNumber=10001 mappedDevNum
Command line interface commands Table 4-43 GetStorageArray (subtarget=Path) command parameters Parameter Name Status Description subtarget Required Specify Path. objectid Optional Object ID of the path 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.
Command line interface commands domainID=0 scsiID=15 LUN=0 wwnSecurityValidity=true . . (repeated for other Path instances) . An instance of Path objectID=***** devNum=99 portID=7 domainID=0 scsiID=15 LUN=99 wwnSecurityValidity=true List of 256 WWN elements: An instance of WWN WWN=88.77.77.77.77.77.00.01 nickname=Jane An instance of WWN WWN=88.77.77.77.77.77.00.02 nickname=Jone . . (repeated for other WWN instances) . *****: The values are encoded by the CLI.
Command line interface commands WWN=88.77.77.77.77.77.00.02 nickname=Jone *****: The value is encoded by the CLI. 4-4-17-14 GetStorageArray (subtarget=PDEV) GetStorageArray (subtarget=PDEV) obtains the information about a PDEV in one or all storage subsystems (see parameters in Table 4-44). A user to whom a user-defined resource group is assigned can obtain information about one or all PDEVs in one or all storage subsystems that the user is permitted to access.
Command line interface commands objectID=***** chassis=1 arrayGroup=0 capacityInKB=75,497,472 row=-1 column=-1 depth=-1 role= vendor= model=DKR2D-J072FC firmwareVersion= serialNumber= dkuType=XP1024 rpm=-1 diskType=-1 pdevid=1 . . (repeated for other PDEV instances) . *****: The value is encoded by the CLI.
Command line interface commands Table 4-45 GetStorageArray (subtarget=Pool) command parameters Parameter Name Status Description model Optional Model of the storage subsystem If you omit this parameter, all the storage subsystems become the target. serialnum Optional Serial number of the storage subsystem If you omit this parameter, all the storage subsystems become the target. subtarget Required Specify Pool.
Command line interface commands Command execution example: In this example, the GetStorageArray (subtarget=Pool) command obtains information about the journal pool in a storage subsystem (serial number: 14050, model: XP12000). The information includes information about the logical unit, paired journal pool and replication in the journal pool. hdvmcli GetStorageArray -o "D:\logs\XP12000\GetStorageArray_Pool.
Command line interface commands differentialManagement=false snapshotPoolID=-1 journalPoolID=0 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=3,028 displayName=B:D4 emulation=OPEN-V devCount=1 devType= capacityInKB=1,638,720 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=2 arrayGroup=54 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeTy
Command line interface commands List of 2 ReplicationInfo elements: An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType= XP12000 pvolDevNum=3,033 pvolObjectID=**** pvolPoolID=1 svolSerialNumber=14053 svolArrayType=Unknown svolDevNum=3,033 svolPoolID=1 replicationFunction=ContinuousAccessJournal status=17 muNumber=0 copyTrackSize=-1 splitTime=-1 An instance of ReplicationInfo objectID=***** pvolSerialNumber=14050 pvolArrayType= XP12000 pvolDevNum=3,034 pvolObjectID=**** pvolPoo
Command line interface commands sysVolFlag=0 externalVolume=0 differentialManagement=false snapshotPoolID=-1 journalPoolID=1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 List of 1 PairedPool elements: An instance of PairedPool muNumber=0 pairedArrayType=Unknown pairedSerialNumber=14053 pairedPoolID=1 . . (repeated for other Pool instances) . *****: The value is encoded by the CLI.
Command line interface commands Table 4-46 GetStorageArray (subtarget=Port) command parameters Parameter Name Status Description portsubinfo Optional Specific information about the ports The values you can specify are WWN, WWNGroup, LUNGroup, or HostStorageDomain. If you specify multiple values at the same time, separate the values by commas. wwngroupsubinfo# Optional Information obtained from a WWN group Specify WWNGroup in the parameter portsubinfo when using this parameter.
Command line interface commands nickname=Jane An instance of WWN WWN=00.00.00.00.00.00.00.
Command line interface commands Table 4-47 GetStorageArray (subtarget=PortController) command parameters Parameter Name Status Description controllernum Optional Controller ID of the port controller in the storage subsystem Specify this parameter when you want to obtain information about a specific port controller. If you specify this parameter, you must also specify the model and serialnum parameters.
Command line interface commands Command execution result 2: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) . List of 1 PortController elements: An instance of PortController objectID=***** cluster=1 card=1 controllerID=1 displayName=CHA-1P mode=1 type=12 *****: The value is encoded by the CLI.
Command line interface commands Table 4-48 GetStorageArray (subtarget=ReplicationInfo) command parameters Parameter Name Status Description startElementNumF Optional ilter Starting sequence number of performed replications for which information is to be obtained Specify this parameter when you want to obtain information for a part of replications in a specific storage subsystem.
Command line interface commands List of 2 Lu elements: An instance of LogicalUnit objectID=***** devNum=100 displayName=00:64 emulation=OPEN-3 devCount=1 devType= capacityInKB=2,403,360 path=true commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=16 raidType=RAID5(3D+1P) currentPortController=-1 defaultPortController=-1 isComposite=0 continuousAccessVolumeType=Simplex businessCopyVolumeType=P-VOL snapshotVolumeType=Simplex journalVolumeType=Simplex sysVolFlag=0 externalVo
Command line interface commands externalVolume=0 differrentialManagement=false SnapshotPoolID=-1 journalPoolID=-1 thpType=-1 consumedCapacityInKB=-1 thpPoolID=-1 threshold=-1 tcaPoolID=-1 . . (repeated for other ReplicationInfo instances) . *****: The values are encoded by the CLI. 4-4-18 ModifyArrayReservation ModifyArrayReservation extends the period of time that can elapse before the target storage subsystem is unlocked (see Table 4-49). Reservation affects only Storage Array Commands and LUN Commands.
Command line interface commands 4-4-19 ModifyLogicalUnit ModifyLogicalUnit modifies the LU and its corresponding LDEV in a storage device (see Table 4-50). A user to whom a user-defined resource group is assigned, and who has only View permission cannot execute this command.
Command line interface commands Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands Format when the command is used to change the usage rate threshold of a THP pool: hdvmcli [URL] ModifyPool model=model serialnum=serial-number poolid=pool-ID threshold=usage-rate-threshold-of-THP-pool NOTE: When you use this command to expand a THP pool, the logical units specified to be used as pool volumes must satisfy the conditions listed in 4-4-5 .
Command line interface commands status=0 threshold=75 threshold2=80 capacityInKB=31,458,240 freeCapacityInKB=31,458,240 usageRate=0 numberOfPoolVols=3 numberOfVVols=0 capacityOfVVolsInKB=0 clprNumber=0 List of 3 Lu elements: An instance of LogicalUnit objectID=***** devNum=2,369 displayName=00:09:41 emulation=OPEN-V devCount=1 devType= capacityInKB=10,486,080 path=false commandDevice=false commandDeviceEx=0 commandDeviceSecurity=false chassis=1 arrayGroup=64 raidType=RAID5(3D+1P) currentPortController=-1 de
Command line interface commands arrayGroup=64 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=0 threshold=-1 tcaPoolID=-1 An instance of LogicalUnit objectID=***** devNum=2,371 displayName=00:09:43 emulation=O
Command line interface commands 4-4-21 ModifyPort ModifyPort changes port and host storage domain attributes (see parameters in Table 4-52, Table 4-53, and Table 4-54). A user to whom a user-defined resource group is assigned, and who has only View permission cannot execute this command.
Command line interface commands Table 4-52 ModifyPort command parameters Parameter Name Status Description fibreaddr Optional New Fibre Channel address for the port (the hex string representation) channelspeed Optional (for XP24000/ XP20000, XP12000/ XP10000/ SVS200, XP1024/ XP128) New transmission speed of a Fibre Channe for the port You can specify the following values. For XP24000/XP20000 and XP12000/XP10000/SVS200: • 1: 1 Gbps • 2: 2 Gbps • 4: 4 Gbps • 10: 10 Gbps For XP12000/XP10000/SVS200.
Command line interface commands Table 4-52 ModifyPort command parameters Parameter Name Status nickname Optional (for XP24000/ XP20000, XP12000/ XP10000/ SVS200, XP1024/ XP128) 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.
Command line interface commands Table 4-52 ModifyPort command parameters Parameter Name Status wwnnickname Optional (for XP24000/ XP20000, XP12000/ XP10000/ SVS200, XP1024/ XP128) Description The nickname for the WWN To specify two or more WWN nicknames, separate them with commas. The value specified for this parameter differs depending on whether wwn is specified. If wwn is specified: Specify the new nickname for WWN.
Command line interface commands Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48 Storage Subsystem Available Values for Setting the HostMode Parameter XP24000/XP20000 Possible values are: • Standard • VMware • HP • OpenVMS • Tru64 • Solaris • NetWare • Windows • AIX • VMware Extension • Windows Extension • UVM XP12000/XP10000/SVS200 Possible values are: • Standard • Sequent • HP • Solaris • Netware • Windows • Win
Command line interface commands Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48 Storage Subsystem Available Values for Setting the HostMode Parameter XP24000/XP20000 Possible values are: • Standard • VMware • HP • OpenVMS • Tru64 • Solaris • NetWare • Windows • AIX • VMware Extension • Windows Extension • UVM XP1024/XP128 Possible values are: • Standard • Sequent • HP • Solaris • Netware • Windows • Windows Exten
Command line interface commands Table 4-53 Available values for setting the hostmode parameter for XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48 Storage Subsystem Available Values for Setting the HostMode Parameter XP24000/XP20000 Possible values are: • Standard • VMware • HP • OpenVMS • Tru64 • Solaris • NetWare • Windows • AIX • VMware Extension • Windows Extension • UVM XP512/XP48 Possible values are: • Standard • Sequent • HP • Solaris • Netware • Windows • Tru64 • AIX • O
Command line interface commands Table 4-54 hostModeOption parameter values and description hostModeOption Values Description 7 Specify this value when both of the following conditions are satisfied: • The host connection mode is set to Standard (mode 00) or Solaris (mode 09). • You want to let the system automatically recognize the reduction and increase in the number of devices while a SUN host bus adapter is in use.
Command line interface commands • 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 Channe address to 73 Disables XP LUN security by specifying false Sets the transmission speed of the Fibre Channe to 1 hdvmcli ModifyPort -o "D:\logs\XP1024 ModifyPort.
Command line interface commands 4-4-22 ModifyPortController ModifyPortController supports changing characteristics of a PortController (see Table 4-55). A user to whom a user-defined resource group is assigned, and who has only View permission cannot execute this command.
Command line interface commands NOTE: This command can be used only with XP24000/XP20000 storage subsystems.
Command line interface commands Table 4-56 ModifyVirtualVolume command parameters Parameter Name Status Description threshold Optional Usage rate threshold for the THP volumes (%) Specify this parameter when you are assigning THP volumes to a THP pool, or when you are changing the threshold value. Specify a multiple of 5 from 5 to 300. If omitted, 5 is set. If this parameter is omitted when true is specified for the assign parameter, 5 is set.
Command line interface commands thpType=0 consumedCapacityInKB=0 thpPoolID=0 threshold=15 tcaPoolID=-1 *****: The value is encoded by the CLI. 4-4-24 RefreshStorageArrays RefreshStorageArrays refreshes the configuration information of all storage subsystems by performing a re-discovery operation on each storage subsystem that is managed by the Device Manager.
Command line interface commands . List of 1 CommParameters elements: An instance of CommParameters userID= root ipAddress2=172.16.50.2 ipAddress=172.16.50.1 ] [An instance of StorageArray . (Attributes of StorageArray are omitted here) . List of 1 CommParameters elements: An instance of CommParameters snmpWrCommunity=public ipAddress=172.16.40.1 snmpRdCommunity=public snmpPort=161 ] . . (repeated for other StorageArray instances) .
Command line interface commands Table 4-58 AddLogicalGroup command parameters Parameter Name Status groupname Required Description Name for the new logical group This must be unique among groups within its parent (if the parent parameter is supplied) or unique among top-level groups (if no parent is specified). The number of characters that can be used for a group name is 1-64 bytes. NOTE: Spaces at the beginning or end of a group name are not registered.
Command line interface commands realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 *****: The value is encoded by the CLI. Command execution example 2: hdvmcli AddLogicalGroup -o "D:\logs\AddLogicalGroup.log" "groupname=toro" "iconfile=group12.gif" "parent=*****" *****: The value is encoded by the CLI. Command execution result 2: RESPONSE: An instance of LogicalGroup objectID=***** name=toro logicalPath=root/toro parentID=***** icon=group12.
Command line interface commands List of 94 HostStorageDomain elements: An instance of HostStorageDomain objectID=***** portID=0 domainID=0 hostMode=HP displayName=CL1-A-0 domainType=0 nickname=1A-G00 . . (repeated for other HostStorageDomain instances) . List of 283 Path elements: An instance of Path objectID=***** devNum=101 portID=0 domainID=0 scsiID=15 LUN=8 wwnSecurityValidity=true . . (repeated for other Path instances) . *****: The values are encoded by the CLI.
Command line interface commands Command execution example: hdvmcli AddObjectForLogicalGroup -o "D:\logs\XP1024 AddObjectForLogicalGroup.log" "objectID=*****" "groupelements=*****" *****: The values are encoded by the CLI. Command execution result: RESPONSE: An instance of LogicalGroup objectID=***** name=toro parentID=***** logicalPath=root/toro icon=group12.
Command line interface commands Command execution example: hdvmcli DeleteLogicalGroup -o "D:\logs\DeleteLogicalGroup.log" "objectid=*****" *****: The value is encoded by the CLI. Command execution result: RESPONSE: (Command completed; no data returned) 4-5-5 DeleteObjectForLogicalGroup DeleteObjectForLogicalGroup deletes the specified object from a logical group (see Table 462). A user who has only View permission cannot execute this command.
Command line interface commands A user to whom a user-defined resource group is assigned can obtain information about logical groups that the user is permitted to access. Table 4-63 GetLogicalGroup command parameters Parameter Name Status objectid Optional Description Object ID of the desired logical group Omit this parameter to include all logical groups. Specify the objectID obtained from another CLI response. The value is encoded by the CLI.
Command line interface commands portID=0 domainID=0 scsiID=15 LUN=8 wwnSecurityValidity=true . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. Command execution example 2: hdvmcli GetLogicalGroup -o "D:\logs\GetLogicalGroup.log" "objectID=*****" "subtarget=Host,HostStorageDomain,path" *****: The value is encoded by the CLI. Command execution result 2: RESPONSE: An instance of LogicalGroup objectID=***** name=toro parentID=***** logicalPath=root/toro icon=group12.
Command line interface commands Command execution result 3: RESPONSE: An instance of LogicalGroup objectID=***** name=toro parentID=***** logicalPath=root/toro icon=group12.gif capacity=0 capacityInKB=0 realCapacityInKB=0 percentUsed=0 numberOfLUNs=0 . . (repeated for other LogicalGroup instances) . *****: The values are encoded by the CLI. 4-5-7 ModifyLogicalGroup ModifyLogicalGroup changes one or more characteristics of an existing logical group (see Table 4-64).
Command line interface commands Table 4-64 ModifyLogicalGroup command parameters Parameter Name Status parent Optional Description Object ID of the logical group under which the logical group is moved This must be the valid ID of a group and the parent must either contain only other groups or be empty. If you omit this parameter, the group's parent is not modified. NOTE: Do not specify the parent and parentpath parameter at the same time, as this might cause an error to occur.
Command line interface commands Format for the XP24000/XP20000, XP12000/XP10000/SVS200, and XP1024/XP128: hdvmcli [URL] AddLun [options] serialnum=serial-number model=model-name [name=name] {port=port-number|portname=port-name} domain=domain-ID [scsi=SCSIID] lun=valid-LUN [{devnum=device-number|lusedevnums=list-of-LDEV-numbers}] Format for the XP512/XP48: hdvmcli [URL] AddLun [options] serialnum=serial-number model=model-name [name=name] {port=port-number|portname=port-name} [scsi=SCSI-ID] lun=valid-LUN {
Command line interface commands Table 4-65 AddLun command parameters Parameter Name Status devnum Optional Description Device number used to identify the new path (not provided when a LUSE is defined) This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48, use the xx:yy format, where xx is the CU number, and yy is the LDEV number.
Command line interface commands displayName=00:7F emulation=OPEN-8 cylinders=50 isComposite=1 sizeInKB=36,000 lba=72,000 raidType=RAID5(3D+1P) substance=0 volumeType=-1 slotSizeInKB=48 chassis=1 arrayGroup=7 path=true onDemandDevice=false devType= isStandardLDEV=false diskType=-1 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1 systemDisk=0 An instance of LDEV objectID=***** devNum=128 displayName=00:80 e
Command line interface commands thpPoolID=-1 threshold=-1 systemDisk=0 List of 1 WWN elements: An instance of WWN WWN=AA.AA.AA.AA.AA.AA.AA.AA *****: The values are encoded by the CLI. Command execution example 2: hdvmcli AddLun -o "D:\logs\XP1024\AddLun.log" "serialnum=10001" "model=XP1024" "name=hp" "port=1" "domain=4" "scsi=15" "lun=114" "lusedevnums=1001,1002" Command execution result 2: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands thpType=-1 consumedSizeInKB=-1 thpPoolID=-1 threshold=-1 systemDisk=0 An instance of LDEV objectID=***** devNum=1,002 displayName=03:EA emulation=OPEN-3 cylinders=0 isComposite=1 sizeInKB=2,403,360 lba=1,201,680 raidType=RAID5(3D+1P) substance=0 volumeType=3 slotSizeInKB=48 chassis=3 arrayGroup=16 path=false onDemandDevice=false devType= isStandardLDEV=true guardMode= diskType=-1 slprNumber=-1 clprNumber=-1 cacheResidencyMode=-1 stripeSizeInKB=-1 volumeKind=3 status=Blocked t
Command line interface commands scsiID=15 LUN=120 wwnSecurityValidity=true *****: The value is encoded by the CLI. 4-6-2 AddLunGroup AddLunGroup adds a LUN group to a port on the target storage subsystem. The path from the host is set for the LUN group added to the port (see Table 4-66). A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned, and who also has Modify permission, can execute this command for any resources.
Command line interface commands . List of 1 Port elements: An instance of Port . . (Attributes of Port are omitted here) . List of 1 LUNGroup elements: An instance of LUNGroup objectID=***** name=hp nickname=hp List of 2 Path elements: An instance of Path objectID=***** devNum=0 portID=19 domainID=16 scsiID=15 LUN=8 wwnSecurityValidity=true . . (repeated for other Path instances) . *****: The values are encoded by the CLI.
Command line interface commands Table 4-67 AddWWNForHostStorageDomain command parameters Parameter Name Status port Optional Description Port ID of the host storage domain NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur. portname Optional Port name of the host storage domain NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur.
Command line interface commands Command execution example: hdvmcli AddWWNForHostStorageDomain -o "D:\logs\XP1024 AddWWNForHostStorageDomain.log" "serialnum=10001" "model=XP1024" "port=1" "domain=1" "wwn=22.33.44.55.44.55.44.33,11.33.22.33.44.33.22.22" Command execution result: RESPONSE: An instance of StorageArray . . (Attributes of StorageArray are omitted here) .
Command line interface commands Table 4-68 AddWWNForLun command parameters Parameter Name Status Description domain Required Domain ID of the path This parameter can be specified in decimal and hexadecimal. If you specify a hexadecimal number, add the 0x prefix. NOTE: The execution results are output in decimal. devnum Required Device number used to identify the path This parameter can be specified in decimal, and in colon-separated hexadecimal.
Command line interface commands Table 4-69 AddWWNForLunGroup command parameters Parameter Name Status Description serialnum Required Serial number of the storage array in which the LUN group exists model Required Model of the storage array in which the LUN group exists port Optional Port number of the LUN group NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur.
Command line interface commands is 127. Only WWNs not used for a port can be added. WWNs already existing in a port cannot be added. A maximum of 127 WWN groups can be set to a port. For the WWNs to be grouped into a WWN group, you can specify only the WWNs already set for a port or WWNs newly created. The WWNs that you specify are added to the port. You cannot add a WWN that belongs to a different WWN group, or to a different LUN or LUN group.
Command line interface commands . List of 1 WWNGroup elements: An instance of WWNGroup objectID=***** name=hp nickname=hp List of 2 WWN elements: An instance of WWN WWN= AA.AA.AA.AA.AA.AA.AA.AA nickname=Jane An instance of WWN WWN= BB.BB.BB.BB.BB.BB.BB.BB nickname=Jone *****: The value is encoded by the CLI. 4-6-7 DeleteLun DeleteLun deletes paths set from a host to a volume (see Table 4-71). If the LUN is secured, the corresponding WWN is required.
Command line interface commands Command execution example: hdvmcli DeleteLun -o "D:\logs\XP1024 DeleteLun.log" "serialnum=10001" "model=XP1024" "port=1" "domain=1" "devnum=1" "deletionoption=lusekeep" Command execution result: RESPONSE: (Command completed; no data returned) 4-6-8 DeleteLunGroup DeleteLunGroup deletes a LUN groups allocated to ports on the target storage subsystem. Any LUNs (paths) in the group are not deleted (see Table 4-72).
Command line interface commands Table 4-73 DeleteWWN command parameters Parameter Name Status Description serialnum Required Serial number of the port's storage array model Required Model of the port's storage array port Optional Port number NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur. portname Optional Port name NOTE: Specify either port or portname. Do not specify both parameters at the same time.
Command line interface commands Table 4-74 DeleteWWNForHostStorageDomain command parameters Parameter Name Status Description domainnickname Optional (for XP24000/ XP20000, XP12000/ XP10000/ SVS200, and XP1024/ XP128) The nickname of the host storage domain Optional Comma-separated list of WWNs to unsecure the host storage domain To specify two or more options, separate them with commas. wwn NOTE: You must specify either domain or domainnickname.
Command line interface commands Table 4-75 DeleteWWNForLun command parameters Parameter Name Status Description port Optional Port number NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur. portname Optional Port name NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur.
Command line interface commands Table 4-76 DeleteWWNForLunGroup command parameters Parameter Name Status Description portname Optional Port name of the LUN group NOTE: Specify either port or portname. Do not specify both parameters at the same time. This might cause an error to occur. objectid Required Object ID of the LUN group Specify the objectID obtained from another CLI response. The value is encoded by the CLI.
Command line interface commands Command execution result: RESPONSE: (Command completed; no data returned) 4-6-14 ModifyLunGroup ModifyLunGroup modifies a LUN group assigned to a port of the target storage array (XP512/XP48 subsystem only) and adds paths in the LUN group (see Table 4-78). A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned, and who also has Modify permission, can execute this command for any resources.
Command line interface commands List of 1 Port elements: An instance of Port . . (Attributes of Port are omitted here) . List of 1 LUNGroup elements: An instance of LUNGroup objectID=***** nickname=hp List of 2 Path elements: An instance of Path objectID=***** devNum=0 portID=19 domainID=16 scsiID=15 LUN=8 wwnSecurityValidity=true . . (repeated for other Path instances) . . *****: The values are encoded by the CLI.
Command line interface commands Table 4-79 ModifyWWNGroup command parameters Parameter Name Status Description nickname Optional Unique nickname of the WWN group You can use the following characters: A-Z a-z 0-9 ! # $ % & ' ( ) + - . = @ [ ] ^ _ ` { } ~ The number of characters that can be used for a WWN nickname is 1-8 bytes. Command execution example: hdvmcli ModifyWWNGroup -o "D:\logs\XP512 ModifyWWNGroup.log" "serialnum=10001" "model=XP512" "port=19" "objectid=*****" "wwn=AA.AA.AA.AA.AA.AA.AA.
Command line interface commands A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned, and who also has Modify permission, can execute this command for any resources. Table 4-80 AddHost command parameters Parameter Name Status Description hostname Required Name of the new host The number of characters that can be used for a name is 1-64 bytes. NOTE: Spaces at the beginning or end of a name are not registered.
Command line interface commands Table 4-81 AddHostInfo command parameters Parameter Name Status Description hostname Required Name of the HostInfo The number of characters that can be used for a name is 1-50 bytes. ipaddress Optional IPv4 IP address of the host ipv6address Optional IPv6 IP address of the host mountpoint Optional Mount point on the host file system corresponding to the path port Optional Port that the path is on NOTE: Specify either port or portname.
Command line interface commands • • • • Host LUN: 1 HBA WWN: 11.22.33.44.55.66.77.88 LUN size: 10MB LUN in use: 10% Command execution example: hdvmcli AddHostInfo -o "D:\logs\XP1024 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.
Command line interface commands Table 4-82 AddHostRefresh command parameter Parameter Name Status Optional objectid Description Specify the object ID of the target host. NOTE: You must specify either objectid or hostname. Do not specify both parameters at the same time, as this might cause an error to occur. Optional hostname Name of the target host NOTE: You must specify either objectid or hostname. Do not specify both parameters at the same time, as this might cause an error to occur.
Command line interface commands Command execution result: RESPONSE (Command completed; no data returned) 4-7-5 DeleteHostInfo DeleteHostInfo deletes a HostInfo instance from the Device Manager server (see Table 4-84). A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned and who also has Modify permission can specify HostInfo for an allowed host.
Command line interface commands Table 4-85 GetHost command parameters Parameter Name Status Description configfileid Optional Object ID of the HORCM configuration definition file in the host If you omit this parameter, the command acquires information about all HORCM configuration definition files contained in the host. If you specify this parameter, you must also specify the objectid parameter. Specify the objectID obtained from another CLI response. The value is encoded by the CLI.
Command line interface commands pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=2 svolInstanceNumber=12 svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
Command line interface commands Command execution result 2: RESPONSE: An instance of Host objectID=***** name=testmf capacityInKB=0 hostType=2 An instance of Host objectID=***** name=testmf2 capacityInKB=0 hostType=2 *****: The values are encoded by the CLI. 4-7-7 GetHostInfo GetHostInfo returns either a selected HostInfo record or all the HostInfo on the Device Manager server (see Table 4-86).
Command line interface commands osLun=1 portWWN=11.22.33.44.55.66.77.88 fileSystemType=NTFS fileSystemName=C: sizeInMB=10 percentUsed=10 lastUpdated=1039003852 *****: The value is encoded by the CLI. Command execution example 2: hdvmcli GetHostInfo -o "D:\logs\XP1024 GetHostInfo.log" Command execution result 2: RESPONSE An instance of HostInfo objectID=***** name=HIS_HOSTINFO_XP1024 serialNumber=10001 arrayType=XP1024 ipAddress=172.16.64.
Command line interface commands Table 4-87 ModifyHost command parameters Parameter Name Status Description objectid Optional Object ID of the host to be be modified NOTE: You must specify objectid or hostname. hostname Optional Name of the host to modify Omit this parameter if you do not want to change the name. The number of characters that can be used for a name is 1-64 bytes. The value specified for this parameter differs depending on whether objectid is specified.
Command line interface commands *****: The value is encoded by the CLI. 4-7-9 ModifyHostInfo ModifyHostInfo modifies a HostInfo record in the Device Manager Manager server (see Table 4-88). A user who has only View permission cannot execute this command. A user to whom a user-defined resource group is assigned and who also has Modify permission can specify HostInfo for an allowed host. NOTE: A Local System Administrator and Local Storage Administrator can specify HostInfo for a permitted host.
Command line interface commands Table 4-88 ModifyHostInfo command parameters Parameter Name Status Description devnum Optional New device number of the path Omit this when no change is required. This parameter can be specified in decimal, and in colon-separated hexadecimal. If you specify a hexadecimal number, for XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48, use the xx:yy format, where xx is the CU number, and yy is the LDEV number.
Command line interface commands serialNumber=10001 arrayType=XP1024 ipAddress=111.111.111.111 mountPoint=E: portID=7 domainID=0 scsiID=15 lun=2 devNum=2 osScsiBus=0 osScsiID=15 osLun=1 portWWN=11.33.55.77.99.BB.DD.FF fileSystemType=NTFS1 fileSystemName=E: sizeInMB=156 percentUsed=50 lastUpdated=1039003476 *****: The value is encoded by the CLI. 4-8 Server management commands The Server Management commands provide management support for the Device Manager server.
Command line interface commands An instance of URLLink objectID=***** name=AUTO url=192.168.99.AA linkedID=***** description=xxxxx *****: The values are encoded by the CLI. 4-8-2 DeleteAlerts DeleteAlerts deletes one or more alerts from the Device Manager server (see Table 4-90). You can specify alerts to be deleted using either the alert number or the source. A user to whom a user-defined resource group is assigned and who has only View permission, cannot execute this command.
Command line interface commands Table 4-91 DeleteURLLink command parameters Parameter Name Status Description objectid Optional The objectID of the URLLink to be removed You must specify either objectid or linkedid. Specify the objectID obtained from another CLI response. The value is encoded by the CLI. linkedid Optional The object ID of the linked object All links to this object are removed. You must specify either objectid or linkedid. Specify the objectID obtained from another CLI response.
Command line interface commands Command execution example: hdvmcli GetAlerts -o D:\logs\GetAlerts.log "countfilter=2" "timefilter=2002/04/01 00:00:00" Command execution result: RESPONSE An instance of Alerts Contains 2Alert instances: An instance of Alert number=2 type=Server source=***** severity=3 component=DKU drive description=Serious error detected on DKU drive. actionToTake=Contact Customer Support. data=Component has stopped.
Command line interface commands Table 4-93 GetLogFile command parameters Parameter Name Status Description filename Required Name of the requested log file (access.log, service.log, error.log, or trace.log) Command execution example: hdvmcli GetLogFile -o "D:\logs\GetLogFile.log" "filename=error.log" Command execution result: RESPONSE An instance of File name=error.log ----- Contents of File Follow ----. . (Contents of File "error.log" is omitted here) .
Command line interface commands 4-8-8 GetURLLink GetURLLink gets any or all URLLink objects in the Device Manager server (see Table 4-94). A user to whom a user-defined resource group is assigned can specify the allowed XP Command View AE object.
Command line interface commands Modifying the debug level affects the amount of information written to the trace.log file, subsequent to the change. The command does not affect the Device Manager server configuration files, so any debug level modifications by this command does not affect the debug level when the server is restarted. A user to whom a user-defined resource group is assigned and who has only View permission cannot execute this command.
Command line interface commands Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status Description pvolhostid Required Host ID for identifying the P-VOL When using Method 1, specify the host ID of the P-VOL in a group specified in the definition file. pvolinstancenum Optional Instance number of the HORCM instance for managing the P-VOL When using Method 1, specify the instance number of the P-VOL of a group specified in the definition file.
Command line interface commands Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status Description pvolportname Optional Port name in the HORCM configuration file that manages the P-VOL path NOTE: If you specify this parameter, specify either pvolportid or pvolportname. Do not specify both parameters at the same time. This might cause an error to occur. pvolpoolid Optional Specify the pool ID of the journal data to which the P-VOL belongs.
Command line interface commands Table 4-96 AddConfigFileForReplication command parameters Parameter Name Status replicationfunct Optional ion Description Type of copy used for the copy pair • BusinessCopy: Execute XP Business Copy Software. • ContinuousAccessSync: Execute XP Continuous Access Synchronous Software. • ContinuousAccessAsync: Execute XP Continuous Access Asynchronous Software. • Snapshot: Execute XP Snapshot. • ContinuousAccessJournal: Execute XP Continuous Access Journal Software.
Command line interface commands Command execution example 1: (add pairs to the existing group in the configuration files). hdvmcli AddConfigFileForReplication -o "D:\logs\XP12000 AddConfigFileForReplication.
Command line interface commands Command execution result 3: RESPONSE (Command completed; no data returned) 4-9-2 AddReplication The AddReplication command creates copy pairs for XP Business Copy Software, XP Continuous Access Synchronous Software, XP Continuous Access Asynchronous Software, XP Snapshot, and XP Continuous Access Journal Software. When you create a copy pair, the HORCM configuration definition file for XP RAID Manager contained in the host is rewritten.
Command line interface commands Table 4-97 AddReplication command parameters Parameter Name Status Description pvolportnum Optional Specify the port number of the HORCM instance that manages P-VOL. Specify an integer in the following range: • Solaris:0 to 65535. • AIX, Windows, HP-UX, and Linux 1 to 65535. NOTE: If you are using method 3, you must specify this parameter. NOTE: If the replicationgroupid or pvolinstancenum parameter is specified, this parameter is ignored.
Command line interface commands Table 4-97 AddReplication command parameters Parameter Name Status Description pvolpoolid Optional Specify the pool ID of the journal data to which P-VOL belongs. NOTE: You must specify this parameter when you are using method 2 or 3 with XP Continuous Access Journal Software. NOTE: When you are using method 1, this parameter value is invalid even if you specify a value. svolarraytype Required Specify the model of the storage subsystem that contains S-VOL.
Command line interface commands Table 4-97 AddReplication command parameters Parameter Name Status Description munum Optional Specify the MU number of the P-VOL. This parameter can be specified only for XP Continuous Access Journal Software. NOTE: If this parameter is not specified, Device Manager automatically specifies the value. fencelevel Optional Specify the P-VOL fence level as follows (default = Never).
Command line interface commands Table 4-98 GetHost command display and AddReplication command parameters Location of Value Displayed Item Name by the GetHost Command Corresponding Parameter ReplicationGroup replicationGroupID replicationgroupid pvolHostID pvolhostid pvolInstanceNumber pvolinstancenum pvolPortNumber pvolportnum svolHostID svolhostid svolInstanceNumber svolinstancenum svolPortNumber svolportnum pvolSerialNumber pvolserialnum pvolArrayType pvolarraytype pvolDevNum pvolde
Command line interface commands Command execution result 1: RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=0 groupName=HCMD_CG0003 pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,001 pvolHORCMMONHostName=192.168.32.63 pvolHORCMINSTHostName=192.168.32.63 svolHostID=1 svolInstanceNumber=12 svolPortNumber=50,002 svolHORCMMONHostName=192.168.32.64 svolHORCMMONHostName=192.168.32.
Command line interface commands the primary volume (P-VOL), specify the logical device (LDEV 11, model number XP1024, and serial number 15001). The host that recognizes the primary volume has ID 1, and the HORCM instance number is 11. For the secondary volume (S-VOL), specify the logical device (LDEV 12, model number XP1024 and serial number 15001). The ID of the host that recognizes the secondary volume is 1, (same as the primary volume), and the HORCM instance number is 12.
Command line interface commands number|pvolportname=port-name]] pvolpoolid=pool-ID svolarraytype=model svolserialnum=serial-number svoldevnum=device-number [svolportid=portnumber|svolportname=port-name]] pvolpoolid=pool-ID [replicationfunction= {BusinessCopy|ContinuousAccessSync|ContinuousAccessAsync|Snapshot|ContinuousAccessJ ournal}] [munum=Mu-number] [fencelevel=fence-level] [copytracksize=copypace] [pairoption=suspend] Command execution example 3: This example creates a RAID Manager configuration defini
Command line interface commands status=1 muNumber=-1 copyTrackSize=14 splitTime=-1 *****: The values are encoded by the CLI. 4-9-3 DeleteReplication DeleteReplication deletes copy pair information from a RAID Manager configuration definition file and releases the copy pair from the storage subsystem (see parameters in Table 4-99). A user who has only View permission cannot execute this command.
Command line interface commands Command execution example 1: This example deletes a copy pair for XP Continuous Access Synchronous Software that has been defined in copy group 8. The primary volume (P-VOL) is the LDEV number 10, serial number 65010001. The secondary volume (S-VOL) is LDEV number 11, sequence number 0012. The execution result displays the remaining copy pairs after deleting the specified copy pair. hdvmcli DeleteReplication -o "D:\logs\XP1024 DeleteReplication.
Command line interface commands Command execution result 2: RESPONSE (Command completed; no data returned) 4-9-4 GetReplicationControllerPair GetReplicationControllerPair obtains information about a replication controller pair (see parameters in Table 4-100). In XP24000/XP20000, XP12000/XP10000/SVS200, XP1024/XP128, and XP512/XP48, the pairs indicate paths between MCUs and RCUs. For this command, there are no access restrictions regarding the resource groups or permissions assigned to a user.
Command line interface commands Command execution result 2: RESPONSE An instance of ReplicationControllerPair objectID=***** masterArrayType=XP128 masterSerialNumber=35001 masterControllerID=10 masterStartDevNum=0 masterEndDevNum=255 remoteArrayType=XP1024 remoteSerialNumber=15001 remoteSSID=65534 remoteControllerID=15 remoteStartDevNum=0 remoteEndDevNum=255 *****: The value is encoded by the CLI.
Command line interface commands Table 4-101 ModifyReplication command parameters Parameter Name Status Description svolserialnum Optional Specify the serial number of the storage subsystem that contains the SVOL. NOTE: If you specify this parameter, specify either svolserialnum or svolsequencenum. Do not specify both parameters at the same time. This might cause an error to occur. svolsequencenum Optional Specify the sequence number of the storage subsystem that contains the S-VOL.
Command line interface commands Command execution result: RESPONSE: An instance of ReplicationGroup objectID=***** replicationGroupID=12 groupName=HCMD_CG000d pvolHostID=1 pvolInstanceNumber=11 pvolPortNumber=50,000 pvolHORCMMONHostName=192.168.32.63 pvolHORCMMONHostName=192.168.32.63 svolHostID=3 svolInstanceNumber=12 svolPortNumber=50,001 svolHORCMMONHostName=192.168.32.64 svolHORCMINSTHostName=192.168.32.
Command line interface commands 4-10 Items output as command execution results This section lists the items that are output when Device Manager CLI commands are executed. These items are output as attributes of each Device Manager instance. The meaning of items that have the same name can differ for different instances. When you refer to an output item, check the instance of the item.
Command line interface commands Table 4-103 lists and describes the attributes of the ArrayGroup instance. Table 4-103 Items output when instance is ArrayGroup Attribute Description objectID Object ID of the array group name Array group name This item is output if it has been registered.
Command line interface commands Table 4-103 Items output when instance is ArrayGroup Attribute Description allocatedCapacity Total size of all LDEVs assigned paths in the array group (in KB) freeCapacity Total size of all LDEVs that are not assigned paths in the array group (in KB) autoLunCapacity Total size of all LDEVs reserved for XP Auto LUN Software in the array group (in KB) onDemandCapacity Total size of all LDEVs expanded on demand in the array group (in KB) totalFreeSpace Total size of
Command line interface commands Table 4-103 Items output when instance is ArrayGroup Attribute Description mfOnDemandCapacity Total size of all mainframe LDEVs expanded on demand in the array group (in KB) mfAllocatedCapacit Total size of all mainframe LDEVs assigned paths in the array group (in KB) y mfUnallocatedCapac Total size of all mainframe LDEVs that are not assigned paths in the array group (in ity KB) openAllocatedActua Total size of the open logical units and the intermediate logical units tha
Command line interface commands 4-10-3 Items output when instance is ArrayReservation The ArrayReservation instance is output when the following commands are executed: • • • AddArrayReservation (see section 4-4-1 ) GetArrayReservation (see section 4-4-16 ) ModifyArrayReservation (see section 4-4-18 ) Table 4-104 lists and describes the attributes of the ArrayReservation instance.
Command line interface commands 4-10-5 Items output when instance is Component The Component instance is output when the GetStorageArray (subtarget=Component) command (see section 4-4-17-5 ) is executed. Table 4-106 lists and describes the attributes of the Component instance.
Command line interface commands 4-10-6 Items output when instance is ConfigFile The ConfigFile instance is output when the GetHost command (see section 4-7-6 ) is executed. Table 4-107 lists and describes the attributes of the ConfigFile instance.
Command line interface commands Table 4-109 Items output when instance is File Attribute Description name Log file name The log recorded in the log file is output after the file name. 4-10-9 Items output when instance is FreeLUN The FreeLUN instance is output when the GetStorageArray (subtarget=HostStorageDomain) command (see section 4-4-17-8 ) is executed. Table 4-110 describes the attribute of the FreeLUN instance.
Command line interface commands Table 4-112 Items output when instance is Host Attribute Description objectID Object ID of the host name Host name If EXSP_RAID500_xxxx_xxxx is output as this value, the host is a virtual host and the value indicates an XP12000/XP10000/SVS200 port connected to an external subsystem.
Command line interface commands Table 4-113 Items output when instance is HostInfo Attribute Description devNum Device number of the logical unit osScsiBus Number of the SCSI bus on the host osScsiID SCSI ID assigned to a channel on the host osLun LUN of a logical unit on the host portWWN WWN of the port in the host bus adapter fileSystemType Type of the file system to be mounted fileSystemName File system name sizeInMB LUN size (in MB) percentUsed Rate of LUN usage (%) lastUpdated Lat
Command line interface commands Table 4-114 Items output when instance is HostStorageDomain Attribute Description hostMode Host connect mode For the XP24000/XP20000: • • • • • • • • • • • • Standard VMware HP OpenVMS Tru64 Solaris NetWare Windows AIX VMware Extension Windows Extension UVM For XP12000/XP10000/SVS200: • • • • • • • • • • • • • Standard Sequent HP Solaris Netware Windows Windows Extension Tru64 HI-UX AIX OPEN-VMS UVM 237
Command line interface commands Table 4-114 Items output when instance is HostStorageDomain Attribute Description For XP1024/XP128: • • • • • • • • • • • • • • • • • Standard Sequent HP Solaris Netware Windows Tru64 HI-UX AIX OPEN-VMS Windows Extension Solaris Extension Standard Extension2 HP Extension2 Solaris Extension2 Windows Extension2 AIX Extension2 For XP512/XP48: • • • • • • • • • • • Standard Sequent HP HP Extension Solaris Netware Windows Tru64 HI-UX AIX OPEN-VMS 238
Command line interface commands Table 4-114 Items output when instance is HostStorageDomain Attribute Description hostModeOption Host mode option One of the following values is output for the XP24000/XP20000: • 2: VERITAS Database Edition/Advanced Cluster or VERITAS Cluster Server 4.0 is used. • 6: The value of the TPRLO parameter of the HBA mini-port driver is 2. • 7: Automatic recognition of LUNs • 12: LUNs without defined paths are hidden.
Command line interface commands Table 4-116 Items output when instance is JournalPool Attribute Description objectID Object ID of the journal pool name Name of the journal pool This is output if the name has been registered. poolFunction Outputs the type of function that operates the journal pool. Outputs the type of the journal pool operation.
Command line interface commands • • • • • AddLUSE (see section 4-4-4 ) AddVirtualVolume (see section 4-4-7 ) FormatLU (see section 4-4-15 ) GetStorageArray (subtarget=LDEV) (see section 4-4-17-10 ) GetStorageArray (subtarget=LogicalUnit) (see section 4-4-17-12 ) Table 4-117 lists and describes the attributes of the LDEV instance. Table 4-117 Items output when instance is LDEV Attribute Description objectID Object ID of the LDEV name LDEV name This item is output if it has been registered.
Command line interface commands Table 4-117 Items output when instance is LDEV Attribute Description volumeType Information about LDEV options One of the following values is output: • 0: I/O suppression mode is invalid and cache mode is invalid. • 1: I/O suppression mode is invalid and cache mode is valid. • 2: I/O suppression mode is valid and cache mode is invalid. • 3: I/O suppression mode is valid and cache mode is valid.
Command line interface commands Table 4-117 Items output when instance is LDEV Attribute Description diskType Type of the disk drive One of the following values is output: • 0: FC • 1: SATA • 2: BD • -1: Unknown For XP12000/XP10000/SVS200, -1 is output. For XP24000/XP20000, 1 or -1 is output. For an external volume on XP12000/XP10000/SVS200 or XP24000/XP20000, 1, 2, or -1 is output. -1 is output in other cases.
Command line interface commands Table 4-117 Items output when instance is LDEV Attribute Description status LDEV status One of the following values is output for XP12000/XP10000/SVS200 and XP24000/XP20000: • • • • • • • • • • Unknown: Unknown Normal: Normal status Normal (Quick Format): Normal status (Quick Format) Blocked: The LDEV is blocked. Format: The LDEV is being formatted. Correction Access: The access attribute is being modified. Copying: Data is being copied.
Command line interface commands Table 4-117 Items output when instance is LDEV Attribute Description thpPoolID Pool ID of the XP Thin Provisioning Software One of the following values is output for XP24000/XP20000: When the LDEV is a THP volume: pool ID of the THP pool to which the THP volume is assigned. NOTE: When the THP volume has not been assigned to a THP pool, -1 is displayed. NOTE: When the operator is a partitioned storage administrator, -1 is displayed.
Command line interface commands 4-10-18 Items output when instance is LogicalGroup The LogicalGroup instance is output when the following commands are executed: • • • • AddLogicalGroup (see section 4-5-1 ) AddObjectForLogicalGroup (see section 4-5-3 ) GetLogicalGroup (see section 4-5-6 ) ModifyLogicalGroup (see section 4-5-7 ) Table 4-119 lists and describes the attributes of the LogicalGroup instance.
Command line interface commands • • • • GetStorageArray (subtarget=ReplicationInfo) (see section 4-4-17-18 ) ModifyLogicalUnit (see section 4-4-19 ) ModifyPool (see section 4-4-20 ) ModifyVirtualVolume (see section 4-4-23 ) Table 4-120 lists and describes the attributes of the LogicalUnit instance. Table 4-120 Items output when instance is LogicalUnit Attribute Description objectID Object ID of the logical unit name Name of the logical unit This item is output if it has been registered.
Command line interface commands Table 4-120 Items output when instance is LogicalUnit Attribute Description chassis Number of the chassis where the logical unit is located arrayGroup Number of the array group containing the logical unit raidType RAID level of the logical unit RAID levels are output in the format RAIDx(yD+zP): • RAIDx: RAID level • yD: Number of data disks • zP: Number of parity disks For example, when RAID5(2D+1P) is output for raidType, it means the array group consists of two dat
Command line interface commands Table 4-120 Items output when instance is LogicalUnit Attribute Description journalVolumeType Volume type of XP Continuous Access Journal Software One of the following types is output: • Unknown: Unknown • Simplex: Not an XP Continuous Access Journal Software volume • P-VOL: XP Continuous Access Journal Software P-VOL • S-VOL: XP Continuous Access Journal Software S-VOL • JNL-VOL: XP Continuous Access Journal Software JNL-VOL • MF-JNL: XP Continuous Access Journal Softwa
Command line interface commands Table 4-120 Items output when instance is LogicalUnit Attribute Description consumedCapacityInK Space used on the THP volume (KB) B One of the following values is output for XP24000/XP20000: When the logical unit consists of THP volumes: space used on the THP volumes NOTE: When the THP volumes are not assigned to a THP pool, 0 is displayed. NOTE: When the operator is a partitioned storage manager, -1 is output.
Command line interface commands • • • AddWWNForLunGroup (see section 4-6-5 ) GetStorageArray (subtarget=Port) (see section 4-4-17-16 ) ModifyLunGroup (see section 4-6-14 ) Table 4-121 lists and describes the attributes of the LUNGroup instance. Table 4-121 Items output when instance is LUNGroup Attribute Description objectID Object ID of the LUN group name Name of the LUN group This item is output if it has been registered.
Command line interface commands 4-10-23 Items output when instance is PairedPortController The PairedPortController instance is output when the GetStorageArray (subtarget=PortController) command (see section 4-4-17-17 ) is executed. Table 4-124 lists and describes the attributes of the PairedPortController instance.
Command line interface commands Table 4-125 Items output when instance is Path Attribute Description wwnSecurityValidity Indicates whether the WWN of the path and the WWN of the host storage domain assigned to the path are the same: • true: Same • false: Not the same 4-10-25 Items output when instance is PDEV The PDEV instance is output when the following commands are executed: • • GetStorageArray (subtarget=ArrayGroup) (see section 4-4-17-3 ) GetStorageArray (subtarget=PDEV) (see section 4-4-17-14 )
Command line interface commands Table 4-126 Items output when instance is PDEV Attribute Description dkuType Type of the disk unit containing the physical device One of the following values is output: • XP24K: XP24000/XP20000 • XP12K/10K/SVS200: XP12000/XP10000/SVS200 • XP1024/128: XP1024/XP128 • XP512/48: XP512/XP48 rpm Drive revolutions per minute This information is output for XP12000/XP10000/SVS200 and XP24000/XP20000. 0 or -1 is output if the drive revolutions are unknown.
Command line interface commands Table 4-127 Items output when instance is Pool Attribute Description controllerID ID of the disk controller for the journal pool One of the following values is output: For XP24000/XP20000: XP Continuous Access Journal Software: Logical DKC number For other cases: -1 -1 is output for other storage subsystems. poolType Indicates the pool type. The value output depends on the poolFunction value.
Command line interface commands Table 4-127 Items output when instance is Pool Attribute Description capacityInKB Capacity of the journal pool (KB) For XP24000/XP20000, when poolFunction is 5, the capacity of the THP pool is output. -1 is output for other cases. NOTE: The THP pool uses a control area, so this value does not match the total capacity of the THP pool volumes.
Command line interface commands Table 4-128 Items output when instance is Port Attribute Description objectID Object ID of the port name Port name This item is output if it has been registered portID Port ID portType Port type One of the following values is output: • LCP • Fibre • SCSI • NAS • iSCSI fibreAddress Address of the Fibre port (AL_PA) For XP512/XP48, XP1024/XP128, XP12000/XP10000/SVS200, and XP24000/XP20000, either of the following values is output: • 0 (NULL): Not a Fibre port • 01
Command line interface commands Table 4-128 Items output when instance is Port Attribute Description portRole Port attribute One of the following values is output: • Target • RCU Target • Initiator • LCP • RCP • External: External port • (Blank): Unknown slprNumber SLPR number This item is output for XP12000/XP10000/SVS200. -1 is output for other storage subsystems.
Command line interface commands Table 4-129 Items output when instance is PortController Attribute Description mode Mode of the port controller One of the following values is output: For XP512/XP48 and XP1024/XP128: • 1: Normal mode • 2: High-speed mode (1 port) • 3: Unknown • 4: High-speed mode (2 ports) For XP12000/XP10000/SVS200 and XP24000/XP20000: • 1: Normal mode • 2: High-speed mode (all ports) • 3: Unknown • 4: Reserve mode • 5: High-speed mode (upper 4 ports) • 6: High-speed mode (lower 4 port
Command line interface commands Table 4-129 Items output when instance is PortController Attribute Description For XP1024/XP128: • 2: ESCON • 8: Fibre-Tachyon Shortwave (2 ports) • 12: Fibre-Tachyon Shortwave (4 ports) • 13: Fibre-Tachyon Shortwave (4 ports) • 14: Fibre-Tachyon Shortwave (8 ports) • 15: Fibre-Tachyon Longwave (4 ports) • 21: E-NAS • 25: iSCSI • 32: FICON Shortwave (4 ports) • 33: FICON Longwave (4 ports) For XP12000/XP10000/SVS200: • 40: ESCON • 42: Fibre-Tachyon (8 ports) • 43: Fibre-T
Command line interface commands 4-10-29 Items output when instance is ReplicationControllerPair The ReplicationControllerPair instance is output when the GetReplicationControllerPair command (see section 4-9-4 ) is executed. Table 4-130 lists and describes the attributes of the ReplicationControllerPair instance.
Command line interface commands Table 4-131 Items output when instance is ReplicationGroup Attribute Description groupName Name of the copy group used by the XP RAID Manager pvolHostID Host ID of the host that recognizes the P-VOL pvolInstanceNumber Instance number of the HORCM instance that manages the P-VOL pvolPortNumber Port number of the HORCM instance that manages the P-VOL svolHostID Host ID of the host that recognizes the S-VOL pvolHORCMMONHostNam Value specified in HORCM_MON for the P-
Command line interface commands • • • • • • • AddReplication (see section 4-9-2 ) DeleteReplication (see section 4-9-3 ) GetHost (see section 4-7-6 ) GetStorageArray (subtarget=JournalPool) (see section 4-4-17-9 ) GetStorageArray (subtarget=Pool) (see section 4-4-17-15 ) GetStorageArray (subtarget=ReplicationInfo) (see section 4-4-17-18 ) ModifyReplication (see section 4-9-5 ) Table 4-132 lists and describes the attributes of the ReplicationInfo instance.
Command line interface commands Table 4-132 Items output when instance is ReplicationInfo Attribute Description fenceLevel Fence level of the P-VOL One of the following values is output when the value of replicationFunction is ContinuousAccessSync: For XP512/XP48, XP1024/XP128, XP12000/XP10000/SVS200, and XP24000/XP20000: • Never • Data • Status status Replication status One of the following values is output: • -1: Unknown • 0: Simplex • 1: Pair • 8: Copying • 9: Reverse-Copying • 16: Split • 17: Sus
Command line interface commands Table 4-133 Items output when instance is ServerInfo Attribute Description buildVersion Version and build date of Device Manager server (example: Build 0590-00 (Jan 16, 2008)) serverURL URL of Device Manager server (example: http://localhost:2001) upTime Length of time that Device Manager server is active (example: 1 day 2 hours 3 minutes 4 seconds) upSince Time and date when the server was started (example: Wed, 23 Jan 2008 06:07:01 GMT) currentApiVersion API ver
Command line interface commands • • • • • • • • • • • • • • • • • • • • • GetStorageArray (subtarget=Filter) (see section 4-4-17-6 ) GetStorageArray (subtarget=FreeSpace) (see section 4-4-17-7 ) GetStorageArray (subtarget=HostStorageDomain) (see section 4-4-17-8 ) GetStorageArray (subtarget=JournalPool) (see section 4-4-17-9 ) GetStorageArray (subtarget=LDEV) (see section 4-4-17-10 ) GetStorageArray (subtarget=LogicalDKC) (see section 4-4-17-11 ) GetStorageArray (subtarget=LogicalUnit) (see section 4-4-17
Command line interface commands Table 4-134 Items output when instance is StorageArray Attribute Description sharedMemoryInMB Size of shared memory (in MB) numberOfSpareDrives Number of spare drives -1 is output for XP512/XP48, XP1024/XP128, XP12000/XP10000/SVS200, and XP24000/XP20000.
Command line interface commands Table 4-134 Items output when instance is StorageArray Attribute Description slprStatus SLPR status of the storage subsystem One of the following values is output: • -1: None • 0: The storage subsystem has all the resources. • 1: The storage subsystem has some of the resources divided by using the SLPR. -1 is output for storage subsystems other than XP12000/XP10000/SVS200 and XP24000/XP20000.
Command line interface commands Table 4-134 Items output when instance is StorageArray Attribute Description numberOfUnallocated Number of mainframe logical devices to which paths are not assigned MfLDEVs productCode Product code of the storage subsystem lastRefreshed Time when the storage subsystem was last refreshed The number of seconds elapsed from 00:00:00 on January 1, 1970 (world standard time) is displayed. autoFormatLU This item indicates whether an unformatted logical unit can be created.
Command line interface commands Table 4-134 Items output when instance is StorageArray Attribute Description numberOfOpenReserve Number of open logical units that satisfy both the following conditions: dLUs • Paths are not assigned. • Paths cannot be assigned by using Device Manager. numberOfImReservedL Number of intermediate logical units that satisfy both the following conditions: Us • Paths are not assigned. • Paths cannot be assigned by using Device Manager.
Command line interface commands Table 4-136 Items output when instance is VolumeConnection Attribute Description mappedDevNum Device number of the internal volume to which an external volume is mapped externalArrayType Storage subsystem type consisting of external volumes externalSerialNumbe Serial number of the storage subsystem consisting of external volumes r Unknown is output if the serial number is unknown.
Command line interface commands • • GetStorageArray (subtarget=Port) (see section 4-4-17-16 ) ModifyWWNGroup (see section 4-6-15 ) Table 4-138 lists and describes the attributes of the WWNGroup instance. Table 4-138 Items output when instance is WWNGroup Attribute Description objectID Object ID of the WWN group name Name of the WWN group This item is output when registered.
Command line interface commands 4-11-1-1 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. If you do not do this, an error occurs.
Command line interface commands portname parameter is specified. For this reason, to execute such commands together, the parameters need to be unified on either the port or portname parameter. Table 4-139, Table 4-140, Table 4-141, and Table 4-142 show the specification conditions for each command parameter.
Command line interface commands 4-11-1-4 Examples of batch file creation The following shows an example of a batch file created according to the input rules from (1) to (3).
Command line interface commands description= XP12000 (14053) at 10.208.116.
Command line interface commands numberOfUnallocatedMfLDEVs=0 productCode=2 lastRefreshed=1,153,456,561 autoFormatLU=1 statusOfDBInconsistency=0 openAllocatedActualCapacity=1,683,100,560 openUnallocatedCapacity=5,803,543,936 openUnallocatedActualCapacity=5,803,543,936 openReservedCapacity=62,545,600 openReservedActualCapacity=62,545,600 numberOfReservedLUs=32 numberOfOpenReservedLUs=32 numberOfImReservedLUs=0 List of 4 Path elements: An instance of Path objectID=***** devNum=816 portID=0 domainID=0 scsiID=15
Command line interface commands 4-11-3-1 When the target storage subsystem is other than XP24000/XP20000, or is an XP24000/XP20000 whose microcode version is earlier than 60-02-00-00/00 If an error occurs during the batch functionality execution, perform the following procedure to check up to what point the batch file contents were processed. For the unprocessed commands, re-create the batch file, and re-execute the batch functionality. To check the batch file contents: 1.
Command line interface commands Table 4-143 Actions to take for storage subsystem error codes Storage subsystem Action error code 1005,1003 1005,1004 1005,1005 1005,1007 1005,1018 1005,1020 1005,1021 1005,1025 1005,1068 1005,1134 1005,1135 1005,1350 1005,1363 1005,1368 1005,1600 1005,1600 1005,1904 1005,6012 1005,6036 1005,6036 1005,65660 2005,1002 2005,1009 2005,1010 2005,1012 2005,1013 2005,1015 2005,1021 2005,1028 2005,1050 2005,1126 2005,1137 2005,1182 2005,1185 2005,1187 2005,1196 2005,1362 2005,1365
Command line interface commands Table 4-143 Actions to take for storage subsystem error codes Storage subsystem Action error code 1005,1364 1005,2009 1005,2010 1005,2013 1005,2015 1005,2032 1005,2082 1005,2083 1005,2098 1005,2099 1005,2500 1005,2501 1005,3002 2005,2005 2005,2009 2005,2013 2005,2032 2005,2082 2005,2083 2005,2084 2005,2098 2005,2099 2005,2502 2005,3002 2005,3003 2005,3006 1005,2005 1005,2084 1005,3003 1005,3006 Others Perform the following procedure: 1 Execute the AddStorageArray command o
Command line interface commands • • Mainframe volume information (VOLSER and DEVN) Logical DKC serial number of a storage subsystem To use the web client to display information recognized by a mainframe host, you must set up the mainframe host and Device Manager environments. NOTE: In the web client, you cannot view mainframe hosts. The mainframe volume information obtained from mainframe agent is displayed in the Mainframe-Unspecified group in the web client.
Command line interface commands 2. From the execution result of the AddHost command, make sure that specified information is correctly output to the name and hosttype parameters. Notes on executing the AddHost command: ○ If the host name specified during mainframe host environment setup and the host name specified during Device Manager environment setup do not match, information registered in the mainframe agent cannot be acquired.
Command line interface commands Notes on executing the AddURLLink command: If the name parameter is specified incorrectly, the mainframe host is not registered as the mainframe agent information, and mainframe volume information and the logical DKC serial number of the storage subsystem cannot be acquired. If you specified the name parameter incorrectly, use the DeleteURLLink command to delete the mainframe agent information, and then use the AddURLLink command to register the information again.
Command line interface commands Example of executing the command: Hdvmcli AddHostRefresh -o "D:\logs\AddHostRefresh.log" "objectid=*****" *****: The values are encoded by the CLI. Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=toro2 capacityInKB=0 hostType=2 sysplexID=RSDPLEX *****: The values are encoded by the CLI.
Command line interface commands *****: The values are encoded by the CLI. 4-12-4 Acquiring mainframe agent information registered in the Device Manager To acquire the mainframe agent information registered in the Device Manager server, use the GetURLLink command. By executing this command, you can acquire the IP address and port number of the mainframe host from the url information included in the execution results. Example of executing the command: hdvmcli GetURLLink -o "D:\logs\GetURLLink.
Command line interface commands 4-12-6 Deleting mainframe agent information registered in the Device Manager To delete the mainframe agent information registered in the Device Manager server, use the DeleteURLLink command. NOTE: Use this command when you want to delete only mainframe agent registration information. For example, you might want to execute the command if you specified the name parameter incorrectly. Example of executing the command: hdvmcli DeleteURLLink -o "D:\logs\DeleteURLLink.
Command line interface commands NOTE: When you change the host name, specify the host name that was set in the initialization parameter for the mainframe agent. If you specify a host name that differs from the host name set during mainframe agent environment setup, you cannot acquire information from the mainframe agent. NOTE: The ModifyHost command cannot be used to modify the hosttype parameter information.
Command line interface commands 4-13 Example of Device Manager CLI commands This section gives an example of applying Device Manager CLI commands. 4-13-1 Merging existing WWN information and registering It for a new host This section gives an example of how to merge the WWN information of multiple existing hosts and register the information in the Device Manager server for a new host, as illustrated in Figure 4-1.
Command line interface commands Example of executing the command: hdvmcli GetHost Example of output from executing the command: RESPONSE: An instance of Host objectID=***** name=HOST_A capacityInKB=2,403,360 hostType=-1 List of 1 WWN elements: An instance of WWN WWN=11.11.11.11.11.11.11.11 An instance of Host objectID=***** name=HOST_B capacityInKB=1,000,080 hostType=-1 List of 1 WWN elements: An instance of WWN WWN=22.22.22.22.22.22.22.22 *****: The values are encoded by the CLI. 2.
Command line interface commands 4. Register a new host, assigning to it the WWNs that were deleted in step 2. Command format: hdvmcli AddHost "hostname=new-host-name" "wwnlist=WWN1,WWN2 ... " Example of executing the command: hdvmcli AddHost "hostname=HOST_C" "wwnlist=11.11.11.11.11.11.11.11,22.22.22.22.22.22.22.22" 5. Check the WWNs for the new host that was registered in step 4. Execute the GetHost command to confirm that the new host and its WWNs are registered correctly.
Using the Device Manager properties file 5 Using the Device Manager 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 on the command line.
Using the Device Manager properties file Table 5-1 Example of the properties file (in Windows) # Device Manager Command Line Interface (CLI) Properties File # # Can be used to provide options and default parameters for the # Device Manager CLI program. # # The Device Manager CLI program does not require any of the properties to be set. # Location for the diagnostics file (default, when not specified, is # hdvmcli.log in the executing directory) hdvmcli.logfile=C:/Temp/diag.
Using the Device Manager properties file NOTE: When true is set in a property file for an option without an argument, it cannot be overwritten to false from the command line. Table 5-2 lists options and their corresponding properties.
Using the Device Manager properties file The following example specifies C:\Temp\diag.log for the output destination: hdvmcli.logfile=C:/Temp/diag.log NOTE: In a Windows environment, use / or \\ instead of \ as a delimiter. 5-4-2 Specifying a log level You can use hdvmcli.diaglevel to specify the level of log information to be output to the log file. Specify the log level as follows: • • • • Debugging: hdvmcli.diaglevel=DEBUG Information: hdvmcli.diaglevel=INFO Warnings: hdvmcli.
Using the Device Manager properties file Manager request. The command line option -i or --input specifies the input file. The other options are still valid. However, any command or parameter specified from the command line or in the properties file is ignored, because that information is already in the XML document. The -i option allows you to specify an xml message file. You can use this feature to request multiple operations in on the CLI command, which can save considerable time.
Using the Device Manager properties file When you specify the saved file that contains the preceding message, you can create multiple LUNs using one command, as follows: hdvmcli -t -i xmlcommand.txt 5-4-6 Using the message trace file to create XML files When message tracing is turned on, each execution of the application writes over the message tracing file with the request and response of that execution, so that file never has more than one request and one response.
Using the Device Manager properties file 6. At the CLI prompt, enter the the following command: do getserverinfo You will see output similar to the following: RESPONSE: An instance of ServerInfo buildVersion=Build 0590-00 (Jan 16, 2008) serverURL=http://193.36.40.55:2001 upTime=1 day 23 hours 35 minutes 27 seconds upSince=Wed, 23 Jan 2008 11:07:51 GMT currentApiVersion=5.
Using the Device Manager properties file C:\hdvm>type getserv.inp C:\hdvm> 9. At the CLI prompt, type the following command: do –i getserv.inp You will see results similar to the following example: C:\hdvm>type getservinp Das System kann die angegebene Datei nicht finden. C:\hdvm>type getserv.inp
Using the Device Manager properties file 5-4-7 Output format of execution results Command results are output in the standard format specified for Device Manager CLI. The results of the GetStorageArray command can be output in either CSV format or XML format. For details about outputting execution results in CSV format, see section 5-4-8 . For details about outputting execution results in XML format, see section 5-4-9 .
Using the Device Manager properties file Figure 5-1 Output image of an execution result of Device Manager CLI (CSV format) 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 (").
Using the Device Manager properties file When an execution result is output in XML format, an XML declaration, a DOCTYPE declaration, and XML elements are output. • XML declaration (see Figure 5-2 (1)) In the first line of the execution result, an XML declaration and a linefeed code ([CRLF]) are output. NOTE: In Device Manager CLI, the execution result is output in UTF-8 encoding according to the XML1.0 Specifications recommended by W3C.
Troubleshooting 6 Troubleshooting If there is a problem with 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. See the HP StorageWorks XP Command View Advanced Edition software Device Manager server installation and configuration guide for troubleshooting information for the Device Manager server.
Troubleshooting Table 6-1 General troubleshooting information Problem Cause The following error message is displayed and the operation of Device Manager CLI is stopped: An unspecified error was encountered in CLI. Recommended Action Collect the following information, and then contact your HP technical support representative. • CLI log file • CLI property file • Contents entered on the command line • An executed batch file if a batch was executed. • Device Manager server log.
Appendix A Appendix A Using a DTD with Device Manager CLI To use a Document Type Definition (DTD), you must create a DTD using the following contents:
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A
Appendix A 315
Glossary Glossary Glossary Glossary term Definition AL arbitrated loop API application program interface ASL array support library CLI command-line interface DKA disk adapter DKC disk controller DNS Domain Name Server DST Daylight Saving Time DTD Document Type Definition FC Fibre Channel GB gigabytes (1024 MB) GUI graphical user interface HTML hypertext markup language HTTP hypertext transmission protocol HTTPS hypertext transmission protocol secure HBA host bus adapter ID
Glossary Glossary term Definition OS operating system PDEV physical device P-VOL primary volume (for XP Business Copy Software or XP Continuous Access Software) RAID redundant array of independent disks RCU remote control unit (for XP Continuous Access Software) SCSI small computer system interface SNMP simple network management protocol SSID storage subsystem ID S-VOL secondary volume (for XP Business Copy Software or XP Continuous Access Software) SVP service processor (component of
Index Index B batch: execution example, 275; execution results, 275 batch file to execute command, 272 D document: providing feedback, 23 DTD: specifying, 301; using with Device Manager CLI, 304 G GetStorageArray (subtarget=JournalPool): Device Manager CLI, 112 GetStorageArray (subtarget=LogicalDKC): Device Manager CLI, 119 H O output format: CVS format, 299; execution results, 299; XML format, 300 HDVM_CLI_JRE_PATH, 33 HDVM_CLI_MEM_SIZE, 32 help: obtaining, 23 HP: Subscriber's Choice for Business we
