). Command Line Interface Reference ■ InForm OS Version 2.3.1 Detailed_State. Provides additional details of the move with General Information, Error Information, or Degraded Information. General Information: ◆ dest_unknown. Destination is unknown. ◆ dest_unknown. Destination is known. ◆ valid_move. Source and Destination are valid. ◆ ch_moved. Chunklet was moved. ◆ ch_move_pending. Chunklet move is pending due to -nowait option. ◆ move_error. Error moving chunklet. InForm OS Version 2.3.1 ◆ remote_pds_used. Connection Degraded. ◆ ldpattern_not_obeyed. LD pattern was not obeyed. ◆ raid_availability_reduced. RAID availability reduced. Command Line Interface Reference NOTES ■ Chunklets moved from physical disks fd are treated as if they originated on disk td. Disk td can be the same as disk fd. ■ Specifying the –dr option can be used to see if the specified moves succeeds and what the results (quality) of the moves are. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND movetodomain DESCRIPTION The movetodomain command moves Common Provisioning Groups (CPGs) from one domain to another. SYNTAX movetodomain [options] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –vv Specifies that the object is a virtual volume. -cpg Specifies that the object is a CPG. –host Specifies that the object is a host. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLE The following example displays the movement of VV vv1 to domain SampleDomain: cli% movetodomain -vv vv1 SampleDomain The following volumes will have their domain modified: vv1 The following hosts will have their domain modified: thehost The following CPGs will have their domain modified: SampleCPG 14 associated LDs will also have their domain changed. Command Line Interface Reference 17.20 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 18 Promote Commands In this chapter promotesv 18.2 promotevvcopy 18.4 Promote Commands 18. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. SYNTAX promotesv [options] AUTHORITY Super, Edit OPTIONS -target Copy the differences of the virtual copy to the specified RW parent in the same VV family tree. The default is to copy the differences to the base volume. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ The virtual copy and its base volume must not be exported. ■ Only one promote operation is allowed at a time within a VV family tree. EXAMPLES The following example promotes the differences from VV Dub and its base volume Dublin: cli% promotesv Dub NOTES ■ Issue the showvv command to verify that differences in the snapshot volume are promoted to its target volume. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND promotevvcopy DESCRIPTION The promotevvcopy command promotes a physical copy back to a regular base volume. SYNTAX promotevvcopy AUTHORITY Super, Edit OPTIONS None. SPECIFIERS Specifies the name of the physical copy to be promoted, using up to 31 characters. RESTRICTIONS The physical copy must have completed the copy from the base volume. InForm OS Version 2.3.1 Command Line Interface Reference 19 Remove Commands In this chapter removealert 19.3 removecpg 19.5 removedomain 19.7 removedomainset 19.8 removeeventlog 19.10 removehost 19.12 removehostset 19.14 removeld 19.16 removercopygroup 19.18 removercopytarget 19.20 removesched 19.22 removesnmpmgr 19.24 removesnmppw 19.26 removespare 19.28 removesshkey 19.30 Remove Commands 19. Command Line Interface Reference 19.2 InForm OS Version 2.3.1 removetask 19.31 removetemplate 19.33 removeuser 19.35 removeuserconn 19.37 removevlun 19.39 removevv 19.43 removevvset 19. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removealert DESCRIPTION The removealert command removes one or more alerts from the system. CAUTION: Use care when removing alerts. Alerts that have not been fixed or acknowledged should NOT be removed. SYNTAX removealert [option] –a|... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies all alerts from the system and prompts removal for each alert. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays all alerts from the system with the option to remove individual alerts: cli% removealert –a Id 120 – New Occurred 4 times, last at Tue May 03 22:45:47 PDT 2005 Message code: 196609 Tue May 03 22:23:17 PDT 2005 Node: 0 Severity: Minor Firmware coredump event Firmware COREDUMP: recovered file /var/core/hba/fwcore.n00.s02.p01.20050503.224547 Alert 120 is marked as "New". InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removecpg DESCRIPTION The removecpg command removes Common Provisioning Groups (CPGs) from the system or removes specific Logical Disks (LDs) from CPGs. AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. SYNTAX removecpg [options ] {|}... OPTIONS –f Specifies that the command is forced. Command Line Interface Reference InForm OS Version 2.3.1 –pat The specified patterns are treated as glob-style patterns and that all common provisioning groups matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified. This option must be used if the pattern specifier is used. SPECIFIERS Specifies the name of the CPG that is either being removed or losing LDs. Specifies a glob-style pattern. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removedomain DESCRIPTION The removedomain command removes an existing domain from the system. SYNTAX removedomain [option] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f When using this option, the command does not ask for confirmation before removing the domain. SPECIFIERS Specifies the domain that is removed. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removedomainset DESCRIPTION The removedomainset command removes a domain set or removes domains from an existing set. SYNTAX removedomainset [options] [...] AUTHORITY Super, Edit OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the domain set. ... InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removeeventlog DESCRIPTION The removeeventlog command removes all Debug events from the system event log. SYNTAX removeeventlog [option] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS None. InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ Without the -f flag, the command prompts for confirmation. ■ Verify the removal of event logs by issuing the showeventlog command. See showeventlog on page 22.41 for more information. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removehost DESCRIPTION The removehost command removes a system host or paths to a host. If one or more paths are specified, the command removes only those paths, otherwise the entire host definition is removed. SYNTAX removehost [options] [...|...] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference Specifies the host iSCSI name to be removed from the specified host. If no ISCSI name is specified, the entire host definition is removed. RESTRICTIONS ■ Access to all domains is required to run this command. ■ A host that has one or more VLUNs exported on it cannot be removed. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removehostset DESCRIPTION The removehostset command removes a host set or removes hosts from an existing set. SYNTAX removehostset [options] [...] AUTHORITY Super, Edit OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Name of the host set to remove. ... InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removeld DESCRIPTION The removeld command removes a specified Logical Disk (LD) from the system service group. SYNTAX removeld [options] {|}... AUTHORITY Super, Service, Edit OPTIONS –pat Specified patterns are treated as glob-style patterns and all LDs matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the LD name, using up to 31 characters. Multiple LDs can be specified. Specifies a glob-style pattern. Multiple LDs can be specified. If this specifier is not used, the specifier must be used. See Glob-Style Pattern on page 2.4 for more information. RESTRICTIONS ■ System resource LDs are required for correct operation of the InServ Storage Server. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removercopygroup DESCRIPTION The removercopygroup command removes a Remote Copy volume group. SYNTAX removercopygroup AUTHORITY Super, Edit OPTIONS None. SPECIFIERS The name of the group to be removed. RESTRICTIONS ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. InForm OS Version 2.3.1 ■ Command Line Interface Reference The removercopygroup command removes all the associations configured in the specified group and removes the group name and any Remote Copy synchronization snapshots affiliated with volumes in the group. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removercopytarget DESCRIPTION The removercopytarget command removes target designation from a Remote Copy system and removes all links affiliated with that target. SYNTAX removercopytarget [options] AUTHORITY Edit NOTE: You need access to all domains in order to run this command. OPTIONS -cleargroups Remove all groups that have no other targets or dismiss this target from groups with additional targets. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example removes target InServ1_in from a Remote Copy system: cli% removercopytarget InServ1_in NOTES None. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesched DESCRIPTION The removesched command removes a scheduled task from the system. SYNTAX removesched [options] AUTHORITY Super, Service OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all scheduled tasks matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES None. NOTES None. 19. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP managers from receiving alerts (traps). SYNTAX removesnmpmgr [option ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the manager receives traps. If not specified, the port number defaults to 162. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the removal of a manager with the IPv4 address 123.45.67.89 from the list of registered managers: cli% removesnmpmgr 123.45.67. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. SYNTAX removesnmppw [options] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Removes the read/write (–rw), read-only (–r), or write-only (–w) password. If not specified, the read/write community string password is removed. InForm OS Version 2.3.1 Command Line Interface Reference EXIT STATUS The following codes are returned indicating success or failure: ■ 0 indicates that the password was removed and the command was successful. ■ 1 indicates that the command failed. ■ 2 indicates that a password does not exist. NOTES ■ After a password has been removed, the system manager can no longer use that password to send requests to the SNMP agent. ■ Verify the removal of SNMP passwords by issuing the showsnmppw command. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removespare DESCRIPTION The removespare command removes chunklets from the spare chunklet list. SYNTAX removespare [options] ... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. InForm OS Version 2.3.1 Command Line Interface Reference a:a Removes all spare chunklets that are not currently used. –pos Specifies the position of a specific chunklet identified by its position in a drive cage, drive magazine, physical disk, and chunklet number. For example –pos 1:0.2:3:121, where 1 is the drive cage, 0.2 is the drive magazine, 3 is the physical disk, and 121 is the chunklet number. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesshkey DESCRIPTION The removesshkey command removes your Secure Shell (SSH) public key to disable key authentication. SYNTAX removesshkey [... ] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS ... Specifies the name of the user whose SSH key is removed. Multiple users can be specified. If not specified, the SSH key for the current user is removed. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removetask DESCRIPTION The removetask command removes information about one or more completed tasks and their details. SYNTAX The syntax of the removetask command can be one of the following: ■ removetask [options ] –a ■ removetask [options ] –t ■ removetask [options ] ... AUTHORITY Super, Edit OPTIONS –a Removes all tasks including details. –d Remove task details only. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None. EXAMPLES The following example shows how to remove a task based on the task ID. cli% removetask 2 Remove the following tasks? 2 select q=quit y=yes n=no: y The following example shows how to remove all tasks, including details. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removetemplate DESCRIPTION The removetemplate command removes one or more Virtual Volume (VV), Logical Disk (LD), and Common Provisioning Group (CPG) templates. SYNTAX removetemplate [options]{|}... AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the forced removal of template vv1: cli% removetemplate -f vv1 NOTES None. 19.34 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removeuser DESCRIPTION The removeuser command removes a user account from the system. SYNTAX removeuser [option] ... AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS ... Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ Verify the removal of users by issuing the showuser command. See showuser on page 22.188 for additional information. ■ The removeuser command does not affect currently connected users. If an attempt is made to remove a user that is currently connected, an error message will be returned. 19. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removeuserconn DESCRIPTION The removeuserconn command removes user connections to the current system. AUTHORITY Super NOTE: You need access to all domains in order to run this command. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the forced removal of user user1 at IP address 127.0.0.1: cli% removeuserconn –f 2315 user1 127.0.0.1 Removing user connection Id:2315 Name:user1 Addr:127.0.0. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removevlun DESCRIPTION The removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN) export definition from the system. Command Line Interface Reference InForm OS Version 2.3.1 –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. 19. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the volume or volume set name, using up to 31 characters in length. The volume set name must start with set:. Specifies the LUN ID to remove. Specifies that exports to the specified port are removed. If this specifier is not used, the host_name specifier must be used. node Specifies the system port where node is a number from 0 through 7. Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ If the VLUN to be removed is a matched-set, use the port and host_name specifiers. ■ Verify the removal of VLUNs by issuing the showvlun command. See showvlun on page 22.195 for more information. 19. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removevv DESCRIPTION The removevv command removes Virtual Volumes (VVs) from the system. SYNTAX The syntax of the removevv command can be as follows: ■ removevv [options] |... ■ removevv -expired [options] [VV_name>|...] AUTHORITY Super, Edit OPTIONS –pat Specifies that specified patterns are treated as glob-style patterns and that all VVs matching the specified pattern are removed. Command Line Interface Reference InForm OS Version 2.3.1 –cascade Remove all the descendent volumes as long as none has an active VLUN. It will remove any VLUN templates as long as there were no active VLUNs. It will remove the volumes from all the volume sets. If the -expired option is specified, all expired volumes and their descendent volumes will be removed regardless if they are expired or not. InForm OS Version 2.3.1 Command Line Interface Reference The following example removes the volumes that start with test and are snapshot: cli% removevv -f -snaponly -pat test* The following example removes vv1_snap if it is a snapshot and all its descendents: cli% removevv –f snaponly -cascade vv1_snap NOTES ■ By default, this command deletes any unused LDs that are not also part of a CPG. This is equivalent to using the –ld option. The –ld option still exists for backward compatibility. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removevvset DESCRIPTION The removevvset command removes a VV set or removes VVs from an existing set. SYNTAX removevvset [options] [...] AUTHORITY Super, Edit OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the VV set to remove. ... InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19. Command Line Interface Reference 19.48 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 20 Service Commands In this chapter servicecage 20.2 servicehost 20.5 servicemag 20.8 Service Commands 20. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND servicecage DESCRIPTION The servicecage command is necessary when executing removal and replacement actions for a drive cage FC-AL module. The startfc or unstartfc subcommands are used to initiate service on a cage, and the endfc subcommand is used to indicate that service is completed. InForm OS Version 2.3.1 Command Line Interface Reference resetfc ◆ For DC1 and DC3 drive cages, soft resets the FC-AL module. ◆ For DC2 and DC4 drive cages, resets the cage. FC-AL specifier is ignored. hresetfc ◆ For DC1 and DC3 drive cages, hard reset the FC-AL module. ◆ For DC2 and DC4 drive cages, hard reset the cage. FC-AL specifier is ignored. remove Removes the indicated drive cage (indicated with the specifier) from the system. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the commencement of Fibre Channel hot-plugging for drive cage cage0: cli% servicecage startfc –f -ovrd cage0 NOTES ■ Issuing the servicecage command results in chunklet relocation, causing a dip in throughput. ■ The unstartfc subcommand is provided if a mistake was made when issuing the servicecage command. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND servicehost DESCRIPTION The servicehost command executes removal and replacement actions for a host connecting to an InServ Storage Server port. SYNTAX The syntax for the servicehost command can be one of the following: ■ servicehost list ■ servicehost remove [-f] [ [... Command Line Interface Reference InForm OS Version 2.3.1 copy Copies all active VLUNs from the specified source port (as specified with ) from host WWNs or iSCSI names matching the specified pattern () to the destination port (as specified with ). If necessary, the port is reset to target mode. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. InForm OS Version 2.3.1 ■ Command Line Interface Reference If the specifier is not used with the remove subcommand, all inactive hosts in the system and their LUNs are removed. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND servicemag DESCRIPTION The servicemag command executes service on a drive magazine or disk. SYNTAX The syntax for the servicemag command can be one of the following: ■ servicemag start [options] ■ servicemag start [options] -pdid ... InForm OS Version 2.3.1 Command Line Interface Reference Relocation of chunklets is considered one step and can take from several minutes to several hours (depending on number of chunklets) to complete. If servicemag unmark is issued during the relocation phase, the spin-down phase will indicate that the servicemag start operation Failed. This can be confirmed by issuing servicemag status -d. Command Line Interface Reference InForm OS Version 2.3.1 –partial This option can only be used with the resume subcommand. Specifies that as many chunklets as possible are relocated. Error messages are printed for those chunklets that could not be relocated. -pdid ... Specifies one to four physical disks (by physical disk ID) that need to be serviced or replaced. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ Access to all domains is required to run this command. ■ Users with Browse level authority can only issue the servicemag status command. EXAMPLES The following example displays the suspension and resumption of data services on drive magazine 0 in drive cage 2: 20. Command Line Interface Reference cli% servicemag start –log –wait 2 0.0 Begin servicemag start –log 2 0.0... ... disks in mag : 2 0.0 ... valid disks: wwn [2000000087043098] id [20] diskpos [0] .................... wwn [2000000087008150] id [21] diskpos [1] .................... wwn [20000000870042F6] id [22] diskpos [2] .................... wwn [2000000087007E6D] id [23] diskpos [3] ... not valid disks: ... mark disk wwn [2000000087043098] id [20] as non usable for ld allocation ... InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ Issuing the servicemag command results in chunklet relocation that causes a dip in throughput. ■ When a servicemag command is issued with the –log option, all chunklets on the disks in the drive magazine being serviced are marked as normal,smag. This state indicates an active servicemag operation on the disks. ◆ Any I/O on the chunklets marked normal,smag, changes the states to logging and I/O is written to the logging logical disks. Command Line Interface Reference 20.14 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 21 Set Commands In this chapter setalert 21.3 setauthparam 21.5 setbattery 21.12 setcage 21.14 setcim 21.16 setclienv 21.18 setcpg 21.20 setdate 21.27 setdomain 21.31 setdomainset 21.33 sethost 21.35 sethostset 21.39 setlicense 21.40 setnet 21.42 setnode 21.47 Set Commands 21. Command Line Interface Reference 21.2 InForm OS Version 2.3.1 setntp 21.49 setpassword 21.51 setpd 21.53 setrcopygroup 21.55 setrcopytarget 21.62 setsched 21.66 setsnmppw 21.68 setsshkey 21.70 setstatch 21.72 setstatpdch 21.74 setsys 21.75 setsysmgr 21.79 settemplate 21.82 setuser 21.84 setuseracl 21.86 setvv 21.88 setvvset 21. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setalert DESCRIPTION The setalert command sets the status of system alerts. SYNTAX setalert new|ack|fixed {...|–a} AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies that the status of all alerts be set to new, acknowledged (ack), or fixed. If not specified, the specifier must be specified on the command line. SPECIFIERS ... Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example sets the status of all system alerts as new: cli% setalert –a new NOTES Verify the status of alerts by issuing the showalert command. See showalert on page 22.4 for additional information. 21. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setauthparam DESCRIPTION The setauthparam command is used to set the authentication and authorization parameters. SYNTAX The syntax of the setauthparam command can be one of the following: setauthparam [-f] setauthparam [-f] ... setauthparam [-f] -clear ... setauthparam [-f] -clearall AUTHORITY Super OPTIONS -f Does not ask for a confirmation before performing the operation. Command Line Interface Reference InForm OS Version 2.3.1 Table 21-1. Values for Specifiers and ldap-server Numeric IP address of the LDAP server. ldap-server-hn Indicates the host name of the LDAP server. This value must be set when the ldap-reqcert option is set or the sasl-mechanism option is set to GSSAPI. InForm OS Version 2.3.1 Command Line Interface Reference Table 21-1. Values for Specifiers and (continued) user-dn-base When using simple binding, the authentication process attempts to bind the user to an entry in the server's Directory Information Tree (DIT). The Distinguished Name (DN) of the entry is a concatenation of the value of user-attr, "=", the username, ",", and the value of user-dn-base. Command Line Interface Reference InForm OS Version 2.3.1 Table 21-1. Values for Specifiers and (continued) member-attr The attribute that holds the names of users in the group. accounts-dn Indicates the base of the subtree in the DIT in which to search for objects that hold account information. It is mutually exclusively with groups-dn variable. account-obj The objectClass attribute of an account object. InForm OS Version 2.3.1 Command Line Interface Reference Table 21-1. Values for Specifiers and (continued) domain-name-attr When set, the mapping of groups to domains is enabled. For a user that is a member of a group that maps to a privilege level, the value of domain-name-attr is used to look up an attribute in the group that holds the name of the domain. Command Line Interface Reference InForm OS Version 2.3.1 : Table 21-2. Examples of Domain Name Prefix Effects candidate domain-name-prefix result dom1 ISDom= dom1 ISDom=dom2 ISDom= dom2 ISDom=dom3 !ISDom= dom3 dom4 !ISDom= In the last case there is no resulting domain name because ISDom= does not appear in the candidate. Table 21-3. InForm OS Version 2.3.1 ■ Command Line Interface Reference The matching of a user's groups with the mapping rules is done in the order of the mapping parameters provided previously. When there are multiple matches, the first match determines the user's privilege level. ■ Domain names found with the use of domain-name-attr and domain-name-prefix are only potential domains and a user will only have privileges in those if they are actually existing domains. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setbattery DESCRIPTION The setbattery command sets battery information such as the battery’s expiration date, its recharging time, and its serial number. This information gives the system administrator a record or log of the battery age and battery charge status. SYNTAX setbattery [options ] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference Specifies the power supply number on the node using either 0 (left side from the rear of the node) or 1 (right side from the rear of the node). Specifies the battery number on the power supply where 0 is the first battery. NOTE: The and specifiers can be obtained from the output of the showbattery command. RESTRICTIONS Access to all domains is required to run this command. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcage DESCRIPTION The setcage command enables service personnel to set or modify parameters for a drive cage. SYNTAX setcage [subcommand ]... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example demonstrates how to assign cage1 a position description of Side Left: cli% setcage position Cabinet 0 Bay 5 Side Left cage1 The following example demonstrates how to assign model names to the power supplies in cage1. In this example, cage1 has two power supplies (0 and 1). Both power supplies are assigned model name Magnetek. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcim DESCRIPTION The setcim command sets the properties of the CIM server, including options to enable or disable the HTTP and HTTPS ports for the CIM server. The command also provides the ability to configure the port numbers associated with these two protocols. In addition, it allows users to enable or disable the SLP port. InForm OS Version 2.3.1 Command Line Interface Reference -httpsport Sets the HTTPS port (49152 - 65535). The default value is 5989. SPECIFIERS None. RESTRICTIONS ■ Access to all domains is required to run this command. ■ You cannot disable both of the HTTP and HTTPS ports. ■ You cannot set the same port number for both of the HTTP and HTTPS ports. EXAMPLES To disable the HTTPS ports: cli% setcim -https disable Warning: The CIM server is active and will restart. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setclienv DESCRIPTION The setclienv command sets the CLI environment parameters. SYNTAX setclienv AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS The specifiers include the parameters and values to which the parameters should be set. InForm OS Version 2.3.1 hafter Command Line Interface Reference - Specifies the number of lines of data to display before an output header is displayed. If is 10 or more, print the header after every of data. If is less than 10, print only the header at the beginning. editor NOTE: This parameter is only supported when connected via SSH. Specifies the command line editing mode. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcpg DESCRIPTION The setcpg command modifies existing Common Provisioning Groups (CPG). SYNTAX setcpg [options ] AUTHORITY Super, Edit, Service NOTE: You need access to all domains in order to run this command. OPTIONS –sa ... Specifies additional Logical Disks (LDs) that have already been created to be used for snapshot administration space allocation. InForm OS Version 2.3.1 Command Line Interface Reference –sdgs [g|G|t|T] Specifies the growth increment, the amount of logical disk storage created, on each autogrow operation. The default growth increment is fixed at 32G, but the minimum growth increment varies according to the number of controller nodes in the system. If is non-zero it must be 8G or bigger. A size of 0 disables the auto-grow feature. Command Line Interface Reference InForm OS Version 2.3.1 NOTE: The following options, –t, –ssz, –rs, –ss, –ha, –ch, and –p are used to control auto logical disk creation. –t Specifies the RAID type of the logical disk: r0 for RAID-0, r1 for RAID-1, r5 for RAID-5, or r6 for RAID-6. If no RAID type is specified, the default is r1. –ssz Specifies the set size in terms of chunklets. InForm OS Version 2.3.1 Command Line Interface Reference –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all disks of device type specified at creation time. If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern. Command Line Interface Reference InForm OS Version 2.3.1 –mg - Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (1,2,3). A range of drive magazines is separated with a hyphen (0–3). The specified drive magazine(s) must contain disks.
InForm OS Version 2.3.1 Command Line Interface Reference –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command. –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for Nearline, or SSD for Solid State Drive) to be used. Device types can be displayed by issuing the showpd command. Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS Specifies the name of the CPG being modified. RESTRICTIONS ■ Access to all domains is required to run this command. ■ This command sets the parameters that will be used for future grows and it will OVERWRITE all previously set parameters. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdate DESCRIPTION The setdate command allows you to set the system time and date on all nodes. SYNTAX The syntax for the setdate command can be one of the following: ■ setdate [[]][<.ss>] ■ setdate –tzlist [group] ■ setdate –tz AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –tzlist [group] Displays a timezone within a group, if a group is specified. Command Line Interface Reference InForm OS Version 2.3.1 Specifies the century (CC) and cannot be used unless a year is specified (YY). This specifier is not required. Specifies a year (YY). This specifier is not required. <.ss> Specifies seconds (ss). This specifier is not required. Specifiers can only be used in combinations as listed in Restrictions in the section that follows. RESTRICTIONS ■ Access to all domains is required to run this command. InForm OS Version 2.3.1 Command Line Interface Reference The following example displays the timezones with the –tzlist option: cli% setdate –tzlist Africa America Antarctica Arctic Asia ... The following example narrows down the list to the required timezone of Etc: cli% setdate –tzlist Etc Etc/GMT Etc/GMT+0 Etc/GMT+1 ... The following example shows the timezone being set: cli% setdate –tz Etc/GMT Timezone set successfully. Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ Specifies must be provided in one of the combinations listed as follows when issuing the setdate command: ■ ◆ MMDDhhmm ◆ MMDDhhmmYY ◆ MMDDhhmmCCYY ◆ MMDDhhmm.ss ◆ MMDDhhmmYY.ss ◆ MMDDhhmmCCYY.ss Check node dates by issuing the showdate command. See showdate on page 22.33 for additional information. 21. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdomain DESCRIPTION The setdomain command sets the parameters and modifies the properties of a domain. SYNTAX setdomain [options ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS -name Changes the name of the domain. -comment Specifies comments or additional information for the domain. Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS Indicates the name of the domain. RESTRICTIONS You need access to all domains to run this command. EXAMPLE In the following example, the name of a domain named Domain1 is changed to DomainX: cli% setdomain -name DomainX Domain1 The following example displays the addition of a comment to the domain Engineering: cli% setdomain -comment “This is a comment for engineering. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdomainset DESCRIPTION The setdomainset command sets the parameters and modifies the properties of a domain set. SYNTAX setdomainset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. Unprintable characters are not allowed. -name Specifies a new name for the domain set. Command Line Interface Reference NOTES None. 21.34 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND sethost DESCRIPTION The sethost command sets properties on existing system hosts, including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. The command also provides the ability to configure or remove iSCSI CHAP authentication information. Command Line Interface Reference InForm OS Version 2.3.1 removechap Removes CHAP authentication information on one or more hosts. By default, this removes all CHAP information for all specified hosts. Using this subcommand with the –target option removes only target CHAP information. clearagent Clears any host agent data associated with the host. OPTIONS -loc Specifies the location of the host. -ip Specifies the IP address of the host. InForm OS Version 2.3.1 Command Line Interface Reference -chapname Used to specify the initiator or target CHAP name. If this option is not specified, then the initiator CHAP name defaults to the host name and the target CHAP name defaults to the 3PAR System name. -hex The CHAP secret is treated as a hex number. The following options are for use with the removechap subcommand: -target Removes only the target CHAP authentication. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND sethostset DESCRIPTION The sethostset command sets the parameters and modifies the properties of a host set. SYNTAX sethostset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies a comment relating to the set. -name Specifies a new name for the host set. SPECIFIERS Specifies the name of the host set to modify. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setlicense DESCRIPTION The setlicense command sets the license key information. SYNTAX setlicense [options ] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies the file from which the license key is read. –noconfirm Specifies that the system does not prompt for confirmation for the new license key. SPECIFIERS None. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the setting of a license key: cli% setlicense If this software is being provided to you for a limited evaluation period, then your license shall be governed by the terms of 3PAR's standard Master Purchase and License Agreement which can be found at http://www.3par. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setnet DESCRIPTION The setnet command sets the administration network interface configuration. AUTHORITY Service, Super NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference startgateway Specifies that the gateway be immediately set to the specified IP address if no gateway is currently defined, or switched to the specified IP address if currently defined, in both cases indicated with the ( specifier). finish Specifies that outstanding changes from the startaddr and startgateway subcommands be completed. abort Specifies that any attempt to configure a new IP address or gateway fails. Command Line Interface Reference InForm OS Version 2.3.1 OPTIONS –f Specifies that the operation is forced even if verification has not occurred. This option can only be used with the finish and cleargateway subcommands. SPECIFIERS Specifies an existing IP address that is to be changed. This specifier is used in conjunction with the and specifiers and can only be used with the startaddr subcommand. Specifies a new IP address to which the system is configured. InForm OS Version 2.3.1 Command Line Interface Reference Specifies the IP address of the node. This specifier can only be used with the failoverping subcommand. |none Specifies that during an IP failover, a ping either be sent to the specified IP address () or not sent at all (none). This specifier can only be used with the failoverping subcommand. [] Specifies the node, by ID, that has an active Ethernet interface. Command Line Interface Reference ■ InForm OS Version 2.3.1 To make it possible to change the network configuration without running the risk of losing contact with the system because of misconfiguration, the setnet command uses a two step process. When a new IP address is specified with the setnet startaddr command, the system is configured to listen as both the old and new IP addresses. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setnode DESCRIPTION The setnode command sets the properties of the node components such as the serial number of the power supply. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SYNTAX setnode ps [options] SUBCOMMAND ps Sets the power supply properties. OPTIONS -s Specifies the serial number up to eight characters in length. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setntp DESCRIPTION The setntp command sets the system Network Time Protocol (NTP) server. This command is deprecated and will be removed in a subsequent release. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SYNTAX setntp |none OPTIONS None. SPECIFIERS Specifies the IP address of the NTP server to which the InServ system synchronizes its internal clocks. Command Line Interface Reference NOTES None. 21.50 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setpassword DESCRIPTION The setpassword command allows a user with Super level privileges to change the password for any user and create a password file on a client. Edit-, browse-, or service-level users can use the setpassword command to change their own passwords or save their password files on a client. Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS None. RESTRICTIONS ■ Only a user with Super level privileges can set another user’s password. ■ Passwords can be no longer than eight non-null characters, and must be at least six nonnull characters long. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setpd DESCRIPTION The setpd command marks a Physical Disk (PD) as allocatable or non allocatable for Logical Disks (LDs). SYNTAX setpd ldalloc on|off ... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS ldalloc on|off Specifies that the PD, as indicated with the PD_ID specifier, is either allocatable (on) or nonallocatable for LDs (off). OPTIONS None. SPECIFIERS ... Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ This command can be used when the system has disks that are not to be used until a later time. ■ 21.54 Verify the status of PDs by issuing the showpd -s command. See showpd on page 22.91. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setrcopygroup DESCRIPTION The setrcopygroup command performs the following actions: ■ Sets the policy of the Remote Copy volume group for dealing with I/O failure and error handling. ■ Switches the direction of transfer between volume groups. ■ Sets a resynchronization period for volume groups in asynchronous periodic mode. ■ Sets the group’s mode. Command Line Interface Reference InForm OS Version 2.3.1 Specifies the operation of the group(s). Valid operations are: reverse Changes the natural and current direction of all specified groups. The operation is mirrored resulting in a direction change on both systems. This option is very flexible depending on the options that are provided, however it should not be used as a part of the normal disaster recovery process. InForm OS Version 2.3.1 Command Line Interface Reference –nosync Specifies that groups are not synchronized after role reversal is completed through the recover, restore and failover specifiers. -discard Specifies not to check a group's other targets to see if newer data should be pushed from them if the group has multiple targets. The use of this option can result in the loss of the most recent changes to the group's volumes and thus should be used carefully. Command Line Interface Reference InForm OS Version 2.3.1 Wait for all tasks created by this command to complete before returning. This option applies to the failover, recover, restore, and reverse subcommands. SPECIFIERS Specifies the policy to assign to the group. This specifier can only be used with the pol subcommand. InForm OS Version 2.3.1 Command Line Interface Reference NOTE: When issuing the setrcopygroup command, either the specifier or the specifier must be specified. 21. Command Line Interface Reference InForm OS Version 2.3.1 Specifies the name of the volume group whose policy is set, or whose target direction is switched. Specifies the target name for the target definition created with the creatercopytarget command. Specifies the mode, sync or periodic, to which the group is set. This specifier can only be used with the mode subcommand. InForm OS Version 2.3.1 Command Line Interface Reference The following example sets volume group Group1 to synchronize to its asynchronous periodic mode target InServ2 every 30 minutes: cli% setrcopygroup period 30m InServ2 Group1 NOTES ■ There is no default resynchronization period. For groups whose mode is asynchronous periodic, you must specify a resynchronization period using setrcopygroup period or resynchronizations does not automatically take place. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setrcopytarget DESCRIPTION The setrcopytarget command sets the name, policies, and throughput of a target definition. InForm OS Version 2.3.1 Command Line Interface Reference enable|disable Enables or disables the target. OPTIONS None. SPECIFIERS Specifies the target name for the target definition previously created with the creatercopytarget command. This specifier can only be used with the pol subcommand. Command Line Interface Reference InForm OS Version 2.3.1 The measured round-trip latency of the connection to the target, specified in milliseconds (ms). This specifier can only be used with the tunelinks subcommand. RESTRICTIONS ■ Access to all domains is required to run this command. ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. InForm OS Version 2.3.1 ■ Command Line Interface Reference Under normal operating conditions the mirror_config policy should never be changed to no_mirror_config. This policy option is included only as a method to correct several unusual error conditions that might occur in the course of operation which result in a mismatch in configuration between the two sides of a Remote Copy pair. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsched DESCRIPTION The setsched command allows users to suspend, pause, change the schedule, change the parameters, and change the name of currently scheduled tasks. SYNTAX setsched [options ] setsched [-suspend | -resume] setsched [-suspend_all | -resume_all] AUTHORITY Super, Service OPTIONS -suspend Suspends execution of a specified task. InForm OS Version 2.3.1 Command Line Interface Reference -name Sets a new name for a given task. The name can be up to 31 characters in length. -no_alert Failures of tasks will no longer generate an alert. -alert Failures of tasks will generate an alert. This is set by default. SPECIFIERS Specifies the name of the scheduled task to modify. RESTRICTIONS None. EXAMPLES None. NOTES None. 21. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsnmppw DESCRIPTION The setsnmppw command allows a user to update SNMP access community strings passwords. The SNMP password is required for the system manager to send requests to the SNMP agent. SYNTAX setsnmppw [options] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) community password is changed. InForm OS Version 2.3.1 Command Line Interface Reference The following example changes the read-only SNMP password to newpassword2 by specifying the –r option on the command line: cli% setsnmppw –r newpassword2 The following example changes the write-only SNMP password to newpassword3 by specifying the –w option on the command line: cli% setsnmppw –w newpassword3 NOTES ■ The default initial read/write password is public. ■ If the read-only or write-only passwords do not exist, they are created. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsshkey DESCRIPTION The setsshkey command sets the SSH public key for a user. The user will be prompted to provide the SSH public key. To finish entering the public key, press enter on a blank line. The key must have been generated using the ssh-keygen utility. The public key is contained in the user-defined file named with .pub extension. The user can open this file with an ASCII editor to copy the key and paste it. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the setting of a user’s SSH public key: cli% setsshkey Please enter the SSH public key below. When finished, press enter twice. The key is usually long. It's better to copy it from inside an editor and paste it here. (Please make sure there are no extra blanks.) The maximum length of the key is 4096 bits. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setstatch DESCRIPTION The setstatch command starts and stops the statistics collection mode for chunklets. SYNTAX setstatch start|stop AUTHORITY Super, Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for the specified Logical Disk (LD) and chunklet. OPTIONS None. SPECIFIERS Specifies the name of the LD in which the chunklet to be configured resides. InForm OS Version 2.3.1 Command Line Interface Reference NOTES After the statistic collection mode for the chunklet is set, you can then use either the histch command (page 15.2) or the statch command (page 25.2) to view the chunklet’s statistics. 21. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setstatpdch DESCRIPTION The setstatpdch command sets the statistics collection mode for all in-use chunklets on a Physical Disk (PD). SYNTAX setstatpdch start|stop AUTHORITY Super, Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for chunklets on the specified PD used by Logical Disks (LDs). OPTIONS None. SPECIFIERS Specifies the PD ID. RESTRICTIONS None. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setsys DESCRIPTION The setsys command sets the properties of the system, and includes options to annotate a system with descriptor information such as physical location, owner, contact information, and so on. The command also enables you to set system-wide parameters such as the raw space alert. SYNTAX setsys [options] setsys AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS The following parameters can be configured on the system and are issued for the specifier: RawSpaceAlertFC Sets the user configurable space alert threshold (100 to 100000 GB) for Fibre Channel type drives. When the total space on the available chunklets (both clean and unclean) for the specified drive type falls below the specified value, the alert is posted. A value of 0 will disable the alert. InForm OS Version 2.3.1 Command Line Interface Reference RemoteSyslogHost Sets the IP address of the system to which events will be sent as syslog messages. The value must be a valid IP address. SparingAlgorithm Sets the sparing algorithm used by the admithw command. Valid values are Default, Minimal, Maximal, and Custom. MgmtOldPorts Enables or disables listening on the old management ports 2540 and 2550 (for SSL). The server now listens on ports 5782 and 5783 (for SSL). Command Line Interface Reference InForm OS Version 2.3.1 VVRetentionTimeMax [h|H|d|D] Specifies the maximum value that can be set for the retention time of a volume. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setsysmgr DESCRIPTION The setsysmgr command sets the system manager startup state. CAUTION: Issuing the setsysmgr command can potentially remove the entire state of the system causing data loss. Command Line Interface Reference InForm OS Version 2.3.1 CAUTION: Issuing the setsysmgr force_idewipe command can result in data loss. force_idewipe Specifies that the system wipes the IDE powerfail partition. The system is shutdown and restarted, during which time all logical disks and VVs are checked. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. InForm OS Version 2.3.1 Command Line Interface Reference The following example starts the system with the table of contents generation number of 42956, where 91 is the highest disk quorum displayed: cli% setsysmgr tocgen 42956 91 The following example displays the start of a system’s recovery process from its IDE disk: cli% setsysmgr force_iderecovery NOTES ■ If the wipe subcommand is specified, all system data and configuration information, including customer data and VV layout, are destroyed. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND settemplate DESCRIPTION The settemplate command modifies the properties of existing templates. SYNTAX settemplate ... [option ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTION -remove InForm OS Version 2.3. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setuser DESCRIPTION The setuser command sets your user properties. SYNTAX setuser [options ] AUTHORITY Super, Edit, Browse OPTIONS –f Specifies that the command is forced. No confirmation is requested before executing the command. -adddomain :[,:...] Adds a specified user () to the specified domain () at the specified privilege level (). InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS The -adddomain and -rmdomain options cannot be used on a user that is currently logged in. Existing sessions can be terminated with the removeuserconn command. EXAMPLES In the following example, user 3paruser is permitted edit level privileges in the domain Engineering: cli% setuser -adddomain Engineering:edit 3paruser NOTES None. 21. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setuseracl DESCRIPTION The setuseracl command sets the Access Control List (ACL). SYNTAX setuseracl [options] []... AUTHORITY Super, Edit OPTIONS -add Adds names or patterns of objects at the end of an existing ACL. -remove Removes names or patterns of objects from an ACL. SPECIFIERS Specifies the name of the user whose ACL is being set. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example sets the ACL for user testuser1 and allows testuser1 to update the snapshot VVs of VVs vv1 and vv2. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setvv DESCRIPTION The setvv command changes the properties associated with Virtual Volumes (VVs). It can be used to modify volume names, volume policies, allocation warning, and limit levels, and the volume’s controlling Common Provisioning Group (CPG). SYNTAX setvv [options ] ... InForm OS Version 2.3.1 Command Line Interface Reference -retain [d|D|h|H] Specifies the amount of time, relative to the current time, that the volume will be retained. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value. Command Line Interface Reference InForm OS Version 2.3.1 tp_bzero Specifies that if a host write results in the allocation of a new data page that is only partially filled by the host write, then a zero-fill is performed on the unwritten portion of the data page to ensure that the host cannot read data from deleted volumes or snapshot. The default allocation page size is 16 KB. This is the default setting. InForm OS Version 2.3.1 Command Line Interface Reference The following options can only be used on Thinly Provisioned Virtual Volumes (TPVVs): -usr_aw This option returns a user space allocation warning. It generates a warning alert when the user space of the TPVV exceeds the specified percentage of the VV size. -usr_al This option returns the user space allocation limit. The user space of the TPVV is prevented from growing beyond the indicated percentage of the virtual volume size. Command Line Interface Reference InForm OS Version 2.3.1 –spt Defines the VV geometry sectors per track value that is reported to the hosts through the SCSI mode pages. The valid range is from 4 to 8192 and the default value is 304. –hpc Defines the VV geometry heads per cylinder value that is reported to the hosts through the SCSI mode pages. The valid range is from 1 to 1024 and the default value is 8. SPECIFIERS ... InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ To view policies assigned to the system’s VVs, issue the showvv –p command. See showvv on page 22.201 for more information. ■ It is not possible to rename a VV that is already associated with a Remote Copy group. ■ Changing the CPG for a TPVV is not allowed. 21. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setvvset DESCRIPTION The setvvset command sets the parameters and modifies the properties of a Virtual Volume (VV) set. SYNTAX setvvset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. Unprintable characters are not allowed. -name Specifies a new name for the VV set. InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 21. Command Line Interface Reference 21.96 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 22 Show Commands In this chapter showalert 22.4 showauthparam 22.6 showbattery 22.8 showblock 22.14 showcage 22.17 showcim 22.23 showclienv 22.25 showcpg 22.26 showdate 22.33 showdomain 22.34 showdomainset 22.36 showeeprom 22.38 showeventlog 22.41 showfirmwaredb 22.45 showhost 22.47 Show Commands 22. Command Line Interface Reference 22.2 InForm OS Version 2.3.1 showhostset 22.52 showinventory 22.54 showiscsisession 22.56 showld 22.58 showldch 22.66 showldmap 22.71 showlicense 22.73 shownet 22.75 shownode 22.77 shownodeenv 22.87 showpatch 22.89 showpd 22.91 showpdata 22.108 showpdch 22.109 showpdvv 22.116 showport 22.121 showportarp 22.132 showportdev 22.134 showportisns 22.137 showportlesb 22.139 showrcopy 22.145 showrctransport 22.150 showrsv 22. InForm OS Version 2.3.1 Command Line Interface Reference showspace 22.161 showspare [-used] 22.166 showsshkey 22.169 showsys 22.171 showsysmgr 22.176 showtarget 22.179 showtask 22.180 showtemplate 22.184 showtoc 22.185 showtocgen 22.187 showuser 22.188 showuseracl 22.190 showuserconn 22.191 showversion 22.193 showvlun 22.195 showvv 22.201 showvvmap 22.217 showvvpd 22.219 showvvset 22.224 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showalert DESCRIPTION The showalert command displays the status of system alerts. When issued without options, all alerts are displayed. SYNTAX showalert [options] AUTHORITY Super, Service, Edit, Browse OPTIONS The selection of alerts to be displayed is controlled by selecting one of the following options: –n Specifies that only new alerts are displayed. –a Specifies that only acknowledged alerts are displayed. InForm OS Version 2.3.1 Command Line Interface Reference -wide Do not truncate the message text. Only valid if the -oneline option is also specified. SPECIFIERS None. RESTRICTIONS Without any options, the showalert command displays all alerts in the New state. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showauthparam DESCRIPTION The showauthparam command shows authentication parameters. SYNTAX showauthparam AUTHORITY Super OPTIONS None. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showbattery DESCRIPTION The showbattery command displays battery status information including serial number, expiration date, battery life, and so on, which could be helpful when determining battery maintenance schedules. SYNTAX showbattery [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed battery information, including battery test information, serial numbers, and expiration dates, is displayed. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays battery status information: cli% showbattery Node PS Bat Serial 0 0 0 FFFFFFFF 0 1 0 FFFFFFFF 1 0 0 -1 1 0 -- --State--- ChrgLvl(%) -ExpDate-- Expired OK 100 05/15/2007 No OK 100 05/15/2007 No NotPresent -- -No NotPresent -- -No Testing No No No No The columns in the previous example are identified as follows: ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed battery information: cli% showbattery -d --------------Node 0 PS 0 Battery 0--------------Node ID : 0 Power Supply ID : 0 Battery ID : 0 Manufacturer : MAG Model : 0800-0016-50.0B Serial Number : 70315366 State : OK Charge State : FullyCharged Charge Level(%) : 100 Max Battery Life(mins) : 25 Expired : No Test in Progress : No Expiration Date : 2010-07-17 13:00:00 PD ... InForm OS Version 2.3. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays the detailed status of the battery using the showbattery –s command: cli% showbattery -s Node PS Bat -State0 0 0 OK 0 1 0 OK 1 0 0 OK 1 1 0 OK -Detailed_StateNormal Normal Normal Normal ■ State ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID. ■ State. The current status of the battery and can be one of the following: ■ ◆ OK. The battery is operating normally. InForm OS Version 2.3.1 ■ Command Line Interface Reference For the E-Class and F-Class Storage Servers, the Power Supply 0's primary node is 0 and its secondary node is 1. The Power Supply 1's primary node is 1 and its secondary node is 0. The primary node can read and modify the power supply's properties. The secondary node can only read the power supply's properties. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showblock DESCRIPTION The showblock command displays block mapping information for Virtual Volumes (VVs), Logical Disks (LDs), and Physical Disks (PDs). SYNTAX showblock [options ] [] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed information is displayed for the specified device and block. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays block mapping information for block 0 in the user space of VV admin: cli% showblock vv admin usr 0 VVname Spc VVBlock admin usr 0x00000000 = = = LDname LDBlock PDid Chnk PDblock admin.usr. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed block mapping information from blocks 0x100 through 0x400 in the user space of VV admin: cli% showblock –d vv admin usr 0x100 0x400 VV/LD Name Block Region VV usr: admin 0x00000100 0x00000000–0x0007FFFF (0–256MB) LD : admin.usr. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showcage DESCRIPTION The showcage command displays information about drive cages. SYNTAX The syntax of the showcage command can be one of the following: ■ showcage [options] [-d] [...] ■ showcage [-sfp [-d|-ddm]] [...] ■ showcage -i [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that more detailed information about the drive cage is displayed. Command Line Interface Reference InForm OS Version 2.3.1 –i Specifies that inventory information about the drive cage is displayed. If this option is not used, then only summary information about the drive cages is displayed. SPECIFIERS ... Specifies a drive cage name for which information is displayed. This specifier can be repeated to display information for multiple cages. If no specifiers are used, the command defaults to displaying information about all cages in the system. InForm OS Version 2.3.1 ■ RevA. The cage firmware version for side A of the drive cage. ■ RevB. The cage firmware version for side B of the drive cage. ■ Model. The model can be DC1, DC2, DC3, or DC4. ■ Side. Specifies the right (1) or left (0) side of the drive cage. Command Line Interface Reference 22. Command Line Interface Reference InForm OS Version 2.3.1 Specifying the –d option provides more detailed information about the drive cages. See the following E200 Storage Server example for cage0: cli% showcage -d Id Name LoopA Pos.A LoopB Pos. InForm OS Version 2.3.1 Command Line Interface Reference Specifying the –d option provides more detailed information about the drive cages. See the following DC4 example from a T-Class Storage Server example for cage0: cli% showcage -d cage0 Id Name LoopA Pos.A LoopB Pos.B Drives Temp RevA RevB Model Side 0 cage0 0:1:1 0 1:1:1 0 40 24-33 2.05 2. Command Line Interface Reference InForm OS Version 2.3.1 When the power supply is switched off, it will be reported as Off through the showcage -d command as well as a degraded alert being posted. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showcim DESCRIPTION The showcim command displays the CIM server current status, either active or inactive. It also displays the current status of the HTTP and HTTPS ports and their port numbers. In addition, it shows the current status of the SLP port, that is either enabled or disabled. SYNTAX showcim AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference ■ SLP. Indicates the SLP port state. ◆ --. Cannot determine the SLP port state. ◆ Enabled. The SLP port state is enabled. ◆ Disabled. The SLP port state is disabled. ■ SLPPort. The SLP port. Default is 427. ■ HTTP. Indicates the HTTP port state. ◆ --. Cannot determine the HTTP port state. ◆ Enabled. HTTP port is enabled. ◆ Disabled. HTTP port is disabled. ■ HTTPPort. HTTP port (1024 - 65635). The default value is 5988. ■ HTTPS. The HTTPS port state. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showclienv DESCRIPTION The showclienv command displays the CLI environment parameters. SYNTAX showclienv AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showcpg DESCRIPTION The showcpg command displays Common Provisioning Groups (CPGs) in the system. SYNTAX showcpg [options ] [...|...] AUTHORITY Super, Service, Edit, Browse OPTIONS The following options can not be used together with other options except -hist and -domain: -d Show the detail information of CPGs. –r Specifies that raw space used by the CPGs is displayed. –alert Indicates whether alerts are posted. InForm OS Version 2.3.1 Command Line Interface Reference -domain Shows only CPGs that are in domains with names matching one or more of the argument. This option does not allow listing objects within a domain of which the user is not a member. Patterns are glob-style (shell-style) patterns (see Help on sub,globpat). SPECIFIERS [...|... Command Line Interface Reference ■ ■ ■ ■ InForm OS Version 2.3.1 Usage. Virtual Volumes using the CPG. ◆ Usr. The number of VVs whose User Space is using the CPG. ◆ Snp. The number of VVs whose Snapshot Space is using the CPG. Usr. User space. ◆ Total. The total logical disk space in MBs in the Usr space. ◆ Used. The total logical disk space in MBs used in Usr space. Snp. Snap space. ◆ Total. The total logical disk space in MBs in the Snp space. ◆ Used. InForm OS Version 2.3.1 ■ ■ ■ ■ ■ Command Line Interface Reference Usage. Virtual Volumes using the CPG. ◆ Usr. The number of VVs whose User Space is using the CPG. ◆ Snp. The number of VVs whose Snapshot Space is using the CPG. Usr. User space. ◆ Total. The total logical disk space in MBs in the Usr space. ◆ Used. The total logical disk space in MBs used in Usr space. Snp. Snap space. ◆ Total. The total logical disk space in MBs in the Snp space. ◆ Used. Command Line Interface Reference InForm OS Version 2.3.1 ■ Limit. The CPG’s snapshot data allocation limit threshold, or growth limit in MBs. ■ Grow. The CPG’s snapshot data space allocation limit threshold. ■ Args. The options used in the creation of the CPG. InForm OS Version 2.3. Command Line Interface Reference ■ InForm OS Version 2.3.1 Adm. Administration space. ◆ Total. The total logical disk space in MBs in the Adm space. ◆ RTotal. The total raw MBs of (raw) space in the Adm space. ◆ Used. The total logical disk space in MBs used in Adm space. ◆ RUsed. The total MBs of (raw) space used in the Adm space. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showdate DESCRIPTION The showdate command displays the date and time for each system node. SYNTAX showdate AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showdomain DESCRIPTION The showdomain command displays a list of domains in a system. SYNTAX showdomain [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed information is displayed. –sortcol [,][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays detailed information about a system’s domains: cli% showdomain -d ID Domain -----CreationTime-----1 TestDomain1 2009-08-22 14:23:30 PDT 2 TestDomain2 2009-08-22 14:23:30 PDT 3 TestDomain3 2009-08-22 14:23:30 PDT --Comments--- -VVRetentionTimeMaxBeef Test 0 Hours Chicken Test 0 Hours Pork Test 0 Hours In the example above: ■ ID. The domain ID. ■ Domain. The domain name. ■ CreationTime. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showdomainset DESCRIPTION The showdomainset command lists the host sets defined on the InServ and their members. SYNTAX showdomainset [options] [...] showdomainset -domain [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -domain Show domain sets that contain the supplied domains or patterns SPECIFIERS ... InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES To show all domain sets defined to the system: cli% showdomainset Id Name Members 7 domainset domainset.1 domainset.2 23 newset testdomain Show details of a specific set: cli% showdomainset -d newset Id Name Members Comment 23 newset testdomain this set has been renamed and now has a comment Show domain sets containing domains matching the pattern domainset.*: cli% showdomainset -domain domainset.* Id Name Members 7 domainset domainset. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showeeprom DESCRIPTION The showeeprom command displays node EEPROM log information. SYNTAX showeeprom [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –dead Specifies that an EEPROM log for a node that has not started or successfully joined the cluster be displayed. If this option is used, it must be followed by a list of nodes. SPECIFIERS ... InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the EEPROM log for all nodes: cli% showeeprom Node: 0 -------Board revision: 0920-1053-03.01 Assembly: FLH 2007/50 Serial 0039 System serial: 1000183 BIOS version: 2.1.3 OS version: 2.2.4. Command Line Interface Reference InForm OS Version 2.3.1 In the example above: ■ Board revision indicates the 3PAR part number for the node board, including any minor revision codes. ■ Assembly indicates the code of the assembly, the year or week the node was produced, and the node serial number. ■ System serial is the cluster serial number. ■ BIOS version displays the currently installed BIOS version. ■ OS version displays the currently installed OS version. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showeventlog DESCRIPTION The showeventlog command displays the current system event log. SYNTAX showeventlog [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –min Specifies that only events occurring after the specified number of minutes are shown. The is an integer from 1 through 2147483647. –more Specifies that you can page through several events at a time. Command Line Interface Reference InForm OS Version 2.3.1 –endt Specifies that only events before a specified time are to be shown. The time argument can be specified as either , , or both. Specified as the hour (hh), as interpreted on a 24 hour clock, where minutes (mm) and seconds (ss) can be optionally specified. Acceptable formats are hh:mm:ss or hhmm. InForm OS Version 2.3.1 Command Line Interface Reference –nnode Specifies that only events from nodes that do not match the specified pattern(s) are displayed. –type Specifies that only events with types that match the specified pattern(s) are displayed. –ntype Specifies that only events with types that do not match the specified pattern(s) are displayed. –msg Specifies that only events, whose messages match the specified patttern(s), are displayed. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showfirmwaredb DESCRIPTION The showfirmwaredb command displays the current database of firmware levels for possible upgrade. If issued without any options, the firmware for all vendors is displayed. SYNTAX showfirmwaredb [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –n Specifies that the firmware vendor from the SCSI database file is displayed. –l Reloads the SCSI database file into the system. Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the current database of firmware levels and prints firmware data: cli% showfirmwaredb Vendor Prod_rev Dev_Id Fw_status Cage_type HITACHI [C1C1] DK..DJ-18FC Current DC4 HITACHI [C1C1] DK..DJ-72FC Current DC4 HITACHI [JLAK] DK..CJ-18FC Current DC4 HITACHI [JLAK] DK..CJ-36FC Current DC4 HITACHI [JLAK] DK..CJ-72FC Current DC4 HITACHI [GLAK] DK.. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showhost DESCRIPTION The showhost command displays information about defined hosts and host paths in the system. SYNTAX showhost [options ] [...|...|...] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Shows a detailed listing of the host and path information. This option can only be used with -agent and -domain options. -verbose Shows a verbose listing of all host information. Command Line Interface Reference InForm OS Version 2.3.1 -listpersona Lists the defined host personas. This option cannot be used with the -d option. Different host personas support different host operating systems and have different capabilities. Host personas may have the following additional capabilities: ◆ UARepLun. Sends a unit attention when the LUN list changes due to adding or removing VLUNs. ◆ RTPG. InForm OS Version 2.3.1 Command Line Interface Reference set:... Specifies that information about all the hosts that are members of set should be displayed. The set name must start with set:. Acts as if all members were individually specified as parameters to the comment. May be repeated to specify multiple host sets. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays host CHAP properties: cli% showhost –chap Id Name -Initiator_CHAP_Name- -Target_CHAP_Name0 queasy10 queasy10 s019 1 foo --- The following example displays all host information: cli% showhost –verbose Id Name Persona -----WWN/iSCSI_Name----- Port IP_addr 0 queasy10 Generic 210000E08B027B60 0:0:1 n/a 1 foo Generic myiscsipath.3pardata.com --0.0.0. InForm OS Version 2.3.1 Command Line Interface Reference if the CLI was started with the TPDLISTDOM environment variable set. Please run cli -h and setclienv -h for details of the environment variables command. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showhostset DESCRIPTION The showhostset command lists the host sets defined on the InServ and their members. SYNTAX showhostset [options] [...] showhostset -host [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -host Show host sets that contain the supplied hostnames or patterns. SPECIFIERS ... InForm OS Version 2.3. Command Line Interface Reference COMMAND showinventory DESCRIPTION Shows information about all the hardware components in the system. SYNTAX showinventory AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES None. 22.54 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference NOTES The inventory is divided into sections and inventory for each of these sections can be shown separately with the following command: Section Command Node shownode -i Battery showbattery -i Port showport -i Cage showcage -i Disk showpd -i 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showiscsisession DESCRIPTION The showiscsisession command shows the iSCSI sessions. SYNTAX showiscsisession [option ] AUTHORITY Super, Service, Edit, Browse OPTIONS –sortcol [,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. InForm OS Version 2.3.1 Command Line Interface Reference In the example above: ■ N:S:P. The port location in Node:Slot:Port format, where Slot is the PCI slot number in the node and Port is the port number in the PCI card. ■ IPAddr. The IP address of the Ethernet port. ■ TPGT. The Target Portal Group Tag. ■ TSIH. The Target Session Identifying Handle. ■ Conns. The number of connections for the session. ■ iSCSI_Name. The iSCSI name of the host. ■ StartTime. The time the session was started. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showld DESCRIPTION The showld command displays configuration information about the system’s Logical Disks (LDs). SYNTAX showld [options ] [|...] AUTHORITY Super, Service, Edit, Browse OPTIONS –cpg ... Requests that only logical disks in Common Provisioning Groups (CPGs) that match the specified CPG names or patterns be displayed. InForm OS Version 2.3.1 Command Line Interface Reference –sortcol [,][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:).Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information for al LDs in a two node system: cli% showld Id Name 0 log0.0 1 log1.0 2 pdsld0.0 3 admin.usr.0 4 admin.usr.1 5 VV111.usr.0 6 VV111.usr. InForm OS Version 2.3.1 ◆ Command Line Interface Reference removing. The logical disk is being deleted. The following State values indicate that an uncontrolled shutdown has occurred and the logical disk was not properly closed before the shutdown. ◆ auto_check. The logical disk is checked for validity. ◆ checking. The logical disk is checked for validity. ◆ need_check. The logical disk has been checked, and an inconsistency has been found. ◆ need_pd. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed information about the system LDs: cli% showld -d Id Name CPG RAID Own SizeMB RSizeMB RowSz StepKB SetSz Refcnt Avail CAvail -----CreationTime------ -CreationPattern0 log0.0 --1 0/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 1 log1.0 --1 1/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 2 pdsld0. InForm OS Version 2.3.1 ◆ Command Line Interface Reference mag. A chunklet from another disk within the same drive magazine can be used as a replacement. ◆ cage. A chunklet from another drive cage can be used as a replacement. ◆ port. A chunklet from another port can be used as a replacement. ■ CAvail. Indicates the current, or actual, availability: disk, mag, port, or cage. ■ Creation Time. Indicates when the logical disk was created. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed states of each LD: cli% showld -s Id Name 0 log0.0 1 pdsld0.0 2 pdsld0.1 3 pdsld0.2 4 admin.usr.0 5 vvfromcpg2.usr.0 6 vvfromcpg2.usr.1 7 Temple.usr.0 ... -Statenormal normal normal normal normal normal normal normal -Detailed_Statenormal normal normal normal normal normal normal normal The columns in the previous example are identified as follows: ■ Id. The logical disk ID. ■ Name. InForm OS Version 2.3.1 ◆ degraded_avail. The availability of the LD is degraded. ◆ degraded_perf. The performance of the LD is degraded. ◆ unknown. The LD state is unknown. Command Line Interface Reference NOTES ■ For this command, KB=1024 bytes and MB=1048576 bytes. ■ A Domain column may be included by using the setclienv command to set listdom to 1. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showldch DESCRIPTION The showldch command displays configuration information about the chunklet mapping for one Logical Disk (LD). SYNTAX showldch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -degraded Show only the chunklets in sets that cause the LD availability to be degraded. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the LD name. RESTRICTIONS None. EXAMPLES The following example displays information about chunklets for LD r1.usr.0: cli% showldch r1.usr. Command Line Interface Reference InForm OS Version 2.3.1 ◆ normal. The chunklet is available for use. ◆ normal,smag. A servicemag operation is being performed on the disks. ◆ stale. The chunklet is not available for use because of a medium failure or a connectivity failure. ■ ◆ logging. Writes to the chunklet are being logged to a separate logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. The chunklet does not process physical disk errors. InForm OS Version 2.3.1 Command Line Interface Reference The following example displays information about degraded chunklets for LD r1.usr.0. cli% showldch -degraded r1.usr.0 Ldch Row Set PdPos Pdid Pdch State Usage Media Sp 0 0 0 1:3:2 30 0 normal ld valid N 1 0 0 1:3:3 31 3 normal ld valid N 14 0 7 2:0:1 33 0 normal ld valid N 15 0 7 2:0:2 34 5 normal ld valid N cli% showldch -degraded r1.usr.1 No degraded sets in LD r1.usr. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays row and set layout including pdid and pdpos for chunklets for LD test.usr.0. cli% showldch -lformat set -linfo pdid,pdpos test.usr. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showldmap DESCRIPTION The showldmap command displays the mapping from a Logical Disk (LD) to Virtual Volumes (VVs). SYNTAX showldmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the LD name. RESTRICTIONS None. EXAMPLES The following example displays the region of LD v0.usr.0 that is used for a VV: cli% showldmap v0.usr. Command Line Interface Reference ■ VVName. The name of the virtual volume that contains the region. ■ VVSp. The type of the space-user (usr), snapshot data (snp), or snapshot administration (adm)-for which the region is being used. ■ VVOff(MB). The offset from the beginning of the space that contains the region. NOTES None. 22.72 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showlicense DESCRIPTION The showlicense command displays the currently installed license key and current license information. SYNTAX showlicense AUTHORITY Super, Service, Edit, Browse OPTIONS –raw Specifies that the license key originally entered (the raw license) be displayed. The license key is displayed in a manner that is acceptable input for the setlicense command. SPECIFIERS None. RESTRICTIONS None. 22. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownet DESCRIPTION The shownet command displays the configuration and status of the administration network interfaces, including the configured gateway and Network Time Protocol (NTP) server. SYNTAX shownet [option] AUTHORITY Super, Service, Edit, Browse OPTION –d Displays detailed information. SPECIFIERS None. RESTRICTIONS None. 22. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays the status of the system administration network interfaces: root@enodec34:S424# shownet -d IP Address: 192.168.5.191 Netmask 255.255.252. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownode DESCRIPTION The shownode command displays an overview of the node-specific properties and its component information. Various command options can be used to display the properties of PCI cards, CPUs, physical memory, disk drives, and power supplies. SYNTAX shownode [option] [... Command Line Interface Reference InForm OS Version 2.3.1 -drive Displays the disk drive information. –ps Displays power supply information. –s Displays the detailed state information for node or power supply (proceed with the -ps option) SPECIFIERS ... Displays the node information for the specified node ID(s). This specifier is not required. RESTRICTIONS None. InForm OS Version 2.3.1 ◆ Command Line Interface Reference Failed. The node has not initialized, is offline, has mismatching kernal versions has bad drive partitions, is rebooting, or has shutdown. ■ Master. Specifies is the node is the master node. ■ InCluster. Indicates if the node is in the cluster. ■ LED. The node LED information. Values are as follows: ◆ --. The node LED is unknown. ◆ off. The node LED is off. ◆ Green. The kernal is not running. ◆ GreenBlink. Command Line Interface Reference InForm OS Version 2.3.1 These columns and values are described in detail in the following examples. cli% Node 0 0 0 0 0 1 1 1 1 1 shownode -mem Riser Slot SlotID n/a 0 J4200 n/a 1 J4300 2-slot 0 J0901 4-slot 1 J0900 4-slot 2 J1300 n/a 0 J4200 n/a 1 J4300 2-slot 0 J0901 4-slot 1 J0900 4-slot 2 J1300 -Name-DIMM0 DIMM1 DIMM0.0 DIMM1.0 DIMM2.0 DIMM0 DIMM1 DIMM0.0 DIMM1.0 DIMM2. InForm OS Version 2.3.1 Command Line Interface Reference cli% shownode -drive ... Node Drive -Manufacturer- ---Model--- -Serial- -Firmware- Size(MB) Type 0 0 Seagate ST9100821AS 5NJ09DF3 3.AAB 95396 SATA 1 0 Seagate ST9100821AS 5NJ08NA4 3.AAB 95396 SATA In the example above: ■ Node. The node ID. ■ Drive. The disk drive ID. ■ Manufacturer. The manufacturer of the disk drive. ■ Model. The model number of the disk drive. ■ Serial. The serial number of the disk drive. ■ Firmware. Command Line Interface Reference ■ Rev. The revision number of the PCI card. ■ Firmware. The firmware version on the PCI card. InForm OS Version 2.3.1 cli% shownode -cpu --------------------------------CPUs-------------------------------Node CPU -Manufacturer- -----Serial----- CPUSpeed(MHz) BusSpeed(MHz) 0 0 GenuineIntel 000188AAF2AEA667 995 132.76 0 1 GenuineIntel 0000D8D47BD100A6 995 132.76 1 0 GenuineIntel 0000F5A65AAD5D6F 995 132.72 1 1 GenuineIntel 00028FE5F6E4068D 995 132. InForm OS Version 2.3.1 ■ ■ ■ ■ ■ Command Line Interface Reference ◆ Failed. The power supply is operating abnormally. ◆ NotPresent. The power supply is missing. ◆ Degraded. There is a fan failure, or the battery state is not OK. FanState. The power supply fan state. Values are as follows: ◆ --. Cannot determine the state. ◆ OK. The fan is operating normally. ◆ Failed. The fan is operating abnormally. ACState. The state of the AC power. Values are as follows: ◆ --. Command Line Interface Reference InForm OS Version 2.3.1 The following example displays the detailed state of the nodes: cli% shownode -s Node 0 1 2 3 -StateOK OK OK OK -Detailed_StateOK OK OK OK In the example above: ■ Node. The node ID. ■ State. The state of the node. Values are as follows: ◆ ◆ OK. The node and its components are operating normally. Degraded. InForm OS Version 2.3.1 Command Line Interface Reference ◆ cpu_vrm_overheating. The node CPU VRM overheating. ◆ control_cache_dimm_overheating. The node Control Cache DIMM is overheating. ◆ node_offline_due_to_failure. The node is offline due to failure. ◆ node_shutdown_manually. The node was shutdown manually. ◆ unknown. The node state is unknown. Command Line Interface Reference ◆ invalid_firmware. The power supply firmware is invalid. ◆ oscillating_presence. The power supply presence is oscillating. ◆ oscillating_dc. The power supply DC is oscillating. ◆ oscillating_ac. The power supply AC is oscillating. ◆ oscillating_fan. The power supply fan is oscillating. ◆ oscillating_charger. The power supply charger is oscillating. ◆ oscillating_bat. The power supply battery is oscillating. ◆ NotPresent. The power supply is not present. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownodeenv DESCRIPTION The shownodeenv command displays the node operating environment status, including voltages and temperatures. SYNTAX shownodeenv [options ...] AUTHORITY Super, Service, Edit, Browse OPTIONS –n ... Specifies the ID of the node whose environment status is displayed. Multiple node IDs can be specified as a series of integers separated by a space (1 2 3). Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays the operating environment status for all nodes in the system: cli% shownodeenv Node 0 --------Measurement CPU0 1.32V: CPU1 1.32V: 82563 1.20V: 31154 1.30V: 82563 1.90V: 3.30V: PLX 3.30V: VCC 5.00V: V_PTT 1.20V: MCH 1.50V: ESB 1.50V: FBD 1.50V: FBD 1.80V: VTT_FBD 0.90V: ESB 1.20V: PLX 1.00V: Osprey DDR 1.25V: Osprey DDR 2.50V: Osprey Lnk 1.87V: FPGA 2.50V: 12. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpatch DESCRIPTION The showpatch command displays patches applied to a system. SYNTAX showpatch [option ] AUTHORITY Super, Service, Edit, Browse OPTIONS –hist Specifies the history of all patches and updates applied to the system. –d Specifies the details on a specified patch ID. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 ■ Obsoletes. Specifies the patch IDs deleted by this patch. ■ Requires. Specifies the patch IDs of any other patches required by this patch. ■ Notes. Specifies any special instructions for the patch. NOTES This command displays all the patches currently affecting the system if options are not used. 22. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpd DESCRIPTION The showpd command displays configuration information about a system’s Physical Disks (PDs). SYNTAX showpd [options] [...] showpd -listcols AUTHORITY Super, Service, Edit, Browse OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showpd for help on each column). Command Line Interface Reference InForm OS Version 2.3.1 –i Specifies a request for disk (inquiry) data. The following columns are shown: Id, CagePos, State, Node_WWN, Manuf, Model, Serial, FW_Rev. –e Specifies a request for the disk environment and error information. Note that reading this information places a significant load on each disk. The following columns are shown: Id, CagePos, Type, State, Rd_CErr, Rd_UErr, Wr_CErr, Wr_UErr. –c Specifies a request for chunklet use totals for each PD. InForm OS Version 2.3.1 Command Line Interface Reference –sortcol [,][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting () can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:).Command Line Interface Reference InForm OS Version 2.3.1 –st - Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–3). The primary path of the disks must be on the specified PCI slot(s). –pt
- Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3).
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive. –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected. –tc_lt Specifies that physcial disks with total chunklets less than the number specified are selected. Command Line Interface Reference InForm OS Version 2.3.1 -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 ◆ new - The PD is new, needs to be admitted before it can be used (see help admitpd) ◆ failed - The PD has failed. ■ Total. Total size of the disk in MB (1024^2 bytes). ■ Free. Free size of the disk in MB (1024^2 bytes). This includes the size that is available to use, uninitialized, and unavailable to use. ■ Port_A. The port location for the A port of the physical disk. If the primary path, the port location is followed by an asterisk (*). InForm OS Version 2.3.1 ◆ ■ Command Line Interface Reference SSD - Solid State Drive State. State of the PD can be one of the following: ◆ normal - PD is normal ◆ degraded - The PD is not operating normally. Use showpd -s to find out the detail information. ■ ■ ◆ new - The PD is new, needs to be admitted before it can be used (see help admitpd) ◆ failed - The PD has failed. Total. Total size of the disk in MB (1024^2 bytes). Normal Chunklets. Command Line Interface Reference ■ InForm OS Version 2.3.1 CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine. InForm OS Version 2.3.1 ■ Command Line Interface Reference CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference ■ Write_Error_UnCorr. Number of uncorrectable write errors. ■ T(C). Temperature in degrees celsius. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference the current position of the drive is not known (for example, the drive may be missing), and the position shown is the last known position. ■ ■ Type. Device type of the PD. ◆ FC - Fibre Channel ◆ NL - Nearline ◆ SSD - Solid State Drive Speed(K). The maximum RPM speed of the physical disk. The number does not represent a rotational speed for the drives without spinning media (SSD). Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 ■ Command Line Interface Reference Without the -i, -c, -e, -s, -path or -space options, basic information about the PD is printed. Note that the primary path to the disk is shown by an asterisk(*) in either the APort or BPort column, and a minus (-) sign following a path indicates the port is disabled. ■ If the specifier and the -w option is not specified, all disks are displayed. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showpdata DESCRIPTION The showpdata command displays information about the preserved data in the system. SYNTAX showpdata [] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [] Requests that preserved data for a specific Logical Disk (LD) is displayed. This specifier is not required on the command line. If not specified, then the amount of preserved data by LD is displayed. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpdch DESCRIPTION The showpdch command displays the status of selected Physical Disk (PD) chunklets. SYNTAX showpdch [options] showpdch [options] |... (deprecated usage) AUTHORITY Super, Service, Edit, Browse OPTIONS The following filtering options specify conditions that a chunklet should meet in order for the chunklet to be displayed. Command Line Interface Reference InForm OS Version 2.3.1 –tgt Specifies that information for chunklets marked as targets of relocation is displayed. –src Specifies that information about chunklets that are marked as sources of relocation, is displayed. –spr Specifies that information about chunklets that are marked as spares, is displayed. –log Specifies that information about chunklets that are logging is displayed. InForm OS Version 2.3.1 Command Line Interface Reference –nd - Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s). –st
- Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.3.1 –dk - Specifies one or more PDs. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive.
InForm OS Version 2.3.1 Command Line Interface Reference -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed. Command Line Interface Reference ■ LdCh. The position of the chunklet on the logical disk. ■ State. The state of the chunklet as identified by the kernel. InForm OS Version 2.3.1 ◆ logging. I/O to the chunklet is written to the logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. Chunklets do not process physical disk errors. ◆ preserved. Any I/O to the chunklet is written to the preserved logical disks. ◆ preserved playback. InForm OS Version 2.3.1 ■ Command Line Interface Reference Cl. The clean status of the chunklet. N indicates that the chunklet is in-use. Y indicates that the chunklet is clean. Cg indicates that the chunklet is being cleaned. ■ From. The initial location of the chunklet before relocation in the syntax :. ■ To. The destination location of the chunklet during relocation in the syntax :. NOTES None. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showpdvv DESCRIPTION The showpdvv command displays the virtual volumes hat are mapped to a particular physical disk. SYNTAX showpdvv [options] [ [:]...] AUTHORITY Super, Service, Edit, Browse OPTIONS -sum Shows number of chunklets used by virtual volumes for different space types for each physical disk. –p PDs matching the specified pattern are displayed. InForm OS Version 2.3.1 Command Line Interface Reference –pt - Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–3). The primary path of the disks must be on the specified port(s). –cg
- Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.3.1 –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows with the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS Specifies the physical disk ID using an integer. This specifier is not required if -p option is used, otherwise it must be used at least once on the command line. Command Line Interface Reference NOTES None. 22.120 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX The syntax of the showport command can be one of the following: ■ showport [options] [-failed] [-sortcol [,]] AUTHORITY Super, Service, Edit, Browse OPTIONS -i Show hardware and inventory formation. -c Displays all devices connected to each loop (by position on the loop).Command Line Interface Reference InForm OS Version 2.3.1 -rcip Displays information specific to the Ethernet Remote Copy ports. -iscsi Displays information about iSCSI ports. -iscsiname Displays iSCSI names associated with iSCSI ports. -sfp Displays information about hot pluggable SFPs attached to ports. -ddm Displays information about the SFPs DDM. This option must be used with the -sfp option. -d Displays detailed information about the SFPs attached to ports. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference ◆ loss_sync. The port is not physically connected to anything. ◆ config_wait. Firmware has yet to be initialized. ◆ InForm OS Version 2.3.1 login_wait. Fibre Channel adapter is attempting port and process logins with all loop ports. ◆ error. Fibre Channel adapter has experienced an unrecoverable error. ◆ non_participate. Port is logically isolated from the Fibre Channel loop. ◆ offline. The port is offline. ◆ pending_reset. InForm OS Version 2.3. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference The following example displays information about all Remote Copy ports: cli% showport –rc N:S:P State HwAddr Rate 5:3:2 ready 25320002AC000006 2Gbps 4:1:1 ready 24110002AC000006 2Gbps 0:5:1 ready 0002B39B2013 100Mbps Type rcip rcip rcip The columns in the previous example are identified as follows: ■ N:S:P. The physical position of the port, in the syntax node:slot:port. ■ State. State of the port. ◆ ready. Command Line Interface Reference The following example displays the detailed state of the port: cli% showport –s N:S:P --State-- -Detailed_State0:0:1 ready loss_sync 0:0:2 ready loss_sync 0:3:1 ready offline 0:3:1 ready offline 0:5:1 ready loss_sync -------------------------------10 The columns in the previous example are identified as follows: ■ N:S:P. The physical position of the port, in the syntax node:slot:port. ■ State. State of the port. ■ 22.128 ◆ OK. Port SFP is operating normally. InForm OS Version 2.3.1 ◆ Command Line Interface Reference unknown. The link state is unknown. The following example displays information about RCIP ports: cli% showport N:S:P State 0:1:1 offline 0:1:1 offline 1:2:1 offline 1:2:1 offline -rcip ---HwAddr--- IPAddr Netmask Gateway MTU Rate Duplex AutoNeg 000423C21B72 - n/a n/a n/a 000423C21B73 - n/a n/a n/a 000423ADE95E - n/a n/a n/a 000423ADE95F - n/a n/a n/a The columns in the previous example are identified as follows: ■ N:S:P. Command Line Interface Reference ■ InForm OS Version 2.3.1 AutoNeg. Values can either be Yes or No. The following example displays information about iSCSI ports: cli% showport -iscsi N:S:P State IPAddr Netmask Gateway TPGT MTU Rate DHCP iSNS_Prim iSNS_Sec iSNS_Port 1:3:1 ready 192.168.9.163 255.255.255.0 192.168.9.1 131 1500 1Gbps 0 0.0.0.0 0.0.0.0 3205 1:3:2 loss_sync 0.0.0.0 0.0.0.0 0.0.0.0 132 1500 n/a 0 0.0.0.0 0.0.0. InForm OS Version 2.3.1 Command Line Interface Reference The following examples display both standard and detailed information about SFPs attached to ports: cli% showport N:S:P -State0:0:1 OK 0:0:2 OK 0:3:2 OK 1:0:1 OK 1:0:2 OK cli% -sfp -Manufacturer- MaxSpeed(Gbps) TXDisable TXFault RXLoss DDM FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2.10 No No Yes Yes SIGMA-LINKS 2.10 No No Yes Yes FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showportarp DESCRIPTION The showportarp command shows the ARP table for iSCSI ports in the system. SYNTAX showportarp [::] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [::] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. InForm OS Version 2.3.1 ■ Command Line Interface Reference HwAddr. The MAC address of a remote host discovered through the MAC address resolution process. ■ IPAddr. The IP address of the remote host to which the port is attempting to connect. ■ Time (mins). The amount of time (in minutes) that the entry has been in the table. When the entry has been in the table for 20 minutes, it is removed. NOTES None. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showportdev DESCRIPTION The showportdev command displays detailed information about either all devices or only arbitrated loop devices on a Fibre Channel port. SYNTAX showportdev loop|all|ns AUTHORITY Super, Service, Edit, Browse SUBCOMMANDS loop|all|ns loop Specifies that information is returned for arbitrated loop devices that are attached to the specified port. InForm OS Version 2.3.1 Command Line Interface Reference slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot. RESTRICTIONS The loop subcommand is functional only in a private loop topology. Command Line Interface Reference NOTES None. 22.136 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showportisns DESCRIPTION The showportisns command shows iSNS host information for iSCSI ports in the system. SYNTAX showportisns [::] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node. Command Line Interface Reference ■ N:S:P. Represents the node:slot:port of the iSCSI port. ■ Host_IPAddr. The IP address of a remote host. ■ Host_iSCSI_Name. Represents the iSCSI name of the host. ■ Host_alias. Represents the iSCSI alias of the host. NOTES None. 22.138 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showportlesb DESCRIPTION The showportlesb command displays Fibre Channel Link Error Status Block (LESB) counters (the number of errors accumulated for Fibre Channel devices). The LESB is composed of six counters that can measure Fibre Channel signal integrity or status. Command Line Interface Reference InForm OS Version 2.3.1 Displays differences between historical samples of LESB counters on the specified port of loop devices. OPTIONS –startt Specifies that samples taken of LESB counters should commence after the indicated time (). Time can be specified in hours or as a specific date. When specifying the time in hours, the following formats can be used: ◆ hh[:mm[:ss]], where hh is the hour, mm is the minute (optional), and ss is the second (optional). InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the port for which information about devices on that port are displayed. This specifier is required for the single, both, hist, and diffhist subcommands, and optional for the compare subcommand. If this specifier is not used with the compare subcommand, then all ports are compared. The port is specified as follows: node Specifies the node. slot Specifies the PCI bus slot in the specified node. Command Line Interface Reference The following example displays the comparison of all ports: cli% showportlesb compare Port <1:0:1> Loop <1:0:1> Time since last save: 0:00:28 ID ALPA LinkFail LossSync LossSig PrimSeq InvWord InvCRC <1:0:1> 0xef 1 19 19 0 0 0 pd7 0x6d 1 5 0 0 270 0 pd6 0x72 1 4 0 0 524 0 pd5 0x73 1 4 0 0 335 0 pd4 0x76 1 4 0 0 334 0 pd3 0x79 1 4 0 0 401 0 pd2 0x80 1 4 0 0 344 0 pd1 0x81 1 4 0 0 270 0 pd0 0x88 1 4 0 0 401 0 Port <0:0:1> Loop <0:0:1> Time since last save: 0:00:28 ID ALPA Link InForm OS Version 2.3. Command Line Interface Reference ■ InForm OS Version 2.3.1 PrimSeq. Primitive Sequence Protocol Error. There were errors during the transmission of a Fibre Channel primitive sequence. This might indicate an error during the loop recovery or initialization. ■ InvWord. Invalid Transmission Word. Illegal Fibre Channel transmission word received. ■ InvCRC. Invalid Cyclical Redundancy Check. Data corruption in the Fibre Channel frame. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showrcopy DESCRIPTION The showrcopy command displays details of the Remote Copy configuration. SYNTAX The syntax for the showrcopy command can be one of the following: ■ showrcopy [options ] [links] ■ showrcopy [options ] [groups []] ■ showrcopy [options ] [targets []] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Displays more detailed configuration information. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. EXAMPLES The following example displays output from the showrcopy command: cli% showrcopy Remote Copy System Information Status: Started, Normal Target Information Name ID Type Status Options Policy InServ2 9 IP ready mirror_config Link Information Target InServ2 InServ2 receive receive Node 0 1 0 1 Address 10.100.33.11 10. InForm OS Version 2.3.1 Command Line Interface Reference ■ New. Volume is configured, but has not yet been started. ■ Syncing. Volume is currently synchronizing. ■ NotSynced. The volume is not synchronized, likely the result of an initial sync failure or some other failure. ■ Stopped. The volume was synced the last time the group was started, but the group is currently stopped. There might be writes that have not been sent to the secondary site. ■ Stale. Command Line Interface Reference ◆ Starting. Currently attempting to start the group. ◆ Started. Group is started (has Remote Copy running). ◆ Stopped. Group was stopped. ■ Role. The role of the group as either Primary or Secondary. ■ Mode. The mode of the group as either Periodic or Synchronous. ■ Options. The options set for the group. ■ LocalVV and ID. The name and ID of this system. ■ RemoteVV and ID. The name and ID of the target system. ■ SyncStatus. InForm OS Version 2.3.1 Command Line Interface Reference ■ See Help on sub,globpat for information on glob-style patterns. ■ A Domain column may be included by using the setclienv command to set listdom to 1. The -listdom option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable set. See Help on sub,glopat for information on glob-style patterns. Please run cli -h and setclienv -h for details of the environment variables. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showrctransport DESCRIPTION The showrctransport command shows status and information about end-to-end transport for Remote Copy in the system. SYNTAX showcrtransport [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –rcip Show information about Ethernet end-to-end transport. –rcfc Show information about Fibre Channel end-to-end-transport. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3.1 ■ Command Line Interface Reference Peer_Address. IP address of the Remote Copy storage server port connected to this Remote Copy port. ■ Address. IP address of the Remote Copy storage server port. ■ State. Remote copy end-to-end transport state. Can include one of the following results: ◆ new. Configuration is not completed on this port. ◆ incomplete. Configuration is not yet completed on the peer port. ◆ ready. Command Line Interface Reference ■ IPAddress. IP address of the Ethernet port indicated in the N:S:P column. ■ PeerIPAddress. IP address of the peer Ethernet port to which the port indicated in the N:S:P column is connected. ■ Netmask. Netmask for the IP address. ■ Gateway. Address of the gateway. ■ MTU. Maximum Transfer Unit (MTU) size for the specified Remote Copy interface (default is 1500). The largest supported value is 9000 and the smallest is 100. ■ Rate. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showrsv DESCRIPTION The showrsv command displays SCSI reservation and registration information for Virtual Volume Logical Unit Numbers (VLUNs) bound for a specified port. SYNTAX showrsv [options ] [] AUTHORITY Super, Service, Edit, Browse OPTIONS –l Specifies that either SCSI–3 persistent reservation or SCSI–2 reservation information is displayed. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about reservation and registration information for VLUNs bound with host name w2k_emx1_cisco. cli% showrsv –host w2k_emx1_cisco VVname Host Owner w2k_clusterd.10 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd.11 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd.12 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsched DESCRIPTION The showsched command shows the state of tasks currently scheduled on the system. SYNTAX showsched [options][|] AUTHORITY Super, Service OPTIONS -all Specifies that all scheduled tasks will be displayed. -sortcol [,][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None. EXAMPLES The following example displays information of all scheduled tasks. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. SYNTAX showsnmpmgr AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays a list of registered managers: cli% showsnmpmgr Manager IP 82.185.98.76 82.162.9.7 5def:2008:abcd::161a Port 162 8004 9162 In the example above: Host IP. Command Line Interface Reference InForm OS Version 2.3.1 EXIT STATUS The following codes are returned indicating success or failure: ■ 0 indicates that the command was successful. ■ 1 indicates that the command failed. NOTES Managers are registered using the addsnmpmgr command. See addsnmpmgr on page 4.2 for additional information. 22. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. SYNTAX showsnmppw [options] AUTHORITY Super, Edit, Browse OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) password is displayed. If not specified, the read/write community string password is displayed. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 NOTES SNMP passwords are registered using the setsnmppw command. See setsnmppw on page 21.68 for more information. 22. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation. Command Line Interface Reference InForm OS Version 2.3.1 –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed. –ss Specifies the step size in kilobytes using 32 KB to 512 KB. The step size should be a power of 2 and a multiple of 32. If no value is entered, the step size defaults to 256 KB for RAID-0 and RAID-1, and 128 KB for RAID-5. For RAID-6, the default is a function of the set size. InForm OS Version 2.3.1 Command Line Interface Reference –pt - Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–4). The primary path of the disks must be on the specified port(s). –cg
- Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.3.1 –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the estimated free space for a RAID-1 LD: cli% showspace –t r1 --Estimated(MB)--RawFree UsableFree 13824 6912 NOTES ■ The showspace command includes chunklets in the process of being initialized as shown by the Normal, Unused, Uninit column of showpd -c. The space represented by these chunklets will not actually be available until the initialization process is complete. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showspare [-used] DESCRIPTION The showspare command displays information about chunklets in the system that are reserved for spares and previously free chunklets selected for spares by the system. SYNTAX showspare AUTHORITY Super, Service, Edit, Browse OPTIONS -used Show only used spare chunklets. By default all spare chunklets are shown. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3.1 Command Line Interface Reference ■ LdName. The name of the logical disk that is using the spare chunklet. ■ LdCh. The position of the chunklet on the logical disk. ■ State. The state of the chunklet as identified by the kernel. ◆ logging. I/O to the chunklet is written to the logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. Chunklets do not process physical disk errors. ◆ preserved. Command Line Interface Reference ■ InForm OS Version 2.3.1 Sp. The spare status of the chunklet; Y indicates the chunklet is reserved for spare, N indicates a previously free chunklet selected by the system as a spare. ■ Cl. The clean status of the chunklet. N indicates that the chunklet is in-use. Y indicates that the chunklet is clean. Cg indicates that the chunklet is being cleaned. ■ From. The initial location of the chunklet before relocation. ■ To. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsshkey DESCRIPTION The showsshkey command will displays all SSH public keys that have been set with setsshkey. SYNTAX showsshkey AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 NOTES The public SSH keys that are displayed by this command are used to determine that the private keys that are paired with them are valid, and are not useful in determining the contents of that private key. As such, the contents of the public keys are not sensitive, and having access to them will not aid someone attempting to access an account to which they should not have access. 22. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsys DESCRIPTION The showsys command displays the InServ system properties includes system name, model, serial number, and system capacity information, etc. SYNTAX showsys [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that more detailed information about the system is displayed. –param Specifies that the system parameters are displayed. –fan Displays the system fan information. Command Line Interface Reference InForm OS Version 2.3.1 –devtype FC|NL|SSD Displays the system capacity information where the disks must have a device type string matching the specified device type; either Fibre Channel (FC), Nearline (NL), Solid State Drive (SSD). This option can only be issued with the -space option. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference The following example shows system parameters (–param option) for an InServ Storage Server: cli% showsys -param System parameters from configured settings ---Parameter---RawSpaceAlertFC RawSpaceAlertNL RemoteSyslog RemoteSyslogHost SparingAlgorithm CopySpaceReclaim EventLogSize VVRetentionTimeMax : : : : : : : : ---Value---0 0 1 192.168.6.15 Minimal 0 3M 336 Hours NOTES ■ See setsys on page 21. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the startup state information about the system manager. In this example, the system manager reports that it is up and running. InForm OS Version 2.3.1 Command Line Interface Reference If the system has attempted powerfail recovery three times, and during the recovery attempts encountered kernal panics because of hardware or software errors, the following message is displayed. See Notes in the following section for additional information. cli% showsysmgr System is recovering from a previous power failure. Please use the 'showvv', 'showld', 'showpd' CLI commands to check for not started vvs, lds, pds. Command Line Interface Reference InForm OS Version 2.3.1 disks and virtual volumes upon restarting. See setsysmgr on page 21.79 for more information. ■ During powerfail recovery, a kernal panic because of hardware or software errors might indicate a damaged volume. In such cases, after the system restarts, it waits for user intervention. Issue the setsysmgr force_iderecovery command to force the system to start another powerfail recovery. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtarget DESCRIPTION The showtarget command displays information about unrecognized targets. SYNTAX showtarget AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays information about unrecognized targets: cli% showtarget no unknown targets listed In the previous example, there are no unknown targets. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showtask DESCRIPTION The showtask command displays information about tasks. By default, this command displays all non-system tasks on the system within the last 24 hours. SYNTAX showtask [options ] [ | ] AUTHORITY Super, Service, Edit, Browse OPTIONS –all Specifies that all scheduled tasks will be displayed. Unless the -all option is specified, system tasks are not displayed. InForm OS Version 2.3.1 Command Line Interface Reference –d ... Show detailed task status for specified tasks. Tasks must be explicitly specified using their task IDs . Multiple task IDs can be specified. This option cannot be used in conjunction with other options. -sortcol [,][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. Command Line Interface Reference InForm OS Version 2.3.1 ◆ move_regions. Track region move operations (movereg command). ◆ promote_sv. Track virtual copy promotes (promotesv command). Requires a 3PAR Virtual Copy license. ◆ remote_copy_sync. Track Remote Copy volume group synchronizations (syncrcopy and startrcopygroup commands). Requires a 3PAR Remote Copy license. ◆ tune_vv. Track 3PAR System Tuner volume tuning operations (tunealdvv command). Requires a 3PAR Dynamic Optimization license. InForm OS Version 2.3.1 Command Line Interface Reference The following example shows details about a specific task using the task ID (task ID is 3). Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showtemplate DESCRIPTION The showtemplate command displays existing templates that can be used for Virtual Volume (VV), Logical Disk (LD), or Common Provisioning Group (CPG) creation. SYNTAX showtemplate [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –t VV|LD|CPG Specifies that the template type displayed is a VV, LD, or CPG template. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtoc DESCRIPTION The showtoc command displays the system table of contents summary that provides a summary of the system’s resources. SYNTAX showtoc AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the system table of contents. Command Line Interface Reference NOTES None. 22.186 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtocgen DESCRIPTION The showtocgen command displays the table of contents generation number. SYNTAX showtocgen AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showuser DESCRIPTION The showuser command displays information about one or all users, including the username, authority level, and system resources to which a given user has access. The showuser command shows account information for local users (those created with the createuser command) or shows the SSH key information for local and LDAP users (enabled by the setauthparam command). InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES cli% showuser root Username Domain Privilege Default root all super N cli% The previous example indicates user root being a member of all domains. Valid output includes all, or . The columns are identified as follows: ■ Username. Your user name. ■ Domain. The domain to which the user belongs. ■ Privilege. The privilege level required to run the command. ■ Default. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showuseracl DESCRIPTION The showuseracl command displays a user’s access control list (ACL). SYNTAX showuseracl AUTHORITY Super, Edit, Browse, Service OPTIONS None. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showuserconn DESCRIPTION The showuserconn command displays information about users who are currently connected (logged in) to the InServ Storage Server. SYNTAX showuserconn [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -current Shows all information about the current connection only. –sortcol [,][:[,]...] Sorts command output based on column number . Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about user connections: cli% showuserconn Id Name --IP_Addr--- Domain Level ----Connected_since---- Current 23180 root 192.168.17.7 all super 2007/05/31 15:02:53 PDT current --------------------------------------------------------------------1 total The columns in the previous example are identified as follows: ■ Id. Your InServ Storage Server identification number. ■ Name. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showversion DESCRIPTION The showversion command displays information about the storage server software. Use this command to determine if your system is using the latest software version. SYNTAX showversion [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –a Show all component versions. –b Show build levels. –s Show release version number only (useful for scripting). Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays comprehensive information about the system software: cli% showversion Release version 2.3.1.60 (DEVEL) Patches: None Component Name CLI Server CLI Client System Manager Kernel TPD Kernel Code Version 2.3.1 2.3.1 2.3.1 2.3.1 2.3.1 NOTES ■ When displaying all versions, for certain components multiple versions might be installed. In such cases, multiple lines are displayed. ■ 22. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvlun DESCRIPTION The showvlun command displays information about Virtual Volume Logical Unit Numbers (VLUNs) in the system, such as all active and template VLUNs. The display is divided into two sections: the upper provides information about active VLUNs and the lower provides information about VLUN templates. Command Line Interface Reference InForm OS Version 2.3.1 –a Shows only active VLUNs. –t Shows only VLUN templates. -pathsum Shows path summary information for active VLUNs. –host {}... Specifies that only VLUNs exported to hosts that match the hostname or glob-style patterns (see Help on sub,globpat). –v {|}... Requests that only Logical Disks (LD) mapped to VVs that match any of the specified names or patterns be displayed. InForm OS Version 2.3.1 Command Line Interface Reference -domain {}... Shows only the VLUNs whose VVs are in domains with names that match one or more of the options. This option does now allow listing objects within a domain of which the user is not a member. Multiple domain names or patterns can be repeated using a comma-separated list. –sortcol [,][:[,]...] Sorts command output based on column number . Command Line Interface Reference EXAMPLES The following example displays all active and template VLUNs: cli% showvlun Active VLUNs Lun VVname Host ----Host_WWN---- Port Type 0 tpv.0 pe750–07 210000E08B056C21 0:2:1 host 1 tpv.1 pe750–07 210000E08B056C21 0:2:1 host 2 tpv.2 pe750–07 210000E08B056C21 0:2:1 host 3 tpv.3 pe750–07 210000E08B056C21 0:2:1 host 0 tpv.0 pe750–07 210100E08B256C21 1:2:1 host 1 tpv.1 pe750–07 210100E08B256C21 1:2:1 host 2 tpv.2 pe750–07 210100E08B256C21 1:2:1 host 3 tpv. InForm OS Version 2.3.1 Command Line Interface Reference The following example displays all active and template VLUNs using glob-style patterns: cli% showvlun –v *.2,*.3 Active VLUNs Lun VVname Host ----Host_WWN---- Port Type 2 tpv.2 pe750–07 210000E08B056C21 0:2:1 host 3 tpv.3 pe750–07 210000E08B056C21 0:2:1 host 2 tpv.2 pe750–07 210100E08B256C21 1:2:1 host 3 tpv.3 pe750–07 210100E08B256C21 1:2:1 host 2 test.2 sun 210000E08B023F71 0:2:2 host 3 test.3 sun 210000E08B023F71 0:2:2 host 2 test. Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable set. Please run cli -h and setclienv -h for details of the environment variables. ■ 22.200 See Glob-Style Pattern on page 2.4 for more information. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvv DESCRIPTION The showvv command displays information about all Virtual Volumes (VVs) or a specific VV in a system. SYNTAX ■ showvv [options ] [...] ■ showvv -listcols AUTHORITY Super, Service, Edit, Browse OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showvv for help on each column). Command Line Interface Reference InForm OS Version 2.3.1 –d Displays detailed information about the VVs. The following columns are shown: ID, Name, Rd, Mstr, Prnt, Roch, Rwch, PPrnt, PBlkRemain, VV_WWN, CreationTime. –pol Displays policy information about the VV. The following columns are shown: ID, Name, Policies. –s Displays Logical Disk (LD) space use by the VVs. InForm OS Version 2.3.1 Command Line Interface Reference –alert Indicates whether alerts are posted on behalf of the VVs. The following columns are shown: ID, Name, Prov, Type, VSize_MB, Snp_Used_Perc, Warn_Snp_Perc, Limit_Snp_Perc, Usr_Used_Perc, Warn_Usr_Perc, Limit_Usr_Perc, Alert_Adm_Fail_Y, Alert_Snp_Fail_Y, Alert_Snp_Wrn_Y Alert_Snp_Lim_Y, Alert_Usr_Fail_Y, Alert_Usr_Wrn_Y, Alert_Usr_Lim_Y. –alerttime Shows times when alerts were posted (when applicable). Command Line Interface Reference InForm OS Version 2.3.1 –sortcol [,][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:).InForm OS Version 2.3.1 Command Line Interface Reference –host {}... Displays only VVs that are exported as VLUNs to hosts with names that match one or more of the specified or . See Specifiers for additional information on patterns as used with this command. Multiple or specifiers can be repeated using a comma-separated list (for example -host ,...). -baseid {}... Command Line Interface Reference InForm OS Version 2.3.1 -retained Shows only VVs that have a retention time. -failed Shows only failed VVs. The following VV filtering options are deprecated and will be removed in a future release. Instead, use the appropriate -p option described above. -cpg ... Show only VVs whose UsrCPG or SnpCPG matchs the one or more of the or specifier. This option is deprecated without the preceding -p option. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS NOTE: If one or more are specified, then the virtual volumes with names that match any of the patterns are listed. Otherwise, all virtual volumes are listed. The virtual volumes shown include snapshots. Patterns are glob-style (shell-style) patterns (see Help for sub,globpat). ... Command Line Interface Reference InForm OS Version 2.3.1 ◆ tpvv. Thin Provisioned VV, with space for the base volume allocated from the Usr space that is associated with the UsrCPG. Snapshots allocate space from the Snp space associated with the SnpCPG (if any). ◆ cpvv. Commonly Provisioned VV. The Usr space for this VV is fully provisioned and the Snp space is associated with a SnpCPG. ◆ tpsd. An old-style Thin Provisioned VV (created on a 2.2. InForm OS Version 2.3.1 Command Line Interface Reference ◆ started. The virtual volume has been started and is available for use. ◆ started,stl. The virtual volume is stale. ◆ started,cpf. The virtual volume copy or promote has failed. ◆ not_started. The virtual volume has not yet been started (perhaps because one of its underlying logical disks has not yet been started). ◆ pmt. A promote is currently occurring on the base volume. Command Line Interface Reference InForm OS Version 2.3.1 ■ Name. The virtual volume’s name. ■ Rd. The read/write permissions for the volume. Values can be RW (read and write) or RO (read only). ■ Mstr. The master node for the volume responsible for assigning mapping zones. ■ Prnt. The ID of the volume’s parent in the snapshot tree. ■ Roch. The ID of the read only child volume in the snapshot tree. ■ Rwch.The ID of the read write child volume in the snapshot tree. ■ PPrnt. InForm OS Version 2.3.1 ◆ Command Line Interface Reference tpsd. An old-style Thin Provisioned VV (created on a 2.2.4 release or earlier) where both the base VV and snapshot data are allocated from the Snp space associated with the UsrCPG. ◆ snp. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ Adm_Rsvd_MB. Adm (snapshot admin or SA) reserved space in megabytes. ■ Adm_Used_MB. Adm used space in megabytes. ■ Snp_Rsvd_MB. Command Line Interface Reference InForm OS Version 2.3.1 The columns in the previous example are identified as follows: ■ Id. The virtual volume ID. ■ Name. The virtual volume name. ■ Domain. The domain to which the virtual volume belongs. Valid values are – or . If the domain does not exist, - is displayed. The Domain column can be included by using the setclienv command to set listdom to 1. InForm OS Version 2.3.1 Command Line Interface Reference ◆ cpvv. Commonly Provisioned VV. The Usr space for this VV is fully provisioned and the Snp space is associated with a SnpCPG. ◆ tpsd. An old-style Thin Provisioned VV (created on a 2.2.4 release or earlier) where both the base VV and snapshot data are allocated from the Snp space associated with the UsrCPG. ◆ -. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ ■ ■ Type. Command Line Interface Reference ◆ copy_target. The volume is currently the target of a copy. ◆ tuning. The volume is currently tuning. ◆ closing. The volume is currently closing. ◆ removing. The volume is currently removing. ◆ creating. The volume is currently creating. ◆ copy_source. The volume is a copy source. ◆ unknown. The volume state is unknown. InForm OS Version 2.3. InForm OS Version 2.3.1 ◆ Command Line Interface Reference -. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ ■ Type. Indicates the copy type of virtual volume and can be one of the following: ◆ base. Base volume (not a copy). ◆ pcopy. Physical copy (full copy). ◆ vcopy. Snapshot copy (virtual copy). Adm_RawRsvd_MB. Raw (including RAID overhead) Adm reserved space in MB (1024^2 bytes). ■ Adm_Rsvd_MB. Command Line Interface Reference InForm OS Version 2.3.1 ■ Grown_Snp_MB. The amount of snapshot space that the volume has grown. ■ Grown_Snp_SD_MB. The amount of snapshot SD space that the volume has grown. ■ Reclaimed_Adm_MB. The amount of administrator space that the volume has had reclaimed. ■ Reclaimed_Snp_MB. The amount of snapshot space that the volume has had reclaimed. ■ Reclaimed_Snp_SD_MB. The amount of snapshot SD space that the volume has had reclaimed. ■ Name. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvvmap DESCRIPTION The showvvmap command displays information about how Virtual Volume (VV) regions are mapped to logical disks. SYNTAX showvvmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the VV name, using up to 31 characters in length. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 The columns in the previous example are identified as follows: ■ Space. The type of the space (user (usr), snapshot data (snp), or snapshot administration (adm) for which the region is being used followed by the ID of the region. The number to the right of the space type are the chunklets for each space. ■ Start(MB). The offset from the beginning of the region, in MB. ■ Length(MB). The length, or size, of the region in MB. ■ LdId. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvvpd DESCRIPTION The showvvpd command displays Virtual Volume (VV) distribution across Physical Disks (PDs). SYNTAX showvvpd [option ] {}... AUTHORITY Super, Service, Edit, Browse OPTIONS –sortcol [,][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about multiple VVs. In this case multi.0, multi.1, multi.2 and multi.3 were created using the -cnt 4 option. Using multi.*, the aggregate chunklets for all the physical disks is displayed: cli% showvvpd multi. InForm OS Version 2.3.1 Command Line Interface Reference For the example above, if you only specified a single volume you would get the same result. That is because the four VVs are interleaved across the same logical disks and share the same chunklets. The following example displays the distribution of space for a single VV (multi.0): cli% showvvpd multi. Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference for all the VVs that match the or list. This can be useful in determining how evenly the VV is striped across the disks. ■ Not all the data in the chunklets is necessarily allocated exclusively to the selected VV. In some cases, only part of a chunklet could be data that is allocated for the VVs. 22. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showvvset DESCRIPTION The showvvset command lists the Virtual Volume (VV) sets defined on the InServ and their members. SYNTAX showvvset [options] [...] showvvset -vv [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -vv Show VV sets that contain the supplied vvnames or patterns SPECIFIERS ... InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES To show all VV sets defined to the system: cli% showvvset Id Name Members 0 oravv oravv.0 oravv.1 oravv.2 oravv.3 oravv.4 oravv.5 oravv.6 oravv.7 oravv.8 oravv.9 20 sia-1 test ttpvv.rw test-sv bar Show the sia-1 set only, with detail: cli% showvvset -d sia-1 20 sia-1 test This set has a comment ttpvv.rw test-sv bar Show VV sets containing VVs matching test*: cli% showvvset -vv test* Id Name Members 20 sia-1 test ttpvv. Command Line Interface Reference 22.226 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 23 Shutdown Commands In this chapter shutdownnode 23.2 shutdownsys 23.4 Shutdown Commands 23. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Forces the operation so that the command does not require confirmation before proceeding. SPECIFIERS Specifies the node, identified by its ID, to be shut down. InForm OS Version 2.3.1 ■ Command Line Interface Reference If any of the following conditions exists, the shutdown operation will not proceed: ◆ The system software upgrade is in progress. ◆ The target node is not online. ◆ The system is processing tasks that should not be interrupted, such as tunevv and remote copy related tasks. ◆ If any other node is online but not yet integrated into the cluster. ◆ If another shutdown node operation is already in progress. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND shutdownsys DESCRIPTION The shutdownsys command shuts down an entire system. SYNTAX shutdownsys halt|reboot AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the system should be halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the system should be restarted after shutdown. InForm OS Version 2.3. Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ The execution of shutdownsys command can affect service. Hence, a confirmation is required before proceeding with this command. ■ After the shutdownsys command is issued, there is no indication from the CLI that the shutdown is occurring. You can issue the showsys command (showsys on page 22.171) to display the current status of the system during the initial stage of the shutdown process and after the system has fully restarted. InForm OS Version 2.3.1 Command Line Interface Reference 24 Start Commands In this chapter startcim 24.2 startld 24.3 startrcopy 24.4 startrcopygroup 24.5 starttask 24.7 startvv 24.8 Start Commands 24. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startcim DESCRIPTION The startcim command starts the CIM server to service CIM requests. By default, the CIM server is not started until this command is issued. SYNTAX startcim AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS Access to all domains is required to run this command. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND startld DESCRIPTION The startld command starts data services on a Logical Disk (LD) that has not yet been started. SYNTAX startld [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the LD is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the LD name, using up to 31 characters. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startrcopy DESCRIPTION The startrcopy command starts the Remote Copy Service. SYNTAX startrcopy AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND startrcopygroup DESCRIPTION The startrcopygroup command enables Remote Copy for the specified Remote Copy volume group. SYNTAX startrcopygroup [options ] AUTHORITY Super, Edit OPTIONS –nosync Prevents the initial synchronization and sets the virtual volumes to a synchronized state. –wait Specifies that the command waits until the initial synchronization is completed. Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ If a group’s target has the mirror_config policy set and the group is a primary group, then this command is mirrored to that target and the corresponding secondary group is started. If the policy is set and the group is a secondary, then this command fails. ■ If the mirror_config policy is not set, then the corresponding secondary group must already be started or this command fails. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND starttask DESCRIPTION The starttask command provides users with the ability to execute commands with long running times. The commands run in the background. SYNTAX starttask AUTHORITY Super, Service OPTIONS None. SPECIFIERS Specifies the command to be run by the starttask command. RESTRICTIONS None. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startvv DESCRIPTION The startvv command starts data services on a Virtual Volume (VV) that has not yet been started. SYNTAX startvv [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the logical disk is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the VV name, using up to 31 characters. InForm OS Version 2.3.1 Command Line Interface Reference 25 Stat Commands In this chapter statch 25.2 statcmp 25.7 statcpu 25.10 statiscsi 25.12 statiscsisession 25.16 statld 25.18 statlink 25.23 statpd 25.25 statport 25.33 statrcopy 25.39 statvlun 25.42 statvv 25.48 Stat Commands 25. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statch DESCRIPTION The statch command displays chunklet statistics in a timed loop. SYNTAX statch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. –filt Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , , are filtered out and not displayed. Command Line Interface Reference InForm OS Version 2.3.1 The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays the collection of statistics: cli% statch -iter 1 12:47:54 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Ldid Ldname LdCh Pdid PdCh Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg ----------------------------------------------------------------------------------------total t 0 0 0 0 0.0 0.0 0.0 0. Command Line Interface Reference ■ Qlen. The queue length. ■ Util % Cur. The percentage of current use. ■ Util % Avg. The percentage of average use. InForm OS Version 2.3.1 NOTES ■ For this command: KB = 1000 bytes. ■ If no options are used, the command defaults to show reads, writes, and totals separately for all chunklets in intervals of 2 seconds. ■ The statch command can only be used after the setstatch command has been issued to enable chunklet statistics. See page 21. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statcmp DESCRIPTION The statcmp command displays Cache Memory Page (CMP) statistics by node or by Virtual Volume (VV). SYNTAX statcmp [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Specifies that CMP statistics by VV instead of by node are displayed. By default, all VVs are displayed unless the –n option is specified. Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None. InForm OS Version 2.3.1 Command Line Interface Reference ■ WrtSched. Number of pages scheduled to be written to disk. ■ Writing. Number of pages being currently written by the flusher to disk. ■ RecFlush. During node down, number of recovered pages currently being written by the flusher to disk. ■ LockBlk. Number of pages being modified by host I/O that are temporarily blocked because page is being written to disk by the flusher. NOTES ■ Patterns are specified as regular expressions. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statcpu DESCRIPTION The statcpu command displays CPU statistics for all nodes. SYNTAX statcpu [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays two iterations of CPU statistics for all nodes: cli% statcpu –iter 2 15:11:03 node,cpu user sys idle intr/s ctxt/s 0,0 0 0 100 0,1 0 0 100 0,total 0 0 100 162 412 1,0 0 1 99 1,1 0 1 99 1,total 0 1 99 158 Press the enter key to stop... 15:11:05 node,cpu 0,0 0,1 0,total user sys 0 0 19 7 10 4 1,0 0 0 1,1 0 0 1,total 0 0 Press the enter key 269 idle intr/s ctxt/s 100 74 87 183 444 100 100 100 158 to stop... Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statiscsi DESCRIPTION The statiscsi command displays the iSCSI statistics. SYNTAX statiscsi [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included. InForm OS Version 2.3.1 Command Line Interface Reference This option cannot be used with the -prot option. If the -fullcounts option is not specified, the metrics from the start of the command are displayed. -prot [,,...] Shows the statistics for the specified protocols. The available protocols are: ◆ Eth - Ethernet. ◆ IP - Internet Protocol (IP). ◆ TCP - Transmission Control Protocol (TCP). ◆ iSCSI - iSCSI. ◆ all - All protocols (default). Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays basic iSCSI statistics collection: cli% statiscsi 16:37:59 04/06/06 ----Receive---- ---Transmit---- -----Total----port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/s 0:4:1 Eth 15633.2 1116.7 30115.9 45164.4 45749.1 46281.1 0.0 0:4:1 IP 15632.7 522.6 30116.4 44020.8 45749.1 44543.3 0.0 0:4:1 TCP 15632.7 22.3 30116.4 43057.0 45749.1 43079.4 0.0 0:4:1 iSCSI 547.7 0.0 1477.3 50452.8 2025.0 50452. InForm OS Version 2.3.1 Command Line Interface Reference NOTES The statistics for the TCP, IP, and iSCSI protocols listed are the combined values for both ports of the HBA. Each port reports the combined stats for both ports for these protocols. The total reported at the bottom for these protocols is therefore twice the actual values. 25. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statiscsisession DESCRIPTION The statiscsisession command displays the iSCSI session statistics. SYNTAX statiscsisession [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined number of iterations. -nodes List of nodes for which the ports are included. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the session statistics for the iSCSI: cli% statiscsisession 15:31:35 04/04/06 --From start of statiscsisession command------PDUs/s---- --KBytes/s--- ----Errs/s---port ----------------------iSCI_Name---------------------- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut 1:3:1 iqn.1991-05.com.microsoft:dt-ashok-xp.hq.3pardata.com 131 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statld DESCRIPTION The statld command displays read/write (I/O) statistics about Logical Disks (LDs) in a timed loop. SYNTAX statld [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -vv {}... Show only LDs that are mapped to Virtual Volumes (VVs) with names matching any of names or patterns specified. InForm OS Version 2.3.1 Command Line Interface Reference –begin Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Specifies the percent of idle columns in the output. –sortcol [,][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. You must specify a column number.Command Line Interface Reference InForm OS Version 2.3.1 The operation argument can be specified with one of the following arguments: r Specifies that read-only statistics are displayed. w Specifies that write-only statistics are displayed. t|rw Specifies that statistics for read and write totals are displayed. The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed. InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS ... Only statistics are displayed for the specified LD or pattern. Multiple LDs or patterns can be repeated (for example ...). RESTRICTIONS None. EXAMPLES The following example displays one iteration of I/O statistics for all LDs: cli% statld -iter 1 13:03:04 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Ldname Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg log0. Command Line Interface Reference ■ Svt ms Max. The maximum service time in milliseconds. ■ Svt ms Cur. The current service time in milliseconds. ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. ■ Util % Cur. The percentage of current use. ■ Util % Avg. The percentage of average use. InForm OS Version 2.3.1 NOTES ■ For this command: KB = 1000 bytes. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statlink DESCRIPTION The statlink command displays statistics for link utilization for all nodes in a timed loop. SYNTAX statlink [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays one iteration of statistics for the internode link: cli% statlink –iter 1 11:37:28 03/11/08 XCB_sent_per_second KBytes_per_second XCBSz_KB Node Q ToNode Cur Avg Max Cur Avg Max Cur Avg 0 CM 0 15134 14911 15134 61951 61038 61951 4.1 4.1 0 PCI0 0 22336 21852 22336 79831 77128 79831 3.6 3.5 0 PCI1 1 15312 12103 19805 62106 63198 77324 4.0 4.1 0 L0 1 10339 10307 10339 69673 69384 69673 6.7 6.7 1 1 1 1 NOTES None. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statpd DESCRIPTION The statpd command displays the read/write (I/O) statistics for physical disks in a timed loop. SYNTAX statpd [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –w Specifies that statistics for a particular Physical Disk (PD) identified by World Wide Names (WWNs) are displayed. –nodes Specifies that the display is limited to specified nodes and PDs connected to those nodes. Command Line Interface Reference InForm OS Version 2.3.1 –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. InForm OS Version 2.3.1 Command Line Interface Reference The type argument can be specified with one of the following arguments: curs Specifies that only devices with current statistics above the threshold are displayed. avgs Specifies that only devices with average statistics above the threshold are displayed. maxs Specifies that only devices with maximum values above the threshold are displayed. Command Line Interface Reference InForm OS Version 2.3.1 size Specifies that statistics for I/O operations in bytes are displayed. [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. The integer can be optionally followed with k or K to indicate a multiple of 1,000, m or M to indicate a multiple of 1,000,000, or g or G to indicate a multiple of 1,000,000,000. InForm OS Version 2.3.1 Command Line Interface Reference –pt - Specifies one or more ports. Ports are identified by one or more integers (
- ). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–4). The primary path of the disks must be on the specified port(s). –cg
- Specifies one or more drive cages. Drive cages are identified by one or more integers (
- ). Multiple drive cages are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.3.1 –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays one iteration of I/O statistics for all PDs: cli% statpd -iter 1 16:03:44 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Pdid Port Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg 0 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 1 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 2 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 4 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0. Command Line Interface Reference ■ KBytes per Max. The maximum number of KB per second. ■ KBytes per Cur. The current number of KB per second. ■ KBytes per Avg. The average number of KB per second. ■ Svt ms Max. The maximum service time in milliseconds. ■ Svt ms Cur. The current service time in milliseconds. ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. ■ Util % Cur. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statport DESCRIPTION The statport command displays read/write (I/O) statistics for ports. SYNTAX statport [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –both|–ctl|–data Show data transfers only (–data), control transfers only (–ctl), or both data and control transfers (–both). If no option is included on the command line, the command shows data transfers only. Command Line Interface Reference InForm OS Version 2.3.1 –host|-disk|-rcfc Specifies to display only host ports (target ports), only disk ports (initiator ports), or only Fibre Channel Remote Copy configured ports. If no option is specified, all ports are displayed. –rcip Includes only statistics for Ethernet configured Remote Copy ports. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. InForm OS Version 2.3.1 Command Line Interface Reference –filt Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The –filt option applies to data transfers only. The , , , and arguments are separated with one comma. Command Line Interface Reference InForm OS Version 2.3.1 bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. svct Specifies that statistics for service time in milliseconds are displayed. size Specifies that statistics for I/O operations in bytes are displayed. [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays one iteration of I/O statistics for all ports: cli% statport -iter 1 10:38:56 09/14/09 r/w I/O per second KBytes per sec Svt ms IOSz KB Port D/C Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen 0:0:1 Data t 2 2 2 34 34 34 13.0 13.0 17.4 17.4 0 0:0:2 Data t 0 0 0 4 4 4 8.2 8.2 8.2 8.2 0 0:2:1 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0:2:2 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0:3:1 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0. Command Line Interface Reference ■ Errs. Number of errors on the port. ■ Drops. Number of dropped packets. InForm OS Version 2.3.1 NOTES 25.38 ■ For this command: KB = 1000 bytes. ■ The -filt option applies only to data transfers and not control transfers. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statrcopy DESCRIPTION The statrcopy command displays statistics for Remote Copy links. SYNTAX statrcopy [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example shows statistics for sending links link0 and link1: cli% statrcopy 17:37:01 05/17/07 -Throughput(KBytes per sec)Target Node Address IPC Total(KBytes) Current Average --------------------------------------------------------------------------amp1 0 10.100.33.96 RCs041 404761.15 4.95 4.95 amp1 1 10.101.33.96 RCs142 404661.63 3.30 3.30 --------------------------------------------------------------------------amp1 809422. InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ This command repeats until directed to stop. ■ Within the context of this command, KB is 1000 bytes, MB is 1000KB, and GB is 1000MB. ■ The numbers displayed by this command might be somewhat less than those displayed with statport, as statrcopy output does not include TCP/IP overhead 25. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statvlun DESCRIPTION The statvlun command displays statistics for Virtual Volumes (VVs) and Logical Unit Number (LUN) host attachments. SYNTAX statvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only Virtual Volume Logical Unit Number (VLUNs) whose VVs are in domains with names that match one or more of the specified domain names or patterns. InForm OS Version 2.3.1 Command Line Interface Reference (1,2,3). The list can also consist of a single integer (1). If the node_list is not specified, all disks on all nodes are displayed. –slots Specifies that the display is limited to specified PCI slots and PDs connected to those PCI slots. The slot_list is specified as a series of integers separated by commas (1,2,3). The list can also consist of a single integer (1). Command Line Interface Reference InForm OS Version 2.3.1 –iter Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647. –begin Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Includes a percent idle columns in the output. –sortcol [,][:[,]... InForm OS Version 2.3.1 Command Line Interface Reference maxs Specifies that only devices with maximum values above the threshold are displayed. The argument can be specified with one of the following arguments: r Specifies that read-only statistics are displayed. w Specifies that write-only statistics are displayed. t|rw Specifies that statistics for read and write totals are displayed. Command Line Interface Reference InForm OS Version 2.3.1 –ni Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS None. RESTRICTIONS None. InForm OS Version 2.3.1 ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. Command Line Interface Reference NOTES ■ For this command: KB = 1000 bytes. ■ A Domain column may be included by using the setclienv command to set listdom to 1. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statvv DESCRIPTION The statvv command displays statistics for Virtual Volumes (VVs) in a timed loop. SYNTAX statvv [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only the VVs that are in domains with names that match the specified domain names or patterns. –rw Specifies that the display includes separate read and write data. InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:) Rows with the same information in them as earlier columns will be sorted by the values in the later columns. –filt Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. Command Line Interface Reference InForm OS Version 2.3.1 The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the value argument. bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the value argument. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays I/O statistics for all VVs: cli% statvv -iter 1 15:31:21 05/31/07 r/w I/O per second KBytes per sec Svt ms IOSz KB VVname Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen admin t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 test2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 -----------------------------------------------------------------------total t 0 0 0 0 0.0 0.0 0.0 0. Command Line Interface Reference ■ InForm OS Version 2.3.1 In addition to external accesses by hosts, VVs may be read internally by the system readahead prefetcher. The histvv data includes read-ahead accesses from the prefetcher, which can cause the read data to appear more than seen by the hosts. Use the histvlun -vvsum command to see data for only accesses from the host. ■ 25.52 For this command KB = 1000 bytes. InForm OS Version 2.3.1 Command Line Interface Reference 26 Stop Commands In this chapter stopcim 26.2 stoprcopy 26.4 stoprcopygroup 26.6 Stop Commands 26. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. SYNTAX stopcim [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation. InForm OS Version 2.3.1 Command Line Interface Reference The following example stops the CIM server immediately without graceful shutdown notice and confirmation: cli% stopcim -f -x CIM server stopped successfully. NOTES By default, the CIM server is not started until the startcim command is issued. 26. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stoprcopy DESCRIPTION The stoprcopy command stops the Remote Copy service and optionally stops any started Remote Copy volume groups. AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. SYNTAX stoprcopy [options] OPTIONS –f Specifies that any started copy will not ask for confirmation for the -clear option. –stopgroups Specifies that any started Remote Copy volume groups are stopped. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example disables the Remote Copy functionality of all primary Remote Copy volume groups: cli% stoprcopy –stopgroups NOTES ■ Unless the -stopgroups option is used, the command will fail if there are any Remote Copy groups that are started. If the -clear option has been used, the configuration is completely erased. Consequently, Remote Copy operations can not be restarted using only the startrcopy command. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stoprcopygroup DESCRIPTION The stoprcopygroup command stops the Remote Copy functionality for the specified Remote Copy volume group. SYNTAX stoprcopygroup [options] AUTHORITY Super, Edit OPTIONS –nosnap In synchronous mode, this option turns off the creation of snapshots. This is useful if removercopygroup is to be run to remove Remote Copy. InForm OS Version 2.3.1 Command Line Interface Reference NOTES In sync mode, this command creates snapshots that are used for synchronizing the primary and secondary groups if startrcopygroup is run later. 26. Command Line Interface Reference 26.8 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 27 Sync Command In this chapter syncrcopy 27.2 Sync Command 27. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND syncrcopy DESCRIPTION The syncrcopy command manually synchronizes Remote Copy volume groups. SYNTAX syncrcopy [options] AUTHORITY Super, Edit OPTIONS –w Wait for synchronization to complete before returning to a command prompt. –n Do not save resynchronization snapshot. This option is only relevant for asynchronous periodic mode volume groups. NOTE: Using the -n option requires a full synchronization at the next sync. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. ■ Using the -n option requires a full synchronization at the next sync. Command Line Interface Reference 27.4 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 28 Tune Commands In this chapter tunealdvv 28.2 tunepd 28.10 tunetpvv 28.15 tunevv 28.18 Tune Commands 28. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunealdvv DESCRIPTION This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the tunevv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The tunealdvv command changes the layout of a virtual volume. InForm OS Version 2.3.1 Command Line Interface Reference OPTIONS The following options can be used on all commands: –f Forces the command. The command completes without prompting for confirmation. –waittask Specifies that the command will wait for any created tasks to complete. The following options cannot be used with the restart or rollback subcommands: –cpg Name of the Common Provisioning Group (CPG) to which the snapshot data space is moved. Command Line Interface Reference InForm OS Version 2.3.1 –ss Specifies the step size from 32 KB to 512 KB. The step size should be a power of 2 and a multiple of 32. If no value is entered, the step size defaults to 256 KB for RAID-0 and RAID-1, and 128 KB for RAID-5. For RAID-6, the default is a function of the set size. –ha port|cage|mag Specifies that the layout must support the failure of one port pair, one cage, or one drive magazine (mag). This option has no meaning for RAID-0. InForm OS Version 2.3.1 Command Line Interface Reference –pt - Specifies one or more ports. Ports are identified by one or more integers (
- ). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–5). The primary path of the disks must be on the specified port number(s). –cg
- Specifies one or more drive cages. Drive cages are identified by one or more integers (
- ). Multiple drive cages are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.3.1 –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. InForm OS Version 2.3.1 Command Line Interface Reference –wait If the tunealdvv command fails due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately. If this option is not used, the command will keep waiting for dirty chunklets to be cleaned if enough space will be available with the dirty chunklets cleaned. Command Line Interface Reference ■ InForm OS Version 2.3.1 This command requires sufficient available physical space, equivalent to the user size of the volume being tuned. ■ When changing the layout of a virtual volume, you can optionally apply arguments originally defined for logical disk creation through the createtemplate command by issuing the tunealdvv -templ command. The -templ option is only valid for logical disk template object types. InForm OS Version 2.3.1 Command Line Interface Reference cli% canceltask 1 Are you sure you want to cancel task 1? select q=quit y=yes n=no: y cli% tunealdvv –restart testvol Task 2 started. NOTES ■ This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the tunevv command in the future. ■ Automatic chunklet selection for relocations will prefer selection of chunklets on physical disks with the same device type as the source. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunepd DESCRIPTION The tunepd command identifies physical disks with high service times and optionally executes load balancing. SYNTAX The syntax for the tunepd command can be one of the following: ■ tunepd [options ] maxsvct |highest ■ tunepd [options ] avgsvct |highest AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference –ports Specifies that the display is limited to specified port slots and physical disks connected to those port slots. The port list is specified as a series of integers separated by commas (1,2,3). A list can also consist of a single integer (1). If the port list is not specified, all disks on all ports are displayed. Command Line Interface Reference InForm OS Version 2.3.1 –maxpd Specifies that only the indicated number of physical disks with high service times are displayed. If this option is not specified, 10 PDs are displayed. –movech auto|manual Specifies that if any disks with unbalanced loads are detected that chunklets are moved from those disks for load balancing. auto Specifies that the system chooses source and destination chunklets. InForm OS Version 2.3.1 ■ Command Line Interface Reference Use the –chstat force option only when you have verified that no other tunepd processes are running. EXAMPLES In the following example, PDs with average service times exceeding 50 milliseconds are identified and their chunklets automatically relocated to rebalance the PDs’ load. cli% tunepd –vvlayout –chstat –movech auto avgsvct 50 Collecting I/O statistic for physical disks (PDs) ... Command Line Interface Reference InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference COMMAND tunetpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the tunevv command in the future. If Virtual Volumes (VVs) were created with deprecated commands then only deprecated commands can be used to modify VVs. The tunetpvv command allows the RAID and Availability characteristics of an exiting Thin Provisioned Virtual Volume (TPVV) to be dynamically modified. Command Line Interface Reference InForm OS Version 2.3.1 –dr Specifies that the command is a dry run and that no logical disks or Virtual Volumes (VVs) are actually tuned. –cnt Specifies the number of identical VVs to tune using an integer from 1 through 999. The default will tune one VV. The following option is only used for tuning a legacy single-space TPVV: –cpg Specifies the CPG to which the snapshot data space is moved. This option is not valid with either subcommands. InForm OS Version 2.3.1 Command Line Interface Reference The following example shows how to use the tunetpvv command to increase the availability level of a TPVV (testvol). Note that there is mag availability because testvol was originally on cpg1, which is created with option (–ha mag). To increase cage availability, create a CPG with cage availability and tune testvol to the associated CPG. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with either the createvv or createtpvv command by associating it with a different Common Provisioning Group. InForm OS Version 2.3.1 Command Line Interface Reference rollback Returns to a previously issued tunevv operation call that was interrupted. The canceltask command needs to run before the rollback. This cannot be used on Thinly Provisioned Virtual Volumes. OPTIONS –f Forces the command. The command completes without prompting for confirmation. –waittask Specifies that the command will wait for any created tasks to complete. Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES In the following example, the LDs used for user space are moved to CPG cpg_sn1.0_p for VV nf_st_tp_22.0: cli% tunevv usr_cpg cpg_sn1.0_p nf_st_tp_22.0 Task 999 started NOTES When canceling a tunevv command task, the canceltask command can return before a cancellation is completed. Therefore, resources reserved for the task might not be immediately available. This can prevent actions such as restarting the canceled tunevv command task. InForm OS Version 2.3.1 Command Line Interface Reference 29 Update Commands In this chapter updatesnapspace 29.2 updatevv 29.4 Update Commands 29. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND updatesnapspace DESCRIPTION The updatesnapspace command starts a non-cancelable task to update the snapshot space usage accounting. The snapshot space usage displayed by showvv -snapspace is not necessarily the current usage and the TimeCalculated column will show when it was last calculated. This command causes the system to start calculating current snapsnot space usage. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the actual snapshot space used by all VVs: cli% updatesnapspace Task 2 has been started to calculate actual space usage. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND updatevv DESCRIPTION The updatevv command updates a snapshot Virtual Volume (VV) with a new snapshot. SYNTAX updatevv [options] ... AUTHORITY Super, Edit, Browse OPTIONS –ro Specifies that if the specified VV () is a read/write snapshot the snapshot’s read-only parent volume is also updated with a new snapshot if the parent volume is not a member of a virtual volume set. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the snapshot update of snapshot VV avvro: cli% updatevv –f avvro Updating VV avvro NOTES ■ The updatevv command attempts to use the same VV IDs for new snapshots as the snapshots that they replace so that the new VV have the same World Wide Names (WWNs) as the originals (this might be important for hosts using the VV WWN to identify the VV). Command Line Interface Reference 29.6 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 30 Upgrade Commands In this chapter upgradecage 30.2 upgradepd 30.4 Upgrade Commands 30. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND upgradecage DESCRIPTION The upgradecage command downloads new firmware into the specified cage. SYNTAX The syntax for the upgradecage command can be one of the following: ■ upgradecage [options ] ... ■ upgradecage [options ] -a AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. InForm OS Version 2.3.1 Command Line Interface Reference –file Use firmware in file , where is the full path name of the file on the node. The default is to use the firmware that is marked current in the firmware database (see the showfirmwaredb command). –minlevel Minimum firmware level that the cage firmware must be at for the upgrade to be allowed. This option is deprecated and will be removed in a future release. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND upgradepd DESCRIPTION The upgradepd command upgrades the Physical Disk (PD) firmware. SYNTAX upgradepd [-f] [-skiptest] {-a | -w ... | ...} AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Upgrades the PD firmware without requiring confirmation. –skiptest Skips the 10 second diagnostic test normally completed after each PD upgrade. InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the upgrade of all PDs: cli% upgradepd –a NOTES ■ PDs can be upgraded while I/O is occurring. ■ If a disk with RAID-0 chunklets is upgraded, I/O to those chunklets at the time of the upgrade results in data loss. This is not applicable to other RAID types. ■ Specify the –w option when upgrading unadmitted PDs. 30. Command Line Interface Reference 30.6 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference 31 Wait Command In this chapter waittask 31.2 Wait Command 31. Command Line Interface Reference InForm OS Version 2.3.1 COMMAND waittask DESCRIPTION The waittask command asks the CLI to wait for a task to complete before proceeding. The command automatically notifies you when the specified task is finished. SYNTAX The syntax for the waittask command can be one of the following: waittask –v waittask [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Displays the detailed status of the task specified by as it executes. InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example shows how to wait for a task using the task ID. When successful, the command returns only after the task is complete. cli% waittask 1 Task 1 done NOTES ■ See the InForm OS CLI Administrator’s Manual for additional information and examples regarding task management and task management commands. ■ This command returns an error if any of the tasks it is waiting for fail. 31. Command Line Interface Reference 31.4 InForm OS Version 2.3. InForm OS Version 2.3.1 Command Line Interface Reference Index . . . (ellipsis), multiuse option specifier 2.2 admitrcopyvv 5.10 () (parentheses), grouped elements 2.2 alerts removing from system 19.3 [] (brackets) optional elements 2.2 service, registered SNMP software for 22.155 | (vertical bar), or option specifier 2.2 system A removing preregistered SNMP software 19.24 access status of 22.4 status of, setting 21.3 user information about 22.186 using addsnmpmgr for 4.2 active VLUN 22. Command Line Interface Reference InForm OS Version 2.3.1 C clusters, shutting down 23.4 cages, new firmware, downloading into 30.2 cmd (command) operations 2.2 cancel command See also specific commands (cancel*) canceltask 6.2 CBIOS version 3.10 chapters, overview of 1.4 characters, length limits 2.3 check commands See also specific commands (check*) syntax for 2.3 command (cmd). See cmd (command) command line interface (CLI). See CLI (command line interface) commands 7.1 startrcopygroup 26. InForm OS Version 2.3.1 link to remote storage server 5.6 create commands See also specific commands (create*) createald 11.3 createaldvv 11.9 createavv 11.18 Command Line Interface Reference D data services starting on logical disk 24.3 virtual volume, starting 24.7, 24.8 databases, current firmware levels, displaying 22.45 date and time createcpg 11.22, 11.30 for system nodes 22.33 createdomain 11.30 setting nodes 21.27 creategroupsv 11.34 definitions, removing 12.2 creategroupvvcopy 11. Command Line Interface Reference InForm OS Version 2.3.1 virtual volumes, mapping information 22.115 replacing 10.5 controlling 10.9 firmware dismiss command 12.1 levels of 22.45 See also specific commands (dismiss*) new, downloading into cages 30.2 physical disks, upgrading 30.4 dismisspd 12.2 specific cages, downloading into 30.2 dismissrcopylink 12.3 dismissrcopytarget 12.5 freespace 13.2 dismissrcopyvv 12.6 G display group configuration details 22.143 add virtual volume to 5. InForm OS Version 2.3.1 Command Line Interface Reference for ports 15.18 create to remote storage server 5.6 physical disks, of 15.10 remove 12.3 VLUNs 15.23 link utilization statistics 25.23 histpd 15.10 LIP 10.10 histport 15.18 locate command histvlun 15.23 See also specific commands (locate*) histvv 15.28 locatecage 16.2 host name, length limit 2.3 locatesys 16.4 host sees VLUN template 11.79 logical disk name, length limit 2.3 hosts logical disks creating new system 11. Command Line Interface Reference InForm OS Version 2.3.1 movechtodomain 17.18 SNMP removing access 19.26 movechtospare 17.6 updating access 21.68 movepdtospare 17.9 moverelocpd 17.12 moving chunklet lists 17.2 persistent repository 22.173 physical disks 12.2, 17.6, 17.9 allocatable, marking as 21.53 moving domains 17.18 displaying mapping information 22.14 moving physical disks to spare 17.6, 17.9 firmware, upgrading 30.4 multiuse option specifier. See . . . InForm OS Version 2.3.1 Command Line Interface Reference related documents 1.3 removevlun 19.39 Remote Copy 26.4 removevv 19.43 enable 24.4 ports 10.9 stop 26.6 remove group 19.18 removing hosts 19.12 removing users 19.35 removing virtual volumes 19.43 replacing drive magazines or disk drives 10.5 link 12.3 revision history RH.1 target designation 19.20 RSCN 10.10, 22.124 virtual volume from group 12.6 rules, syntax 2.3 remove commands See also specific commands (remove*) removealert 19. Command Line Interface Reference setcpg 21.20 setdate 21.27 IX.8 InForm OS Version 2.3.1 show commands See also specific commands (show*) setdomain 21.31, 21.33 showalert 22.4 setdomainset 21.33 showauthparam 22.6 sethost 21.35 showbattery 22.8 sethostset 21.39 showblock 22.14 setlicense 21.39, 21.40 showcage 22.17 setnet 21.42 showcim 22.23 setnode 21.47 showclienv 22.25 setntp 2.5 to 2.6, 21.49 showcpg 22.26 setpassword 21.51 showdate 22.33 setpd 21.53 showdomain 22. InForm OS Version 2.3.1 showpdvv 22.115 showport 22.119 Command Line Interface Reference shutdown commands See also specific commands (shutdown*) showportarp 22.130 shutdownnode 23.2 showportdev 22.132 shutdownsys 23.4 showportisns 22.135 shutting down system nodes 23.2 showportlesb 22.137 snapshot volumes (copies), creating 11.58 showrcopy 22.143 SNMP access showrctransport 22.148 showrsv 22.151 showsched 22.153 showsnmpmgr 22.155 removing passwords for 19.26 updating 21. Command Line Interface Reference InForm OS Version 2.3.1 statcmp 25.7 stoprcopy command 22.144 statcpu 25.10 stoprcopygroup 26.6 statiscsi 25.12 storage server, information about 22.191 statiscsisession 25.16 subcmd (subcommand) operations 2.2 statistics subcommand (subcmd). See subcmd (subcommand) cache memory page 25.7 chunklet collection mode 21.72, 21.74 sync command 27.1 to 27.3 See also specific commands (sync*) chunklets, timed loop display 25.2 CPU, for all nodes 25. InForm OS Version 2.3.1 templates creating 11.61 Thinly Provisioned Virtual Volume (TPVV), length limit 2.3 time and date for system nodes 22.33 setting nodes 21.27 traps removing preregistered SNMP software 19.24 using addsnmpmgr for 4.2 tunealdvv 28.2 tunepd 28.10 Command Line Interface Reference of virtual volumes 7.13 VCN 10.10, 22.124 verifying controlport command success 10.18 physical disk admittance 5.5 physical disk status 21.54 vertical bar (|), or option specifier 2. Command Line Interface Reference InForm OS Version 2.3.1 host sees 11.79 template 22.193 matched set 11.79 template conflicts in 11.42 port presents 11.79 voltage status 22.87 VLUNs active 22.193 W deleting 19.39 wait command information about 22.193 of virtual volumes, creating 11.79 service time, histograms of 15.23 IX.12 Index See also specific commands (wait*) waittask 31. InForm OS Version 2.3.1 Command Line Interface Reference Revision History Release Level Revision Summary 320–200166 Rev A October 2009 First release of this manual to support initial release of the 2.3.1 InForm OS. 320-200166 Rev B March 2010 Second release of this manual to support the 2.3.1 MU1 InForm OS release. Revision History RH. Command Line Interface Reference RH.2 Revision History InForm OS Version 2.3. |