HP 3PAR Command Line Interface Reference HP 3PAR OS 3.1.3 Abstract This reference describes the HP 3PAR Command Line Interface (CLI) commands that are used to administer and maintain the HP 3PAR storage system.
© Copyright 2013–2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 CLI Command Syntax and Conventions.......................................................11 Syntax and Conventions..........................................................................................................11 Syntax Rules...........................................................................................................................11 Glob-Style Pattern...................................................................................................................
Virtual LUN (Export) Statistics...............................................................................................28 Virtual Volume Statistics......................................................................................................28 Remote Copy Volume Statistics.............................................................................................28 Preserved Data Commands......................................................................................................
8 CLI Command..........................................................................................73 cli.........................................................................................................................................73 9 Compact Commands................................................................................77 compactcpg...........................................................................................................................77 compactld................
16 Import Command..................................................................................187 importvv..............................................................................................................................187 17 Locate Commands................................................................................189 locatecage..........................................................................................................................189 locatenode......................
setbattery............................................................................................................................266 setcage...............................................................................................................................268 setcim.................................................................................................................................270 setclienv........................................................................................
showinventory......................................................................................................................382 showiscsisession...................................................................................................................383 showld................................................................................................................................385 showldch................................................................................................
25 System Reporter (SR) commands ............................................................527 sraomoves...........................................................................................................................527 srcpgspace..........................................................................................................................529 srhistld................................................................................................................................
29 Sync Command....................................................................................646 syncrcopy............................................................................................................................647 30 Tune Commands..................................................................................649 tunepd................................................................................................................................649 tunesys........................
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]]... [...][...
• User supplied input is identified by angled brackets (< >). • Unless noted otherwise, valid character formats include alphanumeric characters, periods, dashes, and underscores.
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 ({ }).
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.
To determine whether or not the user space of the virtual volume is provisioned from a CPG, use the "showvv -cpgalloc" command.
• @l@ - Hour in 12-hour format, without leading zeros (1 - 12). • @m@ - Month number (01 - 12). • @M@ - Minute (00 - 59). • @p@ - AM/PM indicator. • @s@ - Count of seconds since the epoch, expressed as a decimal integer. • @S@ - Seconds (00 - 59). • @u@ - Weekday number (Monday = 1, Sunday = 7). • @U@ - Week of year (00 - 52), Sunday is the first day of the week. • @V@ - Week of year according to ISO-8601 rules. Week 1 of a given year is the week containing 4 January.
SYNTAX See Section (page 11). OPTIONS This section lists the available options you can use in conjunction with the command for varied results. Some options and their specifiers are required, as indicated in the syntax, whereas some are provided to increase the level and functionality of your output. SPECIFIERS Specifies a suggested input required by the user. RESTRICTIONS This section includes any restrictions that must be followed in order to achieve maximum results.
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 97) removeaocfg Removes specified AO configurations from the system.
Disk Enclosure Management Commands Drive Cage Management Command Description Authority For Details See locatecage Locates a particular drive cage. Super, Service1 “locatecage” (page 189) 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 268) Any role granted the cage_set right. “showcage” (page 350) You need access to all domains in order to run this command.
Command Description Authority For Details See temporary location selected Any role granted the by the system. pd_move right. setpd Marks physical disks as Super, Service1 allocatable for logical disks. “setpd” (page 298) showpd Displays physical disks in the Any role in the system. system. “showpd” (page 411) 1 You need access to all domains in order to run this command. Domain Management Commands Command Description changedomain Changes the currentdomain Any role in the system.
1 You need access to all domains in order to run this command. Health and Alert Management Commands Alerts Command removealert Description Authority For Details See 1 Removes one or more alerts. Super, Service “removealert” (page 213) Any role granted the alert_remove right. setalert showalert 1 Sets the status of system alerts. Super, Service1 Displays system alerts. Any role in the system. “setalert” (page 259) Any role granted the alert_set right.
Help and Utility Commands Command Description Authority For Details See cli Provides a means to set up your CLI session or to enter directly into a CLI shell. Super, Edit, Browse, Service “CLI Command” (page 73) clihelp Lists all commands or details Super, Edit, Browse, Service for a specified command. cmore Pages the output of commands. help Lists all commands or details Super, Edit, Browse, Service for a specified command. setclienv Sets the CLI environment parameters.
LDAP Management Commands Command Description Authority For Details See setauthparam Sets the authentication parameters. Super Any role granted the authparam_set right. “setauthparam” (page 262) showauthparam Shows authentication parameters and integrates the authentication and authorization features using LDAP. Any role in the system. “showauthparam” (page 342) checkpassword Supports authentication and Super, Edit, Browse, Service “checkpassword” (page 62) authorization using LDAP.
Node Date Information Command Description Authority For Details See setdate Sets the system time and date on all nodes. Super, Service1 “setdate” (page 279) Displays the date and time on all system nodes. Any role in the system. showdate 1 Any role granted the date_set right. “showdate” (page 363) You need access to all domains in order to run this command.
1 You need access to all domains in order to run this command. Network Interface Configuration Command setnet shownet 1 Description Authority For Details See 1 Sets the administration network interface configuration. Super, Service Displays the network configuration and status. Any role in the system. “setnet” (page 290) Any role granted the net_set right. “shownet” (page 398) You need access to all domains in order to run this command.
1 You need access to all domains in order to run this command. Battery Management Command setbattery Description Sets battery properties. Authority For Details See 1 Super, Service “setbattery” (page 266) Any role granted the battery_set right. showbattery 1 Displays battery status information. Any role in the system. “showbattery” (page 343) You need access to all domains in order to run this command.
Data Cache Memory Statistics Command Description Authority For Details See statcmp Displays statistics for cache memory pages. Any role in the system. “statcmp” (page 599) Command Description Authority For Details See statcpu Displays statistics for CPU use. Any role in the system. “statcpu” (page 601) Command Description Authority For Details See histld Displays histogram data for Any role in the system. logical disks.
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 649) tunesys Analyzes disk usage and adjusts resources. Super, Edit Any role granted the sys_tune right. “tunesys” (page 653) Command Description Authority For Details See tunevv Changes the layout of a virtual volume.
Replication Commands Physical Copy Command Description Authority For Details See creategroupvvcopy Creates consistent group physical copies of a list of virtual volumes. Super, Edit Any role granted the groupvvcopy_create right. “creategroupvvcopy” (page 110) createvvcopy Copies a virtual volume. Super, Edit Any role granted the vvcopy_create right. “createvvcopy” (page 148) promotevvcopy Promotes a physical copy back to a base volume. Super, Edit Any role granted the vvcopy_promote right.
Command Description Authority For Details See dismissrcopytarget Dismisses a Remote Copy target from a Remote Copy volume group. Super, Edit “dismissrcopytarget” (page 157) dismissrcopyvv Dismisses a virtual volume Super, Edit from a Remote Copy volume Any role granted the group. rcopyvv_dismiss right. removercopygroup Removes a group used for Remote Copy. Super, Edit Any role granted “removercopygroup” the rcopygroup_remove (page 225) right.
1 You need access to all domains in order to run this command. Virtual Copy Command Description Authority createsv Creates snapshot volumes. Super, Edit For Details See Any role granted the sv_create right. creategroupsv Creates consistent group snapshots of a list of virtual volumes. Super, Edit “creategroupsv” (page 108) Any role granted the groupsv_create right. promotesv Copies the differences of a Super, Edit virtual copy back to its base Any role granted the volume. sv_promote right.
1 You need access to all domains in order to run this command. Node Command servicenode Description Authority For Details See 1 Prepares a node for service. Super, Service “servicenode” (page 257) Any role granted the node_service right. 1 You need access to all domains in order to run this command. General System Maintenance Command Description Authority For Details See 1 shutdownnode Shuts down an individual system node. Super, Service Any role granted the node_shutdown right.
SNMP Agent Commands Command Description addsnmpmgr Adds an SNMP manager to Super1 receive trap notifications. Any role granted the snmpmgr_ad right. “addsnmpmgr” (page 43) checksnmp Allows a user to send an SNMPv2 test trap to the list of managers Super, Service Any role granted the snmp_check right “checksnmp” (page 71) removesnmpmgr Removes an SNMP trap manager. Super1 “removesnmpmgr” (page 229) Removes an SNMP password. Super1 removesnmpuser Removes an SNMP user.
Command Description showsralertcrit Displays the criteria that Any role in the system. System Reporter evaluates to determine if a performance alert should be generated. “showsralertcrit” (page 472) sraomoves Shows the space that Any role in the system. Adaptive Optimization (AO) has moved between tiers. “sraomoves” (page 527) srcpgspace Displays historical space Any role in the system. data reports for common provisioning groups (CPGs).
Command Description Authority For Details See srstatport Displays historical Any role in the system. performance data reports for ports. “srstatport” (page 566) srstatqos Displays historical Any role in the system. performance data reports for QoS rules. “srstatqos” (page 569) srstatvlun Displays historical Any role in the system. performance data reports for VLUNs. “srstatvlun” (page 578) srvvspace Displays historical space data reports for virtual volumes (VVs). Any role in the system.
Command Description Authority For Details See movepdtospare Moves specified physical disks to spare. Super, Service, Edit1 “movepdtospare” (page 200) Moves chunklets relocated from a physical disk to another physical disk. Super, Service1 Removes spare chunklets. Edit, Service1 moverelocpd removespare Any role granted the pd_movetospare right. “moverelocpd” (page 202) Any role granted the pd_movereloc right. “removespare” (page 233) Any role granted the spare_remove right.
User Management Commands Command Description Authority For Details See createuser Creates user accounts. Super1 “createuser” (page 139) Any role granted the user_create right. removeuser Removes user accounts. Super1 “removeuser” (page 240) Any role granted the user_remove right. removeuserconn Removes user connections. Super1 “removeuserconn” (page 241) Any role granted the userconn_remove right. setpassword Changes your password.
Volume Management Commands Common Provisioning Group Management Command Description compactcpg Consolidates logical disk Super, Edit 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 77) “createcpg” (page 101) Any role granted the cpg_create right.
Command Description sethost Sets properties on existing Super, Edit1 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 284) sethostset Sets the parameters and modifies the properties of a host set. “sethostset” (page 287) 1 Authority For Details See Super, Edit Any role granted the hostset_set right.
Command Description Authority For Details See showspace Displays estimated free space. Any role in the system. “showspace” (page 467) showvvmap Displays virtual volume to logical disk mapping. Any role in the system. “showvvmap” (page 512) showvvpd Displays virtual volume distribution across physical disks. Any role in the system.
Command Description Authority For Details See growvv Increases the size of a virtual Super, Edit1 volume by adding logical Any role granted the disks. vv_grow right. “growvv” (page 161) importvv Migrates data from a remote Super, Service, Edit LUN to the local HP 3PAR Any role granted the Storage System. vv_import right. “importvv” (page 187) removevv Removes virtual volumes or logical disks from common provisioning groups.
1 You need access to all domains in order to run this command. Virtual LUN (Export) Management Command Description Authority For Details See createvlun Creates a virtual volume as a SCSI LUN. Super, Edit Any role granted the vlun_create right. “createvlun” (page 141) removevlun Removes VLUNs. Super, Edit Any role granted the vlun_remove right. “removevlun” (page 242) showvlun Displays VLUNs in the system. Any role in the system.
3 Add Command addsnmpmgr DESCRIPTION The addsnmpmgr command adds an SNMP manager to receive alert (traps) notifications. 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. This option is used if the port number differs from the default of 162.
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 44 • The HP 3PAR storage system does not support any form of name resolution.
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. nopatch Suppresses the check for drive table update packages for new hardware enablement.
• 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.
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.
• Verify the admittance of physical disk definitions by issuing the showpd command. See “showpd” (page 411). • 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.
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.
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. • 50 ◦ For IP targets, the list consists 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.
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 must have access to all domains to run this command. OPTIONS None SPECIFIERS Specifies the name of the target that was previously created with the creatercopytarget command.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 • 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.
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.
setauthparam command has been used to change parameters or data in the LDAP server has changed since the user last logged in. • The showuserconn command can be used to verify the authorization levels assigned at login.
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.
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.
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.
NOTES • 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.
checkrclink DESCRIPTION The checkrclink command performs a connectivity, latency, and throughput test between two connected HP 3PAR storage systems. SYNTAX • checkrclink startclient
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.
c. (Optional) To end the test before it completes, on SystemA, issue the following command: # checkrclink stopclient d.
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.
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.
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.
-nocertprompt Do not prompt user for CLI server certificate which is not verified. The cli exits with an error message. The default is to prompt user. –sys Connect to system named . When this option is not used, the CLI uses the value of the TPDSYSNAME environment variable. When the TPDSYSNAME environment variable is not set, the CLI prompts you for the system name. –pwf Specifies the password file that contains the user name and encrypted password.
Any CLI command. This specifier is not required when issuing the cli command. If commands are specified, the CLI exits after executing the commands unless the -cmdloop option is specified. If no commands are specified in the command line, CLI enters the command loop. RESTRICTIONS None EXAMPLES The following example displays the CLI client version: $ cli –v CLI client version: 3.1.
System to connect to. Overridden by-sys option. TPDPWFILE Password file containing username and password Overridden by -pwf option. TPDCACHEDIR Directory in which to cache the client bytecode. TPDSTARTFILE File containing code that is executed before any command line commands are executed or the interactive command loop is entered. This file normally contains customization scripts TPDHAFTER Number of lines after which the header is printed again. Overridden by the -hafter option.
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.
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 78 • 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.
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.
EXAMPLES In the following example, logical disk pdsld0.0 is compacted: cli% compactld -f pdsld0.0 Compacting LDs: pdsld0.
10 Control Commands controlencryption DESCRIPTION The controlencryption command provides various options to control data encryption.
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.
controliscsiport DESCRIPTION The controliscsiport command is used to set properties of an iSCSI port.
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.
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.
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: 86 • Relocation of chunklets. • Affected logical disks are put into write-through mode. • Momentary dip in throughput, but no loss of connectivity.
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.
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.
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. The controlport rcip and controlport rcfc commands are required for setting up remote-copy interfaces. 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] ...
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.
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.
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.
5 seconds. If neither -w nor -c is present, the timeout is the default value for the count (1 second) plus 5 seconds, or 6 seconds. The maximum value is 30 seconds. –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.
Specifies the PCI bus slot in the specified node using a number between 0 and 5. 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.
• For quad-port LSI Fibre Channel adapters, each ports pair (ports 1 and 2, ports 3 and 4) must use the same mode. • Changing the mode of one port in a pair (for example, from initiator to target) causes the other port in the pair to undergo a mode change as well. CAUTION: Use caution when changing modes for ports in LSI Fibre Channel adapters. Changing the mode of one port in a pair (for example, from initiator to target) causes the other port in the pair to undergo a mode change.
NOTES 96 • The ct, cl2, or rate subcommands automatically resets the port for the changes to take effect. • Issue the showport command with either the –i or –par options to verify the success of the controlport command. See “showport” (page 431) • Resetting a port causes a momentary dip in throughput, but no loss of connectivity. • The -f option forces the operation. Without the flag, the command prompts for confirmation.
11 Create Commands 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.
The following example creates a new AO configuration called aocfg2. The optimization bias defaults to Balanced, and no Tier 1 CPG is specified.
createcert DESCRIPTION The createcert command creates the SSL certificate for the storage system. AUTHORITY • Super SYNTAX createcert [-f] [-keysize ][-days ] [subject attribute options] OPTIONS –f Creates a self-signed certificate and restarts the services that use the new certificate without prompting user. When this option is not used, user is prompted before a self-signed certificate is created and the corresponding services are restarted.
EXAMPLES The following example shows how to create a self-signed certificate. The encryption key size is 2048 bits and the certificate is valid for 365 days. The common name (CN) attribute of the certificate subject will be determined by the model name and the serial number of the storage system. cli% createcert -days 365 NOTES Use the showcert command to display the certificate information. See “showcert” (page 354).
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.
–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).
–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.
–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.
NOTES • 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.
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.
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.
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.
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.
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.
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.
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] [...
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.
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.
To create a host set with a comment and a host in it: cli% createhostset -comment “A host set” oraset ora1 NOTES None createhostset 115
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 :...
If you are using domains, the syntax is as follows: cli% creatercopygroup -domain domain2 Group1 System2_out:periodic If you are using volume auto-create: cli% creatercopygroup -usr_cpg Localcpg target:Targetcpg -snp_cpg Localsnp target:Targetsnp groupname target:periodic NOTES When a Remote Copy group is created, a VV set will also be created. Its name will be the remote copy group's name prepended with RCP_, with numbers appended if necessary to make the set name unique.
creatercopytarget DESCRIPTION The creatercopytarget command creates a remote-copy target definition. SYNTAX • 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 []... AUTHORITY • Super, Edit • Any role that is granted the rcopytarget_create right.
The following example creates a primary target definition named System1 on the backup system, where the node numbers of the Ethernet ports on the backup system 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.
createsched DESCRIPTION The createsched command allows users to schedule tasks that are periodically run by the scheduler. SYNTAX createsched [options] AUTHORITY • Super, Service, Edit • 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.
The following example creates a scheduled task that will run every hour on the hour ("0 * * * *") and will create a read-only (-ro) snapshot of sample_vv, that will expire in two hours (-exp 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@.
• 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.
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.
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.
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 470) for more information.
createsralertcrit DESCRIPTION The createsralert command creates a criterion that System Reporter evaluates to determine if a performance alert should be generated. SYNTAX createsralertcrit [options ] [,...] AUTHORITY • Super, Service • Any role that is granted the sralertcrit_create right. OPTIONS NOTE: Many of these options are dependent upon the type specifier, below.
Ports with :: that match any of the specified :: patterns are included, where each of the patterns is a glob-style pattern. If not specified, all ports are included.
-disk_type [,...] Limit the data to disks of the types specified. Allowed types are: • FC - Fibre Channel • NL - Nearline • SSD - Solid State Drive -pd | 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.
sum_total_iops, sum_read_kbps, sum_write_kbps, sum_total_kbps, limit_iops, limit_kbps, read_wait, write_wait, total_wait, rej, wait_qlen Options specific to the rcopy type —target [,...] Limit the data to that corresponding to one of the specified RC targets. Fields applicable to the rcopy type rc_kbs, rc_kbps, rc_hbrttms, Options specific to the rcvv type -vv [,...
EXAMPLES The following example describes a criterion that generates an alert for each port that has more than 50 write IOPS in a high resolution sample: cli% createsralertcrit port write_iops>50 write_port_check The following example describes a criterion that generates an alert for each port that has more than 10000 write IOPS in a high resolution sample if the sum of all write IOPS for all ports exceeds 50000: cli% createsralertcrit port write_iops>10000,sum_write_iops>50000 write_port_check The followi
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 • Any role that is granted the sv_create right. OPTIONS –ro Specifies that the copied volume is read-only.
block host I/O to the parent virtual volume during snapshot creation. This option is only applicable for read-only snapshots. 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.
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.
–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.
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.
–size [g|G|t|T] Specifies the size of the virtual volume and logical disk in megabytes. Size can be specified in megabytes (default) or in gigabytes by using the g|G parameter and 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). –szs [g|G|t|T] By default, specifies the size of the snapshot volume in megabytes using an integer from 0 through 2096128(2047 GB).
-snp_cpg The name of the CPG from which the snapshot space is allocated. -snp_aw Provides a snapshot space allocation warning. Generates a warning alert when the snapshot space of the virtual volume exceeds the specified percentage of the virtual volume size. -snp_al Provides a snapshot space allocation limit. The snapshot space of the virtual volume is prevented from growing beyond the indicated percentage of the virtual volume size.
RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example creates a virtual volume template called vvr1. The –ha and –pol option values are fixed. The RAID type can be changed when the virtual volume is created. Note that if patterns are specified, it is not possible to mix read-only and read/write pattern specifications. cli% createtemplate vv -ha mag -rw -t r1 -ro -pol stale_ss vvr1 The command rejects the pattern.
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.
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 • 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 488) for more information.
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.
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.
• Verify the creation of VLUNs by issuing the showvlun command. See “showvlun” (page 494) 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.
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.
Do not ask for confirmation before creating a volume with retention time (-retain). -retain
-snp_cpg Specifies the name of the CPG from which the snapshot space is allocated. -snp_aw Enables a snapshot space allocation warning. A warning alert is generated when the reserved snapshot space of the VV exceeds the indicated percentage of the VV size. -snp_al Sets a snapshot space allocation limit. The snapshot space of the VV is prevented from growing beyond the indicated percentage of the VV size.
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.2 1g The following example creates 2 VVs vva.0 and vva.1 which may share LDs: cli% createvv -cnt 3 cpg1 vv1.
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.
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.
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
• 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.
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.
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.
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.
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.
NOTES 156 • 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.
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.
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 must have access to the domain of the specified group () to run this command. OPTIONS -f Does not ask for confirmation for the dismissrcopyvv command.
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.
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.
14 Grow Commands 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 must have access to the domain of the specified group () 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.
the local and remote volumes can be grown by the requested amount. If this succeeds, all the volumes are grown; however, if other volumes are grown during this process, it is possible that remote volumes are grown and the local volume is not. If this occurs, remote volumes must be grown manually before the group can be started.
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.
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.
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.
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 ...|...
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.
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.
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).
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.
• ◦ 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.
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.
EXAMPLES The following example displays a histogram of service times for all physical disks and shows the columns from 8ms to 8192 ms.
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.
–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.
• ◦ 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.
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.
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.
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.
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 ...|...
–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.
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.
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).
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.
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.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.
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.
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@.
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.
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).
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.
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.
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.
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.
• remote_pds_used. Remote PDs used. • ldpattern_not_obeyed. LD pattern was not obeyed. • raid_availability_reduced. RAID availability reduced. NOTES • 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.
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.
• 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.
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.
NOTES • 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.
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.
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.
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.
-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.
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.
• 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.
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.
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.
19 Promote Commands promotegroupsv DESCRIPTION The promotegroupsv command copies the differences of snapshots back to their base volumes, allowing you to revert the base volumes to an earlier point in time. SYNTAX promotesv [options] [:]... AUTHORITY • Super, Edit • Any role granted the svgrp_promote right. OPTIONS –rcp Allows the promote operation to proceed even if the RW parent volume is currently in a Remote Copy volume group, if that group has not been started.
EXAMPLES The following example illustrates how virtual volumes vv1 and vv2 can be promoted with the differences from their base volume: cli% promotegroupsv vv1 vv2 NOTES • A promote to a parent of larger size will include zeroing the additional capacity of the parent in order to correctly represent the data from the smaller virtual copy. Such zeroing activity will proportionally increase the duration of the promote task.
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 virtual volume family tree. The default is to copy the differences to the base volume.
RESTRICTIONS • The virtual copy and its base volume must not be exported. • Only one promote operation is allowed at a time within a VV family tree. EXAMPLES The following example illustrates how virtual volume vv1 can be promoted with the differences from its base volume: cli% promotesv vv1 NOTES • A promote to a parent of larger size will include zeroing the additional capacity of the parent in order to correctly represent the data from the smaller virtual copy.
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.
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.
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".
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.
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.
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.
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.
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. ...
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.
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.
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. ...
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.
• 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 391) for additional information. EXAMPLES The following example removes logical disk nf_vv_1.0.usr.1: cli% removeld -f nf_vv_1.0.usr.
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.
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: # removercopygroup -keepsnap group1 The following example removes Group1 and associated volumes from the local system and removes the corresponding volumes on all the
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 must have access to all domains to run this command. OPTIONS -cleargroups Remove all groups that have no other targets or dismiss this target from groups with additional targets.
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.
removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP managers from receiving alerts (traps). 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. If not specified, the port number defaults to 162.
NOTES • SNMP managers are registered by issuing the addsnmpmgr command. See “addsnmpmgr” (page 43) for additional information. • Verify the removal of SNMP managers by issuing the showsnmpmgr command. See “showsnmpmgr” (page 464) for more information.
removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. 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. If not specified, the read/write community string password is removed.
removesnmpuser DESCRIPTION The removesnmpuser command allows a user to remove an SNMPv3 user. 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.
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.
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 470) 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.
removesralertcrit DESCRIPTION The removesralertcrit command removes a criterion that System Reporter evaluates to determine if a performance alert should be generated. SYNTAX removesralertcrit [options ]| AUTHORITY • Super, Service • Any role granted the sralertcrit_remove right OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all criteria matching the specified pattern are removed.
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.
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.
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. However, task IDs are not recycled, so the next task started on the system uses the next whole integer that has not already been used. Task IDs roll over at 29999.
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.
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.
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.
removevlun DESCRIPTION The removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN) export definition from the system.
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.
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.
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.
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. ...
removewsapisession DESCRIPTION The removewsapisession command removes the WSAPI user connections from the current system. SYNTAX removewsapisession [options] AUTHORITY • Super • Any role granted the wsapisession_remove right OPTIONS -pat Specifies that the , , and specifiers are treated as glob-style (shell-style) patterns and all WSAPI user connections matching those patterns are removed.
To remove a single VV from a set: cli% removevvset vvset vv1 NOTES Because user connections can disappear from the time they are listed and the time they are removed, the removewsapisession command continues past errors while removing individual connections if the -pat option is specified.
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.
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.
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.
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.
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.
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.
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.
... 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.
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.
EXAMPLES In the following example, fan 1 on node 3 is put into servicing-mode: cli% servicenode -fan 1 3 NOTES None 258 Service Commands
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 ...
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.
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.
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.
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.
Table 3 Values for setauthparam Specifiers (continued) be specified using multiple arguments. It is mutually exclusively with the groups-dn variable. 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.
Table 5 Values for Specifiers and (continued) can be specified using multiple arguments. A value of “ * ” matches any group name. service-map Same as super-map, but for the Service level. 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.
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.
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 343) for information about the showbattery command.
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.
NOTES • The parameters specified by the setcage command appear in the showcage –d output (see “showcage” (page 350)). • The power supply model cannot be modified if the information is automatically retrieved from the system.
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.
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.
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.
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.
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.
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.
–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).
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).
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.
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 -f Specifies that the command is forced.
RESTRICTIONS • Access to all domains is required to run this command. • Specifiers must be provided in one of the combinations listed as follows when issuing the setdate command: • MMDDhhmm • MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY.ss EXAMPLES The following example shows the timezone being set: Timezone set successfully.
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.
NOTES For moving objects into a domain, use the movetodomain command.
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.
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.
-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.
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.
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.
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.
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.
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.
Specifies that the network interface is set to the specified speed and duplex as indicated with the andspecifiers. 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.
Specifies a new prefix_len to which the system is configured. This specifier is used in conjunction with the and specifiers. This specifier can only be used when is of IPv6 type and can only be used with the startaddr and addaddr subcommands. Specifies the IP address of the new gateway for the system. This specifier can only be used with the startgateway subcommand.
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.
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.
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.
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.
The following example displays the prompts encountered when changing a user’s (user1) password: cli% setpassword –u user1 password: Old password: NOTES • 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. • Without any options, the command will prompt to change the invoking user's password on the system.
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 ...
setqos DESCRIPTION The setqos command creates and updates QoS rules in a system. SYNTAX setqos [options] [{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY • Super, Edit • Any role granted the qos_set right can set QoS configurations. OPTIONS -pri {high|normal|low} Set the QoS scheduling priority of the QoS rule (of this target object). The default priority is normal. -io {none|[{}-]} Sets the I/O issue count min goal and max limit for QoS throttling.
EXAMPLES The following example sets the IOPs Min Goal and Max Limit of vvset vsa to 300: cli% setqos -io 300 vvset:vsa The following example turns off the QoS scheduling for vvset vsa: cli% setqos -off vvset:vsa The following example removes all QoS settings of all vvsets: cli% setqos -clear vvset:* NOTES Maximum limit — this is the maximum amount of IOPS or bandwidth, or both, which a given VVset or Domain is allowed to achieve.
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.
Specifies how frequently the remote-copy system takes group-based coordinated snapshots on both the primary system and the secondary system in asynchronous periodic mode. mode Specifies the mode to which the volume group is set. cpg Specifies the local and target cpg. 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.
Specifies not to check a group's other targets to see if newer data should be pushed from them if the group has multiple targets. The use of this option can result in the loss of the most recent changes to the group's volumes and should be used carefully. This option is only valid for the failover specifier. –nopromote This option is only valid for the failover and reverse specifiers.
SPECIFIERS Specifies a glob-style pattern. If this specifier is not used, the or specifier must be used. Specifies the policy to assign to the group. Valid policies are: • auto_failover Configure automatic failover on a remote-copy group. This feature will perform an automatic failover on a remote-copy group when used in conjunction with the Quorum Witness functionality. Secondary volumes will be subject to a remote-copy failover operation.
Specifies the mode, sync or periodic, to which the group is set. This specifier can only be used with the mode subcommand. s|m|h|d Specifies the time period in units of seconds (s), minutes (m), hours (h), or days (d), for automatic resynchronization (for example, 14h for 14 hours). For the asynchronous mode, this value is used to specify the time period for automatic resynchronization.
The following example sets volume groups that start with the name testgroup to synchronize to its asynchronous periodic mode target System2 every 30 minutes: # setrcopygroup period -pat testgroup* 30m System2 NOTES • An earlier version of this command provided fail_wrt_on_err and no_fail_wrt_on_err policies. These policies were deprecated in HP 3PAR OS release 3.1.1. • An earlier version of this command provided a target subcommand. This subcommand was deprecated in HP 3PAR OS release 2.2.3.
setrcopytarget DESCRIPTION The setrcopytarget command adjusts the characteristics of a target definition.
OPTIONS -remote Used to forward a witness subcommand to the be executed on the remote HP 3PAR Storage System. When used in conjunction with the witness check subcommand the target must be specified when executing on the local storage system target specification is not required to check connectivity with the Quorum Witness. -node Used to conjunction with the witness check subcommand to test the connectivity to the Quorum Witness via the Quorum Announce process running on the specified node.
RESTRICTIONS • This command requires the HP 3PAR Remote Copy Software license. Contact your local service provider for more information. • If the mirror_config policy is set and the setrcopytarget command is issued with the pol subcommand, the duplicated configuration commands cannot be issued on the secondary. Doing so results in an error. • There must be an active connection between the systems in the remote-copy pair in order to issue commands on the primary to be mirrored to the secondary.
change the policy to no_mirror_config in order to bring the configurations into alignment. After being corrected the mirror_config policy should be immediately restored. Such operations should generally only be undertaken on the advice of a HP representative. • 310 The setrcopytarget witness subcommands are provided to locally create and associate a target with a Peer Persistence quorum and to manage the operational state of the quorum.
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.
EXAMPLES None NOTES None 312 Set Commands
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.
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.
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. 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. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) community password is changed.
NOTES 316 • 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 465) for more information.
setsralertcrit DESCRIPTION The setsralertcrit command allows users to enable or disable a System Reporter alert criterion. SYNTAX setsralertcrit {-enable|-disable} AUTHORITY Super, Service Any role granted the sralertcrit_set right. OPTIONS -enable Enables the specified criterion. -disable Disables the specified criterion. SPECIFIERS Specifies the name of the criterion to modify.
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.
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.
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.
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.
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.
Performs the same function as RawSpaceAlertFC, but should be used for solid state drive 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.
AllowR5onNLDrives Enables or disables support for RAID-5 on NL drives. If disabled, new RAID-5 CPGs cannot be created on NL drives. HP strongly recommends RAID-6 for high-capacity NL drives. can be 'yes' or 'no'. The default is 'no'. AllowR0 Enables or disables support for RAID-0. If disabled, new RAID-0 CPGs cannot be created on this system. RAID-0 virtual volumes do not offer data protection. can be 'yes' or 'no'. The default is 'no'.
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.
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.
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 29999.
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
NOTES • All option available for the createcpgcommand 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.
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 :[,:...
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.
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.
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.
specified in days or hours providing either d or D for day and h or H for hours following the entered time value. NOTE: The -retain option requires the HP 3PAR Virtual Lock license. Contact your local service provider for more information. NOTE: If the volume is not in any domain, then its retention time cannot exceed the value of the system's maximum VV retention time. The default value for the system's maximum VV retention time is 14 days.
Indicates a snapshot space allocation warning. Through this option you can generate a warning alert when the reserved snapshot space of the virtual volume exceeds the indicated percentage of the virtual volume size. -snp_al Indicates a snapshot space allocation limit. The snapshot space of the virtual volume is prevented from growing beyond the indicated percentage of the virtual volume size.
The following example modifies the WWN of virtual volume vv1. cli% setvv -wwn 50002AC0001A0024 vv1 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. • It is not possible to rename a virtual volume that is already associated with a Remote Copy group. • Changing the CPG for a TPVV is not allowed.
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.
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.
23 Show Commands showalert 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.
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
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.
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.
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 [,..
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.
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.
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.
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.
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.
NOTES None showblock 349
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.
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.
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
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 ...
showcert DESCRIPTION The showcert command shows SSL certificate information for the storage system. The first form of this command is used to display the certificate in readable format and the second displays the certificate in PEM (Privacy Enhanced Mail) format and also saves the certificate in the specified file in PEM format when —file option is used.
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.
• 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.
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.
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).
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
• 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.
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.
• 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.
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.
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.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.
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 .
Show domain sets containing domains matching the pattern domainset.*: cli% showdomainset -domain domainset.* Id Name Members 7 domainset domainset.1 domainset.
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).
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
• 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.
showencryption DESCRIPTION The showencryption shows Data Encryption information. AUTHORITY • Super, Service • Any role granted the control_encryption_status right SYNTAX showencryption [options] OPTIONS -d Provides details on the encryption status. SPECIFIERS None NOTES If the state shows recovery_needed, the enable or latest rekey operation failed. Re-issue the operation to fix this state. Also see “controlencryption” (page 81).
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.
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.
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
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.
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..
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.
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. ...
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.
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.
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.
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.
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.• iSCSI_Name. The iSCSI name of the host. • StartTime. The time the session was started.
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 ,...).
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.
• 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.
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.
The following example displays policy information about all system LDs: cli% showld -p Id Name Keep_Preserved 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.1 1 1 FC 10 18 tp-0-sd-0.
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.
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.
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 --------------
• 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.
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 394 Show Commands
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.
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.
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.
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.
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 ...
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.
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).
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.
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.
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.
• 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: • • • • ◦ --.
• ◦ 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.
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.
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.
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 Tolerance Tolerance Tolerance Tolerance Tolerance Tolerance Tolerance Node 1 --------...
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.
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.
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.
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).
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.
• 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.
• 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.
• 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.
• 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.
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
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.
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
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.
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.
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.
–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.
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.
NOTES None showpdch 427
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.
–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.
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.
showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX 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. Such devices include cages (for initiator ports), hosts (for target ports) and ports from other storage systems (for RCFC and peer ports).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.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 loss_sync none ready loss_sync none ready ready none loss_sync none ready ready none offline ready none ready loss_sync none ready loss_sync none l
◦ 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.
◦ failed_over Failed over to partner ◦ active The partner port is failed over to this port ◦ active_down The partner port is failed over to this port, but this port is down ◦ failback_pending In the process of failing back from partner The following example displays hardware and connection information about the ports settings: cli% showport -i N:S:P Brand Model Rev Firmware Serial 1:2:1 3PAR FC044X 08 1.02.N.5 00981760001d6187 1:2:2 3PAR FC044X 08 1.02.N.5 00981760001d6187 1:2:3 3PAR FC044X 08 1.02.
• VCN. VLUN State Change Notification support setting. Valid values are n/a, enabled or disabled. When enabled and in public loop or fabric topology, a Registered State Change Notification (RSCN) message is issued to the fabric controller whenever a VLUN is created or removed. • IntCoal. Indicates whether the interrupt coalesce setting is Enabled or Disabled.
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. State of the port. The states are as follows: • ◦ config_wait. The link configuration is waiting. ◦ alpa_wait. The link ALPA is waiting. ◦ login_wait. The link login is waiting. ◦ ready. The link is online and ready for use. Detailed State.
◦ error. Fibre Channel adapter has experienced an unrecoverable error. ◦ non_participate. Port is logically isolated from the FC loop. ◦ offline. The port is offline. • HwAddr. A unique identifier of the port hardware used for remote-copy connection. For an RCIP port, it is the MAC address of the port. • IPAddr. The IP address of the remote-copy interface. • Netmask. Netmask for the Ethernet port. • Gateway. Gateway address for the remote-copy interface. • MTU.
State : Manufacturer : Part Number : Serial Number : Revision : MaxSpeed(Gbps): Qualified : TX Disable : TX Fault : RX Loss : RX Power Low : DDM Support : Degraded PICOLIGHT PL-XPL-VE-S24-31 425EF1E6 N/A 2.10 No ---No No ----------Port 1:3:1----------N:S:P : 1:3:1 State : OK Manufacturer : FINISAR_CORP. Part Number : FTLF8519P2BNL Serial Number : U76031S Revision : A MaxSpeed(Gbps): 2.
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.
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.
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.
NOTES The loop subcommand is functional only in a private loop topology.
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.
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.
• 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
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
• 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.
showqos DESCRIPTION The showqos command lists the QoS rules configured in a system. SYNTAX showqos [options][{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY Any role in the system OPTIONS -domain {}... Shows statistics for rules with target objects in domains with names that match one or more of the specified domains or patterns. If -domain is not specified, statistics for all rules with target objects in the current domain are shown.
-------------------------------------------------------------------------4 total Only show QoS rules that are on: cli% showqos -on -I/O_per_second- -KBytes_per_secId Type Name QoS Priority Min Max Min Max LatencyGoal 43 vvset vsb on normal - 4000 - 204800 44 vvset vsc on normal - 102400 45 vvset vsd on normal - 5000 - 256000 -------------------------------------------------------------------------3 total Show QoS rules containing VV vv1: cli% showqos -vv vv1 -I/O_per_second- -KBytes_per_secId Type Name Qo
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 [ ...
Target Information Name ID Type Status Options Policy System2 9 IP ready mirror_config 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.
The following example displays output from the showrcopy groups command, where is specified as b* and 1*: # showrcopy groups b* l* Remote Copy System Information Status: Started, Normal 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 S
◦ Stopped—The volumes were previously synchronized, but may be out of sync due to a group being stopped. ◦ Stale—Volume was previously synchronized, but a previous synchronization attempt failed. Thus the secondary has a valid copy, just not a valid copy from the last synchronization attempt. The secondary volumes can be marked stale in certain failure scenarios, such as when a target fails during node-down handling on the secondary system.
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.
• ◦ 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).
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.
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.
vv_update of a volume Remove old virtual copy and create a new virtual copy 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.
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.
• 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.
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.move_back_chunklet1 moverelocpd -f 0,7,14 17 2 * * 0 3parsvc active Y 2009-03-15 03:17:00 PDT move_back_chunklet2 moverelocpd -f 1,8,15 17 2 * * 1 3parsvc active Y 2009-03-16 02:17:00 PDT move_back_chunklet3 moverelocpd -f 2,9 17 2 * * 2 3parsvc active Y 2009-03-17 02:17:00 PDT 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 * *
showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. 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.7 5def:2008:abcd::161a Port 162 8004 9162 In the example above: Manager IP. The trap manager’s IP address. Port. The trap manager’s port number.
showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. 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.
showsnmpuser DESCRIPTION The showsnmpuser command displays information about one or all SNMP users, including the username, authentication and privacy protocols. SYNTAX The syntax for the showsnmpuser command can be one of the following: showsnmpuser [] showsnmpuser AUTHORITY Any role in the system. OPTIONS None SPECIFIERS Specifies the SNMPv3 username, using up to 31 characters. This specifier is not required on the command line.
showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation. SYNTAX showspace [options ] AUTHORITY Any role in the system.
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).
–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).
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.
• • ◦ 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).
showsralertcrit DESCRIPTION The showsralertcrit command shows the criteria that System Reporter evaluates to determine if a performance alert should be generated. SYNTAX showsalertcrit [options ] AUTHORITY Any role in the system. OPTIONS -daily Displays only criteria evaluated on a daily basis. -hourly Displays only criteria evaluated on an hourly basis. -hires Displays only criteria evaluated on a high-resolution (5 minute) basis. -enabled Displays only criteria that are enabled.
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.
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).
• 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. The free system capacity in MB. • Failed Cap. The failed system capacity in MB.
Number of Nodes Master Node Nodes Online Nodes in Cluster : : : : 2 0 0,1 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 : Green Speed : Normal Primary Node ID : 1 Secondary Node ID : 0 State : OK LED : Green Speed : Normal --------System Descriptors-------Location : Owner : Contact : Comment : The following example shows system parameters
showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr [options] AUTHORITY Any role in the system. OPTIONS -d Shows additional detailed information if available. -l Shows field service diagnostics for locking, and ioctl system calls. 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.
If the system has attempted powerfail recovery, and during the recovery encountered kernal panics because of hardware or software errors, the error could be associated with a specific volume. The following message is displayed. See “NOTES” (page 478) 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.
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.
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.
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.
EXAMPLES The following example displays all tasks on a system. In this case, the last task is still in progress.
◦ online_copy. Track physical copy of VV while online (createvvcopy -online command). ◦ convert_vv. Track tasks that are converting a volume from fully-provisioned to thin-provisioned and vice-versa. ◦ tune_sd. Track HP 3PAR System Tuner volume tuning operations. Requires an HP 3PAR Dynamic Optimization license. ◦ tune_vv. Track 3PAR System Tuner volume tuning operations. Requires an HP 3PAR Dynamic Optimization license. ◦ tune_vv_restart.
2009-02-27 2009-02-27 2009-02-27 2009-02-27 11:37:46 11:37:47 11:37:48 11:37:48 PST PST PST PST Updated Updated Updated Finished snapshot usage data for VV North snapshot usage data for VV VV_Tech_1.0020.0000.ro snapshot usage data for VV VV_Tech_1 snapshot usage data collection process. 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.
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.
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.
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.
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).
NOTES • Users are created using the createuser command. See “createuser” (page 139) for more information. • For the first usage (without the -k option), the showusercommand 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.
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.
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 .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.
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.
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.
–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.
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.
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).
–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.
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.• -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 {}...
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.
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. ◦ ---.
◦ 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).
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.
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.
• • • 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.
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.
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.
• For this command: 1 MB = 1048576 bytes. • If your system is accessible by an OpenStack cloud, you may see volumes with prefixes indicating the volumes were created through the OpenStack cloud. Volumes created through the OpenStack cloud use the OpenStack Volume (OSV) and OpenStack Snapshot (OSS) prefixes.
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.
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
showvvmap DESCRIPTION The showvvmap command displays information about how virtual volume regions are mapped to logical disks. It also can display bitmap representation of the allocation of a volume or differences between volumes, which is useful in visualizing the utilization of thinly provisioned volumes. SYNTAX showvvmap showvvmap -allocmap [options] showvvmap -unsharedmap -p [options] AUTHORITY Any role in the system.
The following example shows the allocated bitmap starting at 1MB mark of a volume, for a length of 1GB: cli% showvvmap -allocmap -start 1M -len 1G vv0 The following example shows the unshared bitmap between a snapshot and its parent: cli% showvvmap -unsharedmap -p vv0 vv0.ro The columns in the previous example are identified as follows: • Space. The type of the space (user (usr), snapshot data (snp), or snapshot administration (adm) for which the region is being used followed by the ID of the region.
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.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
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
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
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 -summary Shows VV sets with summarized output with VVset names and number of VVs in those sets.
test-sv bar 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.
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.
showwsapisession DESCRIPTION The showwsapisession command displays the WSAPI server sessions connection information, including the id, node, username, role, hostname, and IP Address of the connecting client. It also displays the session creation time. SYNTAX showwsapisession [options][{|}...
NOTES For all the fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat). The only exception is when -d option is provided. In this case, the session id is not a glob-style pattern and is checked against an exact match. The Web Services API server sessions information is only available if the WSAPI server is ready to accept queries.
24 Shutdown Commands shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot 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 subcommand must be used. reboot Specifies that the nodes are restarted after shutdown.
It is recommended that these tasks are either allowed to finish or manually cancelled before continuing. Continuing with this REBOOT operation may cause some of these tasks to fail. Shutting down this node will impact applications running on the system displayed above Do you REALLY want to REBOOT this node? yes or no: yes The node will REBOOT in 15 seconds Press the enter key to stop... The node will REBOOT in 12 seconds Press the enter key to stop...
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.
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...
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).
Select the end time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). • The absolute time as a text string in one of the following formats: ◦ Full time string including time zone: "2012-10-26 11:00:00 PDT" ◦ Full time string excluding time zone: "2012-10-26 11:00:00" ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time.
srcpgspace DESCRIPTION The srcpgspace command displays historical space data reports for common provisioning groups (CPGs). SYNTAX srcpgspace [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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
RESTRICTIONS None EXAMPLES The following example displays aggregate hourly CPG space information for CPGs with names that match the pattern "fc*" beginning 24 hours ago: cli% srcpgspace -hourly -btsecs -24h fc* The following example displays CPG space information for the most recent daily sample aggregated by the disk type and raid type for CPGs with names that match the pattern "fc*": cli% srcpgspace -daily -attime -groupby disk_type,raid_type fc* NOTES For this command: 1 MB = 1048576 bytes.
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
• LD_NAME Logical disk name • CPG_NAME Common Provisioning Group name • NODE The node that owns the LD –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.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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
• PORT_P The port number for the primary port for the the PD • DISK_TYPE The disk type of the PD • SPEED The speed of the PD -disk_type [,...] Limit the data to disks of the types specified. • FC – Fibre Channel • NL – Nearline • SSD – Solid State Drive –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.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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
• PORT_P The port number of the port • PORT_TYPE Port type • GBITPS The speed of the port -port_type [,...] Limit the data to port of the types specified. Allowed types are: • disk – disk port • host – host fibre channel port • iscsi – host iscsi port • free – unused port • rcip – remote copy IP port • rcfc – remote copy FC port –sortcol [,
][:[,]...] Sorts command output based on the column number ().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.
If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires.
• LUN The LUN number for the VLUN • 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 • VVSET_NAME Virtual volume set name • HOSTSET_NAME Host set name -host [,...] Limit the data to hosts with names that match one or more of the specified names or glob-style patterns.
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.
Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
Limit the data to RAID of the specified types. Allowed types are 0, 1, 5 and 6. –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. Multiple columns can be specified and separated by a colon (:).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.
Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. 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.
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. SYNTAX srrgiodensity [options] -cpg {|}...
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -cmult 2|4|8 Select the step between histogram columns of the report.
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
EXAMPLES The following example displays aggregate hourly performance statistics for all node caches beginning 24 hours ago: cli% srstatcmp -hourly -btsecs -24h The following example displays daily node cache performance aggregated by node for nodes 0 and 1: cli% srstatcmp -daily -attime -groupby node 0 1 554 System Reporter (SR) commands
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
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.
If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires.
NOTES For this command: KB = 1000 bytes.
srstatlink DESCRIPTION The srstatlinkcommand displays historical performance data reports for links (internode, PCI and cache memory). SYNTAX The syntax for the srstatlink 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.
Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
EXAMPLES The following example displays aggregate hourly performance statistics for all nodes and links beginning 24 hours ago: cli% srstatlink -hourly -btsecs -24h The following example displays daily node link performance aggregated by node for nodes 0 and 1: cli% srstatlink -daily -attime -groupby node 0 1 562 System Reporter (SR) commands
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
EXAMPLES The following example displays aggregate hourly performance statistics for all physical disks beginning 24 hours ago: cli% srstatpd -hourly -btsecs -24h srstatpd 565
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.
If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires.
Ports with :: that match any of the specified[::...] patterns are included, where each of the patterns is a glob-style pattern. If not specified, all ports are included.
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
EXAMPLES The following example displays aggregate hourly performance statistics for QoS rules beginning 24 hours ago: cli% srstatqos -hourly -btsecs -24h NOTES For this command KB = 1000 bytes.
srstatrcopy DESCRIPTION The srstatrcopy command displays historical performance data reports for Remote Copy links SYNTAX srstatrcopy [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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
EXAMPLES The following example displays aggregate hourly performance statistics for all Remote Copy links beginning 24 hours ago: cli% srstatrcopy -hourly -btsecs -24h The following example displays most recent daily Remote Copy link performance for all targets grouped by target name: cli% srstatrcopy -daily -attime -groupby target_name The following example displays most recent daily Remote Copy link performance for targets grouped by port_n, port_s, port_p: cli% srstatrcopy -daily -attime -groupby port_
srstatrcvv DESCRIPTION The srstatrcvv command displays historical performance data reports for Remote Copy volumes. SYNTAX srstatrcvv [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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
Limit the data to TARGET_NAMEs that match one or more of the specified TARGET_NAMEs or glob-style patterns. -mode [,] Limit the data to TARGET_MODEs of the specified mode. Allowed modes are: -group [,...] Limit the data to GROUP_NAMEs that match one or more of the specified GROUP_NAMEs or glob-style patterns.
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.
◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). 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.
Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS None EXAMPLES The following example displays aggregate hourly performance statistics for all VLUNs beginning 24 hours ago: cli% srstatvlun -hourly -btsecs -24h NOTES For this command: KB = 1000 bytes.
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.
Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600).
inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS || VVs with names that match either the specified VV_name or glob-style pattern are included. Data for all VV members of a specified VV set may also be requested. VV set name must be prefixed by "set:" and can also include patterns.
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).
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).
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.
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.
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.
startrcopy DESCRIPTION The startrcopy command enables remote copy. SYNTAX startrcopy AUTHORITY • Super, Edit • Any role granted the rcopy_start right. NOTE: You must have access to all domains 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.
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.
To start Group2, which contains 4 virtual volumes, and specify starting snapshots, with vv4 starting from a full resynchronization: # 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.
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.
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.
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.
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.
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.
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.
• 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 320) for information about the setstatch command.
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.
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.
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.
NOTES None 602 Stat Commands
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.
EXAMPLES The following example displays one iteration of FCoE counts: cli% statfcoe -iter 1 -counts -begin NOTES None 604 Stat Commands
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.
-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.
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.
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...
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 {}...
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.
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 ...).
NOTES 612 • 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.
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.
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).
–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.◦ 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.
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).
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.
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.
Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647. –begin 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.• 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.
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.
statqos DESCRIPTION The statqos command display the run-time stats of QoS rules that are on. SYNTAX The syntax for the statqos command can be one of the following examples: • statqos [options][{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY • Any role in the system OPTIONS -domain {}... Shows statistics for rules with target objects in domains with names that match one or more of the specified domains or patterns.
NOTE: 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. -filt 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.
EXAMPLES The following example displays one iteration of statistics for QoS: cli% statqos -iter 1 NOTES For this command KB = 1000 bytes. For all the fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat). 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.
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.
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.
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.
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).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.
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.
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.
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.
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.
Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0.
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.
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.
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.
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.
28 Stop Commands stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. 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. -x Specifies that the operation terminates the server immediately without graceful shutdown notice.
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 must have access to all domains 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.
typing, y. Refer to the HP 3PAR Command Line Interface Administrator’s Manual for information about using environment variables.
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.
The following example stops remote-copy groups that start with the name testgroup: # stoprcopygroup -pat testgroup* NOTES • If a group 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.
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.
29 Sync Command 646 Sync Command
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.
EXAMPLES The following example specifies that remote-copy volume group Group1 should be synchronized with its 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 comma
30 Tune Commands 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.
–freq 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.
• 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.
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.
tunesys DESCRIPTION The tunesys command is used to analyze and detect poor layout and disk utilization across an entire across an entire storage system. The command runs a series of low level operations to re-balance resources on the system. SYNTAX tunesys [options] AUTHORITY • Super, Edit • Any role granted the sys_tune right OPTIONS -chunkpct Controls the detection of any imbalance in PD chunklet allocation between PDs owned by individual nodes.
-waittask Wait for all tasks created by this command to complete before returning. SPECIFIERS None 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). • PD chunklets will be re-balanced on each node if any disk has usage less than 20% than the average chunklet usage (chunkpct value). • A maximum of 4 tune tasks will be run at a time (maxtasks value)..
tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with the createvv command by associating it with a different Common Provisioning Group.
-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. Must be used with the -tpvv or -full options.
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.
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}
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.
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.
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.
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.
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.
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 Any role in the system OPTIONS –v Displays the detailed status of the task specified by as it executes. When the task completes, this command exits.
34 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
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
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
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
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.
Index Symbols (brackets) optional elements, 11 (ellipsis), multiuse option specifier, 11 (parentheses), grouped elements, 11 A access user information about, 488 active VLUN, 494 add virtual volume to group, 52 addsnmpmgr, 43, 647 admin volume, 476 admithw, 45 admitpd, 47 admitrcopylink, 49 admitrcopytarget, 51 admitrcopyvv, 52 alerts removing from system, 213 service, registered SNMP software for, 464 system removing preregistered SNMP software, 229 status of, 339 status of, setting, 259 using addsnmpmgr
createvlun, 141 createvv, 144 createvvcopy, 148 createvvset, 152 creating domains, 106 creating new system hosts, 112 creating new users, 139 creating provisioned virtual volumes, 144 creating templates, 133 D data services starting on logical disk, 587 virtual volume, starting, 592 databases, current firmware levels, displaying, 375 date and time for system nodes, 363 setting nodes, 279 definitions, removing, 47, 154 deleting VLUNs, 242 designate site as primary or secondary, 589 disks logical chunklets,
virtual volumes, 636 identify primary and secondary storage servers, 118 identifying drive cages, 189 IP address, specifying SNMP additions, 43 K kernel build text, 24 kernel version number, 24 L length limits, 12 link create to remote storage server, 49 remove, 155 link utilization statistics, 613 LIP, 90 locatecage, 189 locatesys, 192 logical disk name, length limit, 12 logical disks access times, histogram of, 166 check data on, 60 creating virtual volumes in, 144 data services, starting on, 587 displa
removehost, 220 removehostset, 222 removeld, 223 removercopygroup, 225 removercopytarget, 227 removesched, 228 removesnmpmgr, 229 removesnmppw, 231 removespare, 233 removesralertcrit, 235 removesshkey, 236 removetask, 237 removetemplate, 239 removeuser, 240 removeuserconn, 241 removevlun, 242 removevv, 244 removewsapisession, 247 removing hosts, 220 removing users, 240 removing virtual volumes, 244 replacing drive magazines or disk drives, 85 RSCN, 90 S SCSI-3 reservation types, 460 secondary site designat
showspace, 467 showspare, 470 showsralertcrit, 472 showsys, 473 showsysmgr, 477 showtarget, 479 showtask, 481 showtemplate, 485 showtoc, 486 showtocgen, 487 showuser, 488 showuseracl, 490 showuserconn, 491 showversion, 493 showvlun, 494 showvv, 497 showvvmap, 512 showvvpd, 514 showvvset, 518 showwsapi, 520 showwsapisession, 521 shutdownnode, 523 shutdownsys, 525 shutting down system nodes, 523 SNMP access removing passwords for, 231, 592 updating, 315 SNMP software for alerts, 464 removing preregistered, 22
T table of contents generation number, 487 target designation, remove, 227 targets, unrecognized, 479 temperature status, 408 template name, length limit, 12 template VLUN, 494 templates creating, 133 text symbols, 668 Thinly Provisioned Virtual Volume (TPVV), length limit, 12 time and date for system nodes, 363 setting nodes, 279 traps removing preregistered SNMP software, 229 using addsnmpmgr for, 43 tunepd, 649 tunesys, 653 tunevv, 655 U statistics I/O, 636 LUN host attachments, 632 validity checks of,
