| ...] AUTHORITY • Super, Service • Any role granted the pd_movereloc right. NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No physical disks are actually moved. -mg - Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (e.g. 1,2,3). A range of drive magazines is separated with a hyphen (e.g. 0-7). Disks must reside in the specified drive magazine(s). -pn
- Specifies one or more disk positions within a drive magazine.
it must be used at least once on the command line. If this specifier is repeated then the operation is performed on multiple disks. RESTRICTIONS Access to all domains is required to run this command. • src_set_invalid. Source is in invalid set. • src_not_found. Source chunklet does not exist. • invalid_dest. Destination is invalid. • move_failed. Chunklet move failed. • disk_relocating. Disk is relocating. Degraded Information: • disks_reused_in_row. Disks reused in row. • connection_degraded. Disks reused in row. • remote_pds_used. Connection Degraded. • ldpattern_not_obeyed. LD pattern was not obeyed. • raid_availability_reduced. RAID availability reduced. movetodomain DESCRIPTION The movetodomain command moves objects from one domain to another. SYNTAX movetodomain [options] AUTHORITY • Super, Edit • Any role granted the domain_moveto right. NOTE: You need access to all domains in order to run this command. OPTIONS –vv Specifies that the object is a virtual volume. -cpg Specifies that the object is a CPG. –host Specifies that the object is a host. –f Specifies that the command is forced. The following example displays the removal of the host testhost from any domain: cli% movetodomain -host testhost -unset The following hosts will have their domain modified: Id Name 2 testhost Persona -WWN/iSCSI_Name- Port Generic Do you want to proceed with removing the domain of the above? select y=yes n=no: y NOTES • The movetodomain command moves all objects that are directly or indirectly related to the specified object into the specified domain. 19 Promote Commands promotegroupsv DESCRIPTION The promotegroupsv command copies the differences of snapshots back to their base volumes, allowing you to revert the base volumes to an earlier point in time. SYNTAX promotesv [options] [:]... AUTHORITY • Super, Edit • Any role granted the svgrp_promote right. OPTIONS –rcp Allows the promote operation to proceed even if the RW parent volume is currently in a Remote Copy volume group, if that group has not been started. EXAMPLES The following example illustrates how virtual volumes vv1 and vv2 can be promoted with the differences from their base volume: cli% promotegroupsv vv1 vv2 NOTES • A promote to a parent of larger size will include zeroing the additional capacity of the parent in order to correctly represent the data from the smaller virtual copy. Such zeroing activity will proportionally increase the duration of the promote task. promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. SYNTAX promotesv [options] AUTHORITY • Super, Edit • Any role granted the sv_promote right. OPTIONS -target Copy the differences of the virtual copy to the specified RW parent in the same virtual volume family tree. The default is to copy the differences to the base volume. RESTRICTIONS • The virtual copy and its base volume must not be exported. • Only one promote operation is allowed at a time within a VV family tree. EXAMPLES The following example illustrates how virtual volume vv1 can be promoted with the differences from its base volume: cli% promotesv vv1 NOTES • A promote to a parent of larger size will include zeroing the additional capacity of the parent in order to correctly represent the data from the smaller virtual copy. promotevvcopy DESCRIPTION The promotevvcopy command promotes a physical copy back to a regular base volume. SYNTAX promotevvcopy AUTHORITY • Super, Edit • Any role granted the vvcopy_promote right. OPTIONS None SPECIFIERS Specifies the name of the physical copy to be promoted, using up to 31 characters. RESTRICTIONS The physical copy must have completed the copy from the base volume. 20 Remove Commands removealert DESCRIPTION The removealert command removes one or more alerts from the system. CAUTION: Use care when removing alerts. Alerts that have not been fixed or acknowledged should not be removed. SYNTAX removealert [option] –a|... AUTHORITY • Super, Service • Any role granted the alert_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies all alerts from the system and prompts removal for each alert. Are you sure you want to remove it? select q=quit y=yes n=no: y Id 131 – New Message code: 1114115 Thu May 05 00:11:25 PDT 2005 Node: 0 Severity: Minor Too many events are being logged Too many events are being generated. 2 event files were rolled over in less than 1800 seconds. Current event files could not be archived because too many have been archived already. Alert 131 is marked as "New". removeaocfg DESCRIPTION The removeaocfg command removes specified Adaptive Optimization configurations from the system. AUTHORITY Super, Edit SYNTAX removeaocfg [options] {|}... OPTIONS -pat Indicates that specified patterns are treated as glob-style patterns and that all AO configurations matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified. removecpg DESCRIPTION The removecpg command removes Common Provisioning Groups (CPGs) from the system or removes specific Logical Disks (LDs) from CPGs. AUTHORITY • Super, Edit • Any role granted the cpg_remove right. NOTE: You need access to all domains in order to run this command. SYNTAX removecpg [options ] {|}... OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. RESTRICTIONS • Access to all domains is required to run this command. • The removecpg command fails if any of the LDs, or the entire CPG, is in use by a Thinly Provisioned Virtual Volume (TPVV). EXAMPLES The following example displays the removal of CPG cpg1: cli% removecpg cpg1 NOTES • By default, this command deletes any unused LDs. This is equivalent to using the –ld option. The –ld option still exists for backward compatibility. removedomain DESCRIPTION The removedomain command removes an existing domain from the system. SYNTAX removedomain [option] AUTHORITY • Super • Any role granted the domain_remove right. Super NOTE: You need access to all domains in order to run this command. OPTIONS –f When using this option, the command does not ask for confirmation before removing the domain. SPECIFIERS Specifies the domain that is removed. removedomainset DESCRIPTION The removedomainset command removes a domain set or removes domains from an existing set. SYNTAX removedomainset [options] [...] AUTHORITY • Super, Edit • Any role granted the domainset_remove right. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the domain set. ... removehost DESCRIPTION The removehost command removes a system host or paths to a host. If one or more paths are specified, the command removes only those paths, otherwise the entire host definition is removed. SYNTAX removehost [options] [...|...] AUTHORITY • Super, Edit • Any role granted the host_remove right. NOTE: You need access to all domains in order to run this command. NOTES • Removing an entire host definition by issuing the removehost command is not equivalent to removing all of the paths associated with a host. The latter leaves a host definition with no paths associated to it, whereas the former removes the entire host definition. • Verify the removal of hosts by issuing the showhost command. removehostset DESCRIPTION The removehostset command removes a host set or removes hosts from an existing set. SYNTAX removehostset [options] [...] AUTHORITY • Super, Edit • Any role granted the hostset_set right can remove a host set or hosts from a host set. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Name of the host set to remove. ... removeld DESCRIPTION The removeld command removes a specified Logical Disk (LD) from the system service group. SYNTAX removeld [options] {|}... AUTHORITY • Super, Service, Edit • Any role granted the ld_remove right. OPTIONS –pat Specified patterns are treated as glob-style patterns and all LDs matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified. • Issuing the removeld command with the –pat option specified returns a request for confirmation to remove LDs, unless the –f option is specified. • Do not issue the removeld command while a movech, movech2spare, movepd2spare, or moverelocpd operation is being executed. Issue the showldch command to view operations currently running on the system. See “showldch” (page 391) for additional information. EXAMPLES The following example removes logical disk nf_vv_1.0.usr.1: cli% removeld -f nf_vv_1.0.usr. removercopygroup DESCRIPTION The removercopygroup command removes a remote-copy volume group or multiple remote-copy groups that match a given pattern. SYNTAX removercopygroup [options] { ... | ...} AUTHORITY • Super, Edit • Any role granted the rcopygroup_remove right. OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. EXAMPLES The following example removes Group1 from a remote-copy system: # removercopygroup Group1 The following example removes remote-copy groups that start with the name testgroup: # removercopygroup -pat testgroup* The following example removes the remote-copy group (group1) and retains the resync snapshots associated with each volume: # removercopygroup -keepsnap group1 The following example removes Group1 and associated volumes from the local system and removes the corresponding volumes on all the removercopytarget DESCRIPTION The removercopytarget command removes target designation from a remote-copy system and removes all links affiliated with that target definition. SYNTAX removercopytarget [options] AUTHORITY • Super, Edit • Any role granted the rcopytarget_remove right. NOTE: You must have access to all domains to run this command. OPTIONS -cleargroups Remove all groups that have no other targets or dismiss this target from groups with additional targets. removesched DESCRIPTION The removesched command removes a scheduled task from the system. SYNTAX removesched [options] AUTHORITY • Super, Service, Edit • Any role granted the sched_remove right. OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all scheduled tasks matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified. removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP managers from receiving alerts (traps). SYNTAX removesnmpmgr [option ] AUTHORITY • Super • Any role granted the snmpmgr_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the manager receives traps. If not specified, the port number defaults to 162. NOTES • SNMP managers are registered by issuing the addsnmpmgr command. See “addsnmpmgr” (page 43) for additional information. • Verify the removal of SNMP managers by issuing the showsnmpmgr command. See “showsnmpmgr” (page 464) for more information. removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. SYNTAX removesnmppw [options] AUTHORITY • Super • Any role granted the snmppw_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Removes the read/write (–rw), read-only (–r), or write-only (–w) password. If not specified, the read/write community string password is removed. removesnmpuser DESCRIPTION The removesnmpuser command allows a user to remove an SNMPv3 user. SYNTAX removesnmpuser [options] AUTHORITY • Super, Service, Edit, Browse • Any role granted the snmpuser_remove right. OPTIONS –f Forces the operation so that the command does not require confirmation before proceeding. removespare DESCRIPTION The removespare command removes chunklets from the spare chunklet list. SYNTAX removespare [options] ... AUTHORITY • Super, Service • Any role granted the spare_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. –p Specifies that partial completion of the command is acceptable. EXAMPLES The following example removes a spare chunklet from position 3 on physical disk 1: cli% removespare 1:3 NOTES • Verify the removal of spare chunklets by issuing the showspare command. See “showspare” (page 470) for more information. • If a wildcard (a) is used or the -p flag is specified, prints the number of spares removed. Otherwise, if all the explicitly specified spares could not be removed, prints an error message. removesralertcrit DESCRIPTION The removesralertcrit command removes a criterion that System Reporter evaluates to determine if a performance alert should be generated. SYNTAX removesralertcrit [options ]| AUTHORITY • Super, Service • Any role granted the sralertcrit_remove right OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all criteria matching the specified pattern are removed. removesshkey DESCRIPTION The removesshkey command removes your Secure Shell (SSH) public key to disable key authentication. SYNTAX removesshkey [... ] AUTHORITY • Super, Service, Edit, Browse • Any role granted the sshkey_remove right. OPTIONS None SPECIFIERS ... Specifies the name of the user whose SSH key is removed. If not specified, the SSH key for the current user is removed. removetask DESCRIPTION The removetask command removes information about one or more completed tasks and their details. SYNTAX The syntax of the removetask command can be one of the following: • removetask [options ] –a • removetask [options ] –t • removetask [options ] ... AUTHORITY • Super, Edit • Any role granted the task_remove right. OPTIONS –a Removes all tasks including details. –d Remove task details only. –f Specifies that the command is to be forced. NOTES • See the HP 3PAR StoreServ Storage Concepts Guide and HP 3PAR Command Line Interface Administrator’s Manual for additional information and examples regarding task management and task management commands. • With this command, the specified task ID and any information associated with it are removed from the system. However, task IDs are not recycled, so the next task started on the system uses the next whole integer that has not already been used. Task IDs roll over at 29999. removetemplate DESCRIPTION The removetemplate command removes one or more Virtual Volume (VV), Logical Disk (LD), and Common Provisioning Group (CPG) templates. SYNTAX removetemplate [options]{|}... AUTHORITY • Super • Any role granted the template_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. removeuser DESCRIPTION The removeuser command removes a user account from the system. SYNTAX removeuser [option] ... AUTHORITY • Super • Any role granted the user_remove right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS ... Specifies a login name using any combination of letters and numbers. removeuserconn DESCRIPTION The removeuserconn command removes user connections to the current system. AUTHORITY • Super • Any role granted the userconn_remove right. NOTE: You need access to all domains in order to run this command. SYNTAX removeuserconn [options] OPTIONS –pat Specifies that the , , and specifiers are treated as glob-style (shell-style) patterns and all user connections matching those patterns are removed. removevlun DESCRIPTION The removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN) export definition from the system. slot Specifies the PCI bus slot in the node where slot is a number from 0 through 5. port Specifies the FCS port number of the card in PCI bus slot using 1 through 4. Specifier requests that exports to the specified host or host set, named using up to 31 characters in length, be removed. The host set name must start with set:. If this specifier is not used, the N:S:P specifier must be used. removevv DESCRIPTION The removevv command removes Virtual Volumes (VVs) from the system. SYNTAX The syntax of the removevv command can be as follows: • removevv [options] |... • removevv -expired [options] [VV_name>|...] AUTHORITY • Super, Edit • Any role granted the vv_remove right can remove base volumes. • Any role granted the vvcopy_remove right can remove physical volumes. • Any role granted the sv_remove right can remove virtual copies. Specifies the VV name, using up to 31 characters in length. This specifier can be repeated to remove multiple VVs. If this specifier is not used, the pattern specifier must be used. Specifies a glob-style pattern. This specifier can be repeated to remove multiple VVs. If this specifier is not used, the specifier must be used. See “Glob-Style Pattern” (page 12) for more information. removevvset DESCRIPTION The removevvset command removes a VV set or removes VVs from an existing set. SYNTAX removevvset [options] [...] AUTHORITY • Super, Edit • Any role granted the vvset_remove right can remove a volume set or volumes from a volume set. OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the VV set to remove. ... removewsapisession DESCRIPTION The removewsapisession command removes the WSAPI user connections from the current system. SYNTAX removewsapisession [options] AUTHORITY • Super • Any role granted the wsapisession_remove right OPTIONS -pat Specifies that the , , and specifiers are treated as glob-style (shell-style) patterns and all WSAPI user connections matching those patterns are removed. To remove a single VV from a set: cli% removevvset vvset vv1 NOTES Because user connections can disappear from the time they are listed and the time they are removed, the removewsapisession command continues past errors while removing individual connections if the -pat option is specified. 21 Service Commands servicecage DESCRIPTION The servicecage command is necessary when executing removal and replacement actions for a drive cage FC-AL module. The startfc or unstartfc subcommands are used to initiate service on a cage, and the endfc subcommand is used to indicate that service is completed. clearlog • For DC2 and DC4 drive cages, clear the log in the cage. FC-AL specifier is ignored. • For DC3 drive cages, clearlog is not supported. OPTIONS –f Forces the operation. When this option is not used, the command requires confirmation before proceeding. –ovrd Forces the specified physical disk path offline even if it is the last remaining path. SPECIFIERS a|b Specifies the side of the specified DC1 or DC3 drive cage to be serviced. servicehost DESCRIPTION The servicehost command executes removal and replacement actions for a host connecting to an HP 3PAR Storage System port. SYNTAX The syntax for the servicehost command can be one of the following: • servicehost list • servicehost remove [-f] [ [...]] • servicehost copy [-f] AUTHORITY • Super, Service • Any role granted the host_service right. Specifies a host’s World Wide Name (WWN). This specifier can only be used with the remove and copy subcommands. When used with the remove subcommand, this specifier can be repeated. Specifies that the indicated WWN or iSCSI name is treated as a glob-style pattern. See “Glob-Style Pattern” (page 12) for more information. Specifies the source port when exporting VLUNs. This specifier can only be used with the copy subcommand. servicemag DESCRIPTION The servicemag command executes service on a drive magazine or disk. SYNTAX The syntax for the servicemag command can be one of the following: • servicemag start [options] • servicemag start [options] -pdid ... • servicemag resume|unmark [options] • servicemag status [options] [ ] • servicemag clearstatus AUTHORITY • Super, Service • Any role granted the mag_service right. Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. –wait Specifies that the servicemag command must be completed before exiting. If not specified, the servicemag command automatically exits before service begins and the remainder of the process proceeds in the background. This option is only valid for the start or resume operations. Specifies the drive magazine within the specified drive cage to be serviced based on the side of the drive magazine and drive magazine slot number. • For drive chassis with a single drive cage (type DC2, DC4, and DC3), the valid syntax is (the numeric position of the drive magazine). Position values for DC2 drive cages can be from 0 to 9. Position values for DC3 drive cages can be from 0 to 15. RESTRICTIONS • Access to all domains is required to run this command. ... marking pd wwn [20000000870042F6] id [22] as usable for ld allocation ... marking pd wwn [2000000087007E6D] id [23] as usable for ld allocation servicemag resume 2 0.0 –– Succeeded NOTES • Issuing the servicemag command results in chunklet relocation that causes a dip in throughput. • When a servicemag command is issued with the –log option, all chunklets on the disks in the drive magazine being serviced are marked as normal,smag. This state indicates an active servicemag operation on the disks. servicenode DESCRIPTION The servicenode command informs the system that a certain component is to be replaced, and causes the system to indicate the physical location of that component. SYNTAX servicenode [options] AUTHORITY • Super, Service • Any role granted the node_service right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS start Specifies the start of service on a node. status Displays the state of any active servicenode operations. EXAMPLES In the following example, fan 1 on node 3 is put into servicing-mode: cli% servicenode -fan 1 3 NOTES None 258 Service Commands 22 Set Commands setalert DESCRIPTION The setalert command sets the status of system alerts. SYNTAX setalert new|ack|fixed {...|–a} AUTHORITY • Super, Service • Any role granted the alert_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies that the status of all alerts be set to new, acknowledged (ack), or fixed. If not specified, the specifier must be specified on the command line. SPECIFIERS ... setaocfg DESCRIPTION The setaocfg command updates an Adaptive Optimization (AO) configuration. AUTHORITY Super, Edit SYNTAX setaocfg [options ] OPTIONS -t0cpg Specifies the Tier 0 CPG for this AO config. -t1cpg Specifies the Tier 1 CPG for this AO config. -t2cpg Specifies the Tier 2 CPG for this AO config. EXAMPLES The following example changes the optimization bias (mode) of an AO configuration called aocfg1 to Performance. cli% setaocfg -mode Performance aocfg1 The following example sets the tier1 CPG for AO configuration aocfg2 to R5FCcpg. R5FCcpg must not already be used in an AO configuration, and the tier 1 CPG for aocfg2 must not already be set. cli% setaocfg -t1cpg R5FCcpg aocfg2 The following example swaps a CPG between tiers. setauthparam DESCRIPTION The setauthparam command is used to set the authentication and authorization parameters. SYNTAX The syntax of the setauthparam command can be one of the following: setauthparam [-f] setauthparam [-f] ... setauthparam [-f] -clear ... setauthparam [-f] -clearall AUTHORITY • Super • Any role granted the authparam_set right. OPTIONS -f Does not ask for a confirmation before performing the operation. Table 3 Values for setauthparam Specifiers (continued) ldap-ssl-cacert Indicates the path name of the file containing the certificate of the Certificate Authority that has issued the LDAP server's certificate, or a “– “ to prompt you to enter the certificate text. ldap-StartTLS Set this parameter to one of the following: • no – to not request the server use StartTLS . Default. • try – to request the server use StartTLS but does not require it to proceed. Table 3 Values for setauthparam Specifiers (continued) be specified using multiple arguments. It is mutually exclusively with the groups-dn variable. account-obj The objectClass attribute of an account object. account-name-attr The attribute of an account object that holds the user's username . memberof-attr The attribute that holds the name of a group of which the user is a member. domain-name-attr When set, the mapping of groups to domains is enabled. Table 5 Values for Specifiers and (continued) can be specified using multiple arguments. A value of “ * ” matches any group name. service-map Same as super-map, but for the Service level. edit-map Same as super-map, but for the Edit level. browse-map Same as super-map, but for the Browse level. create-map Same as super-map, but for the Create level. basic_edit-map Same as super-map, but for the Basic_edit level. setbattery DESCRIPTION The setbattery command sets battery information such as the battery’s expiration date, its recharging time, and its serial number. This information gives the system administrator a record or log of the battery age and battery charge status. SYNTAX setbattery [options ] setbattery [options ] AUTHORITY • Super, Service • Any role granted the battery_set right. EXAMPLES The following example resets the battery test log and the recharging time for a newly installed battery on node 2, power supply 1, and battery 0, with an expiration date of July 4, 2010: cli% setbattery -x 07/04/2010 2 1 0 NOTES To view battery status information, issue the showbattery command. See “showbattery” (page 343) for information about the showbattery command. setcage DESCRIPTION The setcage command enables service personnel to set or modify parameters for a drive cage. SYNTAX setcage [subcommand ]... AUTHORITY • Super, Service • Any role granted the cage_set right. NOTE: You need access to all domains in order to run this command. NOTES • The parameters specified by the setcage command appear in the showcage –d output (see “showcage” (page 350)). • The power supply model cannot be modified if the information is automatically retrieved from the system. setcim DESCRIPTION The setcim command sets the properties of the CIM server, including options to enable or disable the HTTP and HTTPS ports for the CIM server. The command also provides the ability to configure the port numbers associated with these two protocols. In addition, it allows users to enable or disable the SLP port. SYNTAX setcim [options] AUTHORITY • Super, Service • Any role granted the cim_set right. NOTE: You need access to all domains in order to run this command. EXAMPLES To disable the HTTPS ports: cli% setcim -https disable Warning: The CIM server is active and will restart. Are you sure you want to continue (Y/N)? Y To enable the HTTPS port and set the HTTPS port number to 49153: cli% setcim -https enable -httpsport 49153 Warning: The CIM server is active and will restart. setclienv DESCRIPTION The setclienv command sets the CLI environment parameters. SYNTAX setclienv AUTHORITY • Super, Service, Edit, Browse • Any role granted the clienv_set right. OPTIONS None SPECIFIERS The specifiers include the parameters and values to which the parameters should be set. EXAMPLES In the following example, the CLI environment is set to display domains information: cli% setclienv listdom 1 NOTES This command is only available when you are using a CLI shell or SSH. setcpg DESCRIPTION The setcpg command modifies existing Common Provisioning Groups (CPG). SYNTAX setcpg [options ] AUTHORITY • Super, Edit, Service • Any role granted the cpg_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –sa ... Specifies additional Logical Disks (LDs) that have already been created to be used for snapshot administration space allocation. The argument can be repeated to specify multiple logical disks. Table 6 Growth Increment Per Number of Nodes (continued) Number of Nodes Default Minimum 5-6 96 GB 24 GB 7-8 128 GB 32 GB –sdgl [g|G|t|T] Specifies that the auto-grow operation is limited to the specified storage amount. The storage amount can be specified in MB (default) or GB (using g or G) or TB (using t or T). A size of 0 (default) means no limit is enforced. To disable auto-grow, set the limit to 1. –nd - Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s). –st
- Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7).
Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for nearline, or SSD for solid state drive) to be used. Device types can be displayed by issuing the showpd command. If it is not specified, the default device type is FC. -rpm Disks must be of the specified speed. Device speeds are shown in the RPM column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). nearline (NL), or solid state drive (SSD)). This implies that, within a CPG, one can have logical disks of type FC, type NL, and type SSD. However, this is only permitted so that, if a user wants to change the type of a CPG from FC to NL or SSD, they can first change the new logical disk creation characteristics using setcpg and then use region moves to change the device types of existing logical disks. For this same reason, users are permitted to add logical disks of a different device type to a CPG. setdate DESCRIPTION The setdate command allows you to set the system time and date on all nodes. SYNTAX The syntax for the setdate command can be one of the following: • setdate [[]][<.ss>] • setdate –tzlist [group] • setdate –tz AUTHORITY • Super, Service • Any role granted the date_set right. NOTE: You need access to all domains in order to run this command. OPTIONS -f Specifies that the command is forced. RESTRICTIONS • Access to all domains is required to run this command. • Specifiers must be provided in one of the combinations listed as follows when issuing the setdate command: • MMDDhhmm • MMDDhhmmYY • MMDDhhmmCCYY • MMDDhhmm.ss • MMDDhhmmYY.ss • MMDDhhmmCCYY.ss EXAMPLES The following example shows the timezone being set: Timezone set successfully. setdomain DESCRIPTION The setdomain command sets the parameters and modifies the properties of a domain. SYNTAX setdomain [options ] AUTHORITY • Super • Any role granted the domain_set right. NOTE: You need access to all domains in order to run this command. OPTIONS -name Changes the name of the domain. -comment Specifies comments or additional information for the domain. The comment can be up to 511 characters long and must be enclosed in quotation marks. NOTES For moving objects into a domain, use the movetodomain command. setdomainset DESCRIPTION The setdomainset command sets the parameters and modifies the properties of a domain set. SYNTAX setdomainset [options ] AUTHORITY • Super, Edit • Any role granted the domainset_annotate right can only annotate the comment of a domain set. • Any role granted the domainset_set right can set any domain set property. OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. sethost DESCRIPTION The sethost command sets properties on existing system hosts, including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. The command also provides the ability to configure or remove iSCSI CHAP authentication information and to reset a host, aborting all its pending I/O. -ip Specifies the IP address of the host. -os Specifies the operating system running on the host. -model Specifies the model of the host. -contact Specifies the contact information for the host. -comment Specifies any additional information for the host. -name Specifies the new name of the host up to 31 characters in length. -persona Sets the host persona that specifies the personality for all ports which are part of the host set. The World Wide Name (WWN) or iSCSI name of the host which should be reset or for which host agent data should be cleared. node — Specifies the node using a number from 0 through 7. slot Specifies the PCI slot in the specified node. sethostset DESCRIPTION The sethostset command sets the parameters and modifies the properties of a host set. SYNTAX sethostset [options ] AUTHORITY • Super, Edit • Any role granted the hostset_annotate right can only annotate the comment of a host set. • Any role granted the hostset_set right can set any host set property. OPTIONS -comment Specifies a comment relating to the set. -name Specifies a new name for the host set. setlicense DESCRIPTION The setlicense command sets the license key information. SYNTAX setlicense [options ] AUTHORITY • Super, Service • Any role granted the license_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies the file from which the license key is read. –noconfirm Specifies that the system does not prompt for confirmation for the new license key. NOTES • This command prompts for a new license key. To finish entering the license key, press enter on a blank line. • When the license key is being interpreted, all characters other than letters (without case-sensitivity) and numbers are ignored, and the letters are not case-sensitive. • After the new license key has been entered, the changes between the existing license key and the new license key are displayed. setnet DESCRIPTION The setnet command sets the administration network interface configuration. AUTHORITY • Service, Super • Any role granted the net_set right. NOTE: You need access to all domains in order to run this command. Specifies that the network interface is set to the specified speed and duplex as indicated with the andspecifiers. failoverping Specifies that on IP failover, a ping is sent to the specified IP address as indicated with the specifier. ntp none|ntp Specifies the NTP server the system should use to synchronize its clocks. The server must be specified as an IP address. changenode Forces the system to change which node has an active Ethernet interface. Specifies a new prefix_len to which the system is configured. This specifier is used in conjunction with the and specifiers. This specifier can only be used when is of IPv6 type and can only be used with the startaddr and addaddr subcommands. Specifies the IP address of the new gateway for the system. This specifier can only be used with the startgateway subcommand. NOTES • If successful, this command causes any CLI or GUI clients currently connected to lose their connection. • To make it possible to change the network configuration without running the risk of losing contact with the system because of misconfiguration, the setnet command uses a two step process. When a new IP address is specified with the setnetstartaddr command, the system is configured to listen as both the old and new IP addresses. setnode DESCRIPTION The setnode command sets the properties of the node components such as the serial number of the power supply. AUTHORITY • Super, Service • Any role granted the node_set right. NOTE: You need access to all domains in order to run this command. SYNTAX setnode ps [options] SUBCOMMAND ps Sets the power supply properties. OPTIONS -s Specifies the serial number up to eight characters in length. SPECIFIERS Specifies the power supply ID. cli% cli% setnode ps 0 -s aabbccdd 1 cli% shownode -ps Node PS -Serial- -PSState-- FanState ACState DCState -BatState- ChrgLvl(%) 0 0 -NotPresent ---NotPresent 0 0 1 12345678 OK OK OK OK OK 100 1 0 AABBCCDD OK OK OK OK OK 100 1 1 -NotPresent ---NotPresent 0 cli% cli% setnode ps 0 -s aabbccddee 1 Error: The serial number aabbccddee is too long, should be less than 9 characters. setpassword DESCRIPTION The setpassword command allows a user with Super level role to change the password for any user and create a password file on a client. Edit-, browse-, or service-level users can use the setpassword command to change their own passwords or save their password files on a client. SYNTAX setpassword [options ] AUTHORITY • Super, Edit, Browse, Service • Any role granted the password_setany right can set any user password. The following example displays the prompts encountered when changing a user’s (user1) password: cli% setpassword –u user1 password: Old password: NOTES • The format of the entry in the file is . This file may be referenced by the TPDPWFILE environment variable or -pwf command line option for subsequent commands. • The -save or -saveonly option requires the -file option. • Without any options, the command will prompt to change the invoking user's password on the system. setpd DESCRIPTION The setpd command marks a Physical Disk (PD) as allocatable or non allocatable for Logical Disks (LDs). SYNTAX setpd ldalloc on|off ... AUTHORITY • Super, Service • Any role granted the pd_set right NOTE: You need access to all domains in order to run this command. SUBCOMMANDS ldalloc on|off Specifies that the PD, as indicated with the PD_ID specifier, is either allocatable (on) or nonallocatable for LDs (off). OPTIONS None SPECIFIERS ... setqos DESCRIPTION The setqos command creates and updates QoS rules in a system. SYNTAX setqos [options] [{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY • Super, Edit • Any role granted the qos_set right can set QoS configurations. OPTIONS -pri {high|normal|low} Set the QoS scheduling priority of the QoS rule (of this target object). The default priority is normal. -io {none|[{}-]} Sets the I/O issue count min goal and max limit for QoS throttling. EXAMPLES The following example sets the IOPs Min Goal and Max Limit of vvset vsa to 300: cli% setqos -io 300 vvset:vsa The following example turns off the QoS scheduling for vvset vsa: cli% setqos -off vvset:vsa The following example removes all QoS settings of all vvsets: cli% setqos -clear vvset:* NOTES Maximum limit — this is the maximum amount of IOPS or bandwidth, or both, which a given VVset or Domain is allowed to achieve. setrcopygroup DESCRIPTION The setrcopygroup command performs the following actions: • Sets the policy of the remote-copy volume group for dealing with I/O failure and error handling. • Switches the direction of transfer between volume groups. • Sets a resynchronization period for volume groups in asynchronous periodic mode. • Sets the group’s mode. Specifies how frequently the remote-copy system takes group-based coordinated snapshots on both the primary system and the secondary system in asynchronous periodic mode. mode Specifies the mode to which the volume group is set. cpg Specifies the local and target cpg. Specifies the operation of the group(s). Valid operations are: • reverse—Changes the natural and current direction of all specified groups. The operation is mirrored resulting in a direction change on both systems. Specifies not to check a group's other targets to see if newer data should be pushed from them if the group has multiple targets. The use of this option can result in the loss of the most recent changes to the group's volumes and should be used carefully. This option is only valid for the failover specifier. –nopromote This option is only valid for the failover and reverse specifiers. SPECIFIERS Specifies a glob-style pattern. If this specifier is not used, the or specifier must be used. Specifies the policy to assign to the group. Valid policies are: • auto_failover Configure automatic failover on a remote-copy group. This feature will perform an automatic failover on a remote-copy group when used in conjunction with the Quorum Witness functionality. Secondary volumes will be subject to a remote-copy failover operation. Specifies the mode, sync or periodic, to which the group is set. This specifier can only be used with the mode subcommand. s|m|h|d Specifies the time period in units of seconds (s), minutes (m), hours (h), or days (d), for automatic resynchronization (for example, 14h for 14 hours). For the asynchronous mode, this value is used to specify the time period for automatic resynchronization. The following example sets volume groups that start with the name testgroup to synchronize to its asynchronous periodic mode target System2 every 30 minutes: # setrcopygroup period -pat testgroup* 30m System2 NOTES • An earlier version of this command provided fail_wrt_on_err and no_fail_wrt_on_err policies. These policies were deprecated in HP 3PAR OS release 3.1.1. • An earlier version of this command provided a target subcommand. This subcommand was deprecated in HP 3PAR OS release 2.2.3. setrcopytarget DESCRIPTION The setrcopytarget command adjusts the characteristics of a target definition. OPTIONS -remote Used to forward a witness subcommand to the be executed on the remote HP 3PAR Storage System. When used in conjunction with the witness check subcommand the target must be specified when executing on the local storage system target specification is not required to check connectivity with the Quorum Witness. -node Used to conjunction with the witness check subcommand to test the connectivity to the Quorum Witness via the Quorum Announce process running on the specified node. RESTRICTIONS • This command requires the HP 3PAR Remote Copy Software license. Contact your local service provider for more information. • If the mirror_config policy is set and the setrcopytarget command is issued with the pol subcommand, the duplicated configuration commands cannot be issued on the secondary. Doing so results in an error. • There must be an active connection between the systems in the remote-copy pair in order to issue commands on the primary to be mirrored to the secondary. change the policy to no_mirror_config in order to bring the configurations into alignment. After being corrected the mirror_config policy should be immediately restored. Such operations should generally only be undertaken on the advice of a HP representative. • 310 The setrcopytarget witness subcommands are provided to locally create and associate a target with a Peer Persistence quorum and to manage the operational state of the quorum. setsched DESCRIPTION The setsched command allows users to suspend, pause, change the schedule, change the parameters, and change the name of currently scheduled tasks. SYNTAX setsched [options ] setsched [-suspend | -resume] setsched [-suspend_all | -resume_all] AUTHORITY • Super, Service, Edit • Any role granted the sched_setany right can set any user scheduled task properties. • Any role granted the sched_setown right can only set their own scheduled task properties. EXAMPLES None NOTES None 312 Set Commands setsnmpmgr DESCRIPTION The setsnmpmgr command changes an SNMP manager's properties. SYNTAX The syntax for the setsnmpmgr command can be one of the following examples: • setsnmpmgr [options ] AUTHORITY • Super • Any role granted to the snmpmgr_set right NOTE: You need access to all domains in order to run this command. OPTIONS -p Specifies the port number where the SNMP manager receives traps. The following example modifies the user and version properties of the SNMP manager identified by the IPv4 address 123.45.67.89: cli% setsnmpmgr -snmpuser john -version 3 123.45.67.89 NOTES The storage system does not support any form of name resolution. You must specify these IP addresses directly. Issue the addsnmpmgr command to add an SNMP manager. Issue the showsnmpmgr command to display the list of registered SNMP managers. Issue the setsnmppw command to change the SNMP passwords. setsnmppw DESCRIPTION The setsnmppw command allows a user to update SNMP access community strings passwords. The SNMP password is required for the system manager to send requests to the SNMP agent. SYNTAX setsnmppw [options] AUTHORITY • Super • Any role granted the snmppw_set right. NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) community password is changed. NOTES 316 • The default initial read/write password is public. • If the read-only or write-only passwords do not exist, they are created. • Verify SNMP passwords by issuing the showsnmppw command. See “showsnmppw” (page 465) for more information. setsralertcrit DESCRIPTION The setsralertcrit command allows users to enable or disable a System Reporter alert criterion. SYNTAX setsralertcrit {-enable|-disable} AUTHORITY Super, Service Any role granted the sralertcrit_set right. OPTIONS -enable Enables the specified criterion. -disable Disables the specified criterion. SPECIFIERS Specifies the name of the criterion to modify. setsshkey DESCRIPTION The setsshkey command sets the SSH public key for a user. The user will be prompted to provide the SSH public key. To finish entering the public key, press ENTER on a blank line. The key must have been generated using the ssh-keygen utility. The public key is contained in the user-defined file named with .pub extension. The user can open this file with an ASCII editor to copy the key and paste it. NOTES • Issuing the setsshkey command results in the system prompting for your SSH public key. Copy and paste the key using the aforementioned ASCII editor on the command line and then press ENTER. • After setting the SSH public key on the system, use the corresponding private key to log on without a password. A single ssh key may be used for multiple hosts with a single use of setsshkey, or different keys may be used for different hosts. setstatch DESCRIPTION The setstatch command starts and stops the statistics collection mode for chunklets. SYNTAX setstatch start|stop AUTHORITY • Super, Edit • Any role granted the statch_set right. SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for the specified Logical Disk (LD) and chunklet. OPTIONS None SPECIFIERS Specifies the name of the LD in which the chunklet to be configured resides. setstatpdch DESCRIPTION The setstatpdch command sets the statistics collection mode for all in-use chunklets on a Physical Disk (PD). SYNTAX setstatpdch start|stop AUTHORITY • Super, Edit • Any role granted the statpdch_set right. SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for chunklets on the specified PD used by Logical Disks (LDs). OPTIONS None SPECIFIERS Specifies the PD ID. setsys DESCRIPTION The setsys command sets the properties of the system, and includes options to annotate a system with descriptor information such as physical location, owner, contact information, and so on. The command also enables you to set system-wide parameters such as the raw space alert. SYNTAX setsys [options] setsys AUTHORITY • Super, Service • Any role granted the sys_set right. NOTE: You need access to all domains in order to run this command. Performs the same function as RawSpaceAlertFC, but should be used for solid state drive type drives. RemoteSyslog Enables or disables sending events as syslog messages to a remote system. A value of 0 disables the message, and a value of 1 enables the message. AllowR5onNLDrives Enables or disables support for RAID-5 on NL drives. If disabled, new RAID-5 CPGs cannot be created on NL drives. HP strongly recommends RAID-6 for high-capacity NL drives. can be 'yes' or 'no'. The default is 'no'. AllowR0 Enables or disables support for RAID-0. If disabled, new RAID-0 CPGs cannot be created on this system. RAID-0 virtual volumes do not offer data protection. can be 'yes' or 'no'. The default is 'no'. setsysmgr DESCRIPTION The setsysmgr command sets the system manager startup state. CAUTION: Issuing the setsysmgr command can potentially remove the entire state of the system causing data loss. SYNTAX The syntax of the setsysmgr command can be one of the following: • setsysmgr wipe [-f] [] • setsysmgr tocgen [-f] [ []] • setsysmgr force_iderecovery [-f] • setsysmgr force_idewipe [-f] AUTHORITY • Super • Any role granted the sysmgr_set right. Specifies the ID of the system to be started. Specifies the table of contents generation number for the system to start with. Specifies the disk quorum for the system to start with. RESTRICTIONS • Access to all domains is required to run this command. • Use this command only when the system cannot start up normally. settask DESCRIPTION The settask command sets the priority on specified task. SYNTAX settask [-f] -pri AUTHORITY • Super, Edit • Any role that is granted the task_set right. OPTIONS -f Forces the command. The command completes the process without prompting for confirmation. -pri Specifies the priority of the task. SPECIFIERS Sets the priority on a task specified by the task ID. The must be an unsigned integer from 1 to 29999. settemplate DESCRIPTION The settemplate command modifies the properties of existing templates. SYNTAX settemplate ... [option ] AUTHORITY • Super • Any role granted the template_set right. NOTE: You need access to all domains in order to run this command. OPTIONS -remove NOTES • All option available for the createcpgcommand can be used with the settemplate command to modify an existing template. • Options preceded with –remove are removed from an existing template. • When adding options to a template, specify the option flag and its value (if any). • When removing options from a template, specify the option flag only. setuser DESCRIPTION The setuser command sets your user properties. SYNTAX setuser [options ] AUTHORITY • Super, Edit, Browse • Any role granted the user_setany right can add, remove, and set default domains for any user. • Any role granted the user_setown right can only set their own default domain. OPTIONS –f Specifies that the command is forced. No confirmation is requested before executing the command. -adddomain :[,:... setuseracl DESCRIPTION The setuseracl command sets the Access Control List (ACL). SYNTAX setuseracl [options] []... AUTHORITY • Super, Edit • Any role granted the useracl_set right. OPTIONS -add Adds names or patterns of objects at the end of an existing ACL. -remove Removes names or patterns of objects from an ACL. SPECIFIERS Specifies the name of the user whose ACL is being set. The following example shows how to remove vv3 from the ACL for user testuser1: cli% setuseracl -remove testuser1 updatevv vv3 The following example shows how to clear the ACL for user testuser1: cli% setuseracl testuser1 updatevv "" NOTES • The -add and -remove options are mutually exclusive. • If the names or pattern of objects to add already exist, the request is ignored. • If the names or pattern of objects to remove do not exist, the request is also ignored. setvv DESCRIPTION The setvv command changes the properties associated with a virtual volume. Use the setvv command to modify volume names, volume policies, allocation warning and limit levels, and the volume’s controlling common provisioning group (CPG). SYNTAX setvv [options ] ... AUTHORITY • Super, Edit • Any role granted the vv_set right can edit the properties of base volumes. • Any role granted the vvcopy_set right can edit the properties of physical copies of volumes. specified in days or hours providing either d or D for day and h or H for hours following the entered time value. NOTE: The -retain option requires the HP 3PAR Virtual Lock license. Contact your local service provider for more information. NOTE: If the volume is not in any domain, then its retention time cannot exceed the value of the system's maximum VV retention time. The default value for the system's maximum VV retention time is 14 days. Indicates a snapshot space allocation warning. Through this option you can generate a warning alert when the reserved snapshot space of the virtual volume exceeds the indicated percentage of the virtual volume size. -snp_al Indicates a snapshot space allocation limit. The snapshot space of the virtual volume is prevented from growing beyond the indicated percentage of the virtual volume size. The following example modifies the WWN of virtual volume vv1. cli% setvv -wwn 50002AC0001A0024 vv1 NOTES • Use the setvv command to associate a standard virtual volume with a common provisioning group (CPG) for use with remote copy. • To view policies assigned to the system's virtual volumes, issue the showvv -pol command. • It is not possible to rename a virtual volume that is already associated with a Remote Copy group. • Changing the CPG for a TPVV is not allowed. setvvset DESCRIPTION The setvvset command sets the parameters and modifies the properties of a Virtual Volume (VV) set. SYNTAX setvvset [options ] AUTHORITY • Super, Edit • Any role granted the vvset_annotate right can only annotate the comment of a volume set. • Any role granted the vvset_set right can set any volume set property. OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. setwsapi DESCRIPTION The setwsapi command sets properties of the Web Services API server, including options to enable or disable the HTTP and HTTPS ports. SYNTAX setwsapi [options] AUTHORITY Super, Service Any role granted the wsapi_set right OPTIONS -f Forces the operation of the setwsapi command, bypassing the typical confirmation message. At least one of the following options are required: -http enable|disable Enables or disables the HTTP port. -https enable|disable Enables or disables the HTTPS port. 23 Show Commands showalert DESCRIPTION The showalert command displays the status of system alerts. When issued without options, all new customer alerts are displayed. SYNTAX showalert [options] AUTHORITY Any role in the system. OPTIONS The selection of alerts to be displayed is controlled by selecting one of the following options: –n Specifies that only new customer alerts are displayed. –a Specifies that only acknowledged alerts are displayed. –f Specifies that only fixed alerts are displayed. EXAMPLES The following example displays new customer alerts on a system: cli% showalert -n Id : State : Message Code: Time : Severity : Type : Message : 1 New 0x2200de 2008-07-17 20:14:29 PDT Degraded Component state change Node 0, Power Supply 1, Battery 0 Degraded (Unknown) Id : State : Message Code: Time : Severity : Type : Message : 2 New 0xe000c 2008-07-17 20:15:31 PDT Informational Cluster shutdown after system recovery completion System recovery completed for node 0 (reason Power Loss) 2 alerts showaocfg DESCRIPTION The showaocfg command shows Adaptive Optimization (AO) configurations in the system. SYNTAX showaocfg [options [...|...] AUTHORITY Any role in the system. OPTIONS -domain Shows only AO configurations that are in domains with names matching one or more of the argument. This option does not allow listing objects within a domain of which the user is not a member. showauthparam DESCRIPTION The showauthparam command shows authentication parameters. SYNTAX showauthparam AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following is example output from the showauthparam command: cli% showauthparam Param -----------------Value----------------ldap-server xxx.xxx.xx.xx ldap-server-hn domaincontroller.work.com binding sasl sasl-mechanism GSSAPI kerberos-realm NTDOM1.work. showbattery DESCRIPTION The showbattery command displays battery status information including serial number, expiration date, battery life, and so on, which could be helpful when determining battery maintenance schedules. SYNTAX showbattery [options] [ ...] showbattery -listcols AUTHORITY Any role in the system. OPTIONS -listcols Lists the columns available to be shown with the -showcols option described below (see clihelp -col showbattery for help on each column). -showcols [,.. RESTRICTIONS None EXAMPLES The following example displays battery status information: cli% showbattery Node PS Bat Serial 0 0 0 FFFFFFFF 0 1 0 FFFFFFFF 1 0 0 -1 1 0 -- --State--- ChrgLvl(%) -ExpDate-- Expired OK 100 05/15/2007 No OK 100 05/15/2007 No NotPresent -- -No NotPresent -- -No Testing No No No No The columns in the previous example are identified as follows: • Node. The controller node number. • PS. The power supply number. • Bat. The battery ID. • Serial. The battery serial number. The following example displays the inventory information for the battery using the showbattery –i command: cli% showbattery -i Node PS Bat -Manufacturer0 0 0 -0 1 0 -1 0 0 -1 1 0 -- -Model----- -SerialFFFFFFFF FFFFFFFF --- • Node. The controller node number. • PS. The power supply number. • Manufacturer. The manufacturer of the battery. • Model. The battery model. • Serial. Indicates the serial number of the battery. The following example displays the detailed status of the battery using the showbattery –s command: cli% showbattery -state Node PS Bat -State- -Detailed_State0 0 0 OK Normal 0 1 0 OK Normal 1 0 0 OK Normal 1 1 0 OK Normal • Node. The controller node number. • PS. The power supply number. • Bat. The battery ID. • State. The current status of the battery and can be one of the following: • ◦ OK. The battery is operating normally. ◦ Failed. The battery is operating abnormally. ◦ Degraded. showblock DESCRIPTION The showblock command displays block mapping information for Virtual Volumes (VVs), Logical Disks (LDs), and Physical Disks (PDs). SYNTAX showblock [options ] [] AUTHORITY Any role in the system. OPTIONS –d Specifies that detailed information is displayed for the specified device and block. The following example displays detailed block mapping information for block 0 in the user space of VV admin: cli% showblock –d vv admin usr 0 VV/LD Name Block Region VV usr: admin 0x00000000 0x00000000–0x0007FFFF (0–256MB) LD : admin.usr. NOTES None showblock 349 showcage DESCRIPTION The showcage command displays information about drive cages. SYNTAX The syntax of the showcage command can be one of the following: • showcage [options] [-d] [...] • showcage [-sfp [-d|-ddm]] [...] • showcage -i [...] • showcage -svc -i [...] AUTHORITY Any role in the system. OPTIONS –d Specifies that more detailed information about the drive cage is displayed. EXAMPLES The following examples display information for a single system’s drive cages: cli% showcage Id Name LoopA Pos.A LoopB Pos.B Drives Temp RevA RevB Model Side 0 cage0 0:1:1 0 1:1:1 0 40 24-33 2.05 2.05 DC4 n/a 1 cage1 0:1:2 0 1:1:2 0 24 26-32 2.05 2.05 DC2 0 1 cage1 0:1:3 0 1:1:3 0 16 28-32 2.05 2.05 DC2 1 2 cage2 0:1:4 0 1:1:4 0 16 33-36 DC3 n/a 04 04 The columns in the previous example are identified as follows: • Id. The cage number. • Name. The name of the cage. Interface Board Info LoopA LoopB Firmware_status Current Current Product_Rev 03 03 IFC_State OK OK ESH_State OK OK Master_CPU Yes No Loop_Map valid valid Link_Speed 2Gbps 2Gbps Port0_State OK OK Port1_State No_SFP No_SFP Port2_State No_SFP No_SFP Port3_State No_SFP No_SFP Power Supply Info State Fan State AC Model ps0 OK MedSpeed OK -ps1 OK MedSpeed OK --------------Drive Info------------- ----LoopA----- ----LoopB----Drive 0:0 3:0 4:0 7:0 8:0 11:0 12:0 15:0 NodeWWN State Temp(C) ALPA LoopState ALPA LoopSta State Normal Op Loop_Split 0 VendorId,ProductId 3PARdata,DC4 Unique_ID 1062010000001C00 Power Supply Info State Fan State AC Model ps0 OK OK OK POI ps1 OK OK OK POI ps2 OK OK OK POI ps3 OK OK OK POI -----Magazine Info----- ---State--Mag SysLED HplLED Disks LoopA LoopB 0 Green Off 4 Ready Ready 1 Green Off 4 Ready Ready 2 Green Off 4 Ready Ready ... showcert DESCRIPTION The showcert command shows SSL certificate information for the storage system. The first form of this command is used to display the certificate in readable format and the second displays the certificate in PEM (Privacy Enhanced Mail) format and also saves the certificate in the specified file in PEM format when —file option is used. showcim DESCRIPTION The showcim command displays the CIM server current status, either active or inactive. It also displays the current status of the HTTP and HTTPS ports and their port numbers. In addition, it shows the current status of the SLP port, that is either enabled or disabled. SYNTAX showcim AUTHORITY Any role in the system. • HTTP. Indicates the HTTP port state. ◦ --. Cannot determine the HTTP port state. ◦ Enabled. HTTP port is enabled. ◦ Disabled. HTTP port is disabled. • HTTPPort. HTTP port (1024 - 65635). The default value is 5988. • HTTPS. The HTTPS port state. ◦ --. Cannot determine the HTTPS port state. ◦ Enabled. HTTPS port is enabled. ◦ Disabled. HTTPS port is disabled. • HTTPSPort. The HTTPS port (1024 - 65535). The default value is 5989. • PGVer. The Pegasus version. • CIMVer. showclienv DESCRIPTION The showclienv command displays the CLI environment parameters. SYNTAX showclienv AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the currently set CLI environment variables for sample system TestSystem: cli% showclienv Parameter Value csvtable 0 nohdtot 0 hafter -1 listdom 0 editor emacs NOTES See the setclienv command for a complete description of the environment parameters. showcpg DESCRIPTION The showcpg command displays Common Provisioning Groups (CPGs) in the system. SYNTAX showcpg [options ] [...|...] AUTHORITY Any role in the system. OPTIONS The following options cannot be used together with other options except -hist and -domain: -d Show the detail information of CPGs. –r Specifies that raw space used by the CPGs is displayed. –alert Indicates whether alerts are posted. –alerttime Show times when alerts were posted (when applicable). EXAMPLES The following example displays a system’s CPGs: cli% showcpg ---------------(MB)---------------Volumes- -Usage- --- Usr --- --- Snp --- -- Adm --Id Name Warn% VVs TPVVs Usr Snp Total Used Total Used Total Used 0 cpg1 2 0 2 1 15360 15360 32768 0 8192 0 1 cpg2 2 2 0 2 0 0 32768 1024 8192 256 2 cpg3 1 1 0 1 0 0 32768 512 8192 128 ------------------------------------------------------------------3 total 2 4 15360 15360 98304 1536 24576 384 The columns for the previous example output are identified as • Warn%. The CPG’s allocation warning threshold. • Volumes. Virtual Volumes (VVs) and Thinly Provisioned Virtual Volumes (TPVVs). • VVs. The Number of VVs (including TPVVs) using the CPG. • TPVVs. The number of TPVVs using the CPG. • Usage. Virtual Volumes using the CPG. • Usr. The number of VVs whose User Space is using the CPG. • Snp. The number of VVs whose Snapshot Space is using the CPG. • Usr. User space. • Total. The total logical disk space in MBs in the Usr space. • Used. 1 cpg2 2 cpg3 3 cpg4 - 32768 - 32768 - 32768 - - - - - - - - - - - - 8192 8192 8192 - - The columns in the previous example are identified as follows: • Id. The physical disk ID. • Name. The name of the common provisioning group. • Warn%. The allocation warning percentage (see –aw option of the createcpg or setcpg command). • Total. The total logical disk MB space in a CPG. • Warn. The size in MB of the space at which a warning alert is generated. • Limit. • Usr. The number of VVs whose User Space is using the CPG. • Snp. The number of VVs whose Snapshot Space is using the CPG. • Usr. User space. • Total. The total logical disk space in MBs in the Usr space. • RTotal. The total raw MBs of (raw) space in the Usr space. • Used. The total logical disk space in MBs used in Usr space. • RUsed. The total MBs of (raw) space used in the Usr space. • Snp. Snap space. • Total. The total logical disk space in MBs in the Snp space. • RTotal. showdate DESCRIPTION The showdate command displays the date and time for each system node. SYNTAX showdate AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the date and time for the system node: cli% Node 0 1 showdate Date Mon Apr 17 17:07:44 PDT 2007 (US/Pacific) Mon Apr 17 17:07:44 PDT 2007 (US/Pacific) NOTES Set date and time information on nodes by issuing the setdate command. showdomain DESCRIPTION The showdomain command displays a list of domains in a system. SYNTAX showdomain [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies that detailed information is displayed. –sortcol [,][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. NOTES If the VVRetentionTimeMax is--, then the minimum volume retention time for the system is used instead. If the VVRetentionTimeMax is 0, then the volume retention time in the domain is disabled. showdomainset DESCRIPTION The showdomainset command lists the host sets defined on the HP 3PAR storage system and their members. SYNTAX showdomainset [options] [...] showdomainset -domain [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -domain Show domain sets that contain the supplied domains or patterns SPECIFIERS ... An optional list of or . Show domain sets containing domains matching the pattern domainset.*: cli% showdomainset -domain domainset.* Id Name Members 7 domainset domainset.1 domainset. showeeprom DESCRIPTION The showeeprom command displays node EEPROM log information. SYNTAX showeeprom [options] [...] AUTHORITY Any role in the system. OPTIONS –dead Specifies that an EEPROM log for a node that has not started or successfully joined the cluster be displayed. If this option is used, it must be followed by a list of nodes. SPECIFIERS ... Specifies the node ID for which EEPROM log information is retrieved. Multiple node IDs are separated with a single space (0 1 2). Code Code Code Code Code Code 20 25 20 25 20 10 (AP Init Failure) - Subcode 0x0 (0) (PROM Failure) - Subcode 0x1 (0) (AP Init Failure) - Subcode 0x0 (0) (PROM Failure) - Subcode 0x1 (0) (AP Init Failure) - Subcode 0x0 (0) (PCI Failure) - Subcode 0xd (30) Tue Tue Tue Tue Tue Mon Jan Jan Jan Jan Jan Jan 29 29 29 29 29 14 13:30:56 13:17:57 13:17:28 13:14:49 13:04:57 18:17:12 2008 2008 2008 2008 2008 2008 Node: 1 -------Board revision: Assembly: System serial: BIOS version: OS version: Reset reason: Las • Last panic displays the last time another node in the cluster requested this node to take a panic. • Error ignore code is for engineering use only. • SMI context is for engineering use only. • Last HBA mode contains PCI Fibre port settings forcing certain ports to start up in initiator mode and certain ports to start up in target mode. • BIOS state is for engineering use only. • TPD state is for engineering use only. showencryption DESCRIPTION The showencryption shows Data Encryption information. AUTHORITY • Super, Service • Any role granted the control_encryption_status right SYNTAX showencryption [options] OPTIONS -d Provides details on the encryption status. SPECIFIERS None NOTES If the state shows recovery_needed, the enable or latest rekey operation failed. Re-issue the operation to fix this state. Also see “controlencryption” (page 81). showeventlog DESCRIPTION The showeventlog command displays the current system event log. SYNTAX showeventlog [options ] AUTHORITY Any role in the system. OPTIONS –min Specifies that only events occurring after the specified number of minutes are shown. The is an integer from 1 through 2147483647. –more Specifies that you can page through several events at a time. –oneline Specifies that each event is formatted on one line. –d Specifies that detailed information is displayed. Specified as the month (mm or month_name) and day (dd), where the year (yy) can be optionally specified. Acceptable formats are mm/dd/yy, month_name dd, dd month_name yy, or yy–mm–dd. If the syntax yy–mm–dd is used, the year must be specified. NOTE: The pattern argument in the following options is a regular expression pattern that is used to match against the events each option produces. For each option, the pattern argument can be specified multiple times. For example: showeventlog –type Disk. EXAMPLES The following example displays the system events occurred during the last 20 minutes: cli% showeventlog -min 20 Mon Sep 29 09:48:07 2003 PST Node: 0, Seq: 51, Class: Status change, Severity: Informational, Type: Node booted Node 0 has booted Mon Sep 29 09:48:13 2003 PST Node: 1, Seq: 50, Class: Status change, Severity: Informational, Type: Node booted Node 1 has booted Mon Sep 29 09:48:53 2003 PST Node: 0, Seq: 334, Class: Status change, Severity: Informational, Type: Cage loop status Cage 0 is con showfirmwaredb DESCRIPTION The showfirmwaredb command displays the current database of firmware levels for possible upgrade. If issued without any options, the firmware for all vendors is displayed. SYNTAX showfirmwaredb [options ] AUTHORITY Any role in the system. OPTIONS –n Specifies that the firmware vendor from the SCSI database file is displayed. –l Reloads the SCSI database file into the system. –all Specifies current and past firmware entries are displayed. HITACHI [JLAK] DK..CJ-36FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [JLAK] DK..CJ-72FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-18FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-36FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [GLAK] DK..CJ-72FC Current /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [C0C0] DK..EJ-36FC Current /opt/tpd/fw/drive/MEJFC0C0.BIN HITACHI [C0C0] DK..EJ-72FC Current /opt/tpd/fw/drive/MEJFC0C0.BIN HITACHI [C0C0] DK.. showhost DESCRIPTION The showhost command displays information about defined hosts and host paths in the system. SYNTAX showhost [options ] [...|...|...] AUTHORITY Any role in the system. OPTIONS –d Shows a detailed listing of the host and path information. This option can only be used with -agent and -domain options. -verbose Shows a verbose listing of all host information. -chap Shows the CHAP authentication information. -desc Shows the host descriptor information. Shows only hosts that are in domains or domain sets that match one or more of the specifier or set: arguments. The set name must start with set:. This option does not allow listing objects within a domain of which the user is not a member. SPECIFIERS ... Name of the host up to 31 characters in length. This specifier can be repeated to set properties for multiple hosts. ... 0 queasy10 queasy10 1 foo -- s019 -- The following example displays all host information: cli% showhost –verbose Id Name Persona -----WWN/iSCSI_Name----- Port IP_addr 0 queasy10 Generic 210000E08B027B60 0:0:1 n/a 1 foo Generic myiscsipath.3pardata.com --0.0.0. showhostset DESCRIPTION The showhostset command lists the host sets defined on the HP 3PAR storage system and their members. SYNTAX showhostset [options] [...] showhostset -host [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -host Show host sets that contain the supplied hostnames or patterns. SPECIFIERS ... An optional list of setnames or patterns. Show the host sets containing host sun40z-09-0: cli% showhostset -host sun40z-09-0 Id Name Members 3 sunv40z-09 sunv40z-09-0 sunv40z-09-1 sunv40z-09-2 sunv40z-09-3 NOTES A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set. Run cli -h and setclienv -h for details of the environment variables. showinventory DESCRIPTION Shows information about all the hardware components in the system. SYNTAX showinventory [options] AUTHORITY Any role in the system. OPTIONS -svc Displays inventory information with HP serial number, spare part number, and so on. This option must be used with the -i option and it is supported only on HP 3PAR StoreServ 7000 Storage systems. showiscsisession DESCRIPTION The showiscsisession command shows the iSCSI sessions. SYNTAX showiscsisession [option ] AUTHORITY Any role in the system. OPTIONS –sortcol [,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. • iSCSI_Name. The iSCSI name of the host. • StartTime. The time the session was started. showld DESCRIPTION The showld command displays configuration information about the system’s Logical Disks (LDs). SYNTAX showld [options ] [|...] AUTHORITY Any role in the system. OPTIONS –cpg ... Requests that only logical disks in Common Provisioning Groups (CPGs) that match the specified CPG names or patterns be displayed. Multiple CPG names or patterns can be repeated using a comma-separated list (for example -cpg ,...). SPECIFIERS ... Requests that information for a specified logical disk is displayed. This specifier can be repeated to display configuration information about multiple logical disks. If not specified, configuration information for all logical disks in the system is displayed. ... Specifies that the logical disk matching the specified glob-style pattern is displayed. This specifier can be repeated to display configuration information about multiple logical disks. • RAID. The RAID type (0 is for RAID-0, 1 is for RAID-1, 5 is for RAID-5, and 6 is for RAID-6). • State. The current status of the logical disk. ◦ normal. The logical disk has started and is available for use. ◦ orphan. Both the primary owner and backup owner nodes are down, and the logical disk’s data is not available. ◦ preserved. Some disks used by the logical disk are missing. Data belonging to the logical disk is saved on the preserved logical disk. ◦ stopped. 0 log0.0 --1 0/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 1 log1.0 --1 1/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 2 pdsld0.0 --1 0/1 4096 8192 2 256 2 0 mag mag 2007-11-29 18:44:03 PST -p -devtype FC 3 admin.usr.0 --1 0/1 5120 10240 2 256 2 0 mag mag 2007-11-29 18:44:12 PST -p -devtype FC 4 admin.usr.1 --1 1/0 5120 10240 2 256 2 0 mag mag 2007-11-29 18:44:12 PST -p -devtype FC 5 Collie.usr. The following example displays policy information about all system LDs: cli% showld -p Id Name Keep_Preserved Dev_Type RPM 0 log0.0 0 0 FC 10 1 log1.0 0 0 FC 10 2 pdsld0.0 0 0 FC 10 3 pdsld0.1 0 0 FC 10 4 pdsld0.2 0 0 FC 10 5 admin.usr.0 1 0 FC 10 6 admin.usr.1 1 0 FC 10 7 admin.usr.2 1 0 FC 10 8 admin.usr.3 1 0 FC 10 9 tp-0-sa-0.0 1 0 FC 10 10 tp-0-sa-0.1 1 0 FC 10 11 tp-0-sa-0.2 1 0 FC 10 14 tp-0-sa-0.4 1 0 FC 10 15 v1.0.usr.0 1 0 FC 10 16 v1.1.usr.0 1 0 FC 10 17 tp-0-sd-0.1 1 1 FC 10 18 tp-0-sd-0. The columns in the previous example are identified as follows: • Id. The logical disk ID. • Name. The logical disk name. • State. The current state of the LD that is one of the following: • ◦ normal. The LD is operating normally. ◦ failed. The LD is operating abnormally. ◦ degraded. The LD is in degraded state. Detailed_State. The detailed state of the LD that is one of the following: ◦ nodes_unavail. The nodes are down. ◦ not_stated. showldch DESCRIPTION The showldch command displays configuration information about the chunklet mapping for one Logical Disk (LD). SYNTAX showldch [options ] AUTHORITY Any role in the system. OPTIONS -degraded Show only the chunklets in sets that cause the LD availability to be degraded. For example, if the LD normally has cage level availability, but one set has two chunklets in the same cage, then the chunklets in that set are shown. 3 4 5 6 7 8 9 10 11 12 13 14 15 0 0 0 0 0 0 0 0 0 0 0 0 0 1 2 2 3 3 4 4 5 5 6 6 7 7 1:3:0 0:1:2 2:1:3 0:2:0 1:2:2 2:3:3 1:1:2 2:2:3 0:3:0 0:0:0 1:0:2 2:0:1 2:0:2 28 6 39 8 26 47 22 43 12 0 18 33 34 0 0 0 0 0 0 0 0 0 0 0 0 5 normal normal normal normal normal normal normal normal normal normal normal normal normal ld ld ld ld ld ld ld ld ld ld ld ld ld valid valid valid valid valid valid valid valid valid valid valid valid valid N N N N N N N N N N N N N ------------------------16:1 -------------- • Media. The current status of the physical disk medium for the chunklet. ◦ valid. The chunklet is available for use. ◦ failed. The medium has encountered errors and is not available for use. • Sp. The spare status of the chunklet; Y indicates the chunklet is used for spare, N indicates the chunklet is not used as spare. • From. The initial location of the chunklet before relocation. • To. 4 4 0 47-2:3:3 18-1:0:2 14-0:3:2 33-2:0:1 1 2-0:0:2 28-1:3:0 37-2:1:1 22-1:1:2 NOTES None 394 Show Commands showldmap DESCRIPTION The showldmap command displays the mapping from a Logical Disk (LD) to Virtual Volumes (VVs). SYNTAX showldmap AUTHORITY Any role in the system. OPTIONS None SPECIFIERS Specifies the LD name. RESTRICTIONS None EXAMPLES The following example displays the region of LD v0.usr.0 that is used for a VV: cli% showldmap v0.usr. showlicense DESCRIPTION The showlicense command displays the currently installed license key and current license information. SYNTAX showlicense AUTHORITY Any role in the system. OPTIONS –raw Specifies that the license key originally entered (the raw license) be displayed. The license key is displayed in a manner that is acceptable input for the setlicense command. SV47–NH2R–BL1L–TJKR–31F2–V9QX–0WM0–AWTH LRB7–8XQD–BLHD–LF68–A4BW–K4QG–ZS7B–Q41X 35Y1–6CZC–KBJ5–6VQE–EC2G–Q6EG–SJV0–KMHC SAWG–YJ4V–WRE5–3GZA–DGW0–ZYVE–5SVT–8TJX QR9W–R92D–SSTY–RVWY–1Y2B–YH8D–KRN5–ZZ7Y... NOTES Without options, a description of which features are enabled is displayed. When the license was generated and any expiration dates are also shown. If the -raw option is specified, the license key prints in a manner that is acceptable input for the setlicense command. shownet DESCRIPTION The shownet command displays the configuration and status of the administration network interfaces, including the configured gateway and Network Time Protocol (NTP) server. SYNTAX shownet [option] AUTHORITY Any role in the system. OPTION –d Displays detailed information. SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the status of the system administration network interfaces: cli% shownet -d IP Address: 192.168.5. RX RX RX RX RX RX RX Bytes: Errors: Dropped: FIFO Errors: Frame Errors: Multicast: Compressed: 0 0 0 0 0 0 0 Admin interface on node 1 MAC Address: 00:02:AC:43:00:33 RX Packets: 477147 RX Bytes: 59353196 RX Errors: 0 RX Dropped: 0 RX FIFO Errors: 0 RX Frame Errors: 0 RX Multicast: 0 RX Compressed: 0 ... shownode DESCRIPTION The shownode command displays an overview of the node-specific properties and its component information. Various command options can be used to display the properties of PCI cards, CPUs, physical memory, disk drives, and power supplies. SYNTAX shownode [option] [...] AUTHORITY Any role in the system. Specifies detailed information in verbose format. It can be used with any of the following component options: -fan Displays the node fan information. –pci Displays PCI card information. –cpu Displays CPU information. –mem Displays physical memory information. -drive Displays the disk drive information. –ps Displays power supply information. -mcu Displays MicroController Unit information. -state Displays the detailed state information for the node or power supply (proceed with the -ps option). In the example above: • Node. The node ID. • Name. The node name. • State. The state of the node. Values are as follows: ◦ --. Cannot determine the overall node state. ◦ OK. The node and its components are operating normally. ◦ Degraded. For T-Series and S-Series nodes, the node is degraded due to a missing, failed, or degraded power supply. For E-series nodes, the node is degraded to due a missing or degraded fan. ◦ Failed. 1 4-slot 2048 1 4-slot 2048 1 J0900 DIMM1.0 Data DDR_SDRAM Micron Technology E010DF97 CL2.0/2.5 2 J1300 DIMM2.0 Data DDR_SDRAM Micron Technology E010DF96 CL2.0/2.5 ----------------------------Internal Drives---------------------------Node Drive -Manufacturer- ---Model--- -Serial- -Firmware- Size(MB) Type 0 0 Seagate ST9100821AS 5NJ09DF3 3.AAB 95396 SATA 1 0 Seagate ST9100821AS 5NJ08NA4 3.AAB 95396 SATA These columns and values are described in detail in the following examples. 0 1 0 Seagate 0 Seagate ST9100821AS 5NJ09DF3 3.AAB ST9100821AS 5NJ08NA4 3.AAB 95396 SATA 95396 SATA In the example above: • Node. The node ID. • Drive. The disk drive ID. • Manufacturer. The manufacturer of the disk drive. • Model. The model number of the disk drive. • Serial. The serial number of the disk drive. • Firmware. The firmware version on the disk drive. • Size. The drive size in MB. • Type. The type of disk drive. • CPUSpeed. The speed of the CPU in MHz. • BusSpeed. The bus speed of the CPU in MHz. cli% shownode -ps -------------------------Power Supplies-------------------------Node PS -PSState-- FanState ACState DCState -BatState- ChrgLvl(%) 0 0 NotPresent ---NotPresent 0 0 1 OK OK OK OK OK 100 1 0 OK OK OK OK OK 100 1 1 NotPresent ---NotPresent 0 In the example above: • Node. The node ID. • PS. The power supply ID. • PSState. The power supply state. Values are as follows: • • • • ◦ --. • ◦ NotPresent. The battery is missing. ◦ MaxLifeLow. The maximum battery life is low. ChrgLvl. The battery charge level in percentage. The following example displays the detailed state of the nodes: cli% shownode -state Node 0 1 2 3 -StateOK OK OK OK -Detailed_StateOK OK OK OK In the example above: • Node. The node ID. • State. The state of the node. Values are as follows: • ◦ OK. The node and its components are operating normally. ◦ Degraded. The following example displays the detailed state of the power supplies: cli% shownode -ps Node PS -State- -Detailed_State0 0 OK OK 1 1 OK OK 2 2 OK OK 3 3 OK OK In the example above: • Node. The node ID. • PS. The power supply ID. • State. The power supply state. Values are as follows: • ◦ OK. The power supply is operating normally. ◦ Failed. The power supply is operating abnormally. ◦ NotPresent. The power supply is missing. ◦ Degraded. The fan failure or battery state is not OK. shownodeenv DESCRIPTION The shownodeenv command displays the node operating environment status, including voltages and temperatures. SYNTAX shownodeenv [options ...] AUTHORITY Any role in the system. OPTIONS –n ... Specifies the ID of the node whose environment status is displayed. Multiple node IDs can be specified as a series of integers separated by a space (1 2 3). If no option is used, then the environment status of all nodes is displayed. LM87 Ext CPU0 CPU1 CPU0 VRM CPU1 VRM CPU DIMM0 CPU DIMM1 Temp: Temp: Temp: Temp: Temp: Temp: Temp: 20 C 24 C 25 C n/a n/a 37 C 38 C -10 C 0 C 0 C n/a n/a 0 C 0 C 65 C 85 C 85 C n/a n/a 105 C 105 C Within Within Within Within Within Within Within Measurement Reading Lo Limit Hi Limit Status Tolerance Tolerance Tolerance Tolerance Tolerance Tolerance Tolerance Node 1 --------... showpatch description The showpatch command displays patches applied to a system. SYNTAX showpatch [option ] AUTHORITY Any role in the system. OPTIONS –hist Specifies the history of all patches and updates applied to the system. –d Specifies the details on a specified patch ID. SPECIFIERS None RESTRICTIONS None EXAMPLES The showpatch command is specific to each individual patch and typically displays these fields: • Patch ID. Specifies the patch ID. • Release Version. showpd DESCRIPTION The showpd command displays configuration information about a system’s Physical Disks (PDs). SYNTAX showpd [options] [...] showpd -listcols AUTHORITY Any role in the system. OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showpd for help on each column). The [options] are generally of two kinds: those that select the type of information that is displayed, and those that filter the list of PDs that are displayed. The following columns are shown: Id, CagePos, Type, State, Detailed_State. -s Show detailed information regarding the state of each PD. This option is deprecated and will be removed in a future release. -path Shows current and saved path information for disks. The following columns are shown: ID, CagePos, Type, State, Path_A0, Path_A1, Path_B0, Path_B1, Order. Path_A1 and Path_B1 are only shown for systems with drive chassis that are connected to four nodes. Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–3). The primary path of the disks must be on the specified port(s). –cg - Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3). A range of drive cages is separated with a hyphen (0–3).
performance benchmark that takes into account in I/O per second, bandwidth and the access time. Disks that satisfy all of the specified characteristics are used. For example -p -fc_gt 60 -fc_lt 230 -nd 2 specifies all the disks that have greater than 60 and less than 230 free chunklets and that are connected to node 2 through their primary path. –nodes Specifies that the display is limited to specified nodes and physical disks connected to those nodes. • FC – Fibre Channel • NL – Nearline • SSD – Solid State Drive • RPM – The maximum RPM speed of the physical disk. • State – State of the PD can be one of the following: ◦ normal – PD is normal ◦ degraded – The PD is not operating normally. Use showpd -s to find out the detail information. ◦ new – The PD is new, needs to be admitted before it can be used (see help admitpd) ◦ failed – The PD has failed. • Total. Total size of the disk in MB (1024^2 bytes). • Free. • NL – Nearline • SSD – Solid State Drive • State. State of the PD can be one of the following: ◦ normal – PD is normal. ◦ degraded – The PD is not operating normally. Use showpd -s to find out the detail information. ◦ new – The PD is new, needs to be admitted before it can be used (see help admitpd). ◦ failed – The PD has failed. • Total. Total size of the disk in MB (1024^2 bytes). • Normal Chunklets. This area provides information about chunklets that are not reserved for use as spares. • Node_WWN. Node World Wide Name of the disk. • MFR. Physical disk manufacturer. • Model. Physical disk manufacturer’s device ID. • Serial. Physical disk manufacturer’s serial number. • FW_Rev. Physical disk manufacturer’s firmware revision tracking string. • Spare Chunklets. This area provides information about chunklets that are reserved for use as spares. • OK. Number of chunklets with data that is accessible to the system. • Fail. Number of failed chunklets. • Free. Number of initialized but currently unused chunklets available for use by logical disks. • Uninit. Number of chunklets being cleaned. • Unavail. Number of chunklets that are unavailable for use. The following example displays the states of each physical disk: cli% showpd ID CagePos 0 0:0:0 1 0:0:1 2 0:0:2 3 0:0:3 4 0:1:0 5 0:1:1 6 0:1:2 7 0:1:3 8 1:2:0 9 1:2:1 10 1:2:2 11 1:2:3 12 1:3:0 13 1:3:1 14 1:3:2 15 1:3:3 -state Type -State- -Detailed_StateFC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal FC normal normal The columns in the previous example are identified as follows: • ID. Physical disk ID, as assigned by the system. For unadmitted disk the ID appears as dashes (––). • CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine. The following example displays all disk in magazine 0 of cage 0 and 1: cli% showpd -p -mg 0 -cg 0,1 --Size(MB)--- ----Ports---ID CagePos Type RPM State Total Free A B 0 0:0:0 NL 7 degraded 715008 684288 0:0:1* 1:0:1 8 1:0:0 FC 10 normal 69632 2560 0:0:2* 1:0:2 ------------------------------------------------------------2 total 784640 686848 NOTES • In the showpd output, when the position of the disk is not valid (for example, in the case of a missing disk), the most recent position might be displayed, fol showpdata DESCRIPTION The showpdata command displays information about the preserved data in the system. SYNTAX showpdata [] AUTHORITY Any role in the system. OPTIONS None SPECIFIERS [] Requests that preserved data for a specific Logical Disk (LD) is displayed. This specifier is not required on the command line. If not specified, then the amount of preserved data by LD is displayed. RESTRICTIONS Access to all domains is required to run this command if no LD name is specified. showpdch DESCRIPTION The showpdch command displays the status of selected Physical Disk (PD) chunklets. SYNTAX showpdch [options] showpdch [options] |... (deprecated usage) AUTHORITY Any role in the system. OPTIONS The following filtering options specify conditions that a chunklet should meet in order for the chunklet to be displayed. Multiple conditions can be specified and a chunklet will be displayed if any of the specified conditions are met. inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows with the same information in them as earlier columns will be sorted by values in later columns. –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating LDs. If no pattern is specified, the option defaults to all Fibre Channel (FC) disks. –tc_gt Specifies that PDs with total chunklets greater than the number specified are selected. –tc_lt Specifies that PDs with total chunklets less than the number specified are selected. –fc_gt Specifies that PDs with free chunklets greater than the number specified are selected. –fc_lt Specifies that PDs with free chunklets less than the number specified are selected. –devid Specifies that PDs identified by their models are selected. The columns in the previous example are identified as follows: • Pdid. The physical disk on which the chunklets reside. • Chnk. The chunklet number. • LdName. The name of the logical disk that is using the spare chunklet. • LdCh. The position of the chunklet on the logical disk. • State. The state of the chunklet as identified by the kernel. • • ◦ logging. I/O to the chunklet is written to the logging logical disk. ◦ playback. Data is played back from the logging logical disks. ◦ passthru. NOTES None showpdch 427 showpdvv DESCRIPTION The showpdvv command displays the virtual volumes hat are mapped to a particular physical disk. SYNTAX showpdvv [options] [ [:]...] AUTHORITY Any role in the system. OPTIONS -sum Shows number of chunklets used by virtual volumes for different space types for each physical disk. –p PDs matching the specified pattern are displayed. –dk - Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments, –tc_gt , –tc_lt , –fc_gt , –fc_lt , –devid , and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive.
Specifies the physical disk ID using an integer. This specifier is not required if -p option is used, otherwise it must be used at least once on the command line. [:] Specifies the chunklet number in a physical disk to which virtual volumes are mapped. This specifier is not required. This specifier is not required. This specifier cannot be used along with -p option. showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX showport [options] [-failed] [-sortcol [,]][ |...] AUTHORITY Any role in the system. OPTIONS -i Show hardware and inventory formation. -c Displays all devices connected to the port. Such devices include cages (for initiator ports), hosts (for target ports) and ports from other storage systems (for RCFC and peer ports).Displays only failed ports. -state Displays the detailed state information. -s Displays the detailed state information. This option has been deprecated and will be removed in a future release. -ids Displays the identities hosted by each physical port. –sortcol [,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified.0:0:2 initiator 0:0:3 target 1:0:3 0:0:4 target 0:3:1 target 1:3:1 0:3:2 initiator 0:4:1 target 1:4:1 0:4:2 target 1:4:2 0:5:1 initiator 0:5:2 target 1:5:2 0:6:1 peer 1:0:1 target 0:0:1 1:0:2 initiator 1:0:3 target 0:0:3 1:0:4 initiator 1:3:1 target 0:3:1 1:3:2 initiator 1:4:1 target 0:4:1 1:4:2 target 0:4:2 1:5:1 initiator 1:5:2 target 0:5:2 1:6:1 peer - ready loss_sync none ready loss_sync none ready ready none loss_sync none ready ready none offline ready none ready loss_sync none ready loss_sync none l ◦ error. Currently in an error state. ◦ non_participate. Link not participating. ◦ taking_coredump.Coredump in progress. ◦ offline. Link is offline. ◦ fw_dead. Firmware dead. ◦ link_idle_for_reset. Link is idle for reset. ◦ dhcp_in_progress. DHCP is in progress. ◦ pending_reset. Link reset is pending. ◦ unknown. Link state is unknown. • Node_WWN. The WWN that belongs to the controller node identified in the N:S:P column. • Port_WWN/HW_Addr. ◦ failed_over Failed over to partner ◦ active The partner port is failed over to this port ◦ active_down The partner port is failed over to this port, but this port is down ◦ failback_pending In the process of failing back from partner The following example displays hardware and connection information about the ports settings: cli% showport -i N:S:P Brand Model Rev Firmware Serial 1:2:1 3PAR FC044X 08 1.02.N.5 00981760001d6187 1:2:2 3PAR FC044X 08 1.02.N.5 00981760001d6187 1:2:3 3PAR FC044X 08 1.02. • VCN. VLUN State Change Notification support setting. Valid values are n/a, enabled or disabled. When enabled and in public loop or fabric topology, a Registered State Change Notification (RSCN) message is issued to the fabric controller whenever a VLUN is created or removed. • IntCoal. Indicates whether the interrupt coalesce setting is Enabled or Disabled. 0:3:1 ready offline 0:3:1 ready offline 0:5:1 ready loss_sync -------------------------------10 The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the syntax node:slot:port. • State. State of the port. The states are as follows: • ◦ config_wait. The link configuration is waiting. ◦ alpa_wait. The link ALPA is waiting. ◦ login_wait. The link login is waiting. ◦ ready. The link is online and ready for use. Detailed State. ◦ error. Fibre Channel adapter has experienced an unrecoverable error. ◦ non_participate. Port is logically isolated from the FC loop. ◦ offline. The port is offline. • HwAddr. A unique identifier of the port hardware used for remote-copy connection. For an RCIP port, it is the MAC address of the port. • IPAddr. The IP address of the remote-copy interface. • Netmask. Netmask for the Ethernet port. • Gateway. Gateway address for the remote-copy interface. • MTU. State : Manufacturer : Part Number : Serial Number : Revision : MaxSpeed(Gbps): Qualified : TX Disable : TX Fault : RX Loss : RX Power Low : DDM Support : Degraded PICOLIGHT PL-XPL-VE-S24-31 425EF1E6 N/A 2.10 No ---No No ----------Port 1:3:1----------N:S:P : 1:3:1 State : OK Manufacturer : FINISAR_CORP. Part Number : FTLF8519P2BNL Serial Number : U76031S Revision : A MaxSpeed(Gbps): 2. showportarp DESCRIPTION The showportarp command shows the ARP table for iSCSI ports in the system. SYNTAX showportarp [::] AUTHORITY Any role in the system. OPTIONS None SPECIFIERS [::] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot. showportdev DESCRIPTION The showportdev command displays detailed information about devices on a specified port. SYNTAX showportdev loop|all|ns|sas|fcswitch|fcfabric showportdev sas [options] AUTHORITY Any role in the system. SUBCOMMANDS loop Specifies that information is returned for arbitrated loop devices that are attached to the specified port. This subcommand is only for use with Fibre Channel arbitrated loop ports. Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot. RESTRICTIONS The loop subcommand is functional only in a private loop topology. NOTES The loop subcommand is functional only in a private loop topology. showportisns DESCRIPTION The showportisns command shows iSNS host information for iSCSI ports in the system. SYNTAX showportisns [::] AUTHORITY Any role in the system. OPTIONS None SPECIFIERS [] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. port Specifies the iSCSI port number of the PCI card in the specified PCI bus slot. showportlesb DESCRIPTION The showportlesb command displays Fibre Channel Link Error Status Block (LESB) counters (the number of errors accumulated for Fibre Channel devices). The LESB is composed of six counters that can measure Fibre Channel signal integrity or status. • dd monthname [yy], where dd is the day and yy is the year (optional). • yy–mm–dd, where yy is the year, mm is the month, and dd is the day. –endt pd4 0x76 pd3 0x79 pd2 0x80 pd1 0x81 pd0 0x88 Port <0:0:1> 1 1 1 1 1 4 4 4 4 4 0 0 0 0 0 0 0 0 0 0 334 401 344 270 401 0 0 0 0 0 Loop <0:0:1> Time since last save: 0:00:28 ID ALPA LinkFail LossSync LossSig PrimSeq InvWord InvCRC <0:0:1> 0xef 1 19 19 0 0 0 pd7 0x6d 1 5 0 0 465 0 pd6 0x72 1 5 0 0 890 0 pd5 0x73 1 4 0 0 969 0 pd4 0x76 1 5 0 0 761 0 pd3 0x79 1 4 0 0 815 0 pd2 0x80 1 4 0 0 925 0 pd1 0x81 1 7 0 0 3283 0 pd0 0x88 1 258 0 0 269 0 LESB compare completed The following example displays the coun • LossSig. Loss of signal (electrical or optical) to the receiver port of a Fibre Channel node. • PrimSeq. Primitive Sequence Protocol Error. There were errors during the transmission of a Fibre Channel primitive sequence. This might indicate an error during the loop recovery or initialization. • InvWord. Invalid Transmission Word. Illegal Fibre Channel transmission word received. • InvCRC. Invalid Cyclical Redundancy Check. Data corruption in the Fibre Channel frame. showqos DESCRIPTION The showqos command lists the QoS rules configured in a system. SYNTAX showqos [options][{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY Any role in the system OPTIONS -domain {}... Shows statistics for rules with target objects in domains with names that match one or more of the specified domains or patterns. If -domain is not specified, statistics for all rules with target objects in the current domain are shown. -------------------------------------------------------------------------4 total Only show QoS rules that are on: cli% showqos -on -I/O_per_second- -KBytes_per_secId Type Name QoS Priority Min Max Min Max LatencyGoal 43 vvset vsb on normal - 4000 - 204800 44 vvset vsc on normal - 102400 45 vvset vsd on normal - 5000 - 256000 -------------------------------------------------------------------------3 total Show QoS rules containing VV vv1: cli% showqos -vv vv1 -I/O_per_second- -KBytes_per_secId Type Name Qo showrcopy DESCRIPTION The showrcopy command displays details of the remote-copy configuration. The showrcopy command also displays the group’s domain names if the global -listdom option is used or if the TPDLISTDOM environment variable is set. SYNTAX The syntax for the showrcopy command can be one of the following: • showrcopy [options ] [links] • showrcopy [options ] [groups []] • showrcopy [options ] [targets [ ... Target Information Name ID Type Status Options Policy System2 9 IP ready mirror_config Link Information Target System2 System2 receive receive Node 0 1 0 1 Address 10.100.33.11 10.101.33.11 10.100.33.11 10.101.33.11 Status Options Up Up Up Up Group Information Name Target Status sync_group_1 System2 Started LocalVV ID RemoteVV localvv.0 391 remotevv.0 localvv.1 392 remotevv. The following example displays output from the showrcopy groups command, where is specified as b* and 1*: # showrcopy groups b* l* Remote Copy System Information Status: Started, Normal Group Information Name Target Status bart bf_mirror Started PDT 2006 , Period 30m LocalVV ID RemoteVV bart-tp-ws 9 bart-ws Role Primary Mode Options Periodic Last-Sync Tue Jul 18 14:12:59 ID SyncStatus 3924 Synced LastSyncTime Tue Jul 18 14:13:09 PDT 2006 Name Target Status Role Mode Options lisa bf_mirror S ◦ Stopped—The volumes were previously synchronized, but may be out of sync due to a group being stopped. ◦ Stale—Volume was previously synchronized, but a previous synchronization attempt failed. Thus the secondary has a valid copy, just not a valid copy from the last synchronization attempt. The secondary volumes can be marked stale in certain failure scenarios, such as when a target fails during node-down handling on the secondary system. showrctransport DESCRIPTION The showrctransport command shows status and information about end-to-end transport for remote copy in the system. SYNTAX showcrtransport [options] AUTHORITY Any role in the system. OPTIONS –rcip Show information about Ethernet end-to-end transport. –rcfc Show information about Fibre Channel end-to-end-transport. • ◦ ready. Configuration is completed on this port and the peer port; transport is ready for use. ◦ missing. A configured transport was disconnected. Type. Indicates the port connection type. ◦ rcip. Port is used for remote copy over IP (RCIP). ◦ rcfc. Port is used for remote copy over FC (RCFC). The columns in the previous example are identified as follows: • N:S:P. The physical position of the port, in the format node:slot:port. • Remote_Node_WWN. World Wide name of the node to which the port indicated in the N:S:P column connects. • Remote_Port_WWN. World Wide name of the target port to which the port indicated in the N:S:P column connects. • State. Indicates whether the end-to-end transport is ready to be used for remote copy. Can be one of the following: ◦ new. showrole DESCRIPTION The showrole command displays information about rights assigned to roles in the system. Without any argument, showrole displays the roles currently defined. SYNTAX showrole [] showrole -listrights AUTHORITY Any role in the system. OPTIONS -listrights Lists the rights available in the system. SPECIFIERS ... Specifies that the role name matching the specified glob-style pattern will have their rights displayed. vv_update of a volume Remove old virtual copy and create a new virtual copy NOTES • To avoid cluttering the output, the show commands rights are not included in the output of the showrole because show commands are granted to all roles by default. showrsv DESCRIPTION The showrsv command displays SCSI reservation and registration information for Virtual Volume Logical Unit Numbers (VLUNs) bound for a specified port. SYNTAX showrsv [options ] [] AUTHORITY Any role in the system. OPTIONS –l Specifies that either SCSI–3 persistent reservation or SCSI–2 reservation information is displayed. If this option is not specified, information about both SCSI–2 and SCSI–3 reservation will be shown. • 5. (Write exclusive–registrants only). All read requests allowed. Write requests allowed for registered initiators only. • 6. (Exclusive access–registrants only). Read and write requests allowed for registered initiators only. • 7. (Write exclusive–all registrants). All read requests allowed. Write requests allowed for registered initiators only. • 8. (Exclusive access–all registrants). Read and write requests allowed for registered initiators only. showsched DESCRIPTION The showsched command shows the state of tasks currently scheduled on the system. SYNTAX showsched [options][|] AUTHORITY Super, Service, Edit, Browse Any extended role in the system. OPTIONS -all Specifies that all scheduled tasks will be displayed. -sortcol [,][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. move_back_chunklet1 moverelocpd -f 0,7,14 17 2 * * 0 3parsvc active Y 2009-03-15 03:17:00 PDT move_back_chunklet2 moverelocpd -f 1,8,15 17 2 * * 1 3parsvc active Y 2009-03-16 02:17:00 PDT move_back_chunklet3 moverelocpd -f 2,9 17 2 * * 2 3parsvc active Y 2009-03-17 02:17:00 PDT move_back_chunklet4 moverelocpd -f 3,10 17 2 * * 3 3parsvc active Y 2009-03-18 02:17:00 PDT move_back_chunklet5 moverelocpd -f 4,11 17 2 * * 4 3parsvc active Y 2009-03-12 02:17:00 PDT move_back_chunklet6 moverelocpd -f 5,12 17 2 * * showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. SYNTAX showsnmpmgr AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays a list of registered managers: cli% showsnmpmgr Manager IP 82.185.98.76 82.162.9.7 5def:2008:abcd::161a Port 162 8004 9162 In the example above: Manager IP. The trap manager’s IP address. Port. The trap manager’s port number. showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. SYNTAX showsnmppw [options] AUTHORITY Any role in the system. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) password is displayed. If not specified, the read/write community string password is displayed. showsnmpuser DESCRIPTION The showsnmpuser command displays information about one or all SNMP users, including the username, authentication and privacy protocols. SYNTAX The syntax for the showsnmpuser command can be one of the following: showsnmpuser [] showsnmpuser AUTHORITY Any role in the system. OPTIONS None SPECIFIERS Specifies the SNMPv3 username, using up to 31 characters. This specifier is not required on the command line. showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation. SYNTAX showspace [options ] AUTHORITY Any role in the system. The -devtype pattern cannot be used to mix Near Line (NL) and FC, and Solid State Drive (SSD) drives: NOTE: An item is specified as an integer, a comma-separated list of integers, or a range of integers specified from low to high. –nd - Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s).
–devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel or NL, nearline, or SSD for solid state drive) to be used. Device types can be displayed by issuing the showpd command. If it is not specified, the default device type is FC. -rpm Specifies that disks must be of the indicated speed. Device speeds are shown in the RPM column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). showspare DESCRIPTION The showspare command displays information about chunklets in the system that are reserved for spares and previously free chunklets selected for spares by the system. SYNTAX showspare [-used] AUTHORITY Any role in the system. OPTIONS -used Show only used spare chunklets. By default all spare chunklets are shown. • • ◦ normal. The chunklet is available for use. ◦ normal,smag. A servicemag operation is performed on the disks. ◦ None Chunklets were not used by any logical disk. Usage. Shows whether the spare chunklet is in use by a logical disk. ◦ available. The chunklet is available for use as a spare or as a logical disk. ◦ ld. The chunklet is in use by a logical disk. ◦ synch. The chunklet is both the source and the target of a logical disk relocation operation (synchronizing the chunklet). showsralertcrit DESCRIPTION The showsralertcrit command shows the criteria that System Reporter evaluates to determine if a performance alert should be generated. SYNTAX showsalertcrit [options ] AUTHORITY Any role in the system. OPTIONS -daily Displays only criteria evaluated on a daily basis. -hourly Displays only criteria evaluated on an hourly basis. -hires Displays only criteria evaluated on a high-resolution (5 minute) basis. -enabled Displays only criteria that are enabled. showsshkey DESCRIPTION The showsshkey command will displays all SSH public keys that have been set with setsshkey. SYNTAX showsshkey AUTHORITY Any role in the system. showsys DESCRIPTION The showsys command displays the HP 3PAR storage system properties includes system name, model, serial number, and system capacity information, etc. SYNTAX showsys [options] AUTHORITY Any role in the system. OPTIONS –d Specifies that more detailed information about the system is displayed. –param Specifies that the system parameters are displayed. –fan Displays the system fan information. –space Displays the system capacity information in MB (1048576 bytes). • Model. The model type of the HP 3PAR storage system. • Serial. The system serial number. • Nodes. The number of nodes in the system. • Master. The master node ID. • TotalCap. The total system capacity in MB. • AllocCap. The allocated system capacity in MB. • FreeCap. The free system capacity in MB. • Failed Cap. The failed system capacity in MB. Number of Nodes Master Node Nodes Online Nodes in Cluster : : : : 2 0 0,1 0,1 -----System Capacity (MB)----Total Capacity : 6277120 Allocated Capacity : 687872 Free Capacity : 5589248 Failed Capacity : 0 ---------System Fan--------Primary Node ID : 0 Secondary Node ID : 1 State : OK LED : Green Speed : Normal Primary Node ID : 1 Secondary Node ID : 0 State : OK LED : Green Speed : Normal --------System Descriptors-------Location : Owner : Contact : Comment : The following example shows system parameters showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr [options] AUTHORITY Any role in the system. OPTIONS -d Shows additional detailed information if available. -l Shows field service diagnostics for locking, and ioctl system calls. None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the startup state information about the system manager. In this example, the system manager reports that it is up and running. If the system has attempted powerfail recovery, and during the recovery encountered kernal panics because of hardware or software errors, the error could be associated with a specific volume. The following message is displayed. See “NOTES” (page 478) in the following section for additional information. cli% showsysmgr System is recovering from a previous power failure. Please use the 'showvv', 'showld', 'showpd' CLI commands to check for not started vvs, lds, pds. showtarget DESCRIPTION The showtarget command displays information about unrecognized targets. SYNTAX showtarget [...] showtarget -lun ... showtarget <-inq|-mode> [-page ] [-d] ... showtarget -rescan AUTHORITY Any role in the system. OPTIONS -lun Display the information for remote LUNs. -inq Display the SCSI inquiry page information. -mode Display the SCSI mode page information. -page Specify the SCSI page number for the inquiry and mode information. 0:5:2 50002AC00014001F 20520002AC00001F peer_volume 1:5:2 50002AC00014001F 21520002AC00001F peer_volume If unknown targets are found, information (Port, LUN_WWN, Port WWN, and State) about each target found is displayed. NOTES Some hosts might appear as unknown targets. showtask DESCRIPTION The showtask command displays information about tasks. By default, this command displays all non-system tasks on the system within the last 24 hours. SYNTAX showtask [options ] [ | ] AUTHORITY Any role in the system. OPTIONS –all Specifies that all scheduled tasks will be displayed. Unless the -all option is specified, system tasks are not displayed. –done Display includes only tasks that are successfully completed. EXAMPLES The following example displays all tasks on a system. In this case, the last task is still in progress. ◦ online_copy. Track physical copy of VV while online (createvvcopy -online command). ◦ convert_vv. Track tasks that are converting a volume from fully-provisioned to thin-provisioned and vice-versa. ◦ tune_sd. Track HP 3PAR System Tuner volume tuning operations. Requires an HP 3PAR Dynamic Optimization license. ◦ tune_vv. Track 3PAR System Tuner volume tuning operations. Requires an HP 3PAR Dynamic Optimization license. ◦ tune_vv_restart. 2009-02-27 2009-02-27 2009-02-27 2009-02-27 11:37:46 11:37:47 11:37:48 11:37:48 PST PST PST PST Updated Updated Updated Finished snapshot usage data for VV North snapshot usage data for VV VV_Tech_1.0020.0000.ro snapshot usage data for VV VV_Tech_1 snapshot usage data collection process. NOTES • See the HP 3PAR Command Line Interface Administrator’s Manual for additional information and examples regarding task management and task management commands, as well as information about Dynamic Optimization. showtemplate DESCRIPTION The showtemplate command displays existing templates that can be used for Virtual Volume (VV), Logical Disk (LD), or Common Provisioning Group (CPG) creation. SYNTAX showtemplate [options] [...] AUTHORITY Any role in the system. OPTIONS –t VV|LD|CPG Specifies that the template type displayed is a VV, LD, or CPG template. –fit Specifies that the properties of the template is displayed to fit within 80 character lines. showtoc DESCRIPTION The showtoc command displays the system table of contents summary that provides a summary of the system’s resources. SYNTAX showtoc AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the system table of contents. showtocgen DESCRIPTION The showtocgen command displays the table of contents generation number. SYNTAX showtocgen AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays the table of contents generation number: cli% showtocgen Table of Contents generation number: 4292 NOTES The table of contents generation number increases each time there is a change in the system configuration. showuser DESCRIPTION The showuser command displays information about one or all users, including the username, authority level, and system resources to which a given user has access. The showuser command shows account information for local users (those created with the createuser command) or shows the SSH key information for local and LDAP users (enabled by the setauthparam command). NOTES • Users are created using the createuser command. See “createuser” (page 139) for more information. • For the first usage (without the -k option), the showusercommand displays account information for all local users when the is not provided or the account information for just the local user with the name when it is provided. showuseracl DESCRIPTION The showuseracl command displays a user’s access control list (ACL). SYNTAX showuseracl AUTHORITY Any role in the system. OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays ACL information about all system users: cli% showuseracl User Operation Object_Names_or_Patterns suser updatevv avvro* buser updatevv avvr*,vv0,cpvv0,tpvv0 –f ruser updatevv vv0 cpvv0 tpvv0 avv* The columns in the previous example are identified as follows: • User. showuserconn DESCRIPTION The showuserconn command displays information about users who are currently connected (logged in) to the HP 3PAR storage system. SYNTAX showuserconn [options ][ ...] AUTHORITY Any role in the system. OPTIONS -current Shows all information about the current connection only. -d Specifies more detailed information about the user connection. –sortcol [,][:[,]...] Sorts command output based on column number . The columns in the previous example are identified as follows: • Id. Your HP 3PAR storage system identification number. • Name. Indicates the user name under which you logged in. • IP_Addr. The IP address where the user connection exists. NOTE: The Domain column is displayed only if the CLI was started with the -listdom global option or with the LISTDOM environment variable. showversion DESCRIPTION The showversion command displays information about the storage server software. Use this command to determine if your system is using the latest software version. SYNTAX showversion [options] AUTHORITY Any role in the system. OPTIONS –a Show all component versions. –b Show build levels. –s Show release version number only (useful for scripting). If no options are specified, the overall version of the software is displayed. showvlun DESCRIPTION The showvlun command displays information about Virtual Volume Logical Unit Numbers (VLUNs) in the system, such as all active and template VLUNs. The display is divided into two sections: the upper provides information about active VLUNs and the lower provides information about VLUN templates. SYNTAX showvlun [options ] showvlun -listcols AUTHORITY Any role in the system. –l {}... Specifies that only exports to the specified LUN are displayed. This specifier can be repeated to display information for multiple LUNs. –nodes Requests that only VLUNs for specific nodes are displayed. The node list is specified as a series of integers separated by commas (for example 0,1,2). The list can also consist of a single integer (for example 1). –slots Requests that only VLUNs for specific slots are displayed. 2 test.2 sun 210000E08B023C71 1:5:1 host 3 test.3 sun 210000E08B023C71 1:5:1 host ----------------------------------------------8 VLUN Templates Lun VVname Host ----Host_WWN---- Port Type 2 tpv.2 pe750–07 ---------------- --- host 3 tpv.3 pe750–07 ---------------- --- host 2 test.2 sun ---------------- --- host 3 test.3 sun ---------------- --- host ---------------------------------------------4 The columns in the previous examples are identified as follows: • Lun. showvv DESCRIPTION The showvv command displays information about all Virtual Volumes (VVs) or a specific VV in a system. SYNTAX • showvv [options ] [...] • showvv -listcols AUTHORITY Any role in the system. OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showvv for help on each column). –r Displays raw space used by the VVs. The following columns are shown: ID, Name, Prov, Type, Adm_RawRsvd_MB, Adm_Rsvd_MB, Snp_RawRsvd_MB, Snp_Rsvd_MB, Usr_RawRsvd_MB, Usr_Rsvd_MB, Tot_RawRsvd_MB, Tot_Rsvd_MB, VSize_MB. -zone Displays mapping zone information for VVs. The following columns are shown: ID, Name, Prov, Type, VSize_MB, Adm_Zn, Adm_Free_Zn, Snp_Zn, Snp_Free_Zn, Usr_Zn, Usr_Free_Zn. -g Displays the volume’s SCSI geometry settings for VVs. Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: • inc Sort in increasing order (default). • dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by the values in later columns.• -rcopygroup {}... Displays only VVs that are in Remote Copy groups that match one or more of the specified groups or patterns. Multiple groups or patterns can be repeated using a comma-separated list (for example -rcopygroup ,...). • -policy ... Show only VVs whose policy matches the one or more of the policies or patterns. -domain {}... Specifies the VV name (up to 31 characters in length) matching the glob-style pattern or that are members of the supplied VV set will have their information displayed. The VV_set name must start with set:. This specifier can be repeated to display configuration information about multiple VVs. This specifier is not required on the command line. If not specified, configuration information for all VVs in the system is displayed. option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable. • • Type. Indicates the copy type of virtual volume and can be one of the following: ◦ base. Base volume (not a copy). ◦ pcopy. Physical copy (full copy). ◦ vcopy. Snapshot copy (virtual copy). ◦ peer. Remote volume admit into the local HP 3PAR storage system. CopyOf. Displays the virtual volume from which the copy was made. ◦ ---. ◦ copy_source. Copy Source. ◦ unknown. Volume state unknown. • Adm. The snapshot administrator space in megabytes. • Snap. The snapshot space in megabytes. • user. Your user space in megabytes. • VSize. Virtual size of volume in MB (1024^2 bytes). 13 BasketDome cpvv base 0 0 0 0 0.0 2 5 256 256 100.0 --256 256 ----------------------------------------------------------------------------------------------------- 2 total 10496 10496 0 0 0 0 0.0 2 5 10496 10496 100.0 The columns in the previous example are identified as follows: • ID. The ID of the virtual volume. • Name. The name of the virtual volume. • Prov. The provisioning for the VV. Can be one of the following: ◦ full. The following example displays policy information for virtual volume 0: cli% showvv -p 0 Id Name Domain Policies 0 admin stale_ss,system ---------------------------------------------1 The columns in the previous example are identified as follows: • Id. The virtual volume ID. • Name. The virtual volume name. • Domain. The domain to which the virtual volume belongs. Valid values are – or . If the domain does not exist, - is displayed. • • • Type. Indicates the copy type of virtual volume and can be one of the following: ◦ base. Base volume (not a copy). ◦ pcopy. Physical copy (full copy). ◦ vcopy. Snapshot copy (virtual copy). ◦ peer. Remote volume admit into the local HP 3PAR storage system. State. The state of the virtual volume. ◦ normal. The virtual volume is operating normally. ◦ failed. The virtual volume is operating abnormally. ◦ degraded. The virtual volume is degraded. Detailed_State. The following example displays raw space usage information for thin provisioned VVs exported to host hname and all VVs in the tree with the base VV of ID 50. The following example shows the policies associated with a volume: cli% showvv -pol Id Name --------------------------Policies-------------------------0 admin stale_ss,system,no_zero_detect 19 aldvv stale_ss,no_system,no_one_host,no_zero_detect 20 bar-remote stale_ss,no_system,no_one_host,no_cache,no_zero_detect 11 mytpvv stale_ss,no_system,no_one_host,no_zero_detect 6 rcopy.0 stale_ss,no_system,no_one_host,no_zero_detect 7 rcopy. • For this command: 1 MB = 1048576 bytes. • If your system is accessible by an OpenStack cloud, you may see volumes with prefixes indicating the volumes were created through the OpenStack cloud. Volumes created through the OpenStack cloud use the OpenStack Volume (OSV) and OpenStack Snapshot (OSS) prefixes. showvvcpg DESCRIPTION The showvvcpg command displays the Virtual Volume (VV) space distribution among CPGs. SYNTAX showvvcpg [options] [ ...] AUTHORITY Any role in the system. OPTIONS -domain [,...] Only show VVs that are in domains with names matching one or more of the specified domain_name or patterns. Only VVs within domains that the user is a member of can be listed. The following example shows VV space distribution for VVs belonging to VV sets with names that begin with tv: cli% showvvcpg set:tv* ----(MB)---- -New (MB)-Name CPG Adm Snp Usr Adm Snp Usr testvv cpg0 - 1024 0 0 0 newtestvv cpg0 - 1024 0 0 0 --------------------------------------2 0 0 2048 0 0 0 The following example shows how Adaptive Optimization has distributed space for the Adm, Snp and Usr space for a VV among 3 CPGs: cli% showvvcpg Win2k8-MySqlData -----(MB)------ -New (MB)-Name CPG Adm Snp Usr Adm S showvvmap DESCRIPTION The showvvmap command displays information about how virtual volume regions are mapped to logical disks. It also can display bitmap representation of the allocation of a volume or differences between volumes, which is useful in visualizing the utilization of thinly provisioned volumes. SYNTAX showvvmap showvvmap -allocmap [options] showvvmap -unsharedmap -p [options] AUTHORITY Any role in the system. The following example shows the allocated bitmap starting at 1MB mark of a volume, for a length of 1GB: cli% showvvmap -allocmap -start 1M -len 1G vv0 The following example shows the unshared bitmap between a snapshot and its parent: cli% showvvmap -unsharedmap -p vv0 vv0.ro The columns in the previous example are identified as follows: • Space. The type of the space (user (usr), snapshot data (snp), or snapshot administration (adm) for which the region is being used followed by the ID of the region. showvvpd DESCRIPTION The showvvpd command displays Virtual Volume (VV) distribution across Physical Disks (PDs) . SYNTAX showvvpd [option ] {}... AUTHORITY Any role in the system. OPTIONS –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number. 11 0:2:3 0 0 0 0 12 0:3:0 0 0 0 0 13 0:3:1 0 0 0 0 14 0:3:2 0 0 0 0 15 0:3:3 0 0 0 0 16 1:0:0 0 0 4 4 17 1:0:1 0 0 4 4 18 1:0:2 0 0 4 4 19 1:0:3 0 0 4 4 20 1:1:0 0 0 4 4 21 1:1:1 0 0 4 4 22 1:1:2 0 0 4 4 23 1:1:3 0 0 4 4 24 1:2:0 0 0 4 4 25 1:2:1 0 0 4 4 26 1:2:2 0 0 4 4 27 1:2:3 0 0 4 4 28 1:3:0 0 0 4 4 29 1:3:1 0 0 4 4 30 1:3:2 0 0 4 4 31 1:3:3 0 0 4 4 32 2:0:0 0 0 4 4 33 2:0:1 0 0 4 4 34 2:0:2 0 0 4 4 35 2:0:3 0 0 4 4 36 2:1:0 0 0 4 4 37 2:1:1 0 0 4 4 38 2:1:2 0 0 4 4 39 2:1:3 0 0 4 4 40 2:2:0 0 0 4 4 41 17 1:0:1 0 0 4 4 18 1:0:2 0 0 4 4 19 1:0:3 0 0 4 4 20 1:1:0 0 0 4 4 21 1:1:1 0 0 4 4 22 1:1:2 0 0 4 4 23 1:1:3 0 0 4 4 24 1:2:0 0 0 4 4 25 1:2:1 0 0 4 4 26 1:2:2 0 0 4 4 27 1:2:3 0 0 4 4 28 1:3:0 0 0 4 4 29 1:3:1 0 0 4 4 30 1:3:2 0 0 4 4 31 1:3:3 0 0 4 4 32 2:0:0 0 0 4 4 33 2:0:1 0 0 4 4 34 2:0:2 0 0 4 4 35 2:0:3 0 0 4 4 36 2:1:0 0 0 4 4 37 2:1:1 0 0 4 4 38 2:1:2 0 0 4 4 39 2:1:3 0 0 4 4 40 2:2:0 0 0 4 4 41 2:2:1 0 0 4 4 42 2:2:2 0 0 4 4 43 2:2:3 0 0 4 4 44 2:3:0 0 0 4 4 45 2:3:1 0 0 4 4 46 2:3:2 0 0 4 4 47 42 2:2:2 1 1 0 2 44 2:3:0 1 1 0 2 45 2:3:1 1 1 0 2 46 2:3:2 0 1 1 2 1 0:0:1 0 1 0 1 2 0:0:2 0 1 0 1 4 0:1:0 0 1 0 1 5 0:1:1 0 1 0 1 12 0:3:0 0 1 0 1 13 0:3:1 1 0 0 1 14 0:3:2 1 0 0 1 16 1:0:0 0 0 1 1 25 1:2:1 0 1 0 1 28 1:3:0 0 1 0 1 32 2:0:0 0 1 0 1 35 2:0:3 0 1 0 1 37 2:1:1 0 1 0 1 38 2:1:2 1 0 0 1 47 2:3:3 1 0 0 1 23 1:1:3 0 0 0 0 36 2:1:0 0 0 0 0 41 2:2:1 0 0 0 0 --------------------------48 total 32 40 8 80 NOTES • The command prints the number of chunklets in each physical disk that contain data for showvvset DESCRIPTION The showvvset command lists the Virtual Volume (VV) sets defined on the HP 3PAR storage system and their members. SYNTAX showvvset [options] [...] showvvset -vv [options] [...] AUTHORITY Any role in the system. OPTIONS -d Show a more detailed listing of each set. -vv Show VV sets that contain the supplied vvnames or patterns -summary Shows VV sets with summarized output with VVset names and number of VVs in those sets. test-sv bar Show the sia-1 set only, with detail: cli% showvvset -d sia-1 20 sia-1 test This set has a comment ttpvv.rw test-sv bar Show VV sets containing VVs matching test*: cli% showvvset -vv test* Id Name Members 20 sia-1 test ttpvv.rw test-sv bar NOTES A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set. showwsapi DESCRIPTION The showwsapi command displays the WSAPI server service configuration state as either Enabled or Disabled. It displays the server currently running status as Active, Inactive or Error. It also displays the current status of the HTTP and HTTPS ports and their port numbers. showwsapisession DESCRIPTION The showwsapisession command displays the WSAPI server sessions connection information, including the id, node, username, role, hostname, and IP Address of the connecting client. It also displays the session creation time. SYNTAX showwsapisession [options][{|}... NOTES For all the fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat). The only exception is when -d option is provided. In this case, the session id is not a glob-style pattern and is checked against an exact match. The Web Services API server sessions information is only available if the WSAPI server is ready to accept queries. 24 Shutdown Commands shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot AUTHORITY • Super, Service • Any role granted the node_shutdown right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the nodes are halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the nodes are restarted after shutdown. It is recommended that these tasks are either allowed to finish or manually cancelled before continuing. Continuing with this REBOOT operation may cause some of these tasks to fail. Shutting down this node will impact applications running on the system displayed above Do you REALLY want to REBOOT this node? yes or no: yes The node will REBOOT in 15 seconds Press the enter key to stop... The node will REBOOT in 12 seconds Press the enter key to stop... shutdownsys DESCRIPTION The shutdownsys command shuts down an entire system. SYNTAX shutdownsys halt|reboot AUTHORITY • Super, Service • Any role granted the sys_shutdown right. NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the system should be halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the system should be restarted after shutdown. 7 8 9 sunx4150-08 Generic-legacy 2101001B323BC44C 6:5:1 n/a sunx4150-09 Generic-legacy 2101001B323BFF4C 6:5:1 n/a sunx4150-10 Generic-legacy 2101001B323B0A4C 6:5:1 n/a Shutting down this storage system will impact applications running on the hosts displayed above Do you REALLY want to REBOOT this storage system? yes or no: yes The system will REBOOT in 15 seconds Press the enter key to stop... The system will REBOOT in 12 seconds Press the enter key to stop... 25 System Reporter (SR) commands sraomoves DESCRIPTION The sraomoves command shows the space that Adaptive Optimization (AO) has moved between tiers. SYNTAX sraomoves [options] AUTHORITY Any role in the system OPTIONS -btsecs Select the begin time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). Select the end time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). • The absolute time as a text string in one of the following formats: ◦ Full time string including time zone: "2012-10-26 11:00:00 PDT" ◦ Full time string excluding time zone: "2012-10-26 11:00:00" ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. srcpgspace DESCRIPTION The srcpgspace command displays historical space data reports for common provisioning groups (CPGs). SYNTAX srcpgspace [options] [{|}...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. RESTRICTIONS None EXAMPLES The following example displays aggregate hourly CPG space information for CPGs with names that match the pattern "fc*" beginning 24 hours ago: cli% srcpgspace -hourly -btsecs -24h fc* The following example displays CPG space information for the most recent daily sample aggregated by the disk type and raid type for CPGs with names that match the pattern "fc*": cli% srcpgspace -daily -attime -groupby disk_type,raid_type fc* NOTES For this command: 1 MB = 1048576 bytes. srhistld DESCRIPTION The srhistld command displays historical histogram performance data reports for logical disks. SYNTAX srhistld [options] [{|}...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. • LD_NAME Logical disk name • CPG_NAME Common Provisioning Group name • NODE The node that owns the LD –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order.srhistpd DESCRIPTION The srhistpd command displays historical histogram data reports for physical disks. SYNTAX srhistpd [options] [{|}...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. • PORT_P The port number for the primary port for the the PD • DISK_TYPE The disk type of the PD • SPEED The speed of the PD -disk_type [,...] Limit the data to disks of the types specified. • FC – Fibre Channel • NL – Nearline • SSD – Solid State Drive –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. srhistport DESCRIPTION The srhistport command displays historical histogram performance data reports for ports. SYNTAX srhistport [options] [{::} ...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. • PORT_P The port number of the port • PORT_TYPE Port type • GBITPS The speed of the port -port_type [,...] Limit the data to port of the types specified. Allowed types are: • disk – disk port • host – host fibre channel port • iscsi – host iscsi port • free – unused port • rcip – remote copy IP port • rcfc – remote copy FC port –sortcol [,][:[,]...] Sorts command output based on the column number (). srhistvlun DESCRIPTION The srhistvlun command displays historical histogram performance data reports for VLUNs. SYNTAX srhistvlun [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires. • LUN The LUN number for the VLUN • HOST_WWN The host WWN for the VLUN • PORT_N The node number for the VLUN port • PORT_S The PCI slot number for the VLUN port • PORT_P The port number for the VLUN port • VVSET_NAME Virtual volume set name • HOSTSET_NAME Host set name -host [,...] Limit the data to hosts with names that match one or more of the specified names or glob-style patterns. srldspace DESCRIPTION The srldspace command displays historical space data reports for logical disks (LDs). SYNTAX srldspace [options] [{|}...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). Limit the data to RAID of the specified types. Allowed types are 0, 1, 5 and 6. –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:).srpdspace DESCRIPTION The srpdspace command displays historical space data reports for physical disks (PDs). SYNTAX srpdspace [options] [{|}...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS | PDs with IDs that match either the specified PDID or glob-style pattern are included. This specifier can be repeated to include multiple PDIDs or patterns. If not specified, all PDs are included. srrgiodensity DESCRIPTION The srrgiodensity command shows the distribution of IOP/s intensity for Logical Disk (LD) regions for a common provisioning group (CPG) or Adaptive Optimization (AO) configuration. For a single CPG, this can be used to see whether AO can be effectively used. For an AO configuration the command shows how AO has moved regions between tiers. SYNTAX srrgiodensity [options] -cpg {|}... ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -cmult 2|4|8 Select the step between histogram columns of the report. srstatcmp DESCRIPTION The srstatcmp command displays historical performance data reports for cache memory. SYNTAX srstatcmp [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. EXAMPLES The following example displays aggregate hourly performance statistics for all node caches beginning 24 hours ago: cli% srstatcmp -hourly -btsecs -24h The following example displays daily node cache performance aggregated by node for nodes 0 and 1: cli% srstatcmp -daily -attime -groupby node 0 1 554 System Reporter (SR) commands srstatcpu DESCRIPTION The srstatcpu command displays historical performance data reports for CPUs. SYNTAX srstatcpu [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. srstatld DESCRIPTION The srstatld command displays historical performance data reports for logical disks. SYNTAX srstatld [options] [{|}...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires. NOTES For this command: KB = 1000 bytes. srstatlink DESCRIPTION The srstatlinkcommand displays historical performance data reports for links (internode, PCI and cache memory). SYNTAX The syntax for the srstatlink command can be one of the following examples: • srstatlink [options] [...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). EXAMPLES The following example displays aggregate hourly performance statistics for all nodes and links beginning 24 hours ago: cli% srstatlink -hourly -btsecs -24h The following example displays daily node link performance aggregated by node for nodes 0 and 1: cli% srstatlink -daily -attime -groupby node 0 1 562 System Reporter (SR) commands srstatpd DESCRIPTION The srstatpd command displays historical performance data reports for physical disks. SYNTAX srstatpd [options] [{|}...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. EXAMPLES The following example displays aggregate hourly performance statistics for all physical disks beginning 24 hours ago: cli% srstatpd -hourly -btsecs -24h srstatpd 565 srstatport DESCRIPTION The srstatport command displays historical performance data reports for ports. SYNTAX srstatport [options] [{::} ...] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. If it is not specified then the time at which the report begins depends on the sample category (-hires, -hourly, -daily): • -For hires, the default begin time is 12 hours ago (-btsecs -12h). • For hourly, the default begin time is 7 days ago (-btsecs -7d). • For daily, the default begin time is 90 days ago (-btsecs -90d). If begin time and sample category are not specified then the time the report begins is 12 hours ago and the default sample category is hires. Ports with :: that match any of the specified[::...] patterns are included, where each of the patterns is a glob-style pattern. If not specified, all ports are included. srstatqos DESCRIPTION The srstatqos command displays historical performance data reports for QoS rules. SYNTAX srstatqos [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option performance is shown versus time, with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. This is the default. EXAMPLES The following example displays aggregate hourly performance statistics for QoS rules beginning 24 hours ago: cli% srstatqos -hourly -btsecs -24h NOTES For this command KB = 1000 bytes. srstatrcopy DESCRIPTION The srstatrcopy command displays historical performance data reports for Remote Copy links SYNTAX srstatrcopy [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. EXAMPLES The following example displays aggregate hourly performance statistics for all Remote Copy links beginning 24 hours ago: cli% srstatrcopy -hourly -btsecs -24h The following example displays most recent daily Remote Copy link performance for all targets grouped by target name: cli% srstatrcopy -daily -attime -groupby target_name The following example displays most recent daily Remote Copy link performance for targets grouped by port_n, port_s, port_p: cli% srstatrcopy -daily -attime -groupby port_ srstatrcvv DESCRIPTION The srstatrcvv command displays historical performance data reports for Remote Copy volumes. SYNTAX srstatrcvv [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. Limit the data to TARGET_NAMEs that match one or more of the specified TARGET_NAMEs or glob-style patterns. -mode [,] Limit the data to TARGET_MODEs of the specified mode. Allowed modes are: -group [,...] Limit the data to GROUP_NAMEs that match one or more of the specified GROUP_NAMEs or glob-style patterns. srstatvlun DESCRIPTION The srstatvlun command displays historical performance data reports for VLUNs. SYNTAX srstatvlun [options] AUTHORITY Any role in the system OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. -btsecs Select the begin time in seconds for the report. ◦ Date string: "2012-10-26" or 2012-10-26 ◦ Time string: "11:00:00" or 11:00:00 • A negative number indicating the number of seconds before the current time. Instead of a number representing seconds, can be specified with a suffix of m, h or d to represent time in minutes (e.g. -30m), hours (e.g. -1.5h) or days (e.g. -7d). If it is not specified then the report ends with the most recent sample. -hires Select high resolution samples (5 minute intervals) for the report. Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS None EXAMPLES The following example displays aggregate hourly performance statistics for all VLUNs beginning 24 hours ago: cli% srstatvlun -hourly -btsecs -24h NOTES For this command: KB = 1000 bytes. srvvspace DESCRIPTION The srvvspace command displays historical space data reports for virtual volumes (VVs). SYNTAX srvvspace [options] [{||}...] AUTHORITY Any role in the system SUBCOMMANDS None OPTIONS -attime Performance is shown at a particular time interval, specified by the -etsecs option, with one row per object group described by the -groupby option. Without this option, performance is shown versus time with a row per time interval. Select the end time in seconds for the report. If -attime is specified, select the time for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS || VVs with names that match either the specified VV_name or glob-style pattern are included. Data for all VV members of a specified VV set may also be requested. VV set name must be prefixed by "set:" and can also include patterns. 26 Start Commands startao DESCRIPTION The startao command starts execution of an Adaptive Optimization (AO) configuration using data region level performance data collected for the specified number of hours. SYNTAX startao [option] AUTHORITY Super, Edit Any role granted the aocfg_start right OPTIONS -btsecs Select the begin time in seconds for the report. The value can be specified as either: • The absolute epoch time (for example 1351263600). Select the approximate maximum run time in hours (default is 6 hours). The number should be between 1 and 24 hours. The command will attempt to limit the amount of data to be moved so the command can complete by the specified number of hours. If the time runs beyond the specified hours, the command will abort at an appropriate time. -compact Specify if and how CPGs should be compacted. Choices for are: • auto Automatically select the compactcpg mode (default). startcim DESCRIPTION The startcim command starts the CIM server to service CIM requests. By default, the CIM server is not started until this command is issued. SYNTAX startcim AUTHORITY • Super, Service • Any role granted the cim_start right. NOTE: You need access to all domains in order to run this command. OPTIONS None SPECIFIERS None RESTRICTIONS Access to all domains is required to run this command. startld DESCRIPTION The startld command starts data services on a Logical Disk (LD) that has not yet been started. SYNTAX startld [option] AUTHORITY • Super, Service • Any role granted the ld_start right. NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the LD is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the LD name, using up to 31 characters. startnoderescue DESCRIPTION The startnoderescue command initiates a node rescue, which initializes the internal node disk of the specified node to match the contents of the other node disks. The copy is done over the network, so the node to be rescued must have an Ethernet connection. It will automatically select a valid unused link local address. Progress is reported as a task. SYNTAX startnoderescue -node AUTHORITY Super, Service OPTIONS -node Specifies the node to be rescued. startrcopy DESCRIPTION The startrcopy command enables remote copy. SYNTAX startrcopy AUTHORITY • Super, Edit • Any role granted the rcopy_start right. NOTE: You must have access to all domains to run this command. OPTIONS None SPECIFIERS None RESTRICTIONS This command requires the HP 3PAR Remote Copy Software license. Contact your local service provider for more information. startrcopygroup DESCRIPTION The startrcopygroup command enables remote copy for the specified remote-copy volume group. SYNTAX startrcopygroup [options] [ ...] startrcopygroup [options] AUTHORITY • Super, Edit • Any role granted the rcopygroup_start right. OPTIONS –nosync Prevents the initial synchronization and sets the virtual volumes to a synchronized state. –wait Specifies that the command blocks until the initial synchronization is complete. To start Group2, which contains 4 virtual volumes, and specify starting snapshots, with vv4 starting from a full resynchronization: # startrcopygroup Group2 vv1:sv1 vv2:sv2 vv3:sv3 vv4:- NOTES • If a group’s target has the mirror_config policy set and the group is a primary group, then this command will be mirrored to that target and the corresponding secondary group will be started. If the policy is set and the group is a secondary, then this command will fail. starttask DESCRIPTION The starttask command provides users with the ability to execute commands with long running times. The commands run in the background. SYNTAX starttask AUTHORITY • Super, Service, Edit • Any role granted thetask_start right. OPTIONS None SPECIFIERS Specifies the command to be run by the starttask command. startvv DESCRIPTION The startvv command starts data services on a Virtual Volume (VV) that has not yet been started. SYNTAX startvv [option] AUTHORITY • Super, Service • Any role granted the vv_start right. NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the logical disk is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the VV name, using up to 31 characters. startwsapi DESCRIPTION The startwsapi command starts the Web Services API server to service HTTP and HTTPS requests. By default, the Web Services API server is not started until this command is issued. SYNTAX startwsapi AUTHORITY Super, Service Any role granted the wsapi_start right OPTIONS None SPECIFIERS None RESTRICTIONS None EXAMPLES The following example starts the Web Services API server: cli% startwsapi The Web Services API server will start shortly. 27 Stat Commands statch DESCRIPTION The statch command displays chunklet statistics in a timed loop. SYNTAX statch [options ] AUTHORITY Any role in the system. OPTIONS –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of 2 seconds. Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed. Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. –ld |–ch –ld Specifies that statistics are restricted to chunklets from a particular logical disk. –ch Specifies that statistics are restricted to a particular chunklet number. • Qlen. The queue length. • Util % Cur. The percentage of current use. • Util % Avg. The percentage of average use. NOTES • For this command: KB = 1000 bytes. • If no options are used, the command defaults to show reads, writes, and totals separately for all chunklets in intervals of 2 seconds. • The statch command can only be used after the setstatch command has been issued to enable chunklet statistics. See “setstatch” (page 320) for information about the setstatch command. statcmp DESCRIPTION The statcmp command displays Cache Memory Page (CMP) statistics by node or by Virtual Volume (VV). SYNTAX statcmp [options ] AUTHORITY Any role in the system. OPTIONS –v Specifies that CMP statistics by VV instead of by node are displayed. By default, all VVs are displayed unless the –n option is specified. –n Specifies that statistics are displayed for VVs matching the specified name or pattern. This option is valid only when used with the –v option. 0 473405 11790 1 483013 2158 0 0 0 0 0 0 0 0 0 0 0 0 Temporary and Page Credits Node Node0 Node1 Node2 Node3 Node4 Node5 Node6 Node7 0 0 33411 ------------1 33482 0 ------------Page Statistics ---CfcDirty--- ------CfcMax------Node FC FC15 NL SSD FC FC15 NL SSD 0 15 0 17 0 19200 0 9600 0 1 16 0 18 0 19200 0 9600 0 ----DelAck---FC FC15 NL SSD 11 0 13 0 12 0 14 0 Press the enter key to stop... The columns in the example above are identified as follows: • Node. Node ID on the storage system. statcpu DESCRIPTION The statcpu command displays CPU statistics for all nodes. SYNTAX statcpu [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. NOTES None 602 Stat Commands statfcoe DESCRIPTION The statfcoe command displays statistics for Fibre Channel over Ethernet connections. SYNTAX statfcoe [options ] AUTHORITY Any role in the system. OPTIONS -d Specifies the looping delay in seconds . The default is 2. -iter Specifies that the command execution should terminate after a user-defined of iterations. -nodes Specifies the list of nodes for which the ports are included. EXAMPLES The following example displays one iteration of FCoE counts: cli% statfcoe -iter 1 -counts -begin NOTES None 604 Stat Commands statiscsi DESCRIPTION The statiscsi command displays the iSCSI statistics. SYNTAX statiscsi [options ] AUTHORITY Any role in the system. OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included. -ports List of ports for which the ports are included. -begin Shows the values from when the system was last initiated. SPECIFIERS None RESTRICTIONS None EXAMPLES The following example displays basic iSCSI statistics collection: cli% statiscsi 16:37:59 04/06/06 ----Receive---- ---Transmit---- -----Total----port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/s 0:4:1 Eth 15633.2 1116.7 30115.9 45164.4 45749.1 46281.1 0.0 0:4:1 IP 15632.7 522.6 30116.4 44020.8 45749.1 44543.3 0.0 0:4:1 TCP 15632.7 22.3 30116.4 43057.0 45749.1 43079.4 0. statiscsisession DESCRIPTION The statiscsisession command displays the iSCSI session statistics. SYNTAX statiscsisession [options ] AUTHORITY Any role in the system. OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined number of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included. Rx Total Digest TimeOut 1:3:1 iqn.1991-05.com.microsoft:dt-ashok-xp.hq.3pardata.com 131 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0.0 ---------------------------------------------------------------------------------------------------------Total - 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0.0 Press the enter key to stop... statld DESCRIPTION The statld command displays read/write (I/O) statistics about Logical Disks (LDs) in a timed loop. SYNTAX statld [options ] [...] AUTHORITY Any role in the system. OPTIONS -vv {}... Show only LDs that are mapped to Virtual Volumes (VVs) with names matching any of names or patterns specified. Multiple volumes or patterns can be repeated using a comma-separated list (for example -vv ,...). -domain {}... Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The type, operation, meas, and value arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed. Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS ... Only statistics are displayed for the specified LD or pattern. Multiple LDs or patterns can be repeated (for example ...). NOTES 612 • For this command: KB = 1000 bytes. • If no option is specified, the command defaults to display statistics totals. • If the or specifier is used, then LDs with names matching any of the patterns are listed, otherwise all LDs are listed. These patterns are glob-style patterns. Refer to “Glob-Style Pattern” (page 12) for further information. statlink DESCRIPTION The statlink command displays statistics for link utilization for all nodes in a timed loop. SYNTAX statlink [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. statpd DESCRIPTION The statpd command displays the read/write (I/O) statistics for physical disks in a timed loop. SYNTAX statpd [options] AUTHORITY Any role in the system. OPTIONS –w Specifies that statistics for a particular Physical Disk (PD) identified by World Wide Names (WWNs) are displayed. –nodes Specifies that the display is limited to specified nodes and PDs connected to those nodes. The node_list argument is specified as a series of integers separated by commas (1,2,3). –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting () can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order.◦ svct Specifies that statistics for service time in milliseconds are displayed. ◦ size Specifies that statistics for I/O operations in bytes are displayed. • [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. The integer can optionally be followed with k or K to indicate a multiple of 1000, m or M to indicate a multiple of 1,000,000, or g or G to indicate a multiple of 1,000,000,000. range of disk positions is separated with a hyphen (0–3). The specified position(s) must contain disks. –dk - Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s).
0 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 1 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 2 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 4 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 5 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 6 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 7 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 8 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 9 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 10 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 11 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 12 1:0:2 t 0 0 0 0 0 0 0. statport DESCRIPTION The statport command displays read/write (I/O) statistics for ports. SYNTAX statport [options] AUTHORITY Any role in the system. OPTIONS –both|–ctl|–data Show data transfers only (–data), control transfers only (–ctl), or both data and control transfers (–both). If no option is included on the command line, the command shows data transfers only. –nodes Specifies that the display is limited to specified nodes and Physical Disks (PDs) connected to those nodes. Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647. –begin Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Specifies the percent of idle columns in the output. –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0.• The meas argument can be specified with one of the following arguments: ◦ iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. ◦ bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. ◦ svct Specifies that statistics for service time in milliseconds are displayed. The columns in the example above are identified as follows: • Port. The port ID. • D/C. The Data or Control transfers. • r/w. The I/O type. Values can be read (r), write (w), or read and write (t). • I/O per second Cur. The current number of I/O per second. • I/O per second Avg. The average number of I/O per second. • KBytes per Max. The maximum number of KB per second. • KBytes per Cur. The current number of KB per second. • KBytes per Avg. The average number of KB per second. statqos DESCRIPTION The statqos command display the run-time stats of QoS rules that are on. SYNTAX The syntax for the statqos command can be one of the following examples: • statqos [options][{{vvset|domain}:{|}|sys:all_others}]... AUTHORITY • Any role in the system OPTIONS -domain {}... Shows statistics for rules with target objects in domains with names that match one or more of the specified domains or patterns. NOTE: Multiple columns can be specified and separated by a colon (:). Rows with the same information in them as earlier columns will be sorted by values in later columns. -filt Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , are filtered out and not displayed. The , , , are separated by one comma. EXAMPLES The following example displays one iteration of statistics for QoS: cli% statqos -iter 1 NOTES For this command KB = 1000 bytes. For all the fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat). A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option, or if the CLI was started with the TPDLISTDOM environment variable set. statrcopy DESCRIPTION The statrcopy command displays statistics for remote-copy volume groups. SYNTAX statrcopy [options ] AUTHORITY Any role in the system. OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. Receive 1806402.23 50.69 50.69 Send 172955055.10 47838.51 47838.51 --------------------------------------------------------------------------Total 174761457.34 47889.20 47889.20 Press the enter key to stop... The columns in this example provide the following information: • Target. The system name of the actual link process that is running. • Node. The node that the link is running on. • Address. The IP address of the remote node. • IPC. The mode of the remote-copy link (r) Receive or (s) Send. statrcvv DESCRIPTION The statrcvv command displays statistics for remote-copy volumes in a timed loop. SYNTAX statrcvv [options ] [|]... AUTHORITY Any role in the system. OPTIONS –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds. Specifies that the sums for all volumes of a domain are displayed. -domain ...|... Show only the virtual volumes that are in domains with names that match the specified domain name(s) or pattern(s). -sortcol [,][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting (): inc Sort in increasing order (default). Specifies that statistics for only non-idle devices are displayed. This option is shorthand for the option -filt curs,t,iops,0. SPECIFIERS ... Displays statistics only for the specified virtual volume or volume name pattern. Multiple volumes or patterns can be repeated (for example, ...). If not specified, all virtual volumes that are configured for remote copy are listed. RESTRICTIONS This command requires the HP 3PAR Remote Copy Software license. The columns in this example provide the following information: • VVname—The name of the virtual volume being copied. • RCGroup—Remote-copy group containing the volume. • Target—Remote-copy target system to which the volume is copied. • Mode—Remote-copy mode of the volume, either "Per" (asynchronous periodic) or "Sync" (synchronous). • Port—Remote-copy port for which statistics are displayed. • Type—Interface type of the port. • I/O per second Cur—The current number of I/O per second. statvlun DESCRIPTION The statvlun command displays statistics for Virtual Volumes (VVs) and Logical Unit Number (LUN) host attachments. SYNTAX statvlun [options ] AUTHORITY Any role in the system. OPTIONS -domain ... Shows only Virtual Volume Logical Unit Number (VLUNs) whose VVs are in domains with names that match one or more of the specified domain names or patterns. Specifies that sums for VLUNs are grouped by domain in the display. All VLUNs to unnamed hosts are added and displayed as a single set of data with a "-" host name. –vvsum Specifies that sums for VLUNs of the same VV are displayed. –hostsum Specifies that sums for VLUNs are grouped by host in the display. All VLUNs to unnamed hosts are added and displayed as a single set of data with a nameless host. –rw Specifies reads and writes to be displayed separately. Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed. Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. statvv DESCRIPTION The statvv command displays statistics for Virtual Volumes (VVs) in a timed loop. SYNTAX statvv [options ] [...] AUTHORITY Any role in the system. OPTIONS -domain ... Shows only the VVs that are in domains with names that match the specified domain names or patterns. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The , , , and arguments are separated with one comma. • The type argument can be specified with one of the following arguments: ◦ curs Specifies that only devices with current statistics above the threshold are displayed. Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS ... Only statistics are displayed for the specified VV or pattern. Multiple volumes or patterns can be repeated (for example ...). If not specified, all VVs are listed. cause the read data to appear more than seen by the hosts. Use the histvlun -vvsum command to see data for only accesses from the host. • For this command: KB = 1000 bytes. 28 Stop Commands stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. SYNTAX stopcim [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. -x Specifies that the operation terminates the server immediately without graceful shutdown notice. stoprcopy DESCRIPTION The stoprcopy command disables the remote-copy functionality for any started remote-copy volume groups. SYNTAX stoprcopy [options] AUTHORITY Super, Edit Any role granted the rcopy_stop right. NOTE: You must have access to all domains to run this command. OPTIONS –f Specifies that any started copy will not ask for confirmation for the -clear option. –stopgroups Specifies that any started remote-copy volume groups are stopped. typing, y. Refer to the HP 3PAR Command Line Interface Administrator’s Manual for information about using environment variables. stoprcopygroup DESCRIPTION The stoprcopygroup command stops the remote-copy functionality for the specified remote-copy volume group. SYNTAX stoprcopygroup [option ] |... AUTHORITY Super, Edit Any role granted the rcopygroup_stop right. OPTIONS –nosnap In synchronous mode, this option turns off the creation of snapshots. This is useful if removercopygroup is to be run to remove Remote Copy. In asynchronous periodic mode, this option deletes any current synchronization snapshots. The following example stops remote-copy groups that start with the name testgroup: # stoprcopygroup -pat testgroup* NOTES • If a group target has the mirror_config policy set and the group is a primary group, then this command will be mirrored to that target and the corresponding secondary group will be stopped. If the mirror_config policy is set and the group is a secondary, then this command will fail. stopwsapi DESCRIPTION The stopwsapi command stops the Web Services API server from servicing HTTP and HTTPS requests. SYNTAX stopwsapi [options] AUTHORITY Super, Service Any role granted the wsapi_stop right OPTIONS -f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. 29 Sync Command 646 Sync Command syncrcopy DESCRIPTION The syncrcopy command manually synchronizes remote-copy volume groups. SYNTAX syncrcopy [options ] |... AUTHORITY Super, Edit Any role granted the rcopy_sync right. OPTIONS –w Wait for synchronization to complete before returning to a command prompt. –n Do not save resynchronization snapshot. This option is only relevant for asynchronous periodic mode volume groups. EXAMPLES The following example specifies that remote-copy volume group Group1 should be synchronized with its corresponding secondary volume group: # syncrcopy Group1 Synchronization request issued for group Group1 The following example specifies that all remote-copy volume groups that start with the name testgroup should be synchronized with their corresponding secondary volume group: # syncrcopy -pat testgroup* NOTES • Mode (synchronous or asynchronous periodic) is set using the creatercopygroup comma 30 Tune Commands tunepd DESCRIPTION The tunepd command identifies physical disks with high service times and optionally executes load balancing. SYNTAX The syntax for the tunepd command can be one of the following: • tunepd [options ] maxsvct |highest • tunepd [options ] avgsvct |highest AUTHORITY Super, Edit Any role granted the pd_tune right NOTE: You need access to all domains in order to run this command. –freq Specifies the interval, in minutes, that the command enters standby mode between iterations using an integer greater than 0. If this option is not specified, the number of iterations is looped indefinitely. –vvlayout Specifies that the layout of the virtual volume is displayed. If this option is not specified, the layout of the virtual volume is not displayed. –portstat Specifies that statistics for all disk ports in the system are displayed. • If one or more chunklet statistics collection processes are running, the tunepd command exits to prevent possible tunepd –chstat on processes running simultaneously. • Use the –chstat force option only when you have verified that no other tunepd processes are running. EXAMPLES In the following example, PDs with average service times exceeding 50 milliseconds are identified and their chunklets automatically relocated to rebalance the PDs’ load. Physical Disk 29: The following chunklets have been marked for moving: 26 Pass 1: Dryrun moving chunklets: Move Status qlocal qlost 29:26–10:16 source and destination are valid true false Pass 2: Move qlocal qlost 29:26–10:16 true false Status ch was moved qset qrow qcon mag 0 2 qset qrow qcon mag 0 2 Note that physical disk 29 is identified as matching the search criterion of average service times greater than 50 milliseconds and its chunklets are relocated. tunesys DESCRIPTION The tunesys command is used to analyze and detect poor layout and disk utilization across an entire across an entire storage system. The command runs a series of low level operations to re-balance resources on the system. SYNTAX tunesys [options] AUTHORITY • Super, Edit • Any role granted the sys_tune right OPTIONS -chunkpct Controls the detection of any imbalance in PD chunklet allocation between PDs owned by individual nodes. -waittask Wait for all tasks created by this command to complete before returning. SPECIFIERS None EXAMPLES In the following example: • VVs will be re-balanced between nodes if there is an imbalance in space usage between nodes of more than 5% (nodepct value). • PD chunklets will be re-balanced on each node if any disk has usage less than 20% than the average chunklet usage (chunkpct value). • A maximum of 4 tune tasks will be run at a time (maxtasks value).. tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with the createvv command by associating it with a different Common Provisioning Group. -tpvv Indicates that the virtual volume should be converted to a Thinly-Provisioned Virtual Volume. Cannot be used with the -full option. -full Indicates that the virtual volume should be converted to a fully-provisioned virtual volume. Cannot be used with the -tpvv option. -keepvv Indicates that the original logical disks should be saved under a new virtual volume with the given name. Must be used with the -tpvv or -full options. 31 Update Commands updatesnapspace DESCRIPTION The updatesnapspace command starts a non-cancelable task to update the snapshot space usage accounting. The snapshot space usage displayed by showvv -snapspace is not necessarily the current usage and the TimeCalculated column will show when it was last calculated. This command causes the system to start calculating current snapsnot space usage. If one or more VV names or patterns are specified, only the specified VVs will be updated. The following example displays the task information using –d : cli% showtask –d 2 Id Type Name Status Phase Step ----------StartTime-------- ---------FinishTime--------2 snapspace_accounting ss_accounting Done 0/0 0/0 Thu Sep 22 18:43:35 PDT 2005 Thu Sep 22 18:43:35 PDT 2005 Detailed {Thu Sep {Thu Sep VVs {Thu Sep {Thu Sep {Thu Sep {Thu Sep status: 22 18:43:35 PDT 2005} Created 22 18:43:35 PDT 2005} Started 22 22 22 22 18:43:35 18:43:35 18:43:35 18:43:35 PDT PDT PDT PDT 2005} 2005} 2005} 2005} updatevv DESCRIPTION The updatevv command updates a snapshot Virtual Volume (VV) with a new snapshot. SYNTAX updatevv [options] ... AUTHORITY Super, Edit, Browse Any role granted the vv_update right OPTIONS –ro Specifies that if the specified VV () is a read/write snapshot the snapshot’s read-only parent volume is also updated with a new snapshot if the parent volume is not a member of a virtual volume set. NOTES • The updatevv command attempts to use the same VV IDs for new snapshots as the snapshots that they replace so that the new VV have the same World Wide Names (WWNs) as the originals (this might be important for hosts using the VV WWN to identify the VV). However, between the removal of the original snapshot and the creation of the new snapshot it is possible that another VV might have been created with the same ID causing the creation of the new snapshot to fail. 32 Upgrade Commands upgradecage DESCRIPTION The upgradecage command downloads new firmware into the specified cage. SYNTAX The syntax for the upgradecage command can be one of the following: • upgradecage [options ] ... • upgradecage [options ] -a AUTHORITY Super, Service Any role granted the cage_upgrade right NOTE: You need access to all domains in order to run this command. RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays a cage with firmware level of 4.41 upgrading to 4.42: cli% upgradecage –a Upgrading cage cage0 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05. Upgrading cage cage1 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05. Upgrading cage cage2 cpuA from rev 1.46 to revision in file /opt/tpd/fw/cage/dc2/lbod_fw.bin-2.05. upgradepd DESCRIPTION The upgradepd command upgrades the Physical Disk (PD) firmware. SYNTAX upgradepd [-f] [-skiptest] {-a | -w ... | ...} AUTHORITY Super, Service Any role granted the pd_upgrade right NOTE: You need access to all domains in order to run this command. OPTIONS –f Upgrades the PD firmware without requiring confirmation. –skiptest Skips the 10 second diagnostic test normally completed after each PD upgrade. 33 Wait Command waittask DESCRIPTION The waittask command asks the CLI to wait for a task to complete before proceeding. The command automatically notifies you when the specified task is finished. SYNTAX The syntax for the waittask command can be one of the following: waittask –v waittask [...] AUTHORITY Any role in the system OPTIONS –v Displays the detailed status of the task specified by as it executes. When the task completes, this command exits. 34 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp. For information about: See: Migrating data from one HP 3PAR storage system to another HP 3PAR-to-3PAR Storage Peer Motion Guide Configuring the Secure Service Custodian server in order to monitor and control HP 3PAR storage systems HP 3PAR Secure Service Custodian Configuration Utility Reference Using the CLI to configure and manage HP 3PAR Remote Copy HP 3PAR Remote Copy Software User’s Guide Updating HP 3PAR operating systems HP 3PAR Upgrade Pre-Planning Guide Identifying storage system components For information about: See: Planning for HP 3PAR storage system setup Hardware specifications, installation considerations, power requirements, networking options, and cabling information for HP 3PAR storage systems HP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7000 Storage Site Planning Manual HP 3PAR StoreServ 7450 Storage Site Planning Manual HP 3PAR 10000 storage systems HP 3PAR StoreServ 10000 Storage Physical Planning Manual HP 3PAR StoreServ 10000 Storage Third-Party Rack Physic Typographic conventions Table 8 Document conventions Convention Element Bold text • Keys that you press • Text you typed into a GUI element, such as a text box • GUI elements that you click or select, such as menu items, buttons, and so on Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values • Code variables • Command variables Bold monospace text • Commands you enter into a command line interface • System 35 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback. Index Symbols (brackets) optional elements, 11 (ellipsis), multiuse option specifier, 11 (parentheses), grouped elements, 11 A access user information about, 488 active VLUN, 494 add virtual volume to group, 52 addsnmpmgr, 43, 647 admin volume, 476 admithw, 45 admitpd, 47 admitrcopylink, 49 admitrcopytarget, 51 admitrcopyvv, 52 alerts removing from system, 213 service, registered SNMP software for, 464 system removing preregistered SNMP software, 229 status of, 339 status of, setting, 259 using addsnmpmgr createvlun, 141 createvv, 144 createvvcopy, 148 createvvset, 152 creating domains, 106 creating new system hosts, 112 creating new users, 139 creating provisioned virtual volumes, 144 creating templates, 133 D data services starting on logical disk, 587 virtual volume, starting, 592 databases, current firmware levels, displaying, 375 date and time for system nodes, 363 setting nodes, 279 definitions, removing, 47, 154 deleting VLUNs, 242 designate site as primary or secondary, 589 disks logical chunklets, virtual volumes, 636 identify primary and secondary storage servers, 118 identifying drive cages, 189 IP address, specifying SNMP additions, 43 K kernel build text, 24 kernel version number, 24 L length limits, 12 link create to remote storage server, 49 remove, 155 link utilization statistics, 613 LIP, 90 locatecage, 189 locatesys, 192 logical disk name, length limit, 12 logical disks access times, histogram of, 166 check data on, 60 creating virtual volumes in, 144 data services, starting on, 587 displa removehost, 220 removehostset, 222 removeld, 223 removercopygroup, 225 removercopytarget, 227 removesched, 228 removesnmpmgr, 229 removesnmppw, 231 removespare, 233 removesralertcrit, 235 removesshkey, 236 removetask, 237 removetemplate, 239 removeuser, 240 removeuserconn, 241 removevlun, 242 removevv, 244 removewsapisession, 247 removing hosts, 220 removing users, 240 removing virtual volumes, 244 replacing drive magazines or disk drives, 85 RSCN, 90 S SCSI-3 reservation types, 460 secondary site designat showspace, 467 showspare, 470 showsralertcrit, 472 showsys, 473 showsysmgr, 477 showtarget, 479 showtask, 481 showtemplate, 485 showtoc, 486 showtocgen, 487 showuser, 488 showuseracl, 490 showuserconn, 491 showversion, 493 showvlun, 494 showvv, 497 showvvmap, 512 showvvpd, 514 showvvset, 518 showwsapi, 520 showwsapisession, 521 shutdownnode, 523 shutdownsys, 525 shutting down system nodes, 523 SNMP access removing passwords for, 231, 592 updating, 315 SNMP software for alerts, 464 removing preregistered, 22 T table of contents generation number, 487 target designation, remove, 227 targets, unrecognized, 479 temperature status, 408 template name, length limit, 12 template VLUN, 494 templates creating, 133 text symbols, 668 Thinly Provisioned Virtual Volume (TPVV), length limit, 12 time and date for system nodes, 363 setting nodes, 279 traps removing preregistered SNMP software, 229 using addsnmpmgr for, 43 tunepd, 649 tunesys, 653 tunevv, 655 U statistics I/O, 636 LUN host attachments, 632 validity checks of, | 
