HP 3PAR Command Line Interface Reference (OS 3.1.2 MU2) (QL226-97016, June 2013)

ManualsBrandsHP ManualsStorageHP 3PAR 10000 V400 16GB Control Cache/32GB Data Cache Rack Configuration Base

HP 3PAR Command Line Interface Reference

HP 3PAR OS 3.1.2

Abstract

This reference describes the HP 3PAR Command Line Interface (CLI) commands that are used to administer and maintain the

HP 3PAR storage system.

HP Part Number: QL226-97016

Published: June 2013

Summary of content (676 pages)

PAGE 1
HP 3PAR Command Line Interface Reference HP 3PAR OS 3.1.2 Abstract This reference describes the HP 3PAR Command Line Interface (CLI) commands that are used to administer and maintain the HP 3PAR storage system.
PAGE 2
© Copyright 2013 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
PAGE 3
Contents 1 CLI Command Syntax and Conventions.......................................................11 Syntax and Conventions..........................................................................................................11 Syntax Rules...........................................................................................................................11 Glob-Style Pattern...................................................................................................................
PAGE 4
Virtual Volume Statistics......................................................................................................27 Remote Copy Volume Statistics.............................................................................................28 Preserved Data Commands......................................................................................................28 Replication Commands............................................................................................................
PAGE 5
8 CLI Command..........................................................................................72 cli.........................................................................................................................................72 9 Compact Commands................................................................................75 compactcpg...........................................................................................................................75 compactld................
PAGE 6
histld...................................................................................................................................183 histpd.................................................................................................................................186 histport................................................................................................................................191 histrcvv....................................................................................
PAGE 7
22 Set Commands.....................................................................................271 setalert................................................................................................................................271 setaocfg..............................................................................................................................272 setauthparam......................................................................................................................
PAGE 8
showfirmwaredb...................................................................................................................384 showhost.............................................................................................................................386 showhostset.........................................................................................................................389 showinventory.............................................................................................
PAGE 9
shutdownsys.........................................................................................................................533 25 System Reporter (SR) commands ............................................................535 sraomoves...........................................................................................................................535 srcpgspace..........................................................................................................................
PAGE 10
29 Sync Command....................................................................................639 syncrcopy............................................................................................................................640 30 Tune Commands..................................................................................642 tunealdvv............................................................................................................................642 tunepd..........................
PAGE 11
1 CLI Command Syntax and Conventions This chapter describes the command syntax for the HP 3PAR OS CLI commands listed in this reference. General control commands that do not follow the syntax rules are also listed as well as glob-style patterns. Syntax and Conventions Most CLI commands use the following syntax. [cmd [subcmd] [options [arg]]... [...] [...
PAGE 12
• An argument must directly follow the option or subcommand it is modifying and is required on the command line, unless otherwise specified (for example: removealert –i ). • Multiple options and arguments on a command line are separated with a space. • Specifiers follow options. • User supplied input is identified by angled brackets (< >). • Unless noted otherwise, valid character formats include alphanumeric characters, periods, dashes, and underscores.
PAGE 13
The following actions are practical examples of the glob-style pattern in use: Example Explanation of Action * Shows all names. [a]* Matches all names beginning with the letter a. [a–z]x* Matches any character a-z in the first character position and "x" in the second position, followed by any character "*". NOTE: Brackets ([ ]) are significant in Tcl and must be escaped using a backslash (\) or enclosed in braces ({ }).
PAGE 14
sub,regexpat - Using regular expression (regex) pattern matching Regular expression patterns are used to match against strings. In the CLI the strings are usually descriptive text such as help text or event message strings. See the Tcl re_syntax documentation for detailed help; this help text is only a summary. Regular expressions are one or more branches separated by |, matching any string that matches any of the branches.
PAGE 15
For a virtual volume with user space that is not provisioned from a CPG, "createaldvv", "growaldvv", and "tunealdvv" commands should be used instead. To determine whether or not the user space of the virtual volume is provisioned from a CPG, use the "showvv -cpgalloc" command.
PAGE 16
• @G@ - The ISO8601 year number corresponding to the ISO8601 week (%V), expressed as a four-digit number. • @h@ - Abbreviated month name. • @H@ - Hour in 24-hour format (00 - 23). • @I@ - Hour in 12-hour format (01 - 12). • @j@ - Day of year (001 - 366). • @k@ - Hour in 24-hour format, without leading zeros (0 - 23).. • @l@ - Hour in 12-hour format, without leading zeros (1 - 12). • @m@ - Month number (01 - 12). • @M@ - Minute (00 - 59). • @p@ - AM/PM indicator.
PAGE 17
AUTHORITY This section defines the user access required within the HP 3PAR Storage System to use the command. SUBCOMMANDS This section indicates any necessary subcommands required to complete the use of the command. SYNTAX See Section (page 11). OPTIONS This section lists the available options you can use in conjunction with the command for varied results.
PAGE 18
2 Commands Quick Reference The HP 3PAR Command Line Interface provides a host of commands allowing you to administer your HP 3PAR storage system. To facilitate your navigation through this manual, this section provides an overview of the commands grouped by functionality. Adaptive Optimization (AO) Commands Command Description Authority For Details See createaocfg Creates an AO configuration. Super, Edit “createaocfg” (page 105) removeaocfg Removes specified AO configurations from the system.
PAGE 19
Disk Enclosure Management Commands Drive Cage Management Command Description Authority For Details See locatecage Locates a particular drive cage. Super, Service1 “locatecage” (page 206) Sets parameters for a drive cage. Super, Service1 Displays drive cage information. Any role in the system. setcage showcage 1 Any role granted the cage_locate right. “setcage” (page 280) Any role granted the cage_set right. “showcage” (page 361) You need access to all domains in order to run this command.
PAGE 20
Command Description Authority For Details See createdomainset Defines a new set of domains and provides the option of assigning one or more domains to that set. “createdomainset” Super (page 116) Any role granted the domainset_create right. movetodomain Moves objects from one domain to another. Super, Edit1 “movetodomain” (page 223) Any role granted the domain_moveto right. removedomain Removes an existing domain Super, Edit1 from the system.
PAGE 21
Table 2 Alert Severity Levels (continued) Severity Description Minor An event has occurred that requires action, but the situation is not yet serious. Degraded An aspect of performance or availability may have become degraded. You must decide if action is necessary. Informational The event is informational. No action is required other than acknowledging or removing the alert. Events Command Description Authority For Details See showeventlog Displays event logs. Any role in the system.
PAGE 22
Command Description Authority For Details See settask Sets the priority on a specified task. Super, Edit Any role granted the task_set right. “settask” (page 338) showtask Displays information about tasks. Any role in the system. “showtask” (page 490) starttask Executes commands with long running times. Super, Service Edit Any role granted the task_start right. “starttask” (page 585) waittask Asks the CLI to wait for a task to complete before proceeding.
PAGE 23
Node Date Information Command Description Authority For Details See setdate Sets the system time and date on all nodes. Super, Service1 “setdate” (page 291) showdate 1 Displays the date and time on all system nodes. Any role granted the date_set right. Any role in the system. “showdate” (page 373) You need access to all domains in order to run this command.
PAGE 24
1 You need access to all domains in order to run this command. Network Interface Configuration Command setnet Description Sets the administration network interface configuration. Authority Super, Service For Details See 1 Any role granted the net_set right. setntp Sets the NTP server to which Super, Service1 the HP 3PAR Storage System Any role granted the synchronizes. ntp_set right. shownet Displays the network configuration and status. 1 “setnet” (page 302) Any role in the system.
PAGE 25
Command Description Authority For Details See statiscsi Displays the iSCSI statistics. Any role in the system. “statiscsi” (page 598) statiscsisession Displays the iSCSI session statistics. Any role in the system. “statiscsisession” (page 600) 1 You need access to all domains in order to run this command. Battery Management Command Description Authority For Details See setbattery Sets battery properties. Super, Service1 “setbattery” (page 278) Any role granted the battery_set right.
PAGE 26
Command Description Authority For Details See setstatpdch Sets statistics collection mode on physical disk chunklets. Super, Edit Any role granted the statpdch_set right. “setstatpdch” (page 332) statch Displays statistics for individual chunklets. Any role in the system. “statch” (page 588) Data Cache Memory Statistics Command Description Authority For Details See statcmp Displays statistics for cache memory pages. Any role in the system.
PAGE 27
System Tuner Command Description Authority For Details See tunepd Displays physical disks with Super, Edit high service times and Any role granted the optionally performs load pd_tune right. balancing. “tunepd” (page 647) tunesys Analyzes disk usage and adjusts resources. Super, Edit Any role granted the sys_tune right.
PAGE 28
Remote Copy Volume Statistics Command Description Authority For Details See histrcvv Displays histogram data for Any role in the system. Remote Copy volumes. “histrcvv” (page 194) statrcvv Displays statistics for Remote Any role in the system. Copy volumes. “statrcvv” (page 621) Preserved Data Commands Command Description Authority For Details See showpdata Displays preserved data status. Any role in the system.
PAGE 29
Command Description Authority creatercopygroup Creates a group for Remote Super, Edit Copy. Any role granted the rcopygroup_create right. creatercopytarget Creates a target for Remote Copy. Super, Edit1 dismissrcopylink Dismisses a network link from Remote Copy use. Super, Edit1 Any role granted the rcopylink_dismiss right. “dismissrcopylink” (page 165) dismissrcopytarget Dismisses a Remote Copy target from a Remote Copy volume group.
PAGE 30
Command Description Authority For Details See stoprcopy Stops a Remote Copy subsystem. Super, Edit1 “stoprcopy” (page 634) Stops a Remote Copy volume group. Super, Edit Synchronizes Remote Copy volume groups. Super, Edit stoprcopygroup syncrcopy 1 Any role granted the rcopy_stop right. “stoprcopygroup” (page 636) Any role granted the rcopygroup_stop right. “syncrcopy” (page 640) Any role granted the rcopy_sync right. You need access to all domains in order to run this command.
PAGE 31
Command Description Authority For Details See Any role granted the mag_service right. upgradecage upgradepd Upgrades drive cage firmware. Super, Service1 Upgrades disk firmware. Super, Service1 “upgradecage” (page 662) Any role granted the cage_upgrade right. “upgradepd” (page 664) Any role granted the pd_upgrade right. 1 You need access to all domains in order to run this command. Node Command Description Authority servicenode Prepares a node for service.
PAGE 32
System Upgrade Command Description Authority For Details See showpatch Displays patches applied to Any role in the system. a system. “showpatch” (page 419) showversion Displays software versions. Any role in the system. “showversion” (page 502) Authority For Details See SNMP Agent Commands Command 1 addsnmpmgr Adds an SNMP manager to Super receive trap notifications. Any role granted the snmpmgr_ad right.
PAGE 33
1 You need access to all domains in order to run this command. System Reporter Commands Command Description Authority sraomoves Any role in the system. Shows the space that Adaptive Optimization (AO) has moved between tiers. “sraomoves” (page 535) srcpgspace Displays historical space Any role in the system. data reports for common provisioning groups (CPGs). “srcpgspace” (page 537) srhistld Displays historical histogram Any role in the system. performance data reports for logical disks.
PAGE 34
Command Description Authority For Details See srstatport Any role in the system. Displays historical performance data reports for ports. “srstatport” (page 568) srstatqos Displays historical Any role in the system. performance data reports for QoS rules. “srstatqos” (page 570) srstatvlun Any role in the system. Displays historical performance data reports for VLUNs. “srstatvlun” (page 572) srvvspace Displays historical space data reports for virtual volumes (VVs). Any role in the system.
PAGE 35
Command Description Authority For Details See movepdtospare Moves specified physical disks to spare. Super, Service, Edit1 “movepdtospare” (page 217) Moves chunklets relocated from a physical disk to another physical disk. Super, Service1 moverelocpd removespare Removes spare chunklets. Any role granted the pd_movetospare right. “moverelocpd” (page 219) Any role granted the pd_movereloc right. Edit, Service1 “removespare” (page 248) Any role granted the spare_remove right.
PAGE 36
User Management Commands Command Description Authority For Details See createuser Creates user accounts. Super1 “createuser” (page 149) Any role granted the user_create right. removeuser Removes user accounts. Super1 “removeuser” (page 254) Any role granted the user_remove right. removeuserconn Removes user connections. Super1 “removeuserconn” (page 255) Any role granted the userconn_remove right. setpassword Changes your password.
PAGE 37
Volume Management Commands Common Provisioning Group Management Command Description compactcpg Super, Edit Consolidates logical disk space in a CPG into as few Any role granted the logical disks as possible, cpg_compact right. allowing unused logical disks to be removed. createcpg Creates a Common Provisioning Group (CPG). Super, Edit1 Removes CPGs. Super, Edit1 removecpg Authority For Details See “compactcpg” (page 75) “createcpg” (page 110) Any role granted the cpg_create right.
PAGE 38
Command Description sethost Super, Edit1 Sets properties on existing system hosts, including Any role granted the options to annotate a host host_set right. with descriptor information such as physical location, IP address, operating system, model, and so on. “sethost” (page 296) sethostset Sets the parameters and modifies the properties of a host set. “sethostset” (page 299) 1 Authority Super, Edit For Details See Any role granted the hostset_set right.
PAGE 39
Command Description Authority For Details See showpdch Displays the status of selected chunklets of physical disks. Any role in the system. “showpdch” (page 432) showpdvv Displays physical disk to virtual volume mapping. Any role in the system. “showpdvv” (page 437) showspace Displays estimated free space. Any role in the system. “showspace” (page 476) showvvmap Displays virtual volume to logical disk mapping. Any role in the system.
PAGE 40
Command Description Authority For Details See Any role granted the vv_create right. createvv Creates a virtual volume from logical disks. Super, Edit1 “createvv” (page 154) Any role granted the vv_create right. createvvset Defines a new set of virtual Super, Edit volumes provides the option Any role granted the of assigning one or more vvset_create right. existing virtual volumes to that set.
PAGE 41
Command Description Authority For Details See showrsv Displays information about reservation and registration of VLUNs connected on a Fibre Channel port. Any role in the system. “showrsv” (page 469) showvv Displays virtual volumes in the system. Any role in the system. “showvv” (page 506) showvvcpg Displays the virtual volume Any role in the system. sets defined on the HP 3PAR Storage System and their associated members.
PAGE 42
3 Add Command addsnmpmgr DESCRIPTION The addsnmpmgr command adds an SNMP manager to receive alert (traps) notifications. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX addsnmpmgr [options ] AUTHORITY • Super • Any role granted the snmpmgr_add right. NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the SNMP manager receives traps.
PAGE 43
5de:2008:0:0abcd::161a. RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the addition of SNMP manager IPv4 address 123.45.67.89 with the assigned password of alpha1: cli% addsnmpmgr –pw alpha1 123.45.67.89 The following example displays the addition of SNMP manager IPv6 address 5def:2008:abcd::161a with port number 9162: cli% addsnmpmgr -p 9162 5def:2008:abcd::161a NOTES • The HP 3PAR storage system does not support any form of name resolution.
PAGE 44
4 Admit Commands admithw DESCRIPTION The admithw command admits new hardware into the system. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SYNTAX admithw [options] OPTIONS –checkonly Only performs passive checks; does not make any changes. –f If errors are encountered, the admithw command ignores them and continues. The messages remain displayed. SPECIFIERS None. RESTRICTIONS Access to all domains is required to run this command.
PAGE 45
• The admithw command also handles creating system logical disks while adding and rebalancing spare chunklets. • Spares are allocated according to the algorithm specified by the Sparing Algorithm system parameter.
PAGE 46
admitpd DESCRIPTION The admitpd command creates and admits physical disk definitions to enable the use of those disks. AUTHORITY • Super, Service • Any role granted the pd_admit right. NOTE: You need access to all domains in order to run this command. SYNTAX admitpd [option] [...] OPTIONS –nold Do not use the physical disk (as identified by the WWN specifier) for logical disk allocation. See “NOTES” for more information about the –nold option.
PAGE 47
• Verify the admittance of physical disk definitions by issuing the showpd command. See “showpd” (page 420). • If no WWN is specified or if all the specified WWNs are admitted, the command succeeds. If all the specified WWNs could not be admitted, the command fails.
PAGE 48
admitrcopylink DESCRIPTION The admitrcopylink command adds one or more links (connections) to a Remote Copy target system. SYNTAX • For Remote Copy over IP (RCIP), the syntax for the admitrcopylink command is as follows: admitrcopylink ... • For Remote Copy over Fibre Channel (RCFC), the syntax for the admitrcopylink command is as follows: admitrcopylink ... AUTHORITY • Super, Edit • Any role granted the rcopylink_admit right.
PAGE 49
NOTES • The transport layer (RCIP or RCFC) is set using the creatercopytarget command. • This command concludes by returning a list of one or more links to be admitted. • For IP targets this list is made up of pairs composed of the node containing the Ethernet port on the local system and an IP address of the peer port on the target system. • For FC targets this list is made up of sets with the node, slot, and port of the FC port on the local system and WWN of the peer port on the target system.
PAGE 50
admitrcopytarget DESCRIPTION The admitrcopytarget command adds a target to a Remote Copy volume group. SYNTAX admitrcopytarget [:]... AUTHORITY • Super, Edit • Any role granted the rcopytarget_admit right. NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS Specifies the name of the target that was previously created with the creatercopytarget command.
PAGE 51
admitrcopyvv DESCRIPTION The admitrcopyvv command adds an existing virtual volume to an existing Remote Copy volume group. SYNTAX admitrcopyvv [options] [:] :... AUTHORITY • Super, Edit • Any role granted the rcopyvv_admit right. OPTIONS -pat Specifies that the is treated as a glob-style pattern and that all Remote Copy volumes matching the specified pattern are admitted to the Remote Copy group.
PAGE 52
The target name associated with this group, as set with the creatercopygroup command. The target is created with the creatercopytarget command. specifies the name of the secondary volume on the target system. One : must be specified for each target of the group. Specifies a glob-style pattern. If this specifier is not used, the specifier must be used.
PAGE 53
In the following example, the admitrcopyvv command adds all the volumes that start with the name testvv to the primary volume group Group1. At the same time, it adds all the volume testvv*.r on the target system InServ1_in to the corresponding secondary volume group that was previously created when the creatercopygroup command was issued.
PAGE 54
admitvv DESCRIPTION The admitvv command creates and admits remotely exported virtual volume definitions to enable the migration of these volumes. The newly created volume will have the WWN of the underlying remote volume. SYNTAX admitvv [-domain ] : [: ...] admitvv [-domain ] :: [:] ... AUTHORITY • Super, Edit • Any role granted the vv_admit right.
PAGE 55
5 Cancel Command canceltask DESCRIPTION The canceltask command cancels one or more tasks. SYNTAX canceltask [option] {all|...} AUTHORITY • Service, Super, Edit • Any role granted the task_cancel right. OPTIONS –f Forces the command. The command completes the process without prompting for confirmation. SPECIFIERS all Cancels all active tasks. If not specified, a task ID(s) must be specified. ... Cancels only tasks identified by their task IDs.
PAGE 56
6 Change Command changedomain DESCRIPTION The changedomain command changes the currentdomain CLI environment parameter. SYNTAX changedomain [] AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS Name of the domain to be set as the working domain for the current CLI session. If the parameter is not present or is equal to -unset, then the working domain is set to no current domain. RESTRICTIONS Access to all domains is required to run this command.
PAGE 57
7 Check Commands checkhealth DESCRIPTION The checkhealth command checks the status of system hardware and software components, and reports any issues. NOTE: For information about system alerts, go to http://www.hp.com/support/hpgt/3par and select your server platform. SYNTAX checkhealth [ | ] AUTHORITY • Super, Service • Any role granted the health_check right. OPTIONS -lite Will perform a minimal health check. –list Will list all components that will be checked.
PAGE 58
Checking rc Checking snmp Checking task Checking vlun Checking vv Component ------------Description------------ Qty Alert New alerts 6 Cage Cages not on current firmware 2 Date Date is not the same on all nodes 1 LD LDs not mapped to a volume 3 License Golden License. 1 PD PDs that are degraded or failed 2 pdch LDs with chunklets on a remote disk 5 vlun Hosts not connected to a port 3 vlun Paths not reported by host agent 2 NOTES None.
PAGE 59
checkld DESCRIPTION The checkld command executes consistency checks of data on logical disks in the event of an uncontrolled system shutdown and optionally repairs inconsistent logical disks. SYNTAX checkld [options] ... Any role granted the ld_check right AUTHORITY • Super, Service • Any role granted the ld_check right NOTE: You need access to all domains in order to run this command.
PAGE 60
The following example attempts to recover chunklet 1032:10 of logical disk vv.adm.0, and there will be output about the progress: cli% checkld -y -p -recover 1032:10 vv.adm.0 NOTES 60 • Repairing logical disks refers to making logical disks consistent. • Consistency for RAID-1 means that all mirrors in the set have the same data. • Consistency for RAID-5 or RAID-6 means that parity is consistent with the data in the set.
PAGE 61
checkpassword DESCRIPTION The checkpassword command prompts for the 's password and then displays the steps the system uses to authenticate the user and determine the user's access to the system. The information includes whether the user is local to the system or authenticated and authorized based on the configuration parameters set with setauthparam command for use with LDAP.
PAGE 62
setauthparam command has been used to change parameters or data in the LDAP server has changed since the user last logged in. • 62 The showuserconn command can be used to verify the authorization levels assigned at login.
PAGE 63
checkpd DESCRIPTION The checkpd command executes surface scans or diagnostics on physical disks. SYNTAX checkpd scrub|diag [options ] ... AUTHORITY • Super, Service • Any role granted the pd_check right. NOTE: You need access to all domains in order to run this command. OPTIONS The following options can only be used with the scrub specifier: -ch To scan a specific chunklet rather than the entire disk. -count To scan a number of chunklets starting from -ch.
PAGE 64
Performs read, write, or verifies test diagnostics. ... The ID of the physical disk to be checked. Only one pd_ID can be specified for the “scrub” test. RESTRICTIONS Access to all domains is required to run this command.
PAGE 65
checkport DESCRIPTION The checkport command performs a loopback test on Fibre Channel ports. SYNTAX checkport [options ] AUTHORITY Super, Service Any role granted the port_check right. NOTE: You need access to all domains in order to run this command. OPTIONS –time Specifies the number of seconds the test is to run. Use an integer from 0 to 300. –iter Specifies the number of times the test is to run. Use an integer from 1 to 1000000.
PAGE 66
NOTES 66 • When both the -time and -iter options are specified, the first limit reached terminates the program. If neither are specified, the default is 1,000 iterations. The total run time is always limited to 300 seconds even when not specified. • The default loopback is an ELS-ECHO sent to the HBA itself.
PAGE 67
checkrclink DESCRIPTION The checkrclink command performs a connectivity, latency, and throughput test between two connected HP 3PAR storage systems. SYNTAX • checkrclink startclient [] • checkrclink stopclient • checkrclink startserver [] [] • checkrclink stopserver • checkrclink portconn AUTHORITY • Super, Service • Any role granted the rclink_check right.
PAGE 68
Specifies the port on which to run the test. If this specifier is not used, the test automatically runs on port 3492. RESTRICTIONS The Remote Copy ports must be configured via the controlport command before this test can be carried out; however, this test can be performed before links are admitted into the Remote Copy target system. EXAMPLES The following example displays a 60-second latency and throughput check of SystemA to SystemB: SystemB# checkrclink startserver 0:6:1 10.100.33.
PAGE 69
c. (Optional) To end the test before it completes, on SystemA enter: # checkrclink stopclient d.
PAGE 70
checksnmp DESCRIPTION The checksnmp command allows a user to send an SNMPv2 test trap to the list of managers as specified in showsnmpmgr. SYNTAX checksnmp AUTHORITY Super, Service Any role granted the snmp_check right OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example shows the case when there are SNMP managers configured. The trap destinations are displayed in the format :. cli% checksnmp Trap sent to the following managers: 192.168.17.10:162 192.168.17.
PAGE 71
checkvv DESCRIPTION The checkvv command executes validity checks of virtual volume administration information in the event of an uncontrolled system shutdown and optionally repairs corrupted virtual volumes. SYNTAX checkvv [options] ... AUTHORITY • Super, Service • Any role that is granted the vv_check right. NOTE: You need access to all domains in order to run this command.
PAGE 72
8 CLI Command cli DESCRIPTION The cli command provides a means to set up your CLI session or to enter directly into a CLI shell. SYNTAX cli [options] [] AUTHORITY Super, Edit, Browse, Service OPTIONS –v Displays the CLI client version. –b Displays the CLI client build level. –h Displays help for the cli command. –tpdportnum Specifies the TCP port of the CLI server to which the CLI client connects. The default SSL port number is 5783; the default unsecured port number is 5782.
PAGE 73
–nohdtot Does not print header and totals. –csvtable Prints table data as Comma Separated Values (CSV). –listdom Indicates the domain associated with the storage server. –clientname Sets name of the client application. –clientver Sets version of the client application. –clienthost Sets name of the host the client application runs on. –-conntimeout The maximum time in seconds to establish the connection to the CLI server.
PAGE 74
NOTES • If the cli command is issued without any arguments, you are placed in a CLI shell. After commands are issued, the CLI exits unless the –cmdloop option was specified. • Multiple commands can be entered by quoting a semicolon separator: cli showdate ";" showversion ENVIRONMENT VARIABLES TPDSOCKSSL If set, use an SSL socket TPDNOSOCKSSL If set, do not use an SSL socket TPDNOSOCKSSL If set, do not use an SSL socket TPDSYSNAME System to connect to.
PAGE 75
9 Compact Commands compactcpg DESCRIPTION The compactcpg command consolidates logical disk space in Common Provisioning Groups (CPGs) into as few logical disks as possible, allowing unused logical disks to be removed and their space reclaimed. SYNTAX compactcpg [options] ... compactcpg -pat [options] ... AUTHORITY • Super, Edit • Any role granted the cpg_compact right. OPTIONS -pat Compacts CPGs that match any of the specified patterns.
PAGE 76
EXAMPLES The following example shows how to compact a single CPG named testcpg and remove any unused logical disks after consolidating the space: cli% compactcpg -trimonly testcpg Are you sure you want to compact CPG 'testcpg' ? select q=quit y=yes n=no: y Task 612 started NOTES 76 • Logical disks that are consolidated must have the same owner and backup nodes. • If one logical disk exists with a different owner and backup node, that logical disk will be compacted individually.
PAGE 77
compactld DESCRIPTION The compactld command consolidates space on the logical disks. SYNTAX compactld [options ] ...|... AUTHORITY • Super, Edit • Any role granted the ld_compact right. OPTIONS -pat Compacts the logical disks that match any of the specified patterns. -cons This option consolidates regions onto the fewest possible logical disks. When this option is not specified, the regions of each logical disk will be compacted within the same logical disk.
PAGE 78
EXAMPLES In the following example, logical disk pdsld0.0 is compacted: cli% compactld -f pdsld0.0 Compacting LDs: pdsld0.0 NOTES None.
PAGE 79
10 Control Commands controlencryption DESCRIPTION The controlencryption provides various commands to control data encryption.
PAGE 80
EXAMPLES The following example backs up the keystore to file backup1: cli% controlencryption backup backup1 The following example restores the keystore from file backup1: cli% controlencryption restore backup1 NOTES The keystore MUST be backed up to prevent total loss of data. A password must be supplied (twice) on backup. The same password must be supplied on restore. For enable and rekey, there must be no failed disks.
PAGE 81
controliscsiport DESCRIPTION The controliscsiport command is used to set properties of an iSCSI port.
PAGE 82
SPECIFIERS Indicates the IP address of the iSCSI target. Indicates the IP netmask of the iSCSI target. Indicates the IP address of the gateway. Indicates the MTU size in bytes. Indicates the IP address of the primary iSNS server. Indicates the IP address of the secondary iSNS server. Returns the TCP port number of the iSNS server. The default port number is 3205.
PAGE 83
controlmag DESCRIPTION The controlmag command takes drive magazines, or disk drives within a magazine, either on loop or off loop. Use this command when replacing a drive magazine or disk drive within a drive magazine. SYNTAX controlmag offloop|onloop [options] AUTHORITY • Super, Service • Any role granted the mag_control right. NOTE: You need access to all domains in order to run this command.
PAGE 84
EXAMPLES The following example requests that drive magazine 1 in drive cage cage0 be put on loop: cli% controlmag onloop cage0 1 NOTES Taking a drive magazine off-loop has the following consequences: 84 • Relocation of chunklets. • Affected logical disks are put into write-through mode. • Momentary dip in throughput, but no loss of connectivity.
PAGE 85
controlpd DESCRIPTION The controlpd command spins a physical disk up or down. This command is used when replacing a physical disk in a drive magazine. CAUTION: Issuing the controlpd command puts the specified disk drive in a not ready state. Furthermore, if this command is issued with the spindown subcommand, data on the specified drive becomes inaccessible. SYNTAX controlpd spinup|spindown [options] ... AUTHORITY • Super, Service • Any role granted the pd_control right.
PAGE 86
NOTES Issuing the controlpd command puts the specified disk drive in a not ready state. Furthermore, if this command is issued with the spindown subcommand, data on the specified drive becomes inaccessible.
PAGE 87
controlport DESCRIPTION The controlport command controls all aspects of a Fibre Channel or Remote Copy port, including the port’s connection type and data rate. SYNTAX The syntax for the controlport command can be one of the following: • controlport config [-ct ][-unique_nwwn enable|disable] [-f]... • controlport rst [–m |–l|-i] [–f] ...
PAGE 88
SUBCOMMANDS config Sets the specified connection mode and type on FC ports. Also allows setting the unique node WWN option for the port. When unique_nwwn is enabled, the port presents a unique node name on the connection and this is needed by certain initiators such as ONTAP. This command is also used to configure the mode of a CNA port. rst Resets a port. This subcommand is not applicable to RCIP ports. offline Holds the specified port offline indefinitely.
PAGE 89
is issued from the port whenever a VLUN is created or removed. See “SPECIFIERS” for additional information on parameters required to issue this subcommand. nssync Verifies current port database against the Name Server when a fabric is attached. Entries present in the database but missing from the Name Server are removed. Using this command is not required under normal circumstances. rcip addr Sets the Remote Copy interface to use the specified IP address and netmask.
PAGE 90
This option can only be used with the rst subcommand. Resets the mode of the port. The port can be reset into a target or initiator mode. If not specified, the port is reset to its current mode. If the port’s mode change value is prohibited, this command fails when attempting to reset to a different mode. Use showport –c to see whether mode change is allowed or prohibited for a particular port. See notes at the bottom of this section for additional information regarding port pair protection.
PAGE 91
–s Specifies the packet size. If no size is specified, the option defaults to 64. This option and argument can only be used with the rcip ping subcommand. –pf Prevents packet fragmentation when issuing the controlport rcip ping command. This option can only be used with the rcip ping subcommand. -portwwn Specifies the Fibre Channel worldwide port name of an attached device for which selective LIP reset will be performed.
PAGE 92
port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot using 1 through 4. Specifies the IP address for a Remote Copy interface. Specifies the gateway address for a Remote Copy interface. Specifies the netmask for a Remote Copy interface. Specifies the MTU size for a Remote Copy interface using an integer from 100 to 9000. If no integer is specified, the value defaults to 1500.
PAGE 93
option is overridden (if specified), a warning is returned, and you are prompted for confirmation to complete the execution of the commands. • The controlport rcip addr command is only allowed for node/slot/port combinations where there is an interface installed. EXAMPLES The following example shows how to increase MTU to 9000 on Gigabit Ethernet port 1 in node 6, slot 3: cli% controlport rcip mtu 9000 6:3:1 Remote Copy change successful. The following example shows how to set Remote Copy interface 172.
PAGE 94
of the offline port causes the online partner port to undergo mode change as well. This results in loss of use of the partner port because it is no longer online. 94 • Issuing the controlport rst -l command affects both ports of a port pair. Only use this command when irreversible damage has been done to a port or port pair. • When issuing the controlport cl2 or vcn commands, if the port is configured as peer connection mode, an error is returned.
PAGE 95
11 Create Commands createald DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. The createald command creates disks with automatic chunklet allocation for the disks. SYNTAX createald [options] [g|G|t|T] AUTHORITY • Super, Service, Edit • Any role that is granted the ld_create right. NOTE: You need access to all domains in order to run this command. OPTIONS –templ Use the options defined in template .
PAGE 96
Specifies the chunklet location preference characteristics, either first (attempt to use the lowest numbered available chunklets) or last (attempt to use the highest numbered available chunklets). If no argument is specified, the default characteristic is first. –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all Fibre Channel (FC) disks.
PAGE 97
–tc_lt Specifies that PDs with total chunklets less than the number specified are selected. –fc_gt Specifies that PDs with free chunklets greater than the number specified are selected. –fc_lt Specifies that PDs with free chunklets less than the number specified are selected. –devid Specifies that PDs identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command.
PAGE 98
Specifies that a new logical disk should be created, even if an existing LD could be grown (to be used in conjunction with the -cpsa and -cpsd options). -listlds Specifies that the names of any newly created LDs should be displayed. SPECIFIERS Specifies the logical disk base name (up to 24 characters in length). The name is created by concatenating the name with an integer value - starting at zero, incrementing it by one for each logical disk generated, up to 999999. This field is required.
PAGE 99
createaldvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the createvv command in the future. The createaldvv command creates a virtual volume and its underlying logical disks and allows the system to automatically allocate resources to meet specified use requirements.
PAGE 100
Specifies the chunklet location preference characteristics: either first (attempt to use the lowest numbered available chunklets) or last (attempt to use the highest numbered available chunklets). If no argument is specified, the default characteristic is first. –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating LDs. If no pattern is specified, the option defaults to Fibre Channel (FC) disks.
PAGE 101
–fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command.
PAGE 102
Specifies that the system will try to share the logical disks among the virtual volumes. This option can only be used with the -cnt option. –szs [g|G|t|T] Specifies the size of the snapshot volume. Defaults to megabytes. Size can be optionally specified in gigabytes (with g or G suffix) or terabytes (with t or T suffix). If not specified, snapshot space is 0. This option cannot be used with the -pct option. –pct Specifies the size of the snapshot volume as a percentage of the user volume.
PAGE 103
Defines the virtual volume geometry heads per cylinder value that is reported to the hosts though the SCSI mode pages. The valid range is between 1 to 255 and the default value is 8. –pol [,...] Specifies VV policies. stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume, but the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted.
PAGE 104
NOTES For this command: • MB = 1048576 bytes • GB = 1024 MB • TB = 1024 GB 104 Create Commands
PAGE 105
createaocfg DESCRIPTION The createaocfg command creates an Adaptive Optimization (AO) configuration. AUTHORITY Super, Edit SYNTAX createaocfg [options ] OPTIONS -t0cpg Specifies the Tier 0 CPG for this AO config. -t1cpg Specifies the Tier 1 CPG for this AO config. -t2cpg Specifies the Tier 2 CPG for this AO config.
PAGE 106
The following example creates a new AO configuration called aocfg2. The optimization bias defaults to Balanced, and no Tier 1 CPG is specified.
PAGE 107
createavv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the createvv command in the future. The createavv command creates a virtual volume where logical disk mapping is determined by the system.
PAGE 108
–pol no_stale_ss|stale_ss|one_host|no_one_host Specifies the policy (rule) that the created virtual volume follows. If an argument is not specified, the policy defaults to stale_ss. stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume. However, the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted.
PAGE 109
RESTRICTIONS • Logical disks must be available to run the createavv command. Issue the createald command to create logical disks. See “createald” (page 95) for more information. • The . , , and specifiers cannot be used if the createavv -cpg command is issued.
PAGE 110
createcpg DESCRIPTION The createcpg command creates a Common Provisioning Group (CPG). AUTHORITY • Super, Edit • Any role that is granted the cpg_create right. NOTE: You need access to all domains in order to run this command. SYNTAX createcpg [options ] CPG_name OPTIONS –templ Use the options defined in the template . The template is created using the createtemplate command. Options specified in the template are read-only or read/write.
PAGE 111
–sdgl [g|G|t|T] Specifies that the auto-grow operation is limited to the specified storage amount. The storage amount can be specified in MB (default) or GB (using g or G) or TB (using t or T). A size of 0 (default) means no limit is enforced. To disable auto-grow, set the limit to 1. –sdgw [g|G|t|T] Specifies that the threshold of used logical disk space, when exceeded, results in a warning alert. The size can be specified in MB (default) or GB (using g or G) or TB (using t or T).
PAGE 112
–p Specifies a pattern for candidate disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all Fibre Channel (FC) disks. If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern. The -devtype pattern cannot be used to mix Near Line (NL), FC, and Solid State Drive (SSD) drives.
PAGE 113
–fc_gt Specifies that physical disks with free chunklets greater than the number specified be selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified be selected. –devid Specifies that PDs identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command.
PAGE 114
NOTES • 114 For this command: ◦ KB = 1024 bytes ◦ MB = 1048576 bytes ◦ GB = 1073741824 bytes • When using the createcpg command, the size of the logical disk space created is the first integer multiple of the RAID set size that is large enough to accommodate the requested virtual volume size.
PAGE 115
createdomain DESCRIPTION The createdomain command creates system domains. AUTHORITY • Super • Any role that is granted the domain_create right. NOTE: You need access to all domains in order to run this command. SYNTAX createdomain [option ] OPTIONS -comment Specifies any comments or additional information for the domain. The comment can be up to 511 characters long. Unprintable characters are not allowed. The comment must be placed inside quotation marks.
PAGE 116
createdomainset description The createdomainset command defines a new set of domains and provides the option of assigning one or more existing domains to that set. The command also allows the addition of domains to an existing set by use of the -add option. SYNTAX createdomainset [options] [...] AUTHORITY • Super, Edit • Any role that is granted the domainset_create right. OPTIONS -add Specifies that the domains listed should be added to an existing set.
PAGE 117
creategroupsv DESCRIPTION The creategroupsv command creates consistent group snapshots of a list of Virtual Volumes. Consistent group snapshots are all created at the same point in time so that related structures on different volumes in the group remain consistent. SYNTAX creategroupsv [option] [:[:]]... AUTHORITY • Super, Edit • Any role that is granted the groupsv_create right. OPTIONS –ro Specifies that read-only snapshots are created.
PAGE 118
SPECIFIERS Specifies the name of the Virtual Volume being copied (the parent volume). Optional name of the snapshot Virtual Volumes. If is not specified, the system tries to automatically generate the snapshot name of the form . where is either ro or rw and is either empty or the lowest number starting from 0 that does not conflict with an existing volume name.
PAGE 119
creategroupvvcopy DESCRIPTION The creategroupvvcopy command creates consistent group physical copies of a list of virtual volumes. SYNTAX The syntax for the creategroupvvcopy command can be one of the following: • creategroupvvcopy -p [options] :... • creategroupvvcopy -r [options] ... • creategroupvvcopy -halt ... AUTHORITY • Super, Edit • Any role that is granted the groupvvcopy_create right.
PAGE 120
Use this specifier to block until all the copies are complete. Without this option, the command completes before the copy operations are completed (use the showvv command to check the status of the copy operations). -pri Specifies the priority of the copy operation when it is started. This option allows the user to control the overall speed of a particular task. If this option is not specified, the creategroupvvcopy operation is started with default priority of medium.
PAGE 121
createhost DESCRIPTION The createhost command creates or adds paths to a new system host and provides the option of assigning one or more paths to that host. Paths can be either Fibre Channel WWNs or iSCSI names. The command also provides options to annotate the host with descriptor information such as physical location, IP address, Operating System, Model, and so on. SYNTAX The syntax for the creathost command can be one of the following: • createhost [options] [...
PAGE 122
Specifies any additional information for the host. SPECIFIERS Specifies the name of the host, using up to 31 characters. Specifies the World Wide Name (WWN) to be assigned or added to an existing host. This specifier can be repeated to specify multiple WWNs. This specifier is optional. Host iSCSI name to be assigned or added to a host. This specifier is optional. RESTRICTIONS Access to all domains is required to run this command.
PAGE 123
createhostset DESCRIPTION The createhostset command defines a new set of hosts and provides the option of assigning one or more existing hosts to that set. The command also allows the addition of hosts to an existing set by use of the -add option. SYNTAX createhostset [options] [...] AUTHORITY • Super, Edit • Any role that is granted the hostset_create right. OPTIONS -add Specifies that the hosts listed should be added to an existing set. At least one host must be specified.
PAGE 124
To create a host set with a comment and a host in it: cli% createhostset -comment “A host set” oraset ora1 NOTES None.
PAGE 125
createld DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the createvv command in the future. The createld command allows you to create a logical disk. Unlike the createald command, issuing the createld command requires that you allocate chunklets for the logical disk created. SYNTAX createld [options] ... AUTHORITY • Super, Edit • Any role that is granted the ld_create role.
PAGE 126
Specifies the logical disk name, using up to 31 characters. Specifies the RAID type: 0 for RAID-0, 1 for RAID -1, 5 for RAID-5, or 6 for RAID-6. Specifies the number of sets in a row. Lists PDs and chunklet pairs. RESTRICTIONS None. EXAMPLES None. NOTES 126 • Verify the creation of a logical disk by issuing the showld command. See “showld” (page 394) for more information. • To create a RAID-1 volume the mirror depth (-mdflag) must be specified.
PAGE 127
creatercopygroup DESCRIPTION The creatercopygroup command creates a Remote Copy volume group. SYNTAX creatercopygroup [options] [: ...] AUTHORITY • Super, Edit • Any role that is granted the rcopygroup_create right. OPTIONS -domain Creates the Remote Copy group in the specified domain. The volume group must be created by a member of a particular domain with Super or Edit privileges. -usr_cpg :...
PAGE 128
If using domains, the syntax would appear as: cli% creatercopygroup -domain domain2 Group1 System2_out:periodic If using volume auto-create: cli% creatercopygroup -usr_cpg Localcpg target:Targetcpg -snp_cpg Localsnp target:Targetsnp groupname target:periodic NOTES 128 • If the mirror_config policy is set for this group’s target system and the group is a primary group, then this command will be mirrored to the target and the corresponding secondary group will also be removed.
PAGE 129
creatercopytarget DESCRIPTION The creatercopytarget command creates a Remote Copy target definition. SYNTAX The syntax for the creatercopytarget command can be one of the following: • Syntax for Remote Copy over IP (RCIP) is as follows: creatercopytarget [options] IP []... • Syntax for Remote Copy over Fibre Channel (RCFC) is as follows: creatercopytarget [options] FC []...
PAGE 130
The following example creates a primary target definition named System1 on the backup system, where the node numbers of the backup system’s Ethernet ports are located at 2:3:1 and 3:3:1 and the corresponding IP addresses on the primary system are 10.1.1.96 and 10.1.2.96: # creatercopytarget System1 IP 2:3:1:10.1.1.96 3:3:1:10.1.2.
PAGE 131
createsched DESCRIPTION The createsched command allows users to schedule tasks that are periodically run by the scheduler. SYNTAX createsched [options] AUTHORITY • Super, Service • Any role that is granted the sched_create right. OPTIONS -run_once The task will only run once at the specified time. -no_alert Tasks created with the no_alert option will not generate alerts if the task fails.
PAGE 132
2h). The created snapshot will be named sample_vv_set.HH.MMM where HH and MM refer to the hour and minute that the snapshot was created (@vvname@.@H@.@M@): cli% createsched "createsv -ro -exp 2h @vvname@.@H@.@M@ vv" "0 * * * *" sv_task The following example creates a scheduled task which will create a consistent group snapshot.
PAGE 133
• Ranges of numbers are allowed. Ranges are two numbers separated with a hyphen. The specified range is inclusive. For example, 8-11 for an hour entry specifies execution at hours 8, 9, 10 and 11. Ranges must be specified from low to high.
PAGE 134
createsnmpuser DESCRIPTION The createsnmpuser command creates the SNMPv3 user secret key used for generating authentication and privacy keys. Username must correspond to an existing local user. The user will be prompted to provide a password, which will be converted to a 20 byte secret key. SYNTAX createsnmpuser [options AUTHORITY • Super • Any role granted the snmpuser_create right OPTIONS -p Specifies the user's password.
PAGE 135
createspare DESCRIPTION The createspare command allocates chunklet resources as spares. Chunklets marked as spare are not used for logical disk creation and are reserved explicitly for spares, thereby guaranteeing a minimum amount of spare space. SYNTAX createspare [options ] ... AUTHORITY • Super, Service • Any role granted the spare_create right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Do not ask for confirmation.
PAGE 136
EXAMPLES • The following example marks chunklet 1 as spare for physical disk 15: cli% createspare 15:1 • The following example specifies the position in a drive cage, drive magazine, physical disk, and chunklet number. –pos 1:0.2:3:121, where 1 is the drive cage, 0.2 is the drive magazine, 3 is the physical disk, and 121 is the chunklet number. cli% createspare –pos 1:0.2:3:121 NOTES To verify the creation of a spare chunklet, issue the showspare command. See “showspare” (page 479) for more information.
PAGE 137
createsv DESCRIPTION The createsv command creates a point-in-time (snapshot) copy of a virtual volume. Create snapshots to perform such tasks as backing up data on the base volume and allowing multiple copies of a base volume to be modified without affecting the original base volume. Syntax createsv [options ] AUTHORITY • Super, Edit • Any role that is granted the sv_create right. OPTIONS –ro Specifies that the copied volume is read-only.
PAGE 138
SPECIFIERS Specifies the snapshot name, using up to 31 characters in length. Specifies the parent volume name or volume set name, using up to 31 characters in length. The VV_set name must start with set:. If copy_of_VV is a VV_set then svname can contain various patterns that are used to form the snapshot volume name. See Help sub,vvnamepat for details. RESTRICTIONS • Use of this command requires a HP 3PAR Virtual Copy license.
PAGE 139
createtemplate DESCRIPTION The createtemplate command creates Virtual Volume (VV), Logical Disk (LD), and Common Provisioning Group (CPG) templates. Templates are sets of predetermined parameters that are applied to the creation of VVs, LDs, and CPGs. Use of this command with the vv specifier to create a VV is deprecated and will be removed in a subsequent release. The command createvv should be used instead to create a VV.
PAGE 140
–ha port|cage|mag Specifies that the layout must support the failure of one port pair, one cage, or one drive magazine (mag). This option has no meaning for RAID-0. –ch first|last Specifies the chunklet characteristics, either first (attempt to use the lowest numbered available chunklets) or last (attempt to use the highest numbered available chunklets). If no argument is specified, the default characteristic is first. –p Specifies a pattern for candidate disks.
PAGE 141
NOTE: The following arguments, –tc_gt , –tc_lt , –fc_gt , –fc_lt , –devid , and –devtype are used to limit the disks that are used to create LDs based on the characteristics of the disk drive. –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected.
PAGE 142
Specifies the allocation limit threshold of the CPG. The snapshot data space is prevented from growing beyond the specified percentage of the virtual volume size. The template with this option can only be used with createaldvv command. This option is deprecated and will be removed in a subsequent release. –size [g|G|t|T] Specifies the size of the virtual volume and logical disk in megabytes.
PAGE 143
Specifies that if a host write results in the allocation of a new data page that is only partially filled by the host write, then a zero-fill is performed on the unwritten portion of the data page. This ensures that the host cannot read data from deleted volumes or snapshot. The default allocation page size is 16 KB. no_tp_bzero Specifies that the zero-fill operation is bypassed on the allocation of partially written data pages.
PAGE 144
terabytes by using the t|T parameter. To specify the size in gigabytes, enter g or G, for terabytes, enter t or T, directly after the specified size (no space). The default is 0. –sdgw [g|G|t|T] Issues a warning alert when the used logical disk space exceeds this amount. A size of 0 means no warning limit is enforced. Size can be specified in megabytes (default) or in gigabytes by using the g|G parameter or terabytes by using the t|T parameter.
PAGE 145
createtpvv DESCRIPTION This command is deprecated and will be removed in a subsequent release. Please use the createvv -tpvv command in the future. The createtpvv command creates a multi-space Thinly Provisioned Virtual Volume (TPVV). When the -snp_cpg option is specified, both of the user space and snapshot space of the TPVV are created. When the -snp_cpg option is not specified, only the user space of the TPVV is created and the snapshot space is not created.
PAGE 146
This option sets the user space allocation limit. The user space of the TPVV is prevented from growing beyond the indicated percentage of the VV size. After this size is reached, any new writes to the VV will fail. -snp_aw Enables a snapshot space allocation warning. A warning alert is generated when the snapshot space of the VV exceeds the indicated percentage of the VV size. -snp_al Sets a snapshot space allocation limit.
PAGE 147
This constrains the export of a volume to one host or one host cluster (when cluster names can be used as a host name). no_one_host This policy should only be used when exporting a VV to multiple hosts for use by a cluster-aware application, or when “port presents” VLUNs are used. This is the default policy setting.
PAGE 148
In the preceding example, a 1 GB TPVV named tpvv1 is allocated from a CPG named cpg1 and its allocation warnings and limits are set at 50% and 75%, respectively. The following example creates 3 VVs vv1.2, vv1.3, vv1.4: cli% createtpvv -cnt 3 cpg1 vv1.
PAGE 149
createuser DESCRIPTION The createuser command creates a new user with the specified name and role in the specified domain. SYNTAX createuser [option ] AUTHORITY • Super • Any role granted the user_create right. NOTE: You need access to all domains in order to run this command. OPTIONS Only one of the following options can be specified: –c Specifies the user's password in the clear-text format.
PAGE 150
EXAMPLES The following example displays the successful creation of a new user user1 with the clear-text password 123456, with access to all service pools, and with edit level authority: cli% createuser –c 123456 user1 testdomain edit User created NOTES 150 • If no password is specified using the -c or -e options, then you will be prompted for a clear-text password. • Verify the creation of a new user by issuing the showuser command. See “showuser” (page 497) for more information.
PAGE 151
createvlun DESCRIPTION The createvlun command creates a Virtual Logical Unit Number (VLUN) template that enables export of a Virtual Volume (VV) as a SCSI VLUN to one or more host(s). A SCSI VLUN is created when the current system state matches the rule established by the VLUN template. There are four types of VLUN templates: • port presents - created when only the node:slot:port are specified. The VLUN is visible to any initiator on the specified port. • host set - created when a host set is specified.
PAGE 152
For each VLUN created, the .int suffix of the VV_name specifier and LUN are incremented by one. –novcn Specifies that a VLUN Change Notification (VCN) not be issued after export. For direct connect or loop configurations, a VCN consists of a Fibre Channel Loop Initialization Primitive (LIP). For fabric configurations, a VCN consists of a Registered State Change Notification (RSCN) that is sent to the fabric controller. –ovrd Specifies that existing lower priority VLUNs will be overridden, if necessary.
PAGE 153
• Verify the creation of VLUNs by issuing the showvlun command. See “showvlun” (page 503) for more information. • Conflicts between overlapping VLUN templates are resolved by a priority order among templates with matched set being the highest and port presents the lowest.
PAGE 154
createvv DESCRIPTION The createvv command creates volumes that are provisioned from one or more Common Provisioning Groups (CPGs). Volumes can be fully provisioned from a CPG or can be thinly provisioned. You can optionally specify a CPG for snapshot space for fully provisioned volumes. Syntax createvv [options] [.] [g|G|t|T] AUTHORITY • Super, Edit • Any role that is granted the vv_create right.
PAGE 155
Do not ask for confirmation before creating a volume with retention time (-retain). -retain [d|D|h|H] Specifies the amount of time, relative to the current time, that the volume will be retained. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value.
PAGE 156
NOTE: Thin Persistence can have some performance implications during extremely busy system conditions. HP recommends the zero_detect policy only be enabled during Thin Persistence and Thin Conversion operations. The zero_detect policy should be disabled during normal operation. no_zero_detect This policy disables the HP 3PAR Storage System to scan for zeros in the incoming write data to reclaim allocated space on the volume. This is the default policy setting.
PAGE 157
• The -templ option is not valid for volumes that are fully provisioned. • The -shared and -wait option cannot be used when creating Thinly Provisioned Virtual Volumes with the -tpvv option. EXAMPLES The following example creates a 10 G TPVV named tpvv1 whose user space is allocated from the common provisioning group cpg1: cli% createvv -tpvv -usr_aw 50 -usr_al 75 cpg1 tpvv1 10G The following example creates 3 VVs vv1.2, vv1.3, vv1.4: cli% createvv -cnt 3 cpg1 vv1.
PAGE 158
createvvcopy DESCRIPTION The createvvcopy command creates a full physical copy of a Virtual Volume (VV) or a read/write virtual copy on another VV. This enables you to create copies of VV to perform tasks such as moving data to a larger VV or creating a copy of data for testing.
PAGE 159
Specifies the priority of the copy operation when it is started. This option allows the user to control the overall speed of a particular task. If this option is not specified, the createvvcopy operation is started with default priority of medium. High priority indicates that the operation will complete faster. Low priority indicates that the operation will run slower than the default priority task. This option cannot be used with -halt option. -online Specifies that the copy is to be performed online.
PAGE 160
Create a set of copies for the volumes in set vvcopyset, keeping snapshots around for quick resynchronization: cli% createvvcopy -s -p set:vvcopyset set:copys Child Parent Status TaskID s1 foo started 14 s2 bar started 15 s3 baz queued 16 Resynchronize the volumes in the volume set copies: createvvcopy -r set:copies Child Parent Status TaskID s1 started 17 s2 started 18 s3 queued 19 Create a set of copies for the volumes in set vvcopyset, mapping the parent volumes to destination volumes with a pattern: c
PAGE 161
• If the source or destination are volume sets then the createvvcopy command creates consistent group snapshots at the same point in time so that related structures on different volumes in the group remain consistent. • On systems that support zero_detect, if destination volume is a TPVV, zero_detect policy is enabled at start of physical copy.
PAGE 162
createvvset DESCRIPTION The createvvset command defines a new set of Virtual Volumes (VV) and provides the option of assigning one or more existing VVs to that set. The command also allows the addition of VVs to an existing set by use of the -add option. SYNTAX createvvset [options] [...] AUTHORITY • Super, Edit • Any role granted the vvset_create right. OPTIONS -add Specifies that the VVs listed should be added to an existing set. At least one VV must be specified.
PAGE 163
To add a VV to the set: cli% createvvset -add vvset vv1 To create a VV set with a comment and a collection of VVs in it: cli% createvvset -comment “Our Oracle VVs” -cnt 10 oravv oravv.0 NOTES None.
PAGE 164
12 Dismiss Commands dismisspd DESCRIPTION The dismisspd command removes Physical Disk (PD) definitions from system use. SYNTAX dismisspd ... AUTHORITY • Super, Service • Any role that is granted the pd_dismiss right. NOTE: You need access to all domains in order to run this command. OPTIONS None SPECIFIERS ... Specifies the PD(s), identified by integers, to be removed from system use. RESTRICTIONS • Access to all domains is required to run this command.
PAGE 165
dismissrcopylink DESCRIPTION The dismissrcopylink command removes one or more links (connections) created with the admitrcopylink command to a target system. SYNTAX • Syntax for Remote Copy over IP (RCIP): dismissrcopylink ... • Syntax for Remote Copy over Fibre Channel (RCFC): dismissrcopylink ... AUTHORITY • Super, Edit • Any role that is granted the rccopylink_dismiss right.
PAGE 166
NOTES • This command is finished with a list of one or more links to be dismissed. • For IP targets, this list is made up of pairs composed of the node containing the Ethernet port on the primary system and an IP address on the backup system. • For Fibre Channel targets, this list is made up of sets with the node, slot, and port of the Fibre Channel adaptor port on the primary system and a WWN address on the backup system.
PAGE 167
dismissrcopytarget DESCRIPTION The dismissrcopytarget command removes a Remote Copy target from a Remote Copy volume group. SYNTAX dismissrcopytarget [options] AUTHORITY • Super, Edit • Any role that is granted the rcopytarget_dismiss right. OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS The name of the target to be removed.
PAGE 168
dismissrcopyvv DESCRIPTION The dismissrcopyvv command removes a virtual volume from a Remote Copy volume group. SYNTAX dismissrcopyvv [option] [] AUTHORITY • Super, Edit • Any role granted the rcopyvv_dismiss right. NOTE: You need access to the domain of the specified group () in order to run this command. OPTIONS -f Does not ask for confirmation for the dismissrcopyvv command.
PAGE 169
EXAMPLES The following example dismisses virtual volume vv1 from Group1: cli% dismissrcopyvv vv1 Group1 The following example dismisses all virtual volumes that start with the name testvv from Group1: cli% dismissrcopyvv -pat testvv* Group1 The following example dismisses volume vv1 from Group1 and removes the corresponding volumes of vv1 on all the target systems of Group1.
PAGE 170
13 Free Command freespace DESCRIPTION The freespace command frees snapshot administration and snapshot data spaces from a Virtual Volume (VV) if they are not in use. SYNTAX freespace [options] ...|... AUTHORITY • Super, Edit • Any role that is granted the space_free right. OPTIONS –pat Remove the snapshot administration and snapshot data spaces from all the VV that match any of the specified glob-style patterns.
PAGE 171
14 Grow Commands growaldvv DESCRIPTION This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the growvv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growaldvv command automatically enlarges (grows) the size of a virtual volume by adding underlying logical disks. AUTHORITY • Super, Edit • Any role granted the vv_grow right.
PAGE 172
Suppresses the requested confirmation before growing a virtual volume with a different RAID type than the last region of the existing virtual volume, or when the virtual volume size grows from under 2 T to over 2 T. –t Specifies the RAID type with r0, r1, r5 or r6. If not specified, the default RAID type is the same as the last region of the existing virtual volume.
PAGE 173
Specifies a pattern for disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all disks of device type specified at creation time. If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern.
PAGE 174
–fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their device IDs be selected for logical disk creation. Device IDs can be specified in a comma-separated list. Device IDs can be displayed by issuing the showpd –i command. –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for nearline, SSD for solid state drive) to be used.
PAGE 175
EXAMPLES The following example displays the enlarging of a RAID-5 virtual volume with 3+1 parity ratio named vv01 by 10 GB: cli% growaldvv –szu 10g –t r5 –ssz 4 vv01 NOTES • A volume can be enlarged while I/O is occurring. • When issuing the growaldvv command, the specified options only apply to the newly enlarged sections of the volume. This can result in a VV that has different characteristics in its base and grown sections.
PAGE 176
growavv DESCRIPTION This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the growvv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growavv command enlarges a Virtual Volume (VV) with automatic mapping to the Logical Disks (LDs).
PAGE 177
Specifies the LDs to be used as snapshot data space. The LDs are identified by one or more integers (item). Integers can be provided as a single number (1), a comma separated list of numbers (1,2,3), or a range of numbers separated with a dash (1–4). Specifies the size of the snapshot space in megabytes. RESTRICTIONS None. EXAMPLES None.
PAGE 178
growtpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the growvv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growtpvv command enlarges a Thinly Provisioned Virtual Volume (TPVV). AUTHORITY • Super, Edit • Any role granted the vv_grow right.
PAGE 179
growvv DESCRIPTION The growvv command increases the size of a virtual volume. SYNTAX growvv [g|G|t|T] AUTHORITY • Super, Edit • Any role granted the vv_grow right. NOTE: You need access to the domain of the specified group () in order to run this command. OPTIONS -f Suppresses the requested confirmation before growing a virtual volume size from under 2 T to over 2 T. SPECIFIERS The name of the volume to be grown.
PAGE 180
15 Hist Commands histch DESCRIPTION The histch command displays a histogram of service times in a timed loop for individual chunklets. SYNTAX histch [options ] AUTHORITY Any role in the system. OPTIONS –ld Specifies the Logical Disk (LD), identified by name, from which chunklet statistics are sampled. –ch Specifies that statistics are limited to only the specified chunklet, identified by number. –metric both|time|size Selects which metric to display.
PAGE 181
Specifies that the histogram displays data either from a previous sample (–prev) or from when the system was last started (–begin). If no option is specified, the histogram shows data from the beginning of the command’s execution. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483.
PAGE 182
SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays one iteration of a histogram of service times for system chunklets: cli% histch –iter 1 12:42:57 10/20/04 ------------Time (millisec)-----------Ldid Ldname LdCh Pdid PdCh 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 2 tp–0–sa–0.0 1 21 0 0 0 0 0 0 0 0 0 0 0 2 tp–0–sa–0.0 0 45 0 0 0 0 0 0 0 0 0 0 0 1 tp–0–sa–0.1 1 20 0 0 0 0 0 0 1 0 0 0 0 1 tp–0–sa–0.1 0 42 0 0 0 0 0 0 1 0 0 0 0 0 admin.usr.0 1 22 3 0 0 0 1 0 3 2 0 0 0 0 admin.usr.
PAGE 183
histld DESCRIPTION The histld command displays a histogram of service times for Logical Disks (LDs) in a timed loop. SYNTAX histld [options ] [...] AUTHORITY Any role in the system. OPTIONS -vv ...|... Show only LDs that are mapped to Virtual Volumes (VVs) with names that match any of the names or patterns specified. Multiple volumes or patterns can be repeated using a comma separated list. -domain ...|...
PAGE 184
Histogram displays data either from a previous sample (–prev) or from when the system was last started (–begin). If no option is specified, the histogram shows data from the beginning of the command’s execution. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds.
PAGE 185
Specifies the LD(s) or pattern(s) for which the histogram data is collected. RESTRICTIONS None. EXAMPLES The following example displays one iteration of a histogram of service times for all LDs: cli% histld –iter 1 12:38:49 10/20/04 ------------Time (millisec)-----------Ldame 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 tp–0–sa–0.0 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.1 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.0 0 0 0 0 0 0 0 0 0 0 admin.usr.0 0 0 0 0 1 6 6 1 0 0 tp–0–sa–0.1 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.
PAGE 186
histpd DESCRIPTION The histpd command displays a histogram of service times for Physical Disks (PDs). SYNTAX histpd [options ] AUTHORITY Any role in the system. OPTIONS –w Specifies the World Wide Name (WWN) of the physical disk for which service times are displayed. –nodes Specifies that the display is limited to specified nodes and physical disks connected to those nodes. The node list is specified as a series of integers separated by commas (1,2,3).
PAGE 187
For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15. • The first column () must be a value greater than or equal to 0, but less than the value of the last column (). The default value of is 3. • The last column () must be less than or equal to 15. The default value of is 15. -pct Shows the access count in each bucket as a percentage.
PAGE 188
• ◦ t - Specifies total statistics. ◦ rw - Specifies total read and write statistics. Specifies the threshold service time in milliseconds. • Specifies the minimum number of access above the threshold service time. When filtering is done, the is compared with the sum of all columns starting with the one which corresponds to the threshold service time.
PAGE 189
A range of disk positions is separated with a hyphen (0–3). The specified position(s) must contain disks. –dk Specifies one or more physical disks. Disks are identified by one or more integers (). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive.
PAGE 190
EXAMPLES The following example displays a histogram of service times for all physical disks and shows the columns from 8ms to 8192 ms.
PAGE 191
histport DESCRIPTION The histport command displays a histogram of service times for ports within the system. SYNTAX histport [options ] AUTHORITY Any role in the system. OPTIONS –both|–ctl|–data Specifies that both control and data transfers are displayed (–both), only control transfers are displayed (–ctl), or only data transfers are displayed (–data). If this option is not specified, only data transfers are displayed.
PAGE 192
–sizecols For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15. • The first column () must be a value greater than or equal to 0, but less than the value of the last column () (default value of 3). • The last column () must be less than or equal to 15 (default value of 11). -pct Shows the access count in each bucket as a percentage.
PAGE 193
• ◦ t - Specifies total statistics. ◦ rw - Specifies total read and write statistics. Specifies the threshold service time in milliseconds. • Specifies the minimum number of access above the threshold service time. When filtering is done, the is compared with the sum of all columns starting with the one which corresponds to the threshold service time.
PAGE 194
histrcvv DESCRIPTION The histrcvv command shows a histogram of total Remote Copy service times and backup system Remote Copy service times in a timed loop. SYNTAX histrcvv [options ][|]... AUTHORITY Any role in the system. OPTIONS -d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command uses a 2-second default interval.
PAGE 195
Displays the sums for all volumes of a domain. -domain ...|... Shows only the virtual volumes that are in domains with names that match the specified domain name(s) or pattern(s). -timecols For the I/O time histogram, shows the columns from the first column () through the last column (). The available columns range from 0 through 31. • must be equal to or greater than 0. The default value of is 6.
PAGE 196
RESTRICTIONS None. EXAMPLES The following example shows histograms sums for all synchronous Remote Copy volumes: cli% histrcvv -vvsum -sync 09:50:40 03/30/10 ----------Svt (millisec)---------- -------Rmt Svt (millisec)-------VVname RCGroup Target Mode 0.50 1 2 4 8 16 32 64 128 256 0.50 1 2 4 8 16 32 64 128 256 testvv.2 multi.1 amp2 Sync 0 0 0 163 61 16 3 0 0 0 0 224 19 0 0 0 0 0 0 0 testvv.3 multi.1 amp2 Sync 0 0 0 138 62 37 4 2 0 0 0 224 19 0 0 0 0 0 0 0 testvv.8 sync.
PAGE 197
histvlun DESCRIPTION The histvlun command displays Virtual Volume Logical Unit Number (VLUN) service time histograms. SYNTAX histvlun [options ] AUTHORITY Any role in the system. OPTIONS -domain ...|... Shows only VLUNs whose Virtual Volumes (VVs) are in domains with names that match one or more of the specified domain names or patterns. Multiple domain names or patterns can be repeated using a comma-separated list. –host ...|...
PAGE 198
–hostsum Specifies that sums for VLUNs are grouped by host in the display. All VLUNs to unnamed hosts are added and displayed as a single set of data with a nameless host. –metric both|time|size Selects which metric to display. Metrics can be one of the following: • both - (Default) Displays both I/O time and I/O size histograms. • time - Displays only the I/O time histogram. • size - Displays only the I/O size histogram.
PAGE 199
Sort in increasing order (default). dec Sort in decreasing order. –filt Specifies that histograms below the threshold specified by the argument are not displayed. The argument is specified in the syntax of ,,. • The argument can be specified as one of the following: • ◦ r - Specifies read statistics. ◦ w - Specifies write statistics. ◦ t - Specifies total statistics. ◦ rw - Specifies total read and write statistics.
PAGE 200
NOTES • Each service time histogram column shows the number of accesses with service times between the point in time shown in the column's heading to the point in time shown in the heading of the column to its right (or infinity for the last column). • Each I/O size histogram column shows the number of accesses with I/O size between the size shown in the column's heading to the size shown in the heading of the column to its right (or infinity for the last column).
PAGE 201
histvv DESCRIPTION The histvv command displays Virtual Volume (VV) service time histograms in a timed loop. SYNTAX histvv [options ] [|]... AUTHORITY Any role in the system. OPTIONS -domain ...|... Shows only the VVs that are in domains with names that match the specified domain name(s) or pattern(s). –metric both|time|size Selects which metric to display. Metrics can be one of the following: • both - (Default) Displays both I/O time and I/O size histograms.
PAGE 202
Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds. –iter Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647. –sortcol [,
][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. You must specify a column number.
PAGE 203
EXAMPLES The following example displays two iterations of a histogram of service times for all VVs: %cli histvv –iter 2 12:53:03 10/20/04 ------------Time (millisec)-----------VVname 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 admin 0 0 0 0 0 0 0 0 0 0 tpvv 29 0 0 0 0 0 0 0 0 0 --------------------------------------------------------total 29 0 0 0 0 0 0 0 0 0 12:53:05 10/20/04 ------------Time (millisec)-----------VVname 0.26 0.53 1.05 2.1 4.2 8.
PAGE 204
16 Import Command importvv DESCRIPTION The importvv command initiates the migration of data from a remote LUN to the local HP 3PAR Storage System. The remote LUN must be prepared for migration by using the admitvv command before using the importvv command. SYNTAX importvv [options] ... AUTHORITY • Super, Service, Edit • Any role granted the vv_import right. OPTIONS –f Specifies that the command is forced.
PAGE 205
RESTRICTIONS Functionality of this command requires the Peer Motion license. Contact your local service provider for more information. EXAMPLES The following example imports vv1 previously admitted using the admitvv command: cli% importvv cpg1 vv1 The following example imports vv1 as a thin provisioned volume: cli% importvv -tpvv cpg1 vv1 The following example imports multiple volumes as thin provisioned volumes and creates read only snapshots: cli% importvv -tpvv -snap @vvname@.
PAGE 206
17 Locate Commands locatecage DESCRIPTION The locatecage command allows system administrators to locate a drive cage, drive magazine, or port in the system using the devices’ blinking LEDs.
PAGE 207
EXAMPLES The following example causes the Fibre Channel LEDs on the drive cage cage0 to blink for 20 seconds: cli% locatecage –t 20 cage0 NOTES • Issue the showcage command for a list of cage names. • If no port or magazine is specified, all LEDs in the cage are set as amber or oscillate (depending on the cage type). • If the port is specified, it turns green (not available in all cage types).
PAGE 208
locatenode DESCRIPTION The locatenode command helps locate a particular node or its components by blinking LEDs on the node. By default all LEDs on the node will blink. SYNTAX locatenode [options] AUTHORITY • Super, Service • Any role granted the node_locate right. NOTE: You need access to all domains in order to run this command. OPTIONS -t Specifies the number of seconds, from 0 through 255, to blink the LEDs. If not specified, the option defaults to 60 seconds.
PAGE 209
locatesys DESCRIPTION The locatesys command helps locate a storage system by blinking the node status LEDs on all nodes of a storage system alternating between amber and green. By default, the LEDs in all connected cages are also set as amber or oscillating (depending on the cage). SYNTAX locatesys [options ] AUTHORITY • Super, Service • Any role granted the sys_locate right. NOTE: You need access to all domains in order to run this command.
PAGE 210
18 Move Commands movech DESCRIPTION The movech command moves a list of chunklets from one physical disk to another. SYNTAX movech [options] ... AUTHORITY • Super, Service, Edit • Any role granted the ch_move right. NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No chunklets are actually moved.
PAGE 211
EXAMPLES The following example moves the chunklet in position 0 on disk 24, to position 50 on disk 64 and chunklet in position 0 on disk 25, to position 1 on disk 27: cli% movech 24:0-64:50 25:0-27:1 Are you sure you want to move the chunklets? select q=quit y=yes n=no: y Move -State- --Detailed_State--24:0-64:50 normal normal 25:0-27:1 degraded disks_reused_in_row The columns in the previous example are identified as follows: • Status. The overall status of the move. • normal.
PAGE 212
• remote_pds_used. Remote PDs used. • ldpattern_not_obeyed. LD pattern was not obeyed. • raid_availability_reduced. RAID availability reduced. NOTES 212 • Chunklets moved through the movech command are only moved temporarily. Issuing either the moverelocpd or servicemag resume command can move the chunklet back to its original position. • Specifying the –dr option can be used to see if the specified moves succeed and what the results (quality) of the moves are.
PAGE 213
movechtospare DESCRIPTION The movechtospare command moves data from specified Physical Disks (PDs) to a temporary location selected by the system. SYNTAX movechtospare [options] AUTHORITY • Super, Service, Edit • Any role granted the ch_movetospare right. NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No chunklets are actually moved.
PAGE 214
• failed. Indicates the chunklet was not moved. • Detailed_State. Provides additional details of the move with General Information, Error Information, or Degraded Information. General Information: • dest_unknown. Destination is unknown. • dest_unknown. Destination is known. • valid_move. Source and Destination are valid. • ch_moved. Chunklet was moved. • ch_move_pending. Chunklet move is pending due to -nowait option. • move_error. Error moving chunklet.
PAGE 215
movepd DESCRIPTION The movepd command moves data from specified Physical Disks (PDs) to a temporary location selected by the system. SYNTAX movepd [options] ... AUTHORITY • Super, Service, Edit • Any role granted the pd_move right. OPTIONS -nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run, and no physical disks are actually moved. -devtype Permits the moves to happen to different device types.
PAGE 216
NOTES 216 • The destination physical disks do not need to be specified; the system automatically determines the spare locations. • Specifying the -dr option can be used to see if the specified moves succeed and the results (quality) of the moves.
PAGE 217
movepdtospare DESCRIPTION The movepdtospare command moves data from specified Physical Disks (PDs) to a temporary location selected by the system. SYNTAX movepdtospare [options] ... AUTHORITY • Super, Service, Edit • Any role granted the pd_movetospare right. NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No PDs are actually moved.
PAGE 218
The columns in the previous example are identified as follows: • Status. The overall status of the move. • normal. Indicates the chunklet has successfully moved with no loss of quality. • degraded. Indicates the chunklet has successfully moved with loss of quality. • failed. Indicates the chunklet was not moved. • Detailed_State. Provides additional details of the move with General Information, Error Information, or Degraded Information. General Information: • dest_unknown.
PAGE 219
moverelocpd DESCRIPTION The moverelocpd command moves chunklets that were on a physical disk to the target of relocation. SYNTAX moverelocpd [options] [[–...] AUTHORITY • Super, Service • Any role granted the pd_movereloc right. NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No physical disks are actually moved.
PAGE 220
-mg Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (e.g. 1,2,3). A range of drive magazines is separated with a hyphen (e.g. 0-7). Disks must reside in the specified drive magazine(s). -pn Specifies one or more disk positions within a drive magazine.
PAGE 221
it must be used at least once on the command line. If this specifier is repeated then the operation is performed on multiple disks. RESTRICTIONS Access to all domains is required to run this command.
PAGE 222
• src_set_invalid. Source is in invalid set. • src_not_found. Source chunklet does not exist. • invalid_dest. Destination is invalid. • move_failed. Chunklet move failed. • disk_relocating. Disk is relocating. Degraded Information: • disks_reused_in_row. Disks reused in row. • connection_degraded. Disks reused in row. • remote_pds_used. Connection Degraded. • ldpattern_not_obeyed. LD pattern was not obeyed. • raid_availability_reduced. RAID availability reduced.
PAGE 223
movetodomain DESCRIPTION The movetodomain command moves objects from one domain to another. SYNTAX movetodomain [options] AUTHORITY • Super, Edit • Any role granted the domain_moveto right. NOTE: You need access to all domains in order to run this command. OPTIONS –vv Specifies that the object is a virtual volume. -cpg Specifies that the object is a CPG. –host Specifies that the object is a host. –f Specifies that the command is forced.
PAGE 224
The following example displays the removal of the host testhost from any domain: cli% movetodomain -host testhost -unset The following hosts will have their domain modified: Id Name 2 testhost Persona -WWN/iSCSI_Name- Port Generic Do you want to proceed with removing the domain of the above? select y=yes n=no: y NOTES • The movetodomain command moves all objects that are directly or indirectly related to the specified object into the specified domain.
PAGE 225
19 Promote Commands promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. SYNTAX promotesv [options] AUTHORITY • Super, Edit • Any role granted the sv_promote right. OPTIONS -target Copy the differences of the virtual copy to the specified RW parent in the same VV family tree. The default is to copy the differences to the base volume.
PAGE 226
EXAMPLES The following example illustrates how virtual volume vv1 can be promoted with the differences from its base volume: cli% promotesv vv1 NOTES • Issue the showvv command to verify that differences in the snapshot volume are promoted to its target volume. • Issue the showvv –d command to display the number of remaining blocks to be copied. • The RW virtual copy and the target of the promote must not be exported.
PAGE 227
promotevvcopy DESCRIPTION The promotevvcopy command promotes a physical copy back to a regular base volume. SYNTAX promotevvcopy AUTHORITY • Super, Edit • Any role granted the vvcopy_promote right. OPTIONS None. SPECIFIERS Specifies the name of the physical copy to be promoted, using up to 31 characters. RESTRICTIONS The physical copy must have completed the copy from the base volume.
PAGE 228
20 Remove Commands removealert DESCRIPTION The removealert command removes one or more alerts from the system. CAUTION: Use care when removing alerts. Alerts that have not been fixed or acknowledged should not be removed. SYNTAX removealert [option] –a|... AUTHORITY • Super, Service • Any role granted the alert_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies all alerts from the system and prompts removal for each alert.
PAGE 229
Are you sure you want to remove it? select q=quit y=yes n=no: y Id 131 – New Message code: 1114115 Thu May 05 00:11:25 PDT 2005 Node: 0 Severity: Minor Too many events are being logged Too many events are being generated. 2 event files were rolled over in less than 1800 seconds. Current event files could not be archived because too many have been archived already. Alert 131 is marked as "New".
PAGE 230
removeaocfg DESCRIPTION The removeaocfg command removes specified Adaptive Optimization configurations from the system. AUTHORITY Super, Edit SYNTAX removeaocfg [options] {|}... OPTIONS -pat Indicates that specified patterns are treated as glob-style patterns and that all AO configurations matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified.
PAGE 231
removecpg DESCRIPTION The removecpg command removes Common Provisioning Groups (CPGs) from the system or removes specific Logical Disks (LDs) from CPGs. AUTHORITY • Super, Edit • Any role granted the cpg_remove right. NOTE: You need access to all domains in order to run this command. SYNTAX removecpg [options ] {|}... OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 232
RESTRICTIONS • Access to all domains is required to run this command. • The removecpg command fails if any of the LDs, or the entire CPG, is in use by a Thinly Provisioned Virtual Volume (TPVV). EXAMPLES The following example displays the removal of CPG cpg1: cli% removecpg cpg1 NOTES • By default, this command deletes any unused LDs. This is equivalent to using the –ld option. The –ld option still exists for backward compatibility.
PAGE 233
removedomain DESCRIPTION The removedomain command removes an existing domain from the system. SYNTAX removedomain [option] AUTHORITY • Super • Any role granted the domain_remove right. Super NOTE: You need access to all domains in order to run this command. OPTIONS –f When using this option, the command does not ask for confirmation before removing the domain. SPECIFIERS Specifies the domain that is removed.
PAGE 234
removedomainset DESCRIPTION The removedomainset command removes a domain set or removes domains from an existing set. SYNTAX removedomainset [options] [...] AUTHORITY • Super, Edit • Any role granted the domainset_remove right. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the domain set. ...
PAGE 235
removehost DESCRIPTION The removehost command removes a system host or paths to a host. If one or more paths are specified, the command removes only those paths, otherwise the entire host definition is removed. SYNTAX removehost [options] [...|...] AUTHORITY • Super, Edit • Any role granted the host_remove right. NOTE: You need access to all domains in order to run this command.
PAGE 236
NOTES • Removing an entire host definition by issuing the removehost command is not equivalent to removing all of the paths associated with a host. The latter leaves a host definition with no paths associated to it, whereas the former removes the entire host definition. • Verify the removal of hosts by issuing the showhost command.
PAGE 237
removehostset DESCRIPTION The removehostset command removes a host set or removes hosts from an existing set. SYNTAX removehostset [options] [...] AUTHORITY • Super, Edit • Any role granted the hostset_set right can remove a host set or hosts from a host set. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Name of the host set to remove. ...
PAGE 238
removeld DESCRIPTION The removeld command removes a specified Logical Disk (LD) from the system service group. SYNTAX removeld [options] {|}... AUTHORITY • Super, Service, Edit • Any role granted the ld_remove right. OPTIONS –pat Specified patterns are treated as glob-style patterns and all LDs matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified.
PAGE 239
• Issuing the removeld command with the –pat option specified returns a request for confirmation to remove LDs, unless the –f option is specified. • Do not issue the removeld command while a movech, movech2spare, movepd2spare, or moverelocpd operation is being executed. Issue the showldch command to view operations currently running on the system. See “showldch” (page 400) for additional information. EXAMPLES The following example removes logical disk nf_vv_1.0.usr.1: cli% removeld -f nf_vv_1.0.usr.
PAGE 240
removercopygroup DESCRIPTION The removercopygroup command removes a Remote Copy volume group or multiple Remote Copy groups that match a given pattern. SYNTAX removercopygroup [options] | ... AUTHORITY • Super, Edit • Any role granted the rcopygroup_remove right. OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 241
EXAMPLES The following example removes Group1 from a Remote Copy system: # removercopygroup Group1 The following example removes Remote Copy groups that start with the name testgroup: # removercopygroup -pat testgroup* The following example removes the Remote Copy group group1 and retains the resync snapshots associated with each volume.
PAGE 242
removercopytarget DESCRIPTION The removercopytarget command removes target designation from a Remote Copy system and removes all links affiliated with that target definition. SYNTAX removercopytarget [options] AUTHORITY • Super, Edit • Any role granted the rcopytarget_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS -cleargroups Remove all groups that have no other targets or dismiss this target from groups with additional targets.
PAGE 243
removesched DESCRIPTION The removesched command removes a scheduled task from the system. SYNTAX removesched [options] AUTHORITY • Super, Service, Edit • Any role granted the sched_remove right. OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all scheduled tasks matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified.
PAGE 244
removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP managers from receiving alerts (traps). WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX removesnmpmgr [option ] AUTHORITY • Super • Any role granted the snmpmgr_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the manager receives traps.
PAGE 245
EXIT STATUS The following codes are returned indicating success or failure: • 0 indicates that the trap manager host was removed and the command was successful. • 1 indicates that the command failed. • 2 indicates that the host is not on the list of registered hosts. NOTES • SNMP managers are registered by issuing the addsnmpmgr command. See “addsnmpmgr” (page 42) for additional information. • Verify the removal of SNMP managers by issuing the showsnmpmgr command.
PAGE 246
removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX removesnmppw [options] AUTHORITY • Super • Any role granted the snmppw_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Removes the read/write (–rw), read-only (–r), or write-only (–w) password.
PAGE 247
removesnmpuser DESCRIPTION The removesnmpuser command allows a user to remove an SNMPv3 user. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX removesnmpuser [options] AUTHORITY • Super, Service, Edit, Browse • Any role granted the snmpuser_remove right. OPTIONS –f Forces the operation so that the command does not require confirmation before proceeding. SPECIFIERS None.
PAGE 248
removespare DESCRIPTION The removespare command removes chunklets from the spare chunklet list. SYNTAX removespare [options] ... AUTHORITY • Super, Service • Any role granted the spare_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. –p Specifies that partial completion of the command is acceptable.
PAGE 249
EXAMPLES The following example removes a spare chunklet from position 3 on physical disk 1: cli% removespare 1:3 NOTES • Verify the removal of spare chunklets by issuing the showspare command. See “showspare” (page 479) for more information. • If a wildcard (a) is used or the -p flag is specified, prints the number of spares removed. Otherwise, if all the explicitly specified spares could not be removed, prints an error message.
PAGE 250
removesshkey DESCRIPTION The removesshkey command removes your Secure Shell (SSH) public key to disable key authentication. SYNTAX removesshkey [... ] AUTHORITY • Super, Service, Edit, Browse • Any role granted the sshkey_remove right. OPTIONS None. SPECIFIERS ... Specifies the name of the user whose SSH key is removed. If not specified, the SSH key for the current user is removed. RESTRICTIONS Only Super level users are allowed to remove other users’ keys. None.
PAGE 251
removetask DESCRIPTION The removetask command removes information about one or more completed tasks and their details. SYNTAX The syntax of the removetask command can be one of the following: • removetask [options ] –a • removetask [options ] –t • removetask [options ] ... AUTHORITY • Super, Edit • Any role granted the task_remove right. OPTIONS –a Removes all tasks including details. –d Remove task details only. –f Specifies that the command is to be forced.
PAGE 252
The following example shows how to remove all tasks, including details. cli% removetask –a Remove all tasks? select q=quit y=yes n=no: y NOTES • See the HP 3PAR StoreServ Storage Concepts Guide and HP 3PAR Command Line Interface Administrator’s Manual for additional information and examples regarding task management and task management commands. • With this command, the specified task ID and any information associated with it are removed from the system.
PAGE 253
removetemplate DESCRIPTION The removetemplate command removes one or more Virtual Volume (VV), Logical Disk (LD), and Common Provisioning Group (CPG) templates. SYNTAX removetemplate [options]{|}... AUTHORITY • Super • Any role granted the template_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 254
removeuser DESCRIPTION The removeuser command removes a user account from the system. SYNTAX removeuser [option] ... AUTHORITY • Super • Any role granted the user_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS ... Specifies a login name using any combination of letters and numbers.
PAGE 255
removeuserconn DESCRIPTION The removeuserconn command removes user connections to the current system. AUTHORITY • Super • Any role granted the userconn_remove right. NOTE: You need access to all domains in order to run this command. SYNTAX removeuserconn [options] OPTIONS –pat Specifies that the , , and specifiers are treated as glob-style (shell-style) patterns and all user connections matching those patterns are removed.
PAGE 256
removevlun DESCRIPTION The removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN) export definition from the system.
PAGE 257
slot Specifies the PCI bus slot in the node where slot is a number from 0 through 5. port Specifies the FCS port number of the card in PCI bus slot using 1 through 4. Specifier requests that exports to the specified host or host set, named using up to 31 characters in length, be removed. The host set name must start with set:. If this specifier is not used, the N:S:P specifier must be used.
PAGE 258
removevv DESCRIPTION The removevv command removes Virtual Volumes (VVs) from the system. SYNTAX The syntax of the removevv command can be as follows: • removevv [options] |... • removevv -expired [options] [VV_name>|...] AUTHORITY • Super, Edit • Any role granted the vv_remove right can remove base volumes. • Any role granted the vvcopy_remove right can remove physical volumes. • Any role granted the sv_remove right can remove virtual copies.
PAGE 259
Specifies the VV name, using up to 31 characters in length. This specifier can be repeated to remove multiple VVs. If this specifier is not used, the pattern specifier must be used. Specifies a glob-style pattern. This specifier can be repeated to remove multiple VVs. If this specifier is not used, the specifier must be used. See “Glob-Style Pattern” (page 12) for more information.
PAGE 260
removevvset DESCRIPTION The removevvset command removes a VV set or removes VVs from an existing set. SYNTAX removevvset [options] [...] AUTHORITY • Super, Edit • Any role granted the vvset_remove right can remove a volume set or volumes from a volume set. OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the VV set to remove. ...
PAGE 261
21 Service Commands servicecage DESCRIPTION The servicecage command is necessary when executing removal and replacement actions for a drive cage FC-AL module. The startfc or unstartfc subcommands are used to initiate service on a cage, and the endfc subcommand is used to indicate that service is completed.
PAGE 262
clearlog • For DC2 and DC4 drive cages, clear the log in the cage. FC-AL specifier is ignored. • For DC3 drive cages, clearlog is not supported. OPTIONS –f Forces the operation. When this option is not used, the command requires confirmation before proceeding. –ovrd Forces the specified physical disk path offline even if it is the last remaining path. SPECIFIERS a|b Specifies the side of the specified DC1 or DC3 drive cage to be serviced.
PAGE 263
servicehost DESCRIPTION The servicehost command executes removal and replacement actions for a host connecting to an HP 3PAR Storage System port. SYNTAX The syntax for the servicehost command can be one of the following: • servicehost list • servicehost remove [-f] [ [...]] • servicehost copy [-f] AUTHORITY • Super, Service • Any role granted the host_service right.
PAGE 264
Specifies a host’s World Wide Name (WWN). This specifier can only be used with the remove and copy subcommands. When used with the remove subcommand, this specifier can be repeated. Specifies that the indicated WWN or iSCSI name is treated as a glob-style pattern. See “Glob-Style Pattern” (page 12) for more information. Specifies the source port when exporting VLUNs. This specifier can only be used with the copy subcommand.
PAGE 265
servicemag DESCRIPTION The servicemag command executes service on a drive magazine or disk. SYNTAX The syntax for the servicemag command can be one of the following: • servicemag start [options] • servicemag start [options] -pdid ... • servicemag resume|unmark [options] • servicemag status [options] [ ] • servicemag clearstatus AUTHORITY • Super, Service • Any role granted the mag_service right.
PAGE 266
Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. –wait Specifies that the servicemag command must be completed before exiting. If not specified, the servicemag command automatically exits before service begins and the remainder of the process proceeds in the background. This option is only valid for the start or resume operations.
PAGE 267
Specifies the drive magazine within the specified drive cage to be serviced based on the side of the drive magazine and drive magazine slot number. • For drive chassis with a single drive cage (type DC2, DC4, and DC3), the valid syntax is (the numeric position of the drive magazine). Position values for DC2 drive cages can be from 0 to 9. Position values for DC3 drive cages can be from 0 to 15. RESTRICTIONS • Access to all domains is required to run this command.
PAGE 268
... marking pd wwn [20000000870042F6] id [22] as usable for ld allocation ... marking pd wwn [2000000087007E6D] id [23] as usable for ld allocation servicemag resume 2 0.0 –– Succeeded NOTES • Issuing the servicemag command results in chunklet relocation that causes a dip in throughput. • When a servicemag command is issued with the –log option, all chunklets on the disks in the drive magazine being serviced are marked as normal,smag. This state indicates an active servicemag operation on the disks.
PAGE 269
servicenode DESCRIPTION The servicenode command informs the system that a certain component is to be replaced, and causes the system to indicate the physical location of that component. SYNTAX servicenode [options] AUTHORITY • Super, Service • Any role granted the node_service right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS start Specifies the start of service on a node. status Displays the state of any active servicenode operations.
PAGE 270
EXAMPLES In the following example, fan 1 on node 3 is put into servicing-mode: cli% servicenode -fan 1 3 NOTES None.
PAGE 271
22 Set Commands setalert DESCRIPTION The setalert command sets the status of system alerts. SYNTAX setalert new|ack|fixed {...|–a} AUTHORITY • Super, Service • Any role granted the alert_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies that the status of all alerts be set to new, acknowledged (ack), or fixed. If not specified, the specifier must be specified on the command line. SPECIFIERS ...
PAGE 272
setaocfg DESCRIPTION The setaocfg command updates an Adaptive Optimization (AO) configuration. AUTHORITY Super, Edit SYNTAX setaocfg [options ] OPTIONS -t0cpg Specifies the Tier 0 CPG for this AO config. -t1cpg Specifies the Tier 1 CPG for this AO config. -t2cpg Specifies the Tier 2 CPG for this AO config.
PAGE 273
EXAMPLES The following example changes the optimization bias (mode) of an AO configuration called aocfg1 to Performance. cli% setaocfg -mode Performance aocfg1 The following example sets the tier1 CPG for AO configuration aocfg2 to R5FCcpg. R5FCcpg must not already be used in an AO configuration, and the tier 1 CPG for aocfg2 must not already be set. cli% setaocfg -t1cpg R5FCcpg aocfg2 The following example swaps a CPG between tiers.
PAGE 274
setauthparam DESCRIPTION The setauthparam command is used to set the authentication and authorization parameters. SYNTAX The syntax of the setauthparam command can be one of the following: setauthparam [-f] setauthparam [-f] ... setauthparam [-f] -clear ... setauthparam [-f] -clearall AUTHORITY • Super • Any role granted the authparam_set right. OPTIONS -f Does not ask for a confirmation before performing the operation.
PAGE 275
Table 3 Values for setauthparam Specifiers (continued) ldap-ssl-cacert Indicates the path name of the file containing the certificate of the Certificate Authority that has issued the LDAP server's certificate, or a “– “ to prompt you to enter the certificate text. ldap-StartTLS Set this parameter to one of the following: • no – to not request the server use StartTLS . Default. • try – to request the server use StartTLS but does not require it to proceed.
PAGE 276
Table 3 Values for setauthparam Specifiers (continued) account-obj The objectClass attribute of an account object. account-name-attr The attribute of an account object that holds the user's username . memberof-attr The attribute that holds the name of a group of which the user is a member. domain-name-attr When set, the mapping of groups to domains is enabled.
PAGE 277
Table 5 Values for Specifiers and (continued) edit-map Same as super-map, but for the Edit level. browse-map Same as super-map, but for the Browse level. create-map Same as super-map, but for the Create level. basic_edit-map Same as super-map, but for the Basic_edit level. 3PAR_AO-map Same as super-map, but for the 3PAR_AO level. 3PAR_RM-map Same as super-map, but for the 3PAR_RM level.
PAGE 278
setbattery DESCRIPTION The setbattery command sets battery information such as the battery’s expiration date, its recharging time, and its serial number. This information gives the system administrator a record or log of the battery age and battery charge status. SYNTAX setbattery [options ] setbattery [options ] AUTHORITY • Super, Service • Any role granted the battery_set right.
PAGE 279
EXAMPLES The following example resets the battery test log and the recharging time for a newly installed battery on node 2, power supply 1, and battery 0, with an expiration date of July 4, 2010: cli% setbattery -x 07/04/2010 2 1 0 NOTES To view battery status information, issue the showbattery command. See “showbattery” (page 354) for information about the showbattery command.
PAGE 280
setcage DESCRIPTION The setcage command enables service personnel to set or modify parameters for a drive cage. SYNTAX setcage [subcommand ]... AUTHORITY • Super, Service • Any role granted the cage_set right. NOTE: You need access to all domains in order to run this command.
PAGE 281
NOTES • The parameters specified by the setcage command appear in the showcage –d output (see “showcage” (page 361)). • The power supply model cannot be modified if the information is automatically retrieved from the system.
PAGE 282
setcim DESCRIPTION The setcim command sets the properties of the CIM server, including options to enable or disable the HTTP and HTTPS ports for the CIM server. The command also provides the ability to configure the port numbers associated with these two protocols. In addition, it allows users to enable or disable the SLP port. SYNTAX setcim [options] AUTHORITY • Super, Service • Any role granted the cim_set right. NOTE: You need access to all domains in order to run this command.
PAGE 283
EXAMPLES To disable the HTTPS ports: cli% setcim -https disable Warning: The CIM server is active and will restart. Are you sure you want to continue (Y/N)? Y To enable the HTTPS port and set the HTTPS port number to 49153: cli% setcim -https enable -httpsport 49153 Warning: The CIM server is active and will restart.
PAGE 284
setclienv DESCRIPTION The setclienv command sets the CLI environment parameters. SYNTAX setclienv AUTHORITY • Super, Service, Edit, Browse • Any role granted the clienv_set right. OPTIONS None. SPECIFIERS The specifiers include the parameters and values to which the parameters should be set.
PAGE 285
EXAMPLES In the following example, the CLI environment is set to display domains information: cli% setclienv listdom 1 NOTES This command is only available when you are using a CLI shell or SSH.
PAGE 286
setcpg DESCRIPTION The setcpg command modifies existing Common Provisioning Groups (CPG). SYNTAX setcpg [options ] AUTHORITY • Super, Edit, Service • Any role granted the cpg_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –sa ... Specifies additional Logical Disks (LDs) that have already been created to be used for snapshot administration space allocation. The argument can be repeated to specify multiple logical disks.
PAGE 287
Table 6 Growth Increment Per Number of Nodes (continued) Number of Nodes Default Minimum 5-6 96 GB 24 GB 7-8 128 GB 32 GB –sdgl [g|G|t|T] Specifies that the auto-grow operation is limited to the specified storage amount. The storage amount can be specified in MB (default) or GB (using g or G) or TB (using t or T). A size of 0 (default) means no limit is enforced. To disable auto-grow, set the limit to 1.
PAGE 288
–nd Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s). –st Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7).
PAGE 289
Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for nearline, or SSD for solid state drive) to be used. Device types can be displayed by issuing the showpd command. If it is not specified, the default device type is FC. -rpm Disks must be of the specified speed. Device speeds are shown in the RPM column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD).
PAGE 290
nearline (NL), or solid state drive (SSD)). This implies that, within a CPG, one can have logical disks of type FC, type NL, and type SSD. However, this is only permitted so that, if a user wants to change the type of a CPG from FC to NL or SSD, they can first change the new logical disk creation characteristics using setcpg and then use region moves to change the device types of existing logical disks. For this same reason, users are permitted to add logical disks of a different device type to a CPG.
PAGE 291
setdate DESCRIPTION The setdate command allows you to set the system time and date on all nodes. SYNTAX The syntax for the setdate command can be one of the following: • setdate [[]][<.ss>] • setdate –tzlist [group] • setdate –tz AUTHORITY • Super, Service • Any role granted the date_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –tzlist [group] Displays a timezone within a group, if a group is specified.
PAGE 292
• MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY.ss EXAMPLES The following example shows the timezone being set: Timezone set successfully. The following example verifies the timezone is set to the required setting: 7 Mon Oct 10 23:14:52 GMT 2005 NOTES • Specifies must be provided in one of the combinations listed as follows when issuing the setdate command: • MMDDhhmm • MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY.
PAGE 293
setdomain DESCRIPTION The setdomain command sets the parameters and modifies the properties of a domain. SYNTAX setdomain [options ] AUTHORITY • Super • Any role granted the domain_set right. NOTE: You need access to all domains in order to run this command. OPTIONS -name Changes the name of the domain. -comment Specifies comments or additional information for the domain. The comment can be up to 511 characters long and must be enclosed in quotation marks.
PAGE 294
NOTES For moving objects into a domain, use the movetodomain command.
PAGE 295
setdomainset DESCRIPTION The setdomainset command sets the parameters and modifies the properties of a domain set. SYNTAX setdomainset [options ] AUTHORITY • Super, Edit • Any role granted the domainset_annotate right can only annotate the comment of a domain set. • Any role granted the domainset_set right can set any domain set property. OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length.
PAGE 296
sethost DESCRIPTION The sethost command sets properties on existing system hosts, including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. The command also provides the ability to configure or remove iSCSI CHAP authentication information and to reset a host, aborting all its pending I/O.
PAGE 297
-ip Specifies the IP address of the host. -os Specifies the operating system running on the host. -model Specifies the model of the host. -contact Specifies the contact information for the host. -comment Specifies any additional information for the host. -name Specifies the new name of the host up to 31 characters in length. -persona Sets the host persona that specifies the personality for all ports which are part of the host set.
PAGE 298
The World Wide Name (WWN) or iSCSI name of the host which should be reset or for which host agent data should be cleared. node — Specifies the node using a number from 0 through 7. slot Specifies the PCI slot in the specified node.
PAGE 299
sethostset DESCRIPTION The sethostset command sets the parameters and modifies the properties of a host set. SYNTAX sethostset [options ] AUTHORITY • Super, Edit • Any role granted the hostset_annotate right can only annotate the comment of a host set. • Any role granted the hostset_set right can set any host set property. OPTIONS -comment Specifies a comment relating to the set. -name Specifies a new name for the host set.
PAGE 300
setlicense DESCRIPTION The setlicense command sets the license key information. SYNTAX setlicense [options ] AUTHORITY • Super, Service • Any role granted the license_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies the file from which the license key is read. –noconfirm Specifies that the system does not prompt for confirmation for the new license key. SPECIFIERS None.
PAGE 301
NOTES • This command prompts for a new license key. To finish entering the license key, press enter on a blank line. • When the license key is being interpreted, all characters other than letters (without case-sensitivity) and numbers are ignored, and the letters are not case-sensitive. • After the new license key has been entered, the changes between the existing license key and the new license key are displayed.
PAGE 302
setnet DESCRIPTION The setnet command sets the administration network interface configuration. AUTHORITY • Service, Super • Any role granted the net_set right. NOTE: You need access to all domains in order to run this command.
PAGE 303
Specifies that the network interface is set to the specified speed and duplex as indicated with the and specifiers. failoverping Specifies that on IP failover, a ping is sent to the specified IP address as indicated with the specifier. ntp none|ntp Specifies the NTP server the system should use to synchronize its clocks. The server must be specified as an IP address. changenode Forces the system to change which node has an active Ethernet interface.
PAGE 304
Specifies the IP address of the new gateway for the system. This specifier can only be used with the startgateway subcommand. auto| Specifies that the speed of the network interface is either auto negotiated (auto), or specified manually using the and specifiers. Specifies the speed of the network interface. Valid values are either 10 or 100. This specifier can only be used with the specifier and with the speed subcommand.
PAGE 305
NOTES • If successful, this command causes any CLI or GUI clients currently connected to lose their connection. • To make it possible to change the network configuration without running the risk of losing contact with the system because of misconfiguration, the setnet command uses a two step process. When a new IP address is specified with the setnetstartaddr command, the system is configured to listen as both the old and new IP addresses.
PAGE 306
setnode DESCRIPTION The setnode command sets the properties of the node components such as the serial number of the power supply. AUTHORITY • Super, Service • Any role granted the node_set right. NOTE: You need access to all domains in order to run this command. SYNTAX setnode ps [options] SUBCOMMAND ps Sets the power supply properties. OPTIONS -s Specifies the serial number up to eight characters in length. SPECIFIERS Specifies the power supply ID.
PAGE 307
cli% cli% setnode ps 0 -s aabbccdd 1 cli% shownode -ps Node PS -Serial- -PSState-- FanState ACState DCState -BatState- ChrgLvl(%) 0 0 -NotPresent ---NotPresent 0 0 1 12345678 OK OK OK OK OK 100 1 0 AABBCCDD OK OK OK OK OK 100 1 1 -NotPresent ---NotPresent 0 cli% cli% setnode ps 0 -s aabbccddee 1 Error: The serial number aabbccddee is too long, should be less than 9 characters. NOTES None.
PAGE 308
setntp DESCRIPTION The setntp command sets the system Network Time Protocol (NTP) server. This command is deprecated and will be removed in a subsequent release. AUTHORITY • Super, Service • Any role granted the ntp_set right. NOTE: You need access to all domains in order to run this command. SYNTAX setntp |none OPTIONS None. SPECIFIERS Specifies the IP address of the NTP server to which the HP 3PAR storage system synchronizes its internal clocks.
PAGE 309
setpassword DESCRIPTION The setpassword command allows a user with Super level role to change the password for any user and create a password file on a client. Edit-, browse-, or service-level users can use the setpassword command to change their own passwords or save their password files on a client. SYNTAX setpassword [options ] AUTHORITY • Super, Edit, Browse, Service • Any role granted the password_setany right can set any user password.
PAGE 310
The following example displays the prompts encountered when changing a user’s (user1) password: cli% setpassword –u user1 password: Old password: NOTES 310 • The format of the entry in the file is . This file may be referenced by the TPDPWFILE environment variable or -pwf command line option for subsequent commands. • The -save or -saveonly option requires the -file option.
PAGE 311
setpd DESCRIPTION The setpd command marks a Physical Disk (PD) as allocatable or non allocatable for Logical Disks (LDs). SYNTAX setpd ldalloc on|off ... AUTHORITY • Super, Service • Any role granted the pd_set right NOTE: You need access to all domains in order to run this command. SUBCOMMANDS ldalloc on|off Specifies that the PD, as indicated with the PD_ID specifier, is either allocatable (on) or nonallocatable for LDs (off). OPTIONS None. SPECIFIERS ...
PAGE 312
setqos DESCRIPTION The setqos command creates and updates QoS rules in a system. SYNTAX The syntax for the setqos command can be one of the following examples: • setqos [options] [{vvset:{|}|sys:all_others}]... AUTHORITY • Super, Edit • Any role granted the qos_set right can set QoS configurations. OPTIONS -io {|none} Set the QoS I/O issue count rate limit to . If "none" is specified, there is no limit on I/O issue count.
PAGE 313
NOTES For all the fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat) When -vv option is present, the setting is only applied to target objects with existing QoS configuration. To limit the new settings to target objects with existing QoS configuration, it is useful to specify -vv * in the command line. QoS rules only manage host I/O. Use of this command to create new QoS rules requires a Quality of Service license.
PAGE 314
setrcopygroup DESCRIPTION The setrcopygroup command performs the following actions: • Sets the policy of the Remote Copy volume group for dealing with I/O failure and error handling. • Switches the direction of transfer between volume groups. • Sets a resynchronization period for volume groups in asynchronous periodic mode. • Sets the group’s mode.
PAGE 315
Specifies the operation of the group(s). Valid operations are: • reverse - Changes the natural and current direction of all specified groups. The operation is mirrored resulting in a direction change on both systems. This option is very flexible depending on the options that are provided. CAUTION: Do NOT use the reverse specifier as part of the disaster recovery process. Misuse of this specifier can result in lost data on the system configured as the primary system under normal operating conditions.
PAGE 316
promoted to the base volume in the case where all volumes of the group were not synced to the same time point. The incorrect use of this option can lead to the primary and secondary volumes not being consistent. –nosnap Specifies that snapshots are not taken of groups that are switched from secondary to primary. Additionally, existing snapshots are deleted if groups are switched from primary to secondary. The use of this option may result in a full synchronization of the secondary volumes.
PAGE 317
Specifies that if the Remote Copy is stopped as a result of the Remote Copy links going down, the group is restarted automatically after the links come back up. If this policy is enabled for a group while the group is stopped after link failures it will only be started when the links come up for the failed target. If the links are already up at the time the policy is set then the group will not be restarted at that time.
PAGE 318
The following example reverses the current direction of secondary group Group1 on System2 (the secondary system) so that I/O might be applied to the group after disaster recovery: # setrcopygroup failover Group1.
PAGE 319
setrcopytarget DESCRIPTION The setrcopytarget command sets the name, policies, or throughput definition for the target’s links.
PAGE 320
and stoprcopygroup) involving the specified target are duplicated (mirror_config) or not duplicated (no_mirror_config). If not specified, all configuration commands are duplicated. NOTE: The no_mirror_config specifier should only be used to allow recovery from an unusual error condition and only used after consulting your HP representative. The new name for the indicated target. This specifier can only be used with the name subcommand.
PAGE 321
NOTES • • • The setrcopytarget command requires the groups associated with it be stopped prior to using the following options: ◦ setrcopytarget name ◦ setrcopytarget tput The setrcopytarget command with the following arguments can be run without bringing down its Remote Copy groups: ◦ setrcopytarget pol ◦ setrcopytarget tunelinks Under normal operating conditions the mirror_config poli
PAGE 322
setsched DESCRIPTION The setsched command allows users to suspend, pause, change the schedule, change the parameters, and change the name of currently scheduled tasks. SYNTAX setsched [options ] setsched [-suspend | -resume] setsched [-suspend_all | -resume_all] AUTHORITY • Super, Service, Edit • Any role granted the sched_setany right can set any user scheduled task properties. • Any role granted the sched_setown right can only set their own scheduled task properties.
PAGE 323
EXAMPLES None. NOTES None.
PAGE 324
setsnmpmgr DESCRIPTION The setsnmpmgr command changes an SNMP manager's properties. SYNTAX The syntax for the setsnmpmgr command can be one of the following examples: • setsnmpmgr [options ] AUTHORITY • Super • Any role granted to the snmpmgr_set right NOTE: You need access to all domains in order to run this command. OPTIONS -p Specifies the port number where the SNMP manager receives traps.
PAGE 325
The following example modifies the user and version properties of the SNMP manager identified by the IPv4 address 123.45.67.89: cli% setsnmpmgr -snmpuser john -version 3 123.45.67.89 NOTES The storage system does not support any form of name resolution. You must specify these IP addresses directly. Issue the addsnmpmgr command to add an SNMP manager. Issue the showsnmpmgr command to display the list of registered SNMP managers. Issue the setsnmppw command to change the SNMP passwords.
PAGE 326
setsnmppw DESCRIPTION The setsnmppw command allows a user to update SNMP access community strings passwords. The SNMP password is required for the system manager to send requests to the SNMP agent. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX setsnmppw [options] AUTHORITY • Super • Any role granted the snmppw_set right. NOTE: You need access to all domains in order to run this command.
PAGE 327
NOTES • The default initial read/write password is public. • If the read-only or write-only passwords do not exist, they are created. • Verify SNMP passwords by issuing the showsnmppw command. See “showsnmppw” (page 474) for more information.
PAGE 328
setsnmpuser DESCRIPTION The setsnmpuser command sets the SNMPv3 user secret key used for generating authentication and privacy keys. The username must correspond to an existing local user. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX setsnmpuser AUTHORITY • Super, Service, Edit, Browse • Any role granted the snmpuser_set right. OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 329
setsshkey DESCRIPTION The setsshkey command sets the SSH public key for a user. The user will be prompted to provide the SSH public key. To finish entering the public key, press enter on a blank line. The key must have been generated using the ssh-keygen utility. The public key is contained in the user-defined file named with .pub extension. The user can open this file with an ASCII editor to copy the key and paste it.
PAGE 330
NOTES • Issuing the setsshkey command results in the system prompting for your SSH public key. Copy and paste the key using the aforementioned ASCII editor on the command line and then press ENTER. • After setting the SSH public key on the system, use the corresponding private key to log on without a password. A single ssh key may be used for multiple hosts with a single use of setsshkey, or different keys may be used for different hosts.
PAGE 331
setstatch DESCRIPTION The setstatch command starts and stops the statistics collection mode for chunklets. SYNTAX setstatch start|stop AUTHORITY • Super, Edit • Any role granted the statch_set right. SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for the specified Logical Disk (LD) and chunklet. OPTIONS None. SPECIFIERS Specifies the name of the LD in which the chunklet to be configured resides.
PAGE 332
setstatpdch DESCRIPTION The setstatpdch command sets the statistics collection mode for all in-use chunklets on a Physical Disk (PD). SYNTAX setstatpdch start|stop AUTHORITY • Super, Edit • Any role granted the statpdch_set right. SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for chunklets on the specified PD used by Logical Disks (LDs). OPTIONS None. SPECIFIERS Specifies the PD ID. RESTRICTIONS None.
PAGE 333
setsys DESCRIPTION The setsys command sets the properties of the system, and includes options to annotate a system with descriptor information such as physical location, owner, contact information, and so on. The command also enables you to set system-wide parameters such as the raw space alert. SYNTAX setsys [options] setsys AUTHORITY • Super, Service • Any role granted the sys_set right. NOTE: You need access to all domains in order to run this command.
PAGE 334
Performs the same function as RawSpaceAlertFC, but should be used for Serial Attached SCSI type drives RemoteSyslog Enables or disables sending events as syslog messages to a remote system. A value of 0 disables the message, and a value of 1 enables the message.
PAGE 335
PortFailoverEnabled Enables or disables the automatic failover of target ports to their designated partner ports. If enabled, automatic failover is triggered when a node goes down. can be 'yes' or 'no'. The default is 'yes'. AutoExportAfterReboot Enables or disables automatically exporting vluns after a reboot. If disabled, vluns and host ports will not become active after a reboot until 'setsysmgr export_vluns' is issued. can be 'yes' or 'no'. The default is 'yes'.
PAGE 336
setsysmgr DESCRIPTION The setsysmgr command sets the system manager startup state. CAUTION: Issuing the setsysmgr command can potentially remove the entire state of the system causing data loss. SYNTAX The syntax of the setsysmgr command can be one of the following: • setsysmgr wipe [-f] [] • setsysmgr tocgen [-f] [ []] • setsysmgr force_iderecovery [-f] • setsysmgr force_idewipe [-f] AUTHORITY • Super • Any role granted the sysmgr_set right.
PAGE 337
Specifies the ID of the system to be started. Specifies the table of contents generation number for the system to start with. Specifies the disk quorum for the system to start with. RESTRICTIONS • Access to all domains is required to run this command. • Use this command only when the system cannot start up normally.
PAGE 338
settask DESCRIPTION The settask command sets the priority on specified task. SYNTAX settask [-f] -pri AUTHORITY • Super, Edit • Any role that is granted the task_set right. OPTIONS -f Forces the command. The command completes the process without prompting for confirmation. -pri Specifies the priority of the task. SPECIFIERS Sets the priority on a task specified by the task ID. The must be an unsigned integer from 1 to 9999.
PAGE 339
settemplate DESCRIPTION The settemplate command modifies the properties of existing templates. SYNTAX settemplate ... [option ] AUTHORITY • Super • Any role granted the template_set right. NOTE: You need access to all domains in order to run this command. OPTIONS -remove
PAGE 340
NOTES • All options available for the createald, createaldvv, createcpg, and createtpvv commands can be used with the settemplate command to modify an existing template. • Options preceded with –remove are removed from an existing template. • When adding options to a template, specify the option flag and its value (if any). • When removing options from a template, specify the option flag only.
PAGE 341
setuser DESCRIPTION The setuser command sets your user properties. SYNTAX setuser [options ] AUTHORITY • Super, Edit, Browse • Any role granted the user_setany right can add, remove, and set default domains for any user. • Any role granted the user_setown right can only set their own default domain. OPTIONS –f Specifies that the command is forced. No confirmation is requested before executing the command. -adddomain :[,:...
PAGE 342
setuseracl DESCRIPTION The setuseracl command sets the Access Control List (ACL). SYNTAX setuseracl [options] []... AUTHORITY • Super, Edit • Any role granted the useracl_set right. OPTIONS -add Adds names or patterns of objects at the end of an existing ACL. -remove Removes names or patterns of objects from an ACL. SPECIFIERS Specifies the name of the user whose ACL is being set.
PAGE 343
The following example shows how to remove vv3 from the ACL for user testuser1: cli% setuseracl -remove testuser1 updatevv vv3 The following example shows how to clear the ACL for user testuser1: cli% setuseracl testuser1 updatevv "" NOTES • The -add and -remove options are mutually exclusive. • If the names or pattern of objects to add already exist, the request is ignored. • If the names or pattern of objects to remove do not exist, the request is also ignored.
PAGE 344
setvv DESCRIPTION The setvv command changes the properties associated with a virtual volume. Use the setvv command to modify volume names, volume policies, allocation warning and limit levels, and the volume’s controlling common provisioning group (CPG). SYNTAX setvv [options ] ... AUTHORITY • Super, Edit • Any role granted the vv_set right can edit the properties of base volumes. • Any role granted the vvcopy_set right can edit the properties of physical copies of volumes.
PAGE 345
Specifies that the volume snapshot space is to be provisioned from the specified CPG. This option moves all the logical disks currently contained in the snapshot space for these volumes into the CPG. This is permitted only when none of the logical disks are shared with other volumes that are not specified in this option. If the specifier is specified as "", the volume snapshot space is longer provisioned from a CPG and the existing snapshot space logical disks are removed from the CPG.
PAGE 346
This option returns a user space allocation warning. It generates a warning alert when the reserved user space of the TPVV exceeds the specified percentage of the virtual volume size. -usr_al This option returns the user space allocation limit. The user space of the TPVV is prevented from growing beyond the indicated percentage of the virtual volume size. After this size is reached, any new writes to the virtual volume will fail.
PAGE 347
NOTES • Use the setvv command to associate a standard virtual volume with a common provisioning group (CPG) for use with Remote Copy. • To view policies assigned to the system's virtual volumes, issue the showvv -pol command. • Changing the CPG for a TPVV is not allowed. • See the HP 3PAR Management Console Help or the HP 3PAR Command Line Interface Administrator’s Manual for instructions on creating CPGs and volumes.
PAGE 348
setvvset DESCRIPTION The setvvset command sets the parameters and modifies the properties of a Virtual Volume (VV) set. SYNTAX setvvset [options ] AUTHORITY • Super, Edit • Any role granted the vvset_annotate right can only annotate the comment of a volume set. • Any role granted the vvset_set right can set any volume set property. OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length.
PAGE 349
setwsapi DESCRIPTION The setwsapi command sets properties of the Web Services API server, including options to enable or disable the HTTP and HTTPS ports. SYNTAX setwsapi [options] AUTHORITY Super, Service Any role granted the wsapi_set right OPTIONS -f Forces the operation of the setwsapi command, bypassing the typical confirmation message. At least one of the following options are required: -http enable|disable Enables or disables the HTTP port. -https enable|disable Enables or disables the HTTPS port.
PAGE 350
23 Show Commands showalert system DESCRIPTION The showalert command displays the status of system alerts. When issued without options, all new customer alerts are displayed. SYNTAX showalert [options] AUTHORITY Any role in the system. OPTIONS The selection of alerts to be displayed is controlled by selecting one of the following options: –n Specifies that only new customer alerts are displayed. –a Specifies that only acknowledged alerts are displayed. –f Specifies that only fixed alerts are displayed.
PAGE 351
EXAMPLES The following example displays new customer alerts on a system: cli% showalert -n Id : State : Message Code: Time : Severity : Type : Message : 1 New 0x2200de 2008-07-17 20:14:29 PDT Degraded Component state change Node 0, Power Supply 1, Battery 0 Degraded (Unknown) Id : State : Message Code: Time : Severity : Type : Message : 2 New 0xe000c 2008-07-17 20:15:31 PDT Informational Cluster shutdown after system recovery completion System recovery completed for node 0 (reason Power Loss) 2 alerts
PAGE 352
showaocfg DESCRIPTION The showaocfg command shows Adaptive Optimization (AO) configurations in the system. SYNTAX showaocfg [options [...|...] AUTHORITY Any role in the system. OPTIONS -domain Shows only AO configurations that are in domains with names matching one or more of the argument. This option does not allow listing objects within a domain of which the user is not a member.
PAGE 353
showauthparam DESCRIPTION The showauthparam command shows authentication parameters. SYNTAX showauthparam AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following is example output from the showauthparam command: cli% showauthparam Param -----------------Value----------------ldap-server xxx.xxx.xx.xx ldap-server-hn domaincontroller.work.com binding sasl sasl-mechanism GSSAPI kerberos-realm NTDOM1.work.
PAGE 354
showbattery DESCRIPTION The showbattery command displays battery status information including serial number, expiration date, battery life, and so on, which could be helpful when determining battery maintenance schedules. SYNTAX showbattery [options] [ ...] showbattery -listcols AUTHORITY Any role in the system. OPTIONS -listcols Lists the columns available to be shown with the -showcols option described below (see clihelp -col showbattery for help on each column). -showcols [,..
PAGE 355
RESTRICTIONS None. EXAMPLES The following example displays battery status information: cli% showbattery Node PS Bat Serial 0 0 0 FFFFFFFF 0 1 0 FFFFFFFF 1 0 0 -1 1 0 -- --State--- ChrgLvl(%) -ExpDate-- Expired OK 100 05/15/2007 No OK 100 05/15/2007 No NotPresent -- -No NotPresent -- -No Testing No No No No The columns in the previous example are identified as follows: • Node. The controller node number. • PS. The power supply number. • Bat. The battery ID. • Serial. The battery serial number.
PAGE 356
The following example displays the inventory information for the battery using the showbattery –i command: cli% showbattery -i Node PS Bat -Manufacturer0 0 0 -0 1 0 -1 0 0 -1 1 0 -- -Model----- -SerialFFFFFFFF FFFFFFFF --- • Node. The controller node number. • PS. The power supply number. • Manufacturer. The manufacturer of the battery. • Model. The battery model. • Serial. Indicates the serial number of the battery.
PAGE 357
The following example displays the detailed status of the battery using the showbattery –s command: cli% showbattery -state Node PS Bat -State- -Detailed_State0 0 0 OK Normal 0 1 0 OK Normal 1 0 0 OK Normal 1 1 0 OK Normal • Node. The controller node number. • PS. The power supply number. • Bat. The battery ID. • State. The current status of the battery and can be one of the following: • ◦ OK. The battery is operating normally. ◦ Failed. The battery is operating abnormally. ◦ Degraded.
PAGE 358
showblock DESCRIPTION The showblock command displays block mapping information for Virtual Volumes (VVs), Logical Disks (LDs), and Physical Disks (PDs). SYNTAX showblock [options ] [] AUTHORITY Any role in the system. OPTIONS –d Specifies that detailed information is displayed for the specified device and block.
PAGE 359
The following example displays detailed block mapping information for block 0 in the user space of VV admin: cli% showblock –d vv admin usr 0 VV/LD Name Block Region VV usr: admin 0x00000000 0x00000000–0x0007FFFF (0–256MB) LD : admin.usr.
PAGE 360
NOTES None.
PAGE 361
showcage DESCRIPTION The showcage command displays information about drive cages. SYNTAX The syntax of the showcage command can be one of the following: • showcage [options] [-d] [...] • showcage [-sfp [-d|-ddm]] [...] • showcage -i [...] • showcage -svc -i [...] AUTHORITY Any role in the system. OPTIONS –d Specifies that more detailed information about the drive cage is displayed.
PAGE 362
EXAMPLES The following examples display information for a single system’s drive cages: cli% showcage Id Name LoopA Pos.A LoopB Pos.B Drives Temp RevA RevB Model Side 0 cage0 0:1:1 0 1:1:1 0 40 24-33 2.05 2.05 DC4 n/a 1 cage1 0:1:2 0 1:1:2 0 24 26-32 2.05 2.05 DC2 0 1 cage1 0:1:3 0 1:1:3 0 16 28-32 2.05 2.05 DC2 1 2 cage2 0:1:4 0 1:1:4 0 16 33-36 DC3 n/a 04 04 The columns in the previous example are identified as follows: • Id. The cage number. • Name. The name of the cage.
PAGE 363
Interface Board Info LoopA LoopB Firmware_status Current Current Product_Rev 03 03 IFC_State OK OK ESH_State OK OK Master_CPU Yes No Loop_Map valid valid Link_Speed 2Gbps 2Gbps Port0_State OK OK Port1_State No_SFP No_SFP Port2_State No_SFP No_SFP Port3_State No_SFP No_SFP Power Supply Info State Fan State AC Model ps0 OK MedSpeed OK -ps1 OK MedSpeed OK --------------Drive Info------------- ----LoopA----- ----LoopB----Drive 0:0 3:0 4:0 7:0 8:0 11:0 12:0 15:0 NodeWWN State Temp(C) ALPA LoopState ALPA LoopSta
PAGE 364
State Normal Op Loop_Split 0 VendorId,ProductId 3PARdata,DC4 Unique_ID 1062010000001C00 Power Supply Info State Fan State AC Model ps0 OK OK OK POI ps1 OK OK OK POI ps2 OK OK OK POI ps3 OK OK OK POI -----Magazine Info----- ---State--Mag SysLED HplLED Disks LoopA LoopB 0 Green Off 4 Ready Ready 1 Green Off 4 Ready Ready 2 Green Off 4 Ready Ready ...
PAGE 365
showcim DESCRIPTION The showcim command displays the CIM server current status, either active or inactive. It also displays the current status of the HTTP and HTTPS ports and their port numbers. In addition, it shows the current status of the SLP port, that is either enabled or disabled. SYNTAX showcim AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 366
• HTTP. Indicates the HTTP port state. ◦ --. Cannot determine the HTTP port state. ◦ Enabled. HTTP port is enabled. ◦ Disabled. HTTP port is disabled. • HTTPPort. HTTP port (1024 - 65635). The default value is 5988. • HTTPS. The HTTPS port state. ◦ --. Cannot determine the HTTPS port state. ◦ Enabled. HTTPS port is enabled. ◦ Disabled. HTTPS port is disabled. • HTTPSPort. The HTTPS port (1024 - 65535). The default value is 5989. • PGVer. The Pegasus version. • CIMVer.
PAGE 367
showclienv DESCRIPTION The showclienv command displays the CLI environment parameters. SYNTAX showclienv AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the currently set CLI environment variables for sample system TestSystem: cli% showclienv Parameter Value csvtable 0 nohdtot 0 hafter -1 listdom 0 editor emacs NOTES See the setclienv command for a complete description of the environment parameters.
PAGE 368
showcpg DESCRIPTION The showcpg command displays Common Provisioning Groups (CPGs) in the system. SYNTAX showcpg [options ] [...|...] AUTHORITY Any role in the system. OPTIONS The following options cannot be used together with other options except -hist and -domain: -d Show the detail information of CPGs. –r Specifies that raw space used by the CPGs is displayed. –alert Indicates whether alerts are posted. –alerttime Show times when alerts were posted (when applicable).
PAGE 369
EXAMPLES The following example displays a system’s CPGs: cli% showcpg ---------------(MB)---------------Volumes- -Usage- --- Usr --- --- Snp --- -- Adm --Id Name Warn% VVs TPVVs Usr Snp Total Used Total Used Total Used 0 cpg1 2 0 2 1 15360 15360 32768 0 8192 0 1 cpg2 2 2 0 2 0 0 32768 1024 8192 256 2 cpg3 1 1 0 1 0 0 32768 512 8192 128 ------------------------------------------------------------------3 total 2 4 15360 15360 98304 1536 24576 384 The columns for the previous example output are identified as
PAGE 370
• Warn%. The CPG’s allocation warning threshold. • Volumes. Virtual Volumes (VVs) and Thinly Provisioned Virtual Volumes (TPVVs). • VVs. The Number of VVs (including TPVVs) using the CPG. • TPVVs. The number of TPVVs using the CPG. • Usage. Virtual Volumes using the CPG. • Usr. The number of VVs whose User Space is using the CPG. • Snp. The number of VVs whose Snapshot Space is using the CPG. • Usr. User space. • Total. The total logical disk space in MBs in the Usr space. • Used.
PAGE 371
1 cpg2 2 cpg3 3 cpg4 - 32768 - 32768 - 32768 - - - - - - - - - - - - 8192 8192 8192 - - The columns in the previous example are identified as follows: • Id. The physical disk ID. • Name. The name of the common provisioning group. • Warn%. The allocation warning percentage (see –aw option of the createcpg or setcpg command). • Total. The total logical disk MB space in a CPG. • Warn. The size in MB of the space at which a warning alert is generated. • Limit.
PAGE 372
• Usr. The number of VVs whose User Space is using the CPG. • Snp. The number of VVs whose Snapshot Space is using the CPG. • Usr. User space. • Total. The total logical disk space in MBs in the Usr space. • RTotal. The total raw MBs of (raw) space in the Usr space. • Used. The total logical disk space in MBs used in Usr space. • RUsed. The total MBs of (raw) space used in the Usr space. • Snp. Snap space. • Total. The total logical disk space in MBs in the Snp space. • RTotal.
PAGE 373
showdate DESCRIPTION The showdate command displays the date and time for each system node. SYNTAX showdate AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the date and time for the system node: cli% Node 0 1 showdate Date Mon Apr 17 17:07:44 PDT 2007 (US/Pacific) Mon Apr 17 17:07:44 PDT 2007 (US/Pacific) NOTES Set date and time information on nodes by issuing the setdate command.
PAGE 374
showdomain DESCRIPTION The showdomain command displays a list of domains in a system. SYNTAX showdomain [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies that detailed information is displayed. –sortcol [,
][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified.
PAGE 375
NOTES If the VVRetentionTimeMax is--, then the minimum volume retention time for the system is used instead. If the VVRetentionTimeMax is 0, then the volume retention time in the domain is disabled.
PAGE 376
showdomainset DESCRIPTION The showdomainset command lists the host sets defined on the HP 3PAR storage system and their members. SYNTAX showdomainset [options] [...] showdomainset -domain [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -domain Show domain sets that contain the supplied domains or patterns SPECIFIERS ... An optional list of or .
PAGE 377
Show domain sets containing domains matching the pattern domainset.*: cli% showdomainset -domain domainset.* Id Name Members 7 domainset domainset.1 domainset.2 NOTES None.
PAGE 378
showeeprom DESCRIPTION The showeeprom command displays node EEPROM log information. SYNTAX showeeprom [options] [...] AUTHORITY Any role in the system. OPTIONS –dead Specifies that an EEPROM log for a node that has not started or successfully joined the cluster be displayed. If this option is used, it must be followed by a list of nodes. SPECIFIERS ... Specifies the node ID for which EEPROM log information is retrieved. Multiple node IDs are separated with a single space (0 1 2).
PAGE 379
Code Code Code Code Code Code 20 25 20 25 20 10 (AP Init Failure) - Subcode 0x0 (0) (PROM Failure) - Subcode 0x1 (0) (AP Init Failure) - Subcode 0x0 (0) (PROM Failure) - Subcode 0x1 (0) (AP Init Failure) - Subcode 0x0 (0) (PCI Failure) - Subcode 0xd (30) Tue Tue Tue Tue Tue Mon Jan Jan Jan Jan Jan Jan 29 29 29 29 29 14 13:30:56 13:17:57 13:17:28 13:14:49 13:04:57 18:17:12 2008 2008 2008 2008 2008 2008 Node: 1 -------Board revision: Assembly: System serial: BIOS version: OS version: Reset reason: Las
PAGE 380
• Last panic displays the last time another node in the cluster requested this node to take a panic. • Error ignore code is for engineering use only. • SMI context is for engineering use only. • Last HBA mode contains PCI Fibre port settings forcing certain ports to start up in initiator mode and certain ports to start up in target mode. • BIOS state is for engineering use only. • TPD state is for engineering use only. NOTES None.
PAGE 381
showeventlog DESCRIPTION The showeventlog command displays the current system event log. SYNTAX showeventlog [options ] AUTHORITY Any role in the system. OPTIONS –min Specifies that only events occurring after the specified number of minutes are shown. The is an integer from 1 through 2147483647. –more Specifies that you can page through several events at a time. –oneline Specifies that each event is formatted on one line. –d Specifies that detailed information is displayed.
PAGE 382
Specified as the month (mm or month_name) and day (dd), where the year (yy) can be optionally specified. Acceptable formats are mm/dd/yy, month_name dd, dd month_name yy, or yy–mm–dd. If the syntax yy–mm–dd is used, the year must be specified. NOTE: The pattern argument in the following options is a regular expression pattern that is used to match against the events each option produces. For each option, the pattern argument can be specified multiple times. For example: showeventlog –type Disk.
PAGE 383
EXAMPLES The following example displays the system events occurred during the last 20 minutes: cli% showeventlog -min 20 Mon Sep 29 09:48:07 2003 PST Node: 0, Seq: 51, Class: Status change, Severity: Informational, Type: Node booted Node 0 has booted Mon Sep 29 09:48:13 2003 PST Node: 1, Seq: 50, Class: Status change, Severity: Informational, Type: Node booted Node 1 has booted Mon Sep 29 09:48:53 2003 PST Node: 0, Seq: 334, Class: Status change, Severity: Informational, Type: Cage loop status Cage 0 is con
PAGE 384
showfirmwaredb DESCRIPTION The showfirmwaredb command displays the current database of firmware levels for possible upgrade. If issued without any options, the firmware for all vendors is displayed. SYNTAX showfirmwaredb [options ] AUTHORITY Any role in the system. OPTIONS –n Specifies that the firmware vendor from the SCSI database file is displayed. –l Reloads the SCSI database file into the system. –all Specifies current and past firmware entries are displayed.
PAGE 385
HITACHI [JLAK] DK..CJ-36FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [JLAK] DK..CJ-72FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-18FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-36FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-72FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [C0C0] DK..EJ-36FC Current /opt/tpd/fw/drive/MEJFC0C0.BIN HITACHI [C0C0] DK..EJ-72FC Current /opt/tpd/fw/drive/MEJFC0C0.BIN HITACHI [C0C0] DK..
PAGE 386
showhost DESCRIPTION The showhost command displays information about defined hosts and host paths in the system. SYNTAX showhost [options ] [...|...|...] AUTHORITY Any role in the system. OPTIONS –d Shows a detailed listing of the host and path information. This option can only be used with -agent and -domain options. -verbose Shows a verbose listing of all host information. -chap Shows the CHAP authentication information. -desc Shows the host descriptor information.
PAGE 387
Shows only hosts that are in domains or domain sets that match one or more of the specifier or set: arguments. The set name must start with set:. This option does not allow listing objects within a domain of which the user is not a member. SPECIFIERS ... Name of the host up to 31 characters in length. This specifier can be repeated to set properties for multiple hosts. ...
PAGE 388
0 queasy10 queasy10 1 foo -- s019 -- The following example displays all host information: cli% showhost –verbose Id Name Persona -----WWN/iSCSI_Name----- Port IP_addr 0 queasy10 Generic 210000E08B027B60 0:0:1 n/a 1 foo Generic myiscsipath.3pardata.com --0.0.0.
PAGE 389
showhostset DESCRIPTION The showhostset command lists the host sets defined on the HP 3PAR storage system and their members. SYNTAX showhostset [options] [...] showhostset -host [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -host Show host sets that contain the supplied hostnames or patterns. SPECIFIERS ... An optional list of setnames or patterns.
PAGE 390
Show the host sets containing host sun40z-09-0: cli% showhostset -host sun40z-09-0 Id Name Members 3 sunv40z-09 sunv40z-09-0 sunv40z-09-1 sunv40z-09-2 sunv40z-09-3 NOTES A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set. Run cli -h and setclienv -h for details of the environment variables.
PAGE 391
showinventory DESCRIPTION Shows information about all the hardware components in the system. SYNTAX showinventory [options] AUTHORITY Any role in the system. OPTIONS -svc Displays inventory information with HP serial number, spare part number, and so on. This option must be used with the -i option and it is supported only on HP 3PAR StoreServ 7000 Storage systems. SPECIFIERS None. RESTRICTIONS None. EXAMPLES None.
PAGE 392
showiscsisession DESCRIPTION The showiscsisession command shows the iSCSI sessions. SYNTAX showiscsisession [option ] AUTHORITY Any role in the system. OPTIONS –sortcol [,
][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order.
PAGE 393
• iSCSI_Name. The iSCSI name of the host. • StartTime. The time the session was started. NOTES None.
PAGE 394
showld DESCRIPTION The showld command displays configuration information about the system’s Logical Disks (LDs). SYNTAX showld [options ] [|...] AUTHORITY Any role in the system. OPTIONS –cpg ... Requests that only logical disks in Common Provisioning Groups (CPGs) that match the specified CPG names or patterns be displayed. Multiple CPG names or patterns can be repeated using a comma-separated list (for example -cpg ,...).
PAGE 395
SPECIFIERS ... Requests that information for a specified logical disk is displayed. This specifier can be repeated to display configuration information about multiple logical disks. If not specified, configuration information for all logical disks in the system is displayed. ... Specifies that the logical disk matching the specified glob-style pattern is displayed. This specifier can be repeated to display configuration information about multiple logical disks.
PAGE 396
• RAID. The RAID type (0 is for RAID-0, 1 is for RAID-1, 5 is for RAID-5, and 6 is for RAID-6). • State. The current status of the logical disk. ◦ normal. The logical disk has started and is available for use. ◦ orphan. Both the primary owner and backup owner nodes are down, and the logical disk’s data is not available. ◦ preserved. Some disks used by the logical disk are missing. Data belonging to the logical disk is saved on the preserved logical disk. ◦ stopped.
PAGE 397
0 log0.0 --1 0/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 1 log1.0 --1 1/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 2 pdsld0.0 --1 0/1 4096 8192 2 256 2 0 mag mag 2007-11-29 18:44:03 PST -p -devtype FC 3 admin.usr.0 --1 0/1 5120 10240 2 256 2 0 mag mag 2007-11-29 18:44:12 PST -p -devtype FC 4 admin.usr.1 --1 1/0 5120 10240 2 256 2 0 mag mag 2007-11-29 18:44:12 PST -p -devtype FC 5 Collie.usr.
PAGE 398
The following example displays policy information about all system LDs: cli% showld -p Id Name Keep_Preserved Growth_Blocked Dev_Type RPM 0 log0.0 0 0 FC 10 1 log1.0 0 0 FC 10 2 pdsld0.0 0 0 FC 10 3 pdsld0.1 0 0 FC 10 4 pdsld0.2 0 0 FC 10 5 admin.usr.0 1 0 FC 10 6 admin.usr.1 1 0 FC 10 7 admin.usr.2 1 0 FC 10 8 admin.usr.3 1 0 FC 10 9 tp-0-sa-0.0 1 0 FC 10 10 tp-0-sa-0.1 1 0 FC 10 11 tp-0-sa-0.2 1 0 FC 10 14 tp-0-sa-0.4 1 0 FC 10 15 v1.0.usr.0 1 0 FC 10 16 v1.1.usr.0 1 0 FC 10 17 tp-0-sd-0.
PAGE 399
The columns in the previous example are identified as follows: • Id. The logical disk ID. • Name. The logical disk name. • State. The current state of the LD that is one of the following: • ◦ normal. The LD is operating normally. ◦ failed. The LD is operating abnormally. ◦ degraded. The LD is in degraded state. Detailed_State. The detailed state of the LD that is one of the following: ◦ nodes_unavail. The nodes are down. ◦ not_stated.
PAGE 400
showldch DESCRIPTION The showldch command displays configuration information about the chunklet mapping for one Logical Disk (LD). SYNTAX showldch [options ] AUTHORITY Any role in the system. OPTIONS -degraded Show only the chunklets in sets that cause the LD availability to be degraded. For example, if the LD normally has cage level availability, but one set has two chunklets in the same cage, then the chunklets in that set are shown.
PAGE 401
3 4 5 6 7 8 9 10 11 12 13 14 15 0 0 0 0 0 0 0 0 0 0 0 0 0 1 2 2 3 3 4 4 5 5 6 6 7 7 1:3:0 0:1:2 2:1:3 0:2:0 1:2:2 2:3:3 1:1:2 2:2:3 0:3:0 0:0:0 1:0:2 2:0:1 2:0:2 28 6 39 8 26 47 22 43 12 0 18 33 34 0 0 0 0 0 0 0 0 0 0 0 0 5 normal normal normal normal normal normal normal normal normal normal normal normal normal ld ld ld ld ld ld ld ld ld ld ld ld ld valid valid valid valid valid valid valid valid valid valid valid valid valid N N N N N N N N N N N N N ------------------------16:1 --------------
PAGE 402
• Media. The current status of the physical disk medium for the chunklet. ◦ valid. The chunklet is available for use. ◦ failed. The medium has encountered errors and is not available for use. • Sp. The spare status of the chunklet; Y indicates the chunklet is used for spare, N indicates the chunklet is not used as spare. • From. The initial location of the chunklet before relocation. • To.
PAGE 403
4 4 0 47-2:3:3 18-1:0:2 14-0:3:2 33-2:0:1 1 2-0:0:2 28-1:3:0 37-2:1:1 22-1:1:2 NOTES None.
PAGE 404
showldmap DESCRIPTION The showldmap command displays the mapping from a Logical Disk (LD) to Virtual Volumes (VVs). SYNTAX showldmap AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS Specifies the LD name. RESTRICTIONS None. EXAMPLES The following example displays the region of LD v0.usr.0 that is used for a VV: cli% showldmap v0.usr.
PAGE 405
showlicense DESCRIPTION The showlicense command displays the currently installed license key and current license information. SYNTAX showlicense AUTHORITY Any role in the system. OPTIONS –raw Specifies that the license key originally entered (the raw license) be displayed. The license key is displayed in a manner that is acceptable input for the setlicense command. SPECIFIERS None. RESTRICTIONS None.
PAGE 406
SV47–NH2R–BL1L–TJKR–31F2–V9QX–0WM0–AWTH LRB7–8XQD–BLHD–LF68–A4BW–K4QG–ZS7B–Q41X 35Y1–6CZC–KBJ5–6VQE–EC2G–Q6EG–SJV0–KMHC SAWG–YJ4V–WRE5–3GZA–DGW0–ZYVE–5SVT–8TJX QR9W–R92D–SSTY–RVWY–1Y2B–YH8D–KRN5–ZZ7Y... NOTES Without options, a description of which features are enabled is displayed. When the license was generated and any expiration dates are also shown. If the -raw option is specified, the license key prints in a manner that is acceptable input for the setlicense command.
PAGE 407
shownet DESCRIPTION The shownet command displays the configuration and status of the administration network interfaces, including the configured gateway and Network Time Protocol (NTP) server. SYNTAX shownet [option] AUTHORITY Any role in the system. OPTION –d Displays detailed information. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the status of the system administration network interfaces: cli% shownet -d IP Address: 192.168.5.
PAGE 408
RX RX RX RX RX RX RX Bytes: Errors: Dropped: FIFO Errors: Frame Errors: Multicast: Compressed: 0 0 0 0 0 0 0 Admin interface on node 1 MAC Address: 00:02:AC:43:00:33 RX Packets: 477147 RX Bytes: 59353196 RX Errors: 0 RX Dropped: 0 RX FIFO Errors: 0 RX Frame Errors: 0 RX Multicast: 0 RX Compressed: 0 ...
PAGE 409
shownode DESCRIPTION The shownode command displays an overview of the node-specific properties and its component information. Various command options can be used to display the properties of PCI cards, CPUs, physical memory, disk drives, and power supplies. SYNTAX shownode [option] [...] AUTHORITY Any role in the system.
PAGE 410
Specifies detailed information in verbose format. It can be used with any of the following component options: -fan Displays the node fan information. –pci Displays PCI card information. –cpu Displays CPU information. –mem Displays physical memory information. -drive Displays the disk drive information. –ps Displays power supply information. -mcu Displays MicroController Unit information. -state Displays the detailed state information for the node or power supply (proceed with the -ps option).
PAGE 411
In the example above: • Node. The node ID. • Name. The node name. • State. The state of the node. Values are as follows: ◦ --. Cannot determine the overall node state. ◦ OK. The node and its components are operating normally. ◦ Degraded. For T-Series and S-Series nodes, the node is degraded due to a missing, failed, or degraded power supply. For E-series nodes, the node is degraded to due a missing or degraded fan. ◦ Failed.
PAGE 412
1 4-slot 2048 1 4-slot 2048 1 J0900 DIMM1.0 Data DDR_SDRAM Micron Technology E010DF97 CL2.0/2.5 2 J1300 DIMM2.0 Data DDR_SDRAM Micron Technology E010DF96 CL2.0/2.5 ----------------------------Internal Drives---------------------------Node Drive -Manufacturer- ---Model--- -Serial- -Firmware- Size(MB) Type 0 0 Seagate ST9100821AS 5NJ09DF3 3.AAB 95396 SATA 1 0 Seagate ST9100821AS 5NJ08NA4 3.AAB 95396 SATA These columns and values are described in detail in the following examples.
PAGE 413
0 1 0 Seagate 0 Seagate ST9100821AS 5NJ09DF3 3.AAB ST9100821AS 5NJ08NA4 3.AAB 95396 SATA 95396 SATA In the example above: • Node. The node ID. • Drive. The disk drive ID. • Manufacturer. The manufacturer of the disk drive. • Model. The model number of the disk drive. • Serial. The serial number of the disk drive. • Firmware. The firmware version on the disk drive. • Size. The drive size in MB. • Type. The type of disk drive.
PAGE 414
• CPUSpeed. The speed of the CPU in MHz. • BusSpeed. The bus speed of the CPU in MHz. cli% shownode -ps -------------------------Power Supplies-------------------------Node PS -PSState-- FanState ACState DCState -BatState- ChrgLvl(%) 0 0 NotPresent ---NotPresent 0 0 1 OK OK OK OK OK 100 1 0 OK OK OK OK OK 100 1 1 NotPresent ---NotPresent 0 In the example above: • Node. The node ID. • PS. The power supply ID. • PSState. The power supply state. Values are as follows: • • • • 414 ◦ --.
PAGE 415
• ◦ NotPresent. The battery is missing. ◦ MaxLifeLow. The maximum battery life is low. ChrgLvl. The battery charge level in percentage. The following example displays the detailed state of the nodes: cli% shownode -state Node 0 1 2 3 -StateOK OK OK OK -Detailed_StateOK OK OK OK In the example above: • Node. The node ID. • State. The state of the node. Values are as follows: • ◦ OK. The node and its components are operating normally. ◦ Degraded.
PAGE 416
The following example displays the detailed state of the power supplies: cli% shownode -ps Node PS -State- -Detailed_State0 0 OK OK 1 1 OK OK 2 2 OK OK 3 3 OK OK In the example above: • Node. The node ID. • PS. The power supply ID. • State. The power supply state. Values are as follows: • ◦ OK. The power supply is operating normally. ◦ Failed. The power supply is operating abnormally. ◦ NotPresent. The power supply is missing. ◦ Degraded. The fan failure or battery state is not OK.
PAGE 417
shownodeenv DESCRIPTION The shownodeenv command displays the node operating environment status, including voltages and temperatures. SYNTAX shownodeenv [options ...] AUTHORITY Any role in the system. OPTIONS –n ... Specifies the ID of the node whose environment status is displayed. Multiple node IDs can be specified as a series of integers separated by a space (1 2 3). If no option is used, then the environment status of all nodes is displayed. SPECIFIERS None. Restrictions None.
PAGE 418
LM87 Ext CPU0 CPU1 CPU0 VRM CPU1 VRM CPU DIMM0 CPU DIMM1 Temp: Temp: Temp: Temp: Temp: Temp: Temp: 20 C 24 C 25 C n/a n/a 37 C 38 C -10 C 0 C 0 C n/a n/a 0 C 0 C 65 C 85 C 85 C n/a n/a 105 C 105 C Within Within Within Within Within Within Within Measurement Reading Lo Limit Hi Limit Status Node 1 --------... NOTES None.
PAGE 419
showpatch description The showpatch command displays patches applied to a system. SYNTAX showpatch [option ] AUTHORITY Any role in the system. OPTIONS –hist Specifies the history of all patches and updates applied to the system. –d Specifies the details on a specified patch ID. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The showpatch command is specific to each individual patch and typically displays these fields: • Patch ID. Specifies the patch ID. • Release Version.
PAGE 420
showpd DESCRIPTION The showpd command displays configuration information about a system’s Physical Disks (PDs). SYNTAX showpd [options] [...] showpd -listcols AUTHORITY Any role in the system. OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showpd for help on each column). The [options] are generally of two kinds: those that select the type of information that is displayed, and those that filter the list of PDs that are displayed.
PAGE 421
The following columns are shown: Id, CagePos, Type, State, Detailed_State. -s Show detailed information regarding the state of each PD. This option is deprecated and will be removed in a future release. -path Shows current and saved path information for disks. The following columns are shown: ID, CagePos, Type, State, Path_A0, Path_A1, Path_B0, Path_B1, Order. Path_A1 and Path_B1 are only shown for systems with drive chassis that are connected to four nodes.
PAGE 422
Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–3). The primary path of the disks must be on the specified port(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3). A range of drive cages is separated with a hyphen (0–3).
PAGE 423
performance benchmark that takes into account in I/O per second, bandwidth and the access time. Disks that satisfy all of the specified characteristics are used. For example -p -fc_gt 60 -fc_lt 230 -nd 2 specifies all the disks that have greater than 60 and less than 230 free chunklets and that are connected to node 2 through their primary path. –nodes Specifies that the display is limited to specified nodes and physical disks connected to those nodes.
PAGE 424
• FC – Fibre Channel • NL – Nearline • SSD – Solid State Drive • RPM – The maximum RPM speed of the physical disk. • State – State of the PD can be one of the following: ◦ normal – PD is normal ◦ degraded – The PD is not operating normally. Use showpd -s to find out the detail information. ◦ new – The PD is new, needs to be admitted before it can be used (see help admitpd) ◦ failed – The PD has failed. • Total. Total size of the disk in MB (1024^2 bytes). • Free.
PAGE 425
• NL – Nearline • SSD – Solid State Drive • State. State of the PD can be one of the following: ◦ normal – PD is normal. ◦ degraded – The PD is not operating normally. Use showpd -s to find out the detail information. ◦ new – The PD is new, needs to be admitted before it can be used (see help admitpd). ◦ failed – The PD has failed. • Total. Total size of the disk in MB (1024^2 bytes). • Normal Chunklets. This area provides information about chunklets that are not reserved for use as spares.
PAGE 426
• Node_WWN. Node World Wide Name of the disk. • MFR. Physical disk manufacturer. • Model. Physical disk manufacturer’s device ID. • Serial. Physical disk manufacturer’s serial number. • FW_Rev. Physical disk manufacturer’s firmware revision tracking string.
PAGE 427
• Spare Chunklets. This area provides information about chunklets that are reserved for use as spares. • OK. Number of chunklets with data that is accessible to the system. • Fail. Number of failed chunklets. • Free. Number of initialized but currently unused chunklets available for use by logical disks. • Uninit. Number of chunklets being cleaned. • Unavail. Number of chunklets that are unavailable for use.
PAGE 428
The following example displays the states of each physical disk: cli% showpd ID CagePos 0 0:0:0 1 0:0:1 2 0:0:2 3 0:0:3 4 0:1:0 5 0:1:1 6 0:1:2 7 0:1:3 8 1:2:0 9 1:2:1 10 1:2:2 11 1:2:3 12 1:3:0 13 1:3:1 14 1:3:2 15 1:3:3 -state Type -State- -Detailed_StateFC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal
PAGE 429
The columns in the previous example are identified as follows: • ID. Physical disk ID, as assigned by the system. For unadmitted disk the ID appears as dashes (––). • CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine.
PAGE 430
The following example displays all disk in magazine 0 of cage 0 and 1: cli% showpd -p -mg 0 -cg 0,1 --Size(MB)--- ----Ports---ID CagePos Type RPM State Total Free A B 0 0:0:0 NL 7 degraded 715008 684288 0:0:1* 1:0:1 8 1:0:0 FC 10 normal 69632 2560 0:0:2* 1:0:2 ------------------------------------------------------------2 total 784640 686848 NOTES • In the showpd output, when the position of the disk is not valid (for example, in the case of a missing disk), the most recent position might be displayed, fol
PAGE 431
showpdata DESCRIPTION The showpdata command displays information about the preserved data in the system. SYNTAX showpdata [] AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS [] Requests that preserved data for a specific Logical Disk (LD) is displayed. This specifier is not required on the command line. If not specified, then the amount of preserved data by LD is displayed. RESTRICTIONS Access to all domains is required to run this command if no LD name is specified.
PAGE 432
showpdch DESCRIPTION The showpdch command displays the status of selected Physical Disk (PD) chunklets. SYNTAX showpdch [options] showpdch [options] |... (deprecated usage) AUTHORITY Any role in the system. OPTIONS The following filtering options specify conditions that a chunklet should meet in order for the chunklet to be displayed. Multiple conditions can be specified and a chunklet will be displayed if any of the specified conditions are met.
PAGE 433
inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows with the same information in them as earlier columns will be sorted by values in later columns. –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating LDs. If no pattern is specified, the option defaults to all Fibre Channel (FC) disks.
PAGE 434
–tc_gt Specifies that PDs with total chunklets greater than the number specified are selected. –tc_lt Specifies that PDs with total chunklets less than the number specified are selected. –fc_gt Specifies that PDs with free chunklets greater than the number specified are selected. –fc_lt Specifies that PDs with free chunklets less than the number specified are selected. –devid Specifies that PDs identified by their models are selected.
PAGE 435
The columns in the previous example are identified as follows: • Pdid. The physical disk on which the chunklets reside. • Chnk. The chunklet number. • LdName. The name of the logical disk that is using the spare chunklet. • LdCh. The position of the chunklet on the logical disk. • State. The state of the chunklet as identified by the kernel. • • ◦ logging. I/O to the chunklet is written to the logging logical disk. ◦ playback. Data is played back from the logging logical disks. ◦ passthru.
PAGE 436
NOTES None.
PAGE 437
showpdvv DESCRIPTION The showpdvv command displays the virtual volumes hat are mapped to a particular physical disk. SYNTAX showpdvv [options] [ [:]...] AUTHORITY Any role in the system. OPTIONS -sum Shows number of chunklets used by virtual volumes for different space types for each physical disk. –p PDs matching the specified pattern are displayed.
PAGE 438
–dk Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments, –tc_gt , –tc_lt , –fc_gt , –fc_lt , –devid , and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive.
PAGE 439
Specifies the physical disk ID using an integer. This specifier is not required if -p option is used, otherwise it must be used at least once on the command line. [:] Specifies the chunklet number in a physical disk to which virtual volumes are mapped. This specifier is not required. This specifier is not required. This specifier cannot be used along with -p option. RESTRICTIONS None.
PAGE 440
showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX The syntax of the showport command can be one of the following: • showport [options] [-failed] [-sortcol [,
]][ |...] AUTHORITY Any role in the system. OPTIONS -i Show hardware and inventory formation. -c Displays all devices connected to the port.
PAGE 441
-failed Displays only failed ports. -state Displays the detailed state information. -s Displays the detailed state information. This option has been deprecated and will be removed in a future release. -ids Displays the identities hosted by each physical port. –sortcol [,
][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified.
PAGE 442
0:0:1 target 1:0:1 0:0:2 initiator 0:0:3 target 1:0:3 0:0:4 target 0:3:1 target 1:3:1 0:3:2 initiator 0:4:1 target 1:4:1 0:4:2 target 1:4:2 0:5:1 initiator 0:5:2 target 1:5:2 0:6:1 peer 1:0:1 target 0:0:1 1:0:2 initiator 1:0:3 target 0:0:3 1:0:4 initiator 1:3:1 target 0:3:1 1:3:2 initiator 1:4:1 target 0:4:1 1:4:2 target 0:4:2 1:5:1 initiator 1:5:2 target 0:5:2 1:6:1 peer - ready 2FF70002AC0000AA 20010002AC0000AA host FC - 2FF70002AC0000AA 20020002AC0000AA disk FC - 2FF70002AC0000AA 20030002AC00
PAGE 443
◦ loss_sync. Link loss sync. ◦ error. Currently in an error state. ◦ non_participate. Link not participating. ◦ taking_coredump.Coredump in progress. ◦ offline. Link is offline. ◦ fw_dead. Firmware dead. ◦ link_idle_for_reset. Link is idle for reset. ◦ dhcp_in_progress. DHCP is in progress. ◦ pending_reset. Link reset is pending. ◦ unknown. Link state is unknown. • Node_WWN. The WWN that belongs to the controller node identified in the N:S:P column. • Port_WWN/HW_Addr.
PAGE 444
• Partner Location of failover partner port in :: format • FailoverState The failover state of the two ports indicated in the N:S:P and Partner columns. The value can be one of the following: ◦ none No failover in operation ◦ failover_pending In the process of failing over to partner.
PAGE 445
• ConnType. Indicates the type of connection configured for the port; loop for loop, point for point-to-point, or lp for loop or point-to-point. • CfgRate. The configurable bit rate of data transfer between the port and a host or a disk; either auto, 1Gbps, 2Gbps, or 4Gbps. • MaxRate. Indicates the maximum bit rate of transfer between the HBA and the host or disk. • Class2. Identifies whether class 2 is enabled (ack0 or ack1) or disabled. • VCN. VLUN State Change Notification support setting.
PAGE 446
• Type. Indicates the port connection type. • rcip. Port is used for Remote Copy over IP (RCIP). The following example displays the detailed state of the port: cli% showport –state N:S:P --State-- -Detailed_State0:0:1 ready loss_sync 0:0:2 ready loss_sync 0:3:1 ready offline 0:3:1 ready offline 0:5:1 ready loss_sync -------------------------------10 The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the syntax node:slot:port. • State.
PAGE 447
The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the syntax node:slot:port. • State. State of the port. ◦ ready. The port is online and ready for use. ◦ loss_sync.The port is not physically connected to anything. ◦ config_wait. Firmware has yet to be initialized. ◦ login_wait. Fibre Channel adapter is attempting port and process logins with all loop ports. ◦ error. Fibre Channel adapter has experienced an unrecoverable error.
PAGE 448
The following examples display both standard and detailed information about SFPs attached to ports: cli% showport N:S:P -State0:0:1 OK 0:0:2 OK 0:3:2 OK 1:0:1 OK 1:0:2 OK cli% -sfp -Manufacturer- MaxSpeed(Gbps) TXDisable TXFault RXLoss DDM FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2.10 No No Yes Yes SIGMA-LINKS 2.10 No No Yes Yes FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2.
PAGE 449
showportarp DESCRIPTION The showportarp command shows the ARP table for iSCSI ports in the system. SYNTAX showportarp [::
~~] AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS [::~~
] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot.
~~PAGE 450~~
showportdev DESCRIPTION The showportdev command displays detailed information about devices on a specified port. SYNTAX showportdev loop|all|ns|sas|fcswitch|fcfabric showportdev sas [options] AUTHORITY Any role in the system. SUBCOMMANDS loop Specifies that information is returned for arbitrated loop devices that are attached to the specified port. This subcommand is only for use with Fibre Channel arbitrated loop ports.
~~PAGE 451~~
Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot. RESTRICTIONS The loop subcommand is functional only in a private loop topology.
~~PAGE 452~~
~~NOTES The loop subcommand is functional only in a private loop topology.~~
~~PAGE 453~~
~~showportisns DESCRIPTION The showportisns command shows iSNS host information for iSCSI ports in the system. SYNTAX showportisns [::~~
] AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS [] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the iSCSI port number of the PCI card in the specified PCI bus slot.
~~PAGE 454~~
showportlesb DESCRIPTION The showportlesb command displays Fibre Channel Link Error Status Block (LESB) counters (the number of errors accumulated for Fibre Channel devices). The LESB is composed of six counters that can measure Fibre Channel signal integrity or status.
~~PAGE 455~~
• dd monthname [yy], where dd is the day and yy is the year (optional). • yy–mm–dd, where yy is the year, mm is the month, and dd is the day. –endt Specifies that samples taken of LESB counters cease after the indicated time (). Time can be specified in hours or as a specific date. When specifying in hours, the following formats can be used: • hh[:mm[:ss]], where hh is the hour, mm is the minute (optional), and ss is the second (optional).
~~PAGE 456~~
pd4 0x76 pd3 0x79 pd2 0x80 pd1 0x81 pd0 0x88 Port <0:0:1> 1 1 1 1 1 4 4 4 4 4 0 0 0 0 0 0 0 0 0 0 334 401 344 270 401 0 0 0 0 0 Loop <0:0:1> Time since last save: 0:00:28 ID ALPA LinkFail LossSync LossSig PrimSeq InvWord InvCRC <0:0:1> 0xef 1 19 19 0 0 0 pd7 0x6d 1 5 0 0 465 0 pd6 0x72 1 5 0 0 890 0 pd5 0x73 1 4 0 0 969 0 pd4 0x76 1 5 0 0 761 0 pd3 0x79 1 4 0 0 815 0 pd2 0x80 1 4 0 0 925 0 pd1 0x81 1 7 0 0 3283 0 pd0 0x88 1 258 0 0 269 0 LESB compare completed The following example displays the coun
~~PAGE 457~~
• LossSig. Loss of signal (electrical or optical) to the receiver port of a Fibre Channel node. • PrimSeq. Primitive Sequence Protocol Error. There were errors during the transmission of a Fibre Channel primitive sequence. This might indicate an error during the loop recovery or initialization. • InvWord. Invalid Transmission Word. Illegal Fibre Channel transmission word received. • InvCRC. Invalid Cyclical Redundancy Check. Data corruption in the Fibre Channel frame.
~~PAGE 458~~
showqos DESCRIPTION The showqos command lists the QoS rules configured in a system. SYNTAX The syntax for the showqos command can be one of the following examples: • showqos [options][{vvset:{|}|sys:all_others}]... AUTHORITY • Any role in the system OPTIONS -{on|off} List enabled or disabled QoS rules only. -domain {}... Shows rules with target objects in domains with names that match one or more of the specified domains or patterns.
~~PAGE 459~~
1 vvset vsb on 4000 204800 4 vvset vsc on 102400 3 vvset vsd on 5000 102400 ----------------------------------------------4 total Show active QoS rules only: cli% showqos -on I/O per second KBytes per sec Id Type Name QoS Limit Limit 1 vvset vsb on 4000 204800 4 vvset vsc on 102400 3 vvset vsd on 5000 102400 ----------------------------------------------3 total Show QoS rules containing VV vv1: cli% showqos -vv vv1 I/O per second KBytes per sec Id Type Name QoS Limit Limit 1 vvset vsb on 4000 204800 3 vvs
~~PAGE 460~~
showrcopy DESCRIPTION The showrcopy command displays details of the Remote Copy configuration. The showrcopy command also displays the group’s domain names if the global -listdom option is used or if the TPDLISTDOM environment variable is set. SYNTAX The syntax for the showrcopy command can be one of the following: • showrcopy [options ] [links] • showrcopy [options ] [groups []] • showrcopy [options ] [targets [ ...
~~PAGE 461~~
Link Information Target System2 System2 receive receive Node 0 1 0 1 Address 10.100.33.11 10.101.33.11 10.100.33.11 10.101.33.11 Status Options Up Up Up Up Group Information Name Target Status sync_group_1 System2 Started LocalVV ID RemoteVV localvv.0 391 remotevv.0 localvv.1 392 remotevv.1 Role Mode Options Primary Sync ID SyncStatus LastSyncTime 351 Syncing (25%) Thu Dec 14 17:37:40 PST 2006 352 Syncing (40%) Thu Dec 14 17:37:40 PST 2006 Name Target Status Role Mode Options sync_group_2.
~~PAGE 462~~
Group Information Name Target Status bart bf_mirror Started PDT 2006 , Period 30m LocalVV ID RemoteVV bart-tp-ws 9 bart-ws Role Primary Mode Options Periodic Last-Sync Tue Jul 18 14:12:59 ID SyncStatus 3924 Synced LastSyncTime Tue Jul 18 14:13:09 PDT 2006 Name Target Status Role Mode Options lisa bf_mirror Started Primary Periodic Last-Sync Tue Jul 18 14:09:44 PDT 2006 , Period 30m, over_per_alert LocalVV ID RemoteVV ID SyncStatus LastSyncTime lisa-ws 2 lisa-ws 3922 Synced Tue Jul 18 14:10:32 PDT 2006
~~PAGE 463~~
NOTES • If the showrcopy command is used with no specifiers, all configuration information is displayed. • The showrcopy command also displays the group’s domain names if the global -listdom option is used or if the TPDLISTDOM environment variable is set. • If showrcopy link|group|target is used without specifying a name, information for all links, groups, or targets is displayed.
~~PAGE 464~~
showrctransport DESCRIPTION The showrctransport command shows status and information about end-to-end transport for Remote Copy in the system. SYNTAX showcrtransport [options] AUTHORITY Any role in the system. OPTIONS –rcip Show information about Ethernet end-to-end transport. –rcfc Show information about Fibre Channel end-to-end-transport. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 465~~
• ◦ ready. Configuration is completed on this port and the peer port; transport is ready for use. ◦ missing. A configured transport was disconnected. Type. Indicates the port connection type. ◦ rcip. Port is used for Remote Copy over IP (RCIP). ◦ rcfc. Port is used for Remote Copy over FC (RCFC).
~~PAGE 466~~
The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the format node:slot:port. • Remote_Node_WWN. World Wide name of the node to which the port indicated in the N:S:P column connects. • Remote_Port_WWN. World Wide name of the target port to which the port indicated in the N:S:P column connects. • State. Indicates whether the end-to-end transport is ready to be used for Remote Copy. Can be one of the following: ◦ new.
~~PAGE 467~~
showrole DESCRIPTION The showrole command displays information about rights assigned to roles in the system. Without any argument, showrole displays the roles currently defined. SYNTAX showrole [] showrole -listrights AUTHORITY Any role in the system. OPTIONS -listrights Lists the rights available in the system. SPECIFIERS ... Specifies that the role name matching the specified glob-style pattern will have their rights displayed.
~~PAGE 468~~
~~NOTES To avoid cluttering the output, the show commands rights are not included in the output of the showrole because show commands are granted to all roles by default.~~
~~PAGE 469~~
showrsv DESCRIPTION The showrsv command displays SCSI reservation and registration information for Virtual Volume Logical Unit Numbers (VLUNs) bound for a specified port. SYNTAX showrsv [options ] [] AUTHORITY Any role in the system. OPTIONS –l Specifies that either SCSI–3 persistent reservation or SCSI–2 reservation information is displayed. If this option is not specified, information about both SCSI–2 and SCSI–3 reservation will be shown.
~~PAGE 470~~
• 5. (Write exclusive–registrants only). All read requests allowed. Write requests allowed for registered initiators only. • 6. (Exclusive access–registrants only). Read and write requests allowed for registered initiators only. • 7. (Write exclusive–all registrants). All read requests allowed. Write requests allowed for registered initiators only. • 8. (Exclusive access–all registrants). Read and write requests allowed for registered initiators only. NOTES None.
~~PAGE 471~~
showsched DESCRIPTION The showsched command shows the state of tasks currently scheduled on the system. SYNTAX showsched [options][|] AUTHORITY Super, Service, Edit, Browse Any extended role in the system. OPTIONS -all Specifies that all scheduled tasks will be displayed. -sortcol [,
~~][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified.~~
~~PAGE 472~~
move_back_chunklet4 moverelocpd -f 3,10 17 2 * * 3 3parsvc active Y 2009-03-18 02:17:00 PDT move_back_chunklet5 moverelocpd -f 4,11 17 2 * * 4 3parsvc active Y 2009-03-12 02:17:00 PDT move_back_chunklet6 moverelocpd -f 5,12 17 2 * * 5 3parsvc active Y 2009-03-13 02:17:00 PDT move_back_chunklet7 moverelocpd -f 6,13 17 2 * * 6 3parsvc active Y 2009-03-14 02:17:00 PDT remove_expired_vvs removevv -f 27 * * * * 3parsvc active Y 2009-03-11 17:27:00 PDT -------------------------------------------------------------
~~PAGE 473~~
showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX showsnmpmgr AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays a list of registered managers: cli% showsnmpmgr Manager IP 82.185.98.76 82.162.9.
~~PAGE 474~~
showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX showsnmppw [options] AUTHORITY Any role in the system. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) password is displayed. If not specified, the read/write community string password is displayed. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 475~~
showsnmpuser DESCRIPTION The showsnmpuser command displays information about one or all SNMP users, including the username, authentication and privacy protocols. WARNING! SNMP cannot be used in Common Criteria mode. It might compromise the security of the storage system. SYNTAX The syntax for the showsnmpuser command can be one of the following: showsnmpuser [] showsnmpuser AUTHORITY Any role in the system. OPTIONS None.
~~PAGE 476~~
~~showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation. SYNTAX showspace [options ] AUTHORITY Any role in the system.~~
~~PAGE 477~~
The -devtype pattern cannot be used to mix Near Line (NL) and FC, and Solid State Drive (SSD) drives: NOTE: An item is specified as an integer, a comma-separated list of integers, or a range of integers specified from low to high. –nd Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s).
~~PAGE 478~~
–devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel or NL, nearline, or SSD for solid state drive) to be used. Device types can be displayed by issuing the showpd command. If it is not specified, the default device type is FC. -rpm Specifies that disks must be of the indicated speed. Device speeds are shown in the RPM column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD).
~~PAGE 479~~
showspare DESCRIPTION The showspare command displays information about chunklets in the system that are reserved for spares and previously free chunklets selected for spares by the system. SYNTAX showspare [-used] AUTHORITY Any role in the system. OPTIONS -used Show only used spare chunklets. By default all spare chunklets are shown. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 480~~
• • ◦ normal. The chunklet is available for use. ◦ normal,smag. A servicemag operation is performed on the disks. ◦ none. Chunklets were not used by any logical disk. Usage. Shows whether the spare chunklet is in use by a logical disk. ◦ available. The chunklet is available for use as a spare or as a logical disk. ◦ ld. The chunklet is in use by a logical disk. ◦ synch. The chunklet is both the source and the target of a logical disk relocation operation (synchronizing the chunklet).
~~PAGE 481~~
showsshkey DESCRIPTION The showsshkey command will displays all SSH public keys that have been set with setsshkey. SYNTAX showsshkey AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 482~~
showsys DESCRIPTION The showsys command displays the HP 3PAR storage system properties includes system name, model, serial number, and system capacity information, etc. SYNTAX showsys [options] AUTHORITY Any role in the system. OPTIONS –d Specifies that more detailed information about the system is displayed. –param Specifies that the system parameters are displayed. –fan Displays the system fan information. –space Displays the system capacity information in MB (1048576 bytes).
~~PAGE 483~~
ID -Name- ---Model--- -Serial- Nodes Master TotalCap AllocCap FreeCap FailedCap 15 s015 InServ T400 1000015 2 0 1063424 208384 855040 0 In the previous example: • ID. The system ID. • Name. The system name. • Model. The model type of the HP 3PAR storage system. • Serial. The system serial number. • Nodes. The number of nodes in the system. • Master. The master node ID. • TotalCap. The total system capacity in MB. • AllocCap. The allocated system capacity in MB. • FreeCap.
~~PAGE 484~~
The following example displays more detailed (–d option) information about the same system: cli% showsys -d ------------General------------System Name : S424 System Model : InServ E200 Serial Number : 1100424 System ID : 424 Number of Nodes : 2 Master Node : 0 Nodes Online : 0,1 Nodes in Cluster : 0,1 -----System Capacity (MB)----Total Capacity : 6277120 Allocated Capacity : 687872 Free Capacity : 5589248 Failed Capacity : 0 ---------System Fan--------Primary Node ID : 0 Secondary Node ID : 1 State : OK LED
~~PAGE 485~~
defaults. When (from default settings) is displayed, system parameters cannot be updated. • The system capacity information may have some overlaps among Volumes, System, Failed Capacities. • If the VVRetentionTimeMax is 0, then the volume retention time in the system is disabled.
~~PAGE 486~~
showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the startup state information about the system manager. In this example, the system manager reports that it is up and running.
~~PAGE 487~~
following message is displayed. See “NOTES” (page 487) in the following section for additional information. cli% showsysmgr System is recovering from a previous power failure. Please use the 'showvv', 'showld', 'showpd' CLI commands to check for not started vvs, lds, pds. Use force_iderecovery to start pfail recovery. VVs with the id(s) 1 will lose data.
~~PAGE 488~~
showtarget DESCRIPTION The showtarget command displays information about unrecognized targets. SYNTAX showtarget [...] showtarget -lun ... showtarget <-inq|-mode> [-page ] [-d] ... showtarget -rescan AUTHORITY Any role in the system. OPTIONS -lun Display the information for remote LUNs. -inq Display the SCSI inquiry page information. -mode Display the SCSI mode page information. -page Specify the SCSI page number for the inquiry and mode information.
~~PAGE 489~~
0:5:2 50002AC00014001F 20520002AC00001F peer_volume 1:5:2 50002AC00014001F 21520002AC00001F peer_volume If unknown targets are found, information (Port, LUN_WWN, Port WWN, and State) about each target found is displayed. NOTES Some hosts might appear as unknown targets.
~~PAGE 490~~
showtask DESCRIPTION The showtask command displays information about tasks. By default, this command displays all non-system tasks on the system within the last 24 hours. SYNTAX showtask [options ] [ | ] AUTHORITY Any role in the system. OPTIONS –all Specifies that all scheduled tasks will be displayed. Unless the -all option is specified, system tasks are not displayed. –done Display includes only tasks that are successfully completed.
~~PAGE 491~~
~~RESTRICTIONS None. EXAMPLES The following example displays all tasks on a system. In this case, the last task is still in progress.~~
~~PAGE 492~~
◦ tune_vv_rollback. Track rolling back of 3PAR System Tuner volume tuning operation that was previously interrupted (tunealdvv –rollback command). Requires an HP 3PAR Dynamic Optimization license. ◦ scheduled_task. Track tasks that have been executed by the system scheduler. ◦ system_task. Track tasks that are periodically run by the system. ◦ background_task. Track commands that have been started via the starttask command. • Name. The name of the system object that is being operated on.
~~PAGE 493~~
NOTES • See the HP 3PAR Command Line Interface Administrator’s Manual for additional information and examples regarding task management and task management commands, as well as information about Dynamic Optimization. • By default, this command shows all tasks that started within the last 24 hours. • The system stores information for the most recent 1000 tasks. Task ID numbers roll at 9999.
~~PAGE 494~~
showtemplate DESCRIPTION The showtemplate command displays existing templates that can be used for Virtual Volume (VV), Logical Disk (LD), or Common Provisioning Group (CPG) creation. SYNTAX showtemplate [options] [...] AUTHORITY Any role in the system. OPTIONS –t VV|LD|CPG Specifies that the template type displayed is a VV, LD, or CPG template. –fit Specifies that the properties of the template is displayed to fit within 80 character lines.
~~PAGE 495~~
showtoc DESCRIPTION The showtoc command displays the system table of contents summary that provides a summary of the system’s resources. SYNTAX showtoc AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the system table of contents.
~~PAGE 496~~
showtocgen DESCRIPTION The showtocgen command displays the table of contents generation number. SYNTAX showtocgen AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the table of contents generation number: cli% showtocgen Table of Contents generation number: 4292 NOTES The table of contents generation number increases each time there is a change in the system configuration.
~~PAGE 497~~
showuser DESCRIPTION The showuser command displays information about one or all users, including the username, authority level, and system resources to which a given user has access. The showuser command shows account information for local users (those created with the createuser command) or shows the SSH key information for local and LDAP users (enabled by the setauthparam command).
~~PAGE 498~~
NOTES • Users are created using the createuser command. See “createuser” (page 149) for more information. • For the first usage (without the -k option), the showuser command displays account information for all local users when the is not provided or the account information for just the local user with the name when it is provided.
~~PAGE 499~~
showuseracl DESCRIPTION The showuseracl command displays a user’s access control list (ACL). SYNTAX showuseracl AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays ACL information about all system users: cli% showuseracl User Operation Object_Names_or_Patterns suser updatevv avvro* buser updatevv avvr*,vv0,cpvv0,tpvv0 –f ruser updatevv vv0 cpvv0 tpvv0 avv* The columns in the previous example are identified as follows: • User.
~~PAGE 500~~
showuserconn DESCRIPTION The showuserconn command displays information about users who are currently connected (logged in) to the HP 3PAR storage system. SYNTAX showuserconn [options ][ ...] AUTHORITY Any role in the system. OPTIONS -current Shows all information about the current connection only. -d Specifies more detailed information about the user connection. –sortcol [,
~~][:[,]...] Sorts command output based on column number .~~
~~PAGE 501~~
The columns in the previous example are identified as follows: • Id. Your HP 3PAR storage system identification number. • Name. Indicates the user name under which you logged in. • IP_Addr. The IP address where the user connection exists. NOTE: The Domain column is displayed only if the CLI was started with the -listdom global option or with the LISTDOM environment variable.
~~PAGE 502~~
showversion DESCRIPTION The showversion command displays information about the storage server software. Use this command to determine if your system is using the latest software version. SYNTAX showversion [options] AUTHORITY Any role in the system. OPTIONS –a Show all component versions. –b Show build levels. –s Show release version number only (useful for scripting). If no options are specified, the overall version of the software is displayed. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 503~~
showvlun DESCRIPTION The showvlun command displays information about Virtual Volume Logical Unit Numbers (VLUNs) in the system, such as all active and template VLUNs. The display is divided into two sections: the upper provides information about active VLUNs and the lower provides information about VLUN templates. SYNTAX showvlun [options ] showvlun -listcols AUTHORITY Any role in the system.
~~PAGE 504~~
–l {}... Specifies that only exports to the specified LUN are displayed. This specifier can be repeated to display information for multiple LUNs. –nodes Requests that only VLUNs for specific nodes are displayed. The node list is specified as a series of integers separated by commas (for example 0,1,2). The list can also consist of a single integer (for example 1). –slots Requests that only VLUNs for specific slots are displayed.
~~PAGE 505~~
2 test.2 sun 210000E08B023C71 1:5:1 host 3 test.3 sun 210000E08B023C71 1:5:1 host ----------------------------------------------8 VLUN Templates Lun VVname Host ----Host_WWN---- Port Type 2 tpv.2 pe750–07 ---------------- --- host 3 tpv.3 pe750–07 ---------------- --- host 2 test.2 sun ---------------- --- host 3 test.3 sun ---------------- --- host ---------------------------------------------4 The columns in the previous examples are identified as follows: • Lun.
~~PAGE 506~~
showvv DESCRIPTION The showvv command displays information about all Virtual Volumes (VVs) or a specific VV in a system. SYNTAX • showvv [options ] [...] • showvv -listcols AUTHORITY Any role in the system. OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showvv for help on each column).
~~PAGE 507~~
–r Displays raw space used by the VVs. The following columns are shown: ID, Name, Prov, Type, Adm_RawRsvd_MB, Adm_Rsvd_MB, Snp_RawRsvd_MB, Snp_Rsvd_MB, Usr_RawRsvd_MB, Usr_Rsvd_MB, Tot_RawRsvd_MB, Tot_Rsvd_MB, VSize_MB. -zone Displays mapping zone information for VVs. The following columns are shown: ID, Name, Prov, Type, VSize_MB, Adm_Zn, Adm_Free_Zn, Snp_Zn, Snp_Free_Zn, Usr_Zn, Usr_Free_Zn. -g Displays the volume’s SCSI geometry settings for VVs.
~~PAGE 508~~
~~Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting~~
can be specified as follows: • inc Sort in increasing order (default). • dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by the values in later columns.
~~PAGE 509~~
• -rcopygroup {}... Displays only VVs that are in Remote Copy groups that match one or more of the specified groups or patterns. Multiple groups or patterns can be repeated using a comma-separated list (for example -rcopygroup ,...). • -policy ... Show only VVs whose policy matches the one or more of the policies or patterns. -domain {}...
~~PAGE 510~~
Specifies the VV name (up to 31 characters in length) matching the glob-style pattern or that are members of the supplied VV set will have their information displayed. The VV_set name must start with set:. This specifier can be repeated to display configuration information about multiple VVs. This specifier is not required on the command line. If not specified, configuration information for all VVs in the system is displayed. RESTRICTIONS None.
~~PAGE 511~~
option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable. • • Type. Indicates the copy type of virtual volume and can be one of the following: ◦ base. Base volume (not a copy). ◦ pcopy. Physical copy (full copy). ◦ vcopy. Snapshot copy (virtual copy). ◦ peer. Remote volume admit into the local HP 3PAR storage system. CopyOf. Displays the virtual volume from which the copy was made. ◦ ---.
~~PAGE 512~~
◦ copy_source. Copy Source. ◦ unknown. Volume state unknown. • Adm. The snapshot administrator space in megabytes. • Snap. The snapshot space in megabytes. • user. Your user space in megabytes. • VSize. Virtual size of volume in MB (1024^2 bytes).
~~PAGE 513~~
13 BasketDome cpvv base 0 0 0 0 0.0 2 5 256 256 100.0 --256 256 ----------------------------------------------------------------------------------------------------- 2 total 10496 10496 0 0 0 0 0.0 2 5 10496 10496 100.0 The columns in the previous example are identified as follows: • ID. The ID of the virtual volume. • Name. The name of the virtual volume. • Prov. The provisioning for the VV. Can be one of the following: ◦ full.
~~PAGE 514~~
The following example displays policy information for virtual volume 0: cli% showvv -p 0 Id Name Domain Policies 0 admin stale_ss,system ---------------------------------------------1 The columns in the previous example are identified as follows: • Id. The virtual volume ID. • Name. The virtual volume name. • Domain. The domain to which the virtual volume belongs. Valid values are – or . If the domain does not exist, - is displayed.
~~PAGE 515~~
• • • Type. Indicates the copy type of virtual volume and can be one of the following: ◦ base. Base volume (not a copy). ◦ pcopy. Physical copy (full copy). ◦ vcopy. Snapshot copy (virtual copy). ◦ peer. Remote volume admit into the local HP 3PAR storage system. State. The state of the virtual volume. ◦ normal. The virtual volume is operating normally. ◦ failed. The virtual volume is operating abnormally. ◦ degraded. The virtual volume is degraded. Detailed_State.
~~PAGE 516~~
~~The following example displays raw space usage information for thin provisioned VVs exported to host hname and all VVs in the tree with the base VV of ID 50.~~
~~PAGE 517~~
The following example shows the policies associated with a volume: cli% showvv -pol Id Name --------------------------Policies-------------------------0 admin stale_ss,system,no_zero_detect 19 aldvv stale_ss,no_system,no_one_host,no_zero_detect 20 bar-remote stale_ss,no_system,no_one_host,no_cache,no_zero_detect 11 mytpvv stale_ss,no_system,no_one_host,no_zero_detect 6 rcopy.0 stale_ss,no_system,no_one_host,no_zero_detect 7 rcopy.
~~PAGE 518~~
• The showvv command has new properties that provide statistics on the growth and reclamation of usr, snp, and adm space within a volume. These properties can be displayed using the -showcols option. The new properties, as shown by the -listcols option are Grown_Adm_MB, Grown_Snp_MB, Grown_Snp_SD_MB, Reclaimed_Adm_MB, Reclaimed_Snp_MB, or Reclaimed_Snp_SD_MB. These statistics are only available via the CLI and only via the -showcols option. • For this command: 1 MB = 1048576 bytes.
~~PAGE 519~~
showvvcpg DESCRIPTION The showvvcpg command displays the Virtual Volume (VV) space distribution among CPGs. SYNTAX showvvcpg [options] [ ...] AUTHORITY Any role in the system. OPTIONS -domain [,...] Only show VVs that are in domains with names matching one or more of the specified domain_name or patterns. Only VVs within domains that the user is a member of can be listed.
~~PAGE 520~~
The following example shows VV space distribution for VVs belonging to VV sets with names that begin with tv: cli% showvvcpg set:tv* ----(MB)---- -New (MB)-Name CPG Adm Snp Usr Adm Snp Usr testvv cpg0 - 1024 0 0 0 newtestvv cpg0 - 1024 0 0 0 --------------------------------------2 0 0 2048 0 0 0 The following example shows how Adaptive Optimization has distributed space for the Adm, Snp and Usr space for a VV among 3 CPGs: cli% showvvcpg Win2k8-MySqlData -----(MB)------ -New (MB)-Name CPG Adm Snp Usr Adm S
~~PAGE 521~~
showvvmap DESCRIPTION The showvvmap command displays information about how Virtual Volume (VV) regions are mapped to logical disks. SYNTAX showvvmap AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS Specifies the VV name, using up to 31 characters in length. RESTRICTIONS None.
~~PAGE 522~~
~~NOTES None.~~
~~PAGE 523~~
showvvpd DESCRIPTION The showvvpd command displays Virtual Volume (VV) distribution across Physical Disks (PDs) . SYNTAX showvvpd [option ] {}... AUTHORITY Any role in the system. OPTIONS –sortcol [,
~~][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number.~~
~~PAGE 524~~
11 0:2:3 0 0 0 0 12 0:3:0 0 0 0 0 13 0:3:1 0 0 0 0 14 0:3:2 0 0 0 0 15 0:3:3 0 0 0 0 16 1:0:0 0 0 4 4 17 1:0:1 0 0 4 4 18 1:0:2 0 0 4 4 19 1:0:3 0 0 4 4 20 1:1:0 0 0 4 4 21 1:1:1 0 0 4 4 22 1:1:2 0 0 4 4 23 1:1:3 0 0 4 4 24 1:2:0 0 0 4 4 25 1:2:1 0 0 4 4 26 1:2:2 0 0 4 4 27 1:2:3 0 0 4 4 28 1:3:0 0 0 4 4 29 1:3:1 0 0 4 4 30 1:3:2 0 0 4 4 31 1:3:3 0 0 4 4 32 2:0:0 0 0 4 4 33 2:0:1 0 0 4 4 34 2:0:2 0 0 4 4 35 2:0:3 0 0 4 4 36 2:1:0 0 0 4 4 37 2:1:1 0 0 4 4 38 2:1:2 0 0 4 4 39 2:1:3 0 0 4 4 40 2:2:0 0 0 4 4 41
~~PAGE 525~~
17 1:0:1 0 0 4 4 18 1:0:2 0 0 4 4 19 1:0:3 0 0 4 4 20 1:1:0 0 0 4 4 21 1:1:1 0 0 4 4 22 1:1:2 0 0 4 4 23 1:1:3 0 0 4 4 24 1:2:0 0 0 4 4 25 1:2:1 0 0 4 4 26 1:2:2 0 0 4 4 27 1:2:3 0 0 4 4 28 1:3:0 0 0 4 4 29 1:3:1 0 0 4 4 30 1:3:2 0 0 4 4 31 1:3:3 0 0 4 4 32 2:0:0 0 0 4 4 33 2:0:1 0 0 4 4 34 2:0:2 0 0 4 4 35 2:0:3 0 0 4 4 36 2:1:0 0 0 4 4 37 2:1:1 0 0 4 4 38 2:1:2 0 0 4 4 39 2:1:3 0 0 4 4 40 2:2:0 0 0 4 4 41 2:2:1 0 0 4 4 42 2:2:2 0 0 4 4 43 2:2:3 0 0 4 4 44 2:3:0 0 0 4 4 45 2:3:1 0 0 4 4 46 2:3:2 0 0 4 4 47
~~PAGE 526~~
42 2:2:2 1 1 0 2 44 2:3:0 1 1 0 2 45 2:3:1 1 1 0 2 46 2:3:2 0 1 1 2 1 0:0:1 0 1 0 1 2 0:0:2 0 1 0 1 4 0:1:0 0 1 0 1 5 0:1:1 0 1 0 1 12 0:3:0 0 1 0 1 13 0:3:1 1 0 0 1 14 0:3:2 1 0 0 1 16 1:0:0 0 0 1 1 25 1:2:1 0 1 0 1 28 1:3:0 0 1 0 1 32 2:0:0 0 1 0 1 35 2:0:3 0 1 0 1 37 2:1:1 0 1 0 1 38 2:1:2 1 0 0 1 47 2:3:3 1 0 0 1 23 1:1:3 0 0 0 0 36 2:1:0 0 0 0 0 41 2:2:1 0 0 0 0 --------------------------48 total 32 40 8 80 NOTES • The command prints the number of chunklets in each physical disk that contain data for
~~PAGE 527~~
showvvset DESCRIPTION The showvvset command lists the Virtual Volume (VV) sets defined on the HP 3PAR storage system and their members. SYNTAX showvvset [options] [...] showvvset -vv [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -vv Show VV sets that contain the supplied vvnames or patterns SPECIFIERS ... An optional list of setnames or patterns.
~~PAGE 528~~
Show the sia-1 set only, with detail: cli% showvvset -d sia-1 20 sia-1 test This set has a comment ttpvv.rw test-sv bar Show VV sets containing VVs matching test*: cli% showvvset -vv test* Id Name Members 20 sia-1 test ttpvv.rw test-sv bar NOTES A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set.
~~PAGE 529~~
showwsapi DESCRIPTION The showwsapi command displays the WSAPI server service configuration state as either Enabled or Disabled. It displays the server currently running status as Active, Inactive or Error. It also displays the current status of the HTTP and HTTPS ports and their port numbers.
~~PAGE 530~~
24 Shutdown Commands shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot|wipeid AUTHORITY • Super, Service • Any role granted the node_shutdown right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the nodes are halted after shutdown. If this subcommand is not specified, the reboot or wipeid (StoreServ 7000 only) subcommand must be used.
~~PAGE 531~~
3 4 5 6 7 8 9 sunx4150-04 sunx4150-05 sunx4150-06 sunx4150-07 sunx4150-08 sunx4150-09 sunx4150-10 Generic-legacy Generic-legacy Generic-legacy Generic-legacy Generic-legacy Generic-legacy Generic-legacy 2101001B32341C95 2101001B32342495 2100001B321A6E82 2101001B3231EE79 2101001B323BC44C 2101001B323BFF4C 2101001B323B0A4C 0:5:1 0:5:1 0:5:1 0:5:1 0:5:1 0:5:1 0:5:1 n/a n/a n/a n/a n/a n/a n/a There are active tasks on this storage system.
~~PAGE 532~~
◦ One or more admin logical disks cannot be reset, resulting in the kernel being unable to access meta data from those LDs. ◦ One or more data (user or snap) logical disks cannot be reset, causing their associated VLUNs to become inaccessible to host applications.
~~PAGE 533~~
shutdownsys DESCRIPTION The shutdownsys command shuts down an entire system. SYNTAX shutdownsys halt|reboot AUTHORITY • Super, Service • Any role granted the sys_shutdown right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the system should be halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the system should be restarted after shutdown.
~~PAGE 534~~
7 8 9 sunx4150-08 Generic-legacy 2101001B323BC44C 6:5:1 n/a sunx4150-09 Generic-legacy 2101001B323BFF4C 6:5:1 n/a sunx4150-10 Generic-legacy 2101001B323B0A4C 6:5:1 n/a Shutting down this storage system will impact applications running on the hosts displayed above Do you REALLY want to REBOOT this storage system? yes or no: yes The system will REBOOT in 15 seconds Press the enter key to stop... The system will REBOOT in 12 seconds Press the enter key to stop...
~~PAGE 535~~
25 System Reporter (SR) commands sraomoves DESCRIPTION The sraomoves command shows the space that Adaptive Optimization (AO) has moved between tiers. SYNTAX sraomoves [options] AUTHORITY Any role in the system OPTIONS -btsecs Select the begin time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
~~PAGE 536~~
RESTRICTIONS None EXAMPLES The following example shows space moved by AO beginning 2 hours (7200 seconds) ago: cli% sraomoves -btsecs -7200 NOTES For this command: 1 MB = 1048576 bytes. The space reported is the space that AO has requested to be moved; the actual space moved could be less (for example, if the move failed).
~~PAGE 537~~
srcpgspace DESCRIPTION The srcpgspace command displays historical space data reports for common provisioning groups (CPGs). SYNTAX srcpgspace [options] [|...] AUTHORITY Any role in the system SUBCOMMANDS OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval.
~~PAGE 538~~
If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 539~~
srhistld DESCRIPTION The srhistld command displays historical histogram performance data reports for logical disks. SYNTAX srhistld [options] [|...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval.
~~PAGE 540~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -metric both|time|size Selects which metric to display.
~~PAGE 541~~
RESTRICTIONS EXAMPLES The following example displays aggregate hourly histogram performance statistics for all logical disks beginning 24 hours ago: cli% srhistld -hourly -btsecs -24h NOTES For this command: KB = 1000 bytes.
~~PAGE 542~~
srhistpd DESCRIPTION The srhistpd command displays historical histogram data reports for physical disks. SYNTAX srhistpd [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 543~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -metric both|time|size Selects which metric to display.
~~PAGE 544~~
Limit the data to disks of the types specified. • FC – Fibre Channel • NL – Nearline • SSD – Solid State Drive SPECIFIERS [...|...] PDs with IDs that match either the specified PDID or glob-style pattern are included. This specifier can be repeated to include multiple PDIDs or patterns. If not specified, all PDs are included.
~~PAGE 545~~
srhistport DESCRIPTION The srhistport command displays historical histogram performance data reports for ports. SYNTAX srhistport [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 546~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -metric both|time|size Selects which metric to display.
~~PAGE 547~~
EXAMPLES The following example displays aggregate hourly histogram performance statistics for all ports beginning 24 hours ago: cli% srhistport -hourly -btsecs -24h NOTES For this command: KB = 1000 bytes.
~~PAGE 548~~
srhistvlun DESCRIPTION The srhistvlun command displays historical histogram performance data reports for VLUNs. SYNTAX srhistvlun [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 549~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -metric both|time|size Selects which metric to display.
~~PAGE 550~~
• HOST_WWN The host WWN for the VLUN • PORT_N The node number for the VLUN port • PORT_S The PCI slot number for the VLUN port • PORT_P The port number for the VLUN port SPECIFIERS None EXAMPLES The following example displays aggregate hourly histogram performance statistics for all VLUNs beginning 24 hours ago: cli% srhistvlun -hourly -btsecs -24h NOTES For this command: KB = 1000 bytes.
~~PAGE 551~~
srldspace DESCRIPTION The srldspace command displays historical space data reports for logical disks (LDs). SYNTAX srldspace [options] [|...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval.
~~PAGE 552~~
If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 553~~
EXAMPLES The following example displays aggregate hourly LD space information for all RAID 5 LDs with names that match either "fc*" or "ssd*" patterns beginning 24 hours ago: cli% srldspace -raid_type 5 -hourly -btsecs -24h fc* ssd* The following example displays LD space information for the most recent daily sample aggregated by the LD name for LDs with names that match the pattern "tp*". cli% srldspace -daily -attime -groupby ld_name tp* NOTES For this command: 1 MB = 1048576 bytes.
~~PAGE 554~~
srpdspace DESCRIPTION The srpdspace command displays historical space data reports for physical disks (PDs). SYNTAX srpdspace [options] [...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval.
~~PAGE 555~~
If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 556~~
srrgiodensity DESCRIPTION The srrgiodensity command shows the distribution of IOP/s intensity for Logical Disk (LD) regions for a common provisioning group (CPG) or Adaptive Optimization (AO) configuration. For a single CPG, this can be used to see whether AO can be effectively used. For an AO configuration the command shows how AO has moved regions between tiers.
~~PAGE 557~~
Select the step between histogram columns of the report. By default each column's IO density is 4 times the previous column, but a step of 2 or 8 can also be specified. -cpg Treat the specifier as a CPG name instead of an AO configuration name. SPECIFIERS The name of the AO configuration to generate the report for. The name of the CPG to generate the report for (if the -cpg option is specified).
~~PAGE 558~~
srstatcmp DESCRIPTION The srstatcmp command displays historical performance data reports for cache memory. SYNTAX srstatcmp [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 559~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 560~~
srstatcpu DESCRIPTION The srstatcpu command displays historical performance data reports for CPUs. SYNTAX srstatcpu [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 561~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items. Each must be different and one of the following: • NODE The controller node • CPU The CPU within the controller node SPECIFIERS [...
~~PAGE 562~~
srstatld DESCRIPTION The srstatld command displays historical performance data reports for logical disks. SYNTAX srstatld [options] [|...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 563~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 564~~
srstalink DESCRIPTION The srstatlink command displays historical performance data reports for links (internode, PCI and cache memory). SYNTAX The syntax for the srstalink command can be one of the following examples: • srstatlink [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option.
~~PAGE 565~~
If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for each combination of items.
~~PAGE 566~~
srstatpd DESCRIPTION The srstatpd command displays historical performance data reports for physical disks. SYNTAX srstatpd [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 567~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 568~~
srstatport DESCRIPTION The srstatport command displays historical performance data reports for ports. SYNTAX srstatport [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 569~~
Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 570~~
srstatqos DESCRIPTION The srstatqos command displays historical performance data reports for QoS rules. SYNTAX srstatqos [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option performance is shown versus time, with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 571~~
Select high resolution samples (5 minute intervals) for the report. This is the default. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -vvset [,...] Limit the data to VVSets with names that match one or more of the specified names or glob-style patterns. -all_others Display statistics for all other IO not regulated by a QoS rule. -groupby [,...
~~PAGE 572~~
srstatvlun DESCRIPTION The srstatvlun command displays historical performance data reports for VLUNs. SYNTAX srstatvlun [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report.
~~PAGE 573~~
~~Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -host [,[,...~~
~~PAGE 574~~
srvvspace DESCRIPTION The srvvspace command displays historical space data reports for virtual volumes (VVs). SYNTAX srvvspace [options] [...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval.
~~PAGE 575~~
If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default setting. -hourly Select hourly samples for the report. -daily Select daily samples for the report. -groupby [,...] For -attime reports, generate a separate row for items.
~~PAGE 576~~
The following example displays VV space information for the most recent daily sample aggregated by the VV name for VVs with names that match the pattern "tp*". cli% srvvspace -daily -attime -groupby vv_name tp* NOTES For this command: 1 MB = 1048576 bytes.
~~PAGE 577~~
26 Start Commands startao DESCRIPTION The startao command starts execution of an Adaptive Optimization (AO) configuration using data region level performance data collected for the specified number of hours. SYNTAX startao [option] AUTHORITY Super, Edit Any role granted the aocfg_start right OPTIONS -btsecs Select the begin time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
~~PAGE 578~~
Select the approximate maximum run time in hours (default is 6 hours). The number should be between 1 and 24 hours. The command will attempt to limit the amount of data to be moved so the command can complete by the specified number of hours. If the time runs beyond the specified hours, the command will abort at an appropriate time. -compact Specify if and how CPGs should be compacted. Choices for are: • auto Automatically select the compactcpg mode (default).
~~PAGE 579~~
startcim DESCRIPTION The startcim command starts the CIM server to service CIM requests. By default, the CIM server is not started until this command is issued. SYNTAX startcim AUTHORITY • Super, Service • Any role granted the cim_start right. NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS Access to all domains is required to run this command.
~~PAGE 580~~
startld DESCRIPTION The startld command starts data services on a Logical Disk (LD) that has not yet been started. SYNTAX startld [option] AUTHORITY • Super, Service • Any role granted the ld_start right. NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the LD is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the LD name, using up to 31 characters.
~~PAGE 581~~
startnoderescue DESCRIPTION The startnoderescue command initiates a node rescue, which initializes the internal node disk of the specified node to match the contents of the other node disks. The copy is done over the network, so the node to be rescued must have an Ethernet connection. It will automatically select a valid unused link local address. Progress is reported as a task. SYNTAX startnoderescue -node AUTHORITY Super, Service OPTIONS -node Specifies the node to be rescued.
~~PAGE 582~~
startrcopy DESCRIPTION The startrcopy command enables Remote Copy. SYNTAX startrcopy AUTHORITY • Super, Edit • Any role granted the rcopy_start right. NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS This command requires the HP 3PAR Remote Copy Software license. Contact your local service provider for more information.
~~PAGE 583~~
startrcopygroup DESCRIPTION The startrcopygroup command enables Remote Copy for the specified Remote Copy volume group. SYNTAX startrcopygroup [options] [ ...] startrcopygroup [options] AUTHORITY • Super, Edit • Any role granted the rcopygroup_start right. OPTIONS –nosync Prevents the initial synchronization and sets the virtual volumes to a synchronized state. –wait Specifies that the command blocks until the initial synchronization is complete.
~~PAGE 584~~
To start Group2, which contains 4 virtual volumes, and specify starting snapshots, with vv4 starting from a full resync: # startrcopygroup Group2 vv1:sv1 vv2:sv2 vv3:sv3 vv4:- NOTES • If a group’s target has the mirror_config policy set and the group is a primary group, then this command will be mirrored to that target and the corresponding secondary group will be started. If the policy is set and the group is a secondary, then this command will fail.
~~PAGE 585~~
starttask DESCRIPTION The starttask command provides users with the ability to execute commands with long running times. The commands run in the background. SYNTAX starttask AUTHORITY • Super, Service, Edit • Any role granted thetask_start right. OPTIONS None. SPECIFIERS Specifies the command to be run by the starttask command. RESTRICTIONS None.
~~PAGE 586~~
startvv DESCRIPTION The startvv command starts data services on a Virtual Volume (VV) that has not yet been started. SYNTAX startvv [option] AUTHORITY • Super, Service • Any role granted the vv_start right. NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the logical disk is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the VV name, using up to 31 characters.
~~PAGE 587~~
startwsapi DESCRIPTION The startwsapi command starts the Web Services API server to service HTTP and HTTPS requests. By default, the Web Services API server is not started until this command is issued. SYNTAX startwsapi AUTHORITY Super, Service Any role granted the wsapi_start right OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example starts the Web Services API server: cli% startwsapi The Web Services API server will start shortly.
~~PAGE 588~~
27 Stat Commands statch DESCRIPTION The statch command displays chunklet statistics in a timed loop. SYNTAX statch [options ] AUTHORITY Any role in the system. OPTIONS –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of 2 seconds.
~~PAGE 589~~
Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed.
~~PAGE 590~~
Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. –ld |–ch –ld Specifies that statistics are restricted to chunklets from a particular logical disk. –ch Specifies that statistics are restricted to a particular chunklet number. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 591~~
• Qlen. The queue length. • Util % Cur. The percentage of current use. • Util % Avg. The percentage of average use. NOTES • For this command: KB = 1000 bytes. • If no options are used, the command defaults to show reads, writes, and totals separately for all chunklets in intervals of 2 seconds. • The statch command can only be used after the setstatch command has been issued to enable chunklet statistics. See “setstatch” (page 331) for information about the setstatch command.
~~PAGE 592~~
statcmp DESCRIPTION The statcmp command displays Cache Memory Page (CMP) statistics by node or by Virtual Volume (VV). SYNTAX statcmp [options ] AUTHORITY Any role in the system. OPTIONS –v Specifies that CMP statistics by VV instead of by node are displayed. By default, all VVs are displayed unless the –n option is specified. –n Specifies that statistics are displayed for VVs matching the specified name or pattern. This option is valid only when used with the –v option.
~~PAGE 593~~
0 473405 11790 1 483013 2158 0 0 0 0 0 0 0 0 0 0 0 0 Temporary and Page Credits Node Node0 Node1 Node2 Node3 Node4 Node5 Node6 Node7 0 0 33411 ------------1 33482 0 ------------Page Statistics ---CfcDirty--- ------CfcMax------Node FC FC15 NL SSD FC FC15 NL SSD 0 15 0 17 0 19200 0 9600 0 1 16 0 18 0 19200 0 9600 0 ----DelAck---FC FC15 NL SSD 11 0 13 0 12 0 14 0 Press the enter key to stop... The columns in the example above are identified as follows: • Node. Node ID on the storage system.
~~PAGE 594~~
statcpu DESCRIPTION The statcpu command displays CPU statistics for all nodes. SYNTAX statcpu [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 595~~
~~NOTES None.~~
~~PAGE 596~~
statfcoe DESCRIPTION The statfcoe command displays statistics for Fibre Channel over Ethernet connections. SYNTAX statfcoe [options ] AUTHORITY Any role in the system. OPTIONS -d Specifies the looping delay in seconds . The default is 2. -iter Specifies that the command execution should terminate after a user-defined of iterations. -nodes Specifies the list of nodes for which the ports are included.
~~PAGE 597~~
~~EXAMPLES The following example displays one iteration of FCoE counts: cli% statfcoe -iter 1 -counts -begin NOTES None.~~
~~PAGE 598~~
statiscsi DESCRIPTION The statiscsi command displays the iSCSI statistics. SYNTAX statiscsi [options ] AUTHORITY Any role in the system. OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included. -ports List of ports for which the ports are included.
~~PAGE 599~~
-begin Shows the values from when the system was last initiated. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays basic iSCSI statistics collection: cli% statiscsi 16:37:59 04/06/06 ----Receive---- ---Transmit---- -----Total----port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/s 0:4:1 Eth 15633.2 1116.7 30115.9 45164.4 45749.1 46281.1 0.0 0:4:1 IP 15632.7 522.6 30116.4 44020.8 45749.1 44543.3 0.0 0:4:1 TCP 15632.7 22.3 30116.4 43057.0 45749.1 43079.4 0.
~~PAGE 600~~
statiscsisession DESCRIPTION The statiscsisession command displays the iSCSI session statistics. SYNTAX statiscsisession [options ] AUTHORITY Any role in the system. OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined number of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included.
~~PAGE 601~~
Rx Total Digest TimeOut 1:3:1 iqn.1991-05.com.microsoft:dt-ashok-xp.hq.3pardata.com 131 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0.0 ---------------------------------------------------------------------------------------------------------Total - 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0.0 Press the enter key to stop... NOTES None.
~~PAGE 602~~
statld DESCRIPTION The statld command displays read/write (I/O) statistics about Logical Disks (LDs) in a timed loop. SYNTAX statld [options ] [...] AUTHORITY Any role in the system. OPTIONS -vv {}... Show only LDs that are mapped to Virtual Volumes (VVs) with names matching any of names or patterns specified. Multiple volumes or patterns can be repeated using a comma-separated list (for example -vv ,...). -domain {}...
~~PAGE 603~~
Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The type, operation, meas, and value arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed.
~~PAGE 604~~
Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS ... Only statistics are displayed for the specified LD or pattern. Multiple LDs or patterns can be repeated (for example ...). RESTRICTIONS None.
~~PAGE 605~~
NOTES • For this command: KB = 1000 bytes. • If no option is specified, the command defaults to display statistics totals. • If the or specifier is used, then LDs with names matching any of the patterns are listed, otherwise all LDs are listed. These patterns are glob-style patterns. Refer to “Glob-Style Pattern” (page 12) for further information.
~~PAGE 606~~
statlink DESCRIPTION The statlink command displays statistics for link utilization for all nodes in a timed loop. SYNTAX statlink [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 607~~
statpd DESCRIPTION The statpd command displays the read/write (I/O) statistics for physical disks in a timed loop. SYNTAX statpd [options] AUTHORITY Any role in the system. OPTIONS –w Specifies that statistics for a particular Physical Disk (PD) identified by World Wide Names (WWNs) are displayed. –nodes Specifies that the display is limited to specified nodes and PDs connected to those nodes. The node_list argument is specified as a series of integers separated by commas (1,2,3).
~~PAGE 608~~
~~–sortcol [,~~
][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting () can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order.
~~PAGE 609~~
◦ svct Specifies that statistics for service time in milliseconds are displayed. ◦ size Specifies that statistics for I/O operations in bytes are displayed. • [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. The integer can optionally be followed with k or K to indicate a multiple of 1000, m or M to indicate a multiple of 1,000,000, or g or G to indicate a multiple of 1,000,000,000.
~~PAGE 610~~
range of disk positions is separated with a hyphen (0–3). The specified position(s) must contain disks. –dk Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s).
~~PAGE 611~~
0 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 1 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 2 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 4 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 5 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 6 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 7 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 8 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 9 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 10 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 11 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 12 1:0:2 t 0 0 0 0 0 0 0.
~~PAGE 612~~
statport DESCRIPTION The statport command displays read/write (I/O) statistics for ports. SYNTAX statport [options] AUTHORITY Any role in the system. OPTIONS –both|–ctl|–data Show data transfers only (–data), control transfers only (–ctl), or both data and control transfers (–both). If no option is included on the command line, the command shows data transfers only. –nodes Specifies that the display is limited to specified nodes and Physical Disks (PDs) connected to those nodes.
~~PAGE 613~~
Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Specifies the percent of idle columns in the output. –sortcol [,
~~][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified.~~
~~PAGE 614~~
• The meas argument can be specified with one of the following arguments: ◦ iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. ◦ bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. ◦ svct Specifies that statistics for service time in milliseconds are displayed.
~~PAGE 615~~
The columns in the example above are identified as follows: • Port. The port ID. • D/C. The Data or Control transfers. • r/w. The I/O type. Values can be read (r), write (w), or read and write (t). • I/O per second Cur. The current number of I/O per second. • I/O per second Avg. The average number of I/O per second. • KBytes per Max. The maximum number of KB per second. • KBytes per Cur. The current number of KB per second. • KBytes per Avg. The average number of KB per second.
~~PAGE 616~~
statqos DESCRIPTION The statqos command displays the run-time stats of active QoS rules. SYNTAX The syntax for the showqos command can be one of the following examples: • statqos [options][{vvset:|}|sys:all_others}]... AUTHORITY • Any role in the system OPTIONS -domain {}... Shows rules with target objects in domains with names that match one or more of the specified domains or patterns.
~~PAGE 617~~
Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , are filtered out and not displayed. The , , , are separated by one comma. The type argument can be specified with one of the following arguments: • curs – specifies that only devices with current statistics above the threshold are displayed. • avgs – specifies that only devices with average statistics above the threshold are displayed.
~~PAGE 618~~
A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set. Please run cli -h and setclienv -h for details of the environment variables.
~~PAGE 619~~
statrcopy DESCRIPTION The statrcopy command displays statistics for Remote Copy volume groups.. SYNTAX statrcopy [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 620~~
Receive 1806402.23 50.69 50.69 Send 172955055.10 47838.51 47838.51 --------------------------------------------------------------------------Total 174761457.34 47889.20 47889.20 Press the enter key to stop... The columns in this example provide the following information: • Target. The system name of the actual link process that is running. • Node. The node that the link is running on. • Address. The IP address of the remote node. • IPC. The mode of the Remote Copy link (r) Receive or (s) Send.
~~PAGE 621~~
statrcvv DESCRIPTION The statrcvv command displays statistics for Remote Copy volumes in a timed loop. SYNTAX statrcvv [options ] [|]... AUTHORITY Any role in the system. OPTIONS –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds.
~~PAGE 622~~
Specifies that the sums for all volumes of a domain are displayed. -domain ...|... Show only the virtual volumes that are in domains with names that match the specified domain name(s) or pattern(s). -sortcol [,
][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting (): inc Sort in increasing order (default).
~~PAGE 623~~
Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option -filt curs,t,iops,0. SPECIFIERS ... Displays statistics only for the specified virtual volume or volume name pattern. Multiple volumes or patterns can be repeated (for example, ...). If not specified, all virtual volumes that are configured for Remote Copy are listed. RESTRICTIONS This command requires the HP 3PAR Remote Copy Software license.
~~PAGE 624~~
The columns in this example provide the following information: • VVname. The name of the virtual volume being copied. • RCGroup. Remote Copy group containing the volume. • Target. Remote Copy target system to which the volume is copied. • Mode. Remote Copy mode of the volume, either "Per" (asynchronous periodic) or "Sync" (synchronous). • Port. Remote Copy port for which statistics are displayed. • Type. Interface type of the port. • I/O per second Cur. The current number of I/O per second.
~~PAGE 625~~
statvlun DESCRIPTION The statvlun command displays statistics for Virtual Volumes (VVs) and Logical Unit Number (LUN) host attachments. SYNTAX statvlun [options ] AUTHORITY Any role in the system. OPTIONS -domain ... Shows only Virtual Volume Logical Unit Number (VLUNs) whose VVs are in domains with names that match one or more of the specified domain names or patterns.
~~PAGE 626~~
Specifies that sums for VLUNs are grouped by domain in the display. All VLUNs to unnamed hosts are added and displayed as a single set of data with a "-" host name. –vvsum Specifies that sums for VLUNs of the same VV are displayed. –hostsum Specifies that sums for VLUNs are grouped by host in the display. All VLUNs to unnamed hosts are added and displayed as a single set of data with a nameless host. –rw Specifies reads and writes to be displayed separately.
~~PAGE 627~~
Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed.
~~PAGE 628~~
~~Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS None. RESTRICTIONS None.~~
~~PAGE 629~~
statvv DESCRIPTION The statvv command displays statistics for Virtual Volumes (VVs) in a timed loop. SYNTAX statvv [options ] [...] AUTHORITY Any role in the system. OPTIONS -domain ... Shows only the VVs that are in domains with names that match the specified domain names or patterns. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed.
~~PAGE 630~~
Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed.
~~PAGE 631~~
Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS ... Only statistics are displayed for the specified VV or pattern. Multiple volumes or patterns can be repeated (for example ...). If not specified, all VVs are listed. RESTRICTIONS None.
~~PAGE 632~~
~~cause the read data to appear more than seen by the hosts. Use the histvlun -vvsum command to see data for only accesses from the host. • For this command: KB = 1000 bytes.~~
~~PAGE 633~~
28 Stop Commands stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. WARNING! The stopcim command must be issued to stop the CIM server when setting the storage system to Common Criteria mode. SYNTAX stopcim [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
~~PAGE 634~~
stoprcopy DESCRIPTION The stoprcopy command disables the Remote Copy functionality for any started Remote Copy volume groups. SYNTAX stoprcopy [options] AUTHORITY Super, Edit Any role granted the rcopy_stop right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that any started copy will not ask for confirmation for the -clear option. –stopgroups Specifies that any started Remote Copy volume groups are stopped.
~~PAGE 635~~
~~interactively typing, y. Refer to the HP 3PAR Command Line Interface Administrator’s Manual for information about using environment variables.~~
~~PAGE 636~~
stoprcopygroup DESCRIPTION The stoprcopygroup command stops the Remote Copy functionality for the specified Remote Copy volume group. SYNTAX stoprcopygroup [option ] |... AUTHORITY Super, Edit Any role granted the rcopygroup_stop right. OPTIONS –nosnap In synchronous mode, this option turns off the creation of snapshots. This is useful if removercopygroup is to be run to remove Remote Copy. In asynchronous periodic mode, this option deletes any current synchronization snapshots.
~~PAGE 637~~
The following example stops Remote Copy Groups that start with the name testgroup: # stoprcopygroup -pat testgroup* NOTES • If a group’s target has the mirror_config policy set and the group is a primary group, then this command will be mirrored to that target and the corresponding secondary group will be stopped. If the mirror_config policy is set and the group is a secondary, then this command will fail.
~~PAGE 638~~
stopwsapi DESCRIPTION The stopwsapi command stops the Web Services API server from servicing HTTP and HTTPS requests. SYNTAX stopwsapi [options] AUTHORITY Super, Service Any role granted the wsapi_stop right OPTIONS -f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
~~PAGE 639~~
~~29 Sync Command 639~~
~~PAGE 640~~
syncrcopy DESCRIPTION The syncrcopy command manually synchronizes Remote Copy volume groups. SYNTAX syncrcopy [options ] |... AUTHORITY Super, Edit Any role granted the rcopy_sync right. OPTIONS –w Wait for synchronization to complete before returning to a command prompt. –n Do not save resynchronization snapshot. This option is only relevant for asynchronous periodic mode volume groups.
~~PAGE 641~~
EXAMPLES The following example specifies that Remote Copy volume group Group1 should be synchronized with it’s corresponding secondary volume group: # syncrcopy Group1 Synchronization request issued for group Group1 The following example specifies that all Remote Copy volume groups that start with the name testgroup should be synchronized with their corresponding secondary volume group: # syncrcopy -pat testgroup* NOTES • Mode (synchronous or asynchronous periodic) is set using the creatercopygroup comm
~~PAGE 642~~
30 Tune Commands tunealdvv DESCRIPTION This command is only used for non-provisioned virtual volumes. Please use the tunevv command to create a virtual volume that has its user space provisioned from a CPG. This command was deprecated in the 2.2.4 release and will be removed in a future release. The tunealdvv command changes the layout of a virtual volume.
~~PAGE 643~~
Use the options defined in template . The template is created using the createtemplate command. Options specified in the template are read-only or read-write. The read-write options may be overridden with new options at the time of their creation, but read-only options may not be overridden at creation time.
~~PAGE 644~~
–cg Specifies one or more drive cages. Drive cages are identified by one or more integers (). Multiple drive cages are separated with a single comma (1,2,3). A range of drive cages is separated with a hyphen (0–3). The specified drive cage(s) must contain disks. –mg Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using the -mg option.
~~PAGE 645~~
Disks that satisfy all of the specified characteristics are used. For example, -p -fc_gt 60 -fc_lt 230 -nd 2 specifies all the disks that have greater than 60 and less than 230 free chunklets and that are connected to node 2 through their primary path. –wait If the tunealdvv command fails due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately.
~~PAGE 646~~
The following example shows how to use the tunealdvv command to change the availability level of a virtual volume (testvol) to cage. Note that because the default availability parameter setting (–ha) for tunealdvv is cage, it is not necessary to explicitly specify cage-level availability when issuing this command. cli% tunealdvv testvol Task 2 started.
~~PAGE 647~~
tunepd DESCRIPTION The tunepd command identifies physical disks with high service times and optionally executes load balancing. SYNTAX The syntax for the tunepd command can be one of the following: • tunepd [options ] maxsvct |highest • tunepd [options ] avgsvct |highest AUTHORITY Super, Edit Any role granted the pd_tune right NOTE: You need access to all domains in order to run this command.
~~PAGE 648~~
Specifies the interval, in minutes, that the command enters standby mode between iterations using an integer greater than 0. If this option is not specified, the number of iterations is looped indefinitely. –vvlayout Specifies that the layout of the virtual volume is displayed. If this option is not specified, the layout of the virtual volume is not displayed. –portstat Specifies that statistics for all disk ports in the system are displayed.
~~PAGE 649~~
• If one or more chunklet statistics collection processes are running, the tunepd command exits to prevent possible tunepd –chstat on processes running simultaneously. • Use the –chstat force option only when you have verified that no other tunepd processes are running. EXAMPLES In the following example, PDs with average service times exceeding 50 milliseconds are identified and their chunklets automatically relocated to rebalance the PDs’ load.
~~PAGE 650~~
Physical Disk 29: The following chunklets have been marked for moving: 26 Pass 1: Dryrun moving chunklets: Move Status qlocal qlost 29:26–10:16 source and destination are valid true false Pass 2: Move qlocal qlost 29:26–10:16 true false Status ch was moved qset qrow qcon mag 0 2 qset qrow qcon mag 0 2 Note that physical disk 29 is identified as matching the search criterion of average service times greater than 50 milliseconds and its chunklets are relocated.
~~PAGE 651~~
tunesys DESCRIPTION The tunesys command is used to analyze and detect poor layout and disk utilization across an entire HP 3PAR storage system array. This command runs a series of low level operations to affect a re-balance of resources on the system. SYNTAX tunesys [options] AUTHORITY • Super, Edit • Any role granted the sys_tune right OPTIONS -cpg Limits the scope of a tunesys operation to the named CPG(s). The specified CPGs must all be in the same domain as the user.
~~PAGE 652~~
Wait for all tasks created by this command to complete before returning. -f Do not ask for confirmation. SPECIFIERS None. RESTRICTIONS None • This command requires a Dynamic Optimization license. Contact your local HP representative for information. EXAMPLES In the following example: • VVs will be re-balanced between nodes if there is an imbalance in space usage between nodes of more than 5% (nodepct value).
~~PAGE 653~~
complete that phase. For example, a showtask step and phase display of 1/3 4/39 indicates that tunesys is in phase 1 of 3 (inter-node), tune 4 of 39. • Only one tunesys task can be active at a time. A dry run can be performed while tunesys is active.
~~PAGE 654~~
tunetpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the tunevv command in the future. If Virtual Volumes (VVs) were created with deprecated commands then only deprecated commands can be used to modify VVs. The tunetpvv command allows the RAID and Availability characteristics of an exiting Thin Provisioned Virtual Volume (TPVV) to be dynamically modified.
~~PAGE 655~~
Specifies an existing VV name. RESTRICTIONS • This command requires an HP 3PAR Dynamic Optimization license. Contact your local HP 3PAR representative for information. • This command requires sufficient available physical space with the same owner or backup node as the space it is being copied from. EXAMPLES The following example shows how to use the tunetpvv command to change the RAID type of a TPVV (testvol) from cpg1, which is originally cpg1, which is of RAID 1. Task 1 started.
~~PAGE 656~~
tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with either the createvv or createtpvv command by associating it with a different Common Provisioning Group.
~~PAGE 657~~
The following options can be used when the subcommand is specified: -tpvv Indicates that the virtual volume should be converted to a Thinly-Provisioned Virtual Volume. Cannot be used with the -full option. -full Indicates that the virtual volume should be converted to a fully-provisioned virtual volume. Cannot be used with the -tpvv option. -keepvv Indicates that the original logical disks should be saved under a new virtual volume with the given name.
~~PAGE 658~~
31 Update Commands updatesnapspace DESCRIPTION The updatesnapspace command starts a non-cancelable task to update the snapshot space usage accounting. The snapshot space usage displayed by showvv -snapspace is not necessarily the current usage and the TimeCalculated column will show when it was last calculated. This command causes the system to start calculating current snapsnot space usage. If one or more VV names or patterns are specified, only the specified VVs will be updated.
~~PAGE 659~~
The following example displays the task information using –d : cli% showtask –d 2 Id Type Name Status Phase Step ----------StartTime-------- ---------FinishTime--------2 snapspace_accounting ss_accounting Done 0/0 0/0 Thu Sep 22 18:43:35 PDT 2005 Thu Sep 22 18:43:35 PDT 2005 Detailed {Thu Sep {Thu Sep VVs {Thu Sep {Thu Sep {Thu Sep {Thu Sep status: 22 18:43:35 PDT 2005} Created 22 18:43:35 PDT 2005} Started 22 22 22 22 18:43:35 18:43:35 18:43:35 18:43:35 PDT PDT PDT PDT 2005} 2005} 2005} 2005}
~~PAGE 660~~
updatevv DESCRIPTION The updatevv command updates a snapshot Virtual Volume (VV) with a new snapshot. SYNTAX updatevv [options] ... AUTHORITY Super, Edit, Browse Any role granted the vv_update right OPTIONS –ro Specifies that if the specified VV () is a read/write snapshot the snapshot’s read-only parent volume is also updated with a new snapshot if the parent volume is not a member of a virtual volume set.
~~PAGE 661~~
NOTES • The updatevv command attempts to use the same VV IDs for new snapshots as the snapshots that they replace so that the new VV have the same World Wide Names (WWNs) as the originals (this might be important for hosts using the VV WWN to identify the VV). However, between the removal of the original snapshot and the creation of the new snapshot it is possible that another VV might have been created with the same ID causing the creation of the new snapshot to fail.
~~PAGE 662~~
32 Upgrade Commands upgradecage DESCRIPTION The upgradecage command downloads new firmware into the specified cage. SYNTAX The syntax for the upgradecage command can be one of the following: • upgradecage [options ] ... • upgradecage [options ] -a AUTHORITY Super, Service Any role granted the cage_upgrade right NOTE: You need access to all domains in order to run this command.
~~PAGE 663~~
RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays a cage with firmware level of 4.41 upgrading to 4.42: cli% upgradecage –a Upgrading cage cage0 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05. Upgrading cage cage1 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05. Upgrading cage cage2 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05.
~~PAGE 664~~
upgradepd DESCRIPTION The upgradepd command upgrades the Physical Disk (PD) firmware. SYNTAX upgradepd [-f] [-skiptest] {-a | -w ... | ...} AUTHORITY Super, Service Any role granted the pd_upgrade right NOTE: You need access to all domains in order to run this command. OPTIONS –f Upgrades the PD firmware without requiring confirmation. –skiptest Skips the 10 second diagnostic test normally completed after each PD upgrade.
~~PAGE 665~~
33 Wait Command waittask DESCRIPTION The waittask command asks the CLI to wait for a task to complete before proceeding. The command automatically notifies you when the specified task is finished. SYNTAX The syntax for the waittask command can be one of the following: waittask –v waittask [...] AUTHORITY Super, Service, Edit, Browse Any role granted the task_wait right OPTIONS –v Displays the detailed status of the task specified by as it executes.
~~PAGE 666~~
~~34 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.~~
~~PAGE 667~~
For information about: See: Migrating data from one HP 3PAR storage system to another HP 3PAR-to-3PAR Storage Peer Motion Guide Configuring the Secure Service Custodian server in order to monitor and control HP 3PAR storage systems HP 3PAR Secure Service Custodian Configuration Utility Reference Using the CLI to configure and manage HP 3PAR Remote Copy HP 3PAR Remote Copy Software User’s Guide Updating HP 3PAR operating systems HP 3PAR Upgrade Pre-Planning Guide Identifying storage system components
~~PAGE 668~~
For information about: See: Planning for HP 3PAR storage system setup Hardware specifications, installation considerations, power requirements, networking options, and cabling information for HP 3PAR storage systems HP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7000 Storage Site Planning Manual HP 3PAR StoreServ 7450 Storage Site Planning Manual HP 3PAR 10000 storage systems HP 3PAR StoreServ 10000 Storage Physical Planning Manual HP 3PAR StoreServ 10000 Storage Third-Party Rack Physic
~~PAGE 669~~
Typographic conventions Table 8 Document conventions Convention Element Bold text • Keys that you press • Text you typed into a GUI element, such as a text box • GUI elements that you click or select, such as menu items, buttons, and so on Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values • Code variables • Command variables Bold monospace text • Commands you enter into a command line interface • System
~~PAGE 670~~
35 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
~~PAGE 671~~
Index Symbols (brackets) optional elements, 11 (ellipsis), multiuse option specifier, 11 (parentheses), grouped elements, 11 A access user information about, 497 active VLUN, 503 add virtual volume to group, 51 addsnmpmgr, 42, 640 admin volume, 484 admithw, 44 admitpd, 46 admitrcopylink, 48 admitrcopytarget, 50 admitrcopyvv, 51 alerts removing from system, 228 service, registered SNMP software for, 473 system removing preregistered SNMP software, 244 status of, 350 status of, setting, 271 using addsnmpmgr
~~PAGE 672~~
createsv to, 137 createtemplate, 139 createtpvv, 145 createuser, 149 createvlun, 151 createvv, 154 createvvcopy, 158 createvvset, 162 creating domains, 115 creating new system hosts, 121 creating new users, 149 creating provisioned virtual volumes, 154 creating templates, 139 creating, 115 drive cages identifying, 206 information about, displaying, 361 drive magazines taking on- or off- loop, 83 D F data services starting on logical disk, 580 virtual volume, starting, 585 databases, current firmware lev
~~PAGE 673~~
system configuration, displaying, 386 VLUN template conflicts and, 122 I I/O statistics logical disks, 602 physical disks, 607 ports, 612 virtual volumes, 629 identify primary and secondary storage servers, 129 identifying drive cages, 206 IP address, specifying SNMP additions, 42 N Nearline drives, 174 new users, creating, 149 nodenames, 23 nodes CPU statistics for, 594 date and time, setting, 291 EEPROM log information, 378 system, shutting down, 530 O kernel build text, 23 kernel version number, 23
~~PAGE 674~~
group, 240 link, 165 target designation, 242 virtual volume from group, 168 removealert, 228 removeaocfg, 230 removecpg, 231 removedomain, 233 removedomainset, 234 removehost, 235 removehostset, 237 removeld, 238 removercopygroup, 240 removercopytarget, 242 removesched, 243 removesnmpmgr, 244 removesnmppw, 246 removespare, 248 removesshkey, 250 removetask, 251 removetemplate, 253 removeuser, 254 removeuserconn, 255 removevlun, 256 removevv, 258 removing hosts, 235 removing users, 254 removing virtual volume
~~PAGE 675~~
showrctransport, 464 showrsv, 469 showsched, 471 showsnmpmgr, 473 showsnmppw, 474 showspace, 476 showspare, 479 showsys, 481 showsysmgr, 486 showtarget, 488 showtask, 490 showtemplate, 494 showtoc, 495 showtocgen, 496 showuser, 497 showuseracl, 499 showuserconn, 500 showversion, 502 showvlun, 503 showvv, 506 showvvmap, 521 showvvpd, 523 showvvset, 527 showwsapi, 529 shutdownnode, 530 shutdownsys, 533 shutting down system nodes, 530 snapshot volumes (copies), creating, 137 SNMP access removing passwords for,
~~PAGE 676~~
Thinly Provisioned Virtual Volume (TPVV), length limit, 12 time and date for system nodes, 373 setting nodes, 291 traps removing preregistered SNMP software, 244 using addsnmpmgr for, 42 tunealdvv, 642 tunepd, 647 tunetpvv, 651 tunevv, 656 U updatesnapspace, 658 updatevv, 660 upgradecage, 662, 665 upgradepd, 664 upgrades, firmware levels, 384 upgrading physical disk firmware, 664 users changing passwords, 309 information about, 497 new, creating, 149 removing, 254 V validity checks logical disk data, 59 o