| ...] 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. 20 Promote Commands 228 Promote Commands promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. SYNTAX promotesv [options] AUTHORITY • Super, Edit • Any role granted the sv_promote right. OPTIONS -target Copy the differences of the virtual copy to the specified RW parent in the same VV family tree. The default is to copy the differences to the base volume. NOTES • Issue the showvv command to verify that differences in the snapshot volume are promoted to its target volume. • Issue the showvv –d command to display the number of remaining blocks to be copied. • The RW virtual copy and the target of the promote must not be exported. • Only one promote operation is allowed at a time within a virtual volume family tree. 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. 21 Remove Commands 232 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. 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". 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 398) for additional information. removercopygroup DESCRIPTION The removercopygroup command removes a Remote Copy volume group or multiple Remote Copy Groups that match a given pattern. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX removercopygroup [options] | ... AUTHORITY • Super, Edit • Any role granted the rcopygroup_remove right. NOTES • If the mirror_config option policy is set for this group’s target and the group is a primary group, then this command is mirrored to the target and the corresponding group is also removed. If the policy is set and the group is a secondary group, then this command fails. • The removercopygroup command removes all the associations configured in the specified group and removes the group name and any Remote Copy synchronization snapshots affiliated with volumes in the group. removercopytarget DESCRIPTION The removercopytarget command removes target designation from a Remote Copy system and removes all links affiliated with that target. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX removercopytarget [options] AUTHORITY • Edit • Any role granted the rcopytarget_remove right. removesched DESCRIPTION The removesched command removes a scheduled task from the system. SYNTAX removesched [options] AUTHORITY • Super, Service • 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). NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX removesnmpmgr [option ] AUTHORITY • Super • Any role granted the snmpmgr_remove right. EXIT STATUS The following codes are returned indicating success or failure: • 0 indicates that the trap manager host was removed and the command was successful. • 1 indicates that the command failed. • 2 indicates that the host is not on the list of registered hosts. NOTES • SNMP managers are registered by issuing the addsnmpmgr command. See “addsnmpmgr” (page 43) for additional information. • Verify the removal of SNMP managers by issuing the showsnmpmgr command. removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. removesnmpuser DESCRIPTION The removesnmpuser command allows a user to remove an SNMPv3 user. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX removesnmpuser [options] AUTHORITY • Super, Service, Edit, Browse • Any role granted the snmpuser_remove right. 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 472) 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. removesshkey DESCRIPTION The removesshkey command removes your Secure Shell (SSH) public key to disable key authentication. NOTE: See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. 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. The following example shows how to remove all tasks, including details. cli% removetask –a Remove all tasks? select q=quit y=yes n=no: y NOTES • See the InForm OS Concepts Guide and InForm OS CLI 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. 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 16) 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_set 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. ... 22 Service Commands 265 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. 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. 0|1 Specifies the side of the specified DC2 or DC4 drive cage to be serviced. Specifies the name of the drive cage to be serviced. RESTRICTIONS Access to all domains is required to run this command. 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 16) 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. 23 Set Commands 276 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 ... setauthparam DESCRIPTION The setauthparam command is used to set the authentication and authorization parameters. NOTE: See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX The syntax of the setauthparam command can be one of the following: setauthparam [-f] setauthparam [-f] ... setauthparam [-f] -clear ... Table 2 Values for setauthparam Specifiers (continued) ldap-reqcert Indicates whether a valid server certificate should be required in order to proceed (The default value is 0). 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. Table 2 Values for setauthparam Specifiers (continued) accounts-dn Indicates the base of the subtree in the DIT in which to search for objects that hold account information. 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. Table 4 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 352) 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 359)). • 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. NOTE: CIM is not part of the Common Criteria evaluated configuration. 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. RESTRICTIONS None. 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. –sdgl [g|G|t|T] Specifies that the autogrow operation is limited to the specified storage amount that sets the growth limit. Storage 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). The default size is 0. 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). The primary path of the disks must be on the specified PCI slot(s). –pt - 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–4).
(SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed. For SSD drive, the number is to be treated as relative 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. 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. • The options -sdgs, -sdgl and -sdgw control the auto LD creation for the CPG’s snapshot data regions. Auto LD creation occurs when the amount of free LD space falls below the specified grow (enlarge) size setting options (-sdgs, -sdgl). • If auto-grow is enabled, new LDs will be created automatically in addition to any LDs specified with -sa or -sd options. setdate DESCRIPTION The setdate command allows you to set the system time and date on all nodes. SYNTAX The syntax for the setdate command can be one of the following: • setdate [[]][<.ss>] • setdate –tzlist [group] • setdate –tz AUTHORITY • Super, Service • Any role granted the date_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –tzlist [group] Displays a timezone within a group, if a group is specified. • MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY.ss EXAMPLES The following example shows the timezone being set: Timezone set successfully. The following example verifies the timezone is set to the required setting: 7 Mon Oct 10 23:14:52 GMT 2005 NOTES • Specifies must be provided in one of the combinations listed as follows when issuing the setdate command: • MMDDhhmm • MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY. 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. SYNTAX The syntax for the sethost command can be one of the following: • sethost [options ] • sethost initchap [-f] [options ] {|}... -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. This selects certain variations in SCSI command behavior which certain operating systems expect. EXAMPLES The following example change the settings of a host: cli% cli% cli% cli% cli% cli% sethost sethost sethost sethost sethost sethost -contact "Joe Smith" -model "Sun Ultra 60" queasy10 initchap "MyChapSecret" queasy10 targetchap -hex "30313233343536373839303132333435" queasy10 removechap -target queasy10 clearagent 210100E08B32A58A -persona 1 queasy10 NOTES • The CHAP configurations are applied to all hosts whose names match one or more of the specified or specifiers. 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. SPECIFIERS None. 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 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. If a node ID is specified, it switches to that node. Otherwise, any node with a connected Ethernet interface is chosen. Specifies that during an IP failover, a ping either be sent to the specified IP address () or not sent at all (none). This specifier can only be used with the failoverping subcommand. [] Specifies the node, by ID, that has an active Ethernet interface. This specifier can only be issued with the changenode subcommand. This specifier is not required. RESTRICTIONS Access to all domains is required to run this command. 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. NOTES None. setntp DESCRIPTION The setntp command sets the system Network Time Protocol (NTP) server. This command is deprecated and will be removed in a subsequent release. AUTHORITY • Super, Service • Any role granted the ntp_set right. NOTE: You need access to all domains in order to run this command. SYNTAX setntp |none OPTIONS None. SPECIFIERS Specifies the IP address of the NTP server to which the HP 3PAR Storage System synchronizes its internal clocks. 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. NOTE: See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. EXAMPLES The following example shows how to set a user’s (user1) password on an InServ storage system and on a client: cli% setpassword –save –file user1 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 . 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 ... 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. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. Changes secondary volume groups to primary volume groups on the active system in the event of a server failure. If the group has multiple targets it will also attempt to pull more recent data from other targets and start Remote Copy to those targets when complete. recover Used for groups on which the failover operation has already been run. Changes matching primary volume groups on the backup system to secondary volume groups and then starts and synchronizes all groups. –natural When issuing the command with the reverse specifier, only the natural direction of the groups is reversed, leaving the current direction unchanged. –current When issuing the setrcopygroup command with the reverse subcommand, only the current direction of the groups is reversed. –waittask Wait for all tasks created by this command to complete before returning. This option applies to the failover, recover, restore, and reverse subcommands. Specifies the name of the volume group whose policy is set, or whose target direction is switched. Specifies the target name for the target definition created with the creatercopytarget command. 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 (e.g. NOTES • There is no default resynchronization period. For groups whose mode is asynchronous periodic, you must specify a resynchronization period using setrcopygroup period or resynchronizations does not automatically take place. • The minimum interval for periodic resynchronizations is five minutes. • Use the -nosnap option when the primary server has failed or where the disks are ruined or in an unknown state. For example, an uncontrolled shutdown can result in loss of data. setrcopytarget DESCRIPTION The setrcopytarget command sets the name, policies, and throughput of a target definition. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. Specifies that all configuration commands (creatercopygroup, removercopygroup, admitrcopyvv, dismissrcopyvv, setrcopygroup pol/period, startrcopygroup, and stoprcopygroup) involving the specified target are duplicated (mirror_config) or not duplicated (no_mirror_config). If not specified, all configuration commands are duplicated. The new name for the indicated target. This specifier can only be used with the name subcommand. The setrcopytarget command with the following arguments can be run without bringing down its Remote Copy groups: • setrcopytarget pol • setrcopytarget tunelinks • Under normal operating conditions the mirror_config policy should never be changed to no_mirror_config. 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 • 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. 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. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX setsnmppw [options] AUTHORITY • Super • Any role granted the snmppw_set right. NOTES • The default initial read/write password is public. • If the read-only or write-only passwords do not exist, they are created. • Verify SNMP passwords by issuing the showsnmppw command. See “showsnmppw” (page 467) for more information. setsnmpuser DESCRIPTION The setsnmpuser command sets the SNMPv3 user secret key used for generating authentication and privacy keys. The username must correspond to an existing local user. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. RESTRICTIONS None. 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. NOTE: See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays setting a raw space alert of 800 gigabytes: cli% setsys RawSpaceAlertFC 800 cli% showsys -param System parameters from configured settings ----Parameter----RawSpaceAlertFC RawSpaceAlertNL RemoteSyslog RemoteSyslogHost SparingAlgorithm CopySpaceReclaim EventLogSize VVRetentionTimeMax : : : : : : : : ---Value---800 0 1 192.168.6. 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 9999. 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 options available for the createald, createaldvv, createcpg, and createtpvv commands can be used with the settemplate command to modify an existing template. • Options preceded with –remove are removed from an existing template. • When adding options to a template, specify the option flag and its value (if any). • When removing options from a template, specify the option flag only. 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 Virtual Volumes (VVs). It can be used 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. NOTE: If the volume is not in any domain, then its retention time cannot exceed the value of the system's VVRetentionTimeMax . The default value for the system's VVRetentionTimeMax is 14 days. If the volume belongs to a domain, then its retention time cannot exceed the value of the domain's VVRetentionTimeMax , if set. The retention time cannot be removed or reduced once it is set. If the volume has its retention time set, it cannot be removed within its retention time. -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. The following options can only be used on fully provisioned volumes: -usr_cpg Specifies that the volume user space that is to be provisioned from the specified CPG. This option moves all the logical disks currently contained in the user space for these volumes into the CPG. The following example modifies the WWN of virtual volume vv1. cli% setvv -wwn 50002AC0001A0024 vv1 NOTES • At least one option must be specified. • To view policies assigned to the system’s VVs, issue the showvv –p command. See “showvv” (page 500) for more information. • It is not possible to rename a VV 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. 24 Show Commands 348 Show Commands showalert DESCRIPTION The showalert command displays the status of system alerts. When issued without options, all 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 alerts are displayed. –a Specifies that only acknowledged alerts are displayed. –f Specifies that only fixed alerts are displayed. –all Specifies that all alerts are displayed. Severity Type Message : 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 NOTES • Set the status of alerts by issuing the setalert command. See “setalert” (page 277) for more information. 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 –d Specifies that detailed battery information, including battery test information, serial numbers, and expiration dates, is displayed. • Serial. The battery serial number. • State. The current status of the battery. Battery states can be as follows: ◦ --. Cannot determine the battery state. ◦ NotPresent. Battery is missing. ◦ OK. Battery is operating normally. ◦ Failed. Battery is operating abnormally. ◦ MaxLifeLow. Maximum battery life is low (less than 12 minutes). • ChgLvl. Percentage of battery charge status for the node. • ExpDate. The expiration date of the battery. • Expired. The following example displays the battery test log information using the showbattery –log command: cli% showbattery -log Node PS Bat Test Result Dur(mins) ------------Time-----------0 0 0 0 Passed 1 Fri Jan 19 13:16:51 PST 2007 0 0 0 1 Passed 1 Fri Feb 02 13:18:51 PST 2007 0 0 0 2 Passed 1 Tue Feb 20 12:41:06 PST 2007 0 0 0 3 Passed 1 Tue Mar 06 12:42:07 PST 2007 0 0 0 4 Passed 1 Tue Mar 20 13:43:58 PDT 2007 0 0 0 5 Passed 1 Tue Apr 03 13:45:35 PDT 2007 0 0 0 6 Passed 1 Tue Apr 17 13:47:07 PDT 2007 0 0 0 7 • ◦ Degraded. The battery is in degraded state. ◦ Not Present. The battery is missing. Detailed_State. The detailed state of the battery and can be one of the following: ◦ Not Present. The battery is missing. ◦ Expired. The battery is already expired. ◦ Failed. The battery is operating abnormally. ◦ InvalidFirmware. The battery has invalid firmware. ◦ Unknown. The battery state is unknown. ◦ Undefined. The battery state can not be determined. 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. 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 [...] AUTHORITY Any role in the system. OPTIONS –d Specifies that more detailed information about the drive cage is displayed. If this option is not used, then only summary information about the drive cages 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 ... 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. NOTE: CIM is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. • 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 can not 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.2 NOTES None. 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. NOTES None. 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. –sev Specifies that only events with severities that match the specified pattern(s) are displayed. –nsev Specifies that only events with severities that do not match the specified pattern(s) are displayed. –class Specifies that only events with classes that match the specified pattern(s) are displayed. –nclass Specifies that only events with classes that do not match the specified pattern(s) are displayed. Node: 0, Seq: 337, Class: Status change, Severity: Informational, Type: Cage loop status Cage 1 is connected to the system on both ports. Autofixing previous alerts. 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 AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES None. 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. NOTES None. 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 Growth_Blocked Dev_Type RPM 0 log0.0 0 0 FC 10 1 log1.0 0 0 FC 10 2 pdsld0.0 0 0 FC 10 3 pdsld0.1 0 0 FC 10 4 pdsld0.2 0 0 FC 10 5 admin.usr.0 1 0 FC 10 6 admin.usr.1 1 0 FC 10 7 admin.usr.2 1 0 FC 10 8 admin.usr.3 1 0 FC 10 9 tp-0-sa-0.0 1 0 FC 10 10 tp-0-sa-0.1 1 0 FC 10 11 tp-0-sa-0.2 1 0 FC 10 14 tp-0-sa-0.4 1 0 FC 10 15 v1.0.usr.0 1 0 FC 10 16 v1.1.usr.0 1 0 FC 10 17 tp-0-sd-0. 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. 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. SPECIFIERS None. RESTRICTIONS None. 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. –s Displays the detailed state information for node or power supply (proceed with the -ps option) SPECIFIERS .. ◦ 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. The node has not initialized, is offline, has mismatching kernal versions has bad drive partitions, is rebooting, or has shutdown. • Master. Specifies is the node is the master node. • InCluster. Indicates if the node is in the cluster. • LED. The node LED information. Values are as follows: ◦ --. These columns and values are described in detail in the following examples. cli% shownode -mem Node Riser Slot SlotID Size(MB) 0 n/a 0 J4200 2048 0 n/a 1 J4300 2048 0 2-slot 0 J0901 2048 0 4-slot 1 J0900 2048 0 4-slot 2 J1300 2048 1 n/a 0 J4200 2048 1 n/a 1 J4300 2048 1 2-slot 0 J0901 2048 1 4-slot 1 J0900 2048 1 4-slot 2 J1300 2048 -Name-- -Usage- --Type--- --Manufacturer--- -Serial- -LatencyDIMM0 Control FB-DIMM Micron Technology E20BC997 CL5.0/5. • 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. cli% shownode -pci --------------------------PCI Node Slot Type -Manufacturer0 0 FC QLOGIC 0 1 FC QLOGIC 1 0 FC QLOGIC Cards--------------------------Model- -Serial- -Rev- Firmware 2302 D13503 1 3.3.16 2302 D44171 1 3.3.16 2302 C31037 1 3.3.16 In the example above: • Node. The node ID. • Slot. The slot ID. • Type. 1 1 0 OK OK 1 NotPresent -- OK -- OK -- OK NotPresent In the example above: • Node. The node ID. • PS. The power supply ID. • PSState. The power supply state. Values are as follows: • • • • • ◦ --. Cannot determine the state. ◦ OK. The power supply is operating normally. ◦ Failed. The power supply is operating abnormally. ◦ NotPresent. The power supply is missing. ◦ Degraded. There is a fan failure, or the battery state is not OK. FanState. The power supply fan state. 0 1 2 3 OK OK OK OK OK 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 node is degraded when the power supply is missing, failed, or degraded (fan failed, battery max life low, failed, expired, or not present). ◦ Failed. The node is either not initialized, offline, kernel revision mismatched, disk partition bad, rebooting, or shut down. Detailed_State. 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. Detailed_State. The power supply detailed state. Values are as follows: ◦ invalid_bat_count. The power supply has an invalid battery count. ◦ dc_failed. shownodeenv DESCRIPTION The shownodeenv command displays the node operating environment status, including voltages and temperatures. SYNTAX shownodeenv [options ...] AUTHORITY Any role in the system. OPTIONS –n ... Specifies the ID of the node whose environment status is displayed. Multiple node IDs can be specified as a series of integers separated by a space (1 2 3). If no option is used, then the environment status of all nodes is displayed. SPECIFIERS None. Restrictions None. LM87 Ext CPU0 CPU1 CPU0 VRM CPU1 VRM CPU DIMM0 CPU DIMM1 Temp: Temp: Temp: Temp: Temp: Temp: Temp: 20 C 24 C 25 C n/a n/a 37 C 38 C -10 C 0 C 0 C n/a n/a 0 C 0 C 65 C 85 C 85 C n/a n/a 105 C 105 C Within Within Within Within Within Within Within Measurement Reading Lo Limit Hi Limit Status Node 1 --------... NOTES None. 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. -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. –space Shows disk capacity usage information (MB). The following columns are shown: Id, CagePos, Type, State, Size_MB, Volume_MB, Spare_MB, Free_MB, Unavail_MB, Failed_MB. –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). The specified drive cage(s) must contain disks. –mg
- Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when usingthe -mg option.
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. The node list is specified as a series of integers separated by commas (0,1,2). A list can also consist of a single integer (1). • 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. Free size of the disk in MB (1024^2 bytes). • 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. • 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 -s Type FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC -State- -Detailed_Statenormal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal normal 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. 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. RESTRICTIONS None. showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX The syntax of the showport command can be one of the following: • showport [options] [-failed] [-sortcol [,]][ |...] AUTHORITY Any role in the system. OPTIONS -i Show hardware and inventory formation. -c Displays all devices connected to each loop (by position on the loop). Position 0 is the cage connected directly to the node on this loop.-d Displays detailed information about the SFPs attached to ports. This option is used with the –sfp option. -failed Displays only failed ports. -state Displays the detailed state information. -s Displays the detailed state information. This option has been deprecated and will be removed in a future release. –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:1 0:0:2 0:0:3 0:0:4 0:2:1 0:2:2 0:4:1 0:5:1 0:5:2 1:0:1 1:0:2 1:0:3 1:0:4 1:2:1 1:2:2 1:3:1 1:3:2 1:4:1 1:5:1 1:5:2 initiator initiator initiator initiator initiator target peer initiator initiator initiator initiator initiator initiator initiator initiator target target peer target target ready ready ready loss_sync ready ready offline loss_sync loss_sync ready ready ready loss_sync ready ready ready loss_sync offline ready loss_sync 2FF70002AC00000A 2FF70002AC00000A 2FF70002AC00000A 2FF70002AC00000 • Port_WWN/HW_Addr. The WWN that belongs to the controller node port identified in the N:S:P column. • Type. Indicates the port connection type. ◦ host. Port is connected to hosts. This port can also be used for Remote Copy over IP (RCIP). ◦ disk. Port is connected to disks. ◦ rcfc. FC port is used for Remote Copy. ◦ peer. FC port used for data migration. ◦ rcip. IP port is used for Remote Copy. ◦ iscsi. iSCSI port connected to hosts. ◦ free. Port is not connected to hosts or disks. 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. • Connmode.Indicates the connection mode which can be rcfc, peer, host or disk. • ConnType. Indicates the type of connection configured for the port; loop for loop, point for point-to-point, or lp for loop or point-to-point. • CfgRate. The configurable bit rate of data transfer between the port and a host or a disk; either auto, 1Gbps, 2Gbps, or 4Gbps. • MaxRate. • 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. • Rate. Data transfer rate (bitrate) for the Remote Copy interface. • Type. Indicates the port connection type. • rcip. Port is used for Remote Copy over IP (RCIP). 1:2:1 offline 000423ADE95E 1:2:1 offline 000423ADE95F - - - - n/a n/a n/a n/a n/a n/a The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the syntax node:slot:port. • State. State of the port. ◦ ready. The port is online and ready for use. ◦ loss_sync.The port is not physically connected to anything. ◦ config_wait. Firmware has yet to be initialized. ◦ login_wait. The following example displays all ports that are configured as peer: cli% showport -peer N:S:P Mode State ----Node_WWN---- ----Port_WWN---- Rate 0:5:1 initiator ready 2FF70202AC000007 20510202AC000007 2Gbps The following examples display both standard and detailed information about SFPs attached to ports: cli% showport N:S:P -State0:0:1 OK 0:0:2 OK 0:3:2 OK 1:0:1 OK 1:0:2 OK cli% -sfp -Manufacturer- MaxSpeed(Gbps) TXDisable TXFault RXLoss DDM FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2. 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 either all devices or only arbitrated loop devices on a Fibre Channel port. SYNTAX showportdev loop|all|ns AUTHORITY Any role in the system. SUBCOMMANDS loop|all|ns loop Specifies that information is returned for arbitrated loop devices that are attached to the specified port. If this subcommand is not specified, then the all subcommand must be specified on the command line. EXAMPLES The following example displays information about all devices attached to Fibre Channel port 1:0:2: cli% showportdev all 1:0:2 PtId LpID Hadr Node_WWN 0xd3 0x0c 0x00 2FF70002AC000013 0xef 0x00 0xef 2000000087002078 0xe8 0x01 0xe8 2000000087002515 0xe4 0x02 0xe4 20000000870024CB 0xe2 0x03 0xe2 20000000870028AE 0xe1 0x04 0xe1 2000000087002224 0xe0 0x05 0xe0 2000000087003019 0xdc 0x06 0xdc 5000087000190E9F 0xda 0x07 0xda 2000000087002397 Port_WWN 21020002AC000013 2200000087002078 2200000087002515 2200 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. showrcopy DESCRIPTION The showrcopy command displays details of the Remote Copy configuration. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. Link Information Target InServ2 InServ2 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 InServ2 Started LocalVV ID RemoteVV localvv.0 391 remotevv.0 localvv.1 392 remotevv.1 Role Mode Options Primary Sync ID SyncStatus LastSyncTime 351 Syncing (25%) Thu Dec 14 17:37:40 PST 2006 352 Syncing (40%) Thu Dec 14 17:37:40 PST 2006 Name Target Status Role Mode Options sync_group_2. LocalVV lisa-ws ID 2 RemoteVV lisa-ws ID SyncStatus 3922 Synced LastSyncTime Tue Jul 18 14:10:32 PDT 2006 In the example above: • Name. The name of the group. • Target. The target to which the group is mirrored. • Status. The following values can appear in the group Status field: ◦ New. Group that has not yet been started. ◦ Starting. Currently attempting to start the group. ◦ Started. Group is started (has Remote Copy running). ◦ Stopped. Group was stopped. ◦ Backup. showrctransport DESCRIPTION The showrctransport command shows status and information about end-to-end transport for Remote Copy in the system. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX showcrtransport [options] AUTHORITY Any role in the system. OPTIONS –rcip Show information about Ethernet 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). NOTES None. 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. 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. NOTES None. showsched description The showsched command shows the state of tasks currently scheduled on the system. syntax showsched [options][|] authority Super, Service 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_chunklet4 moverelocpd -f 3,10 17 2 * * 3 3parsvc active Y 2009-03-18 02:17:00 PDT move_back_chunklet5 moverelocpd -f 4,11 17 2 * * 4 3parsvc active Y 2009-03-12 02:17:00 PDT move_back_chunklet6 moverelocpd -f 5,12 17 2 * * 5 3parsvc active Y 2009-03-13 02:17:00 PDT move_back_chunklet7 moverelocpd -f 6,13 17 2 * * 6 3parsvc active Y 2009-03-14 02:17:00 PDT remove_expired_vvs removevv -f 27 * * * * 3parsvc active Y 2009-03-11 17:27:00 PDT ------------------------------------------------------------- showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX showsnmpmgr AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. showsnmpuser DESCRIPTION The showsnmpuser command displays information about one or all SNMP users, including the username, authentication and privacy protocols. NOTE: SNMP is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. SPECIFIERS None. RESTRICTIONS None. • • ◦ 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). showsshkey DESCRIPTION The showsshkey command will displays all SSH public keys that have been set with setsshkey. NOTE: See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX showsshkey AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. 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). ID -Name- ---Model--- -Serial- Nodes Master TotalCap AllocCap FreeCap FailedCap 15 s015 InServ T400 1000015 2 0 1063424 208384 855040 0 In the previous example: • ID. The system ID. • Name. The system name. • Model. The model type of the HP 3PAR Storage System. • Serial. The system serial number. • Nodes. The number of nodes in the system. • Master. The master node ID. • TotalCap. The total system capacity in MB. • AllocCap. The allocated system capacity in MB. • FreeCap. The following example displays more detailed (–d option) information about the same system: cli% showsys -d ------------General------------System Name : S424 System Model : InServ E200 Serial Number : 1100424 System ID : 424 Number of Nodes : 2 Master Node : 0 Nodes Online : 0,1 Nodes in Cluster : 0,1 -----System Capacity (MB)----Total Capacity : 6277120 Allocated Capacity : 687872 Free Capacity : 5589248 Failed Capacity : 0 ---------System Fan--------Primary Node ID : 0 Secondary Node ID : 1 State : OK LED defaults. When (from default settings) is displayed, system parameters can not be updated. • The system capacity information may have some overlaps among Volumes, System, Failed Capacities. • If the VVRetentionTimeMax is 0, then the volume retention time in the system is disabled. showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the startup state information about the system manager. In this example, the system manager reports that it is up and running. following message is displayed. See “NOTES” (page 480) in the following section for additional information. cli% showsysmgr System is recovering from a previous power failure. Please use the 'showvv', 'showld', 'showpd' CLI commands to check for not started vvs, lds, pds. Use force_iderecovery to start pfail recovery. VVs with the id(s) 1 will lose data. 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. RESTRICTIONS None. EXAMPLES The following example displays all tasks on a system. In this case, the last task is still in progress. ◦ tune_vv_rollback. Track rolling back of 3PAR System Tuner volume tuning operation that was previously interrupted (tunealdvv –rollback command). Requires a 3PAR Dynamic Optimization license. ◦ scheduled_task. Track tasks that have been executed by the system scheduler. ◦ system_task. Track tasks that are periodically run by the system. ◦ background_task. Track commands that have been started via the starttask command. • Name. The name of the system object that is being operated on. NOTES • See the HP 3PAR InForm OS CLI Administrator’s Manual for additional information and examples regarding task management and task management commands, as well as information about Dynamic Optimization. • By default, this command shows all tasks that started within the last 24 hours. • The system stores information for the most recent 1000 tasks. Task ID numbers roll at 9999. 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 147) for more information. • For the first usage (without the -k option), the showuser command displays account information for all local users when the is not provided or the account information for just the local user with the name when it is provided. 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. Refer to the InForm OS CLI Administrator’s Manual for instructions on using global options and setting environment variables. showversion DESCRIPTION The showversion command displays information about the storage server software. Use this command to determine if your system is using the latest software version. SYNTAX showversion [options] AUTHORITY Any role in the system. OPTIONS –a Show all component versions. –b Show build levels. –s Show release version number only (useful for scripting). If no options are specified, the overall version of the software is displayed. SPECIFIERS None. RESTRICTIONS None. 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. 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. 0 test.0 sun 210000E08B023F71 0:2:2 host 1 test.1 sun 210000E08B023F71 0:2:2 host 2 test.2 sun 210000E08B023F71 0:2:2 host 3 test.3 sun 210000E08B023F71 0:2:2 host 0 test.0 sun 210000E08B023C71 1:5:1 host 1 test.1 sun 210000E08B023C71 1:5:1 host 2 test.2 sun 210000E08B023C71 1:5:1 host 3 test.3 sun 210000E08B023C71 1:5:1 host ----------------------------------------------16 VLUN Templates Lun VVname Host ----Host_WWN---- Port Type 0 tpv.0 pe750-07 ---------------- --- host 1 tpv. • Port. The port (node:slot:port) on which the host to which the virtual volume is exported appears. In the Templates section, the host-sees rule contains dashes. • Type. The type of export rule that is applied when the virtual volume is exported. Possible entries are port for port-presents, host for host-sees, hostset for host-set VLUNs, matched-set for matched-set. NOTES • A Domain column may be included by using the setclienv command to set listdom to 1. 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. RESTRICTIONS None. 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. Reclaimed_Snp_MB, or Reclaimed_Snp_SD_MB. These statistics are only available via the CLI and only via the -showcols option. • 512 For this command: 1MB = 1048576 bytes. 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 (VV) regions are mapped to logical disks. SYNTAX showvvmap AUTHORITY Any role in the system. OPTIONS None. SPECIFIERS Specifies the VV name, using up to 31 characters in length. RESTRICTIONS None. NOTES None. 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 SPECIFIERS ... An optional list of setnames or patterns. 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. 25 Shutdown Commands 523 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. OPTIONS None. SPECIFIERS Specifies the node, identified by its ID, to be shut down. RESTRICTIONS Access to all domains is required to run this command. 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 InServ will impact applications running on the hosts displayed above Do you REALLY want to REBOOT this InServ? 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... 26 Start Commands 527 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. NOTE: CIM is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX startcim AUTHORITY • Super, Service • Any role granted the cim_start right. 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. startrcopy DESCRIPTION The startrcopy command starts the Remote Copy Service. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX startrcopy AUTHORITY • Super, Edit • Any role granted the rcopy_start right. NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. startrcopygroup DESCRIPTION The startrcopygroup command enables Remote Copy for the specified Remote Copy volume group. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX startrcopygroup [options] | ... AUTHORITY • Super, Edit • Any role granted the rcopygroup_start right. NOTES • If a group’s target has the mirror_config policy set and the group is a primary group, then this command is mirrored to that target and the corresponding secondary group is started. If the policy is set and the group is a secondary, then this command fails. • If the mirror_config policy is not set, then the corresponding secondary group must already be started or this command fails. • Synchronous groups are automatically synchronized when started. 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 the task_start right. OPTIONS None. SPECIFIERS Specifies the command to be run by the starttask command. RESTRICTIONS None. 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. 27 Stat Commands 535 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. 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. SPECIFIERS None. RESTRICTIONS None. • 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 330) 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 InServ. • Type. 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. 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... NOTES None. 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 ...). RESTRICTIONS None. NOTES • For this command: KB = 1000 bytes. • If no option is specified, the command defaults to display statistics totals. • If the or specifier is used, then LDs with names matching any of the patterns are listed, otherwise all LDs are listed. These patterns are glob-style patterns (see Help on sub,globpat). 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 I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Specifies the percent of idle columns in the output. –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified.• 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. statrcopy DESCRIPTION The statrcopy command displays statistics for Remote Copy links. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. 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. amp2 172145632.32 47830.26 47830.26 receive 0 receive RCr039 983110.14 27.32 27.32 receive 1 receive RCr140 823292.09 23.37 23.37 --------------------------------------------------------------------------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. 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 [,][:[,]...] Sort command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. • 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. testvv.1 multi.1 amp2 Sync 1:2:1 FC 39 38 39 5164 5044 5164 7.7 7.2 1.0 1.0 131.1 131.1 testvv.2 multi.1 amp2 Sync 0:2:1 FC 45 14 45 5841 1895 5841 9.7 9.9 1.1 1.1 131.1 131.1 testvv.2 multi.1 amp2 Sync 1:2:1 FC 33 70 89 4365 9202 11721 6.9 6.6 1.0 1.4 131.1 131.1 testvv.3 multi.1 amp2 Sync 0:2:1 FC 34 37 42 4427 4907 5449 9.9 10.2 1.1 1.1 131.1 131.1 testvv.3 multi.1 amp2 Sync 1:2:1 FC 44 38 44 5779 5014 5779 7.4 7.2 1.0 0.9 131.1 131.1 testvv.4 multi.1 amp2 Sync 0:2:1 FC 45 48 51 5902 6328 6674 10.9 11. NOTES None. 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. SPECIFIERS None. RESTRICTIONS None. 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. RESTRICTIONS None. 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 579 stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. NOTE: CIM is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX stopcim [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. stoprcopy DESCRIPTION The stoprcopy command stops the Remote Copy service and optionally stops any started Remote Copy volume groups. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. AUTHORITY • Super, Edit • Any role granted the rcopy_stop right NOTE: You need access to all domains in order to run this command. NOTES • Unless the -stopgroups option is used, the command will fail if there are any Remote Copy groups that are started. If the -clear option has been used, the configuration is completely erased. Consequently, Remote Copy operations can not be restarted using only the startrcopy command. The configuration must be rebuilt. Therefore, the -clear option requires confirmation with the -f option, the TPDFORCE environment variable, or by interactively typing, y. stoprcopygroup DESCRIPTION The stoprcopygroup command stops the Remote Copy functionality for the specified Remote Copy volume group. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX stoprcopygroup [options] |... EXAMPLES The following example stops Remote Copy for Group1: cli% stoprcopygroup Group1 The following example stops Remote Copy Groups that start with the name testgroup: cli% stoprcopygroup -pat testgroup* NOTES In sync mode, this command creates snapshots that are used for synchronizing the primary and secondary groups if startrcopygroup is run later. 29 Sync Command 585 syncrcopy DESCRIPTION The syncrcopy command manually synchronizes Remote Copy volume groups. NOTE: Remote Copy is not part of the Common Criteria evaluated configuration. See the HP 3PAR InForm OS Common Criteria Administrator’s Reference for more information before using this command in Common Criteria mode. SYNTAX syncrcopy [options] | ... EXAMPLES The following example specifies that Remote Copy volume group Group1 should be synchronized with it’s corresponding secondary volume group: cli% 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 it's corresponding secondary volume group: cli% syncrcopy -pat testgroup* NOTES • Mode (synchronous or asynchronous periodic) is set using the creatercopy grou 30 Tune Commands 588 Tune Commands tunealdvv DESCRIPTION This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the tunevv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The tunealdvv command changes the layout of a virtual volume. or –nrw options of the createtemplate command). Sizing options from the template are ignored. This command does not change the size of the VV on which it acts. –t Specifies the RAID type of the Logical Disk (LD): r0 for RAID-0, r1 for RAID-1, or r5 for RAID-5, or r6 for RAID-6. If no RAID type is specified, the default is r1. –ssz Specifies the set size in the number of chunklets. –mg - Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using the -mg option. Drive magazines are identified by one or more integers (
- ). Drive magazines are identified by one or more integers (
- ). Multiple drive magazines are separated with a single comma (1,2,3). A range of drive magazines is separated with a hyphen (0–7). The specified drive magazine(s) must contain disks.
If the tunealdvv command fails due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately. If this option is not used, the command will keep waiting for dirty chunklets to be cleaned if enough space will be available with the dirty chunklets cleaned. –dr Specifies that the command is a dry run and that no logical disks or virtual volumes are created. setting (–ha) for tunealdvv is cage, it is not necessary to explicitly specify cage-level availability when issuing this command. cli% tunealdvv testvol Task 2 started. The following example shows how to use the tunealdvv command to add a disk filter specifying that the logical disks supporting virtual volume testvol must use chunklets on physical disks 20 and 31 only. cli% tunealdvv –p –dk 20,31 testvol Task 3 started. 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. 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 HP 3PAR Storage System array. This command runs a series of low level operations to effect a re-balance of resources on the system. SYNTAX tunesys [options] AUTHORITY Super, Edit Any role granted the sys_tune right OPTIONS -nodepct Control the detection of any imbalance between LD capacity allocation between nodes. RESTRICTIONS • This command requires a Dynamic Optimization license. Contact your local 3PAR representative for information. EXAMPLES In the following example: • LDs will be re-balanced between nodes if any LD is greater than 5% over the average LD size. • PD chunklets will be re-balanced on each node if more than 5% of the disks have more than 30% greater allocation than the average chunklet usage. • A maximum of 4 tune tasks will be run at a time. tunetpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the tunevv command in the future. If Virtual Volumes (VVs) were created with deprecated commands then only deprecated commands can be used to modify VVs. The tunetpvv command allows the RAID and Availability characteristics of an exiting Thin Provisioned Virtual Volume (TPVV) to be dynamically modified. Specifies an existing VV name. RESTRICTIONS • This command requires an HP 3PAR Dynamic Optimization license. Contact your local HP 3PAR representative for information. • This command requires sufficient available physical space with the same owner or backup node as the space it is being copied from. EXAMPLES The following example shows how to use the tunetpvv command to change the RAID type of a TPVV (testvol) from cpg1, which is originally cpg1, which is of RAID 1. Task 1 started. tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with either the createvv or createtpvv command by associating it with a different Common Provisioning Group. Specifies the number of identical virtual volumes to tune using an integer from 1 through 999. For Thinly Provisioned Virtual Volumes, this must be an integer between 1 and 64. If not specified, one virtual volume is tuned. If the -cnt option is specified, then the subcommands, restart and rollback are not permitted. SPECIFIERS Specifies the name of the existing virtual volume. RESTRICTIONS This command requires a Dynamic Optimization license. 31 Update Commands 604 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 609 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. OPTIONS –a Specifies that all drive cages are upgraded with new firmware ( should not be specified). 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. Upgrading cage cage3 cpuA from rev 03 to revision in file /opt/tpd/fw/cage/dc3/dc3_fw.bin-04. 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 613 waittask DESCRIPTION The waittask command asks the CLI to wait for a task to complete before proceeding. The command automatically notifies you when the specified task is finished. SYNTAX The syntax for the waittask command can be one of the following: waittask –v waittask [...] AUTHORITY Super, Service, Edit, Browse Any role granted the task_wait right OPTIONS –v Displays the detailed status of the task specified by as it executes. Index Symbols (brackets) optional elements, 15 (ellipsis), multiuse option specifier, 15 (parentheses), grouped elements, 15 A access user information about, 490 active VLUN, 496 add virtual volume to group, 51 addsnmpmgr, 43, 586 admin volume, 477 admithw, 46 admitpd, 47 admitrcopylink, 48 admitrcopytarget, 50 admitrcopyvv, 51 alerts removing from system, 233 service, registered SNMP software for, 466 system removing preregistered SNMP software, 248 status of, 349 status of, setting, 277 using addsnmpmgr createtpvv, 143 createuser, 147 createvlun, 149 createvv, 152 createvvcopy, 156 createvvset, 159 creating domains, 114 creating new system hosts, 120 creating new users, 147 creating provisioned virtual volumes, 152 creating templates, 137 identifying, 210 information about, displaying, 359 drive magazines taking on- or off- loop, 83 D F data services starting on logical disk, 529 virtual volume, starting, 533 databases, current firmware levels, displaying, 382 date and time for system nodes, 371 settin system configuration, displaying, 384 VLUN template conflicts and, 121 HP technical support, 14 I I/O statistics logical disks, 550 physical disks, 555 ports, 560 virtual volumes, 575 identify primary and secondary storage servers, 128 identifying drive cages, 210 interfaces, user, 13 IP address, specifying SNMP additions, 43 K kernel build text, 25 kernel version number, 25 L length limits, 16 link create to remote storage server, 48 remove, 163 link utilization statistics, 554 LIP, 88 locatecage, 210 l remove group, 244 link, 163 target designation, 246 virtual volume from group, 166 removealert, 233 removecpg, 235 removedomain, 237 removedomainset, 238 removehost, 239 removehostset, 241 removeld, 242 removercopygroup, 244 removercopytarget, 246 removesched, 247 removesnmpmgr, 248 removesnmppw, 250 removespare, 252 removesshkey, 254 removetask, 255 removetemplate, 257 removeuser, 258 removeuserconn, 259 removevlun, 260 removevv, 262 removing hosts, 239 removing users, 258 removing virtual volumes, 262 rep showspace, 469 showspare, 472 showsys, 474 showsysmgr, 479 showtarget, 481 showtask, 483 showtemplate, 487 showtoc, 488 showtocgen, 489 showuser, 490 showuseracl, 492 showuserconn, 493 showversion, 495 showvlun, 496 showvv, 500 showvvmap, 515 showvvpd, 517 showvvset, 521 shutdownnode, 524 shutdownsys, 525 shutting down system nodes, 524 snapshot volumes (copies), creating, 135 SNMP access removing passwords for, 250, 533 updating, 325 SNMP software for alerts, 466 removing preregistered, 248 spares, allocat updatevv, 607 upgradecage, 610, 614 upgradepd, 612 upgrades, firmware levels, 382 upgrading physical disk firmware, 612 user interfaces, 13 users changing passwords, 312 information about, 490 new, creating, 147 removing, 258 V validity checks logical disk data, 61 of virtual volumes, 71 VCN, 87 verifying controlport command success, 93 physical disk admittance, 47 physical disk status, 314 virtual copy names, length limit, 16 virtual volume names, length limit, 16 virtual volumes backing up, 135 copy (sna | 
