HP 3PAR User's Guide

HP 3PAR Command Line Interface ReferenceHP 3PAR OS 3.1.2AbstractThis reference describes the HP 3PAR Command Line Interface (CLI) commands that are us

29 Sync Command...639syncrcopy...

Specifies the chunklet location preference characteristics: either first (attempt to use the lowestnumbered available chunklets) or last (attempt to u

–fc_gt <number>Specifies that physical disks with free chunklets greater than the number specified are selected.–fc_lt <number>Specifies t

Specifies that the system will try to share the logical disks among the virtual volumes. This optioncan only be used with the -cnt option.–szs <siz

Defines the virtual volume geometry heads per cylinder value that is reported to the hosts thoughthe SCSI mode pages. The valid range is between 1 to

NOTESFor this command:• MB = 1048576 bytes• GB = 1024 MB• TB = 1024 GB104 Create Commands

createaocfgDESCRIPTIONThe createaocfg command creates an Adaptive Optimization (AO) configuration.AUTHORITYSuper, EditSYNTAXcreateaocfg [options <a

The following example creates a new AO configuration called aocfg2. The optimization biasdefaults to Balanced, and no Tier 1 CPG is specified.cli% cre

createavvDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease. Please use the createvv comman

–pol no_stale_ss|stale_ss|one_host|no_one_hostSpecifies the policy (rule) that the created virtual volume follows. If an argument is not specified,the

RESTRICTIONS• Logical disks must be available to run the createavv command. Issue the createaldcommand to create logical disks. See “createald” (page

1 CLI Command Syntax and ConventionsThis chapter describes the command syntax for the HP 3PAR OS CLI commands listed in thisreference. General control

createcpgDESCRIPTIONThe createcpg command creates a Common Provisioning Group (CPG).AUTHORITY• Super, Edit• Any role that is granted the cpg_create ri

–sdgl <size> [g|G|t|T]Specifies that the auto-grow operation is limited to the specified storage amount. The storageamount can be specified in M

–p <pattern>Specifies a pattern for candidate disks. Patterns are used to select disks that are used for creatinglogical disks. If no pattern is

–fc_gt <number>Specifies that physical disks with free chunklets greater than the number specified be selected.–fc_lt <number>Specifies th

NOTES• For this command:KB = 1024 bytes◦◦ MB = 1048576 bytes◦ GB = 1073741824 bytes• When using the createcpg command, the size of the logical disk sp

createdomainDESCRIPTIONThe createdomain command creates system domains.AUTHORITY• Super• Any role that is granted the domain_create right.NOTE: You ne

createdomainsetdescriptionThe createdomainset command defines a new set of domains and provides the option ofassigning one or more existing domains to

creategroupsvDESCRIPTIONThe creategroupsv command creates consistent group snapshots of a list of Virtual Volumes.Consistent group snapshots are all c

SPECIFIERS<copy_of_VV>Specifies the name of the Virtual Volume being copied (the parent volume).<snapshot_VV>Optional name of the snapshot

creategroupvvcopyDESCRIPTIONThe creategroupvvcopy command creates consistent group physical copies of a list of virtualvolumes.SYNTAXThe syntax for th

• An argument must directly follow the option or subcommand it is modifying and is requiredon the command line, unless otherwise specified (for exampl

Use this specifier to block until all the copies are complete. Without this option, the commandcompletes before the copy operations are completed (use

createhostDESCRIPTIONThe createhost command creates or adds paths to a new system host and provides the optionof assigning one or more paths to that h

Specifies any additional information for the host.SPECIFIERS<host_name>Specifies the name of the host, using up to 31 characters.<WWN>Spec

createhostsetDESCRIPTIONThe createhostset command defines a new set of hosts and provides the option of assigningone or more existing hosts to that se

To create a host set with a comment and a host in it:cli% createhostset -comment “A host set” oraset ora1NOTESNone.124 Create Commands

createldDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease. Please use the createvv command

Specifies the logical disk name, using up to 31 characters.<RAID_type>Specifies the RAID type: 0 for RAID-0, 1 for RAID -1, 5 for RAID-5, or 6 f

creatercopygroupDESCRIPTIONThe creatercopygroup command creates a Remote Copy volume group.SYNTAXcreatercopygroup [options] <group_name> [<ta

If using domains, the syntax would appear as:cli% creatercopygroup -domain domain2 Group1 System2_out:periodicIf using volume auto-create:cli% creater

creatercopytargetDESCRIPTIONThe creatercopytarget command creates a Remote Copy target definition.SYNTAXThe syntax for the creatercopytarget command c

The following actions are practical examples of the glob-style pattern in use:Explanation of ActionExampleShows all names.*Matches all names beginning

The following example creates a primary target definition named System1 on the backup system,where the node numbers of the backup system’s Ethernet po

createschedDESCRIPTIONThe createsched command allows users to schedule tasks that are periodically run by thescheduler.SYNTAXcreatesched [options] <

2h). The created snapshot will be named sample_vv_set.HH.MMM where HH and MM refer tothe hour and minute that the snapshot was created (@vvname@.@H@.@

• Ranges of numbers are allowed. Ranges are two numbers separated with a hyphen. Thespecified range is inclusive. For example, 8-11 for an hour entry

createsnmpuserDESCRIPTIONThe createsnmpuser command creates the SNMPv3 user secret key used for generatingauthentication and privacy keys. Username mu

createspareDESCRIPTIONThe createspare command allocates chunklet resources as spares. Chunklets marked as spareare not used for logical disk creation

EXAMPLES• The following example marks chunklet 1 as spare for physical disk 15:cli% createspare 15:1• The following example specifies the position in

createsvDESCRIPTIONThe createsv command creates a point-in-time (snapshot) copy of a virtual volume. Createsnapshots to perform such tasks as backing

SPECIFIERS<SV_name>Specifies the snapshot name, using up to 31 characters in length.<copy_of_VV | VV_set>Specifies the parent volume name

createtemplateDESCRIPTIONThe createtemplate command creates Virtual Volume (VV), Logical Disk (LD), and CommonProvisioning Group (CPG) templates. Temp

sub,regexpat - Using regular expression (regex) pattern matchingRegular expression patterns are used to match against strings. In the CLI the strings

–ha port|cage|magSpecifies that the layout must support the failure of one port pair, one cage, or one drive magazine(mag). This option has no meaning

NOTE: The following arguments, –tc_gt , –tc_lt , –fc_gt , –fc_lt , –devid , and–devtype are used to limit the disks that are used to create LDs base

Specifies the allocation limit threshold of the CPG. The snapshot data space is prevented fromgrowing beyond the specified percentage of the virtual v

Specifies that if a host write results in the allocation of a new data page that is only partially filledby the host write, then a zero-fill is perfor

terabytes by using the t|T parameter. To specify the size in gigabytes, enter g or G, for terabytes,enter t or T, directly after the specified size (n

createtpvvDESCRIPTIONThis command is deprecated and will be removed in a subsequent release. Please use the createvv-tpvv command in the future.The cr

This option sets the user space allocation limit. The user space of the TPVV is prevented fromgrowing beyond the indicated percentage of the VV size.

This constrains the export of a volume to one host or one host cluster (when cluster names can beused as a host name).no_one_hostThis policy should on

In the preceding example, a 1 GB TPVV named tpvv1 is allocated from a CPG named cpg1 andits allocation warnings and limits are set at 50% and 75%, res

createuserDESCRIPTIONThe createuser command creates a new user with the specified name and role in the specifieddomain.SYNTAXcreateuser [option <ar

For a virtual volume with user space that is not provisioned from a CPG, "createaldvv", "growaldvv",and "tunealdvv" comm

EXAMPLESThe following example displays the successful creation of a new user user1 with the clear-textpassword 123456, with access to all service pool

createvlunDESCRIPTIONThe createvlun command creates a Virtual Logical Unit Number (VLUN) template that enablesexport of a Virtual Volume (VV) as a SCS

For each VLUN created, the .int suffix of the VV_name specifier and LUN are incremented byone.–novcnSpecifies that a VLUN Change Notification (VCN) no

• Verify the creation of VLUNs by issuing the showvlun command. See “showvlun” (page 503)for more information.• Conflicts between overlapping VLUN tem

createvvDESCRIPTIONThe createvv command creates volumes that are provisioned from one or more CommonProvisioning Groups (CPGs). Volumes can be fully p

Do not ask for confirmation before creating a volume with retention time (-retain).-retain <time>[d|D|h|H]Specifies the amount of time, relative

NOTE: Thin Persistence can have some performance implications during extremely busy systemconditions. HP recommends the zero_detect policy only be ena

• The -templ option is not valid for volumes that are fully provisioned.• The -shared and -wait option cannot be used when creating Thinly Provisioned

createvvcopyDESCRIPTIONThe createvvcopy command creates a full physical copy of a Virtual Volume (VV) or a read/writevirtual copy on another VV. This

Specifies the priority of the copy operation when it is started. This option allows the user to controlthe overall speed of a particular task. If this

• @G@ - The ISO8601 year number corresponding to the ISO8601 week (%V), expressed asa four-digit number.• @h@ - Abbreviated month name.• @H@ - Hour

Create a set of copies for the volumes in set vvcopyset, keeping snapshots around for quickresynchronization:cli% createvvcopy -s -p set:vvcopyset set

• If the source or destination are volume sets then the createvvcopy command createsconsistent group snapshots at the same point in time so that relat

createvvsetDESCRIPTIONThe createvvset command defines a new set of Virtual Volumes (VV) and provides the optionof assigning one or more existing VVs t

To add a VV to the set:cli% createvvset -add vvset vv1To create a VV set with a comment and a collection of VVs in it:cli% createvvset -comment “Our O

12 Dismiss CommandsdismisspdDESCRIPTIONThe dismisspd command removes Physical Disk (PD) definitions from system use.SYNTAXdismisspd <PD_ID>...AU

dismissrcopylinkDESCRIPTIONThe dismissrcopylink command removes one or more links (connections) created with theadmitrcopylink command to a target sys

NOTES• This command is finished with a list of one or more links to be dismissed.• For IP targets, this list is made up of pairs composed of the node

dismissrcopytargetDESCRIPTIONThe dismissrcopytarget command removes a Remote Copy target from a Remote Copyvolume group.SYNTAXdismissrcopytarget [opti

dismissrcopyvvDESCRIPTIONThe dismissrcopyvv command removes a virtual volume from a Remote Copy volume group.SYNTAXdismissrcopyvv [option] [<patter

EXAMPLESThe following example dismisses virtual volume vv1 from Group1:cli% dismissrcopyvv vv1 Group1The following example dismisses all virtual volum

AUTHORITYThis section defines the user access required within the HP 3PAR Storage System to use thecommand.SUBCOMMANDSThis section indicates any neces

13 Free CommandfreespaceDESCRIPTIONThe freespace command frees snapshot administration and snapshot data spaces from a VirtualVolume (VV) if they are

14 Grow CommandsgrowaldvvDESCRIPTIONThis command was deprecated in the 2.2.4 release and will be changed or removed in a futurerelease. Please use the

Suppresses the requested confirmation before growing a virtual volume with a different RAID typethan the last region of the existing virtual volume, o

Specifies a pattern for disks. Patterns are used to select disks that are used for creating logicaldisks. If no pattern is specified, the option defau

–fc_lt <number>Specifies that physical disks with free chunklets less than the number specified are selected.–devid <ID>Specifies that phy

EXAMPLESThe following example displays the enlarging of a RAID-5 virtual volume with 3+1 parity rationamed vv01 by 10 GB:cli% growaldvv –szu 10g –t r5

growavvDESCRIPTIONThis command was deprecated in the 2.2.4 release and will be changed or removed in a futurerelease. Please use the growvv command in

Specifies the LDs to be used as snapshot data space. The LDs are identified by one or more integers(item). Integers can be provided as a single number

growtpvvDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease. Please use the growvv command i

growvvDESCRIPTIONThe growvv command increases the size of a virtual volume.SYNTAXgrowvv <VV_name> <size>[g|G|t|T]AUTHORITY• Super, Edit• A

2 Commands Quick ReferenceThe HP 3PAR Command Line Interface provides a host of commands allowing you to administeryour HP 3PAR storage system. To fac

15 Hist CommandshistchDESCRIPTIONThe histch command displays a histogram of service times in a timed loop for individual chunklets.SYNTAXhistch [optio

Specifies that the histogram displays data either from a previous sample (–prev) or from whenthe system was last started (–begin). If no option is spe

SPECIFIERSNone.RESTRICTIONSNone.EXAMPLESThe following example displays one iteration of a histogram of service times for system chunklets:cli% histch

histldDESCRIPTIONThe histld command displays a histogram of service times for Logical Disks (LDs) in a timedloop.SYNTAXhistld [options <arg>] [&

Histogram displays data either from a previous sample (–prev) or from when the system was laststarted (–begin). If no option is specified, the histogr

Specifies the LD(s) or pattern(s) for which the histogram data is collected.RESTRICTIONSNone.EXAMPLESThe following example displays one iteration of a

histpdDESCRIPTIONThe histpd command displays a histogram of service times for Physical Disks (PDs).SYNTAXhistpd [options <arg>]AUTHORITYAny role

For the I/O size histogram, show the columns from the first column (<fcol>) through the lastcolumn (<lcol>). Available columns range from

◦ t - Specifies total statistics.◦ rw - Specifies total read and write statistics.• <val_ms>Specifies the threshold service time in milliseconds

A range of disk positions is separated with a hyphen (0–3). The specified position(s) must containdisks.–dk <item>Specifies one or more physical

Disk Enclosure Management CommandsDrive Cage ManagementFor Details SeeAuthorityDescriptionCommand“locatecage” (page 206)Super, Service1Any role grante

EXAMPLESThe following example displays a histogram of service times for all physical disks and shows thecolumns from 8ms to 8192 ms. Only pds with mor

histportDESCRIPTIONThe histport command displays a histogram of service times for ports within the system.SYNTAXhistport [options <arg>]AUTHORIT

–sizecols <fcol> <lcol>For the I/O size histogram, show the columns from the first column (<fcol>) through the lastcolumn (<lcol&

◦ t - Specifies total statistics.◦ rw - Specifies total read and write statistics.• <val_ms>Specifies the threshold service time in milliseconds

histrcvvDESCRIPTIONThe histrcvv command shows a histogram of total Remote Copy service times and backupsystem Remote Copy service times in a timed loo

Displays the sums for all volumes of a domain.-domain <domainname>...|<pattern>...Shows only the virtual volumes that are in domains with

RESTRICTIONSNone.EXAMPLESThe following example shows histograms sums for all synchronous Remote Copy volumes: cli% histrcvv -vvsum -sync 09:

histvlunDESCRIPTIONThe histvlun command displays Virtual Volume Logical Unit Number (VLUN) service timehistograms.SYNTAXhistvlun [options <arg>]

–hostsumSpecifies that sums for VLUNs are grouped by host in the display. All VLUNs to unnamed hostsare added and displayed as a single set of data wi

Sort in increasing order (default).decSort in decreasing order.–filt <fspec>Specifies that histograms below the threshold specified by the <f

© Copyright 2013 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possession, use or copyin

For Details SeeAuthorityDescriptionCommand“createdomainset”(page 116)SuperAny role granted thedomainset_create right.Defines a new set ofdomains and p

NOTES• Each service time histogram column shows the number of accesses with service times betweenthe point in time shown in the column's heading

histvvDESCRIPTIONThe histvv command displays Virtual Volume (VV) service time histograms in a timed loop.SYNTAXhistvv [options <arg>] [<VV_na

Specifies the interval in seconds that statistics are sampled from using an integer from 1 through2147483. If no count is specified, the command defau

EXAMPLESThe following example displays two iterations of a histogram of service times for all VVs:%cli histvv –iter 212:53:03 10/20/04 ------------Tim

16 Import CommandimportvvDESCRIPTIONThe importvv command initiates the migration of data from a remote LUN to the local HP 3PARStorage System. The rem

RESTRICTIONSFunctionality of this command requires the Peer Motion license. Contact your local service providerfor more information.EXAMPLESThe follow

17 Locate CommandslocatecageDESCRIPTIONThe locatecage command allows system administrators to locate a drive cage, drive magazine,or port in the syste

EXAMPLESThe following example causes the Fibre Channel LEDs on the drive cage cage0 to blink for 20seconds:cli% locatecage –t 20 cage0 NOTES• Issue th

locatenodeDESCRIPTIONThe locatenode command helps locate a particular node or its components by blinking LEDs onthe node. By default all LEDs on the n

locatesysDESCRIPTIONThe locatesys command helps locate a storage system by blinking the node status LEDs on allnodes of a storage system alternating b

Table 2 Alert Severity Levels (continued)DescriptionSeverityAn event has occurred that requires action, but the situation is not yet serious.MinorAn a

18 Move CommandsmovechDESCRIPTIONThe movech command moves a list of chunklets from one physical disk to another.SYNTAXmovech [options] <fd:fp–td:tp

EXAMPLESThe following example moves the chunklet in position 0 on disk 24, to position 50 on disk 64and chunklet in position 0 on disk 25, to position

• remote_pds_used. Remote PDs used.• ldpattern_not_obeyed. LD pattern was not obeyed.• raid_availability_reduced. RAID availability reduced.NOTES• Chu

movechtospareDESCRIPTIONThe movechtospare command moves data from specified Physical Disks (PDs) to a temporarylocation selected by the system.SYNTAXm

• failed. Indicates the chunklet was not moved.• Detailed_State. Provides additional details of the move with General Information, ErrorInformation, o

movepdDESCRIPTIONThe movepd command moves data from specified Physical Disks (PDs) to a temporary locationselected by the system.SYNTAXmovepd [options

NOTES• The destination physical disks do not need to be specified; the system automatically determinesthe spare locations.• Specifying the -dr option

movepdtospareDESCRIPTIONThe movepdtospare command moves data from specified Physical Disks (PDs) to a temporarylocation selected by the system.SYNTAXm

The columns in the previous example are identified as follows:• Status. The overall status of the move.• normal. Indicates the chunklet has successful

moverelocpdDESCRIPTIONThe moverelocpd command moves chunklets that were on a physical disk to the target ofrelocation.SYNTAXmoverelocpd [options] [<

For Details SeeAuthorityDescriptionCommand“settask” (page 338)Super, EditAny role granted thetask_set right.Sets the priority on aspecified task.setta

-mg <item>Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpdoutput indicating the side of the cage is

it must be used at least once on the command line. If this specifier is repeated then the operationis performed on multiple disks.RESTRICTIONSAccess t

• src_set_invalid. Source is in invalid set.• src_not_found. Source chunklet does not exist.• invalid_dest. Destination is invalid.• move_failed. Chun

movetodomainDESCRIPTIONThe movetodomain command moves objects from one domain to another.SYNTAXmovetodomain [options] <object_name> <domain_n

The following example displays the removal of the host testhost from any domain:cli% movetodomain -host testhost -unsetThe following hosts will have t

19 Promote CommandspromotesvDESCRIPTIONThe promotesv command copies the differences of a snapshot back to its base volume, allowingyou to revert the b

EXAMPLESThe following example illustrates how virtual volume vv1 can be promoted with the differencesfrom its base volume:cli% promotesv vv1NOTES• Iss

promotevvcopyDESCRIPTIONThe promotevvcopy command promotes a physical copy back to a regular base volume.SYNTAXpromotevvcopy <physical_copy_name>

20 Remove CommandsremovealertDESCRIPTIONThe removealert command removes one or more alerts from the system.CAUTION: Use care when removing alerts. Ale

Are you sure you want to remove it?select q=quit y=yes n=no: yId 131 – New Message code: 1114115 Thu May 05 00:11:25 PDT 2005 Node: 0 Severity: Minor

Node Date InformationFor Details SeeAuthorityDescriptionCommand“setdate” (page 291)Super, Service1Any role granted thedate_set right.Sets the system t

removeaocfgDESCRIPTIONThe removeaocfg command removes specified Adaptive Optimization configurations from thesystem.AUTHORITYSuper, EditSYNTAXremoveao

removecpgDESCRIPTIONThe removecpg command removes Common Provisioning Groups (CPGs) from the system orremoves specific Logical Disks (LDs) from CPGs.A

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

removedomainDESCRIPTIONThe removedomain command removes an existing domain from the system.SYNTAXremovedomain [option] <domain_name>AUTHORITY• S

removedomainsetDESCRIPTIONThe removedomainset command removes a domain set or removes domains from an existingset.SYNTAXremovedomainset [options] <

removehostDESCRIPTIONThe removehost command removes a system host or paths to a host. If one or more paths arespecified, the command removes only thos

NOTES• Removing an entire host definition by issuing the removehost <hostname> command isnot equivalent to removing all of the paths associated

removehostsetDESCRIPTIONThe removehostset command removes a host set or removes hosts from an existing set.SYNTAXremovehostset [options] <setname&g

removeldDESCRIPTIONThe removeld command removes a specified Logical Disk (LD) from the system service group.SYNTAXremoveld [options] {<LD_name>|

• Issuing the removeld command with the –pat option specified returns a request forconfirmation to remove LDs, unless the –f option is specified.• Do

1You need access to all domains in order to run this command.Network Interface ConfigurationFor Details SeeAuthorityDescriptionCommand“setnet” (page 3

removercopygroupDESCRIPTIONThe removercopygroup command removes a Remote Copy volume group or multiple RemoteCopy groups that match a given pattern.SY

EXAMPLESThe following example removes Group1 from a Remote Copy system:# removercopygroup Group1The following example removes Remote Copy groups that

removercopytargetDESCRIPTIONThe removercopytarget command removes target designation from a Remote Copy systemand removes all links affiliated with th

removeschedDESCRIPTIONThe removesched command removes a scheduled task from the system.SYNTAXremovesched [options] <schedname|pattern>AUTHORITY•

removesnmpmgrDESCRIPTIONThe removesnmpmgr command removes preregistered SNMP managers from receiving alerts(traps).WARNING! SNMP cannot be used in Com

EXIT STATUSThe following codes are returned indicating success or failure:• 0 indicates that the trap manager host was removed and the command was suc

removesnmppwDESCRIPTIONThe removesnmppw command allows a user to remove SNMP access community string passwords.WARNING! SNMP cannot be used in Common

removesnmpuserDESCRIPTIONThe removesnmpuser command allows a user to remove an SNMPv3 user.WARNING! SNMP cannot be used in Common Criteria mode. It mi

removespareDESCRIPTIONThe removespare command removes chunklets from the spare chunklet list.SYNTAXremovespare [options] <chunklet_specifier>...

EXAMPLESThe following example removes a spare chunklet from position 3 on physical disk 1:cli% removespare 1:3NOTES• Verify the removal of spare chunk

For Details SeeAuthorityDescriptionCommand“statiscsi” (page 598)Any role in the system.Displays the iSCSI statistics.statiscsi“statiscsisession” (page

removesshkeyDESCRIPTIONThe removesshkey command removes your Secure Shell (SSH) public key to disable keyauthentication.SYNTAXremovesshkey [<user_n

removetaskDESCRIPTIONThe removetask command removes information about one or more completed tasks and theirdetails.SYNTAXThe syntax of the removetask

The following example shows how to remove all tasks, including details.cli% removetask –aRemove all tasks?select q=quit y=yes n=no: yNOTES• See the HP

removetemplateDESCRIPTIONThe removetemplate command removes one or more Virtual Volume (VV), Logical Disk (LD),and Common Provisioning Group (CPG) tem

removeuserDESCRIPTIONThe removeuser command removes a user account from the system.SYNTAXremoveuser [option] <username>...AUTHORITY• Super• Any

removeuserconnDESCRIPTIONThe removeuserconn command removes user connections to the current system.AUTHORITY• Super• Any role granted the userconn_rem

removevlunDESCRIPTIONThe removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN)export definition from the system.SYNTAXThe

slotSpecifies the PCI bus slot in the node where slot is a number from 0 through 5.portSpecifies the FCS port number of the card in PCI bus slot using

removevvDESCRIPTIONThe removevv command removes Virtual Volumes (VVs) from the system.SYNTAXThe syntax of the removevv command can be as follows:• rem

Specifies the VV name, using up to 31 characters in length. This specifier can be repeated toremove multiple VVs. If this specifier is not used, the p

For Details SeeAuthorityDescriptionCommand“setstatpdch” (page 332)Super, EditAny role granted thestatpdch_set right.Sets statistics collectionmode on

removevvsetDESCRIPTIONThe removevvset command removes a VV set or removes VVs from an existing set.SYNTAXremovevvset [options] <setname> [<vv

21 Service CommandsservicecageDESCRIPTIONThe servicecage command is necessary when executing removal and replacement actions fora drive cage FC-AL mod

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–

servicehostDESCRIPTIONThe servicehost command executes removal and replacement actions for a host connecting toan HP 3PAR Storage System port.SYNTAXTh

Specifies a host’s World Wide Name (WWN). This specifier can only be used with the removeand copy subcommands. When used with the remove subcommand, t

servicemagDESCRIPTIONThe servicemag command executes service on a drive magazine or disk.SYNTAXThe syntax for the servicemag command can be one of the

Specifies that the command is forced. If this option is not used, the command requires confirmationbefore proceeding with its operation.–waitSpecifies

Specifies the drive magazine within the specified drive cage to be serviced based on the side ofthe drive magazine and drive magazine slot number.• Fo

... marking pd wwn [20000000870042F6] id [22] as usable for ld allocation... marking pd wwn [2000000087007E6D] id [23] as usable for ld allocationserv

servicenodeDESCRIPTIONThe servicenode command informs the system that a certain component is to be replaced, andcauses the system to indicate the phys

System TunerFor Details SeeAuthorityDescriptionCommand“tunepd” (page 647)Super, EditAny role granted thepd_tune right.Displays physical disks withhigh

EXAMPLESIn the following example, fan 1 on node 3 is put into servicing-mode:cli% servicenode -fan 1 3NOTESNone.270 Service Commands

22 Set CommandssetalertDESCRIPTIONThe setalert command sets the status of system alerts.SYNTAXsetalert new|ack|fixed {<alert_ID>...|–a}AUTHORITY

setaocfgDESCRIPTIONThe setaocfg command updates an Adaptive Optimization (AO) configuration.AUTHORITYSuper, EditSYNTAXsetaocfg [options <arg>] &

EXAMPLESThe following example changes the optimization bias (mode) of an AO configuration called aocfg1to Performance.cli% setaocfg -mode Performance

setauthparamDESCRIPTIONThe setauthparam command is used to set the authentication and authorization parameters.SYNTAXThe syntax of the setauthparam co

Table 3 Values for setauthparam Specifiers (continued)<value><param>Indicates the path name of the file containing the certificateof the C

Table 3 Values for setauthparam Specifiers (continued)<value><param>The objectClass attribute of an account object.account-objThe attribut

Table 5 Values for Specifiers <map-param> and <map-value> (continued)<map-value><map-param>Same as super-map, but for the Edit

setbatteryDESCRIPTIONThe setbattery command sets battery information such as the battery’s expiration date, itsrecharging time, and its serial number.

EXAMPLESThe following example resets the battery test log and the recharging time for a newly installedbattery on node 2, power supply 1, and battery

Remote Copy Volume StatisticsFor Details SeeAuthorityDescriptionCommand“histrcvv” (page 194)Any role in the system.Displays histogram data forRemote C

setcageDESCRIPTIONThe setcage command enables service personnel to set or modify parameters for a drive cage.SYNTAXsetcage [subcommand <arg>]...

NOTES• The parameters specified by the setcage command appear in the showcage –d output(see “showcage” (page 361)).• The power supply model cannot be

setcimDESCRIPTIONThe setcim command sets the properties of the CIM server, including options to enable or disablethe HTTP and HTTPS ports for the CIM

EXAMPLESTo disable the HTTPS ports:cli% setcim -https disableWarning: The CIM server is active and will restart. Are you sure you want to continue (Y/

setclienvDESCRIPTIONThe setclienv command sets the CLI environment parameters.SYNTAXsetclienv <parameter> <value>AUTHORITY• Super, Service

EXAMPLESIn the following example, the CLI environment is set to display domains information:cli% setclienv listdom 1NOTESThis command is only availabl

setcpgDESCRIPTIONThe setcpg command modifies existing Common Provisioning Groups (CPG).SYNTAXsetcpg [options <arg>] <CPG_name>AUTHORITY• S

Table 6 Growth Increment Per Number of Nodes (continued)MinimumDefaultNumber of Nodes24 GB96 GB5-632 GB128 GB7-8–sdgl <size> [g|G|t|T]Specifies

–nd <item>Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodesare separated with a single comma (1,2

Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL fornearline, or SSD for solid state drive) to be used. Dev

For Details SeeAuthorityDescriptionCommand“creatercopygroup”(page 127)Super, EditAny role granted thercopygroup_createright.Creates a group for Remote

nearline (NL), or solid state drive (SSD)). This implies that, within a CPG, one can have logicaldisks of type FC, type NL, and type SSD. However, thi

setdateDESCRIPTIONThe setdate command allows you to set the system time and date on all nodes.SYNTAXThe syntax for the setdate command can be one of t

• MMDDhhmmYY• MMDDhhmmCCYY• MMDDhhmm.ss• MMDDhhmmYY.ss• MMDDhhmmCCYY.ssEXAMPLESThe following example shows the timezone being set:Timezone set success

setdomainDESCRIPTIONThe setdomain command sets the parameters and modifies the properties of a domain.SYNTAXsetdomain [options <arg>] <domain

NOTESFor moving objects into a domain, use the movetodomain command.294 Set Commands

setdomainsetDESCRIPTIONThe setdomainset command sets the parameters and modifies the properties of a domain set.SYNTAXsetdomainset [options <arg>

sethostDESCRIPTIONThe sethost command sets properties on existing system hosts, including options to annotate ahost with descriptor information such a

-ip <IP_address>Specifies the IP address of the host.-os <OS>Specifies the operating system running on the host.-model <model>Specif

The World Wide Name (WWN) or iSCSI name of the host which should be reset or for whichhost agent data should be cleared.<node:slot:port>node — S

sethostsetDESCRIPTIONThe sethostset command sets the parameters and modifies the properties of a host set.SYNTAXsethostset [options <arg>] <s

Contents1 CLI Command Syntax and Conventions...11Syntax and Conventions...

For Details SeeAuthorityDescriptionCommand“stoprcopy” (page 634)Super, Edit1Stops a Remote Copysubsystem.stoprcopyAny role granted thercopy_stop right

setlicenseDESCRIPTIONThe setlicense command sets the license key information.SYNTAXsetlicense [options <arg>]AUTHORITY• Super, Service• Any role

NOTES• This command prompts for a new license key. To finish entering the license key, press enteron a blank line.• When the license key is being inte

setnetDESCRIPTIONThe setnet command sets the administration network interface configuration.AUTHORITY• Service, Super• Any role granted the net_set ri

Specifies that the network interface is set to the specified speed and duplex as indicated with the<mbps> and <duplex> specifiers.failover

<new_gateway>Specifies the IP address of the new gateway for the system. This specifier can only be used withthe startgateway subcommand.auto|&l

NOTES• If successful, this command causes any CLI or GUI clients currently connected to lose theirconnection.• To make it possible to change the netwo

setnodeDESCRIPTIONThe setnode command sets the properties of the node components such as the serial number ofthe power supply.AUTHORITY• Super, Servic

cli%cli% setnode ps 0 -s aabbccdd 1cli% shownode -psNode PS -Serial- -PSState-- FanState ACState DCState -BatState- ChrgLvl(%) 0 0 -- NotPres

setntpDESCRIPTIONThe setntp command sets the system Network Time Protocol (NTP) server. This command isdeprecated and will be removed in a subsequent

setpasswordDESCRIPTIONThe setpassword command allows a user with Super level role to change the password for anyuser and create a password file on a c

For Details SeeAuthorityDescriptionCommandAny role granted themag_service right.“upgradecage” (page 662)Super, Service1Upgrades drive cagefirmware.upg

The following example displays the prompts encountered when changing a user’s (user1) password:cli% setpassword –u user1password:Old password:NOTES• T

setpdDESCRIPTIONThe setpd command marks a Physical Disk (PD) as allocatable or non allocatable for LogicalDisks (LDs).SYNTAXsetpd ldalloc on|off <P

setqosDESCRIPTIONThe setqos command creates and updates QoS rules in a system.SYNTAXThe syntax for the setqos command can be one of the following exa

NOTESFor all the <pattern> fields, the patterns are glob-style (shell-style) patterns (see help on sub,globpat)When -vv option is present, the s

setrcopygroupDESCRIPTIONThe setrcopygroup command performs the following actions:• Sets the policy of the Remote Copy volume group for dealing with I/

Specifies the operation of the group(s). Valid operations are:• reverse - Changes the natural and current direction of all specified groups. The opera

promoted to the base volume in the case where all volumes of the group were not synced to thesame time point.The incorrect use of this option can lead

Specifies that if the Remote Copy is stopped as a result of the Remote Copy links going down, thegroup is restarted automatically after the links come

The following example reverses the current direction of secondary group Group1 on System2 (thesecondary system) so that I/O might be applied to the gr

setrcopytargetDESCRIPTIONThe setrcopytarget command sets the name, policies, or throughput definition for the target’slinks.SYNTAXThe syntax for the s

System UpgradeFor Details SeeAuthorityDescriptionCommand“showpatch” (page 419)Any role in the system.Displays patches applied toa system.showpatch“sho

and stoprcopygroup) involving the specified target are duplicated (mirror_config) or notduplicated (no_mirror_config). If not specified, all configura

NOTES• The setrcopytarget command requires the groups associated with it be stopped prior tousing the following options:◦ setrcopytarget name <new_

setschedDESCRIPTIONThe setsched command allows users to suspend, pause, change the schedule, change theparameters, and change the name of currently sc

EXAMPLESNone.NOTESNone.setsched 323

setsnmpmgrDESCRIPTIONThe setsnmpmgr command changes an SNMP manager's properties.SYNTAXThe syntax for the setsnmpmgr command can be one of the fo

The following example modifies the user and version properties of the SNMP manager identifiedby the IPv4 address 123.45.67.89:cli% setsnmpmgr -snmpuse

setsnmppwDESCRIPTIONThe setsnmppw command allows a user to update SNMP access community strings passwords.The SNMP password is required for the system

NOTES• The default initial read/write password is public.• If the read-only or write-only passwords do not exist, they are created.• Verify SNMP passw

setsnmpuserDESCRIPTIONThe setsnmpuser command sets the SNMPv3 user secret key used for generating authenticationand privacy keys. The username must co

setsshkeyDESCRIPTIONThe setsshkey command sets the SSH public key for a user.The user will be prompted to provide the SSH public key. To finish enteri

1You need access to all domains in order to run this command.System Reporter CommandsFor Details SeeAuthorityDescriptionCommand“sraomoves” (page 535)A

NOTES• Issuing the setsshkey command results in the system prompting for your SSH public key.Copy and paste the key using the aforementioned ASCII edi

setstatchDESCRIPTIONThe setstatch command starts and stops the statistics collection mode for chunklets.SYNTAXsetstatch start|stop <LD_name> <

setstatpdchDESCRIPTIONThe setstatpdch command sets the statistics collection mode for all in-use chunklets on a PhysicalDisk (PD).SYNTAXsetstatpdch st

setsysDESCRIPTIONThe setsys command sets the properties of the system, and includes options to annotate a systemwith descriptor information such as ph

Performs the same function as RawSpaceAlertFC, but should be used for Serial Attached SCSItype drivesRemoteSyslog <value>Enables or disables sen

PortFailoverEnabled <value>Enables or disables the automatic failover of target ports to their designated partner ports. Ifenabled, automatic fa

setsysmgrDESCRIPTIONThe setsysmgr command sets the system manager startup state.CAUTION: Issuing the setsysmgr command can potentially remove the enti

Specifies the ID of the system to be started.<toc_gen_number>Specifies the table of contents generation number for the system to start with.<

settaskDESCRIPTIONThe settask command sets the priority on specified task.SYNTAXsettask [-f] -pri <high|med|low> <task_ID>AUTHORITY• Super

settemplateDESCRIPTIONThe settemplate command modifies the properties of existing templates.SYNTAXsettemplate <option_value>... [option <arg&

For Details SeeAuthorityDescriptionCommand“srstatport” (page 568)Any role in the system.Displays historicalperformance data reports forports.srstatpor

NOTES• All options available for the createald, createaldvv, createcpg, and createtpvvcommands can be used with the settemplate command to modify an e

setuserDESCRIPTIONThe setuser command sets your user properties.SYNTAXsetuser [options <arg>] <user>AUTHORITY• Super, Edit, Browse• Any ro

setuseraclDESCRIPTIONThe setuseracl command sets the Access Control List (ACL).SYNTAXsetuseracl [options] <user_name> <operation> [<nam

The following example shows how to remove vv3 from the ACL for user testuser1:cli% setuseracl -remove testuser1 updatevv vv3The following example show

setvvDESCRIPTIONThe setvv command changes the properties associated with a virtual volume. Use the setvvcommand to modify volume names, volume policie

Specifies that the volume snapshot space is to be provisioned from the specified CPG. This optionmoves all the logical disks currently contained in th

This option returns a user space allocation warning. It generates a warning alert when the reserveduser space of the TPVV exceeds the specified percen

NOTES• Use the setvv command to associate a standard virtual volume with a common provisioninggroup (CPG) for use with Remote Copy.• To view policies

setvvsetDESCRIPTIONThe setvvset command sets the parameters and modifies the properties of a Virtual Volume (VV)set.SYNTAXsetvvset [options <arg>

setwsapiDESCRIPTIONThe setwsapi command sets properties of the Web Services API server, including options toenable or disable the HTTP and HTTPS ports

For Details SeeAuthorityDescriptionCommand“movepdtospare” (page 217)Super, Service, Edit1Moves specified physicaldisks to spare.movepdtospareAny role

23 Show CommandsshowalertsystemDESCRIPTIONThe showalert command displays the status of system alerts. When issued without options, allnew customer ale

EXAMPLESThe following example displays new customer alerts on a system:cli% showalert -nId : 1State : NewMessage Code: 0x2200deTime

showaocfgDESCRIPTIONThe showaocfg command shows Adaptive Optimization (AO) configurations in the system.SYNTAXshowaocfg [options <arg> [<aocf

showauthparamDESCRIPTIONThe showauthparam command shows authentication parameters.SYNTAXshowauthparamAUTHORITYAny role in the system.OPTIONSNone.SPECI

showbatteryDESCRIPTIONThe showbattery command displays battery status information including serial number, expirationdate, battery life, and so on, wh

RESTRICTIONSNone.EXAMPLESThe following example displays battery status information:cli% showbatteryNode PS Bat Serial --State--- ChrgLvl(%) -ExpDate

The following example displays the inventory information for the battery using the showbattery–i command:cli% showbattery -i Node PS Bat -Manufacturer

The following example displays the detailed status of the battery using the showbattery –scommand:cli% showbattery -stateNode PS Bat -State- -Detailed

showblockDESCRIPTIONThe showblock command displays block mapping information for Virtual Volumes (VVs), LogicalDisks (LDs), and Physical Disks (PDs).S

The following example displays detailed block mapping information for block 0 in the user spaceof VV admin:cli% showblock –d vv admin usr 0 VV/LD

User Management CommandsFor Details SeeAuthorityDescriptionCommand“createuser” (page 149)Super1Creates user accounts.createuserAny role granted theuse

NOTESNone.360 Show Commands

showcageDESCRIPTIONThe showcage command displays information about drive cages.SYNTAXThe syntax of the showcage command can be one of the following:•

EXAMPLESThe following examples display information for a single system’s drive cages:cli% showcageId Name LoopA Pos.A LoopB Pos.B Drives Temp RevA R

Interface Board Info LoopA LoopB Firmware_status Current Current Product_Rev 03 03 IFC_State OK OK

State Normal Op Loop_Split 0VendorId,ProductId 3PARdata,DC4 Unique_ID 1062010000001C00Power S

showcimDESCRIPTIONThe showcim command displays the CIM server current status, either active or inactive. It alsodisplays the current status of the HTT

• HTTP. Indicates the HTTP port state.--. Cannot determine the HTTP port state.◦◦ Enabled. HTTP port is enabled.◦ Disabled. HTTP port is disabled.• HT

showclienvDESCRIPTIONThe showclienv command displays the CLI environment parameters.SYNTAXshowclienvAUTHORITYAny role in the system.OPTIONSNone.SPECIF

showcpgDESCRIPTIONThe showcpg command displays Common Provisioning Groups (CPGs) in the system.SYNTAXshowcpg [options <arg>] [<CPG_name>..

EXAMPLESThe following example displays a system’s CPGs:cli% showcpg ---------------(MB)--------------- -

Volume Management CommandsCommon Provisioning Group ManagementFor Details SeeAuthorityDescriptionCommand“compactcpg” (page 75)Super, EditConsolidates

• Warn%. The CPG’s allocation warning threshold.• Volumes. Virtual Volumes (VVs) and Thinly Provisioned Virtual Volumes (TPVVs).• VVs. The Number of V

1 cpg2 - 32768 - - - - - - 8192 - - 2 cpg3 - 32768 - - - - - - 8192 - - 3 cpg4 - 32768 - -

• 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. T

showdateDESCRIPTIONThe showdate command displays the date and time for each system node.SYNTAXshowdateAUTHORITYAny role in the system.OPTIONSNone.SPEC

showdomainDESCRIPTIONThe showdomain command displays a list of domains in a system.SYNTAXshowdomain [options <arg>]AUTHORITYAny role in the syst

NOTESIf the VVRetentionTimeMax is--, then the minimum volume retention time for the system is usedinstead. If the VVRetentionTimeMax is 0, then the vo

showdomainsetDESCRIPTIONThe showdomainset command lists the host sets defined on the HP 3PAR storage system andtheir members.SYNTAXshowdomainset [opti

Show domain sets containing domains matching the pattern domainset.*:cli% showdomainset -domain domainset.*Id Name Members 7 domainset domainset.

showeepromDESCRIPTIONThe showeeprom command displays node EEPROM log information.SYNTAXshoweeprom [options] [<node_ID>...]AUTHORITYAny role in t

Code 20 (AP Init Failure) - Subcode 0x0 (0) Tue Jan 29 13:30:56 2008Code 25 (PROM Failure) - Subcode 0x1 (0) Tue Jan 29 13:17:57 2008

For Details SeeAuthorityDescriptionCommand“sethost” (page 296)Super, Edit1Sets properties on existingsystem hosts, includingsethostAny role granted th

• Last panic displays the last time another node in the cluster requested this node to takea panic.• Error ignore code is for engineering use only.• S

showeventlogDESCRIPTIONThe showeventlog command displays the current system event log.SYNTAXshoweventlog [options <arg>]AUTHORITYAny role in the

Specified as the month (mm or month_name) and day (dd), where the year (yy) can be optionallyspecified. Acceptable formats are mm/dd/yy, month_name dd

EXAMPLESThe following example displays the system events occurred during the last 20 minutes:cli% showeventlog -min 20Mon Sep 29 09:48:07 2003 PSTNode

showfirmwaredbDESCRIPTIONThe showfirmwaredb command displays the current database of firmware levels for possibleupgrade. If issued without any option

HITACHI [JLAK] DK..CJ-36FC Current DC4 /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [JLAK] DK..CJ-72FC Current

showhostDESCRIPTIONThe showhost command displays information about defined hosts and host paths in the system.SYNTAXshowhost [options <arg>] [&l

Shows only hosts that are in domains or domain sets that match one or more of the specifier<domain_name_or_pattern> or set:<domain_set> ar

0 queasy10 queasy10 s019 1 foo -- --The following example displays all host information:cli% showhost –verboseId

showhostsetDESCRIPTIONThe showhostset command lists the host sets defined on the HP 3PAR storage system and theirmembers.SYNTAXshowhostset [options] [

For Details SeeAuthorityDescriptionCommand“showpdch” (page 432)Any role in the system.Displays the status ofselected chunklets ofphysical disks.showpd

Show the host sets containing host sun40z-09-0:cli% showhostset -host sun40z-09-0Id Name Members 3 sunv40z-09 sunv40z-09-0 sunv40z-

showinventoryDESCRIPTIONShows information about all the hardware components in the system.SYNTAXshowinventory [options]AUTHORITYAny role in the system

showiscsisessionDESCRIPTIONThe showiscsisession command shows the iSCSI sessions.SYNTAXshowiscsisession [option <arg>]AUTHORITYAny role in the s

• iSCSI_Name. The iSCSI name of the host.• StartTime. The time the session was started.NOTESNone.showiscsisession 393

showldDESCRIPTIONThe showld command displays configuration information about the system’s Logical Disks (LDs).SYNTAXshowld [options <arg>] [<

SPECIFIERS<LD_name>...Requests that information for a specified logical disk is displayed. This specifier can be repeatedto display configuratio

• 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.

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/-

The following example displays policy information about all system LDs:cli% showld -p Id Name Keep_Preserved Growth_Blocked Dev_Type RPM 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 th

Virtual Volume Statistics...27Remote Copy Volume St

For Details SeeAuthorityDescriptionCommandAny role granted thevv_create right.“createvv” (page 154)Super, Edit1Creates a virtual volumefrom logical di

showldchDESCRIPTIONThe showldch command displays configuration information about the chunklet mapping for oneLogical Disk (LD).SYNTAXshowldch [options

3 0 1 1:3:0 28 0 normal ld valid N --- --- 4 0 2 0:1:2 6 0 normal ld valid N --- --- 5 0 2 2:1:3 39

• Media. The current status of the physical disk medium for the chunklet.valid. The chunklet is available for use.◦◦ failed. The medium has encountere

4 0 47-2:3:3 18-1:0:2 14-0:3:2 33-2:0:1 4 1 2-0:0:2 28-1:3:0 37-2:1:1 22-1:1:2NOTESNone.showldch 403

showldmapDESCRIPTIONThe showldmap command displays the mapping from a Logical Disk (LD) to Virtual Volumes (VVs).SYNTAXshowldmap <LD_name>AUTHOR

showlicenseDESCRIPTIONThe showlicense command displays the currently installed license key and current licenseinformation.SYNTAXshowlicenseAUTHORITYAn

SV47–NH2R–BL1L–TJKR–31F2–V9QX–0WM0–AWTHLRB7–8XQD–BLHD–LF68–A4BW–K4QG–ZS7B–Q41X35Y1–6CZC–KBJ5–6VQE–EC2G–Q6EG–SJV0–KMHCSAWG–YJ4V–WRE5–3GZA–DGW0–ZYVE–5SV

shownetDESCRIPTIONThe shownet command displays the configuration and status of the administration networkinterfaces, including the configured gateway

RX Bytes: 0 TX Bytes: 0RX Errors: 0 TX Errors: 0RX Dro

shownodeDESCRIPTIONThe shownode command displays an overview of the node-specific properties and its componentinformation. Various command options can

For Details SeeAuthorityDescriptionCommand“showrsv” (page 469)Any role in the system.Displays information aboutreservation and registrationshowrsvof V

Specifies detailed information in verbose format. It can be used with any of the following componentoptions:-fanDisplays the node fan information.–pci

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

1 4-slot 1 J0900 DIMM1.0 Data DDR_SDRAM Micron Technology E010DF97 CL2.0/2.5 2048 1 4-slot 2 J1300 DIMM2.0 Data DDR_SDRAM Micro

0 0 Seagate ST9100821AS 5NJ09DF3 3.AAB 95396 SATA 1 0 Seagate ST9100821AS 5NJ08NA4 3.AAB 95396 SATAIn the e

• CPUSpeed. The speed of the CPU in MHz.• BusSpeed. The bus speed of the CPU in MHz.cli% shownode -ps-------------------------Power Supplies----------

◦ NotPresent. The battery is missing.◦ MaxLifeLow. The maximum battery life is low.• ChrgLvl. The battery charge level in percentage.The following exa

The following example displays the detailed state of the power supplies:cli% shownode -ps Node PS -State- -Detailed_State- 0 0 OK OK

shownodeenvDESCRIPTIONThe shownodeenv command displays the node operating environment status, including voltagesand temperatures.SYNTAXshownodeenv [op

LM87 Ext Temp: 20 C -10 C 65 C Within Tolerance CPU0 Temp: 24 C 0 C 85 C Within Tolerance

showpatchdescriptionThe showpatch command displays patches applied to a system.SYNTAXshowpatch [option <arg>]AUTHORITYAny role in the system.OPT

3 Add CommandaddsnmpmgrDESCRIPTIONThe addsnmpmgr command adds an SNMP manager to receive alert (traps) notifications.WARNING! SNMP cannot be used in C

showpdDESCRIPTIONThe showpd command displays configuration information about a system’s Physical Disks (PDs).SYNTAXshowpd [options] [<PD_ID>...]

The following columns are shown: Id, CagePos, Type, State, Detailed_State.-sShow detailed information regarding the state of each PD.This option is de

Specifies one or more ports. Ports are identified by one or more integers (item). Multiple portsare separated with a single comma (1,2,3). A range of

performance benchmark that takes into account in I/O per second, bandwidth and the accesstime.Disks that satisfy all of the specified characteristics

• 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

• 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 operati

• Node_WWN. Node World Wide Name of the disk.• MFR. Physical disk manufacturer.• Model. Physical disk manufacturer’s device ID.• Serial. Physical disk

• Spare Chunklets. This area provides information about chunklets that are reserved for useas spares.• OK. Number of chunklets with data that is acces

The following example displays the states of each physical disk:cli% showpd -stateID CagePos Type -State- -Detailed_State- 0 0:0:0 FC normal no

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

5de:2008:0:0abcd::161a.RESTRICTIONSAccess to all domains is required to run this command.EXAMPLESThe following example displays the addition of SNMP m

The following example displays all disk in magazine 0 of cage 0 and 1:cli% showpd -p -mg 0 -cg 0,1 --Size(MB)--- ----

showpdataDESCRIPTIONThe showpdata command displays information about the preserved data in the system.SYNTAXshowpdata [<LD_name>]AUTHORITYAny ro

showpdchDESCRIPTIONThe showpdch command displays the status of selected Physical Disk (PD) chunklets.SYNTAXshowpdch [options]showpdch [options] <pd

incSort in increasing order (default).decSort in decreasing order.Multiple columns can be specified and separated by a colon (:). Rows with the same i

–tc_gt <number>Specifies that PDs with total chunklets greater than the number specified are selected.–tc_lt <number>Specifies that PDs wi

The columns in the previous example are identified as follows:• Pdid. The physical disk on which the chunklets reside.• Chnk. The chunklet number.• Ld

NOTESNone.436 Show Commands

showpdvvDESCRIPTIONThe showpdvv command displays the virtual volumes hat are mapped to a particular physicaldisk.SYNTAXshowpdvv [options] [<PD_ID&g

–dk <item>Specifies one or more physical disks. Disks are identified by one or more integers (item). Multipledisks are separated with a single c

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 co

4 Admit CommandsadmithwDESCRIPTIONThe admithw command admits new hardware into the system.AUTHORITYSuper, ServiceNOTE: You need access to all domains

showportDESCRIPTIONThe showport command displays information about ports in the system.SYNTAXThe syntax of the showport command can be one of the foll

-failedDisplays only failed ports.-stateDisplays the detailed state information.-sDisplays the detailed state information. This option has been deprec

0:0:1 target ready 2FF70002AC0000AA 20010002AC0000AA host FC - 1:0:1 none0:0:2 initiator ready 2FF70002AC0000AA 2

◦ loss_sync. Link loss sync.◦ error. Currently in an error state.◦ non_participate. Link not participating.◦ taking_coredump.Coredump in progress.◦ of

• Partner Location of failover partner port in <Node>:<Slot>:<Port> format• FailoverState The failover state of the two ports indica

• ConnType. Indicates the type of connection configured for the port; loop for loop, pointfor point-to-point, or lp for loop or point-to-point.• CfgRa

• Type. Indicates the port connection type.• rcip. Port is used for Remote Copy over IP (RCIP).The following example displays the detailed state of th

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

The following examples display both standard and detailed information about SFPs attached toports:cli% showport -sfpN:S:P -State- -Manufacturer- MaxSp

showportarpDESCRIPTIONThe showportarp command shows the ARP table for iSCSI ports in the system.SYNTAXshowportarp [<N>:<S>:<P>]AUTHO

• The admithw command also handles creating system logical disks while adding andrebalancing spare chunklets.• Spares are allocated according to the a

showportdevDESCRIPTIONThe showportdev command displays detailed information about devices on a specified port.SYNTAXshowportdev loop|all|ns|sas|fcswit

Specifies the port for which information about devices on that port are displayed.nodeSpecifies the node.slotSpecifies the PCI bus slot in the specifi

NOTESThe loop subcommand is functional only in a private loop topology.452 Show Commands

showportisnsDESCRIPTIONThe showportisns command shows iSNS host information for iSCSI ports in the system.SYNTAXshowportisns [<N>:<S>:<

showportlesbDESCRIPTIONThe showportlesb command displays Fibre Channel Link Error Status Block (LESB) counters (thenumber of errors accumulated for Fi

• 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 1 4 0 0 334 0pd3 0x79 1 4 0 0 401 0pd2 0x80 1

• LossSig. Loss of signal (electrical or optical) to the receiver port of a Fibre Channel node.• PrimSeq. Primitive Sequence Protocol Error. There wer

showqosDESCRIPTIONThe showqos command lists the QoS rules configured in a system.SYNTAXThe syntax for the showqos command can be one of the following

1 vvset vsb on 4000 204800 4 vvset vsc on - 102400 3 vvset vsd on 5000 102

admitpdDESCRIPTIONThe admitpd command creates and admits physical disk definitions to enable the use of thosedisks.AUTHORITY• Super, Service• Any role

showrcopyDESCRIPTIONThe showrcopy command displays details of the Remote Copy configuration. The showrcopycommand also displays the group’s domain nam

Link InformationTarget Node Address Status OptionsSystem2 0 10.100.33.11 Up System2 1 10.101.33.11 Up receive 0 1

Group InformationName Target Status Role Mode Optionsbart bf_mirror Started Primary Periodic Last-Sync Tue Jul 18

NOTES• If the showrcopy command is used with no specifiers, all configuration information isdisplayed.• The showrcopy command also displays the group’

showrctransportDESCRIPTIONThe showrctransport command shows status and information about end-to-end transport forRemote Copy in the system.SYNTAXshowc

◦ ready. Configuration is completed on this port and the peer port; transport is ready foruse.◦ missing. A configured transport was disconnected.• Typ

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_W

showroleDESCRIPTIONThe showrole command displays information about rights assigned to roles in the system. Withoutany argument, showrole displays the

NOTESTo avoid cluttering the output, the show commands rights are not included in the output of theshowrole because show commands are granted to all r

showrsvDESCRIPTIONThe showrsv command displays SCSI reservation and registration information for Virtual VolumeLogical Unit Numbers (VLUNs) bound for

• Verify the admittance of physical disk definitions by issuing the showpd command. See“showpd” (page 420).• If no WWN is specified or if all the spec

• 5. (Write exclusive–registrants only). All read requests allowed. Write requests allowed forregistered initiators only.• 6. (Exclusive access–regist

showschedDESCRIPTIONThe showsched command shows the state of tasks currently scheduled on the system.SYNTAXshowsched [options][<schedname>|<p

move_back_chunklet4 moverelocpd -f 3,10 17 2 * * 3 3parsvc active Y 2009-03-18 02:17:00 PDTmove_back_chunklet5 movereloc

showsnmpmgrDESCRIPTIONThe showsnmpmgr command displays a list of registered SNMP managers for receiving traps.WARNING! SNMP cannot be used in Common C

showsnmppwDESCRIPTIONThe showsnmppw command displays the SNMP community string passwords.WARNING! SNMP cannot be used in Common Criteria mode. It migh

showsnmpuserDESCRIPTIONThe showsnmpuser command displays information about one or all SNMP users, including theusername, authentication and privacy pr

showspaceDESCRIPTIONThe showspace command displays estimated free space for logical disk creation.SYNTAXshowspace [options <arg>]AUTHORITYAny ro

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-

–devtype <type>Specifies that physical disks must have the specified device type (FC for Fibre Channel or NL,nearline, or SSD for solid state dr

showspareDESCRIPTIONThe showspare command displays information about chunklets in the system that are reservedfor spares and previously free chunklets

admitrcopylinkDESCRIPTIONThe admitrcopylink command adds one or more links (connections) to a Remote Copy targetsystem.SYNTAX• For Remote Copy over IP

◦ normal. The chunklet is available for use.◦ normal,smag. A servicemag operation is performed on the disks.◦ none. Chunklets were not used by any log

showsshkeyDESCRIPTIONThe showsshkey command will displays all SSH public keys that have been set with setsshkey.SYNTAXshowsshkeyAUTHORITYAny role in t

showsysDESCRIPTIONThe showsys command displays the HP 3PAR storage system properties includes system name,model, serial number, and system capacity in

ID -Name- ---Model--- -Serial- Nodes Master TotalCap AllocCap FreeCap FailedCap15 s015 InServ T400 1000015 2 0 1063424 208384 855040

The following example displays more detailed (–d option) information about the same system:cli% showsys -d------------General-------------System Name

defaults. When (from default settings) is displayed, system parameters cannot beupdated.• The system capacity information may have some overlaps among

showsysmgrDESCRIPTIONThe showsysmgr displays startup state information about the system manager.SYNTAXshowsysmgrAUTHORITYAny role in the system.OPTION

following message is displayed. See “NOTES” (page 487) in the following section for additionalinformation.cli% showsysmgrSystem is recovering from a p

showtargetDESCRIPTIONThe showtarget command displays information about unrecognized targets.SYNTAXshowtarget [<Node_WWN>...]showtarget -lun <

0:5:2 50002AC00014001F 20520002AC00001F peer_volume1:5:2 50002AC00014001F 21520002AC00001F peer_volumeIf unknown targets are found, information (Port,

NOTES• The transport layer (RCIP or RCFC) is set using the creatercopytarget command.• This command concludes by returning a list of one or more links

showtaskDESCRIPTIONThe showtask command displays information about tasks. By default, this command displays allnon-system tasks on the system within t

RESTRICTIONSNone.EXAMPLESThe following example displays all tasks on a system. In this case, the last task is still in progress.cli% showtaskId Type

◦ tune_vv_rollback. Track rolling back of 3PAR System Tuner volume tuning operationthat was previously interrupted (tunealdvv –rollback command). Requ

NOTES• See the HP 3PAR Command Line Interface Administrator’s Manual for additional informationand examples regarding task management and task managem

showtemplateDESCRIPTIONThe showtemplate command displays existing templates that can be used for Virtual Volume(VV), Logical Disk (LD), or Common Prov

showtocDESCRIPTIONThe showtoc command displays the system table of contents summary that provides a summaryof the system’s resources.SYNTAXshowtocAUTH

showtocgenDESCRIPTIONThe showtocgen command displays the table of contents generation number.SYNTAXshowtocgenAUTHORITYAny role in the system.OPTIONSNo

showuserDESCRIPTIONThe showuser command displays information about one or all users, including the username,authority level, and system resources to w

NOTES• Users are created using the createuser command. See “createuser” (page 149) for moreinformation.• For the first usage (without the -k option),

showuseraclDESCRIPTIONThe showuseracl command displays a user’s access control list (ACL).SYNTAXshowuseraclAUTHORITYAny role in the system.OPTIONSNone

8 CLI Command...72cli...

admitrcopytargetDESCRIPTIONThe admitrcopytarget command adds a target to a Remote Copy volume group.SYNTAXadmitrcopytarget <target_name> <mod

showuserconnDESCRIPTIONThe showuserconn command displays information about users who are currently connected(logged in) to the HP 3PAR storage system.

The columns in the previous example are identified as follows:• Id. Your HP 3PAR storage system identification number.• Name. Indicates the user name

showversionDESCRIPTIONThe showversion command displays information about the storage server software. Use thiscommand to determine if your system is u

showvlunDESCRIPTIONThe showvlun command displays information about Virtual Volume Logical Unit Numbers (VLUNs)in the system, such as all active and te

–l {<LUN|pattern>}...Specifies that only exports to the specified LUN are displayed. This specifier can be repeated todisplay information for mu

2 test.2 sun 210000E08B023C71 1:5:1 host 3 test.3 sun 210000E08B023C71 1:5:1 host----------------------------------------------- 8VLUN T

showvvDESCRIPTIONThe showvv command displays information about all Virtual Volumes (VVs) or a specific VV in asystem.SYNTAX• showvv [options <arg&g

–rDisplays 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,U

Sorts command output based on the column number <col>. Columns are numbered from left toright, beginning with 0. At least one column must be spe

• -rcopygroup {<group_name|pattern>}...Displays only VVs that are in Remote Copy groups that match one or more of the specifiedgroups or pattern

admitrcopyvvDESCRIPTIONThe admitrcopyvv command adds an existing virtual volume to an existing Remote Copy volumegroup.SYNTAXadmitrcopyvv [options] &l

Specifies the VV name (up to 31 characters in length) matching the glob-style pattern or that aremembers of the supplied VV set will have their inform

option is also set to 1 if the CLI was started with the -listdom option or if the CLI wasstarted with the TPDLISTDOM environment variable.• Type. Indi

◦ copy_source. Copy Source.◦ unknown. Volume state unknown.• Adm. The snapshot administrator space in megabytes.• Snap. The snapshot space in megabyte

13 BasketDome cpvv base 0 0 0 0 0.0 2 5 256 256 100.0 -- -- 256 256-------------------------------------------------

The following example displays policy information for virtual volume 0:cli% showvv -p 0Id Name Domain Policies 0 admin -

• 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).◦

The following example displays raw space usage information for thin provisioned VVs exportedto host hname and all VVs in the tree with the base VV of

The following example shows the policies associated with a volume:cli% showvv -polId Name --------------------------Policies--------------------

• The showvv command has new properties that provide statistics on the growth and reclamationof usr, snp, and adm space within a volume. These propert

showvvcpgDESCRIPTIONThe showvvcpg command displays the Virtual Volume (VV) space distribution among CPGs.SYNTAXshowvvcpg [options] [<vvname|pattern

The target name associated with this group, as set with the creatercopygroup command. Thetarget is created with the creatercopytarget command. <sec

The following example shows VV space distribution for VVs belonging to VV sets with names thatbegin with tv:cli% showvvcpg set:tv* ----(

showvvmapDESCRIPTIONThe showvvmap command displays information about how Virtual Volume (VV) regions are mappedto logical disks.SYNTAXshowvvmap <VV

NOTESNone.522 Show Commands

showvvpdDESCRIPTIONThe showvvpd command displays Virtual Volume (VV) distribution across Physical Disks (PDs) .SYNTAXshowvvpd [option <arg>] {&l

11 0:2:3 0 0 0 012 0:3:0 0 0 0 013 0:3:1 0 0 0 014 0:3:2 0 0 0 015 0:3:3 0 0 0 016 1:0:0 0

17 1:0:1 0 0 4 418 1:0:2 0 0 4 419 1:0:3 0 0 4 420 1:1:0 0 0 4 421 1:1:1 0 0 4 422 1:1:2 0

42 2:2:2 1 1 0 244 2:3:0 1 1 0 245 2:3:1 1 1 0 246 2:3:2 0 1 1 2 1 0:0:1 0 1 0 1 2 0:0:2 0

showvvsetDESCRIPTIONThe showvvset command lists the Virtual Volume (VV) sets defined on the HP 3PAR storage systemand their members.SYNTAXshowvvset [o

Show the sia-1 set only, with detail:cli% showvvset -d sia-120 sia-1 test This set has a comment ttpvv.rw test-sv barShow

showwsapiDESCRIPTIONThe showwsapi command displays the WSAPI server service configuration state as either Enabledor Disabled. It displays the server c

In the following example, the admitrcopyvv command adds all the volumes that start with thename testvv to the primary volume group Group1. At the same

24 Shutdown CommandsshutdownnodeDESCRIPTIONThe shutdownnode command shuts down a system node.SYNTAXshutdownnode halt|reboot|wipeid <node_ID>AUTH

3 sunx4150-04 Generic-legacy 2101001B32341C95 0:5:1 n/a 4 sunx4150-05 Generic-legacy 2101001B32342495 0:5:1 n/a 5 sunx4150-06 Ge

◦ One or more admin logical disks cannot be reset, resulting in the kernel being unable toaccess meta data from those LDs.◦ One or more data (user or

shutdownsysDESCRIPTIONThe shutdownsys command shuts down an entire system.SYNTAXshutdownsys halt|rebootAUTHORITY• Super, Service• Any role granted the

7 sunx4150-08 Generic-legacy 2101001B323BC44C 6:5:1 n/a8 sunx4150-09 Generic-legacy 2101001B323BFF4C 6:5:1 n/a9 sunx4150-10 Generic-legacy 2101001B

25 System Reporter (SR) commandssraomovesDESCRIPTIONThe sraomoves command shows the space that Adaptive Optimization (AO) has moved betweentiers.SYNTA

RESTRICTIONSNoneEXAMPLESThe following example shows space moved by AO beginning 2 hours (7200 seconds) ago:cli% sraomoves -btsecs -7200NOTESFor this c

srcpgspaceDESCRIPTIONThe srcpgspace command displays historical space data reports for common provisioning groups(CPGs).SYNTAXsrcpgspace [options] [&l

If it is not specified then the report ends with the most recent sample.-hiresSelect high resolution samples (5 minute intervals) for the report. This

srhistldDESCRIPTIONThe srhistld command displays historical histogram performance data reports for logical disks.SYNTAXsrhistld [options] [<LD_name

admitvvDESCRIPTIONThe admitvv command creates and admits remotely exported virtual volume definitions to enablethe migration of these volumes. The new

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

RESTRICTIONSEXAMPLESThe following example displays aggregate hourly histogram performance statistics for all logicaldisks beginning 24 hours ago:cli%

srhistpdDESCRIPTIONThe srhistpd command displays historical histogram data reports for physical disks.SYNTAXsrhistpd [options] [<PDID|pattern>..

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

Limit the data to disks of the types specified.• FC – Fibre Channel• NL – Nearline• SSD – Solid State DriveSPECIFIERS[<PDID>...|<pattern>.

srhistportDESCRIPTIONThe srhistport command displays historical histogram performance data reports for ports.SYNTAXsrhistport [options]AUTHORITYAny ro

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

EXAMPLESThe following example displays aggregate hourly histogram performance statistics for all portsbeginning 24 hours ago:cli% srhistport -hourly -

srhistvlunDESCRIPTIONThe srhistvlun command displays historical histogram performance data reports for VLUNs.SYNTAXsrhistvlun [options]AUTHORITYAny ro

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

5 Cancel CommandcanceltaskDESCRIPTIONThe canceltask command cancels one or more tasks.SYNTAXcanceltask [option] {all|<task_ID>...}AUTHORITY• Ser

• 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 f

srldspaceDESCRIPTIONThe srldspace command displays historical space data reports for logical disks (LDs).SYNTAXsrldspace [options] [<LD_name>|&l

If it is not specified then the report ends with the most recent sample.-hiresSelect high resolution samples (5 minute intervals) for the report. This

EXAMPLESThe following example displays aggregate hourly LD space information for all RAID 5 LDs withnames that match either "fc*" or "s

srpdspaceDESCRIPTIONThe srpdspace command displays historical space data reports for physical disks (PDs).SYNTAXsrpdspace [options] [<PDID|pattern&

If it is not specified then the report ends with the most recent sample.-hiresSelect high resolution samples (5 minute intervals) for the report. This

srrgiodensityDESCRIPTIONThe srrgiodensity command shows the distribution of IOP/s intensity for Logical Disk (LD)regions for a common provisioning gro

Select the step between histogram columns of the report. By default each column's IO density is 4times the previous column, but a step of 2 or 8

srstatcmpDESCRIPTIONThe srstatcmp command displays historical performance data reports for cache memory.SYNTAXsrstatcmp [options] [<node>...]AUT

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

6 Change CommandchangedomainDESCRIPTIONThe changedomain command changes the currentdomain CLI environment parameter.SYNTAXchangedomain [<domain>

srstatcpuDESCRIPTIONThe srstatcpu command displays historical performance data reports for CPUs.SYNTAXsrstatcpu [options] [<node>...]AUTHORITYAn

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

srstatldDESCRIPTIONThe srstatld command displays historical performance data reports for logical disks.SYNTAXsrstatld [options] [<LD_name>|<p

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

srstalinkDESCRIPTIONThe srstatlink command displays historical performance data reports for links (internode, PCI andcache memory).SYNTAXThe syntax fo

If it is not specified then the report ends with the most recent sample.-hiresSelect high resolution samples (5 minute intervals) for the report. This

srstatpdDESCRIPTIONThe srstatpd command displays historical performance data reports for physical disks.SYNTAXsrstatpd [options] [<PDID|pattern>

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

srstatportDESCRIPTIONThe srstatport command displays historical performance data reports for ports.SYNTAXsrstatport [options]AUTHORITYAny role in the

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

7 Check CommandscheckhealthDESCRIPTIONThe checkhealth command checks the status of system hardware and software components,and reports any issues.NOTE

srstatqosDESCRIPTIONThe srstatqos command displays historical performance data reports for QoS rules.SYNTAXsrstatqos [options]AUTHORITYAny role in the

Select high resolution samples (5 minute intervals) for the report. This is the default.-hourlySelect hourly samples for the report.-dailySelect daily

srstatvlunDESCRIPTIONThe srstatvlun command displays historical performance data reports for VLUNs.SYNTAXsrstatvlun [options]AUTHORITYAny role in the

Select high resolution samples (5 minute intervals) for the report. This is the default setting.-hourlySelect hourly samples for the report.-dailySele

srvvspaceDESCRIPTIONThe srvvspace command displays historical space data reports for virtual volumes (VVs).SYNTAXsrvvspace [options] [<VV_name|<

If it is not specified then the report ends with the most recent sample.-hiresSelect high resolution samples (5 minute intervals) for the report. This

The following example displays VV space information for the most recent daily sample aggregatedby the VV name for VVs with names that match the patter

26 Start CommandsstartaoDESCRIPTIONThe startao command starts execution of an Adaptive Optimization (AO) configuration usingdata region level performa

Select the approximate maximum run time in hours (default is 6 hours). The number should bebetween 1 and 24 hours. The command will attempt to limit t

startcimDESCRIPTIONThe startcim command starts the CIM server to service CIM requests. By default, the CIM serveris not started until this command is

Checking rcChecking snmpChecking taskChecking vlunChecking vvComponent ------------Description------------ QtyAlert New alerts

startldDESCRIPTIONThe startld command starts data services on a Logical Disk (LD) that has not yet been started.SYNTAXstartld [option] <LD_name>

startnoderescueDESCRIPTIONThe startnoderescue command initiates a node rescue, which initializes the internal node diskof the specified node to match

startrcopyDESCRIPTIONThe startrcopy command enables Remote Copy.SYNTAXstartrcopyAUTHORITY• Super, Edit• Any role granted the rcopy_start right.NOTE: Y

startrcopygroupDESCRIPTIONThe startrcopygroup command enables Remote Copy for the specified Remote Copy volumegroup.SYNTAXstartrcopygroup [options] &l

To start Group2, which contains 4 virtual volumes, and specify starting snapshots, with vv4 startingfrom a full resync:# startrcopygroup Group2 vv1:sv

starttaskDESCRIPTIONThe starttask command provides users with the ability to execute commands with long runningtimes. The commands run in the backgrou

startvvDESCRIPTIONThe startvv command starts data services on a Virtual Volume (VV) that has not yet been started.SYNTAXstartvv [option] <VV_name&g

startwsapiDESCRIPTIONThe startwsapi command starts the Web Services API server to service HTTP and HTTPS requests.By default, the Web Services API ser

27 Stat CommandsstatchDESCRIPTIONThe statch command displays chunklet statistics in a timed loop.SYNTAXstatch [options <arg>]AUTHORITYAny role i

Specifies that statistics that fall below the threshold as specified by the <fspec> arguments, where<fspec> is <type>, <op>, &

checkldDESCRIPTIONThe checkld command executes consistency checks of data on logical disks in the event of anuncontrolled system shutdown and optional

Specifies that statistics for only non-idle devices are displayed. This option is shorthand for theoption –filt curs,t,iops,0.–ld <LD_name>|–ch

• Qlen. The queue length.• Util % Cur. The percentage of current use.• Util % Avg. The percentage of average use.NOTES• For this command: KB = 1000 by

statcmpDESCRIPTIONThe statcmp command displays Cache Memory Page (CMP) statistics by node or by VirtualVolume (VV).SYNTAXstatcmp [options <arg>]

0 473405 11790 0 0 0 0 0 0 1 483013 2158 0 0 0 0 0 0 Temporary

statcpuDESCRIPTIONThe statcpu command displays CPU statistics for all nodes.SYNTAXstatcpu [options <arg>]AUTHORITYAny role in the system.OPTIONS

NOTESNone.statcpu 595

statfcoeDESCRIPTIONThe statfcoe command displays statistics for Fibre Channel over Ethernet connections.SYNTAXstatfcoe [options <arg>]AUTHORITYA

EXAMPLESThe following example displays one iteration of FCoE counts:cli% statfcoe -iter 1 -counts -begin NOTESNone.statfcoe 597

statiscsiDESCRIPTIONThe statiscsi command displays the iSCSI statistics.SYNTAXstatiscsi [options <arg>]AUTHORITYAny role in the system.OPTIONS-d

-beginShows the values from when the system was last initiated.SPECIFIERSNone.RESTRICTIONSNone.EXAMPLESThe following example displays basic iSCSI stat

histld...183histpd...

The following example attempts to recover chunklet 1032:10 of logical disk vv.adm.0, and therewill be output about the progress:cli% checkld -y -p -re

statiscsisessionDESCRIPTIONThe statiscsisession command displays the iSCSI session statistics.SYNTAXstatiscsisession [options <arg>]AUTHORITYAny

Rx Total Digest TimeOut1: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------------------

statldDESCRIPTIONThe statld command displays read/write (I/O) statistics about Logical Disks (LDs) in a timedloop.SYNTAXstatld [options <arg>] [

Specifies that statistics that fall below the threshold as specified by the <fspec> arguments where<fspec> is <type>, <op>, &l

Specifies that statistics for only non-idle devices are displayed. This option is shorthand for theoption –filt curs,t,iops,0.SPECIFIERS<LD_name|pa

NOTES• For this command: KB = 1000 bytes.• If no option is specified, the command defaults to display statistics totals.• If the <LD_name> or &l

statlinkDESCRIPTIONThe statlink command displays statistics for link utilization for all nodes in a timed loop.SYNTAXstatlink [options <arg>]AUT

statpdDESCRIPTIONThe statpd command displays the read/write (I/O) statistics for physical disks in a timed loop.SYNTAXstatpd [options]AUTHORITYAny rol

–sortcol <col> [,<dir>][:<col>[,<dir>]...]Sorts command output based on the column number (<col>). Columns are numbered

◦ svctSpecifies that statistics for service time in milliseconds are displayed.◦ sizeSpecifies that statistics for I/O operations in bytes are display

checkpasswordDESCRIPTIONThe checkpassword command prompts for the <user>'s password and then displays the stepsthe system uses to authentic

range of disk positions is separated with a hyphen (0–3). The specified position(s) must containdisks.–dk <item>Specifies one or more physical d

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

statportDESCRIPTIONThe statport command displays read/write (I/O) statistics for ports.SYNTAXstatport [options]AUTHORITYAny role in the system.OPTIONS

Specifies that I/O averages are computed from the system start time. If not specified, the averageis computed since the first iteration of the command

• <meas>The meas argument can be specified with one of the following arguments:◦ iopsSpecifies that I/O operations per second are displayed. If

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

statqosDESCRIPTIONThe statqos command displays the run-time stats of active QoS rules.SYNTAXThe syntax for the showqos command can be one of the follo

Specifies that statistics that fall below the threshold as specified by the <fspec> arguments, where<fspec> is <type>, <op>, &

A Domain column may be included by using the setclienv command to set listdom to 1. Thelistdom option is also set to 1 if the CLI was started with the

statrcopyDESCRIPTIONThe statrcopy command displays statistics for Remote Copy volume groups..SYNTAXstatrcopy [options <arg>]AUTHORITYAny role in

setauthparam command has been used to change parameters or data in the LDAP serverhas changed since the user last logged in.• The showuserconn command

Receive 1806402.23 50.69 50.69Send 172955055.10 47838.51 47838.51

statrcvvDESCRIPTIONThe statrcvv command displays statistics for Remote Copy volumes in a timed loop.SYNTAXstatrcvv [options <arg>] [<VV_name&

Specifies that the sums for all volumes of a domain are displayed.-domain <domainname>...|<pattern>...Show only the virtual volumes that a

Specifies that statistics for only non-idle devices are displayed. This option is shorthand for theoption -filt curs,t,iops,0.SPECIFIERS<VV_name|pa

The columns in this example provide the following information:• VVname. The name of the virtual volume being copied.• RCGroup. Remote Copy group conta

statvlunDESCRIPTIONThe statvlun command displays statistics for Virtual Volumes (VVs) and Logical Unit Number(LUN) host attachments.SYNTAXstatvlun [op

Specifies that sums for VLUNs are grouped by domain in the display. All VLUNs to unnamed hostsare added and displayed as a single set of data with a &

Specifies that statistics that fall below the threshold as specified by the <fspec> arguments where<fspec> is <type>, <op>, &l

Specifies that statistics for only nonidle devices are displayed. This option is shorthand for theoption –filt curs,t,iops,0.SPECIFIERSNone.RESTRICTIO

statvvDESCRIPTIONThe statvv command displays statistics for Virtual Volumes (VVs) in a timed loop.SYNTAXstatvv [options <arg>] [<VV_name_or_p

checkpdDESCRIPTIONThe checkpd command executes surface scans or diagnostics on physical disks.SYNTAXcheckpd scrub|diag [options <arg>] <pd_ID

Specifies that statistics that fall below the threshold as specified by the <fspec> arguments where<fspec> is <type>, <op>, &l

Specifies that statistics for only nonidle devices are displayed. This option is shorthand for theoption –filt curs,t,iops,0.SPECIFIERS<VV_name|pat

cause the read data to appear more than seen by the hosts. Use the histvlun -vvsumcommand to see data for only accesses from the host.• For this comma

28 Stop CommandsstopcimDESCRIPTIONThe stopcim command stops the CIM server from servicing CIM requests.WARNING! The stopcim command must be issued to

stoprcopyDESCRIPTIONThe stoprcopy command disables the Remote Copy functionality for any started Remote Copyvolume groups.SYNTAXstoprcopy [options]AUT

interactively typing, y. Refer to the HP 3PAR Command Line Interface Administrator’s Manualfor information about using environment variables.stoprcopy

stoprcopygroupDESCRIPTIONThe stoprcopygroup command stops the Remote Copy functionality for the specified RemoteCopy volume group.SYNTAXstoprcopygroup

The following example stops Remote Copy Groups that start with the name testgroup:# stoprcopygroup -pat testgroup*NOTES• If a group’s target has the m

stopwsapiDESCRIPTIONThe stopwsapi command stops the Web Services API server from servicing HTTP and HTTPSrequests.SYNTAXstopwsapi [options]AUTHORITYSu

29 Sync Command639

Performs read, write, or verifies test diagnostics.<pd_ID>...The ID of the physical disk to be checked. Only one pd_ID can be specified for the

syncrcopyDESCRIPTIONThe syncrcopy command manually synchronizes Remote Copy volume groups.SYNTAXsyncrcopy [options <arg>] <group_name>|<

EXAMPLESThe following example specifies that Remote Copy volume group Group1 should be synchronizedwith it’s corresponding secondary volume group:# sy

30 Tune CommandstunealdvvDESCRIPTIONThis command is only used for non-provisioned virtual volumes. Please use the tunevv commandto create a virtual vo

Use the options defined in template <template_name>. The template is created using thecreatetemplate command. Options specified in the template

–cg <item>Specifies one or more drive cages. Drive cages are identified by one or more integers (<item>).Multiple drive cages are separate

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

The following example shows how to use the tunealdvv command to change the availabilitylevel of a virtual volume (testvol) to cage. Note that because

tunepdDESCRIPTIONThe tunepd command identifies physical disks with high service times and optionally executesload balancing.SYNTAXThe syntax for the t

Specifies the interval, in minutes, that the command enters standby mode between iterations usingan integer greater than 0. If this option is not spec

• If one or more chunklet statistics collection processes are running, the tunepd command exitsto prevent possible tunepd –chstat on processes running

checkportDESCRIPTIONThe checkport command performs a loopback test on Fibre Channel ports.SYNTAXcheckport [options <arg>] <N:S:P>AUTHORITY

Physical Disk 29: The following chunklets have been marked for moving: 26Pass 1: Dryrun moving chunklets:Move Status

tunesysDESCRIPTIONThe tunesys command is used to analyze and detect poor layout and disk utilization across anentire HP 3PAR storage system array. Thi

Wait for all tasks created by this command to complete before returning.-fDo not ask for confirmation.SPECIFIERSNone.RESTRICTIONSNone• This command re

complete that phase. For example, a showtask step and phase display of 1/3 4/39 indicatesthat tunesys is in phase 1 of 3 (inter-node), tune 4 of 39.•

tunetpvvDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease. Please use the tunevv command i

Specifies an existing VV name.RESTRICTIONS• This command requires an HP 3PAR Dynamic Optimization license. Contact your local HP3PAR representative fo

tunevvDESCRIPTIONThe tunevv command is used to change the properties of a virtual volume that was created witheither the createvv or createtpvv comman

The following options can be used when the <usr_cpg> subcommand is specified:-tpvvIndicates that the virtual volume should be converted to a Thi

31 Update CommandsupdatesnapspaceDESCRIPTIONThe updatesnapspace command starts a non-cancelable task to update the snapshot spaceusage accounting. The

The following example displays the task information using –d <task_id>:cli% showtask –d 2Id Type Name Status Phase Step

NOTES• When both the -time and -iter options are specified, the first limit reached terminates theprogram. If neither are specified, the default is 1,

updatevvDESCRIPTIONThe updatevv command updates a snapshot Virtual Volume (VV) with a new snapshot.SYNTAXupdatevv [options] <VV_name | VV_set>..

NOTES• The updatevv command attempts to use the same VV IDs for new snapshots as the snapshotsthat they replace so that the new VV have the same World

32 Upgrade CommandsupgradecageDESCRIPTIONThe upgradecage command downloads new firmware into the specified cage.SYNTAXThe syntax for the upgradecage c

RESTRICTIONSAccess to all domains is required to run this command.EXAMPLESThe following example displays a cage with firmware level of 4.41 upgrading

upgradepdDESCRIPTIONThe upgradepd command upgrades the Physical Disk (PD) firmware.SYNTAXupgradepd [-f] [-skiptest] {-a | -w <WWN>... | <PD_I

33 Wait CommandwaittaskDESCRIPTIONThe waittask command asks the CLI to wait for a task to complete before proceeding. Thecommand automatically notifie

34 Support and Other ResourcesContacting HPFor worldwide technical support information, see the HP support website:http://www.hp.com/supportBefore con

See:For information about:HP 3PAR-to-3PAR Storage Peer Motion GuideMigrating data from one HP 3PAR storage system to anotherHP 3PAR Secure Service Cus

See:For information about:Planning for HP 3PAR storage system setupHardware specifications, installation considerations, power requirements, networkin

Typographic conventionsTable 8 Document conventionsElementConventionBold text• Keys that you press• Text you typed into a GUI element, such as a text

checkrclinkDESCRIPTIONThe checkrclink command performs a connectivity, latency, and throughput test between twoconnected HP 3PAR storage systems.SYNTA

35 Documentation feedbackHP is committed to providing documentation that meets your needs. To help us improve thedocumentation, send any errors, sugge

IndexSymbols(brackets) optional elements, 11(ellipsis), multiuse option specifier, 11(parentheses), grouped elements, 11Aaccessuser information about,

createsv to, 137createtemplate, 139createtpvv, 145createuser, 149createvlun, 151createvv, 154createvvcopy, 158createvvset, 162creating domains, 115cre

system configuration, displaying, 386VLUN template conflicts and, 122II/O statisticslogical disks, 602physical disks, 607ports, 612virtual volumes, 62

group, 240link, 165target designation, 242virtual volume from group, 168removealert, 228removeaocfg, 230removecpg, 231removedomain, 233removedomainset

showrctransport, 464showrsv, 469showsched, 471showsnmpmgr, 473showsnmppw, 474showspace, 476showspare, 479showsys, 481showsysmgr, 486showtarget, 488sho

Thinly Provisioned Virtual Volume (TPVV), length limit, 12time and datefor system nodes, 373setting nodes, 291trapsremoving preregistered SNMP softwar

Specifies the port on which to run the test. If this specifier is not used, the test automatically runson port 3492.RESTRICTIONSThe Remote Copy ports

c. (Optional) To end the test before it completes, on SystemA enter:# checkrclink stopclientd. After the test is complete, on SystemB enter:# checkrcl

22 Set Commands...271setalert...

checksnmpDESCRIPTIONThe checksnmp command allows a user to send an SNMPv2 test trap to the list of managers asspecified in showsnmpmgr.SYNTAXchecksnmp

checkvvDESCRIPTIONThe checkvv command executes validity checks of virtual volume administration information inthe event of an uncontrolled system shut

8 CLI CommandcliDESCRIPTIONThe cli command provides a means to set up your CLI session or to enter directly into a CLI shell.SYNTAXcli [options] [<

–nohdtotDoes not print header and totals.–csvtablePrints table data as Comma Separated Values (CSV).–listdom <domain_name>Indicates the domain a

NOTES• If the cli command is issued without any arguments, you are placed in a CLI shell. Aftercommands are issued, the CLI exits unless the –cmdloop

9 Compact CommandscompactcpgDESCRIPTIONThe compactcpg command consolidates logical disk space in Common Provisioning Groups(CPGs) into as few logical

EXAMPLESThe following example shows how to compact a single CPG named testcpg and remove anyunused logical disks after consolidating the space:cli% co

compactldDESCRIPTIONThe compactld command consolidates space on the logical disks.SYNTAXcompactld [options <arg>] <LD_name>...|<pattern

EXAMPLESIn the following example, logical disk pdsld0.0 is compacted:cli% compactld -f pdsld0.0Compacting LDs: pdsld0.0NOTESNone.78 Compact Comman

10 Control CommandscontrolencryptionDESCRIPTIONThe controlencryption provides various commands to control data encryption.SYNTAXThe syntax for the con

showfirmwaredb...384showhost...

EXAMPLESThe following example backs up the keystore to file backup1:cli% controlencryption backup backup1The following example restores the keystore f

controliscsiportDESCRIPTIONThe controliscsiport command is used to set properties of an iSCSI port.SYNTAXThe syntax for the controliscsiport command c

SPECIFIERS<IP_address>Indicates the IP address of the iSCSI target.<netmask>Indicates the IP netmask of the iSCSI target.<gw_address>

controlmagDESCRIPTIONThe controlmag command takes drive magazines, or disk drives within a magazine, either onloop or off loop. Use this command when

EXAMPLESThe following example requests that drive magazine 1 in drive cage cage0 be put on loop:cli% controlmag onloop cage0 1NOTESTaking a drive maga

controlpdDESCRIPTIONThe controlpd command spins a physical disk up or down. This command is used when replacinga physical disk in a drive magazine.CAU

NOTESIssuing the controlpd command puts the specified disk drive in a not ready state. Furthermore,if this command is issued with the spindown subcomm

controlportDESCRIPTIONThe controlport command controls all aspects of a Fibre Channel or Remote Copy port, includingthe port’s connection type and dat

SUBCOMMANDSconfigSets the specified connection mode and type on FC ports. Also allows setting the unique nodeWWN option for the port. When unique_nwwn

is issued from the port whenever a VLUN is created or removed. See “SPECIFIERS” for additionalinformation on parameters required to issue this subcomm

shutdownsys...53325 System Repor

This option can only be used with the rst subcommand. Resets the mode of the port. The port canbe reset into a target or initiator mode. If not specif

–s <size>Specifies the packet size. If no size is specified, the option defaults to 64. This option and argumentcan only be used with the rcip p

portSpecifies the Fibre Channel port number of the PCI card in the specified PCI bus slot using 1 through4.<IP_address>Specifies the IP address

option is overridden (if specified), a warning is returned, and you are prompted for confirmationto complete the execution of the commands.• The contr

of the offline port causes the online partner port to undergo mode change as well. This resultsin loss of use of the partner port because it is no lon

11 Create CommandscreatealdDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease.The createald

Specifies the chunklet location preference characteristics, either first (attempt to use the lowestnumbered available chunklets) or last (attempt to u

–tc_lt <number>Specifies that PDs with total chunklets less than the number specified are selected.–fc_gt <number>Specifies that PDs with

Specifies that a new logical disk should be created, even if an existing LD could be grown (to beused in conjunction with the -cpsa and -cpsd options)

createaldvvDESCRIPTIONThis command was deprecated in the 2.2.3 release and will be changed or removed in a futurerelease. Please use the createvv comm