® 3PAR InForm OS 2.2.4 Command Line Interface Reference 3PAR, Inc. 4209 Technology Drive Fremont, CA 94538 USA Part No.
Revision Notice This is the first release of this manual. A complete revision history is provided at the end of this manual. Changes The material in this document is for information only and is subject to change without notice. While reasonable efforts have been made in the preparation of this document to assure its accuracy, 3PAR Inc. assumes no liability resulting from errors or omissions in this document or from the use of the information contained herein. 3PAR Inc.
All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the University of California, Berkeley and its contributors. 4 Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. Copyright (c) 1996, 1998 Christopher G. Demetriou. All rights reserved.
Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here, provided that the new terms are clearly indicated on the first page of each file where they apply.
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3.
Redistribution and use of the libssl OpenSSL library in source and binary forms, with or without modification, is permitted provided that the following conditions are met: 1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3.
Trademarks 3PAR, InServ, InForm, InSpire and Serving Information are registered trademarks of 3PAR Inc. Intel and Pentium are registered trademarks of Intel Corporation. Linux is a registered trademark of Linus Torvalds. Microsoft, Windows, and Windows NT, Exchange Server, and SQL Server are either registered trademarks or trademarks of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds. Redhat is a registered trademark of Red Hat, Inc. SuSE is a registered trademark of Novell, Inc.
InForm OS Version 2.2.4 Command Line Interface Reference Table of Contents 1 Introduction 1.1 Audience 1.1 1.2 User Interfaces 1.2 1.3 Supported Operating Systems 1.2 1.4 Related Documentation 1.2 1.5 Organization 1.3 1.6 Typographical Conventions 1.5 1.7 Advisories 1.6 2 CLI Command Syntax and Conventions 2.1 Syntax and Conventions 2.2 2.2 Syntax Rules 2.3 2.3 Glob-Style Pattern 2.4 2.4 Typical Command Layout in this Book 2.5 2.5 Global Options and Environment Variables 2.6 2.
Command Line Interface Reference InForm OS Version 2.2.4 3.2.1 Drive Cage Management 3.2 3.2.2 Physical Disk Management 3.3 3.3 Domain Management Commands 3.3 3.4 Health and Alarm Management Commands 3.4 3.4.1 Alerts 3.4 3.4.2 Events 3.4 3.5 Help and Utility Commands 3.5 3.6 Task Management Commands 3.6 3.7 LDAP Management Commands 3.6 3.8 Licensing Management Commands 3.7 3.9 Node Subsystem Management Commands 3.7 3.9.1 Firmware Versions 3.7 3.9.2 Node Date Information 3.
InForm OS Version 2.2.4 Command Line Interface Reference 3.11 Preserved Data Commands 3.16 3.12 Replication Commands 3.17 3.12.1 Physical Copy 3.17 3.12.2 Remote Copy 3.17 3.12.3 Virtual Copy 3.20 3.13 Service Commands 3.20 3.13.1 Disk Enclosure 3.20 3.13.2 General System Maintenance 3.21 3.13.3 System Upgrade 3.21 3.14 SNMP Agent Commands 3.22 3.15 CIM Server Commands 3.23 3.16 Sparing Commands 3.23 3.17 SSH Access Commands 3.24 3.18 User Management Commands 3.25 3.
Command Line Interface Reference InForm OS Version 2.2.4 6 Cancel Command canceltask 6.2 7 Check Commands checkld 7.2 checkpassword 7.4 checkpd 7.6 checkport 7.9 checkvv 7.11 8 CLI Command cli 8.2 9 Compact Commands compactcpg 9.2 compactld 9.4 10 Control Commands controliscsiport 10.2 controlmag 10.5 controlpd 10.7 controlport 10.9 11 Create Commands xii Table of Contents createald 11.3 createaldvv 11.9 createavv 11.17 createcpg 11.21 createdomain 11.
InForm OS Version 2.2.4 Command Line Interface Reference createhost 11.34 createld 11.37 creatercopygroup 11.40 creatercopytarget 11.42 createspare 11.44 createsv 11.46 createtemplate 11.48 createtpvv 11.56 createuser 11.59 createvlun 11.61 createvv 11.64 createvvcopy 11.68 12 Dismiss Commands dismisspd 12.2 dismissrcopylink 12.3 dismissrcopyvv 12.5 13 Free Command freespace 13.2 14 Grow Commands growaldvv 14.2 growavv 14.9 growtpvv 14.11 growvv 14.
Command Line Interface Reference InForm OS Version 2.2.4 histport 15.18 histvlun 15.22 histvv 15.27 16 Locate Commands locatecage 16.2 locatesys 16.4 17 Move Commands movech 17.2 movechtospare 17.5 movepdtospare 17.7 moverelocpd 17.9 movetodomain 17.12 18 Promote Commands promotesv 18.2 promotevvcopy 18.4 19 Remove Commands xiv Table of Contents removealert 19.3 removecpg 19.5 removedomain 19.7 removeeventlog 19.8 removehost 19.9 removeld 19.11 removercopygroup 19.
InForm OS Version 2.2.4 Command Line Interface Reference removetask 19.23 removetemplate 19.25 removeuser 19.27 removeuserconn 19.29 removevlun 19.31 removevv 19.33 20 Service Commands servicecage 20.2 servicehost 20.5 servicemag 20.8 21 Set Commands setalert 21.3 setauthparam 21.5 setbattery 21.12 setcage 21.14 setcim 21.16 setclienv 21.19 setcpg 21.21 setdate 21.27 setdomain 21.31 sethost 21.33 setlicense 21.36 setnet 21.38 setnode 21.43 setntp 21.
Command Line Interface Reference InForm OS Version 2.2.4 setrcopygroup 21.51 setrcopytarget 21.57 setsnmppw 21.61 setsshkey 21.63 setstatch 21.65 setstatpdch 21.67 setsys 21.68 setsysmgr 21.71 settemplate 21.74 setuser 21.76 setuseracl 21.78 setvv 21.80 22 Show Commands xvi Table of Contents showalert 22.4 showauthparam 22.6 showbattery 22.8 showblock 22.12 showcage 22.15 showcim 22.20 showclienv 22.22 showcpg 22.23 showdate 22.29 showdomain 22.
InForm OS Version 2.2.4 Command Line Interface Reference showiscsisession 22.47 showld 22.49 showldch 22.55 showldmap 22.60 showlicense 22.62 shownet 22.64 shownode 22.66 shownodeenv 22.73 showpatch 22.75 showpd 22.77 showpdata 22.88 showpdch 22.89 showpdvv 22.95 showport 22.96 showportarp 22.105 showportdev 22.107 showportisns 22.110 showportlesb 22.112 showrcopy 22.118 showrctransport 22.123 showrsv 22.126 showsnmppw 22.128 showsnmpmgr 22.130 showspace 22.
Command Line Interface Reference InForm OS Version 2.2.4 showtarget 22.147 showtask 22.148 showtemplate 22.152 showtoc 22.154 showtocgen 22.156 showuser 22.157 showuseracl 22.159 showuserconn 22.160 showversion 22.162 showvlun 22.164 showvv 22.169 showvvmap 22.178 showvvpd 22.180 23 Shutdown Commands shutdownnode 23.2 shutdownsys 23.4 24 Start Commands startcim 24.2 startld 24.3 startrcopy 24.4 startrcopygroup 24.5 startvv 24.
InForm OS Version 2.2.4 Command Line Interface Reference statiscsisession 25.16 statld 25.18 statlink 25.23 statpd 25.25 statport 25.33 statrcopy 25.38 statvlun 25.41 statvv 25.47 26 Stop Commands stopcim 26.2 stoprcopy 26.3 stoprcopygroup 26.5 27 Sync Command syncrcopy 27.2 28 Tune Commands tunealdvv 28.2 tunepd 28.10 tunetpvv 28.15 tunevv 28.18 29 Update Commands updatesnapspace 29.2 updatevv 29.4 30 Upgrade Commands upgradecage 30.2 upgradepd 30.
Command Line Interface Reference InForm OS Version 2.2.4 31 Wait Command waittask IX RH xx Table of Contents Index Revision History 31.
InForm OS Version 2.2.4 Command Line Interface Reference 1 Introduction In this chapter This chapter includes the following sections: 1.1 Audience 1.2 1.2 User Interfaces 1.2 1.3 Supported Operating Systems 1.2 1.4 Related Documentation 1.3 1.5 Organization 1.4 1.6 Typographical Conventions 1.6 1.7 Advisories 1.6 This reference describes the 3PAR® InForm® Command Line Interface (CLI) commands that are used to administer and maintain the 3PAR InServ® Storage Server. Introduction 1.
Command Line Interface Reference InForm OS Version 2.2.4 1.1 Audience This reference is for system and storage administrators who monitor and direct system configurations and resource allocation for 3PAR InServ Storage Servers. 1.2 User Interfaces Two user interfaces are offered as part of the 3PAR InForm® operating system: the 3PAR InForm Command Line Interface (CLI) and the 3PAR InForm Management Console graphical user interface. This manual discusses the InForm CLI.
InForm OS Version 2.2.4 Command Line Interface Reference 1.
Command Line Interface Reference InForm OS Version 2.2.4 1.5 Organization This guide is organized as follows: ■ Chapter 1, Introduction (this chapter), provides an overview of this reference, including information on audience, related documentation, and typographical conventions. ■ Chapter 2, CLI Command Syntax and Conventions, describes the standard syntax and conventions used by the InForm CLI.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Chapter 15, Hist Commands, includes the commands used to monitor existing service group resources. ■ Chapter 16, Locate Commands, provides the commands used to identify physical system resources. ■ Chapter 17, Move Commands, lists the commands used to relocate logical entities to various resources in the service group. ■ Chapter 18, Promote Commands, describes the commands used to copy snapshots to base volumes.
Command Line Interface Reference ■ InForm OS Version 2.2.4 Chapter 30, Upgrade Commands, indicates the commands used to provide firmware upgrades to system components. ■ Chapter 31, Wait Command, provides information about the command for pausing a job. This guide also contains an index and a revision history for your reference. 1.
InForm OS Version 2.2.4 Command Line Interface Reference Advisories 1.
Command Line Interface Reference 1.8 Advisories InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 2 CLI Command Syntax and Conventions In this chapter 2.1 Syntax and Conventions 2.2 2.2 Syntax Rules 2.3 2.3 Glob-Style Pattern 2.4 2.4 Typical Command Layout in this Book 2.5 2.5 Global Options and Environment Variables 2.6 2.6 Exit Status 2.6 This chapter describes the command syntax for the CLI commands listed in this reference. General control commands that do not follow the syntax rules are also listed.
Command Line Interface Reference InForm OS Version 2.2.4 2.1 Syntax and Conventions Most CLI commands use the following syntax. Commands that do not use this syntax are listed in General Control and Help Commands on page 3.5. cmd subcmd [options [arg...]] ... [...] Table 2-1 lists all syntax elements and provides their meanings: Table 2-1. CLI Command Syntax Element Meaning cmd Specifies an operation to be executed, such as create, move, or show. subcmd Specifies a subcommand.
InForm OS Version 2.2.4 Command Line Interface Reference 2.2 Syntax Rules The command syntax described in Syntax and Conventions on page 2.2 obeys the following rules: ■ All command line elements are in lowercase letters, except where indicated in this reference. ■ Subcommands immediately follow the commands they modify. ■ Options, as indicated in this guide, are indicated by one or more letters, are preceded by a hyphen, and are enclosed in brackets (for example: removealert [–a]).
Command Line Interface Reference InForm OS Version 2.2.4 2.3 Glob-Style Pattern Several of the commands in this reference allow a pattern to be specified to refine the output of the commands. The patterns are used to match against a string. Strings are typically names such as host or virtual volume names. For example, in the showhost host_name|pattern... command, a pattern can be specified to refine the command output for a string of host names matching the specified pattern.
InForm OS Version 2.2.4 Command Line Interface Reference The following actions are practical examples of the glob-style pattern in use: Example Explanation of Action * Shows all names. [a]* Matches all names beginning with the letter a. [a–z]x* Matches any character a-z in the first character position and "x" in the second position, followed by any character "*". NOTE: Brackets ([ ]) are significant in Tcl and must be escaped using a backslash (\) or enclosed in braces ({ }).
Command Line Interface Reference InForm OS Version 2.2.4 SYNTAX See Syntax and Conventions on page 2.2. OPTIONS This section lists the available options you can use in conjunction with the command for varied results. Some options and their specifiers are required, as indicated in the syntax, whereas some are provided to increase the level and functionality of your output. SPECIFIERS Specifies a suggested input required by the user.
InForm OS Version 2.2.4 Command Line Interface Reference 3 Commands Quick Reference In this section 3.1 Overview 3.2 3.2 Disk Enclosure Management Commands 3.2 3.3 Domain Management Commands 3.3 3.4 Health and Alarm Management Commands 3.4 3.5 Help and Utility Commands 3.5 3.6 Task Management Commands 3.6 3.7 LDAP Management Commands 3.6 3.8 Licensing Management Commands 3.7 3.9 Node Subsystem Management Commands 3.7 3.10 Performance Management Commands 3.12 3.
Command Line Interface Reference InForm OS Version 2.2.4 3.15 CIM Server Commands 3.23 3.16 Sparing Commands 3.23 3.17 SSH Access Commands 3.24 3.18 User Management Commands 3.25 3.19 Volume Management Commands 3.26 3.1 Overview The InForm CLI provides a host of commands allowing you to administer your InServ Storage Server. To facilitate your navigation through this manual, this section provides an overview of the commands grouped by functionality. 3.2 Disk Enclosure Management Commands 3.2.
InForm OS Version 2.2.4 Command Line Interface Reference 3.2.2 Physical Disk Management Command Description Authority For Details See admitpd Admits one or all physical Service* admitpd on disks to enable their use. controlpd Spins physical disks up or page 5.4 Super, Service* down. dismisspd Dismisses one or more page 10.7 Service* physical disks from use. setpd Marks physical disks as controlpd on dismisspd on page 12.2 Edit, Service* allocatable for logical setpd on page 21.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See setdomain Sets the parameters and Super* setdomain on modifies the properties page 21.31 of a domain. showdomain Displays the list of Super, Service, Edit, showdomain on domains on a system. Browse page 22.30 * You need access to all domains in order to run this command 3.4 Health and Alarm Management Commands 3.4.
InForm OS Version 2.2.4 Command Line Interface Reference * You need access to all domains in order to run this command. 3.5 Help and Utility Commands Command Description Authority For Details See cli Provides a means to set Super, Edit, Browse, CLI Command on up your CLI session or to Service page 8.1 Lists all commands or Super, Edit, Browse, General Control details for a specified Service and Help enter directly into a CLI shell. clihelp command. Commands on page 3.
Command Line Interface Reference InForm OS Version 2.2.4 3.6 Task Management Commands Command Description Authority For Details See canceltask Cancels one or more Super, Service, Edit canceltask on tasks. removetask Removes information page 6.2 Edit about one or more tasks removetask on page 19.23 and their details. showtask waittask Displays information Super, Service, Edit, showtask on about tasks. Browse page 22.
InForm OS Version 2.2.4 Command Line Interface Reference 3.8 Licensing Management Commands Command Description Authority For Details See setlicense Sets the license key. Super, Service* setlicense on page 21.36 showlicense Displays the installed Super, Service, Edit, showlicense on license info or key. Browse page 22.62 * You need access to all domains in order to run this command. 3.9 Node Subsystem Management Commands 3.9.
Command Line Interface Reference InForm OS Version 2.2.4 3.9.3 Node Properties Command Description Authority For Details See setnode Sets the properties of the Super, Service* setnode on node components such as page 21.43 the serial number of the power supply. shownode Displays an overview of Super, Service, Edit, shownode on the node specific Browse page 22.66 Displays the node’s Super, Service, Edit, shownodeenv environmental status. Browse on page 22.73 properties.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See setsys Enables you to set Super* setsys on system-wide parameters page 21.68 such as the raw space alert. showsys Displays an overview of Super, Service, Edit, showsys on the InServ system Browse page 22.139 information, including the kernel version number, CPU speed, node name, node model, number of nodes, kernel build text (if any), and the CBIOS version.
Command Line Interface Reference InForm OS Version 2.2.4 3.9.7 Port Information Command Description Authority For Details See controlport Controls Fibre Super, Service* controlport on Channel or Remote page 10.9 Copy ports. controliscsiport Used to set up the Super, Service* parameters and controliscsiport on page 10.2 characteristics of an iSCSI port. showiscsisession Shows the iSCSI Super, Service, Edit, showiscsisession active sessions per Browse on page 22.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See showportlesb Displays Link Error Super, Service, Edit, showportlesb on Status Block Browse page 22.112 Displays Super, Service, Edit, showtarget on unrecognized Browse page 22.147 information about devices on a Fibre Channel port. showtarget targets. * You need access to all domains in order to run this command. 3.9.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See showtoc Displays the system table Super, Service, Edit, showtoc on of contents summary. Browse page 22.154 Displays the system table Super, Service, Edit, showtocgen on of contents generation Browse page 22.156 showtocgen number. * You need access to all domains in order to run this command. 3.10 Performance Management Commands 3.10.
InForm OS Version 2.2.4 Command Line Interface Reference 3.10.2 Data Cache Memory Statistics Command Description Authority For Details See statcmp Displays statistics for Super, Service, Edit, statcmp on cache memory pages. Browse page 25.8 3.10.3 Node CPU Statistics Command Description Authority For Details See statcpu Displays statistics for CPU Super, Service, Edit, statcpu on use. Browse page 25.10 3.10.
Command Line Interface Reference InForm OS Version 2.2.4 3.10.6 Physical Disk Statistics Command Description Authority For Details See histpd Displays histogram data Super, Service, Edit, histpd on for physical disks. Browse page 15.10 Displays statistics for Super, Service, Edit, statpd on physical disks. Browse page 25.25 statpd 3.10.
InForm OS Version 2.2.4 Command Line Interface Reference 3.10.8 System Tuner Command Description Authority For Details See tunealdvv Allows the RAID and Availability characteristics of an existing Thin Provisioned Virtual Volume to be dynamically modified. See the InForm OS Administrator’s Guide for a complete discussion of 3PAR System Tuner and the use of the tunealdvv command. Super, Edit* tunealdvv on Displays physical disks Service* tunepd page 28.
Command Line Interface Reference InForm OS Version 2.2.4 3.10.10 Virtual Volume Statistics Command Description Authority For Details See histvv Displays histogram data Super, Service, Edit, histvv on for virtual volumes. Browse page 15.27 Displays statistics for Super, Service, Edit, statvv on virtual volumes. Browse page 25.47 statvv 3.11 Preserved Data Commands 3.
InForm OS Version 2.2.4 Command Line Interface Reference 3.12 Replication Commands 3.12.1 Physical Copy Command Description Authority For Details See creategroupvvcopy Creates consistent Super, Edit creategroupvvcopy group physical copies on page 11.31 of a list of virtual volumes. Copies a virtual createvvcopy Super, Edit volume. promotevvcopy Promotes a physical createvvcopy on page 11.68 Super, Edit copy back to a base promotevvcopy on page 18.4 volume. 3.12.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See creatercopytarget Creates a target for Super, Edit* creatercopytarge Remote Copy. dismissrcopylink Dismisses a network t on page 11.42 Service* link from Remote dismissrcopylink on page 12.3 Copy use. dismissrcopyvv Dismisses a virtual Service* volume from a dismissrcopyvv on page 12.5 Remote Copy volume group.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See showrctransport Shows status and Super, Service, Edit, showrctransport information about Browse on page 22.123 Super, Edit* startrcopy on end-to-end transport for Remote Copy in the system. startrcopy Starts a Remote Copy subsystem. startrcopygroup Starts a Remote page 24.4 Super, Edit Copy volume group. statrcopy stoprcopy on page 24.
Command Line Interface Reference InForm OS Version 2.2.4 3.12.3 Virtual Copy Command Description Authority For Details See createsv Creates snapshot Super, Edit createsv on volumes. creategroupsv Creates consistent group page 11.46 Super, Edit snapshots of a list of creategroupsv on page 11.29 virtual volumes. promotesv Copies the differences of Super, Edit a virtual copy back to its promotesv on page 18.2 base volume.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See upgradecage Upgrades drive cage Service* upgradecage on firmware. upgradepd Upgrades disk firmware. page 30.2 Service* upgradepd on page 30.4 * You need access to all domains in order to run this command. 3.13.2 General System Maintenance Command Description Authority For Details See shutdownnode Shuts down an individual Service* shutdownnode system node.
Command Line Interface Reference InForm OS Version 2.2.4 3.14 SNMP Agent Commands Command Description Authority For Details See addsnmpmgr Adds an SNMP manager Service* addsnmpmgr on to receive trap page 4.2 notifications. removesnmpmgr Removes an SNMP trap Super* manager. removesnmppw Removes an SNMP on page 19.16 Super* password. setsnmppw Allows users to update showsnmppw Super* SNMP Agent Commands setsnmppw on page 21.
InForm OS Version 2.2.4 Command Line Interface Reference 3.15 CIM Server Commands Command Description Authority For Details See setcim Sets the properties of the Super, Service* setcim on CIM server, including page 21.16 options to enable or disable the HTTP and HTTPS ports for the CIM server. showcim Displays the CIM server Super, Service, Edit, showcim on current status, either Browse page 22.20 Service* startcim on active or inactive.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See movepdtospare Moves specified physical Super, Service, Edit* movepdtospare disks to spare. moverelocpd Moves chunklets on page 17.7 Super, Service, Edit* relocated from a moverelocpd on page 17.9 physical disk to another physical disk. removespare Removes spare Edit, Service* chunklets. showspare removespare on page 19.
InForm OS Version 2.2.4 Command Line Interface Reference 3.18 User Management Commands Command Description Authority For Details See createuser Creates user accounts. Super* createuser on page 11.59 removeuser Removes user accounts. Super* removeuser on page 19.27 removeuserconn Removes user Super* connections. setpassword setuser Changes your password. Sets your user properties. removeuserconn on page 19.29 Super, Edit, Service setpassword on Browse† page 21.
Command Line Interface Reference InForm OS Version 2.2.4 3.19 Volume Management Commands 3.19.1 Common Provisioning Group Management Command Description Authority For Details See createcpg Creates a Common Super, Edit* createcpg on Provisioning Group (CPG). removecpg Removes CPGs. page 11.21 Super, Edit* removecpg on page 19.5 setcpg Changes the properties Super, Edit* CPGs. showcpg Displays CPGs. setcpg on page 21.21 Super, Service, Edit, showcpg on Browse page 22.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See showhost Displays defined hosts in Super, Service, Edit, showhost on the system. Browse page 22.43 Sets properties on Super, Edit* sethost on sethost existing system hosts, page 21.33 including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. * You need access to all domains in order to run this command. 3.
Command Line Interface Reference InForm OS Version 2.2.4 3.19.4 Space and Storage Management Command Description Authority For Details See showblock Displays block mapping Super, Service, Edit, showblock on information for virtual Browse page 22.12 Displays logical disk to Super, Service, Edit, showldch on physical disk chunklet Browse page 22.55 Displays logical disk to Super, Service, Edit, showldmap on virtual volume mapping. Browse page 22.
InForm OS Version 2.2.4 Command Line Interface Reference 3.19.5 Template Management Command Description Authority For Details See createtemplate Creates templates for the Super, Edit* createtemplate creation of logical disks, on page 11.48 virtual volumes, thinly provisioned virtual volumes, and common provisioning groups. removetemplate Removes one or more Super* templates. settemplate Modifies template on page 19.25 Super* properties.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See createtpvv Creates a TPVV. Super, Edit createtpvv on page 11.56 createvv Creates a virtual Super, Edit with logical createvv on volume from logical disks specified* page 11.64 Super, Edit freespace on disks. freespace Frees SA and SD spaces from a virtual volume page 13.2 if they are not in use. growaldvv Automatically Super, Edit* increases the size of a growaldvv on page 14.
InForm OS Version 2.2.4 Command Line Interface Reference Command Description Authority For Details See showrsv Displays information Super, Service, Edit, showrsv on about reservation and Browse page 22.126 Displays virtual Super, Service, Edit, showvv on volumes in the system. Browse page 22.169 Starts virtual volumes. Service* startvv on registration of VLUNs connected on a Fibre Channel port. showvv startvv page 24.
Command Line Interface Reference InForm OS Version 2.2.4 Command Description Authority For Details See createvlun Creates a virtual volume Super, Edit createvlun on as a SCSI LUN. removevlun Removes VLUNs. page 11.61 Super, Edit removevlun on page 19.31 showvlun Displays VLUNs in the Super, Service, Edit, showvlun on system. Browse page 22.164 * You need access to all domains in order to run this command. 3.
InForm OS Version 2.2.4 Command Line Interface Reference 4 Add Command In this chapter addsnmpmgr 4.2 Add Command 4.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND addsnmpmgr DESCRIPTION The addsnmpmgr command adds an SNMP manager to receive trap notifications. SYNTAX addsnmpmgr [options ] AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the SNMP manager receives traps. This option is used if the port number differs from the default of 162.
InForm OS Version 2.2.4 Command Line Interface Reference SPECIFIERS Specifies the IP address of the host where the manager runs. Valid syntax is a.b.c.d, where a, b, c, and d are integers from 0 through 255. RESTRICTIONS You can add a maximum of 10 SNMP managers with this command. EXAMPLES The following example displays the addition of SNMP manager to the host IP address 123.45.67.89 with the assigned password of alpha1: cli% addsnmpmgr –pw alpha1 123.45.67.
Command Line Interface Reference 4.4 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 5 Admit Commands In this chapter admithw 5.2 admitpd 5.4 admitrcopylink 5.6 admitrcopyvv 5.8 Admit Commands 5.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND admithw DESCRIPTION The admithw command admits new hardware into the system. AUTHORITY Service NOTE: You need access to all domains in order to run this command. SYNTAX admithw [options] OPTIONS –checkonly Only performs passive checks; does not make any changes. –f If errors are encountered, the admithw command ignores them and continues. The messages remain displayed. SPECIFIERS None. RESTRICTIONS None. 5.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays a passive check of the system: cli% admithw -checkonly Checking nodes... Checking volumes... Checking system LDs... Checking ports... Checking state of disks... Checking cabling... Check complete. NOTES ■ The admithw command handles any nodes, disks, or cages that have been added into the system.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND admitpd DESCRIPTION The admitpd command creates and admits physical disk definitions to enable the use of those disks. AUTHORITY Service NOTE: You need access to all domains in order to run this command. SYNTAX admitpd [option] [...] OPTIONS –nold Do not use the physical disk (as identified by the WWN specifier) for logical disk allocation. See Notes on page 5.5 for more information about the –nold option.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ Physical disks cannot be used by the InForm operating system for storage until they are admitted into the system. ■ Specify the –nold option when adding a physical disk to replace a failed disk, whose chunklets were moved to spare space. Specifying –nold prevents the allocation of the newly added physical disk and allows chunklets to be moved back to the new disk.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND admitrcopylink DESCRIPTION The admitrcopylink command adds one or more links (connections) to a Remote Copy target system. SYNTAX ■ For Remote Copy over IP (RCIP), the syntax for the admitrcopylink command is as follows: admitrcopylink ... ■ For Remote Copy over fibre channel (RCFC), the syntax for the admitrcopylink command is as follows: admitrcopylink ...
InForm OS Version 2.2.4 Command Line Interface Reference ... Specifies the node, slot, and port of the Fibre Channel port on the local system and a World Wide Name (WWN) address on the target system. RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information. EXAMPLES The following example adds a link on System2 (targetname), node 1. The IP address 193.1.2.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND admitrcopyvv DESCRIPTION The admitrcopyvv command adds an existing virtual volume to an existing Remote Copy volume group. SYNTAX admitrcopyvv : AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information. EXAMPLES In the following example, the admitrcopyvv command adds the volume vv1 to the primary volume group Group1. At the same time, it adds the volume on the target system InServ1_in to the corresponding secondary volume group Group1.
Command Line Interface Reference 5.10 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 6 Cancel Command In this chapter canceltask 6.2 Cancel Command 6.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND canceltask DESCRIPTION The canceltask command cancels one or more tasks. SYNTAX canceltask [-f] all|... AUTHORITY Super, Service, Edit OPTIONS –f Forces the command. The command completes the process without prompting for confirmation. SPECIFIERS all Cancels all active tasks. If not specified, a task ID(s) must be specified. ... Cancels only tasks identified by their task IDs. If not specified, all tasks are cancelled.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ See the 3PAR InForm OS CLI Administrator’s Manual for additional information and examples regarding task management and task management commands. ■ The canceltask command can return before a cancellation is completed. Thus, resources reserved for a task might not be immediately available. This can prevent actions like restarting the canceled task.
Command Line Interface Reference 6.4 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 7 Check Commands In this chapter checkld 7.2 checkpassword 7.4 checkpd 7.6 checkport 7.9 checkvv 7.11 Check Commands 7.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND checkld DESCRIPTION The checkld command executes consistency checks of data on logical disks in the event of an uncontrolled system shutdown and optionally repairs inconsistent logical disks. SYNTAX checkld [options] ... AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS –y|–n Specifies that if errors are found they are either modified so they are valid (-y) or left unmodified (-n).
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays a validity check of logical disk vv63.admn.0: cli% checkld –n vv63.adm.0 Performing a consistency check only (no repairs) Working on ld vv63.adm.0 (955) compare:/dev/tpddev/pd/33 0x2180000 with:/dev/tpddev/pd/11 0x2180000 1 of 1 Logical disk vv63.adm.0 Check completed, logical disk consistent NOTES ■ Repairing logical disks refers to making logical disks consistent.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND checkpassword DESCRIPTION The checkpassword command displays authentication and authorization details using LDAP. This command is used to display the details of how the system authenticates a user and determines a user's privilege level.
InForm OS Version 2.2.4 ■ Command Line Interface Reference The last line of output shows the summary of the steps with the user either being unauthenticated or authenticated and authorized. NOTES ■ The output of the checkpassword command is based on current authentication and authorization parameters and might differ from the user's actual authorization level if the setauthparam command has been used to change parameters or data in the LDAP server has changed since the user last logged in.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND checkpd DESCRIPTION The checkpd command executes surface scans or diagnostics on physical disks. SYNTAX checkpd scrub|diag [options ] ... AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS The following options can only be used with the scrub specifier: -ch To scan a specific chunklet rather than the entire disk.
InForm OS Version 2.2.4 Command Line Interface Reference -time Indicates the number of seconds to run, from 1 to 36000. -total Indicates total bytes to transfer per disk. If a size is not specified, the default size is 1g. -retry Specifies the total number of retries on an I/O error. If the number of retries is not specified, the default is 4. -range Limits diagnostic regions to a specified size, from 2m to 2g.
Command Line Interface Reference InForm OS Version 2.2.4 NOTES ■ 7.8 The specifier can include a letter to indicate units: ◆ g = gigabytes (2^30) ◆ t = terabytes (2^40) ◆ p = petabytes (2^50) ◆ m = 1048576 byte ◆ k = 1024 bytes ◆ s = 512 bytes ■ I/O errors will be reported even if the eventual I/O succeeds due to retries. ■ Up to 40 physical disk IDs can be specified for the diag test type.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND checkport DESCRIPTION The checkport command performs a loopback test on Fibre Channel ports. SYNTAX checkport [options ] AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS –time Specifies the number of seconds the test is to run. Use an integer from 0 to 300. –iter Specifies the number of times the test is to run.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES In the following example, the loopback test is performed on port 0:0:1 a total of five times: cli% checkport -iter 5 0:0:1 Starting loopback test on port 0:0:1 Port 0:0:1 completed 5 loopback frames in 0 seconds Passed NOTES ■ When both the -time and -iter options are specified, the first limit reached terminates the program. If neither are specified, the default is 1,000 iterations.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND checkvv DESCRIPTION The checkvv command executes validity checks of virtual volume administration information in the event of an uncontrolled system shutdown and optionally repairs corrupted virtual volumes. SYNTAX checkvv [options] ... AUTHORITY Service NOTE: You need access to all domains in order to run this command.
Command Line Interface Reference EXAMPLES The following example displays a validity check of virtual volume test1: cli% checkvv -n test1 Doing a consistency check only (no repairs) Return PASS starting volume!! NOTES None. 7.12 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 8 CLI Command In this chapter cli 8.2 CLI Command 8.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND cli DESCRIPTION The cli command provides a means to set up your CLI session or to enter directly into a CLI shell. SYNTAX cli [options] [] AUTHORITY Super, Edit, Browse, Service OPTIONS –v Displays the CLI client version. –b Displays the CLI client build level. –h Displays help for the cli command. –tpdportnum Specifies the IP port of the CLI server to which the CLI client connects. The default port number is 2540.
InForm OS Version 2.2.4 Command Line Interface Reference –pwf Specifies the password file that contains the user name and encrypted password. If this option is not used, check the TPDPWFILE environment variable for the password filename. If the environment variable is not set, the CLI prompts you for the user name and password. –user Specifies a user name to access the CLI. If used, this option must be issued with the –password option and overrides the –pwf option.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the CLI client version: $ cli –v CLI client version: 2.1.1 The following example identifies the storage server being accessed as system1: $ cli –sys system1 The following example displays the current user user1 and the user’s password pw2: $ cli –user user1 –password pw2 The following example places the CLI in an interactive command loop: $ cli –cmdloop NOTES 8.
InForm OS Version 2.2.4 Command Line Interface Reference 9 Compact Commands In this chapter compactcpg 9.2 compactld 9.4 Compact Commands 9.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND compactcpg DESCRIPTION The compactcpg command consolidates logical disk space in Common Provisioning Groups (CPGs) into as few logical disks as possible, allowing unused logical disks to be removed and their space reclaimed. SYNTAX compactcpg [options] ... AUTHORITY Super, Edit OPTIONS -pat The specified patterns are treated as the list of or ...
InForm OS Version 2.2.4 Command Line Interface Reference -f Does not ask for confirmation before compacting the logical disks. Unless the -f option is specified, the command asks for confirmation before compacting each CPG. SPECIFIERS ... Specifies a glob-style pattern. This specifier can be repeated to compact multiple CPGs. If this specifier is not used, the specifier must be used. Refer to Glob-Style Pattern on page 2.4 for further information. ...
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND compactld DESCRIPTION The compactld command consolidates space on the logical disks. SYNTAX compactld [options ] ...|... AUTHORITY Super, Edit OPTIONS -pat The specified patterns are treated as the list of ... or ... as glob-style (shell-style) patterns and compact all the logical disks that match any of those patterns (see Help on sub, globpat).
InForm OS Version 2.2.4 Command Line Interface Reference -f Does not ask for confirmation before compacting the logical disks. Unless the -f option is specified, the command asks for confirmation before compacting each logical disk. -trimonly Only unused logical disk space is removed. Regions are not moved. SPECIFIERS ... Specifies the name of the logical disk to be compacted. Multiple logical disks can be specified. ... Specifies a glob-style pattern.
Command Line Interface Reference 9.6 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 10 Control Commands In this chapter controliscsiport 10.2 controlmag 10.5 controlpd 10.7 controlport 10.9 Control Commands 10.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND controliscsiport DESCRIPTION The controliscsiport command is used to set properties of an iSCSI port.
InForm OS Version 2.2.4 Command Line Interface Reference dhcp Sets whether or not (on or off) the iSCSI target should use the DHCP to obtain its IP addresses. isns Sets the primary or secondary iSNS server IP addresses. isnsport Sets the TCP port number for the iSNS server. By default, the default iSNS port number is used. delete Deletes the iSCSI port configuration. ping Pings the specified IP address a specified number of times from the iSCSI port.
Command Line Interface Reference The physical location of the iSCSI target port. OPTION -f Do not ask for confirmation. The default is to ask for confirmation. RESTRICTIONS None. EXAMPLES In the following example, iSCSI port configuration is deleted: cli% controliscsi delete -f 104.64.98 NOTES None. 10.4 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND controlmag DESCRIPTION The controlmag command takes drive magazines, or disk drives within a magazine, either on-loop or off-loop. Use this command when replacing a drive magazine or disk drive within a drive magazine. SYNTAX controlmag offloop|onloop [options] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command.
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS Specifies the name of the drive cage. Drive cage information can be viewed by issuing the showcage command. Specifies the drive magazine number within the drive cage. Valid formats are . or (for example 1.3 or 3, respectively). RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND controlpd DESCRIPTION The controlpd command spins a physical disk up or down. This command is used when replacing a physical disk in a drive magazine. CAUTION: Issuing the controlpd command puts the specified disk drive in a not ready state. Further, if this command is issued with the spindown subcommand, data on the specified drive becomes inaccessible. SYNTAX controlpd spinup|spindown [options] ...
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS ... Specifies the World-Wide Name (WWN) of the physical disk. This specifier can be repeated to identify multiple physical disks. RESTRICTIONS The spin down operation cannot be performed on a physical disk that is in use unless the –ovrd option is used. EXAMPLES The following example instigates the spin-up of a physical disk identified by its WWN of 2000000087002078: cli% controlpd spinup 2000000087002078 NOTES None. 10.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND controlport DESCRIPTION The controlport command controls all aspects of a Fibre Channel or Remote Copy port, including the port’s connection type and data rate. SYNTAX The syntax for the controlport command can be one of the following: ■ controlport rst [–m |–l|-i] [–f] ... ■ controlport offline ■ controlport lip [–c ] [–f] ...
Command Line Interface Reference ■ controlport rcfc init [–f] ■ controlport rcfc delete [–f] InForm OS Version 2.2.4 AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS rst Resets a port. offline Holds the specified port offline indefinitely. Issue controlport rst to bring the port back online.
InForm OS Version 2.2.4 Command Line Interface Reference Change Notification (RSCN) message is issued to the fabric controller whenever a VLUN is created or removed. In addition, if enabled with a public loop topology, a Loop Initialization (LIP) is issued from the port whenever a VLUN is created or removed. See Specifiers on page 10.14 for additional information on parameters required to issue this subcommand.
Command Line Interface Reference InForm OS Version 2.2.4 rcip ping Performs a ping from the specified interface to the specified address. Only for RCIP ports. See Specifiers on page 10.14 for parameters required to issue this subcommand. Use with the –pf option to prevent fragmentation of packets (see Options on page 10.12). rcfc init Sets the specified Remote Copy interface(s) on the local port. Only for RCFC ports. rcfc delete Deletes the configuration for the Remote Copy interface on the local port.
InForm OS Version 2.2.4 Command Line Interface Reference CAUTION: Issuing the controlport rst –l command affects both ports of a port pair. Only use this command when irreversible damage has been done to a port or port pair. For more information about ports in your system, issue the showport –i command (see showport on page 22.96). –c If using a private loop topology, a Loop Initialization Primitive (LIP) command is issued from the port.
Command Line Interface Reference InForm OS Version 2.2.4 –s Specifies the packet size. If no size is specified, the option defaults to 64. This option and argument can only be used with the rcip ping subcommand. –pf Prevents fragmentation of the packets when issuing the controlport rcip ping command. SPECIFIERS Specifies the connection parameter of the port. Parameters can be one of loop, point, or lp.
InForm OS Version 2.2.4 Command Line Interface Reference node Specifies the node using a number from 0 through 7. slot Specifies the PCI bus slot in the specified node using a number from 0 through 5. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot using 1 through 4. Specifies the personality (specifications) of the device connected a to a Fibre Channel port that includes its vendor, HBA, OS, level, and connection type.
Command Line Interface Reference InForm OS Version 2.2.4 Table 10-1.
InForm OS Version 2.2.4 Command Line Interface Reference half|full Use only with the rcip speed subcommand. Specifies the speed setting (10, 100, or 1000) and duplex setting (half or full) for a Remote Copy interface. In addition to this specifier, you must also specify an interface using . If no speed or duplex settings are specified, or if you specify auto with the rcip speed subcommand, the system auto-negotiates the speed and duplex.
Command Line Interface Reference ■ InForm OS Version 2.2.4 The controlport rcip addr command is only allowed for node/slot/port combinations where there is an interface installed. EXAMPLES The following example shows how to reset port 1 in slot 0 on node 0 to target mode: cli% controlport rst –m target 0:0:1 The following example shows how to increase MTU to 9000 on Gigabit Ethernet port 1 in node 6, slot 3: cli% controlport rcip mtu 9000 6:3:1 Remote Copy change successful.
InForm OS Version 2.2.4 Command Line Interface Reference ■ Resetting a port causes a momentary dip in throughput, but no loss of connectivity. ■ Persona setting 0 is for initiator ports that connect to InServ Storage Server drive cages. Disk ports default to persona setting 0. ■ The –f option forces the operation. Without the flag, the command prompts for confirmation.
Command Line Interface Reference 10.20 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 11 Create Commands In this chapter createald 11.3 createaldvv 11.9 createavv 11.17 createcpg 11.21 createdomain 11.28 creategroupsv 11.29 creategroupvvcopy 11.31 createhost 11.34 createld 11.37 creatercopygroup 11.40 creatercopytarget 11.42 createspare 11.44 createsv 11.46 createtemplate 11.48 Create Commands 11.
Command Line Interface Reference 11.2 InForm OS Version 2.2.4 createtpvv 11.56 createuser 11.59 createvlun 11.61 createvv 11.64 createvvcopy 11.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createald DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. The createald command creates logical disks with automatic chunklet allocation for the disks. SYNTAX createald [options ] [g|G] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –domain Specifies the domain.
Command Line Interface Reference InForm OS Version 2.2.4 –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed. The default is no limit. –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.
InForm OS Version 2.2.4 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 Fibre Channel (FC). If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern. The -devtype pattern cannot be used to mix Near Line (NL) and FC drives.
Command Line Interface Reference InForm OS Version 2.2.4 –mg - Specifies one or more drive magazines. 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–7). Disks must reside in the specified drive magazine(s). –pn
- Specifies one or more disk positions within a drive magazine. Disk positions are identified by one or more integers (item).
InForm OS Version 2.2.4 Command Line Interface Reference –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected for logical disk creation. The total number of free chunklets must be less than the specified number. –devid ,,... Specifies that physical disks identified by their device IDs are selected for logical disk creation. Device IDs can be specified in a comma-separated list. Device IDs can be displayed by issuing the showpd –i command.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the creation of a 256 MB logical disk named testld.0: cli% createald testld 256 NOTES ■ Verify the creation of a logical disk by issuing the showld command. See showld on page 22.49 for more information. ■ ■ For createald: ◆ KB = 1024 bytes ◆ MB = 1048576 bytes ◆ GB = 1073741824 bytes By default, logical disk are created using only physical disks with the same device type.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createaldvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the createvv command in the future. The createaldvv command creates a virtual volume and its underlying logical disks and allows the system to automatically allocate resources to meet specified use requirements.
Command Line Interface Reference InForm OS Version 2.2.4 –ssz Specifies the set size in number of chunklets. The default set size is 2 for RAID-1, 4 for RAID5. If not specified, the default set size is used by the showspace command to estimate space available. –rs Specifies the number of sets in a row. The default is no row limit. –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.
InForm OS Version 2.2.4 Command Line Interface Reference –i Specifies the ID of the created virtual volume. If not specified, the virtual volume’s ID is the next available virtual volume ID. –szs [g|G] Specifies the size for the snapshot volume in MB (maximum 1073741568). The default value is not set. The optional g or G parameter (no space before g or G) modifies the unit to Gigabyte. When -cpg is specified, this value should be 0.
Command Line Interface Reference InForm OS Version 2.2.4 stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume. However, the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted. A failure to update a snapshot is considered a failure to write to the base volume.
InForm OS Version 2.2.4 Command Line Interface Reference –st - Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7). The primary path of the disks must be on the specified PCI slot number(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).
Command Line Interface Reference InForm OS Version 2.2.4 –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected for virtual volume and logical disk creation. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected for virtual volume and logical disk creation.
InForm OS Version 2.2.4 Command Line Interface Reference [g|G] Specifies the size for the user volume in MB (maximum of 2096128 MB). The size should be an integer. If the value is followed by a g or G, (no whitespace before g or G) the size is in GB. If the size is to be taken from a template, this field should be ( - ). RESTRICTIONS ■ Options –pct and –szs cannot be used in the same instance of issuing the createaldvv command.
Command Line Interface Reference InForm OS Version 2.2.4 disks that must be created in units of the logical disk RAID set size. See the InForm OS Concepts Guide for further details. ■ Verify the creation of the virtual volume and its underlying logical disks by issuing the showvv and showld commands. See showvv on page 22.169 and showld on page 22.49 for additional information.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createavv DESCRIPTION The createavv command creates a virtual volume where logical disk mapping is determined by the system.
Command Line Interface Reference InForm OS Version 2.2.4 –al Specifies the virtual volume’s allocation limit. The snapshot data space of the virtual volume is prevented from growing beyond the specified percentage of the virtual volume size. After reached, new writes to the volume fail. –aw Specifies the percentage of used snapshot data space that when reached, results in a warning alert. To disable the warning, enter 0.
InForm OS Version 2.2.4 Command Line Interface Reference SPECIFIERS Specifies the virtual volume name, using up to 31 characters. This option and argument are required on the command line. Specifies the logical disks to be used as user space. The logical disks are identified by one or more integers (item). Integers can be provided as single number (1), a comma separated list of numbers (1,2,3), or a range of numbers separated with a dash (1–4).
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the creation of virtual volume vv0 with its user space set to 256 MB and its administrator space set to 256 MB: cli% createavv vv0 0 256 1 256 2 256 NOTES ■ Verify the creation of virtual volumes by issuing the showvv command. See showvv on page 22.169 for more information. ■ A newly created logical disk is guaranteed to be clean.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createcpg DESCRIPTION The createcpg command creates a Common Provisioning Group (CPG). AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. SYNTAX createcpg [options ] CPG_name OPTIONS –templ Use the options defined in the template . The template is created using the createtemplate command. Options specified in the template are read-only or readwrite.
Command Line Interface Reference InForm OS Version 2.2.4 –sdgs Specifies the amount of logical disk storage created on each auto-grow operation. If is non-zero it must be 8192 (8G) or bigger. A size of 0 disables the auto-grow feature.
InForm OS Version 2.2.4 Command Line Interface Reference -t Specifies the RAID type: r0, r1, or r5. The default is r1. -ssz Specifies the set size in the number of chunklets. The default set size is 2 for RAID-1, 4 for RAID-5. If not specified, the default set size is used by the showspace command to estimate the space available. -rs Specifies the number of sets in a row. The default is no limit. -ss Specifies the step size from 32 KB to 512 KB.
Command Line Interface Reference InForm OS Version 2.2.4 –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 number(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).
InForm OS Version 2.2.4 Command Line Interface Reference –dk - Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s).
Command Line Interface Reference InForm OS Version 2.2.4 Disks that satisfy all of the specified characteristics are used. For example, -p -fc_gt 60 -fc_lt 230 -nd 2 specifies all the disks that have greater than 60 and less than 230 free chunklets and that are connected to node 2 through their primary path. SPECIFIERS Specifies the name of the common provisioning group being created.
InForm OS Version 2.2.4 Command Line Interface Reference be created in units of the logical disk RAID set size. See the InForm OS Concepts Guide for further details. ■ By default, logical disk are created using only physical disks with the same device type. (By default, the Fibre Channel device type is used). Use the –p devtype NL option to override this default. Use showpd –i to see the device types of physical disks in the system.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createdomain DESCRIPTION The createdomain command creates system domains. AUTHORITY Super NOTE: You need access to all domains in order to run this command. SYNTAX createdomain [option ] OPTIONS -comment Specifies any comments or additional information for the domain. The comment can be up to 511 characters long. Unprintable characters are not allowed.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND creategroupsv DESCRIPTION The creategroupsv command creates consistent group snapshots of a list of virtual volumes. Consistent group snapshots are all created at the same point in time so that related structures on different volumes in the group remain consistent. SYNTAX creategroupsv [option] [:[:]]... AUTHORITY Super, Edit OPTIONS –ro Specifies that read-only snapshots are created.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS None. EXAMPLES In the following example, virtual volumes VV1 and VV2, and their underlying logical disks are created using the createaldvv command. A read-only snapshot of the volumes is then taken and a list of the volumes is generated using the creategroupsv command: cli% createaldvv –pct 10 VV1 4g cli% createaldvv –pct 10 VV2 4g cli% creategroupsv –ro VV1 VV2 CopyOfVV SnapshotVV VV1 VV1.ro VV2 VV2.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND creategroupvvcopy DESCRIPTION The creategroupvvcopy command creates consistent group physical copies of a list of virtual volumes. SYNTAX The syntax for the creategroupvvcopy command can be one of the following: ■ creategroupvvcopy -p [options] :... ■ creategroupvvcopy -r [options] ... ■ creategroupvvcopy -halt ...
Command Line Interface Reference InForm OS Version 2.2.4 –halt Cancels an ongoing physical copy or snapshot promotion. This causes the destination volume (as indicated using the ... specifier) to be marked with the copy failed status, which will be cleaned up when they are promoted to base virtual volumes or when a new copy is started.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Consistent group snapshots are all created at the same point in time so that related structures on different volumes in the group remain consistent. 11.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createhost DESCRIPTION The createhost command creates or adds paths to a new system host and provides the option of assigning one or more paths to that host. Paths can be either Fibre Channel WWNs or iSCSI names. The command also provides options to annotate the host with descriptor information such as physical location, IP address, operating system, model, and so on.
InForm OS Version 2.2.4 Command Line Interface Reference -iscsi Indicates that any specified host paths are iSCSI names. -loc Specifies the location of the host. -ip Specifies the IP address of the hosts. -os Specifies the operating system running on the host. -model Sets the model of the host. -contact Sets the owner of the host and contact information. -comment Specifies any additional information for the host.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example creates system host test: cli% createhost test01 2000000087041F72 cli% createhost –iscsi test01 iqn.1991-06.com.microsoft:dt-391xp.hq.3par.com cli% createhost –loc “Lab 5, Rack 37, Pos 1” test02 NOTES ■ A host can be created without assigning a host path. The –add option associates a host path with an existing host. If the –add option is not used; the createhost command defines a new host.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createld DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. The createld command allows you to create a logical disk. Unlike the createald command, issuing the createld command requires that you allocate chunklets for the logical disk created. SYNTAX createld [options ] ...
Command Line Interface Reference InForm OS Version 2.2.4 –ps Specifies the number of chunklets in the RAID set. This option and argument are required for RAID 5. –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. –ha port|cage|mag Defines the availability of the logical disk. The default is cage.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays the creation of RAID 1 logical disk test2. cli% createld test2 1 1 23:22 24:25 NOTES ■ Verify the creation of a logical disk by issuing the showld command. See showld on page 22.49 for more information. ■ To create a RAID 1 volume the mirror depth (-md option) must be specified. To create a RAID 5 volume the parity set (-ps option) must be specified.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND creatercopygroup DESCRIPTION The creatercopygroup command creates a Remote Copy volume group. SYNTAX creatercopygroup [options] : AUTHORITY Super, Edit OPTIONS -domain Creates the Remote Copy group in the specified domain. The volume group must be created by a member of a particular domain with Edit or Super privileges.
InForm OS Version 2.2.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND creatercopytarget DESCRIPTION The creatercopytarget command creates a Remote Copy target definition. SYNTAX The syntax for the creatercopytarget command can be one of the following: ■ Syntax for Remote Copy over IP (RCIP) is as follows: creatercopytarget IP [...] ■ Syntax for Remote Copy over fibre channel (FCFC) is as follows: creatercopytarget FC [...
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information. EXAMPLES The following example sets up targets and links on System2 (target name), node 0 and node 1. The IP addresses specify the addresses on the target system: cli% creatercopytarget System2 IP 0:193.1.1.11 1:193.1.2.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createspare DESCRIPTION The createspare command allocates chunklet resources as spares in the current service group. Chunklets marked as spare are not used for logical disk creation and are reserved explicitly for spares, thereby guaranteeing a minimum amount of spare space. SYNTAX createspare [options ] ... AUTHORITY Edit, Service NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 Command Line Interface Reference a: Specifies a chunklet number on all physical disks. This specifier can be repeated. –pos Specifies the position of a specific chunklet identified by its position in a drive cage, drive magazine, physical disk, and chunklet number. This specifier can be repeated.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createsv DESCRIPTION The createsv command creates a point-in-time (snapshot) copy of a virtual volume. Create snapshots to perform such tasks as backing up data on the base volume and allowing multiple copies of a base volume to be modified without affecting the original base volume. SYNTAX createsv [options ] AUTHORITY Super, Edit OPTIONS –ro Specifies that the copied volume is read-only.
InForm OS Version 2.2.4 Command Line Interface Reference The following example creates snapshot volume svrw_vv0 from the snapshot svro_vv0: cli% createsv svrw_vv0 svro_vv0 NOTES A maximum of 128 writable virtual copies per volume are allowed. 11.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createtemplate DESCRIPTION The createtemplate command creates virtual volume (VV), logical disk (LD), and common provisioning group (CPG) templates. Templates are sets of predetermined parameters that are applied to the creation of virtual volumes, logical disks, and CPGs. SYNTAX createtemplate vv|ld|cpg [options ] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 Command Line Interface Reference –ssz Specifies the set size in the number of chunklets. Enter 1 for RAID 0, an integer from 2 through 4 for RAID 10 and an integer from 3 through 9 for RAID 5. If not specified, the default value for RAID 10 is 2 and the default value for RAID 5 is 4. –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed.
Command Line Interface Reference InForm OS Version 2.2.4 –st - Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7). The primary path of the disks must be on the specified PCI slot number(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.2.4 Command Line Interface Reference –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected for virtual volume and logical disk creation. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected for virtual volume and logical disk creation.
Command Line Interface Reference InForm OS Version 2.2.4 –cpg Specifies that the snapshot data space and snapshot administration space are provisioned from the indicated CPG (). –size Specifies the size of the virtual volume and logical disk. –szs [g|G] By default, specifies the size of the snapshot volume in megabytes using an integer from 0 through 2096128 (2047 GB). Size can optionally be displayed in gigabytes by using the g|G parameter.
InForm OS Version 2.2.4 Command Line Interface Reference –pol no_stale_ss|stale_ss|one_host|no_one_host|tp_bzero|no_tp_bzero Specifies the policy that the created virtual volume follows. If an argument is not specified, the option defaults to stale_ss. stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume. However, the snapshot is considered invalid.
Command Line Interface Reference InForm OS Version 2.2.4 –sdgs Specifies the amount of logical disk storage created on each auto-grow operation. If is non-zero it must be 8192 (8G) or bigger. A size of 0 disables the auto-grow feature.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example creates a virtual volume called vvr1. The –ha and –pol option values are fixed. The RAID type can be changed when the virtual volume is created. Note that if patterns are specified, it is not possible to mix read-only and read/write pattern specifications. cli$ createtemplate vv -ha mag -rw -t r1 -ro -pol stale_ss vvr1 The command rejects the pattern.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createtpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. The createtpvv command creates a thinly provisioned virtual volume (TPVV).
InForm OS Version 2.2.4 Command Line Interface Reference –al Specifies the TPVV’s allocation limit. The snapshot data space of the virtual volume is prevented from growing beyond the specified percentage of the virtual volume size. Once the limit is reached, new writes to the TPVV fail. -spt Allows you to define the virtual volume geometry sectors_per_track value that is reported to the hosts through the SCSI mode pages.
Command Line Interface Reference InForm OS Version 2.2.4 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. no_tp_bzero Specifies that the zero-fill operation is bypassed on the allocation of partially written data pages. SPECIFIERS Specifies the name of the CPG from which the TPVV is created. Specifies the name of the TPVV, using up to 31 characters.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createuser DESCRIPTION The createuser command allows a Super user to create a new user account with a specified name and privilege level in a specified domain. SYNTAX createuser [option ] AUTHORITY Super NOTE: You need access to all domains in order to run this command.
Command Line Interface Reference InForm OS Version 2.2.4 Specifies the privilege level you wish to assign to the created user. The privilege level can be specified as Super, Service, Edit, or Browse. For information about each privilege level, see the InForm OS Concepts Guide. RESTRICTIONS Encrypted passwords are generated by the system. Therefore, you can only specify previously generated encrypted passwords. All passwords must be at least six characters long.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND createvlun DESCRIPTION The createvlun command creates a VLUN template that enables export of a virtual volume as a SCSI VLUN to a host or hosts. A SCSI VLUN is created when the current system state matches the rule established by the VLUN template. There are three types of VLUN templates: ■ port presents - created when only the node:slot:port are specified. The VLUN is visible to any initiator on the specified port.
Command Line Interface Reference InForm OS Version 2.2.4 –cnt Specifies that a sequence of VLUNs, as specified by the num argument, are exported to the same system port and host that is created. The num argument can be specified as any integer. For each VLUN created, the .int suffix of the VV_name specifier and LUN are incremented by one. –novcn Specifies that a VLUN Change Notification (VCN) not be issued after export.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example exports virtual volume test on LUN 2: cli% createvlun test 2 testhost NOTES ■ If a volume is already exported as a VLUN, you will be prompted for confirmation if a new export of the same volume is attempted. ■ The host and port can both be supplied when issuing this command (matched set).
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createvv DESCRIPTION The createvv command creates volumes that are provisioned from one or more common provisioning groups. Volumes can be fully provisioned from a CPG or can be thinly provisioned. You can optionally specify a CPG for snapshot space for fully provisioned volumes.
InForm OS Version 2.2.4 Command Line Interface Reference names of the volumes are .0 through .. If the ID is specified, it is used as the ID of VV_name.0 and incremented by 1 for each subsequent volume. -spt Allows you to define the virtual volume 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.
Command Line Interface Reference InForm OS Version 2.2.4 any deleted volumes or snapshots. The current allocation page size is 16kb. This is the default setting. no_tp_bzero Using this option bypasses the zero-fill stage on the allocation of partially written data pages. This is a performance improvement setting for thin provisioned volumes. The following options can be used when creating thinly provisioned virtual volumes (TPVVs): -tpvv Specifies that the created volume is a TPVV.
InForm OS Version 2.2.4 Command Line Interface Reference Otherwise, the volume is fully provisioned from the specified CPG. If the name of the CPG is to be taken from a template, this field should be “–”. Specifies the virtual volume name, using up to 31 characters in length. If the -cnt option is used, a dot and sequence number will be appended. The final name has this same constraint. [g|G] Specifies the size for the user volume in MB (maximum of 2096128 MB).
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND createvvcopy DESCRIPTION The createvvcopy command creates a full physical copy of a virtual volume or a read/write virtual copy on another virtual volume. This enables you to create copies of virtual volumes to perform tasks such as moving data to a larger virtual volume or creating a copy of data for testing.
InForm OS Version 2.2.4 Command Line Interface Reference –s Saves the snapshot of the source volume after the copy of the volume is completed. This enables a fast copy for the next resynchronization. If not specified, the snapshot is deleted and the association of the destination volume as a copy of the source volume is removed. The –s option is implied when the –r option is used and need not be explicitly specified. –b Specifies that this command blocks until the operation is completed.
Command Line Interface Reference ■ InForm OS Version 2.2.4 Multiple physical copy operations can occur simultaneously. Host-initiated I/O operations and those operations initiated by issuing the createvvcopy command are executed at the same priority level. As a result, noticeable performance degradation from a host perspective can be observed. ■ Issuing the createvvcopy command results in the creation of a temporary snapshot and, in the case of –r, a resynchronization (resync) snapshot.
InForm OS Version 2.2.4 Command Line Interface Reference 12 Dismiss Commands In this chapter dismisspd 12.2 dismissrcopylink 12.3 dismissrcopyvv 12.5 Dismiss Commands 12.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND dismisspd DESCRIPTION The dismisspd command removes physical disk definitions from system use. SYNTAX dismisspd ... AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS None SPECIFIERS ... Specifies the physical disk(s), identified by integers, to be removed from system use. RESTRICTIONS A physical disk that is in use cannot be removed.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND dismissrcopylink DESCRIPTION The dismissrcopylink command removes one or more links (connections) created with the admitrcopylink command to a target system. SYNTAX ■ Syntax for Remote Copy over IP (RCIP) is as follows: dismissrcopylink ... ■ Syntax for Remote Copy over FC (RCFC) is as follows: dismissrcopylink ...
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS ■ Functionality of this command requires a 3PAR Remote Copy license. Contact your local service provider for more information. ■ Use this command only to remove sending links. See the Remote Copy User’s Guide for more details on sending and receiving links. ■ This command cannot be used to remove the last link of a target system with started groups.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND dismissrcopyvv DESCRIPTION The dismissrcopyvv command removes a virtual volume from a Remote Copy volume group. SYNTAX dismissrcopyvv AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS The name of the volume to be removed. Volumes are added to a group with the admitrcopyvv command.
Command Line Interface Reference InForm OS Version 2.2.4 NOTES ■ The dismissrcopyvv command removes any Remote Copy synchronization snapshots affiliated with the removed volume. ■ 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 volume is removed from the corresponding secondary group. If the policy is set and the group is a secondary, then this command fails. 12.
InForm OS Version 2.2.4 Command Line Interface Reference 13 Free Command In this chapter freespace 13.2 Free Command 13.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND freespace DESCRIPTION The freespace command frees snapshot administration and snapshot data spaces from a virtual volume if they are not in use. SYNTAX freespace [options] ...|... AUTHORITY Super, Edit OPTIONS –pat The specified patterns are treated as glob-style patterns. Additionally, the snapshot administration and snapshot data spaces from all volumes matching the specified pattern.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS This command can only be used to free snapshot administration and snapshot data space if it is not used by TPVVs or snapshots. If the specified volume is a TPVV or if it has any snapshots, the command fails. EXAMPLES The following example demonstrates how to remove SA and SD space from virtual volume testd: cli% freespace testd Free SA and SD space of VV testd select q=quit y=yes n=no: y Unused LDs for this VV: testd.adm.0 testd.adm.
Command Line Interface Reference 13.4 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 14 Grow Commands In this chapter growaldvv 14.2 growavv 14.9 growtpvv 14.11 growvv 14.13 Grow Commands 14.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND growaldvv DESCRIPTION The growaldvv command automatically enlarges (grows) the size of a virtual volume by adding underlying logical disks. This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the growvv command in the future. AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 Command Line Interface Reference providing either the g or G options following (no whitespace between) the entered size value. This option cannot be used with the –pct option. –szs [g|G] Specifies the size of the snapshot volume in megabytes using an integer from 0 through 1073741568(1048575.75 GB). Size can optionally be specified in gigabytes by providing either the g or G options following (no whitespace between) the entered size value.
Command Line Interface Reference InForm OS Version 2.2.4 –ha || RAID 1 or RAID 5 can support a failure of one port pair, one cage, or one mag. The default depends on whether the RAID type is specified. If the RAID type is not specified or if the same RAID type as the last region of the existing virtual volume is specified, the default is the same as the last region of the existing virtual volumes. Otherwise for RAID 1 and RAID 5, the user default, snap admin and snap data areas are cage.
InForm OS Version 2.2.4 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 Fibre Channel (FC). If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern. The -devtype pattern cannot be used to mix Near Line (NL) and FC drives.
Command Line Interface Reference InForm OS Version 2.2.4 –mg - Specifies one or more drive magazines. Drive magazines are identified by one or more integers (item). Multiple drive magazines are each separated with a comma (1,2,3). A range of drive magazines is separated with a hyphen (0–7). Disks must reside in the specified drive magazine(s). –pn
- Specifies one or more disk positions within a drive magazine. Disk positions are identified by one or more integers (item).
InForm OS Version 2.2.4 Command Line Interface Reference –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. The total number of free chunklets must be less than the specified number. –devid Specifies that physical disks identified by their device IDs are selected. Device IDs can be specified in a comma-separated list. Device IDs can be shown by issuing the showpd –i command.
Command Line Interface Reference InForm OS Version 2.2.4 disks of multiple device types after the grow operation. If a virtual volume currently has logical disks of multiple device types, it is possible to grow the volume using logical disks of any device type. Use showpd –i to see the device types of physical disks in the system.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND growavv DESCRIPTION The growavv command enlarges a virtual volume with automatic mapping to the logical disks. SYNTAX growavv [options] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –verbose on|off Specifies that verbose output is either enabled (on) or disabled (off).
Command Line Interface Reference InForm OS Version 2.2.4 Specifies the logical disks to be used as snapshot administrator space. The logical disks are identified by one or more integers (item). Integers can be provided as a single number (1), a comma separated list of numbers (1,2,3), or a range of numbers separated with a dash (1–4). Specifies the size of the administrator space in megabytes. Specifies the logical disks to be used as snapshot data space.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND growtpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. The growtpvv command enlarges a thinly provisioned virtual volume (TPVV). AUTHORITY Super, Edit SYNTAX growtpvv [G|g] OPTIONS None. SPECIFIERS [G|g] Specifies the size in megabytes using an integer from 1 through 2096128 (2047 GB).
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the virtual volume being grown by 1 GB, to a total of 5 GB. cli% growtpvv 1g tpvv cli% showvv Id Name Type CopyOf BsId Rd State AdmMB SnapMB userMB 0 tpvv Base,tpvv ––– 0 RW started 128 512 5120 --------------------------------------------------------------------1 total LD 128 512 0 total virtual – – 5120 NOTES A volume can be enlarged while I/O is occurring. 14.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND growvv DESCRIPTION The growvv command increases the size of a virtual volume created with the createvv or createtpvv commands. SYNTAX growvv [g|G] AUTHORITY Super, Edit NOTE: You need access to all domains with logical disks specified in order to run this command. OPTIONS None. SPECIFIERS Specifies the name of the virtual volume to grow. [g|G] Specifies the size in MB to be added to the volume user space.
Command Line Interface Reference NOTES For this command: 14.14 ■ KB = 1024 bytes ■ MB = 1048576 bytes ■ GB = 1073741824 bytes. InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 15 Hist Commands In this chapter histch 15.2 histld 15.6 histpd 15.10 histport 15.18 histvlun 15.22 histvv 15.27 Hist Commands 15.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND histch DESCRIPTION The histch command displays a histogram of service times in a timed loop for individual chunklets. SYNTAX histch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –ld Specifies the logical disk, identified by name, from which chunklet statistics are sampled. –ch Specifies that statistics are limited to only the specified chunklet, identified by number.
InForm OS Version 2.2.4 Command Line Interface Reference –sizecols For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15. ◆ The first column () must be a value greater than or equal to 0, but less than the value of the last column () (default value of 3). ◆ The last column () must be less than or equal to 15 (default value of 11).
Command Line Interface Reference InForm OS Version 2.2.4 dec Sort in decreasing order. You can specify multiple columns on the command line by using a colon (:). Rows having the same column(s) are sorted by the values in the latter specified columns. –filt Specifies that histograms below the threshold specified by the argument are not displayed. The argument is specified in the syntax of ,,.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays one iteration of a histogram of service times for system chunklets: cli% histch –iter 1 12:42:57 10/20/04 ------------Time (millisec)-----------Ldid Ldname LdCh Pdid PdCh 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 2 tp–0–sa–0.0 1 21 0 0 0 0 0 0 0 0 0 0 0 2 tp–0–sa–0.0 0 45 0 0 0 0 0 0 0 0 0 0 0 1 tp–0–sa–0.1 1 20 0 0 0 0 0 0 1 0 0 0 0 1 tp–0–sa–0.1 0 42 0 0 0 0 0 0 1 0 0 0 0 0 admin.usr.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND histld DESCRIPTION The histld command displays a histogram of service times for logical disks in a timed loop. SYNTAX histld [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ...|... Shows only logical disks that are in domains with names that match any of the names or patterns specified. -vv ...|...
InForm OS Version 2.2.4 ◆ Command Line Interface Reference The first column includes all data accumulated for columns less than the first column and the last column includes accumulated data for all columns greater than the last column. –sizecols For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15.
Command Line Interface Reference InForm OS Version 2.2.4 –sortcol
[,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order. –filt Specifies that histograms below the threshold specified by the argument are not displayed.InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays one iteration of a histogram of service times for all logical disks: cli% histld –iter 1 12:38:49 10/20/04 ------------Time (millisec)-----------Ldame 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 tp–0–sa–0.0 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.1 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.0 0 0 0 0 0 0 0 0 0 0 admin.usr.0 0 0 0 0 1 6 6 1 0 0 tp–0–sa–0.1 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.3 0 0 0 0 0 0 0 0 0 0 tp–0–sd–0.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND histpd DESCRIPTION The histpd command displays a histogram of service times for physical disks. SYNTAX histpd [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –i pdid Specifies the physical disk ID for which service times are displayed. –w WWN Specifies the world wide name of the physical disk for which service times are displayed.
InForm OS Version 2.2.4 Command Line Interface Reference –metric both|time|size Selects which metric to display. Metrics can be one of the following: ◆ both - (Default) Displays both I/O time and I/O size histograms. ◆ time - Displays only the I/O time histogram. ◆ size - Displays only the I/O size histogram. –timecols For the I/O time histogram, show the columns from the first column through last column . The available columns range from 0 through 31.
Command Line Interface Reference InForm OS Version 2.2.4 –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds. –iter Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647.
InForm OS Version 2.2.4 Command Line Interface Reference –ni Specifies that histograms for only nonidle devices are displayed. This option is shorthand for the option –filt t,0,0. –p Specifies the pattern of physical disks displayed in the histogram. Patterns are used to filter and select the disks displayed in the histogram. If no pattern is specified, the option defaults to all disks of device type Fibre Channel (FC).
Command Line Interface Reference InForm OS Version 2.2.4 –mg - Specifies one or more drive magazines. Drive magazines are identified by one or more integers (
- ). Multiple drive magazines are separated with a single comma (1,2,3). A range of drive magazines is separated with a hyphen (0–7). Disks must reside in the specified drive magazine(s). –pn
- Specifies one or more disk positions within a drive magazine. Disk positions are identified by one or more integers (
- ).
InForm OS Version 2.2.4 Command Line Interface Reference –devid Specifies that physical disks identified by their device IDs are selected for virtual volume and logical disk creation. Device IDs can be specified in a comma-separated list. Issue the showpd –i command for a list of physical disk device IDs for use with the –devid option.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays a histogram of service times for all physical disks: cli% histpd 12:36:53 10/20/04 ------------Time (millisec)-----------Pdid Port 0.26 0.53 1.05 2.1 4.2 8.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Previous options –n , –s , and –p have been replaced with –nodes , –slots , and –ports . 15.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND histport DESCRIPTION The histport command displays a histogram of service times for ports within the system. SYNTAX histport [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –both|–ctl|–data Specifies that both control and data transfers are displayed (–both), only control transfers are displayed (–ctl), or only data transfers are displayed (– data). If this option is not specified, only data transfers are displayed.
InForm OS Version 2.2.4 Command Line Interface Reference –metric both|time|size Selects which metric to display. Metrics can be one of the following: ◆ both - (Default) Displays both I/O time and I/O size histograms. ◆ time - Displays only the I/O time histogram. ◆ size - Displays only the I/O size histogram. –timecols For the I/O time histogram, show the columns from the first column through last column . The available columns range from 0 through 31.
Command Line Interface Reference InForm OS Version 2.2.4 –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed. –d Specifies the interval in seconds that statistics are sampled from using an integer from 1 through 2147483. If no count is specified, the command defaults to 2 seconds. –iter Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647.
InForm OS Version 2.2.4 Command Line Interface Reference –ni Specifies that histograms for only nonidle devices are displayed. This option is shorthand for the option –filt t,0,0. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays a histogram of service times for reads and writes to ports: li% histport 12:35:24 10/20/04 ------------Time (millisec)------------Port D/C 0.26 0.53 1.05 2.1 4.2 8.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND histvlun DESCRIPTION The histvlun command displays VLUN service time histograms. SYNTAX histvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ...|... Shows only VLUNs whose virtual volumes are in domains with names that match one or more of the specified domain names or patterns. Multiple domain names or patterns can be repeated using a comma-separated list. –host ...|...
InForm OS Version 2.2.4 Command Line Interface Reference –slots Specifies that only exports from the specified slots are to be displayed. 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). –ports Specifies that only exports to the specified ports are to be displayed. The port 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.2.4 –sizecols For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15. ◆ The first column () must be a value greater than or equal to 0, but less than the value of the last column () (default value of 3). ◆ The last column () must be less than or equal to 15 (default value of 11).
InForm OS Version 2.2.4 Command Line Interface Reference –sortcol
[,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order. –filt Specifies that histograms below the threshold specified by the argument are not displayed.Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays two iterations of a histogram of service times for all VLUNs: cli% histvlun –iter 2 12:48:50 10/20/04 ------------Time (millisec)-----------Lun VVname Host Port 0.26 0.53 1.05 2.1 4.2 8.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND histvv DESCRIPTION The histvv command displays virtual volume service time histograms in a timed loop. SYNTAX histvv [options ] [|]... AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ...|... Shows only the virtual volumes that are in domains with names that match the specified domain name(s) or pattern(s). –metric both|time|size Selects which metric to display.
Command Line Interface Reference InForm OS Version 2.2.4 –sizecols For the I/O size histogram, show the columns from the first column () through the last column (). Available columns range from 0 through 15. The first column () must be a value greater than or equal to 0, but less than the ◆ value of the last column () (default value of 3). The last column () must be less than or equal to 15 (default value of 11).
InForm OS Version 2.2.4 Command Line Interface Reference –filt Specifies that histograms below the threshold specified by the argument are not displayed. The argument is specified in the syntax of ,,. The argument can be specified as one of the following: ◆ r - Specifies read statistics. ◆ w - Specifies write statistics. ◆ t - Specifies total statistics. ◆ rw - Specifies total read and write statistics.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays two iterations of a histogram of service times for all virtual volumes: %cli histvv –iter 2 12:53:03 10/20/04 ------------Time (millisec)-----------VVname 0.26 0.53 1.05 2.1 4.2 8.4 17 34 67 135 admin 0 0 0 0 0 0 0 0 0 0 tpvv 29 0 0 0 0 0 0 0 0 0 --------------------------------------------------------total 29 0 0 0 0 0 0 0 0 0 12:53:05 10/20/04 ------------Time (millisec)-----------VVname 0.26 0.53 1.05 2.
InForm OS Version 2.2.4 Command Line Interface Reference 16 Locate Commands In this chapter locatecage 16.2 locatesys 16.4 Locate Commands 16.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND locatecage DESCRIPTION The locatecage command allows system administrators to locate a drive cage, drive magazine, or port in the system using the devices’ blinking LEDs.
InForm OS Version 2.2.4 Command Line Interface Reference Indicates the port specifiers. Accepted values are A0|B0|A1|B1. If a port is specified, the port LED will oscillate between green and off. The specifier is not supported for DC3 drive cages. Indicates the drive magazine by number. ◆ For DC2 and DC4 drive cages, accepted values are 0 through 9. ◆ For DC3 drive cages, accepted values are 0 through 15.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND locatesys DESCRIPTION The locatesys command helps locate a storage system by blinking the node status LEDs on all nodes of a storage system alternating between amber and green. By default, the LEDs in all connected cages are also set as amber or oscillating (depending on the cage). SYNTAX locatesys [options ] AUTHORITY Service NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES In the following example, an InServ Storage Server is identified by blinking the LEDs on all drive cages in the system for 90 seconds. cli% locatesys -t 90 NOTES None. 16.
Command Line Interface Reference 16.6 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 17 Move Commands In this chapter movech 17.2 movechtospare 17.5 movepdtospare 17.7 moverelocpd 17.9 movetodomain 17.12 Move Commands 17.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND movech DESCRIPTION The movech command moves a list of chunklets from one physical disk to another. SYNTAX movech [options] ... AUTHORITY Super, Service, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. If not specified, the command returns only after the move is completed.
InForm OS Version 2.2.4 Command Line Interface Reference -ovrd Permits the moves to happen to a destination even when there will be a loss of quality because of the move. This option is only necessary when the target of the move is not specified and the -perm flag is used. SPECIFIERS [<–td:tp>]...
Command Line Interface Reference ◆ true. Indicates quality was lost. ◆ false. Indicates quality was not lost. InForm OS Version 2.2.4 NOTES ■ Chunklets moved through the movech command are only moved temporarily. Issuing either the moverelocpd or servicemag resume command can move the chunklet back to its original position. ■ Specifying the –dr option can be used to see if the specified moves succeed and what the results (quality) of the moves are. 17.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND movechtospare DESCRIPTION The movechtospare command moves data from specified physical disks to a temporary location selected by the system. SYNTAX movechtospare [options] AUTHORITY Super, Service, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. If not specified, the command returns only after the move is completed.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS None. EXAMPLES In the following example, chunklet 60 from physical disk 0 is moved to spare: cli% movechtospare 0:60 select q=quit y=yes n=no: y Move Status qset qrow qcon qlocal qlost 0:60-10:45 ch was moved mag 0 2 true false In the example above: ■ qset. The quality of the set after the chunklet is moved, in terms of the availability characteristics of the logical disk. ■ qrow.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND movepdtospare DESCRIPTION The movepdtospare command moves data from specified physical disks to a temporary location selected by the system. SYNTAX movepdtospare [options] ... AUTHORITY Super, Service, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. If not specified, the command returns only after the move is completed.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND moverelocpd DESCRIPTION The moverelocpd command moves chunklets that were on a physical disk to the target of relocation as specified by you. SYNTAX moverelocpd [options] ... AUTHORITY Super, Service, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. If not specified, the command returns only after the move is completed.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS None.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Specifying the –dr option can be used to see if the specified moves succeeds and what the results (quality) of the moves are. ■ If the –partial option is used, the command relocates as many chunklets as possible and prints messages for the chunklets it could not move. 17.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND movetodomain DESCRIPTION The movetodomain command moves objects from one domain to another. SYNTAX movetodomain [options] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –vv Specifies that the object is a virtual volume. -cpg Specifies that the object is a CPG. –host Specifies that the object is a host. –f Specifies that the command is forced.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLE The following example displays the movement of virtual volume 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.14 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 COMMAND promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume or any RW parent in the same VV family tree, 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.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS ■ The virtual copy and its base volume must not be exported. ■ If working with a Remote Copy volume group and that group has been started, the promotesv -rcp command will fail. EXAMPLES The following example promotes the differences from virtual volume 11 and its base volume 10: cli% promotesv 11 NOTES ■ Issue the showvv command to verify that differences in the snapshot volume are promoted to its base volume.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference 19 Remove Commands In this chapter removealert 19.3 removecpg 19.5 removedomain 19.7 removeeventlog 19.8 removehost 19.9 removeld 19.11 removercopygroup 19.13 removercopytarget 19.15 removesnmpmgr 19.16 removesnmppw 19.18 removespare 19.20 removesshkey 19.22 removetask 19.23 removetemplate 19.25 Remove Commands 19.
Command Line Interface Reference 19.2 InForm OS Version 2.2.4 removeuser 19.27 removeuserconn 19.29 removevlun 19.31 removevv 19.
InForm OS Version 2.2.4 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.2.4 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.2.4 Command Line Interface Reference COMMAND removecpg DESCRIPTION The removecpg command removes common provisioning groups (CPGs) from the system or removes specific logical disks from common provisioning groups. 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.2.4 –sd Specifies that the logical disk, as identified with the argument, used for snapshot data space allocation is removed. The argument can be repeated to specify multiple logical disks. This option does not remove the CPG. –pat The specified patterns are treated as glob-style patterns and that all virtual volumes matching the specified pattern are removed.
InForm OS Version 2.2.4 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. RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND removeeventlog DESCRIPTION The removeeventlog command removes all debug event logs from the system. 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. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS A host that has one or more VLUNs exported on it cannot be removed. EXAMPLES The following example removes host test01: cli% removehost test01 NOTES ■ Removing an entire host definition by issuing the removehost command is not equivalent to removing all of the paths associated with a host. The latter leaves a host definition with no paths associated to it, whereas the former removes the entire host definition. ■ 19.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND removeld DESCRIPTION The removeld command removes a specified logical disk from the system service group. SYNTAX removeld [options] {|}... AUTHORITY Edit OPTIONS –pat Specified patterns are treated as glob-style patterns and all logical disks matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified.
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS Specifies the logical disk name, using up to 31 characters. Multiple logical disks can be specified. Specifies a glob-style pattern. Multiple logical disks 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 ■ If the logical disk is mapped to a virtual volume, the logical disk is not removed.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND removercopygroup DESCRIPTION The removercopygroup command removes a Remote Copy volume group. SYNTAX removercopygroup AUTHORITY Edit OPTIONS None. SPECIFIERS The name of the group to be removed. RESTRICTIONS ■ Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
Command Line Interface Reference ■ InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND removercopytarget DESCRIPTION The removercopytarget command removes target designation from a Remote Copy system and removes all links affiliated with that target. SYNTAX removercopytarget AUTHORITY Edit NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS The target name for the target definition to be removed.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP software frameworks (managers) for 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.2.4 Command Line Interface Reference ■ 0 indicates that the trap manager host was removed and the command was successful. ■ 1 indicates that the command failed. ■ 2 indicates that the host is not on the list of registered hosts. NOTES ■ SNMP managers are registered by issuing the addsnmpmgr command. See addsnmpmgr on page 4.2 for additional information. ■ Verify the removal of SNMP managers by issuing the showsnmpmgr command. See showsnmpmgr on page 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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.2.4 COMMAND removespare DESCRIPTION The removespare command removes chunklets from the spare chunklet list. SYNTAX removespare [options] ... AUTHORITY Edit, 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.2.4 Command Line Interface Reference –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.2.4 COMMAND removesshkey DESCRIPTION The removesshkey command removes your SSH public key to disable key authentication. SYNTAX removesshkey [... ] AUTHORITY Service 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. RESTRICTIONS None.
InForm OS Version 2.2.4 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 Edit OPTIONS –a Removes all tasks including details. –d Remove task details only.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference COMMAND removetemplate DESCRIPTION The removetemplate command removes one or more virtual volume, logical disk, and common provisioning group 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. If this option is not used, the command requires confirmation before proceeding with its operation.
Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays the forced removal of template vv1: cli% removetemplate -f vv1 NOTES None. 19.26 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 NOTES ■ Verify the removal of users by issuing the showuser command. See showuser on page 22.157 for additional information. ■ The removeuser command does not remove a user's SSH key. Use the removesshkey command to remove the user's SSH key. ■ 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.2.4 Command Line Interface Reference COMMAND removeuserconn DESCRIPTION The removeuserconn command removes user connections to the current host. AUTHORITY Super NOTE: You need access to all domains in order to run this command.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS None. 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.1 NOTES Because user connections can disappear from the time they are listed and the time they are removed, the removeuserconn command continues past errors while removing individual connections if the –pat option is specified. 19.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND removevlun DESCRIPTION The removevlun command removes a virtual volume’s SCSI LUN export definition from the system. SYNTAX removevlun [options] | AUTHORITY Super, Edit OPTIONS –novcn Specifies that a VLUN Change Notification (VCN) not be issued after removal of the VLUN. ◆ For direct connect or loop configurations, a VCN consists of a Fibre Channel Loop Inititalization Primitive (LIP).
Command Line Interface Reference InForm OS Version 2.2.4 Specifies the LUN as an integer from 0 through 65536. 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. slot Specifies the PCI bus slot in the node where slot is a number from 0 through 5. port Specifies the FCS port number of the card in PCI bus slot using 1 through 4.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND removevv DESCRIPTION The removevv command removes virtual volumes from the system. SYNTAX The syntax of the removevv command can be as follows: ■ removevv [options] |... ■ removevv [options] -stale AUTHORITY Super, Edit OPTIONS –keepld After all the virtual volumes have been removed, do not remove the underlying logical disks.
Command Line Interface Reference InForm OS Version 2.2.4 –stale Specifies that all stale volumes can be removed. SPECIFIERS Specifies the virtual volume name, using up to 31 characters. This specifier can be repeated to remove multiple virtual volumes. If this specifier is not used, the pattern specifier must be used. Specifies a glob-style pattern. This specifier can be repeated to remove multiple virtual volumes. If this specifier is not used, the specifier must be used.
InForm OS Version 2.2.4 Command Line Interface Reference If this is a concern, remove logical disks when the virtual volume is removed and use only newly created logical disks for your user space. Previous data in logical disks used for snapshot data space or snapshot admin space is not visible to you because these spaces are only visible after being written with new data. ■ Verify the removal of virtual volumes by issuing the showvv command. See showvv on page 22.169 for additional information. 19.
Command Line Interface Reference 19.36 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 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.2.4 Command Line Interface Reference resetfc ◆ For DC3 cages, soft reset the Fibre Channel interface card. ◆ For DC2 and DC4 cages, soft reset the cage. FC-AL specifier is ignored. hresetfc ◆ For DC3 cages, hard reset the Fibre Channel interface card. ◆ For DC2 and DC4 cages, hard reset the cage. FC-AL specifier is ignored. remove Remove the indicated drive cage (indicated with the specifier) from the system.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS None. 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 that causes a dip in throughput. ■ The unstartfc subcommand is provided if a mistake was made when issuing the servicecage command. The unstartfc subcommand stops the original command.
InForm OS Version 2.2.4 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.2.4 OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies a node. This specifier can only be used with the remove subcommand. Specifies a host’s WWN. This specifier can only be used with the remove and copy subcommands. When used with the remove subcommand, this specifier can be repeated.
InForm OS Version 2.2.4 Command Line Interface Reference The following example displays the removal of an inactive host from port 2:1:1: cli% servicehost remove 2:1:1 20000200000CF790 Removing inactive host 20000200000CF790 on port 2:1:1 Are you sure? select q=quit y=yes n=no: y NOTES None. 20.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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. status Specifies that the status of the servicemag command operations on a drive magazine are displayed. clearstatus Clears the log shown by the servicemag command status for the given cage and magazine. OPTIONS –f Specifies that the command is forced.
Command Line Interface Reference InForm OS Version 2.2.4 -pdid ... Specifies one to four physical disks (by physical disk ID) that need to be serviced or replaced. If the -log option is also specified, logging will only apply to the remaining disks on the magazine and not the ones specified in this option. The disks specified in this option will be vacated out to be replaced and will not be logged.
InForm OS Version 2.2.4 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 ..
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 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.19 setcpg 21.21 setdate 21.27 setdomain 21.31 sethost 21.33 setlicense 21.36 setnet 21.38 setnode 21.43 setntp 21.45 Set Commands 21.
Command Line Interface Reference 21.2 InForm OS Version 2.2.4 setpassword 21.47 setpd 21.49 setrcopygroup 21.51 setrcopytarget 21.57 setsnmppw 21.61 setsshkey 21.63 setstatch 21.65 setstatpdch 21.67 setsys 21.68 setsysmgr 21.71 settemplate 21.74 setuser 21.76 setuseracl 21.78 setvv 21.
InForm OS Version 2.2.4 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.2.4 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.2.4 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.2.4 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.2.4 Command Line Interface Reference Table 21-1. Values for Specifiers and 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 the user-dn-base. user-attr Indicates the attribute used to form a DN for simple binding.
Command Line Interface Reference InForm OS Version 2.2.4 Table 21-1. Values for Specifiers and accounts-dn Indicates the base of the subtree in the DIT in which to search for objects that hold account information. It functions mutually exclusively with the groups-dn variable. account-obj The objectClass attribute of an account object. account-name-attr The attribute of an account object that holds the user's username.
InForm OS Version 2.2.4 Command Line Interface Reference Table 21-1. Values for Specifiers and 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.2.4 : 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.2.4 ■ 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.2.4 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.2.4 Command Line Interface Reference –r Specifies that the battery recharge time is reset and that 10 hours of charging time are required for the battery to be fully charged. SPECIFIERS Specifies the node number where the battery is installed. 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).
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND setcage DESCRIPTION The setcage command enables service personnel to set or modify parameters for a drive cage. SYNTAX setcage [option ]... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS None.
InForm OS Version 2.2.4 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.2.4 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.2.4 Command Line Interface Reference -https enable|disable Enables or disables the HTTPS port. -httpsport Sets the HTTPS port (1024 - 65535). The default value is 5989. SPECIFIERS None. RESTRICTIONS ■ 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.2.4 To configure the same port number for both of the HTTP and HTTPS: cli% setcim -httpport 1024 -httpsport 1024 WARNING: CIM server is active and it will restart Are you sure you want to continue? select q=quit y=yes n=no: y Error: Conflict on http and https port NOTES When the CIM server is active, a warning message appears to inform you of the current status of the CIM server and asks you for confirmation to continue or not.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setclienv DESCRIPTION The setclienv command sets the CLI environment parameters. SYNTAX setclienv AUTHORITY Edit, Browse, Service OPTIONS None. SPECIFIERS The specifiers include the parameters and values to which the parameters should be set.
Command Line Interface Reference hafter InForm OS Version 2.2.4 - 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setcpg DESCRIPTION The setcpg command modifies existing common provisioning groups. AUTHORITY Super, Edit, Service NOTE: You need access to all domains in order to run this command. SYNTAX setcpg [options ] OPTIONS –sa Specifies additional logical disks that have already been created to be used for snapshot administration space allocation. The argument can be repeated to specify multiple logical disks.
Command Line Interface Reference InForm OS Version 2.2.4 –sdgs Specifies the growth increment, the amount of logical disk storage created, on each autogrow operation. The amount of disk storage can be specified in MB (default) or GB (using g or G). The default growth increment is fixed at 32 GB, but the minimum growth increment varies according to the number of controller nodes in the system. The following table displays the default and minimum growth increments per number of nodes: Table 21-4.
InForm OS Version 2.2.4 Command Line Interface Reference –ssz Specifies the set size in terms of chunklets. Enter 1 for RAID 0, an integer from 2 through 8 for RAID 1, and an integer from 3 through 9 for RAID 5. If not specified, the default value for RAID 1 is 2 and the default value for RAID 5 is 4. –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed.
Command Line Interface Reference InForm OS Version 2.2.4 –st - Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7). –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).
InForm OS Version 2.2.4 Command Line Interface Reference –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected for logical disk creation. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected for logical disk creation. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected for logical disk creation.
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS Specifies the name of the common provisioning group being modified. RESTRICTIONS None.
InForm OS Version 2.2.4 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.2.4 Specifies the century (CC) and cannot be used unless a year is specified (YY). This specifier is not required on the command line. Specifies a year (YY). This specifier is not required on the command line. <.ss> Specifies seconds (ss). This specifier is not required on the command line. Specifiers can only be used in combinations as listed in Restrictions in the section that follows.
InForm OS Version 2.2.4 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. 21.
Command Line Interface Reference InForm OS Version 2.2.4 The following example verifies the timezone is set to the required setting: cli% showdate Node Date 4 Mon Oct 10 23:14:52 GMT 2005 5 Mon Oct 10 23:14:52 GMT 2005 6 Mon Oct 10 23:14:52 GMT 2005 7 Mon Oct 10 23:14:52 GMT 2005 NOTES Check node dates by issuing the showdate command. See showdate on page 22.29 for additional information. 21.
InForm OS Version 2.2.4 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.2.4 The following example displays the addition of a comment to the domain Engineering: cli% setdomain -comment “This is a comment for engineering.” Engineering NOTES None. 21.
InForm OS Version 2.2.4 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.2.4 OPTIONS -loc Specifies the location of the host. -ip Specifies the IP address of the host. -os Specifies the operating system running on the host. -model Specifies the model of the host. -contact Specifies the owner of the host and contact information. -comment Specifies any additional information for the host. -f Do not ask for confirmation before performing the operation.
InForm OS Version 2.2.4 Command Line Interface Reference SPECIFIERS Name of the host with a maximum of 31 characters in length. Specifies that the properties are set for all hosts matching the specified pattern. The CHAP secret for the host or the target. If -hex is used, the CHAP secret is treated as a hex number. Otherwise it should be a printable ASCII string 12 to 16 spaces in length with no spaces, or 16 bytes in HEX.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference EXAMPLES The following example displays the setting of a license key: cli% setlicense Please enter the new license key below. When finished, press enter twice. If the key is entered by hand, note that characters other than letters and numbers are ignored, and the key is not case-sensitive. 60R3–0C1G... NOTES ■ This command prompts for a new license key. To finish entering the license key, press ENTER on a blank line.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference startgateway Specifies that if there is no gateway currently defined, then the gateway is immediately set to the specified IP address ( specifier). If a gateway is currently defined, then the gateway is switched to the specified IP address, as indicated with the specifier.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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.2.4 the system is configured to listen as both the old and new IP addresses. When a new gateway is specified with the setnet gateway command, the system switches between the old and new gateways when it sees packets addressed to it being routed through those gateways. After a connection has been made with the new configuration, the setnet finish command can be used to remove the old configuration.
InForm OS Version 2.2.4 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 -s SUBCOMMAND ps Sets the power supply properties. OPTIONS -s Specifies the serial number up to eight characters in length. This option is required.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setntp DESCRIPTION The setntp command sets the system network time protocol (NTP) server. 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.46 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 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.2.4 Command Line Interface Reference COMMAND setpd DESCRIPTION The setpd command marks a physical disk as allocatable or non allocatable for logical disks. SYNTAX setpd ldalloc on|off ... AUTHORITY Edit, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS ldalloc on|off Specifies that the physical disk, as indicated with the PD_ID specifier, is either allocatable (on) or nonallocatable for logical disks (off). OPTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 NOTES ■ This command can be used when the system has disks that are not to be used until a later time. ■ Verify the status of physical disks by issuing the showpd command. See showpd on page 22.77. 21.
InForm OS Version 2.2.4 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.2.4 OPTIONS –t Specifies that the setrcopygroup command be applied to all relevant groups of the indicated target. -f Does not ask for confirmation for disaster recovery commands. –nostart Specifies that groups are not started after role reversal is completed through the recover and restore specifiers. –nosync Specifies that groups are not started after role reversal is completed through the recover specifier.
InForm OS Version 2.2.4 Command Line Interface Reference –current When issuing the setrcopygroup command with the reverse subcommand, only the current direction of the groups is reversed. SPECIFIERS Specifies the policy to assign to the group. This specifier can only be used with the pol subcommand. Valid policies are: fail_wrt_on_err Specifies that if Remote Copy is started for the volume group and a write to the secondary system fails, then an I/O error is returned to the host.
Command Line Interface Reference InForm OS Version 2.2.4 If no policy is specified, the no_fail_wrt_on_err and no_auto_recover policies are implemented by default. NOTE: When issuing the setrcopygroup command, either the specifier or the specifier must be specified. Specifies the operation of the group(s). Valid operations are: reverse Changes the natural and current direction of all specified groups.
InForm OS Version 2.2.4 Command Line Interface Reference Specifies the mode, sync or periodic, to which the group is set. This specifier can only be used with the mode subcommand. s|m|h|d Specifies the time period in units of seconds (s), minutes (m), hours (h), or days (d), for automatic resynchronization (e.g. 14h for 14 hours).
Command Line Interface Reference ■ InForm OS Version 2.2.4 If the mirror_config policy is set for this group's target and the group is a primary group, then the setrcopygroup command is mirrored to the target when the period and pol subcommands are used. ■ Use the -nosnap option when the primary server has failed or where the disks are ruined or in an unknown state. For example, an uncontrolled shutdown can result in loss of data.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setrcopytarget DESCRIPTION The setrcopytarget command sets the name, policies, and throughput of a target definition.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS ■ Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information. ■ If the mirror_config policy is set and the setrcopytarget command is issued with the pol subcommand, the duplicated configuration commands cannot be issued on the secondary. Doing so results in an error. ■ The name and tput subcommands cannot be used on a target with started groups.
Command Line Interface Reference InForm OS Version 2.2.4 necessary to temporarily change the policy to no_mirror_config in order to bring the configurations into alignment. After being corrected the mirror_config policy should be immediately restored. Such operations should generally only be undertaken on the advice of a 3PAR representative. 21.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setsnmppw DESCRIPTION The setsnmppw command allows a user to update SNMP access community string 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the setting of a user’s SSH public key: cli% setsshkey NOTES ■ The SSH public key must have been generated by using the SSH-Kegen utility. The public key is contained in your user-specified file name with a .pub extension. This file can be opened using an ASCII editor. ■ Issuing the setsshkey command results in the system prompting for your SSH public key.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setstatch DESCRIPTION The setstatch command starts and stops the statistics collection mode for chunklets. SYNTAX setstatch start|stop AUTHORITY Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for the specified logical disk and chunklet. OPTIONS None. SPECIFIERS Specifies the name of the logical disk in which the chunklet to be configured resides.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND setstatpdch DESCRIPTION The setstatpdch command sets the statistics collection mode for all in-use chunklets on a physical disk. SYNTAX setstatpdch start|stop AUTHORITY Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for chunklets on the specified physical disk used by logical disks. OPTIONS None. SPECIFIERS Specifies the physical disk ID. RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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) 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.
Command Line Interface Reference InForm OS Version 2.2.4 SparingAlgorithm Sets the sparing algorithm used by the admithw command. Valid values are Default, Minimal, Maximal, and Custom. MgmtOldPorts enable|disable Enable or disable listening on the old management ports 2540, and 2550 for SSL. The server now listens on ports 5782, and 5783 for SSL. Default ports 2540 and 2550 were deprecated in the 2.2.4 release and will be changed in a future release.
InForm OS Version 2.2.4 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.2.4 force_iderecovery Specifies that the system starts the recovery process from the IDE disk even if all virtual volumes have not been started. 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 virtual volumes are checked. OPTIONS –f Specifies that the command is forced.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ If the wipe subcommand is specified, all system data and configuration information, including customer data and virtual volume layout, are destroyed. ■ If the force_iderecovery subcommand is specified, the system can delete data for some of the unstarted virtual volumes. The system can run the checkvv and checkld commands to make the virtual volumes and logical disks consistent, thereby resulting in a possible data loss. 21.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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.2.4 COMMAND setuseracl DESCRIPTION The setuseracl command sets the access control list (ACL). SYNTAX setuseracl []... AUTHORITY Edit OPTIONS None. SPECIFIERS Specifies the name of the user whose ACL is being set. Specifies the operation (command) for which the ACL is being defined. Currently, the only value accepted is updatevv, which updates a snapshot with a new snapshot.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example sets the ACL for user testuser1 and allows testuser1 to update the snapshot virtual volumes of virtual volumes vv1 and vv2. cli% setuseracl testuser1 updatevv vv1 vv2 NOTES None. 21.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND setvv DESCRIPTION The setvv command changes the properties associated with a virtual volume. Use the setvv command to modify volume names, volume policies, allocation warning and limit levels, and the volume’s controlling common provisioning group (CPG). SYNTAX setvv [options ] ... AUTHORITY Edit OPTIONS At least one of the following options must be specified: -clrrsv Specifies that all reservation keys (i.e.
InForm OS Version 2.2.4 Command Line Interface Reference no_one_host This policy should only be used when exporting a virtual volume to multiple hosts for use by a cluster-aware application, or when “port presents” VLUNs are used. This is the default policy setting.
Command Line Interface Reference InForm OS Version 2.2.4 -snp_cpg Specifies that the volume snapshot space is to be provisioned from the specified CPG. This option moves all the logical disks currently contained in the snapshot space for these volumes into the CPG. This is permitted only when none of the logical disks are shared with other volumes that are not specified in this option.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS At least one option must be specified. EXAMPLES The following example sets the policy of virtual volume vv1 to no_stale_ss. cli% setvv –pol no_stale_ss vv1 The following example adds volume vv1 to an existing CPG named CPG1.
Command Line Interface Reference 21.84 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 22 Show Commands In this chapter showalert 22.4 showauthparam 22.6 showbattery 22.8 showblock 22.12 showcage 22.15 showcim 22.20 showclienv 22.22 showcpg 22.23 showdate 22.29 showdomain 22.30 showeeprom 22.32 showeventlog 22.35 showfirmwaredb 22.39 showhost 22.43 Show Commands 22.
Command Line Interface Reference 22.2 InForm OS Version 2.2.4 showiscsisession 22.47 showld 22.49 showldch 22.55 showldmap 22.60 showlicense 22.62 shownet 22.64 shownode 22.66 shownodeenv 22.73 showpatch 22.75 showpd 22.77 showpdata 22.88 showpdch 22.89 showpdvv 22.95 showport 22.96 showportarp 22.105 showportdev 22.107 showportisns 22.110 showportlesb 22.112 showrcopy 22.118 showrctransport 22.123 showrsv 22.126 showsnmppw 22.128 showsnmpmgr 22.
InForm OS Version 2.2.4 Command Line Interface Reference showsysmgr 22.144 showtarget 22.147 showtask 22.148 showtemplate 22.152 showtoc 22.154 showtocgen 22.156 showuser 22.157 showuseracl 22.159 showuserconn 22.160 showversion 22.162 showvlun 22.164 showvv 22.169 showvvmap 22.178 showvvpd 22.180 22.
Command Line Interface Reference InForm OS Version 2.2.4 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 –n|–a|–f|-all –n Specifies that only new alerts are displayed. –a Specifies that only acknowledged alerts are displayed. –f Specifies that only fixed alerts are displayed. –d Specifies that detailed information is displayed.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays new alerts on a system: cli% showalert -n Id : 1 State : New Time : Mon Apr 10 19:40:42 PDT 2007 Severity : Degraded Type : PR transition Component : persistent_repository:0 Message : The PR is currently getting data from the local disk on node 1, not the admin volume. Previously recorded alerts will not be visible till the PR transitions to the admin volume.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showauthparam DESCRIPTION The showauthparam command shows authentication parameters. SYNTAX showauthparam AUTHORITY Super OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference The columns in the previous example are identified as follows: ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID. ■ Serial. The battery serial number. ■ State. The current status of the battery. Battery states can be as follows: ◆ --. Cannot determine the battery state. ◆ NotPresent. Battery is missing. ◆ OK. Battery is operating normally. ◆ Failed. Battery is operating abnormally.
Command Line Interface Reference InForm OS Version 2.2.4 The following example displays the inventory information for the battery using the showbattery –i command: cli% showbattery -i Node PS Bat -Manufacturer0 0 0 -0 1 0 -1 0 0 -1 1 0 -- -Model----- -SerialFFFFFFFF FFFFFFFF --- ■ Node. The controller node number. ■ PS. The power supply number. ■ Manufacturer. The manufacturer of the battery. ■ Model. The battery model. ■ Serial. Indicates the serial number of the battery.
InForm OS Version 2.2.4 ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID. ■ Test. The current status of the battery. ■ Result. The battery status, shows as passed or failed. ■ Dur(mins). Indicates the length of time for the results to return. ■ Time. Indicates the time of the last battery test. Command Line Interface Reference NOTES ■ Battery information is set by issuing the setbattery command. See setbattery on page 21.12 for more information.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showblock DESCRIPTION The showblock command displays block mapping information for virtual volumes, logical disks, and physical disks. AUTHORITY Super, Service, Edit, Browse SYNTAX showblock [options ] [] OPTIONS –d Specifies that detailed information is displayed for the specified device and block.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays block mapping information for block 0 in the user space of virtual volume 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.2.4 The following example displays detailed block mapping information from blocks 0x100 through 0x400 in the user space of virtual volume 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.2.4 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]] [...] 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.2.4 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. RESTRICTIONS None. EXAMPLES The following examples display information for a single system’s drive cages: cli% showcage Id Name LoopA Pos.A LoopB Pos.
InForm OS Version 2.2.4 Command Line Interface Reference ■ Model. The model can be DC2, DC3, or DC4. ■ Side. Specifies the right (1) or left (0) side of the drive cage. Specifying the –d option provides more detailed information about the drive cages. See the following E-Class Storage Server example for cage0: cli% showcage -d Id Name LoopA Pos.A LoopB Pos.
Command Line Interface Reference InForm OS Version 2.2.4 Specifying the –d option provides more detailed information about the drive cages. See the following 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 ■ 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.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showclienv DESCRIPTION The showclienv command displays the CLI environment parameters. SYNTAX showclienv AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showcpg DESCRIPTION The showcpg command displays common provisioning groups (CPGs) in the system. AUTHORITY Super, Service, Edit, Browse SYNTAX showcpg [options ] [...|...] OPTIONS –r Specifies that raw space used by the CPGs is displayed. –alert Indicates whether alerts are posted. –alerttime Show times when alerts were posted (when applicable).
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS [...|...] Specifies that common provisioning groups matching either the specified common provisioning group name or those common provisioning groups matching the specified pattern are displayed. This specifier can be repeated to display information for multiple common provisioning groups. If not specified, all common provisioning groups in the system are displayed. See Glob-Style Pattern on page 2.
InForm OS Version 2.2.4 Command Line Interface Reference ◆ LDs. The number of logical disks used for snapshot data space. ◆ TotMB. The total snapshot data space in MBs. ◆ UseMB. The total used snapshot data space in MBs. The following example displays the common provisioning group’s snapshot administration space’s autogrowth parameters: cli% showcpg –sag Id Name 0 guicpg1 1 clicpg2 WarnMB - LimitMB - GrowMB 2048 2048 Args –ssz 2 The columns in the previous example are defined as follows: ■ Id.
Command Line Interface Reference InForm OS Version 2.2.4 ■ LimitMB. The CPG’s snapshot data allocation limit threshold, or growth limit. ■ GrowMB. The CPG’s snapshot data space allocation limit threshold. ■ Args. The options used in the creation of the CPG.
InForm OS Version 2.2.4 ◆ TotMB. The total logical disk MB in the SD space. ◆ RTotMB. The total physical (raw) MB in the SD space. ◆ UseMB. The number of logical disk MB used in the SD space. ◆ RUseMB. The total physical (raw) MB used in the SD space.
Command Line Interface Reference ■ Sa. The values for the Snapshot Admit Space (SA). ■ Sd. The values for the Snapshot Data Space (SD). ◆ LDs. The number of logical disks in the SA/SD space. ◆ TotMB. The total logical disk MB in the SA/SD space. ◆ RTotMB. The total physical (raw) MB in the SA/SD space. ◆ UseMB. The number of logical disk MB used in the SA/SD space. ◆ RUseMB. The total physical (raw) MB used in the SA/SD space. InForm OS Version 2.2.
InForm OS Version 2.2.4 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. EXAMPLES The following example displays the date and time for the system node: cli% Node 0 1 showdate Date Mon Apr 17 17:07:44 PDT 2007 Mon Apr 17 17:07:44 PDT 2007 NOTES Set date and time information on nodes by issuing the setdate command.
Command Line Interface Reference InForm OS Version 2.2.4 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. You must specify a column number.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays detailed information about a system’s domains: cli% showdomain -d ID Domain --------CreationTime-------- ---Comments---1 TestDomain Tue Jun 12 15:39:44 PDT 2007 blah blah blah. In the example above: ■ ID. The domain ID. ■ Domain. The domain name. ■ CreationTime. The date and time the domain was created. ■ Comments. Information about the domain. NOTES None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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. This option cannot be used with P3 node clusters. SPECIFIERS ...
InForm OS Version 2.2.4 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.2.4 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.2.4 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 minimum value must be greater than 0. –more Specifies that you can page through several events at a time.
Command Line Interface Reference InForm OS Version 2.2.4 –endt
InForm OS Version 2.2.4 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.2.
InForm OS Version 2.2.4 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.
Command Line Interface Reference RESTRICTIONS None. 22.40 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 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 Firmware_File HITACHI [C1C1] DK..DJ-18FC Current DC4 /opt/tpd/fw/drive/MDJFC1C1.BIN HITACHI [C1C1] DK..DJ-72FC Current DC4 /opt/tpd/fw/drive/MDJFC1C1.BIN HITACHI [JLAK] DK..CJ-18FC Current DC4 /opt/tpd/fw/drive/MCJF_LAK.BIN HITACHI [JLAK] DK..
Command Line Interface Reference InForm OS Version 2.2.4 NOTES The firmware information displayed by the showfirmwaredb command is used when issuing the upgradecage and upgradepd commands. See upgradecage on page 30.2 and upgradepd on page 30.4 for more information. 22.
InForm OS Version 2.2.4 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. -verbose Shows a verbose listing of all host information. -chap Shows the CHAP authentication information. -desc Shows the host descriptor information.
Command Line Interface Reference InForm OS Version 2.2.4 ... Specifies that properties are set for all hosts matching the specified glob-style pattern. This specifier can be repeated to set properties for multiple hosts using different patterns. RESTRICTIONS None. EXAMPLES NOTE: For the following two examples, the Domain column appears only if the -listdom global option or TPDLISTDOM environment variable was set prior to starting the CLI.
InForm OS Version 2.2.
Command Line Interface Reference ■ Host descriptor information is available only for hosts that have been assigned a name through the createhost command. 22.46 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 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. You must specify a column number.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays the iSCSI session information: cli% showiscsisession N:S:P ---IPAddr---- TPGT TSIH Conns ------------iSCSI_Name------------ ---------StartTime---------1:3:1 192.168.2.181 131 13 1 iqn.1991-05.com.microsoft:pe750-07 Tue Nov 29 12:43:25 PST 2005 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showld DESCRIPTION The showld command displays configuration information about the system’s logical disks. 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.
Command Line Interface Reference InForm OS Version 2.2.4 M–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. –d Requests that more detailed layout information is displayed.InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays information for all system logical disks: cli% showld Id Name RAID State Own SizeMB UsedMB Use Lgct LgId WThru MapV 0 log0.0 1 normal 0/- 20480 0 log 0 --Y N 1 log1.0 1 normal 1/- 20480 0 log 0 --Y N 2 pdsld0.0 1 normal 0/1 8192 0 P,F 0 --Y N 3 admin.usr.0 1 normal 0/1 5120 5120 V 0 --N Y 4 admin.usr.1 1 normal 1/0 5120 5120 V 0 --N Y 5 VV111.usr.0 0 normal 0/1 256 256 V 0 --N Y 6 VV111.usr.
Command Line Interface Reference InForm OS Version 2.2.4 ◆ stopping. The logical disk is being stopped; normally flushes any in-flight data to disk. ◆ 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.
InForm OS Version 2.2.4 Command Line Interface Reference The following example displays detailed information about the system logical disks: cli% showld -d Id Name CPG RAID Own SizeMB RSizeMB RowSz StepKB SetSz Refcnt Avail CAvail -----CreationTime-----0 log0.0 --1 0/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST 1 log1.0 --1 1/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST 2 pdsld0.0 --1 0/1 4096 8192 2 256 2 0 mag mag 2007-11-29 18:44:03 PST 3 admin.usr.
Command Line Interface Reference ◆ InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showldch DESCRIPTION The showldch command displays configuration information about the chunklet mapping for one logical disk. SYNTAX showldch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -degraded Show only the chunklets in sets that cause the logical disk availability to be degraded.
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS Specifies the logical disk name, using up to 27 characters. RESTRICTIONS None. EXAMPLES The following example displays information about chunklets for logical disk r1.usr.0: cli% showldch r1.usr.
InForm OS Version 2.2.4 Command Line Interface Reference ◆ 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.
Command Line Interface Reference InForm OS Version 2.2.4 The following example displays information about degraded chunklets for logical disk 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.
InForm OS Version 2.2.4 Command Line Interface Reference The following example displays row and set layout including pdid and pdpos for chunklets for logical disk test.usr.0. cli% showldch -lformat set -linfo pdid,pdpos test.usr.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showldmap DESCRIPTION The showldmap command displays the mapping from a logical disk to virtual volumes. SYNTAX showldmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the logical disk name, using up to 27 characters. RESTRICTIONS None. EXAMPLES The following example displays the region of logical disk v0.usr.0 that is used for a virtual volume: cli% showldmap v0.usr.
InForm OS Version 2.2.4 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 (sd), or snapshot administration (sa)-for which the region is being used. ■ VVOff(MB). The offset from the beginning of the space that contains the region. NOTES None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.
Command Line Interface Reference InForm OS Version 2.2.4 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. AUTHORITY Super, Service, Edit, Browse SYNTAX shownet [option] OPTION –d Displays detailed information. SPECIFIERS None. RESTRICTIONS None. 22.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays the status of the system administration network interfaces: cli% shownet –d IP Address: 192.168.5.191 Assigned to nodes: 01 Connected through node 0 Status: Active Netmask 255.255.252.
Command Line Interface Reference InForm OS Version 2.2.4 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, drives, and power supplies. SYNTAX shownode [option] [...
InForm OS Version 2.2.4 Command Line Interface Reference -drive Displays the disk drive information. –ide The -ide option was deprecated in the 2.2.4 release and will be changed or removed in a future release. Use the -drive option to display the disk drive information. –ps Displays power supply information. SPECIFIERS ... Displays the node information for the specified node ID(s). This specifier is not required. RESTRICTIONS None.
Command Line Interface Reference ◆ InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 ■ Serial. The serial number of the PCI card. ■ Rev. The revision number of the PCI card. ■ Firmware. The firmware version on the PCI card. Command Line Interface Reference 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.
Command Line Interface Reference ■ ■ ■ ■ ■ ◆ OK. The power supply is operating normally. ◆ Failed. The power supply is operating abnormally. ◆ NotPresent. The power supply is missing. ◆ Degraded. There is a fan failure, or the battery state is not OK. FanState. The power supply fan state. Values can be: ◆ --. Cannot determine the state. ◆ OK. The fan is operating normally. ◆ Failed. The fan is operating abnormally. ACState. The state of the AC power. Values can be: ◆ --.
InForm OS Version 2.2.4 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.2.4 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.2.4 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.2.4 ■ 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.2.4 Command Line Interface Reference COMMAND showpd DESCRIPTION The showpd command displays configuration information about a system’s physical disks. SYNTAX showpd [-i|-e|-c|-s|-space] [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –i|–e|–c|-s|-space Specifies that either physical disk inquiry information, environment information, or chunklet use information is displayed. –i Specifies a request for disk inquiry data.
Command Line Interface Reference InForm OS Version 2.2.4 –sortcol
[,][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order. –failed Specifies that only failed physical disks are displayed.InForm OS Version 2.2.4 Command Line Interface Reference –p Physical disks matching the specified pattern are displayed. The following arguments can be specified as patterns for this option: NOTE: An item is specified as an integer, a comma-separated list of integers, or a range of integers specified from low to high. –nd - Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3).
Command Line Interface Reference InForm OS Version 2.2.4 –pn - Specifies one or more disk positions within a drive magazine. Disk positions are identified by one or more integers (item). Multiple disk positions are separated with a single comma (1,2,3). A range of disk positions is separated with a hyphen (0–3). Disks must reside in the specified position(s). –dk
- Specifies one or more physical disks. Disks are identified by one or more integers (item).
InForm OS Version 2.2.4 Command Line Interface Reference –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel or NL for Nearline). Device types can be displayed by issuing the showpd –i command. When creating a logical disk, all physical disks used must have the same device type. -rpm Disks must be of the specified speed. Device speeds are shown in the K_RPM column of the showpd -i command.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 ■ Command Line Interface Reference ◆ invdrvblksz. The drive block size is invalid. Valid block size is 512 bytes. ◆ invdrvcp. The drive capacity size is invalid. ◆ notready. The disk is not ready. ◆ new. The disk is new. ◆ failed. The disk has failed. APort. The port location for the A port of the physical disk. If the primary path, the port location is followed by an asterisk (*). If disabled, the port location is followed by a dash (-). ■ BPort.
Command Line Interface Reference InForm OS Version 2.2.4 ■ Serial. Disk manufacturer’s serial number. ■ FW_status. Indicates whether the physical disk firmware is current or not current. ■ Type. Indicates the device type for the physical disk that might be FC for a Fibre Channel drive or NL for a nearline drive. ■ K_RPM. Indicates the speed at which the disks are spinning. Higher performance drives generally have higher RPM rates. Valid values are 7, 10 and 15.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Total. Number of chunklets on the physical disk. Each chunklet occupies 256 MB of contiguous space. ■ OK. Number of chunklets with data that is accessible to the system. ■ Fail. Number of failed chunklets. ■ Free. Number of initialized but currently unused chunklets available for use by logical disks. ■ Uninit. Number of chunklets being cleaned.
Command Line Interface Reference InForm OS Version 2.2.4 ■ Corr_Rd_er. Number of chunklets with correctable read errors. ■ UnCor_rd_er. Number of chunklets with uncorrectable read errors. ■ Corr_Wt_er. Number of chunklets with correctable write errors. ■ Uncor_wt_er. Number of chunklets with uncorrectable write errors. ■ T(C). Temperature in degrees celsius.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ In the showpd output, when the position of the disk is not valid (for example, in the case of a missing disk), the most recent position might be displayed, followed by a question mark (?). ■ Previous options –n , –s , and –p were deprecated and replaced with –nodes , –slots , and – ports .
Command Line Interface Reference InForm OS Version 2.2.4 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 is displayed. This specifier is not required on the command line. If not specified, then the amount of preserved data by logical disk is displayed. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showpdch DESCRIPTION The showpdch command displays the status of selected physical disk chunklets. SYNTAX showpdch [options] ... AUTHORITY Super, Service, Edit, Browse OPTIONS –a Specifies that information about all chunklets is displayed. –ld Specifies that information about chunklets used for logical disks are displayed. This is the default behavior of the showpdch command.
Command Line Interface Reference InForm OS Version 2.2.4 –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. –sync Specifies that information about chunklets that are synchronizing with their RAID sets is displayed. SPECIFIERS ...
InForm OS Version 2.2.4 Command Line Interface Reference –st - Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–7). The primary path of the disks must be on the specified PCI slot number(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).
Command Line Interface Reference InForm OS Version 2.2.4 –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected for logical disk creation. The total number of chunklets on the disks must be greater than the specified number. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected for logical disk creation. The total number of chunklets on the disks must be less than the specified number.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS If no option is specified, the showpdch command defaults to displaying information about chunklets used for logical disks (–ld). EXAMPLES The following example displays information about chunklets on physical disk 1: cli% showpdch 1 Pdid Chnk LdName LdCh State Usage Media Sp Cl From To 1 0 admin.usr.2 11 normal ld valid N N ----1 1 admin.usr.2 23 normal ld valid N N ----1 2 admin.usr.
Command Line Interface Reference InForm OS Version 2.2.4 ◆ available. The chunklet is available for use as a spare or as a logical disk. ◆ ld. The chunklet is in use by a logical disk. ◆ synch. The chunklet is both the source and the target of a logical disk relocation operation (synchronizing the chunklet). ◆ cmprel. The system is completing the logical disk relocation operation. ◆ relsrc. Relocation source. The data has been moved to another chunklet. ◆ reltgt. Relocation target.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showpdvv DESCRIPTION The showpdvv command displays the virtual volumes that are mapped to a particular physical disk. SYNTAX showpdvv [] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the physical disk ID using an integer. [] Specifies the chunklet number in a physical disk to which virtual volumes are mapped. This specifier is not required. RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 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 [-i|-c|-par|-rc|-rcfc|-rcip|-iscsi|-iscsiname] [-failed] [-sortcol
[,]] ■ showport -sfp [-d] [-ddm] [-failed] [-sortcol [,]] AUTHORITY Super, Service, Edit, Browse OPTIONS -i Show hardware and connection information.InForm OS Version 2.2.4 Command Line Interface Reference -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 the 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. This option is used with the –sfp option.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference ◆ non_participate. Port is logically isolated from the Fibre Channel loop. ◆ offline. The port is offline. ◆ pending_reset. A reset of the port has been scheduled, but not yet completed. ■ Node_WWN. The WWN that belongs to the controller node identified in the N:S:P column. ■ Port_WWN/HW_Addr. The WWN that belongs to the controller node port identified in the N:S:P column. ■ Type. Indicates the port connection type. ◆ host.
Command Line Interface Reference ■ InForm OS Version 2.2.4 Mode. Indicates whether the port is an initiator or a target. Initiators connect to disks (default) and target ports connect to hosts or fabrics. A target port that has yet to be initialized by the system appears as suspended. ■ Device. The device connected to the port, for example cage0. ■ Pos. The position of the device, 0 or 1. ■ Config. The validity of the port configuration. Values are valid or invalid. ■ Topology. The link topology.
InForm OS Version 2.2.4 ■ Command Line Interface Reference MaxRate. Indicates the maximum bit rate of transfer between the HBA and the host or disk. ■ Class2. Identifies whether class 2 is enabled (ack0 or ack1) or disabled. ■ VCN. VLUN State Change Notification support setting. Valid values are n/a, enabled or disabled. When enabled and in public loop or fabric topology, a Registered State Change Notification (RSCN) message is issued to the fabric controller whenever a VLUN is created or removed.
Command Line Interface Reference InForm OS Version 2.2.4 ■ Rate. Data transfer rate (bitrate) for the Remote Copy interface. ■ Type. Indicates the port connection type. ◆ rcip. Port is used for Remote Copy over IP (RCIP).
InForm OS Version 2.2.4 Command Line Interface Reference ■ Rate. Data transfer rate for the Remote Copy interface. ■ Duplex. Values can be either Full or Half. ■ AutoNeg. 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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 using a number from 0 through 7.
Command Line Interface Reference InForm OS Version 2.2.4 In the example output above: ■ 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 slot Specifies the PCI bus slot in the specified node using a number from 0 through 5. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot using 1 to 4. RESTRICTIONS The loop subcommand is functional only in a private loop topology.
InForm OS Version 2.2.4 ■ Command Line Interface Reference flen. The maximum received frame length that is located in PLOGI_ACC class-3 word 1, bits 15-0. NOTES None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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 using a number from 0 through 7.
InForm OS Version 2.2.4 Command Line Interface Reference Where ■ 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference diffhist Displays differences between historical samples of LESB counters on the specified port of loop devices. OPTIONS –startt
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS Specifies a port. 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 using a number from 0 through 7. slot Specifies the PCI bus slot in the specified node using a number from 0 through 5.
InForm OS Version 2.2.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 ■ Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
Command Line Interface Reference InForm OS Version 2.2.4 ■ 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.
InForm OS Version 2.2.4 ◆ Starting. Currently attempting to start the group. ◆ Started. Group is started (has Remote Copy running). ◆ Stopped. Group was stopped. Command Line Interface Reference ■ 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.
Command Line Interface Reference ■ InForm OS Version 2.2.4 To limit the performance impact of Remote Copy on the rest of the InServ storage system, the number of volumes that are concurrently synchronizing is limited to 20 volumes. This limit is not user-configurable and applies to the initial synchronization as well as subsequent resynchronizations for synchronous as well as asynchronous periodic groups.
InForm OS Version 2.2.4 Command Line Interface Reference 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-end-transport. SPECIFIERS None. RESTRICTIONS None.
Command Line Interface Reference ■ InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 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.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showrsv DESCRIPTION The showrsv command displays SCSI reservation and registration information for 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. If this option is not specified, information about both SCSI–2 and SCSI–3 is displayed.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. SYNTAX showsnmppw [options] AUTHORITY Super, Service, 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.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES SNMP passwords are registered using the setsnmppw command. See setsnmppw on page 21.61 for more information. 22.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showsnmpmgr DESCRIPTION The showsnmpmgr command retrieves a list of registered SNMP software frameworks (managers) for receiving alerts (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 Host IP 82.185.98.76 82.162.9.7 Port 162 8004 In the example above: Host IP.
InForm OS Version 2.2.4 Command Line Interface Reference ■ 0 indicates that the trap manager list was retrieved and 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.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation.
InForm OS Version 2.2.4 Command Line Interface Reference –ss Specifies the step size in kilobytes using 32, 64, 128, 256, or 512. If no value is entered, the step size defaults to 256 KB for RAID 10 and 128 KB for RAID 50. –ha port|cage|mag Specifies that RAID 10 or 50 can support a failure of a drive cage (cage) or drive magazine (mag). If cage is specified, chunklets from different drive cages are used within a RAID set.
Command Line Interface Reference InForm OS Version 2.2.4 –cg - Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3). A range of drive cages is separated with a hyphen (0–3). –mg
- Specifies one or more drive magazines. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (1,2,3).
InForm OS Version 2.2.4 Command Line Interface Reference –devid Specifies that physical disks identified by their device IDs are selected for virtual volume and logical disk creation. Device IDs can be specified in a comma-separated list. Issue the showpd –i command for a list of physical disk device IDs for use with the –devid option. –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel or NL for Nearline).
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showspare DESCRIPTION The showspare command displays information about chunklets in the system that are reserved for spares and previously free chunklets selected for spares by the system. SYNTAX showspare AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
InForm OS Version 2.2.4 ■ LdCh. The position of the chunklet on the logical disk. ■ State. The state of the chunklet as identified by the kernel. Command Line Interface Reference ◆ 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.
Command Line Interface Reference ■ InForm OS Version 2.2.4 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. The destination location of the chunklet during relocation. NOTES None. 22.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showsys DESCRIPTION The showsys command displays an overview of the InServ Storage Server capacity and connectivity. 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, including the RawSpaceAlert setting, are displayed. See setsys on page 21.68 for information on setting the RawSpaceAlert threshold.
Command Line Interface Reference InForm OS Version 2.2.4 SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays information about an InServ Storage Server: cli% showsys ---------------(MB)---------------ID -Name- ---Model--- -Serial- Nodes Master TotalCap AllocCap FreeCap FailedCap 15 s015 InServ S200 1000015 2 0 1063424 208384 855040 0 In the previous example: ■ ID. The system ID. ■ Name. The system name. ■ Model. The model type of the InServ server. ■ Serial.
InForm OS Version 2.2.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference (PR). If the PR is not available (most likely because of problems with the admin volume), the output reads (from default settings) and the values displayed would indicate the system defaults. When (from default settings) is displayed, you will not be able to update system parameters. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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.2.4 disks and virtual volumes upon restarting. See setsysmgr on page 21.71 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.2.4 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.2.4 COMMAND showtask DESCRIPTION The showtask command displays information about tasks. By default, this command displays all tasks on the system. SYNTAX showtask [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –done Display includes only tasks that are successfully completed. –failed Display includes only tasks that are unsuccessfully completed. –active Display includes only tasks that are currently in progress.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays all tasks on a system. In this case, the last task is still in progress.
Command Line Interface Reference ■ InForm OS Version 2.2.4 ◆ Cancelled. The task was canceled by you. ◆ Failed. The task failed to complete because of a reason other than user cancelation. Phase. For Active tasks, indicates the number of completed phases and the total number of phases in the current step, using the syntax <#completed_phase>/ <#total_phases>. Note that each step is composed of an arbitrary number of phases. ■ Step.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ See the InForm OS CLI Administrator’s Manual for additional information and examples regarding task management and task management commands, as well as information about Dynamic Optimization. ■ By default, this command shows all tasks that started within the last 24 hours. ■ The system stores information for the most recent 1000 tasks. Task ID numbers roll at 99999. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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 Virtual Volume (VV), Logical Disk (LD), or Common Provisioning Group (CPG) template.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES If no options are specified, all existing templates are displayed. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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).
Command Line Interface Reference InForm OS Version 2.2.4 OPTIONS -k Shows when users have set a public SSH key. -oneline Shows all information about a user on one line. SPECIFIERS Specifies your login name, using up to 31 characters. This specifier is not required on the command line. If no specifier is used, information about all users is displayed. RESTRICTIONS Users with privilege levels of Browse and Service can only display the current user.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showuseracl DESCRIPTION The showuseracl command displays a user’s access control list (ACL). SYNTAX showuseracl AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showuserconn DESCRIPTION The showuserconn command displays information about users who are currently connected (logged in) to the InServ Storage Server. AUTHORITY Super, Service, Edit, Browse SYNTAX showuserconn [options ] OPTIONS -current Shows all information about the current connection only. –sortcol [,][:[,]...] Sorts command output based on column number .
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 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. –gpv Show the InForm Management Console interface version. –s Show release version number only (useful for scripting).
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays comprehensive information about the system software: cli% showversion Release version 2.2.4.15 (DEVEL) Patches: None Component Name CLI Server CLI Client GUI Server System Manager Kernel TPD Kernel Code Version 2.2.4 2.2.4 2.2.4 2.2.4 2.2.4 2.2.4 NOTES ■ When displaying all versions, for certain components multiple versions might be installed. In such cases, multiple lines are displayed.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showvlun DESCRIPTION The showvlun command displays information about VLUNs in the system, such as all active and template VLUNs. The display is divided into two sections: the upper provides information about active VLUNs and the lower provides information about VLUN templates. SYNTAX showvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –lvw Show the WWN of the virtual volume associated with the VLUN.
InForm OS Version 2.2.4 Command Line Interface Reference –nodes Requests that only VLUNs for specific nodes are displayed. The node list is specified as a series of integers separated by commas (for example 0,1,2). The list can also consist of a single integer (for example 1). –slots Requests that only VLUNs for specific slots are displayed. The slot list is specified as a series of integers separated by commas (for example 0,1,2).
Command Line Interface Reference RESTRICTIONS None. 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.
InForm OS Version 2.2.4 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.2.4 Previous options –n , –s , and –p were deprecated and replaced with –nodes , –slots , and -ports . ■ 22.168 See Glob-Style Pattern on page 2.4 for more information.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND showvv DESCRIPTION The showvv command displays information about all virtual volumes or a specific virtual volume in a system. SYNTAX showvv [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -cpg {}... Displays virtual volumes belonging to a common provisioning group (CPG) or pattern as indicated with either the or specifier.
Command Line Interface Reference InForm OS Version 2.2.4 using a comma-separated list (for example -domain ,...). –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.
InForm OS Version 2.2.4 Command Line Interface Reference –snapspace Displays the snapspace for the virtual volume. –cpgalloc Shows CPGs from which a virtual volume is allocated, if any. The following option can be specified to add additional columns to the output: -rcopy Adds RcopyStatus and RcopyGroup columns. 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.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays information about all virtual volumes: cli% showvv Id Name Domain Type CopyOf BsId Rd State AdmMB SnapMB userMB 0 admin Base --0 RW started 0 0 10240 1 par d1 Base,cpvv --1 RW started 128 512 16384 2 copy PhCp par 2 RW started 0 0 16384 3 vvcp.1.
InForm OS Version 2.2.4 ■ Command Line Interface Reference BsID. If the virtual volume is a base volume or a physical copy, the base volume ID number is the same as the ID number in the Id column. If the virtual volume is a virtual copy, the column shows the base volume from which the copy was made. ■ Rd. Indicates whether the virtual volume is read/write (RW) or read-only (RO). ■ State. Indicates the current status of the virtual volume. ◆ preserved.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference ■ Name. The name of the virtual volume. ■ 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. 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. ■ Type.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 ◆ ■ Command Line Interface Reference PhCp. The virtual volume is a physical copy. BsID. If the virtual volume is a base volume or a physical copy, the base volume ID number is the same as the ID number in the Id column. If the virtual volume is a virtual copy, the column shows the base volume from which the copy was made. ■ VirtMB. The virtual space in megabytes. ■ AdmMB. The administrator space in megabytes. ■ UsedAdm.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showvvmap DESCRIPTION The showvvmap command displays information about how virtual volume regions are mapped to logical disks. SYNTAX showvvmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the virtual volume name, using up to 31 characters. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference The columns in the previous example are identified as follows: ■ Space. The type of the space (user (usr), snapshot data (sd), or snapshot administration (sa)) 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.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND showvvpd DESCRIPTION The showvvpd command displays virtual volume distribution across physical disks. 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.
InForm OS Version 2.2.4 Command Line Interface Reference information for all virtual volumes in the system is displayed. See Glob-Style Pattern on page 2.4 for more information. RESTRICTIONS None. 22.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays information about multiple virtual volumes. 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.2.4 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 virtual volumes are interleaved across the same logical disks and share the same chunklets. The following example displays the distribution of space for a single virtual volume (multi.0): cli% showvvpd multi.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference for all the virtual volumes that match the or list. This can be useful in determining how evenly the virtual volume is striped across the disks. ■ Note that not all the data in the chunklets is necessarily allocated exclusively to the selected virtual volumes. In some cases, only part of a chunklet could be data that is allocated for the virtual volumes. 22.
Command Line Interface Reference 22.186 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 COMMAND shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot [option] AUTHORITY Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the nodes are halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the nodes are restarted after shutdown.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example shuts down system node 0 and halts the restarting of the node: cli% shutdownnode halt 0 NOTES ■ When issuing the shutdownnode command without the –f option, the system manager executes a set of validation checks before proceeding with the shutdown.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND shutdownsys DESCRIPTION The shutdownsys command shuts down an entire system. SYNTAX shutdownsys halt|reboot [option] AUTHORITY 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.2.4 Command Line Interface Reference EXAMPLES The following example shuts down and then restarts the system: cli% shutdownsys reboot NOTES ■ 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.139) to display the current status of the system during the initial stage of the shutdown process and after the system has fully restarted.
Command Line Interface Reference 23.6 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 24 Start Commands In this chapter startcim 24.2 startld 24.3 startrcopy 24.4 startrcopygroup 24.5 startvv 24.7 Start Commands 24.
Command Line Interface Reference InForm OS Version 2.2.4 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 Service NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example starts the CIM server: cli% startcim CIM server will start in about 90 seconds. NOTES ■ ■ 24.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND startld DESCRIPTION The startld command starts data services on a logical disk that has not yet been started. SYNTAX startld [option] AUTHORITY 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 logical disk name, using up to 27 characters. RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND startrcopy DESCRIPTION The startrcopy command enables Remote Copying. SYNTAX startrcopy AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND startrcopygroup DESCRIPTION The startrcopygroup command turns on Remote Copy for the specified Remote Copy volume group. SYNTAX startrcopygroup [options] AUTHORITY Super, Edit OPTIONS –wait The system generates an event when the synchronization is completed. –nosync Prevents the initial synchronization and sets the virtual volumes to a synchronized state. SPECIFIERS The name of the Remote Copy volume group.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference COMMAND startvv DESCRIPTION The startvv command starts data services on a virtual volume that has not yet been started. SYNTAX startvv [option] AUTHORITY 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 virtual volume name, using up to 31 characters. RESTRICTIONS None.
Command Line Interface Reference 24.8 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 25 Stat Commands In this chapter statch 25.2 statcmp 25.8 statcpu 25.10 statiscsi 25.12 statiscsisession 25.16 statld 25.18 statlink 25.23 statpd 25.25 statport 25.33 statrcopy 25.38 statvlun 25.41 statvv 25.47 Stat Commands 25.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND statch 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.2.4 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.2.4 Specifies that statistics for read and write totals are displayed. The meas argument can be specified with one of the following arguments: 25.
InForm OS Version 2.2.4 Command Line Interface Reference iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. svct Specifies that statistics for service time in milliseconds are displayed.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 ■ Command Line Interface Reference Util % Avg. The percentage of average use. NOTES ■ 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.65 for information about the setstatch command. 25.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND statcmp DESCRIPTION The statcmp command displays Cache Memory Page (CMP) statistics by node or by virtual volume. SYNTAX statcmp [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Specifies that CMP statistics by virtual volume instead of by node are displayed. By default, all virtual volumes are displayed unless the –n option is specified.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS None.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 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.2.4 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.2.4 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.2.4 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.2.4 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.2.4 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.2.4 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.2.4 COMMAND statld DESCRIPTION The statld command displays read/write (I/O) statistics about logical disks in a timed loop. SYNTAX statld [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain {}... Shows only logical disks that are in domains with names that match any of the names or specified patterns.
InForm OS Version 2.2.4 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.2.4 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. If this argument is used, the minimum threshold value must be specified using the value argument.
InForm OS Version 2.2.4 Command Line Interface Reference SPECIFIERS ... Only statistics are displayed for the specified logical disk or pattern. Multiple logical disks or patterns can be repeated (for example ...). RESTRICTIONS None.
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.2.
InForm OS Version 2.2.4 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.2.4 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.2.4 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 –i Specifies that statistics for a particular physical disk identified by an integer are displayed. –w Specifies that statistics for a particular physical disk identified by WWN are displayed.
Command Line Interface Reference InForm OS Version 2.2.4 –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.2.4 Command Line Interface Reference The type argument can be specified with one of the following arguments: curs Specifies that only current statistics are displayed. avgs Specifies that only averages are displayed. maxs Specifies that only statics for maximum values are displayed. 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.
Command Line Interface Reference InForm OS Version 2.2.4 [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. An example of this option in use is –filt curs,r,iops,10k that indicates that statistics for a device that has more than 10,000 current read-only I/O operations are displayed.
InForm OS Version 2.2.4 Command Line Interface Reference 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). A range of drive cages is separated with a hyphen (0–3). Disks must reside in the specified drive cage(s). –mg
- Specifies one or more drive magazines.
Command Line Interface Reference InForm OS Version 2.2.4 –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected for virtual volume and logical disk creation. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected for virtual volume and logical disk creation. –devid Specifies that physical disks identified by their device IDs are selected for virtual volume and logical disk creation.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays one iteration of I/O statistics for all physical disks: 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.0 0 0 0 5 0:0:2 t 0 0 0 0 0 0 0.
Command Line Interface Reference ■ 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. The percentage of current use. ■ Util % Avg. The percentage of average use. InForm OS Version 2.2.
InForm OS Version 2.2.4 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 –data|–ctl|–both 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.2.4 –rcfc Includes only statistics for Fibre Channel configured Remote Copy ports. –rcip Includes only statistics for Ethernet configured Remote Copy ports. –rw Display reads and writes separately. If this option is not used, then the total of reads plus writes is displayed. –d Sets the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483.
InForm OS Version 2.2.4 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 type, operation, meas, and value arguments are separated with one comma.
Command Line Interface Reference InForm OS Version 2.2.4 svct Specifies that statistics for service time in milliseconds are displayed. size Specifies that statistics for I/O operations in bytes are displayed. [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. The integer can 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.2.4 Command Line Interface Reference ■ Port. The port ID. ■ D/C. The Data or Control transfers. ■ r/w. The I/O type. Values can be read (r), write (w), or read and write (t). ■ I/O per second Cur. The current number of I/O per second. ■ I/O per second Avg. The average number of I/O per second. ■ KBytes per Max. The maximum number of KB per second. ■ KBytes per Cur. The current number of KB per second. ■ KBytes per Avg. The average number of KB per second. ■ Svt ms Max.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND statrcopy DESCRIPTION The statrcopy command displays statistics for Remote Copy volume groups. 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND statvlun DESCRIPTION The statvlun command displays statistics for virtual volumes and LUN host attachments. SYNTAX statvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only VLUNs whose virtual volumes are in domains with names that match one or more of the specified domain names or patterns.
Command Line Interface Reference InForm OS Version 2.2.4 –slots Specifies that export statistics from ports on the slots as listed in the slot list are displayed. 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). –ports Specifies that export statistics from ports on the port slots as listed in the port list are displayed. The port list is specified as a series of integers separated by commas (1,2,3).
InForm OS Version 2.2.4 Command Line Interface Reference –idlep Includes a percent idle column 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. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order.Command Line Interface Reference InForm OS Version 2.2.4 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. 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.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays one iteration of statistics for virtual volumes and LUN host attachments: cli% statvlun -iter 1 15:34:18 05/31/07 r/w I/O per second KBytes per sec Svt ms IOSz KB Lun VVname Host Port Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen -------------------------------------------------------------------------total t 0 0 0 0 0.0 0.0 0.0 0.0 0 The columns in the example above are identified as follows: ■ LUN. The LUN.
Command Line Interface Reference InForm OS Version 2.2.4 NOTES ■ Previous options –n , –s , and –p have been deprecated and replaced with –nodes , –slots , and – ports . ■ A Domain column can be displayed by setting the listdom option or TPDLISTDOM environment variable. See the InForm OS CLI Administrator’s Manual for information on setting environment variables and global options. 25.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND statvv DESCRIPTION The statvv command displays statistics for virtual volumes in a timed loop. SYNTAX statvv [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only virtual volumes that are in domains with names that match one or more of the specified domain names or patterns.
Command Line Interface Reference InForm OS Version 2.2.4 inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:), and rows that have the same 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.
InForm OS Version 2.2.4 Command Line Interface Reference 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. svct Specifies that statistics for service time in milliseconds are displayed.
Command Line Interface Reference InForm OS Version 2.2.4 EXAMPLES The following example displays I/O statistics for all virtual volumes: 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.
InForm OS Version 2.2.4 ■ Command Line Interface Reference In addition to external accesses by hosts, virtual volumes may be read internally by the system read-ahead prefetcher. The statvv data includes read-ahead accesses from the prefetcher, which can cause the read data to appear more than seen by the hosts. Use the statvlun -vvsum command to see data for only accesses from the host. ■ For this command KB = 1000 bytes. 25.
Command Line Interface Reference 25.52 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 26 Stop Commands In this chapter stopcim 26.2 stoprcopy 26.3 stoprcopygroup 26.5 Stop Commands 26.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. SYNTAX stopcim [option] AUTHORITY 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. SPECIFIERS None. RESTRICTIONS None.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND stoprcopy DESCRIPTION The stoprcopy command disables the Remote Copy functionality for 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.
Command Line Interface Reference InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 Command Line Interface Reference COMMAND stoprcopygroup DESCRIPTION The stoprcopygroup command stops the Remote Copy functionality for the specified Remote Copy volume group. SYNTAX stoprcopygroup [option] 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.
Command Line Interface Reference ■ InForm OS Version 2.2.4 If the mirror_config policy is not set and this command is issued on a secondary group, then the corresponding primary group is also stopped as a result of this command. ■ In sync mode, this command creates snapshots that are used for synchronizing the primary and secondary groups if startrcopygroup is run later. 26.
InForm OS Version 2.2.4 Command Line Interface Reference 27 Sync Command In this chapter syncrcopy 27.2 Sync Command 27.
Command Line Interface Reference InForm OS Version 2.2.4 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.2.4 Command Line Interface Reference EXAMPLE The following example specifies that Remote Copy volume group Group1 should be synchronized with it’s corresponding secondary volume group: cli% syncrcopy Group1 Synchronization request issued for group Group1 NOTES ■ Mode (synchronous or asynchronous periodic) is set using the creatercopy group command. For information about modes and creating Remote Copy volume groups, see creatercopygroup on page 11.40.
Command Line Interface Reference 27.4 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 COMMAND tunealdvv DESCRIPTION The tunealdvv command changes the layout of a virtual volume. 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.
InForm OS Version 2.2.4 Command Line Interface Reference –f Forces the command. The command completes without prompting for confirmation. –dr Specifies that the command is a dry run and that no logical disks or virtual volumes are actually tuned. –keepld Specifies that unused space at the end of the set of region moves should not be deleted. The default is to reclaim the unused space if the region move completed successfully.
Command Line Interface Reference InForm OS Version 2.2.4 –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, 64, 128, 256, or 512. If no value is entered, the step size defaults to 256 KB for RAID 0 and RAID 1, and 128 KB for RAID 5. –ha port|cage|mag Specifies that a RAID-1 or RAID-5 can support a failure of one port pair, one cage, or mag.
InForm OS Version 2.2.4 Command Line Interface Reference slots is separated with a hyphen (0–7). The primary path of the disks must be on the specified PCI slot number(s). –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.
Command Line Interface Reference InForm OS Version 2.2.4 –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected for virtual volume and logical disk creation. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected for virtual volume and logical disk creation.
InForm OS Version 2.2.4 Command Line Interface Reference –verbose on|off Specifies that verbose output is either enabled (on) or disabled (off). Default is off. –cnt Specifies the number of identical virtual volumes to tune using an integer from 1 through 999. If not specified, one virtual volume is tuned. -restart Restart a tunealdvv command call that was previously interrupted because of component failure, or because of user initiated cancellation. This option was deprecated in the 2.2.
Command Line Interface Reference InForm OS Version 2.2.4 The following example shows how to use the tunealdvv command to change the availability level of a virtual volume (testvol) to cage. Note that because the default availability parameter setting (–ha) for tunealdvv is cage, it is not necessary to explicitly specify cagelevel availability when issuing this command. cli% tunealdvv testvol Task 2 started.
InForm OS Version 2.2.4 Command Line Interface Reference waittask command in your scripts to ensure orderly completion of the tunealdvv cancellation before taking other actions. See waittask on page 31.2 for details about using the waittask command. 28.
Command Line Interface Reference InForm OS Version 2.2.4 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 Service NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 Command Line Interface Reference –ports Specifies that physical disks attached to the ports from the port list are included for statistic sampling. 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). –vv Specifies that the physical disks used by the indicated virtual volume name are included for statistic sampling.
Command Line Interface Reference InForm OS Version 2.2.4 –maxpd Specifies that only the indicated number of physical disks with high service times are displayed. If this option is not specified, 10 physical disks 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.2.4 Command Line Interface Reference EXAMPLES In the following example, physical disks with average service times exceeding 50 milliseconds are identified and their chunklets automatically relocated to rebalance the physical disks’ load. cli% tunepd –vvlayout –chstat –movech auto avgsvct 50 Collecting I/O statistic for physical disks (PDs) ... PdId Pos APort BPort Iops Kbps --------- -------- -------- --------------29 1:3:3 0:4:1 1:5:1* 231.9 8668.8 Svct(ms) ---------87.
Command Line Interface Reference InForm OS Version 2.2.
InForm OS Version 2.2.4 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. The tunetpvv command allows the RAID and Availability characteristics of an exiting Thin Provisioned Virtual Volume to be dynamically modified. SYNTAX tunetpvv [-f] -cpg [options ] AUTHORITY Edit OPTIONS –f Forces the command. The command completes without prompting for confirmation.
Command Line Interface Reference InForm OS Version 2.2.4 RESTRICTIONS ■ Use of this command requires a Dynamic Optimization license. Contact your local 3PAR representative for information. ■ This command requires sufficient available physical space with the same owner or backup node as the space it is being copied from.
InForm OS Version 2.2.4 Command Line Interface Reference NOTES ■ When canceling a tunetpvv command task, the canceltask command might return before a cancellation is complete. Thus, resources reserved for the task might not be immediately available. This prevents actions like attempting another tune on the same virtual volume. Scripts should use the waittask command in order to ensure orderly completion of the tunetpvv command cancellation prior to taking other actions. 28.
Command Line Interface Reference InForm OS Version 2.2.4 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 CPG.
InForm OS Version 2.2.4 Command Line Interface Reference 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. –dr Specifies that the command is a dry run and that no logical disks or virtual volumes are actually tuned.
Command Line Interface Reference InForm OS Version 2.2.4 command cancellation before taking other actions. See waittask on page 31.2 for details about using the waittask command. 28.
InForm OS Version 2.2.4 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.2.4 COMMAND updatesnapspace DESCRIPTION The updatesnapspace command starts a non-cancellable task to update the actual snapshot space used by a virtual volume. By default, this command updates the space used by all volumes on the system. The amount of time required for the task to complete depends on the sizes of the base volumes and snapshots in the system. Monitor the task using the showtask command. SYNTAX updatesnapspace [...|...
InForm OS Version 2.2.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND updatevv DESCRIPTION The updatevv command updates a snapshot virtual volume with a new snapshot. SYNTAX updatevv [options] ... AUTHORITY Super, Edit OPTIONS –ro Specifies that if the specified virtual volume () is a read/write snapshot the snapshot’s read-only parent volume is also updated with a new snapshot.
InForm OS Version 2.2.4 Command Line Interface Reference EXAMPLES The following example displays the snapshot update of snapshot virtual volume avvro.
Command Line Interface Reference 29.6 InForm OS Version 2.2.
InForm OS Version 2.2.4 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.2.4 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 Service NOTE: You need access to all domains in order to run this command.
InForm OS Version 2.2.4 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). SPECIFIERS Specifies the name displayed in the Name column using the showcage command. RESTRICTIONS None. EXAMPLES The following example displays a cage with firmware level of 4.41 upgrading to 4.
Command Line Interface Reference InForm OS Version 2.2.4 COMMAND upgradepd DESCRIPTION The upgradepd command upgrades the physical disk firmware. SYNTAX upgradepd [-f] [-skiptest] {-a | -w ... | ...} AUTHORITY Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Upgrades the physical disk firmware without requiring confirmation. –skiptest Skips the 10 second diagnostic test normally completed after each physical disk upgrade.
InForm OS Version 2.2.4 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays the upgrade of all physical disks: cli% upgradepd –a NOTES ■ Physical disks 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 RAID 1 and RAID 5 logical disks. ■ Specify the –w option when upgrading unadmitted physical disks. 30.
Command Line Interface Reference 30.6 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference 31 Wait Command In this chapter waittask 31.2 Wait Command 31.
Command Line Interface Reference InForm OS Version 2.2.4 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 waittask –v }|[...] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Displays the detailed status of the task specified by as it executes. When the task completes, this command exits. SPECIFIERS [...
InForm OS Version 2.2.4 Command Line Interface Reference 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.2.
InForm OS Version 2.2.4 Command Line Interface Reference Index . . . (ellipsis), multiuse option specifier 2.2 alerts removing from system 19.3 () (parentheses), grouped elements 2.2 service, registered SNMP software for 22.130 [] (brackets) optional elements 2.2 system | (vertical bar), or option specifier 2.2 removing preregistered SNMP software 19.16 status of 22.4 A status of, setting 21.3 access using addsnmpmgr for 4.2 user information about 22.157 active VLUN 22.
Command Line Interface Reference 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.9 chapters, overview of 1.3 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.6 stoprcopy 22.
InForm OS Version 2.2.4 link to remote storage server 5.6 create commands See also specific commands (create*) createald 11.3 createaldvv 11.9 createavv 11.17 createcpg 11.21, 11.28 createdomain 11.28 creategroupsv 11.29 creategroupvvcopy 11.31 createhost 11.34 createld 11.37 creatercopygroup 11.40 creatercopytarget 11.42 Command Line Interface Reference virtual volume, starting 24.7 databases, current firmware levels, displaying 22.39 date and time for system nodes 22.29 setting nodes 21.
Command Line Interface Reference InForm OS Version 2.2.4 See also specific commands (dismiss*) physical disks, upgrading 30.4 specific cages, downloading into 30.2 dismisspd 12.2 dismissrcopylink 12.3 freespace 13.2 dismissrcopyvv 12.5 G display group configuration details 22.118 add virtual volume to 5.8 statistics for group 25.38 create 11.40 displaying 22.88 display statistics for 25.38 displaying administration network interface status and configuration 22.64 remove 19.
InForm OS Version 2.2.4 Command Line Interface Reference histpd 15.10 LIP 10.11 histport 15.18 locate command histvlun 15.22 See also specific commands (locate*) histvv 15.27 locatecage 16.2 host name, length limit 2.3 locatesys 16.4 host sees VLUN template 11.61 logical disk name, length limit 2.3 hosts logical disks creating new system 11.34 access times, histogram of 15.6 removing 19.9 check data on 7.2 system configuration, displaying 22.43, 22.
Command Line Interface Reference InForm OS Version 2.2.4 movepdtospare 17.7 SNMP removing access 19.18 moverelocpd 17.9 updating access 21.61 moving chunklet lists 17.2 moving domains 17.12 moving physical disks to spare 17.5, 17.7 persistent repository 22.142 physical disks 12.2, 17.5, 17.7 allocatable, marking as 21.49 multiuse option specifier. See . . . (ellipsis) multiuse option specifier displaying mapping information 22.12 firmware, upgrading 30.4 N I/O statistics 25.
InForm OS Version 2.2.4 Registered State Change Notification (RSCN) 10.11, 22.101 related documents 1.2 Remote Copy 26.3 enable 24.4 ports 10.9 Command Line Interface Reference removevv 19.33 removing hosts 19.9 removing users 19.27 removing virtual volumes 19.33 replacing drive magazines or disk drives 10.5 stop 26.5 revision history RH.1 turn on for group 24.5 RSCN 10.10, 22.101 remove rules, syntax 2.3 group 19.13 link 12.3 S target designation 19.15 SCSI-3 reservation types 22.
Command Line Interface Reference setdate 21.27 showcage 22.15 setdomain 21.31 showcim 22.20 sethost 21.33 showclienv 22.22 setlicense 21.36 showcpg 22.23 setnet 21.38 showdate 22.29 setnode 21.43 showdomain 22.30 setntp 2.5 to 2.6, 21.45 showeeprom 22.32 setpassword 21.47 showeventlog 22.35 setpd 21.49 showfirmwaredb 22.39 setrcopygroup 21.51 showhost 22.43 setrcopytarget 21.57 showiscsisession 22.47 setsnmppw 21.61 showld 22.49 setsshkey 21.63 showldch 22.55 setstatch 21.
InForm OS Version 2.2.4 Command Line Interface Reference showrctransport 22.123 for alerts 22.130 showrsv 22.126 removing preregistered 19.16 showsnmpmgr 22.130 Solaris SPARC, supported versions 1.2 showsnmppw 22.128 spares, allocating chunklet resources as 11.44 showspace 22.132 spec (specifier) required command line element, used with 2.2 showspare 22.136 showsys 22.139 specifier (spec). See spec (specifier) required command line element, used with showsysmgr 22.
Command Line Interface Reference InForm OS Version 2.2.4 physical disks 25.25 syntax, rules for 2.3 virtual volumes 25.47 system alerts I/O port 25.33 removing 19.3 link utilization 25.23 setting 21.3, 21.5 virtual volumes status of 22.4 I/O 25.47 LUN host attachments 25.41 system configuration, displaying for hosts 22.43, 22.47 statistics, display for group 25.38 system information 3.9 statld 25.18 system manager statlink 25.23 startup date, setting 21.71 statpd 25.
InForm OS Version 2.2.4 traps Command Line Interface Reference verifying removing preregistered SNMP software 19.16 controlport command success 10.18 using addsnmpmgr for 4.2 physical disk admittance 5.5 troubleshooting not all volumes are synchronizing concurrently 22.122 physical disk status 21.50 virtual volume creation with logical disks 11.16 vertical bar (|), or option specifier 2.2 tunealdvv 28.2 virtual copy names, length limit 2.3 tunepd 28.10 virtual volume names, length limit 2.
Command Line Interface Reference port presents 11.61 VLUNs active 22.164 deleting 19.31 information about 22.164 voltage status 22.73 W wait command See also specific commands (wait*) of virtual volumes, creating 11.61 waittask 31.2 service time, histograms of 15.22 warning limit (CPG) 22.25 template 22.164 Windows NT, XP, and 2000, supported 1.2 template conflicts in 11.36 IX.12 InForm OS Version 2.2.
InForm OS Version 2.2.4 Command Line Interface Reference Revision History Release Level Revision Summary 320-200114 Rev A Added information about the InServ F-Class Storage Servers. This March 2009 document was previously released under part number 320-1323. Revision History RH.
Command Line Interface Reference RH.2 InForm OS Version 2.2.
