3PAR InForm® OS 2.3.1 CLI Reference (320-200166 Rev B, March 2010)

ManualsBrandsHP ManualsStorageHP 3PAR F400 Field Starter Kit

3PAR InForm

OS 2.3.1

Command Line Interface

Reference

3PAR, Inc.

4209 Technology Drive

Fremont, CA 94538 USA

Part No. 320-200166 Rev B

March 2010

Summary of content (830 pages)

PAGE 1
® 3PAR InForm OS 2.3.1 Command Line Interface Reference 3PAR, Inc. 4209 Technology Drive Fremont, CA 94538 USA Part No.
PAGE 2
Revision Notice This is the second 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.
PAGE 3
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.
PAGE 4
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.
PAGE 5
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.
PAGE 6
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.
PAGE 7
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.
PAGE 8
PAGE 9
InForm OS Version 2.3.1 Command Line Interface Reference Table of Contents 1 Introduction 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 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.
PAGE 10
Command Line Interface Reference InForm OS Version 2.3.1 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 Alert Management Commands 3.5 3.4.1 Alerts 3.5 3.4.2 Events 3.5 3.4.3 System Health 3.5 3.5 Help and Utility Commands 3.6 3.6 Task Management Commands 3.7 3.7 LDAP Management Commands 3.7 3.8 Licensing Management Commands 3.8 3.9 Node Subsystem Management Commands 3.8 3.9.1 Firmware Versions 3.8 3.9.
PAGE 11
InForm OS Version 2.3.1 Command Line Interface Reference 3.10.10 Virtual LUN (Export) Statistics 3.16 3.10.11 Virtual Volume Statistics 3.17 3.11 Preserved Data Commands 3.17 3.12 Replication Commands 3.18 3.12.1 Physical Copy 3.18 3.12.2 Remote Copy 3.18 3.12.3 Virtual Copy 3.21 3.13 Service Commands 3.21 3.13.1 Disk Enclosure 3.21 3.13.2 General System Maintenance 3.22 3.13.3 System Upgrade 3.22 3.14 SNMP Agent Commands 3.23 3.15 CIM Server Commands 3.24 3.
PAGE 12
Command Line Interface Reference InForm OS Version 2.3.1 admitpd 5.4 admitrcopylink 5.6 admitrcopytarget 5.8 admitrcopyvv 5.10 6 Cancel Command canceltask 6.2 7 Check Commands checkhealth 7.2 checkld 7.4 checkpassword 7.6 checkpd 7.8 checkport 7.11 checkvv 7.13 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.
PAGE 13
InForm OS Version 2.3.1 Command Line Interface Reference createavv 11.18 createcpg 11.22 createdomain 11.30 createdomainset 11.32 creategroupsv 11.34 creategroupvvcopy 11.37 createhost 11.40 createhostset 11.43 createld 11.45 creatercopygroup 11.48 creatercopytarget 11.50 createsched 11.52 createspare 11.56 createsv 11.58 createtemplate 11.61 createtpvv 11.71 createuser 11.77 createvlun 11.79 createvv 11.83 createvvcopy 11.90 createvvset 11.
PAGE 14
Command Line Interface Reference InForm OS Version 2.3.1 13 Free Command freespace 13.2 14 Grow Commands growaldvv 14.2 growavv 14.10 growtpvv 14.12 growvv 14.14 15 Hist Commands histch 15.2 histld 15.6 histpd 15.10 histport 15.18 histvlun 15.23 histvv 15.28 16 Locate Commands locatecage 16.2 locatesys 16.4 17 Move Commands movech 17.2 movechtospare 17.6 movepdtospare 17.9 moverelocpd 17.12 movetodomain 17.18 18 Promote Commands xiv Table of Contents promotesv 18.
PAGE 15
InForm OS Version 2.3.1 Command Line Interface Reference 19 Remove Commands removealert 19.3 removecpg 19.5 removedomain 19.7 removedomainset 19.8 removeeventlog 19.10 removehost 19.12 removehostset 19.14 removeld 19.16 removercopygroup 19.18 removercopytarget 19.20 removesched 19.22 removesnmpmgr 19.24 removesnmppw 19.26 removespare 19.28 removesshkey 19.30 removetask 19.31 removetemplate 19.33 removeuser 19.35 removeuserconn 19.37 removevlun 19.39 removevv 19.
PAGE 16
Command Line Interface Reference InForm OS Version 2.3.1 21 Set Commands xvi Table of Contents setalert 21.3 setauthparam 21.5 setbattery 21.12 setcage 21.14 setcim 21.16 setclienv 21.18 setcpg 21.20 setdate 21.27 setdomain 21.31 setdomainset 21.33 sethost 21.35 sethostset 21.39 setlicense 21.40 setnet 21.42 setnode 21.47 setntp 21.49 setpassword 21.51 setpd 21.53 setrcopygroup 21.55 setrcopytarget 21.62 setsched 21.66 setsnmppw 21.68 setsshkey 21.
PAGE 17
InForm OS Version 2.3.1 Command Line Interface Reference setsysmgr 21.79 settemplate 21.82 setuser 21.84 setuseracl 21.86 setvv 21.88 setvvset 21.94 22 Show Commands showalert 22.4 showauthparam 22.6 showbattery 22.8 showblock 22.14 showcage 22.17 showcim 22.23 showclienv 22.25 showcpg 22.26 showdate 22.33 showdomain 22.34 showdomainset 22.36 showeeprom 22.38 showeventlog 22.41 showfirmwaredb 22.45 showhost 22.47 showhostset 22.52 showinventory 22.
PAGE 18
Command Line Interface Reference xviii Table of Contents InForm OS Version 2.3.1 showldmap 22.71 showlicense 22.73 shownet 22.75 shownode 22.77 shownodeenv 22.87 showpatch 22.89 showpd 22.91 showpdata 22.107 showpdch 22.108 showpdvv 22.115 showport 22.119 showportarp 22.130 showportdev 22.132 showportisns 22.135 showportlesb 22.137 showrcopy 22.143 showrctransport 22.148 showrsv 22.151 showsched 22.153 showsnmpmgr 22.155 showsnmppw 22.157 showspace 22.
PAGE 19
InForm OS Version 2.3.1 Command Line Interface Reference showtask 22.178 showtemplate 22.182 showtoc 22.183 showtocgen 22.185 showuser 22.186 showuseracl 22.188 showuserconn 22.189 showversion 22.191 showvlun 22.193 showvv 22.199 showvvmap 22.215 showvvpd 22.217 showvvset 22.222 23 Shutdown Commands shutdownnode 23.2 shutdownsys 23.4 24 Start Commands startcim 24.2 startld 24.3 startrcopy 24.4 startrcopygroup 24.5 starttask 24.7 startvv 24.
PAGE 20
Command Line Interface Reference InForm OS Version 2.3.1 statiscsi 25.12 statiscsisession 25.16 statld 25.18 statlink 25.23 statpd 25.25 statport 25.33 statrcopy 25.39 statvlun 25.42 statvv 25.48 26 Stop Commands stopcim 26.2 stoprcopy 26.4 stoprcopygroup 26.6 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.
PAGE 21
InForm OS Version 2.3.1 Command Line Interface Reference 31 Wait Command waittask IX RH 31.
PAGE 22
Command Line Interface Reference xxii Table of Contents InForm OS Version 2.3.
PAGE 23
InForm OS Version 2.3.1 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.
PAGE 24
Command Line Interface Reference InForm OS Version 2.3.1 1.1 Audience This reference is for system and storage administrators who monitor and direct system configurations and resource allocation for 3PAR InServ storage systems. 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.
PAGE 25
InForm OS Version 2.3.1 Command Line Interface Reference 1.
PAGE 26
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 27
InForm OS Version 2.3.1 ■ 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.
PAGE 28
Command Line Interface Reference ■ InForm OS Version 2.3.1 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.
PAGE 29
InForm OS Version 2.3.1 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.
PAGE 30
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 31
InForm OS Version 2.3.1 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]).
PAGE 32
Command Line Interface Reference InForm OS Version 2.3.1 ◆ user name  31 characters ◆ system name  31 characters 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...
PAGE 33
InForm OS Version 2.3.1 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 ({ }).
PAGE 34
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 35
InForm OS Version 2.3.1 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 Alert Management Commands 3.5 3.5 Help and Utility Commands 3.6 3.6 Task Management Commands 3.7 3.7 LDAP Management Commands 3.7 3.8 Licensing Management Commands 3.8 3.9 Node Subsystem Management Commands 3.8 3.10 Performance Management Commands 3.13 3.
PAGE 36
Command Line Interface Reference InForm OS Version 2.3.1 3.15 CIM Server Commands 3.24 3.16 Sparing Commands 3.24 3.17 SSH Access Commands 3.25 3.18 Task Schedule Commands 3.26 3.19 User Management Commands 3.26 3.20 Volume Management Commands 3.27 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.
PAGE 37
InForm OS Version 2.3.1 Command Line Interface Reference 3.2.2 Physical Disk Management Command Description Authority For Details See admitpd Admits one or all physical Super, Service* admitpd on disks to enable their use. checkpd Executes surface scans on page 5.4 Super, Service† physical disks. controlpd Spins physical disks up or page 7.8 Super, Service* down. dismisspd Dismisses one or more Marks physical disks as controlpd on page 10.7 Super, Service* physical disks from use.
PAGE 38
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See movetodomain Moves objects from one Super* movetodomain domain to another. removedomain Removes an existing on page 17.18 Super* domain from the system. removedomainset Removes a domain set or removedomain on page 19.7 Super, Edit removes domains from removedomainse t on page 19.8 an existing set.
PAGE 39
InForm OS Version 2.3.1 Command Line Interface Reference 3.4 Health and Alert Management Commands 3.4.1 Alerts Command Description Authority For Details See removealert Removes one or more Super, Service* removealert on alerts. setalert Sets the status of system page 19.3 Super, Service* alerts. showalert Displays system alerts. setalert on page 21.3 Super, Service, Edit, showalert on Browse page 22.4 * You need access to all domains in order to run this command. 3.4.
PAGE 40
Command Line Interface Reference InForm OS Version 2.3.1 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.5 cmore Pages the output of Super, Edit, Browse, General Control commands.
PAGE 41
InForm OS Version 2.3.1 Command Line Interface Reference 3.6 Task Management Commands Command Description Authority For Details See canceltask Cancels one or more Super, Edit canceltask on tasks. removetask Removes information page 6.2 Super, Edit about one or more tasks removetask on page 19.31 and their details. showtask starttask Displays information Super, Service, Edit, showtask on about tasks. Browse page 22.
PAGE 42
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See showauthparam Shows authentication Super showauthparam parameters and on page 22.6 integrates the authentication and authorization features using LDAP. checkpassword Supports authentication Super* and authorization using checkpassword on page 7.6 LDAP. * You need access to all domains in order to run this command. 3.
PAGE 43
InForm OS Version 2.3.1 Command Line Interface Reference 3.9.2 Node Date Information Command Description Authority For Details See setdate Sets the system time and Super, Service* setdate on date on all nodes. showdate page 21.27 Displays the date and Super, Service, Edit, showdate on time on all system nodes. Browse page 22.33 * You need access to all domains in order to run this command. 3.9.
PAGE 44
Command Line Interface Reference InForm OS Version 2.3.1 3.9.5 Array and Node Information Command Description Authority For Details See locatesys Locates a system by blinking its LEDs. Super, Service* locatesys on Enables you to set Super, Service* setsys page 16.4 system-wide parameters setsys on page 21.75 such as the raw space alert. showsys Displays the InServ Super, Service, Edit, showsys on system properties, Browse page 22.
PAGE 45
InForm OS Version 2.3.1 Command Line Interface Reference 3.9.7 Port Information Command Description Authority For Details See checkport Performs a loopback Super, Service* checkport on test on Fibre page 7.11 Channel ports. controlport Controls Fibre Super, Service* Channel or Remote controlport on 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.
PAGE 46
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See showportlesb Displays Link Error Super, Service, Edit, showportlesb on Status Block Browse page 22.139 Displays Super, Service, Edit, showtarget on unrecognized Browse page 22.179 Displays the iSCSI Super, Service, Edit, statiscsi on statistics. Browse page 25.12 Displays the iSCSI Super, Service, Edit, statiscsisession session statistics. Browse on page 25.
PAGE 47
InForm OS Version 2.3.1 Command Line Interface Reference 3.9.9 System Manager Command Description Authority For Details See setsysmgr Sets the system manager Super* setsysmgr on startup state. showsysmgr showtoc showtocgen page 21.79 Displays the system Super, Service, Edit, showsysmgr on manager startup state. Browse page 22.176 Displays the system table Super, Service, Edit, showtoc on of contents summary. Browse page 22.
PAGE 48
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See setstatpdch Sets statistics Super, Edit setstatpdch on collection mode on page 21.74 physical disk chunklets. statch Displays statistics for Super, Service, Edit, statch on individual chunklets. Browse page 25.2 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.
PAGE 49
InForm OS Version 2.3.1 Command Line Interface Reference 3.10.5 Link Statistics Command Description Authority For Details See statlink Displays statistics for Super, Service, Edit, statlink on links. Browse page 25.23 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.
PAGE 50
Command Line Interface Reference InForm OS Version 2.3.1 3.10.9 Dynamic Optimization 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 Changes the layout of a Super, Edit tunetpvv page 28.
PAGE 51
InForm OS Version 2.3.1 Command Line Interface Reference 3.10.11 Virtual Volume Statistics Command Description Authority For Details See histvv Displays histogram data Super, Service, Edit, histvv on for virtual volumes. Browse page 15.28 Displays statistics for Super, Service, Edit, statvv on virtual volumes. Browse page 25.48 statvv 3.
PAGE 52
Command Line Interface Reference InForm OS Version 2.3.1 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.37 of a list of virtual volumes. Copies a virtual createvvcopy Super, Edit volume. promotevvcopy Promotes a physical createvvcopy on page 11.90 Super, Edit copy back to a base promotevvcopy on page 18.4 volume. 3.12.
PAGE 53
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See creatercopygroup Creates a group for Super, Edit creatercopygroup Remote Copy. creatercopytarget Creates a target for on page 11.48 Super, Edit* Remote Copy. dismissrcopylink Dismisses a network creatercopytarget on page 11.50 Super, Edit* link from Remote dismissrcopylink on page 12.3 Copy use.
PAGE 54
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See setrcopytarget Sets the Remote Copy Super, Edit* setrcopytarget on target state. showrcopy page 21.62 Displays the details of Super, Service, Edit, showrcopy on a Remote Copy Browse page 22.145 Shows status and Super, Service, Edit, showrctransport information about Browse on page 22.150 Super, Edit* startrcopy on configuration.
PAGE 55
InForm OS Version 2.3.1 Command Line Interface Reference 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.58 Super, Edit snapshots of a list of creategroupsv on page 11.34 virtual volumes. promotesv Copies the differences of Super, Edit a virtual copy back to its promotesv on page 18.2 base volume.
PAGE 56
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See servicemag Prepares a drive Super, Service* servicemag on magazine for service. upgradecage Upgrades drive cage page 20.8 Super, Service* firmware. upgradepd Upgrades disk firmware. upgradecage on page 30.2 Super, Service* upgradepd on page 30.4 * You need access to all domains in order to run this command. † You need access to all domains in order to run this command. 3.13.
PAGE 57
InForm OS Version 2.3.1 Command Line Interface Reference 3.14 SNMP Agent Commands Command Description Authority For Details See addsnmpmgr Adds an SNMP manager Super* addsnmpmgr on to receive trap page 4.2 notifications. removesnmpmgr Removes an SNMP trap Super* manager. removesnmppw Removes an SNMP on page 19.24 Super* password. setsnmppw Allows users to update showsnmppw removesnmppw on page 19.26 Super* SNMP passwords. showsnmpmgr removesnmpmgr setsnmppw on page 21.
PAGE 58
Command Line Interface Reference InForm OS Version 2.3.1 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 SLP, HTTP and HTTPS ports for the CIM server. showcim Displays the CIM server Super, Service, Edit, showcim on setting information and Browse page 22.23 Super, Service* startcim on status.
PAGE 59
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See movepdtospare Moves specified physical Super, Service, Edit* movepdtospare disks to spare. moverelocpd Moves chunklets on page 17.9 Super, Service, Edit* relocated from a moverelocpd on page 17.12 physical disk to another physical disk. removespare Removes spare Edit, Service* chunklets. showspare removespare on page 19.
PAGE 60
Command Line Interface Reference InForm OS Version 2.3.1 3.18 Task Schedule Commands Command Description Authority For Details See createsched Allows users to schedule Super, Service createsched on tasks that are page 11.52 periodically run by the scheduler. removesched Removes a scheduled Super, Service task from the system. setsched Allows users to suspend, removesched on page 19.22 Super, Service pause, change the setsched on page 21.
PAGE 61
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See setpassword Changes your password. Super, Edit, Service setpassword on Browse† page 21.51 Super, Edit, Browse setuser on setuser Sets your user properties. page 21.84 setuseracl Sets your Access Control Super, Edit List (ACL). showuser showuseracl showuserconn Displays user accounts. setuseracl on page 21.86 Super, Service, Edit, showuser on Browse page 22.
PAGE 62
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See removecpg Removes CPGs. Super, Edit* removecpg on page 19.5 setcpg Changes the properties Super, Edit* CPGs. showcpg Displays CPGs. setcpg on page 21.20 Super, Service, Edit, showcpg on Browse page 22.26 * You need access to all domains in order to run this command. 3.20.
PAGE 63
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See sethost Sets properties on Super, Edit* sethost on existing system hosts, page 21.35 including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. sethostset Sets the parameters and Super, Edit modifies the properties sethostset on page 21.39 of a host set.
PAGE 64
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See showld Displays logical disks. Super, Service, Edit, showld on Browse page 22.58 Super, Service* startld on startld Starts logical disks. page 24.3 * You need access to all domains in order to run this command. 3.20.
PAGE 65
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See showvvmap Displays virtual volume to Super, Service, Edit, showvvmap on logical disk mapping. Browse page 22.217 Displays virtual volume Super, Service, Edit, showvvpd on distribution across Browse page 22.219 showvvpd physical disks. 3.20.
PAGE 66
Command Line Interface Reference InForm OS Version 2.3.1 3.20.6 Virtual Volume Management Command Description Authority For Details See checkvv Performs validity Super, Service* checkvv on checks of virtual page 7.13 volume administrative information. createaldvv Automatically creates Super, Edit* virtual volumes and createaldvv on page 11.9 their underlying logical disks. createavv Automatically creates Super, Edit* virtual volumes. createtpvv Creates a TPVV. createavv on page 11.
PAGE 67
InForm OS Version 2.3.1 Command Line Interface Reference Command Description Authority For Details See growaldvv Automatically Super, Edit* growaldvv on increases the size of a page 14.2 virtual volume and its underlying logical disks. growavv Automatically Super, Edit* increases the size of a growavv on page 14.10 virtual volume. growtpvv Enlarges a thin Super, Edit provisioning virtual growtpvv on page 14.12 volume.
PAGE 68
Command Line Interface Reference InForm OS Version 2.3.1 Command Description Authority For Details See showrsv Displays information Super, Service, Edit, showrsv on about reservation and Browse page 22.153 Displays virtual Super, Service, Edit, showvv on volumes in the system. Browse page 22.201 Displays the virtual Super, Service, Edit, showvvset on volume sets defined on Browse page 22.224 Super, Service* startvv on registration of VLUNs connected on a Fibre Channel port.
PAGE 69
InForm OS Version 2.3.1 Command Line Interface Reference 4 Add Command In this chapter addsnmpmgr 4.2 Add Command 4.
PAGE 70
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND addsnmpmgr DESCRIPTION The addsnmpmgr command adds an SNMP manager to receive alert (traps) notifications. SYNTAX addsnmpmgr [options ] AUTHORITY Super 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.
PAGE 71
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the IP address of the host where the manager runs. It must be a valid IPv4 or IPv6 address. The IPv6 address is in hexadecimal, is case insensitive, and is separated by colons. For example: 5de:2008:0:0abcd:0:0:161a In addition, a double colon (::) can be used once in an address to replace multiple fields of zeros. For example: 5de:2008:0:0abcd::161a.
PAGE 72
Command Line Interface Reference 4.4 InForm OS Version 2.3.
PAGE 73
InForm OS Version 2.3.1 Command Line Interface Reference 5 Admit Commands In this chapter admithw 5.2 admitpd 5.4 admitrcopylink 5.6 admitrcopytarget 5.8 admitrcopyvv 5.10 Admit Commands 5.
PAGE 74
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND admithw DESCRIPTION The admithw command admits new hardware into the system. AUTHORITY Super, 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.
PAGE 75
InForm OS Version 2.3.1 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.
PAGE 76
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND admitpd DESCRIPTION The admitpd command creates and admits physical disk definitions to enable the use of those disks. AUTHORITY Super, 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. SPECIFIERS [...
PAGE 77
InForm OS Version 2.3.1 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.
PAGE 78
Command Line Interface Reference InForm OS Version 2.3.1 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 ...
PAGE 79
InForm OS Version 2.3.1 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. ■ Access to all domains is required to run this command. EXAMPLES The following example adds a link on System2 (targetname), node 1. The IP address 193.1.2.
PAGE 80
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND admitrcopytarget DESCRIPTION The admitrcopytarget command adds a target to a Remote Copy volume group. SYNTAX admitrcopytarget [:]... AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS Specifies the name of the target that was previously created with the creatercopytarget command.
PAGE 81
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Functionality of this command requires the 3PAR Remote Copy license. Contact your local service provider for further information. EXAMPLES In the following example, the admitrcopytarget command adds the target target1 in synchronous mode to volume group Group1. cli% admitrcopytarget target1 sync Group1 NOTES A primary to secondary volume mapping must be provided for each volume currently in the group. 5.
PAGE 82
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND admitrcopyvv DESCRIPTION The admitrcopyvv command adds an existing virtual volume to an existing Remote Copy volume group. SYNTAX admitrcopyvv : [: ...] AUTHORITY Super, Edit OPTIONS None.
PAGE 83
InForm OS Version 2.3.1 Command Line Interface Reference 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 vv1.r on the target system InServ1_in to the corresponding secondary volume group that was previously created when the creatercopygroup command was issued: cli% admitrcopyvv vv1 Group1 InServ1_in:vv1.r NOTES ■ A secondary volume mapping must be provided for each target in the group.
PAGE 84
Command Line Interface Reference 5.12 InForm OS Version 2.3.
PAGE 85
InForm OS Version 2.3.1 Command Line Interface Reference 6 Cancel Command In this chapter canceltask 6.2 Cancel Command 6.
PAGE 86
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND canceltask DESCRIPTION The canceltask command cancels one or more tasks. SYNTAX canceltask [-f] all|... AUTHORITY Super, 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.
PAGE 87
InForm OS Version 2.3.1 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. As a result, resources reserved for a task might not be immediately available. This can prevent actions like restarting the canceled task.
PAGE 88
Command Line Interface Reference 6.4 InForm OS Version 2.3.
PAGE 89
InForm OS Version 2.3.1 Command Line Interface Reference 7 Check Commands In this chapter checkhealth 7.2 checkld 7.4 checkpassword 7.6 checkpd 7.8 checkport 7.11 checkvv 7.13 Check Commands 7.
PAGE 90
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND checkhealth DESCRIPTION The checkhealth command checks the status of system hardware and software components, and reports any issues. NOTE: Refer to the 3PAR InForm Messages and Operator’s Guide and 3PAR InForm OS CLI Administrator’s Guide for alert messages and administering your InServ Storage Server.
PAGE 91
InForm OS Version 2.3.
PAGE 92
Command Line Interface Reference InForm OS Version 2.3.1 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 Super, 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).
PAGE 93
InForm OS Version 2.3.1 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.
PAGE 94
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND checkpassword DESCRIPTION The checkpassword command prompts for the 's password and then displays the steps the system uses to authenticate the user and determine the user's privilege level. The information includes whether the user is local to the system or authenticated and authorized based on the configuration parameters set with setauthparam command for use with LDAP.
PAGE 95
InForm OS Version 2.3.
PAGE 96
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND checkpd DESCRIPTION The checkpd command executes surface scans or diagnostics on physical disks. SYNTAX checkpd scrub|diag [options ] ... AUTHORITY Super, 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.
PAGE 97
InForm OS Version 2.3.1 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.
PAGE 98
Command Line Interface Reference InForm OS Version 2.3.
PAGE 99
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND checkport DESCRIPTION The checkport command performs a loopback test on Fibre Channel ports. SYNTAX checkport [options ] AUTHORITY Super, 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.
PAGE 100
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 101
InForm OS Version 2.3.1 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 Super, Service NOTE: You need access to all domains in order to run this command.
PAGE 102
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.14 InForm OS Version 2.3.
PAGE 103
InForm OS Version 2.3.1 Command Line Interface Reference 8 CLI Command In this chapter cli 8.2 CLI Command 8.
PAGE 104
Command Line Interface Reference InForm OS Version 2.3.1 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 TCP port of the CLI server to which the CLI client connects. The default port number is 2540.
PAGE 105
InForm OS Version 2.3.1 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.
PAGE 106
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 107
InForm OS Version 2.3.1 Command Line Interface Reference 9 Compact Commands In this chapter compactcpg 9.2 compactld 9.4 Compact Commands 9.
PAGE 108
Command Line Interface Reference InForm OS Version 2.3.1 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 Compacts CPGs that match any of the specified patterns. -waittask Waits for any created tasks to complete.
PAGE 109
InForm OS Version 2.3.1 Command Line Interface Reference 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. ... Specifies the name of the CPG. Multiple CPGs can be specified. RESTRICTIONS None.
PAGE 110
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND compactld DESCRIPTION The compactld command consolidates space on the logical disks. SYNTAX compactld [options ] ...|... AUTHORITY Super, Edit OPTIONS -pat Compacts the logical disks that match any of the specified patterns. -cons This option consolidates regions onto the fewest possible logical disks. When this option is not specified, the regions of each logical disk will be compacted within the same logical disk.
PAGE 111
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS ... Specifies the name of the logical disk to be compacted. Multiple logical disks can be specified. ... Specifies a glob-style pattern. This specifier can be repeated to compact multiple logical disks. If this specifier is not used, the specifier must be used. Refer to Glob-Style Pattern on page 2.4 for further information. RESTRICTIONS None. EXAMPLES In the following example, logical disk pdsld0.
PAGE 112
Command Line Interface Reference 9.6 InForm OS Version 2.3.
PAGE 113
InForm OS Version 2.3.1 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.
PAGE 114
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND controliscsiport DESCRIPTION The controliscsiport command is used to set properties of an iSCSI port.
PAGE 115
InForm OS Version 2.3.1 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. OPTION -f Do not ask for confirmation.
PAGE 116
Command Line Interface Reference InForm OS Version 2.3.1 Indicates the number of ping packets to send. If a value is specified, it should be an integer from 1 through 64. If a value is not specified, the default is one packet. The physical location of the iSCSI target port. RESTRICTIONS Access to all domains is required to run this command. EXAMPLES In the following example, iSCSI port configuration is deleted: cli% controliscsiport delete -f 104.64.98.1 NOTES None. 10.
PAGE 117
InForm OS Version 2.3.1 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.
PAGE 118
Command Line Interface Reference InForm OS Version 2.3.1 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 Access to all domains is required to run this command.
PAGE 119
InForm OS Version 2.3.1 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] ...
PAGE 120
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS ... Specifies the World Wide Name (WWN) of the physical disk. This specifier can be repeated to identify multiple physical disks. RESTRICTIONS ■ Access to all domains is required to run this command. ■ The spin down operation cannot be performed on a physical disk that is in use unless the –ovrd option is used.
PAGE 121
InForm OS Version 2.3.1 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. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS config Sets the specified connection mode and type on FC ports. Also allows setting the unique node WWN option for the port.
PAGE 122
Command Line Interface Reference InForm OS Version 2.3.1 cl2 Specifies the Fibre Channel Class-2 parameter of the port. The specified port will be reset. See Specifiers on page 10.15 for parameters required to issue this subcommand. This option is deprecated and will be removed in a subsequent release. rate Specifies the data rate of the Fibre Channel port. The specified port will be reset. See Specifiers on page 10.15 for parameters required to issue this subcommand.
PAGE 123
InForm OS Version 2.3.1 Command Line Interface Reference rcip mtu Sets the Maximum Transfer Unit (MTU) size for the specified Remote Copy interface(s), overriding the default of 1500. The largest supported value is 9000 and the smallest is 100. Only for RCIP ports. See Specifiers on page 10.15 for parameters required to issue this subcommand. rcip state up|down Sets the specified Remote Copy interface(s) as either up or down. Only for RCIP ports. See Specifiers on page 10.
PAGE 124
Command Line Interface Reference InForm OS Version 2.3.1 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] ... ■ controlport ct [–f] ... (deprecated usage) ■ controlport cl2 [–f] ... (deprecated usage) ■ controlport rate [–f] ... ■ controlport vcn [–f] ...
PAGE 125
InForm OS Version 2.3.1 Command Line Interface Reference OPTIONS –m This option can only be used with the rst subcommand. Resets the mode of the port. The port can be reset into a target or initiator mode. If not specified, the port is reset to its current mode. If the port’s mode change value is prohibited, this command fails when attempting to reset to a different mode. Use showport –c to see whether mode change is allowed or prohibited for a particular port.
PAGE 126
Command Line Interface Reference InForm OS Version 2.3.1 –c If using a private loop topology, a Loop Initialization Primitive (LIP) command is issued from the port. If a cage is specified using the argument, the LIP is issued through the cage controller. ◆ If using a point-to-point topology, the link is reset. ◆ If using a public loop or fabric topology, a Registered State Change Notification (RSCN) message is issued to the fabric controller.
PAGE 127
InForm OS Version 2.3.1 Command Line Interface Reference –ct Sets the connection type. The specified port will be reset. SPECIFIERS Specifies the connection parameter of the port. Parameters can be loop or point. The loop parameter sets the port to arbitrated loop mode, the point parameter sets the port to point-to-point mode. This specifier must be provided when issuing the ct subcommand. Specifies the Fibre Channel Class-2 parameter of the port.
PAGE 128
Command Line Interface Reference InForm OS Version 2.3.1 port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot using 1 through 4. Specifies the IP address for a Remote Copy interface. Specifies the gateway address for a Remote Copy interface. Specifies the netmask for a Remote Copy interface. Specifies the MTU size for a Remote Copy interface using an integer from 100 to 9000.
PAGE 129
InForm OS Version 2.3.1 ◆ Command Line Interface Reference Changing the mode of one port in a pair (for example, from initiator to target) causes the other port in the pair to undergo a mode change as well. CAUTION: Use caution when changing modes for ports in LSI Fibre Channel adapters. Changing the mode of one port in a pair (for example, from initiator to target) causes the other port in the pair to undergo a mode change.
PAGE 130
Command Line Interface Reference InForm OS Version 2.3.1 The following example shows how to set the gateway for Gigabit Ethernet port 1 in node 6, slot 3 using a gateway address of 172.16.1.1: cli% controlport rcip gw 172.16.1.1 6:3:1 Are you sure you want to change the gateway for 6:3:1? select q=quit y=yes n=no: y Remote Copy interface change successful.
PAGE 131
InForm OS Version 2.3.1 Command Line Interface Reference ◆ If is rcfc, then can only be point ◆ If is host, then can be either loop or point 10.
PAGE 132
Command Line Interface Reference 10.20 InForm OS Version 2.3.
PAGE 133
InForm OS Version 2.3.1 Command Line Interface Reference 11 Create Commands In this chapter createald 11.3 createaldvv 11.9 createavv 11.18 createcpg 11.22 createdomain 11.30 createdomainset 11.32 creategroupsv 11.34 creategroupvvcopy 11.37 createhost 11.40 createhostset 11.43 createld 11.45 creatercopygroup 11.48 creatercopytarget 11.50 createsched 11.52 createspare 11.56 Create Commands 11.
PAGE 134
Command Line Interface Reference 11.2 InForm OS Version 2.3.1 createsv 11.58 createtemplate 11.61 createtpvv 11.71 createuser 11.77 createvlun 11.79 createvv 11.83 createvvcopy 11.90 createvvset 11.
PAGE 135
InForm OS Version 2.3.1 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|t|T] AUTHORITY Super, Service, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –templ Use the options defined in template .
PAGE 136
Command Line Interface Reference InForm OS Version 2.3.1 –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed. 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. For RAID-6, the default is a function of the set size.
PAGE 137
InForm OS Version 2.3.1 Command Line Interface Reference –pt Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–4). The primary path of the disks must be on the specified port number(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3).
PAGE 138
Command Line Interface Reference InForm OS Version 2.3.1 –tc_lt Specifies that PDs with total chunklets less than the number specified are selected. –fc_gt Specifies that PDs with free chunklets greater than the number specified are selected. –fc_lt Specifies that PDs with free chunklets less than the number specified are selected. –devid Specifies that PDs identified by their models are selected. Models can be specified in a comma-separated list.
PAGE 139
InForm OS Version 2.3.1 Command Line Interface Reference –wait If the createald command fails due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately. If this option is not used, the command will keep waiting for dirty chunklets to be cleaned if enough space will be available with the dirty chunklets cleaned.
PAGE 140
Command Line Interface Reference InForm OS Version 2.3.1 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.58 for more information. ■ 11.
PAGE 141
InForm OS Version 2.3.1 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.
PAGE 142
Command Line Interface Reference InForm OS Version 2.3.1 –ssz Specifies the set size in terms of chunklets. The default depends on the RAID type specified: 2 for RAID-1, 4 for RAID-5, and 8 for RAID-6. –rs Specifies the number of sets in a row using an integer from 1 to 2147483647. If not specified, no row limit is imposed. –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.
PAGE 143
InForm OS Version 2.3.1 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).
PAGE 144
Command Line Interface Reference InForm OS Version 2.3.1 NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive. –tc_gt Specifies that PDs with total chunklets greater than the number specified be selected. –tc_lt Specifies that PDs with total chunklets less than the number specified are selected.
PAGE 145
InForm OS Version 2.3.1 Command Line Interface Reference -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed.
PAGE 146
Command Line Interface Reference InForm OS Version 2.3.1 -cnt Specifies the number of identical virtual volumes to create. This must be an integer from 1 to 999. If is specified with -i option, it is used as the ID of the first virtual volume and incremented by 1 for each subsequent volume. -shared Specifies that the system will try to share the logical disks among the virtual volumes. This option can only be used with the -cnt option.
PAGE 147
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: If the volume is not in any domain, then its retention time cannot exceed the value of the system's VVRetentionTimeMax. The default value for the system's VVRetentionTimeMax is 14 days. If the volume belongs to a domain, then its retention time cannot exceed the value of the domain's VVRetentionTimeMax, if set. The retention time cannot be removed or reduced once it is set.
PAGE 148
Command Line Interface Reference InForm OS Version 2.3.1 –pol [,...] Specifies VV policies. stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume, but the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted. Failure to update a snapshot is considered a failure to write to the base volume.
PAGE 149
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS When creating a logical disk, all physical disks must have the same device type. EXAMPLES The following example creates 3 virtual volumes vv1.2, vv1.3, vv1.4: cli% createaldvv -cnt 3 vv1.2 1g The following example creates a RAID-5 virtual volume using disks in cages 0 and 1: cli% createaldvv -t r5 -p -cg 0,1 vva 1g The following example creates 2 virtual volumes, vva.0 and vva.
PAGE 150
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createavv 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 createavv command creates a virtual volume where logical disk mapping is determined by the system.
PAGE 151
InForm OS Version 2.3.1 Command Line Interface Reference –aw Specifies the percentage of used snapshot data space that when reached, results in a warning alert. To disable the warning, enter 0. –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.
PAGE 152
Command Line Interface Reference InForm OS Version 2.3.1 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).
PAGE 153
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ Logical disks must be available to run the createavv command. Issue the createald command to create logical disks. See createald on page 11.3 for more information. ■ The . , , and specifiers cannot be used if the createavv -cpg command is issued.
PAGE 154
Command Line Interface Reference InForm OS Version 2.3.1 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 read/ write.
PAGE 155
InForm OS Version 2.3.1 Command Line Interface Reference –sdgs [g|G|t|T] 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. If the value is followed by a g or G, (no whitespace before g or G) the size is in GB. If the value is followed by a t or T, (no whitespace before t or T) the size is in TB.
PAGE 156
Command Line Interface Reference InForm OS Version 2.3.1 -sd ... Specifies that existing logical disks are added to the CPG and are used for snapshot data (SD) space allocation. The argument can be repeated to specify multiple logical disks. This option is deprecated and will be removed in a subsequent release. NOTE: The following options, –t, –szs, –rs, –ss, –ha, –ch, and –p are used to control auto logical disk creation (if auto-grow is enabled).
PAGE 157
InForm OS Version 2.3.1 Command Line Interface Reference –ch first|last Specifies the chunklet location characteristics, either first (lowest numbered available chunklets) or last (highest numbered available chunklets). If no argument is specified, the default characteristic is first. –p Specifies a pattern for candidate disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all Fibre Channel (FC) disks.
PAGE 158
Command Line Interface Reference InForm OS Version 2.3.1 –mg Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (1,2,3). A range of drive magazines is separated with a hyphen (0–7). The specified magazine(s) must contain disks.
PAGE 159
InForm OS Version 2.3.1 Command Line Interface Reference –devid Specifies that PDs identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command. –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for Nearline, or SSD for Solid State Drive) to be used. Device types can be displayed by issuing the showpd command.
PAGE 160
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays the creation of common provisioning group cpg1, whose logical disk storage is set to autogrow at 16 GB, has a growth limit of 32 GB, and receives a growth warning at 24 GB: cli% createcpg -sdgs 16g -sdgl 32g -sdgw 24g cpg1 The following example displays disks that satisfy all of the specified characteristics used.
PAGE 161
InForm OS Version 2.3.1 ■ Command Line Interface Reference 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 or -p -devtype SSD option to override this default. Use the showpd command to see the device types of physical disks in the system. ■ The options -sdgs, -sdgl and -sdgw control the auto logical disk creation for the Common Provisioning Group's (CPG) snapshot data regions.
PAGE 162
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 163
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the creation of domain Engineering with an informational comment: cli% createdomain -comment “This is a test domain.” Engineering NOTES None. 11.
PAGE 164
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createdomainset DESCRIPTION The createdomainset command defines a new set of domains and provides the option of assigning one or more existing domains to that set. The command also allows the addition of domains to an existing set by use of the -add option. SYNTAX createdomainset [options] [...] AUTHORITY Super, Edit OPTIONS -add Specifies that the domains listed should be added to an existing set.
PAGE 165
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES To create a domain set with 2 domains in it: cli% createdomainset domset domain1 domain2 To create an empty domain set with a comment: cli% createdomainset -comment "A placeholder set" emptyset NOTES None. 11.
PAGE 166
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 167
InForm OS Version 2.3.1 Command Line Interface Reference -retain [d|D|h|H] Specifies the amount of time, relative to the current time, that the volume will be retained. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value.
PAGE 168
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 169
InForm OS Version 2.3.1 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 ...
PAGE 170
Command Line Interface Reference InForm OS Version 2.3.1 –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.
PAGE 171
InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ The creategroupvvcopy command can be issued multiple times. However, the InServ system allows only two active physical copy tasks to run concurrently. Any additional physical copy tasks are queued, pending the completion of the active physical copy tasks. ■ 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.
PAGE 172
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 173
InForm OS Version 2.3.1 Command Line Interface Reference -persona Sets the host persona that specifies the personality for all ports which are part of the host set. This selects certain variations in SCSI command behavior which certain operating systems expect. The is the host persona ID number with the desired capabilities. These can be seen with showhost -listpersona. -loc Specifies the host’s location. -ip Specifies the host’s IP address.
PAGE 174
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example creates system host test01: cli% createhost test01 2000000087041F72 The following example creates an iSCSI host test02: cli% createhost -iscsi test02 iqn.1991-06.com.microsoft:dt-391xp.hq.3par.
PAGE 175
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND createhostset DESCRIPTION The createhostset command defines a new set of hosts and provides the option of assigning one or more existing hosts to that set. The command also allows the addition of hosts to an existing set by use of the -add option. SYNTAX createhostset [options] [...] AUTHORITY Super, Edit OPTIONS -add Specifies that the hosts listed should be added to an existing set.
PAGE 176
Command Line Interface Reference RESTRICTIONS None. EXAMPLES To create an empty hostset: cli% createhostset hostset To add a host to the set: cli% createhostset -add hostset hosta To create a host set with a comment and a host in it: cli% createhostset -comment “A host set” oraset ora1 NOTES None. 11.44 InForm OS Version 2.3.
PAGE 177
InForm OS Version 2.3.1 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. Please use the createvv command in the future. 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] ...
PAGE 178
Command Line Interface Reference InForm OS Version 2.3.1 –cpsd Adds this logical disk to the specified CPG SD space. –cpsa Adds this logical disk to the specified CPG SA space. Only RAID-1 logical disks may be used for the SA space. –ha port|cage|mag Defines the availability of the logical disk. The default is cage. The availability setting is used to select the destination chunklets during relocation of failed chunklets.
PAGE 179
InForm OS Version 2.3.1 ■ Command Line Interface Reference To create a RAID-1 volume the mirror depth (-md flag) must be specified. For RAID-5 or RAID-6 volume the parityset (-ps flag) must be specified. The owner and backup_owner option should be a number between 0 and 7 and should be the node ID of a valid node in the system. The mirror depth can take any value between 2 and 4, inclusive. 11.
PAGE 180
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 181
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example creates an asynchronous periodic mode volume group named Group1 whose target system is InServ2 (target name InServ2_out): cli% creatercopygroup Group1 InServ2_out:periodic If using domains, the syntax would appear as: cli% creatercopygroup -domain domain2 Group1 InServ2_out:periodic NOTES None. 11.
PAGE 182
Command Line Interface Reference InForm OS Version 2.3.1 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 [options] IP [...
PAGE 183
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the node, slot, and port of the Ethernet port on the local system and an IP address of the peer port on the target system. Specifies the node, slot, port of the Fibre Channel port on the local system and a World Wide Name (WWN) address on the target system. RESTRICTIONS ■ Access to all domains is required to run this command.
PAGE 184
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createsched DESCRIPTION The createsched command allows users to schedule tasks that are periodically run by the scheduler. SYNTAX createsched [options] AUTHORITY Super, Service OPTIONS -run_once The task will only run once at the specified time. -no_alert Tasks created with the no_alert option will not generate alerts if the task fails.
PAGE 185
InForm OS Version 2.3.1 ■ Command Line Interface Reference Only the following commands can be scheduled: updatesnapspace,createsv, removevv, createvvcopy, creategroupsv, creategroupcopy, moverlocpd, checkhealth, compactcpg, compactld, syncrcopy, tunealdvv, tunepd, tunetpvv, tunevv, updatevv. EXAMPLES The following example creates a snapshot every hour that expires in 2 hours for volume vvname: cli% createsched "createsv -ro -exp 2h @vvname@.
PAGE 186
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ The string has five fixed fields: minute, hour, day-of-month, month, day-of-week. ■ Fields are separated by spaces. The allowed values for the fields are: Field Allowed Values Minute 0-59 Hour * or 0-23 Day-of-Month * or 1-31 Month * or 1-12 Day-of-Week * or 0-6 (0 is Sunday) ■ Scheduling on Feburary 29 is not supported. ■ Lists are allowed. A list is a set of numbers (or ranges) separated by commas.
PAGE 187
InForm OS Version 2.3.
PAGE 188
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createspare DESCRIPTION The createspare command allocates chunklet resources as spares. 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 Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Do not ask for confirmation.
PAGE 189
InForm OS Version 2.3.1 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.
PAGE 190
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 191
InForm OS Version 2.3.1 Command Line Interface Reference -retain [d|D|h|H] Specifies the amount of time, relative to the current time, that the volume will be retained. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value.
PAGE 192
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example creates a read-only snapshot volume svro_vv0 from volume vv0: cli% createsv –ro svr0_vv0 vv0 The following example creates snapshot volume svrw_vv0 from the snapshot svro_vv0: cli% createsv svrw_vv0 svro_vv0 The following example creates a snapshot volume for each member of the VV set vvcopies.
PAGE 193
InForm OS Version 2.3.1 Command Line Interface Reference 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 VVs, LDs, and CPGs. SYNTAX createtemplate VV|LD|CPG [options ] AUTHORITY Super NOTE: You need access to all domains in order to run this command.
PAGE 194
Command Line Interface Reference InForm OS Version 2.3.1 –t Specifies the RAID type of the logical disk: r0 for RAID-0, r1 for RAID-1, r5 for RAID-5, or r6 for RAID-6. If no RAID type is specified, the default is r1. –ssz Specifies the set size in terms of chunklets. The default depends on the RAID type specified: 2 for RAID-1, 4 for RAID-5, and 8 for RAID-6. –rs Specifies the number of sets in a row using a positive integer.
PAGE 195
InForm OS Version 2.3.1 Command Line Interface Reference –nd Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node 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).
PAGE 196
Command Line Interface Reference InForm OS Version 2.3.1 –dk Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create LDs based on the characteristics of the disk drive.
PAGE 197
InForm OS Version 2.3.1 Command Line Interface Reference -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed.
PAGE 198
Command Line Interface Reference InForm OS Version 2.3.1 –size [g|G|t|T] Specifies the size of the virtual volume and logical disk in megabytes. Size can be specified in megabytes (default) or in gigabytes by using the g|G parameter and terabytes by using the t|T parameter. To specify the size in gigabytes, enter g or G, for terabytes, enter t or T, directly after the specified size (no space).
PAGE 199
InForm OS Version 2.3.1 Command Line Interface Reference stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume, but the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted. Failure to update a snapshot is considered a failure to write to the base volume.
PAGE 200
Command Line Interface Reference InForm OS Version 2.3.1 -snp_cpg The name of the CPG from which the snapshot space is allocated. -snp_aw Provides a snapshot space allocation warning. Generates a warning alert when the snapshot space of the virtual volume exceeds the specified percentage of the virtual volume size. -snp_al Provides a snapshot space allocation limit.
PAGE 201
InForm OS Version 2.3.1 Command Line Interface Reference –sdgl [g|G|t|T] Limits the auto-grow from exceeding this storage amount. A size of 0 means no limit is enforced. Size can be specified in megabytes (default) or in gigabytes by using the g|G parameter or terabytes by using the t|T parameter. To specify the size in gigabytes, enter g or G, for terabytes, enter t or T, directly after the specified size (no space). The default is 0.
PAGE 202
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ 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 or -p -devtype SSD option to override this default. Use the showpd command to see the device types of physical disks in the system. ■ The value for –ssz and –rs can be set to –.
PAGE 203
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND createtpvv DESCRIPTION This command is deprecated and will be removed in a subsequent release. Please use the createvv -tpvv command in the future. The createtpvv command creates a multi-space Thinly Provisioned Virtual Volume (TPVV). When the -snp_cpg option is specified, both of the user space and snapshot space of the TPVV are created.
PAGE 204
Command Line Interface Reference ■ InForm OS Version 2.3.1 The following option specifies the name of the template used to create a TPVV. –templ Use the options defined in template . The template is created using the createtemplate command. Options specified in the template are read-only or readwrite. The read-write options may be overridden with new options at the time of their creation, but read-only options may not be overridden at the time of creation.
PAGE 205
InForm OS Version 2.3.1 Command Line Interface Reference -hpc Defines the VV geometry heads per cylinder value that is reported to the hosts though the SCSI mode pages. The valid range is between 1 to 1024 and the default value is 8. -exp [d|D|h|H] Specifies the relative time from the current time that volume will expire. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days).
PAGE 206
Command Line Interface Reference ■ InForm OS Version 2.3.1 The following defines the volume policy: –pol [,...] Specifies VV policies. stale_ss Specifies that invalid snapshot volumes are permitted. Failure to update snapshot data does not affect the write to the base volume, but the snapshot is considered invalid. no_stale_ss Specifies that invalid snapshot volumes are not permitted. Failure to update a snapshot is considered a failure to write to the base volume.
PAGE 207
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: Thin Persistence can have some performance implications during extremely busy system conditions. 3PAR recommends the zero_detect policy only be enabled during Thin Persistence and Thin Conversion operations. The zero_detect policy should be disabled during normal operation. no_zero_detect This policy disables the InServ to scan for zeros in the incoming write data to reclaim allocated space on the volume. This is the default policy setting.
PAGE 208
Command Line Interface Reference InForm OS Version 2.3.1 In the preceding example, a 1 GB TPVV named tpvv1 is allocated from a CPG named cpg1 and its allocation warnings and limits are set at 50% and 75%, respectively. The following example creates 3 VVs vv1.2, vv1.3, vv1.4: cli% createtpvv -cnt 3 cpg1 vv1.2 1g NOTES For this command: 11.
PAGE 209
InForm OS Version 2.3.1 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.
PAGE 210
Command Line Interface Reference InForm OS Version 2.3.1 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 ■ Access to all domains is required to run this command. ■ Encrypted passwords are generated by the system. Therefore, you can only specify previously generated encrypted passwords.
PAGE 211
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND createvlun DESCRIPTION The createvlun command creates a Virtual Logical Unit Number (VLUN) template that enables export of a Virtual Volume (VV) has a SCSI VLUN to one or more host(s). A SCSI VLUN is created when the current system state matches the rule established by the VLUN template. There are four types of VLUN templates: ■ port presents - created when only the node:slot:port are specified.
PAGE 212
Command Line Interface Reference InForm OS Version 2.3.1 Matched set: ■ createvlun [options] ■ createvlun [options] AUTHORITY Super, Edit OPTIONS –f Specifies that the operation is forced and that the VLUN is created even if the specified VV has existing VLUNs. Unless the –f option is specified, the command asks for confirmation if a VV is already exported in a VLUN template.
PAGE 213
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the LUN as an integer from 0 through 16383. Alternatively + can be used to indicate a LUN should be auto assigned, but be a minimum of n, or n-m to indicate that a LUN should be chosen in the range n to m. In addition the keyword auto may be used and is treated as 0+. Specifies the host where the LUN is exported, using up to 31 characters.
PAGE 214
Command Line Interface Reference ■ InForm OS Version 2.3.1 Verify the creation of VLUNs by issuing the showvlun command. See showvlun on page 22.195 for more information. ■ Conflicts between overlapping VLUN templates are resolved by a priority order among templates with matched set being the highest and port presents the lowest. 11.
PAGE 215
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND createvv DESCRIPTION The createvv command creates volumes that are provisioned from one or more Common Provisioning Groups (CPGs). 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. SYNTAX createvv [options] [.
PAGE 216
Command Line Interface Reference InForm OS Version 2.3.1 -shared Specifies that the system will try to share the Logical Disks (LDs) among the VVs. This option can only be used with the -cnt option. This option cannot be used with the -tpvv option. -wait If the command would fail due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately.
PAGE 217
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: If the volume is not in any domain, then its retention time cannot exceed the value of the system's VVRetentionTimeMax. The default value for the system's VVRetentionTimeMax is 14 days. If the volume belongs to a domain, then its retention time cannot exceed the value of the domain's VVRetentionTimeMax, if set. The retention time cannot be removed or reduced once it is set.
PAGE 218
Command Line Interface Reference InForm OS Version 2.3.1 no_one_host This policy should only be used when exporting a VV to multiple hosts for use by a cluster-aware application, or when port presents VLUNs are used. This is the default policy setting. tp_bzero Specifies that if a host write results in the allocation of a new data page that is only partially filled by the host write, then a zero-fill is performed on the unwritten portion of the data page.
PAGE 219
InForm OS Version 2.3.1 Command Line Interface Reference -snp_al Sets a snapshot space allocation limit. The snapshot space of the VV is prevented from growing beyond the indicated percentage of the VV size. The following options can be used when creating Thinly Provisioned Virtual Volumes (TPVVs): -tpvv Specifies that the volume should be a TPVV. -usr_aw This option enables user space allocation warning.
PAGE 220
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS ■ Access to all domains is required to to run this command with logical disks specified. ■ Use of this command with the -tpvv option requires a Thin Provisioning license. Contact your local 3PAR representative for information. ■ The -templ option is not valid for volumes that are fully provisioned. ■ The -shared and -wait option cannot be used when creating Thinly Provisioned Virtual Volumes with the -tpvv option.
PAGE 221
InForm OS Version 2.3.1 ■ Command Line Interface Reference For this command: ◆ MB = 1048576 bytes ◆ GB = 1024 MB ◆ TB = 1024 GB 11.
PAGE 222
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createvvcopy DESCRIPTION The createvvcopy command creates a full physical copy of a Virtual Volume (VV) or a read/write virtual copy on another VV. This enables you to create copies of VV to perform tasks such as moving data to a larger VV or creating a copy of data for testing.
PAGE 223
InForm OS Version 2.3.1 Command Line Interface Reference –halt Specifies that an ongoing physical copy or snapshot promotion should be stopped.This will cause the destination volume to be marked with the cpf status, which will be cleaned up when it is promoted to a base volume or when a new copy is started. –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.
PAGE 224
Command Line Interface Reference ■ InForm OS Version 2.3.1 A physical copy of a VV fails in any situation that a snapshot copy fails or when there is insufficient snapshot space or I/O errors. EXAMPLES The following example displays the creation of a copy of the VV vv1: cli% createvvcopy –p vv1 vv2 Started copy.
PAGE 225
InForm OS Version 2.3.1 ■ Command Line Interface Reference 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.
PAGE 226
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND createvvset DESCRIPTION The createvvset command defines a new set of Virtual Volumes (VV) and provides the option of assigning one or more existing VVs to that set. The command also allows the addition of VVs to an existing set by use of the -add option. SYNTAX createvvset [options] [...] AUTHORITY Super, Edit OPTIONS -add Specifies that the VVs listed should be added to an existing set.
PAGE 227
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the name of the VV set to create or add to. The name can be up to 27 characters in length. ... Optional lists of VVs or glob-style pattern matching VVs which are to be included in the VV set. If no or is specified a VV set with no VVs is created. If the -cnt option is used then a VV must be specified. RESTRICTIONS None.
PAGE 228
Command Line Interface Reference 11.96 InForm OS Version 2.3.
PAGE 229
InForm OS Version 2.3.1 Command Line Interface Reference 12 Dismiss Commands In this chapter dismisspd 12.2 dismissrcopylink 12.3 dismissrcopytarget 12.5 dismissrcopyvv 12.6 Dismiss Commands 12.
PAGE 230
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND dismisspd DESCRIPTION The dismisspd command removes Physical Disk (PD) definitions from system use. SYNTAX dismisspd ... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS None SPECIFIERS ... Specifies the PD(s), identified by integers, to be removed from system use. RESTRICTIONS ■ Access to all domains is required to run this command.
PAGE 231
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND dismissrcopylink DESCRIPTION The dismissrcopylink command removes one or more links (connections) to a target system. SYNTAX ■ Syntax for Remote Copy over IP (RCIP) is as follows: dismissrcopylink ... ■ Syntax for Remote Copy over Fibre Channel (RCFC) is as follows: dismissrcopylink ... AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command.
PAGE 232
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS ■ Access to all domains is required to run this command. ■ Functionality of this command requires a 3PAR Remote Copy license. Contact your local service provider for more information. ■ This command cannot be used to remove the last link of a target system with started groups. ■ This command terminates with a list of one or more links to be dismissed.
PAGE 233
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND dismissrcopytarget DESCRIPTION The dismissrcopytarget command removes a Remote Copy target from a Remote Copy volume group. SYNTAX dismissrcopytarget AUTHORITY Super, Edit OPTIONS None. SPECIFIERS Specifies the name of the target to be removed. The name of the group that currently includes the target.
PAGE 234
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND dismissrcopyvv DESCRIPTION The dismissrcopyvv command removes a Virtual Volume (VV) from a Remote Copy volume group. SYNTAX dismissrcopyvv AUTHORITY Super, Edit 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.
PAGE 235
InForm OS Version 2.3.1 Command Line Interface Reference 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.
PAGE 236
Command Line Interface Reference 12.8 InForm OS Version 2.3.
PAGE 237
InForm OS Version 2.3.1 Command Line Interface Reference 13 Free Command In this chapter freespace 13.2 Free Command 13.
PAGE 238
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND freespace DESCRIPTION The freespace command frees snapshot administration and snapshot data spaces from a Virtual Volume (VV)if they are not in use. SYNTAX freespace [options] ...|... AUTHORITY Super, Edit OPTIONS –pat Remove the snapshot administration and snapshot data spaces from all the VV that match any of the specified glob-style patterns.
PAGE 239
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example demonstrates how to remove SA and SD space from virtual volume testd: cli% freespace testd NOTES This command fails if the virtual volume is an old-style thin provisioned VV (created on a 2.2.4 release or earlier) or it has snapshots. 13.
PAGE 240
Command Line Interface Reference 13.4 InForm OS Version 2.3.
PAGE 241
InForm OS Version 2.3.1 Command Line Interface Reference 14 Grow Commands In this chapter growaldvv 14.2 growavv 14.10 growtpvv 14.12 growvv 14.14 Grow Commands 14.
PAGE 242
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND growaldvv DESCRIPTION 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. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growaldvv command automatically enlarges (grows) the size of a virtual volume by adding underlying logical disks.
PAGE 243
InForm OS Version 2.3.1 Command Line Interface Reference –szs [g|G|t|T] Specifies the size of the snapshot volume in megabytes using an integer between 0 and 67108864 (65536 GB). Size can optionally be specified in gigabytes or terabytes by providing either the g or G options (for gigabytes) and t or T options (for terabytes) following (no whitespace between) the entered size value. This option cannot be used with the -pct option.
PAGE 244
Command Line Interface Reference InForm OS Version 2.3.1 –ss Specifies the step size in kilobytes using 32, 64, 128, 256, or 512. The default depends on whether the RAID type is specified. If the RAID type is not specified or is the same RAID type as the last region of the existing virtual volume, the default is the same step size as the last region of the virtual volume. Otherwise, the step size defaults to 256 KB for RAID-0 and RAID-1, and 128 KB for RAID-5.
PAGE 245
InForm OS Version 2.3.1 Command Line Interface Reference –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all disks of device type specified at creation time. If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern.
PAGE 246
Command Line Interface Reference InForm OS Version 2.3.1 –mg Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (1, 2, 3). A range of drive magazines is separated with a hyphen(0-7). The specified drive magazine(s) must contain disks.
PAGE 247
InForm OS Version 2.3.1 Command Line Interface Reference –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their device IDs be 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.
PAGE 248
Command Line Interface Reference ■ InForm OS Version 2.3.1 Options –pct and –szs cannot be used in the same instance of issuing the growaldvv command. ■ One or more of the –szu, –sza, and –szs options must be specified. ■ If enlarging either the administration or snapshot space on the VV and both administration and snapshot space are zero MB, the administration and snapshot space must be enlarged together. Both, the –sza and –szs options must be specified on the command line.
PAGE 249
InForm OS Version 2.3.1 ■ ■ Command Line Interface Reference If no device type is specified using the –p –devtype option, Fibre Channel is assumed. This command is only used for a non-provisioned VV. The command growvv should be used instead for a virtual volume that has its user space provisioned from a CPG. ■ For this command: ◆ KB = 1024 bytes ◆ MB = 1024 KB ◆ GB = 1024 MB 14.
PAGE 250
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND growavv DESCRIPTION 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. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growavv command enlarges a Virtual Volume (VV) with automatic mapping to the Logical Disks (LDs).
PAGE 251
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the LDs to be used as user space. The LDs 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 your area in megabytes. Specifies the LDs to be used as snapshot administrator space. The LDs are identified by one or more integers (item).
PAGE 252
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND growtpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the growvv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The growtpvv command enlarges a Thinly Provisioned Virtual Volume (TPVV).
PAGE 253
InForm OS Version 2.3.1 Command Line Interface Reference NOTES For this command: ■ MB = 1048576 bytes ■ GB = 1024 MB ■ TB = 1024 GB 14.
PAGE 254
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND growvv DESCRIPTION The growvv command increases the size of a Virtual Volume (VV) created with the createvv or createtpvv commands. SYNTAX growvv [g|G|t|T] CAUTION: For Remote Copy configuration, before issuing the growvv command on the primary InServ, ensure the secondary InServ has sufficient space for an equal increase in Virtual Volume size.
PAGE 255
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the enlarging of the of virtual volume vv0 by 10 G: cli% growvv vv0 10g NOTES ■ ■ For the command: ◆ MB = 1048576 bytes ◆ GB = 1024 MB ◆ TB = 1024 GB For Remote Copy configuration after issuing the growvv command, the affected Virtual Volume cannot be reduced back to the original size on the primary InServ. 14.
PAGE 256
Command Line Interface Reference 14.16 InForm OS Version 2.3.
PAGE 257
InForm OS Version 2.3.1 Command Line Interface Reference 15 Hist Commands In this chapter histch 15.2 histld 15.6 histpd 15.10 histport 15.18 histvlun 15.23 histvv 15.28 Hist Commands 15.
PAGE 258
Command Line Interface Reference InForm OS Version 2.3.1 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 (LD), identified by name, from which chunklet statistics are sampled. –ch Specifies that statistics are limited to only the specified chunklet, identified by number.
PAGE 259
InForm OS Version 2.3.1 ◆ 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.
PAGE 260
Command Line Interface Reference InForm OS Version 2.3.1 inc Sort in increasing order (default). dec Sort in decreasing order. Multiple 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 ,,.
PAGE 261
InForm OS Version 2.3.1 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.
PAGE 262
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND histld DESCRIPTION The histld command displays a histogram of service times for Logical Disks (LDs) in a timed loop. SYNTAX histld [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -vv ...|... Show only LDs that are mapped to Virtual Volumes (VVs) with names that match any of the names or patterns specified. Multiple volumes or patterns can be repeated using a comma separated list.
PAGE 263
InForm OS Version 2.3.1 ◆ 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.
PAGE 264
Command Line Interface Reference InForm OS Version 2.3.1 –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.
PAGE 265
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays one iteration of a histogram of service times for all LDs: 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.
PAGE 266
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND histpd DESCRIPTION The histpd command displays a histogram of service times for Physical Disks (PDs). SYNTAX histpd [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –w Specifies the World Wide Name (WWN) of the physical disk for which service times are displayed. –nodes Specifies that the display is limited to specified nodes and physical disks connected to those nodes.
PAGE 267
InForm OS Version 2.3.1 Command Line Interface Reference –devinfo Indicates the device disk type and speed. –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, shows the columns from the first column through last column .
PAGE 268
Command Line Interface Reference InForm OS Version 2.3.1 –prev|–begin Histogram displays data either from a previous sample (–prev) or from when the system was last started (–begin). If no option is specified, the histogram shows data from the beginning of the command’s execution. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed.
PAGE 269
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the threshold service time in milliseconds. Specifies the minimum number of access above the threshold service time. –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 PDs displayed in the histogram. Patterns are used to filter and select the disks displayed in the histogram.
PAGE 270
Command Line Interface Reference InForm OS Version 2.3.1 –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). The specified drive cage(s) must contain disks. –mg Specifies one or more drive magazines. The 1. or 0.
PAGE 271
InForm OS Version 2.3.1 Command Line Interface Reference –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command.
PAGE 272
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 273
InForm OS Version 2.3.1 ■ Command Line Interface Reference Previous options –n , –s , and –p have been replaced with –nodes , –slots , and –ports . 15.
PAGE 274
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 275
InForm OS Version 2.3.1 Command Line Interface Reference –host|disk|-rcfc Specifies to display only host ports (target ports), only disk ports (initiator ports), or only Fibre Channel Remote Copy configured ports. If no option is specified, all ports are displayed. –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.
PAGE 276
Command Line Interface Reference InForm OS Version 2.3.1 –prev|–begin Histogram displays data either from a previous sample (–prev) or from when the system was last started (–begin). If no option is specified, the histogram shows data from the beginning of the command’s execution. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed.
PAGE 277
InForm OS Version 2.3.1 Command Line Interface Reference ◆ t - Specifies total statistics. ◆ rw - Specifies total read and write statistics. Specifies the threshold service time in milliseconds. Specifies the minimum number of access above the threshold service time. –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.
PAGE 278
Command Line Interface Reference ■ InForm OS Version 2.3.1 Each I/O size histogram column shows the number of accesses with I/O size between the size shown in the column's heading to the size shown in the heading of the column to its right (or infinity for the last column). ■ Previous options –n , –s , and –p have been replaced with –nodes , –slots , and –ports . 15.
PAGE 279
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND histvlun DESCRIPTION The histvlun command displays Virtual Volume Logical Unit Number (VLUN) service time histograms. SYNTAX histvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ...|... Shows only VLUNs whose Virtual Volumes (VVs) are in domains with names that match one or more of the specified domain names or patterns.
PAGE 280
Command Line Interface Reference InForm OS Version 2.3.1 –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). If the slot list is not specified, all disks on all slots are displayed. –ports Specifies that only exports to the specified ports are to be displayed.
PAGE 281
InForm OS Version 2.3.1 ◆ 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.
PAGE 282
Command Line Interface Reference InForm OS Version 2.3.1 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. The argument is specified in the syntax of ,, with no space after each comma. The argument can be specified as one of the following: ◆ r - Specifies read statistics. ◆ w - Specifies write statistics.
PAGE 283
InForm OS Version 2.3.1 Command Line Interface Reference 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.
PAGE 284
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND histvv DESCRIPTION The histvv command displays Virtual Volume (VV) service time histograms in a timed loop. SYNTAX histvv [options ] [|]... AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ...|... Shows only the VVs 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.
PAGE 285
InForm OS Version 2.3.1 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).
PAGE 286
Command Line Interface Reference InForm OS Version 2.3.1 –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.
PAGE 287
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays two iterations of a histogram of service times for all VVs: %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.1 4.2 8.
PAGE 288
Command Line Interface Reference 15.32 InForm OS Version 2.3.
PAGE 289
InForm OS Version 2.3.1 Command Line Interface Reference 16 Locate Commands In this chapter locatecage 16.2 locatesys 16.4 Locate Commands 16.
PAGE 290
Command Line Interface Reference InForm OS Version 2.3.1 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.
PAGE 291
InForm OS Version 2.3.1 Command Line Interface Reference Indicates the port specifiers. Accepted values are A0|B0|A1|B1|A2|B2|A3|B3. 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 DC1 drive cages, accepted values are 0 through 4. ◆ For DC2 and DC4 drive cages, accepted values are 0 through 9.
PAGE 292
Command Line Interface Reference InForm OS Version 2.3.1 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 Super, Service NOTE: You need access to all domains in order to run this command.
PAGE 293
InForm OS Version 2.3.1 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.
PAGE 294
Command Line Interface Reference 16.6 InForm OS Version 2.3.
PAGE 295
InForm OS Version 2.3.1 Command Line Interface Reference 17 Move Commands In this chapter movech 17.2 movechtospare 17.6 movepdtospare 17.9 moverelocpd 17.12 movetodomain 17.18 Move Commands 17.
PAGE 296
Command Line Interface Reference InForm OS Version 2.3.1 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. -dr Specifies that the operation is a dry run. No chunklets are actually moved.
PAGE 297
InForm OS Version 2.3.1 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>]...
PAGE 298
Command Line Interface Reference InForm OS Version 2.3.1 General Information: ◆ dest_unknown. Destination is unknown. ◆ dest_unknown. Destination is known. ◆ valid_move. Source and Destination are valid. ◆ ch_moved. Chunklet was moved. ◆ ch_move_pending. Chunklet move is pending due to -nowait option. ◆ move_error. Error moving chunklet. Error Information: ◆ error_type_unknown. An unknown error occurred. ◆ spares_not_found. No suitable spares available. ◆ duplicate_src.
PAGE 299
InForm OS Version 2.3.1 ◆ Command Line Interface Reference raid_availability_reduced. RAID availability reduced. 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.
PAGE 300
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND movechtospare DESCRIPTION The movechtospare command moves data from specified Physical Disks (PDs) 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. -dr Specifies that the operation is a dry run.
PAGE 301
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES In the following example, chunklet 0 from physical disk 66 is moved to spare: cli% movechtospare 66:0 Are you sure you want to move the chunklet to spare? select q=quit y=yes n=no: y Move -Status- -Detailed_State-66:0-54:49 normal ch_moved,normal The columns in the previous example are identified as follows: ■ ■ Status. The overall status of the move. ◆ normal. Indicates the chunklet has successfully moved with no loss of quality.
PAGE 302
Command Line Interface Reference ◆ ch_synching. Chunklet is synchronizing. ◆ src_no_ld. Source not associated with an LD. ◆ src_ld_invalid. Source associated with invalid LD. ◆ src_set_invalid. Source is in invalid set. ◆ src_not_found. Source chunklet does not exist. ◆ invalid_dest. Destination is invalid. ◆ move_failed. Chunklet move failed. ◆ disk_relocating. Disk is relocating. Degraded Information: ◆ disks_reused_in_row. Disks reused in row. ◆ connection_degraded.
PAGE 303
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND movepdtospare DESCRIPTION The movepdtospare command moves data from specified Physical Disks (PDs) 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. -dr Specifies that the operation is a dry run.
PAGE 304
Command Line Interface Reference InForm OS Version 2.3.
PAGE 305
InForm OS Version 2.3.1 ◆ duplicate_src. Duplicate source input. ◆ duplicate_dest. Duplicate destination in chunklet list. ◆ src_relocating. Source is relocating. ◆ ch_synching. Chunklet is synchronizing. ◆ src_no_ld. Source not associated with an LD. ◆ src_ld_invalid. Source associated with invalid LD. ◆ src_set_invalid. Source is in invalid set. ◆ src_not_found. Source chunklet does not exist. ◆ invalid_dest. Destination is invalid. ◆ move_failed. Chunklet move failed.
PAGE 306
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND moverelocpd DESCRIPTION The moverelocpd command moves chunklets that were on a physical disk to the target of relocation. SYNTAX moverelocpd [options] [[–...] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –nowait Specifies that the command returns before the operation is completed. -dr Specifies that the operation is a dry run. No physical disks are actually moved.
PAGE 307
InForm OS Version 2.3.1 Command Line Interface Reference -nd Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (e.g. 1,2,3). A range of nodes is separated with a hyphen (e.g. 0-7). The primary path of the disks must be on the specified node(s). -st Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (e.g. 1,2,3).
PAGE 308
Command Line Interface Reference InForm OS Version 2.3.1 -dk Specifies one or more physical disks. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (e.g. 1,2,3). A range of disks is separated with a hyphen (e.g. 0-3). Disks must match the specified ID(s). -tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected.
PAGE 309
InForm OS Version 2.3.1 Command Line Interface Reference 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 that the chunklets that were relocated from specified disk (), are moved to the specified destination disk ().
PAGE 310
Command Line Interface Reference ■ InForm OS Version 2.3.1 Detailed_State. Provides additional details of the move with General Information, Error Information, or Degraded Information. General Information: ◆ dest_unknown. Destination is unknown. ◆ dest_unknown. Destination is known. ◆ valid_move. Source and Destination are valid. ◆ ch_moved. Chunklet was moved. ◆ ch_move_pending. Chunklet move is pending due to -nowait option. ◆ move_error. Error moving chunklet.
PAGE 311
InForm OS Version 2.3.1 ◆ remote_pds_used. Connection Degraded. ◆ ldpattern_not_obeyed. LD pattern was not obeyed. ◆ raid_availability_reduced. RAID availability reduced. Command Line Interface Reference NOTES ■ Chunklets moved from physical disks fd are treated as if they originated on disk td. Disk td can be the same as disk fd. ■ Specifying the –dr option can be used to see if the specified moves succeeds and what the results (quality) of the moves are.
PAGE 312
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND movetodomain DESCRIPTION The movetodomain command moves Common Provisioning Groups (CPGs) from one domain to another. SYNTAX movetodomain [options] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS –vv Specifies that the object is a virtual volume. -cpg Specifies that the object is a CPG. –host Specifies that the object is a host.
PAGE 313
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLE The following example displays the movement of VV vv1 to domain SampleDomain: cli% movetodomain -vv vv1 SampleDomain The following volumes will have their domain modified: vv1 The following hosts will have their domain modified: thehost The following CPGs will have their domain modified: SampleCPG 14 associated LDs will also have their domain changed.
PAGE 314
Command Line Interface Reference 17.20 InForm OS Version 2.3.
PAGE 315
InForm OS Version 2.3.1 Command Line Interface Reference 18 Promote Commands In this chapter promotesv 18.2 promotevvcopy 18.4 Promote Commands 18.
PAGE 316
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND promotesv DESCRIPTION The promotesv command copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. SYNTAX promotesv [options] AUTHORITY Super, Edit OPTIONS -target Copy the differences of the virtual copy to the specified RW parent in the same VV family tree. The default is to copy the differences to the base volume.
PAGE 317
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ The virtual copy and its base volume must not be exported. ■ Only one promote operation is allowed at a time within a VV family tree. EXAMPLES The following example promotes the differences from VV Dub and its base volume Dublin: cli% promotesv Dub NOTES ■ Issue the showvv command to verify that differences in the snapshot volume are promoted to its target volume.
PAGE 318
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND promotevvcopy DESCRIPTION The promotevvcopy command promotes a physical copy back to a regular base volume. SYNTAX promotevvcopy AUTHORITY Super, Edit OPTIONS None. SPECIFIERS Specifies the name of the physical copy to be promoted, using up to 31 characters. RESTRICTIONS The physical copy must have completed the copy from the base volume.
PAGE 319
InForm OS Version 2.3.1 Command Line Interface Reference 19 Remove Commands In this chapter removealert 19.3 removecpg 19.5 removedomain 19.7 removedomainset 19.8 removeeventlog 19.10 removehost 19.12 removehostset 19.14 removeld 19.16 removercopygroup 19.18 removercopytarget 19.20 removesched 19.22 removesnmpmgr 19.24 removesnmppw 19.26 removespare 19.28 removesshkey 19.30 Remove Commands 19.
PAGE 320
Command Line Interface Reference 19.2 InForm OS Version 2.3.1 removetask 19.31 removetemplate 19.33 removeuser 19.35 removeuserconn 19.37 removevlun 19.39 removevv 19.43 removevvset 19.
PAGE 321
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removealert DESCRIPTION The removealert command removes one or more alerts from the system. CAUTION: Use care when removing alerts. Alerts that have not been fixed or acknowledged should NOT be removed. SYNTAX removealert [option] –a|... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies all alerts from the system and prompts removal for each alert.
PAGE 322
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays all alerts from the system with the option to remove individual alerts: cli% removealert –a Id 120 – New Occurred 4 times, last at Tue May 03 22:45:47 PDT 2005 Message code: 196609 Tue May 03 22:23:17 PDT 2005 Node: 0 Severity: Minor Firmware coredump event Firmware COREDUMP: recovered file /var/core/hba/fwcore.n00.s02.p01.20050503.224547 Alert 120 is marked as "New".
PAGE 323
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removecpg DESCRIPTION The removecpg command removes Common Provisioning Groups (CPGs) from the system or removes specific Logical Disks (LDs) from CPGs. AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. SYNTAX removecpg [options ] {|}... OPTIONS –f Specifies that the command is forced.
PAGE 324
Command Line Interface Reference InForm OS Version 2.3.1 –pat The specified patterns are treated as glob-style patterns and that all common provisioning groups matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified. This option must be used if the pattern specifier is used. SPECIFIERS Specifies the name of the CPG that is either being removed or losing LDs. Specifies a glob-style pattern.
PAGE 325
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removedomain DESCRIPTION The removedomain command removes an existing domain from the system. SYNTAX removedomain [option] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f When using this option, the command does not ask for confirmation before removing the domain. SPECIFIERS Specifies the domain that is removed.
PAGE 326
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removedomainset DESCRIPTION The removedomainset command removes a domain set or removes domains from an existing set. SYNTAX removedomainset [options] [...] AUTHORITY Super, Edit OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the domain set. ...
PAGE 327
InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19.
PAGE 328
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removeeventlog DESCRIPTION The removeeventlog command removes all Debug events from the system event log. SYNTAX removeeventlog [option] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS None.
PAGE 329
InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ Without the -f flag, the command prompts for confirmation. ■ Verify the removal of event logs by issuing the showeventlog command. See showeventlog on page 22.41 for more information. 19.
PAGE 330
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removehost DESCRIPTION The removehost command removes a system host or paths to a host. If one or more paths are specified, the command removes only those paths, otherwise the entire host definition is removed. SYNTAX removehost [options] [...|...] AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command.
PAGE 331
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the host iSCSI name to be removed from the specified host. If no ISCSI name is specified, the entire host definition is removed. RESTRICTIONS ■ Access to all domains is required to run this command. ■ A host that has one or more VLUNs exported on it cannot be removed.
PAGE 332
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removehostset DESCRIPTION The removehostset command removes a host set or removes hosts from an existing set. SYNTAX removehostset [options] [...] AUTHORITY Super, Edit OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Name of the host set to remove. ...
PAGE 333
InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19.
PAGE 334
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removeld DESCRIPTION The removeld command removes a specified Logical Disk (LD) from the system service group. SYNTAX removeld [options] {|}... AUTHORITY Super, Service, Edit OPTIONS –pat Specified patterns are treated as glob-style patterns and all LDs matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the –f option is specified.
PAGE 335
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the LD name, using up to 31 characters. Multiple LDs can be specified. Specifies a glob-style pattern. Multiple LDs can be specified. If this specifier is not used, the specifier must be used. See Glob-Style Pattern on page 2.4 for more information. RESTRICTIONS ■ System resource LDs are required for correct operation of the InServ Storage Server.
PAGE 336
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removercopygroup DESCRIPTION The removercopygroup command removes a Remote Copy volume group. SYNTAX removercopygroup AUTHORITY Super, Edit OPTIONS None. SPECIFIERS The name of the group to be removed. RESTRICTIONS ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
PAGE 337
InForm OS Version 2.3.1 ■ Command Line Interface Reference The removercopygroup command removes all the associations configured in the specified group and removes the group name and any Remote Copy synchronization snapshots affiliated with volumes in the group. 19.
PAGE 338
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removercopytarget DESCRIPTION The removercopytarget command removes target designation from a Remote Copy system and removes all links affiliated with that target. SYNTAX removercopytarget [options] AUTHORITY Edit NOTE: You need access to all domains in order to run this command. OPTIONS -cleargroups Remove all groups that have no other targets or dismiss this target from groups with additional targets.
PAGE 339
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example removes target InServ1_in from a Remote Copy system: cli% removercopytarget InServ1_in NOTES None. 19.
PAGE 340
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesched DESCRIPTION The removesched command removes a scheduled task from the system. SYNTAX removesched [options] AUTHORITY Super, Service OPTIONS -pat Specifies that certain patterns are treated as glob-style patterns and that all scheduled tasks matching the specified pattern are removed. By default, confirmation is required to proceed with the command unless the -f option is specified.
PAGE 341
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES None. NOTES None. 19.
PAGE 342
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesnmpmgr DESCRIPTION The removesnmpmgr command removes preregistered SNMP managers from receiving alerts (traps). SYNTAX removesnmpmgr [option ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –p Specifies the port number where the manager receives traps. If not specified, the port number defaults to 162.
PAGE 343
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the removal of a manager with the IPv4 address 123.45.67.89 from the list of registered managers: cli% removesnmpmgr 123.45.67.
PAGE 344
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesnmppw DESCRIPTION The removesnmppw command allows a user to remove SNMP access community string passwords. SYNTAX removesnmppw [options] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Removes the read/write (–rw), read-only (–r), or write-only (–w) password. If not specified, the read/write community string password is removed.
PAGE 345
InForm OS Version 2.3.1 Command Line Interface Reference EXIT STATUS The following codes are returned indicating success or failure: ■ 0 indicates that the password was removed and the command was successful. ■ 1 indicates that the command failed. ■ 2 indicates that a password does not exist. NOTES ■ After a password has been removed, the system manager can no longer use that password to send requests to the SNMP agent. ■ Verify the removal of SNMP passwords by issuing the showsnmppw command.
PAGE 346
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removespare DESCRIPTION The removespare command removes chunklets from the spare chunklet list. SYNTAX removespare [options] ... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 347
InForm OS Version 2.3.1 Command Line Interface Reference a:a Removes all spare chunklets that are not currently used. –pos Specifies the position of a specific chunklet identified by its position in a drive cage, drive magazine, physical disk, and chunklet number. For example –pos 1:0.2:3:121, where 1 is the drive cage, 0.2 is the drive magazine, 3 is the physical disk, and 121 is the chunklet number.
PAGE 348
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removesshkey DESCRIPTION The removesshkey command removes your Secure Shell (SSH) public key to disable key authentication. SYNTAX removesshkey [... ] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS ... Specifies the name of the user whose SSH key is removed. Multiple users can be specified. If not specified, the SSH key for the current user is removed.
PAGE 349
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removetask DESCRIPTION The removetask command removes information about one or more completed tasks and their details. SYNTAX The syntax of the removetask command can be one of the following: ■ removetask [options ] –a ■ removetask [options ] –t ■ removetask [options ] ... AUTHORITY Super, Edit OPTIONS –a Removes all tasks including details. –d Remove task details only.
PAGE 350
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None. EXAMPLES The following example shows how to remove a task based on the task ID. cli% removetask 2 Remove the following tasks? 2 select q=quit y=yes n=no: y The following example shows how to remove all tasks, including details.
PAGE 351
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removetemplate DESCRIPTION The removetemplate command removes one or more Virtual Volume (VV), Logical Disk (LD), and Common Provisioning Group (CPG) templates. SYNTAX removetemplate [options]{|}... AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced.
PAGE 352
Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the forced removal of template vv1: cli% removetemplate -f vv1 NOTES None. 19.34 InForm OS Version 2.3.
PAGE 353
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removeuser DESCRIPTION The removeuser command removes a user account from the system. SYNTAX removeuser [option] ... AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS ...
PAGE 354
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ Verify the removal of users by issuing the showuser command. See showuser on page 22.188 for additional information. ■ The removeuser command does not affect currently connected users. If an attempt is made to remove a user that is currently connected, an error message will be returned. 19.
PAGE 355
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removeuserconn DESCRIPTION The removeuserconn command removes user connections to the current system. AUTHORITY Super NOTE: You need access to all domains in order to run this command.
PAGE 356
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the forced removal of user user1 at IP address 127.0.0.1: cli% removeuserconn –f 2315 user1 127.0.0.1 Removing user connection Id:2315 Name:user1 Addr:127.0.0.
PAGE 357
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removevlun DESCRIPTION The removevlun command removes a Virtual Volume’s (VVs) SCSI Logical Unit Number (LUN) export definition from the system.
PAGE 358
Command Line Interface Reference InForm OS Version 2.3.1 –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. 19.
PAGE 359
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the volume or volume set name, using up to 31 characters in length. The volume set name must start with set:. Specifies the LUN ID to remove. Specifies that exports to the specified port are removed. If this specifier is not used, the host_name specifier must be used. node Specifies the system port where node is a number from 0 through 7.
PAGE 360
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ If the VLUN to be removed is a matched-set, use the port and host_name specifiers. ■ Verify the removal of VLUNs by issuing the showvlun command. See showvlun on page 22.195 for more information. 19.
PAGE 361
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND removevv DESCRIPTION The removevv command removes Virtual Volumes (VVs) from the system. SYNTAX The syntax of the removevv command can be as follows: ■ removevv [options] |... ■ removevv -expired [options] [VV_name>|...] AUTHORITY Super, Edit OPTIONS –pat Specifies that specified patterns are treated as glob-style patterns and that all VVs matching the specified pattern are removed.
PAGE 362
Command Line Interface Reference InForm OS Version 2.3.1 –cascade Remove all the descendent volumes as long as none has an active VLUN. It will remove any VLUN templates as long as there were no active VLUNs. It will remove the volumes from all the volume sets. If the -expired option is specified, all expired volumes and their descendent volumes will be removed regardless if they are expired or not.
PAGE 363
InForm OS Version 2.3.1 Command Line Interface Reference The following example removes the volumes that start with test and are snapshot: cli% removevv -f -snaponly -pat test* The following example removes vv1_snap if it is a snapshot and all its descendents: cli% removevv –f snaponly -cascade vv1_snap NOTES ■ By default, this command deletes any unused LDs that are not also part of a CPG. This is equivalent to using the –ld option. The –ld option still exists for backward compatibility.
PAGE 364
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND removevvset DESCRIPTION The removevvset command removes a VV set or removes VVs from an existing set. SYNTAX removevvset [options] [...] AUTHORITY Super, Edit OPTIONS -f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation. SPECIFIERS Specifies the name of the VV set to remove. ...
PAGE 365
InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 19.
PAGE 366
Command Line Interface Reference 19.48 InForm OS Version 2.3.
PAGE 367
InForm OS Version 2.3.1 Command Line Interface Reference 20 Service Commands In this chapter servicecage 20.2 servicehost 20.5 servicemag 20.8 Service Commands 20.
PAGE 368
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND servicecage DESCRIPTION The servicecage command is necessary when executing removal and replacement actions for a drive cage FC-AL module. The startfc or unstartfc subcommands are used to initiate service on a cage, and the endfc subcommand is used to indicate that service is completed.
PAGE 369
InForm OS Version 2.3.1 Command Line Interface Reference resetfc ◆ For DC1 and DC3 drive cages, soft resets the FC-AL module. ◆ For DC2 and DC4 drive cages, resets the cage. FC-AL specifier is ignored. hresetfc ◆ For DC1 and DC3 drive cages, hard reset the FC-AL module. ◆ For DC2 and DC4 drive cages, hard reset the cage. FC-AL specifier is ignored. remove Removes the indicated drive cage (indicated with the specifier) from the system.
PAGE 370
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the commencement of Fibre Channel hot-plugging for drive cage cage0: cli% servicecage startfc –f -ovrd cage0 NOTES ■ Issuing the servicecage command results in chunklet relocation, causing a dip in throughput. ■ The unstartfc subcommand is provided if a mistake was made when issuing the servicecage command.
PAGE 371
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND servicehost DESCRIPTION The servicehost command executes removal and replacement actions for a host connecting to an InServ Storage Server port. SYNTAX The syntax for the servicehost command can be one of the following: ■ servicehost list ■ servicehost remove [-f] [ [...
PAGE 372
Command Line Interface Reference InForm OS Version 2.3.1 copy Copies all active VLUNs from the specified source port (as specified with ) from host WWNs or iSCSI names matching the specified pattern () to the destination port (as specified with ). If necessary, the port is reset to target mode. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 373
InForm OS Version 2.3.1 ■ Command Line Interface Reference If the specifier is not used with the remove subcommand, all inactive hosts in the system and their LUNs are removed.
PAGE 374
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND servicemag DESCRIPTION The servicemag command executes service on a drive magazine or disk. SYNTAX The syntax for the servicemag command can be one of the following: ■ servicemag start [options] ■ servicemag start [options] -pdid ...
PAGE 375
InForm OS Version 2.3.1 Command Line Interface Reference Relocation of chunklets is considered one step and can take from several minutes to several hours (depending on number of chunklets) to complete. If servicemag unmark is issued during the relocation phase, the spin-down phase will indicate that the servicemag start operation Failed. This can be confirmed by issuing servicemag status -d.
PAGE 376
Command Line Interface Reference InForm OS Version 2.3.1 –partial This option can only be used with the resume subcommand. Specifies that as many chunklets as possible are relocated. Error messages are printed for those chunklets that could not be relocated. -pdid ... Specifies one to four physical disks (by physical disk ID) that need to be serviced or replaced.
PAGE 377
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ Access to all domains is required to run this command. ■ Users with Browse level authority can only issue the servicemag status command. EXAMPLES The following example displays the suspension and resumption of data services on drive magazine 0 in drive cage 2: 20.
PAGE 378
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 ...
PAGE 379
InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ Issuing the servicemag command results in chunklet relocation that causes a dip in throughput. ■ When a servicemag command is issued with the –log option, all chunklets on the disks in the drive magazine being serviced are marked as normal,smag. This state indicates an active servicemag operation on the disks. ◆ Any I/O on the chunklets marked normal,smag, changes the states to logging and I/O is written to the logging logical disks.
PAGE 380
Command Line Interface Reference 20.14 InForm OS Version 2.3.
PAGE 381
InForm OS Version 2.3.1 Command Line Interface Reference 21 Set Commands In this chapter setalert 21.3 setauthparam 21.5 setbattery 21.12 setcage 21.14 setcim 21.16 setclienv 21.18 setcpg 21.20 setdate 21.27 setdomain 21.31 setdomainset 21.33 sethost 21.35 sethostset 21.39 setlicense 21.40 setnet 21.42 setnode 21.47 Set Commands 21.
PAGE 382
Command Line Interface Reference 21.2 InForm OS Version 2.3.1 setntp 21.49 setpassword 21.51 setpd 21.53 setrcopygroup 21.55 setrcopytarget 21.62 setsched 21.66 setsnmppw 21.68 setsshkey 21.70 setstatch 21.72 setstatpdch 21.74 setsys 21.75 setsysmgr 21.79 settemplate 21.82 setuser 21.84 setuseracl 21.86 setvv 21.88 setvvset 21.
PAGE 383
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setalert DESCRIPTION The setalert command sets the status of system alerts. SYNTAX setalert new|ack|fixed {...|–a} AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –a Specifies that the status of all alerts be set to new, acknowledged (ack), or fixed. If not specified, the specifier must be specified on the command line. SPECIFIERS ...
PAGE 384
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example sets the status of all system alerts as new: cli% setalert –a new NOTES Verify the status of alerts by issuing the showalert command. See showalert on page 22.4 for additional information. 21.
PAGE 385
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setauthparam DESCRIPTION The setauthparam command is used to set the authentication and authorization parameters. SYNTAX The syntax of the setauthparam command can be one of the following: setauthparam [-f] setauthparam [-f] ... setauthparam [-f] -clear ... setauthparam [-f] -clearall AUTHORITY Super OPTIONS -f Does not ask for a confirmation before performing the operation.
PAGE 386
Command Line Interface Reference InForm OS Version 2.3.1 Table 21-1. Values for Specifiers and ldap-server Numeric IP address of the LDAP server. ldap-server-hn Indicates the host name of the LDAP server. This value must be set when the ldap-reqcert option is set or the sasl-mechanism option is set to GSSAPI.
PAGE 387
InForm OS Version 2.3.1 Command Line Interface Reference Table 21-1. Values for Specifiers and (continued) user-dn-base When using simple binding, the authentication process attempts to bind the user to an entry in the server's Directory Information Tree (DIT). The Distinguished Name (DN) of the entry is a concatenation of the value of user-attr, "=", the username, ",", and the value of user-dn-base.
PAGE 388
Command Line Interface Reference InForm OS Version 2.3.1 Table 21-1. Values for Specifiers and (continued) member-attr The attribute that holds the names of users in the group. accounts-dn Indicates the base of the subtree in the DIT in which to search for objects that hold account information. It is mutually exclusively with groups-dn variable. account-obj The objectClass attribute of an account object.
PAGE 389
InForm OS Version 2.3.1 Command Line Interface Reference Table 21-1. Values for Specifiers and (continued) domain-name-attr When set, the mapping of groups to domains is enabled. For a user that is a member of a group that maps to a privilege level, the value of domain-name-attr is used to look up an attribute in the group that holds the name of the domain.
PAGE 390
Command Line Interface Reference InForm OS Version 2.3.1 : Table 21-2. Examples of Domain Name Prefix Effects candidate domain-name-prefix result dom1 ISDom= dom1 ISDom=dom2 ISDom= dom2 ISDom=dom3 !ISDom= dom3 dom4 !ISDom= In the last case there is no resulting domain name because ISDom= does not appear in the candidate. Table 21-3.
PAGE 391
InForm OS Version 2.3.1 ■ Command Line Interface Reference The matching of a user's groups with the mapping rules is done in the order of the mapping parameters provided previously. When there are multiple matches, the first match determines the user's privilege level. ■ Domain names found with the use of domain-name-attr and domain-name-prefix are only potential domains and a user will only have privileges in those if they are actually existing domains.
PAGE 392
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setbattery DESCRIPTION The setbattery command sets battery information such as the battery’s expiration date, its recharging time, and its serial number. This information gives the system administrator a record or log of the battery age and battery charge status. SYNTAX setbattery [options ] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command.
PAGE 393
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the power supply number on the node using either 0 (left side from the rear of the node) or 1 (right side from the rear of the node). Specifies the battery number on the power supply where 0 is the first battery. NOTE: The and specifiers can be obtained from the output of the showbattery command. RESTRICTIONS Access to all domains is required to run this command.
PAGE 394
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcage DESCRIPTION The setcage command enables service personnel to set or modify parameters for a drive cage. SYNTAX setcage [subcommand ]... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command.
PAGE 395
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example demonstrates how to assign cage1 a position description of Side Left: cli% setcage position Cabinet 0 Bay 5 Side Left cage1 The following example demonstrates how to assign model names to the power supplies in cage1. In this example, cage1 has two power supplies (0 and 1). Both power supplies are assigned model name Magnetek.
PAGE 396
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcim DESCRIPTION The setcim command sets the properties of the CIM server, including options to enable or disable the HTTP and HTTPS ports for the CIM server. The command also provides the ability to configure the port numbers associated with these two protocols. In addition, it allows users to enable or disable the SLP port.
PAGE 397
InForm OS Version 2.3.1 Command Line Interface Reference -httpsport Sets the HTTPS port (49152 - 65535). The default value is 5989. SPECIFIERS None. RESTRICTIONS ■ Access to all domains is required to run this command. ■ You cannot disable both of the HTTP and HTTPS ports. ■ You cannot set the same port number for both of the HTTP and HTTPS ports. EXAMPLES To disable the HTTPS ports: cli% setcim -https disable Warning: The CIM server is active and will restart.
PAGE 398
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setclienv DESCRIPTION The setclienv command sets the CLI environment parameters. SYNTAX setclienv AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS The specifiers include the parameters and values to which the parameters should be set.
PAGE 399
InForm OS Version 2.3.1 hafter Command Line Interface Reference - Specifies the number of lines of data to display before an output header is displayed. If is 10 or more, print the header after every of data. If is less than 10, print only the header at the beginning. editor NOTE: This parameter is only supported when connected via SSH. Specifies the command line editing mode.
PAGE 400
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setcpg DESCRIPTION The setcpg command modifies existing Common Provisioning Groups (CPG). SYNTAX setcpg [options ] AUTHORITY Super, Edit, Service NOTE: You need access to all domains in order to run this command. OPTIONS –sa ... Specifies additional Logical Disks (LDs) that have already been created to be used for snapshot administration space allocation.
PAGE 401
InForm OS Version 2.3.1 Command Line Interface Reference –sdgs [g|G|t|T] Specifies the growth increment, the amount of logical disk storage created, on each autogrow operation. The default growth increment is fixed at 32G, but the minimum growth increment varies according to the number of controller nodes in the system. If is non-zero it must be 8G or bigger. A size of 0 disables the auto-grow feature.
PAGE 402
Command Line Interface Reference InForm OS Version 2.3.1 NOTE: The following options, –t, –ssz, –rs, –ss, –ha, –ch, and –p are used to control auto logical disk creation. –t Specifies the RAID type of the logical disk: r0 for RAID-0, r1 for RAID-1, r5 for RAID-5, or r6 for RAID-6. If no RAID type is specified, the default is r1. –ssz Specifies the set size in terms of chunklets.
PAGE 403
InForm OS Version 2.3.1 Command Line Interface Reference –p Specifies a pattern for disks. Patterns are used to select disks that are used for creating logical disks. If no pattern is specified, the option defaults to all disks of device type specified at creation time. If specified multiple times, each instance of the specified pattern adds additional candidate disks that match the pattern.
PAGE 404
Command Line Interface Reference InForm OS Version 2.3.1 –mg Specifies one or more drive magazines. The 1. or 0. displayed in the CagePos column of showpd output indicating the side of the cage is omitted when using -mg option. Drive magazines are identified by one or more integers (item). Multiple drive magazines are separated with a single comma (1,2,3). A range of drive magazines is separated with a hyphen (0–3). The specified drive magazine(s) must contain disks.
PAGE 405
InForm OS Version 2.3.1 Command Line Interface Reference –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command. –devtype Specifies that physical disks must have the specified device type (FC for Fibre Channel, NL for Nearline, or SSD for Solid State Drive) to be used. Device types can be displayed by issuing the showpd command.
PAGE 406
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS Specifies the name of the CPG being modified. RESTRICTIONS ■ Access to all domains is required to run this command. ■ This command sets the parameters that will be used for future grows and it will OVERWRITE all previously set parameters.
PAGE 407
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdate DESCRIPTION The setdate command allows you to set the system time and date on all nodes. SYNTAX The syntax for the setdate command can be one of the following: ■ setdate [[]][<.ss>] ■ setdate –tzlist [group] ■ setdate –tz AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –tzlist [group] Displays a timezone within a group, if a group is specified.
PAGE 408
Command Line Interface Reference InForm OS Version 2.3.1 Specifies the century (CC) and cannot be used unless a year is specified (YY). This specifier is not required. Specifies a year (YY). This specifier is not required. <.ss> Specifies seconds (ss). This specifier is not required. Specifiers can only be used in combinations as listed in Restrictions in the section that follows. RESTRICTIONS ■ Access to all domains is required to run this command.
PAGE 409
InForm OS Version 2.3.1 Command Line Interface Reference The following example displays the timezones with the –tzlist option: cli% setdate –tzlist Africa America Antarctica Arctic Asia ... The following example narrows down the list to the required timezone of Etc: cli% setdate –tzlist Etc Etc/GMT Etc/GMT+0 Etc/GMT+1 ... The following example shows the timezone being set: cli% setdate –tz Etc/GMT Timezone set successfully.
PAGE 410
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ Specifies must be provided in one of the combinations listed as follows when issuing the setdate command: ■ ◆ MMDDhhmm ◆ MMDDhhmmYY ◆ MMDDhhmmCCYY ◆ MMDDhhmm.ss ◆ MMDDhhmmYY.ss ◆ MMDDhhmmCCYY.ss Check node dates by issuing the showdate command. See showdate on page 22.33 for additional information. 21.
PAGE 411
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdomain DESCRIPTION The setdomain command sets the parameters and modifies the properties of a domain. SYNTAX setdomain [options ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS -name Changes the name of the domain. -comment Specifies comments or additional information for the domain.
PAGE 412
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS Indicates the name of the domain. RESTRICTIONS You need access to all domains to run this command. EXAMPLE In the following example, the name of a domain named Domain1 is changed to DomainX: cli% setdomain -name DomainX Domain1 The following example displays the addition of a comment to the domain Engineering: cli% setdomain -comment “This is a comment for engineering.
PAGE 413
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setdomainset DESCRIPTION The setdomainset command sets the parameters and modifies the properties of a domain set. SYNTAX setdomainset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. Unprintable characters are not allowed. -name Specifies a new name for the domain set.
PAGE 414
Command Line Interface Reference NOTES None. 21.34 InForm OS Version 2.3.
PAGE 415
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND sethost DESCRIPTION The sethost command sets properties on existing system hosts, including options to annotate a host with descriptor information such as physical location, IP address, operating system, model, and so on. The command also provides the ability to configure or remove iSCSI CHAP authentication information.
PAGE 416
Command Line Interface Reference InForm OS Version 2.3.1 removechap Removes CHAP authentication information on one or more hosts. By default, this removes all CHAP information for all specified hosts. Using this subcommand with the –target option removes only target CHAP information. clearagent Clears any host agent data associated with the host. OPTIONS -loc Specifies the location of the host. -ip Specifies the IP address of the host.
PAGE 417
InForm OS Version 2.3.1 Command Line Interface Reference -chapname Used to specify the initiator or target CHAP name. If this option is not specified, then the initiator CHAP name defaults to the host name and the target CHAP name defaults to the 3PAR System name. -hex The CHAP secret is treated as a hex number. The following options are for use with the removechap subcommand: -target Removes only the target CHAP authentication.
PAGE 418
Command Line Interface Reference InForm OS Version 2.3.
PAGE 419
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND sethostset DESCRIPTION The sethostset command sets the parameters and modifies the properties of a host set. SYNTAX sethostset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies a comment relating to the set. -name Specifies a new name for the host set. SPECIFIERS Specifies the name of the host set to modify. RESTRICTIONS None.
PAGE 420
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setlicense DESCRIPTION The setlicense command sets the license key information. SYNTAX setlicense [options ] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies the file from which the license key is read. –noconfirm Specifies that the system does not prompt for confirmation for the new license key. SPECIFIERS None.
PAGE 421
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the setting of a license key: cli% setlicense If this software is being provided to you for a limited evaluation period, then your license shall be governed by the terms of 3PAR's standard Master Purchase and License Agreement which can be found at http://www.3par.
PAGE 422
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setnet DESCRIPTION The setnet command sets the administration network interface configuration. AUTHORITY Service, Super NOTE: You need access to all domains in order to run this command.
PAGE 423
InForm OS Version 2.3.1 Command Line Interface Reference startgateway Specifies that the gateway be immediately set to the specified IP address if no gateway is currently defined, or switched to the specified IP address if currently defined, in both cases indicated with the ( specifier). finish Specifies that outstanding changes from the startaddr and startgateway subcommands be completed. abort Specifies that any attempt to configure a new IP address or gateway fails.
PAGE 424
Command Line Interface Reference InForm OS Version 2.3.1 OPTIONS –f Specifies that the operation is forced even if verification has not occurred. This option can only be used with the finish and cleargateway subcommands. SPECIFIERS Specifies an existing IP address that is to be changed. This specifier is used in conjunction with the and specifiers and can only be used with the startaddr subcommand. Specifies a new IP address to which the system is configured.
PAGE 425
InForm OS Version 2.3.1 Command Line Interface Reference Specifies the IP address of the node. This specifier can only be used with the failoverping subcommand. |none Specifies that during an IP failover, a ping either be sent to the specified IP address () or not sent at all (none). This specifier can only be used with the failoverping subcommand. [] Specifies the node, by ID, that has an active Ethernet interface.
PAGE 426
Command Line Interface Reference ■ InForm OS Version 2.3.1 To make it possible to change the network configuration without running the risk of losing contact with the system because of misconfiguration, the setnet command uses a two step process. When a new IP address is specified with the setnet startaddr command, the system is configured to listen as both the old and new IP addresses.
PAGE 427
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setnode DESCRIPTION The setnode command sets the properties of the node components such as the serial number of the power supply. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SYNTAX setnode ps [options] SUBCOMMAND ps Sets the power supply properties. OPTIONS -s Specifies the serial number up to eight characters in length.
PAGE 428
Command Line Interface Reference InForm OS Version 2.3.
PAGE 429
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setntp DESCRIPTION The setntp command sets the system Network Time Protocol (NTP) server. This command is deprecated and will be removed in a subsequent release. AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SYNTAX setntp |none OPTIONS None. SPECIFIERS Specifies the IP address of the NTP server to which the InServ system synchronizes its internal clocks.
PAGE 430
Command Line Interface Reference NOTES None. 21.50 InForm OS Version 2.3.
PAGE 431
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setpassword DESCRIPTION The setpassword command allows a user with Super level privileges to change the password for any user and create a password file on a client. Edit-, browse-, or service-level users can use the setpassword command to change their own passwords or save their password files on a client.
PAGE 432
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS None. RESTRICTIONS ■ Only a user with Super level privileges can set another user’s password. ■ Passwords can be no longer than eight non-null characters, and must be at least six nonnull characters long.
PAGE 433
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setpd DESCRIPTION The setpd command marks a Physical Disk (PD) as allocatable or non allocatable for Logical Disks (LDs). SYNTAX setpd ldalloc on|off ... AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS ldalloc on|off Specifies that the PD, as indicated with the PD_ID specifier, is either allocatable (on) or nonallocatable for LDs (off). OPTIONS None. SPECIFIERS ...
PAGE 434
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ This command can be used when the system has disks that are not to be used until a later time. ■ 21.54 Verify the status of PDs by issuing the showpd -s command. See showpd on page 22.91.
PAGE 435
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setrcopygroup DESCRIPTION The setrcopygroup command performs the following actions: ■ Sets the policy of the Remote Copy volume group for dealing with I/O failure and error handling. ■ Switches the direction of transfer between volume groups. ■ Sets a resynchronization period for volume groups in asynchronous periodic mode. ■ Sets the group’s mode.
PAGE 436
Command Line Interface Reference InForm OS Version 2.3.1 Specifies the operation of the group(s). Valid operations are: reverse Changes the natural and current direction of all specified groups. The operation is mirrored resulting in a direction change on both systems. This option is very flexible depending on the options that are provided, however it should not be used as a part of the normal disaster recovery process.
PAGE 437
InForm OS Version 2.3.1 Command Line Interface Reference –nosync Specifies that groups are not synchronized after role reversal is completed through the recover, restore and failover specifiers. -discard Specifies not to check a group's other targets to see if newer data should be pushed from them if the group has multiple targets. The use of this option can result in the loss of the most recent changes to the group's volumes and thus should be used carefully.
PAGE 438
Command Line Interface Reference InForm OS Version 2.3.1 Wait for all tasks created by this command to complete before returning. This option applies to the failover, recover, restore, and reverse subcommands. SPECIFIERS Specifies the policy to assign to the group. This specifier can only be used with the pol subcommand.
PAGE 439
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: When issuing the setrcopygroup command, either the specifier or the specifier must be specified. 21.
PAGE 440
Command Line Interface Reference InForm OS Version 2.3.1 Specifies the name of the volume group whose policy is set, or whose target direction is switched. Specifies the target name for the target definition created with the creatercopytarget command. Specifies the mode, sync or periodic, to which the group is set. This specifier can only be used with the mode subcommand.
PAGE 441
InForm OS Version 2.3.1 Command Line Interface Reference The following example sets volume group Group1 to synchronize to its asynchronous periodic mode target InServ2 every 30 minutes: cli% setrcopygroup period 30m InServ2 Group1 NOTES ■ There is no default resynchronization period. For groups whose mode is asynchronous periodic, you must specify a resynchronization period using setrcopygroup period or resynchronizations does not automatically take place.
PAGE 442
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setrcopytarget DESCRIPTION The setrcopytarget command sets the name, policies, and throughput of a target definition.
PAGE 443
InForm OS Version 2.3.1 Command Line Interface Reference enable|disable Enables or disables the target. OPTIONS None. SPECIFIERS Specifies the target name for the target definition previously created with the creatercopytarget command. This specifier can only be used with the pol subcommand.
PAGE 444
Command Line Interface Reference InForm OS Version 2.3.1 The measured round-trip latency of the connection to the target, specified in milliseconds (ms). This specifier can only be used with the tunelinks subcommand. RESTRICTIONS ■ Access to all domains is required to run this command. ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
PAGE 445
InForm OS Version 2.3.1 ■ Command Line Interface Reference Under normal operating conditions the mirror_config policy should never be changed to no_mirror_config. This policy option is included only as a method to correct several unusual error conditions that might occur in the course of operation which result in a mismatch in configuration between the two sides of a Remote Copy pair.
PAGE 446
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsched DESCRIPTION The setsched command allows users to suspend, pause, change the schedule, change the parameters, and change the name of currently scheduled tasks. SYNTAX setsched [options ] setsched [-suspend | -resume] setsched [-suspend_all | -resume_all] AUTHORITY Super, Service OPTIONS -suspend Suspends execution of a specified task.
PAGE 447
InForm OS Version 2.3.1 Command Line Interface Reference -name Sets a new name for a given task. The name can be up to 31 characters in length. -no_alert Failures of tasks will no longer generate an alert. -alert Failures of tasks will generate an alert. This is set by default. SPECIFIERS Specifies the name of the scheduled task to modify. RESTRICTIONS None. EXAMPLES None. NOTES None. 21.
PAGE 448
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsnmppw DESCRIPTION The setsnmppw command allows a user to update SNMP access community strings passwords. The SNMP password is required for the system manager to send requests to the SNMP agent. SYNTAX setsnmppw [options] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) community password is changed.
PAGE 449
InForm OS Version 2.3.1 Command Line Interface Reference The following example changes the read-only SNMP password to newpassword2 by specifying the –r option on the command line: cli% setsnmppw –r newpassword2 The following example changes the write-only SNMP password to newpassword3 by specifying the –w option on the command line: cli% setsnmppw –w newpassword3 NOTES ■ The default initial read/write password is public. ■ If the read-only or write-only passwords do not exist, they are created.
PAGE 450
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setsshkey DESCRIPTION The setsshkey command sets the SSH public key for a user. The user will be prompted to provide the SSH public key. To finish entering the public key, press enter on a blank line. The key must have been generated using the ssh-keygen utility. The public key is contained in the user-defined file named with .pub extension. The user can open this file with an ASCII editor to copy the key and paste it.
PAGE 451
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the setting of a user’s SSH public key: cli% setsshkey Please enter the SSH public key below. When finished, press enter twice. The key is usually long. It's better to copy it from inside an editor and paste it here. (Please make sure there are no extra blanks.) The maximum length of the key is 4096 bits.
PAGE 452
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setstatch DESCRIPTION The setstatch command starts and stops the statistics collection mode for chunklets. SYNTAX setstatch start|stop AUTHORITY Super, Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for the specified Logical Disk (LD) and chunklet. OPTIONS None. SPECIFIERS Specifies the name of the LD in which the chunklet to be configured resides.
PAGE 453
InForm OS Version 2.3.1 Command Line Interface Reference NOTES After the statistic collection mode for the chunklet is set, you can then use either the histch command (page 15.2) or the statch command (page 25.2) to view the chunklet’s statistics. 21.
PAGE 454
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setstatpdch DESCRIPTION The setstatpdch command sets the statistics collection mode for all in-use chunklets on a Physical Disk (PD). SYNTAX setstatpdch start|stop AUTHORITY Super, Edit SUBCOMMANDS start|stop Specifies that the collection of statistics is either started or stopped for chunklets on the specified PD used by Logical Disks (LDs). OPTIONS None. SPECIFIERS Specifies the PD ID. RESTRICTIONS None.
PAGE 455
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setsys DESCRIPTION The setsys command sets the properties of the system, and includes options to annotate a system with descriptor information such as physical location, owner, contact information, and so on. The command also enables you to set system-wide parameters such as the raw space alert. SYNTAX setsys [options] setsys AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command.
PAGE 456
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS The following parameters can be configured on the system and are issued for the specifier: RawSpaceAlertFC Sets the user configurable space alert threshold (100 to 100000 GB) for Fibre Channel type drives. When the total space on the available chunklets (both clean and unclean) for the specified drive type falls below the specified value, the alert is posted. A value of 0 will disable the alert.
PAGE 457
InForm OS Version 2.3.1 Command Line Interface Reference RemoteSyslogHost Sets the IP address of the system to which events will be sent as syslog messages. The value must be a valid IP address. SparingAlgorithm Sets the sparing algorithm used by the admithw command. Valid values are Default, Minimal, Maximal, and Custom. MgmtOldPorts Enables or disables listening on the old management ports 2540 and 2550 (for SSL). The server now listens on ports 5782 and 5783 (for SSL).
PAGE 458
Command Line Interface Reference InForm OS Version 2.3.1 VVRetentionTimeMax [h|H|d|D] Specifies the maximum value that can be set for the retention time of a volume. is a positive integer value and in the range of 0 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value. The default value for is 14 days.
PAGE 459
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND setsysmgr DESCRIPTION The setsysmgr command sets the system manager startup state. CAUTION: Issuing the setsysmgr command can potentially remove the entire state of the system causing data loss.
PAGE 460
Command Line Interface Reference InForm OS Version 2.3.1 CAUTION: Issuing the setsysmgr force_idewipe command can result in data loss. force_idewipe Specifies that the system wipes the IDE powerfail partition. The system is shutdown and restarted, during which time all logical disks and VVs are checked. OPTIONS –f Specifies that the command is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
PAGE 461
InForm OS Version 2.3.1 Command Line Interface Reference The following example starts the system with the table of contents generation number of 42956, where 91 is the highest disk quorum displayed: cli% setsysmgr tocgen 42956 91 The following example displays the start of a system’s recovery process from its IDE disk: cli% setsysmgr force_iderecovery NOTES ■ If the wipe subcommand is specified, all system data and configuration information, including customer data and VV layout, are destroyed.
PAGE 462
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND settemplate DESCRIPTION The settemplate command modifies the properties of existing templates. SYNTAX settemplate ... [option ] AUTHORITY Super NOTE: You need access to all domains in order to run this command. OPTION -remove
PAGE 463
InForm OS Version 2.3.
PAGE 464
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setuser DESCRIPTION The setuser command sets your user properties. SYNTAX setuser [options ] AUTHORITY Super, Edit, Browse OPTIONS –f Specifies that the command is forced. No confirmation is requested before executing the command. -adddomain :[,:...] Adds a specified user () to the specified domain () at the specified privilege level ().
PAGE 465
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS The -adddomain and -rmdomain options cannot be used on a user that is currently logged in. Existing sessions can be terminated with the removeuserconn command. EXAMPLES In the following example, user 3paruser is permitted edit level privileges in the domain Engineering: cli% setuser -adddomain Engineering:edit 3paruser NOTES None. 21.
PAGE 466
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setuseracl DESCRIPTION The setuseracl command sets the Access Control List (ACL). SYNTAX setuseracl [options] []... AUTHORITY Super, Edit OPTIONS -add Adds names or patterns of objects at the end of an existing ACL. -remove Removes names or patterns of objects from an ACL. SPECIFIERS Specifies the name of the user whose ACL is being set.
PAGE 467
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example sets the ACL for user testuser1 and allows testuser1 to update the snapshot VVs of VVs vv1 and vv2.
PAGE 468
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setvv DESCRIPTION The setvv command changes the properties associated with Virtual Volumes (VVs). It can be used to modify volume names, volume policies, allocation warning, and limit levels, and the volume’s controlling Common Provisioning Group (CPG). SYNTAX setvv [options ] ...
PAGE 469
InForm OS Version 2.3.1 Command Line Interface Reference -retain [d|D|h|H] Specifies the amount of time, relative to the current time, that the volume will be retained. is a positive integer value and in the range of 1 - 43,800 hours (1,825 days). Time can be optionally specified in days or hours providing either d or D for day and h or H for hours following the entered time value.
PAGE 470
Command Line Interface Reference InForm OS Version 2.3.1 tp_bzero Specifies that if a host write results in the allocation of a new data page that is only partially filled by the host write, then a zero-fill is performed on the unwritten portion of the data page to ensure that the host cannot read data from deleted volumes or snapshot. The default allocation page size is 16 KB. This is the default setting.
PAGE 471
InForm OS Version 2.3.1 Command Line Interface Reference The following options can only be used on Thinly Provisioned Virtual Volumes (TPVVs): -usr_aw This option returns a user space allocation warning. It generates a warning alert when the user space of the TPVV exceeds the specified percentage of the VV size. -usr_al This option returns the user space allocation limit. The user space of the TPVV is prevented from growing beyond the indicated percentage of the virtual volume size.
PAGE 472
Command Line Interface Reference InForm OS Version 2.3.1 –spt Defines the VV geometry sectors per track value that is reported to the hosts through the SCSI mode pages. The valid range is from 4 to 8192 and the default value is 304. –hpc Defines the VV geometry heads per cylinder value that is reported to the hosts through the SCSI mode pages. The valid range is from 1 to 1024 and the default value is 8. SPECIFIERS ...
PAGE 473
InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ To view policies assigned to the system’s VVs, issue the showvv –p command. See showvv on page 22.201 for more information. ■ It is not possible to rename a VV that is already associated with a Remote Copy group. ■ Changing the CPG for a TPVV is not allowed. 21.
PAGE 474
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND setvvset DESCRIPTION The setvvset command sets the parameters and modifies the properties of a Virtual Volume (VV) set. SYNTAX setvvset [options ] AUTHORITY Super, Edit OPTIONS -comment Specifies any comment or additional information for the set. The comment can be up to 255 characters in length. Unprintable characters are not allowed. -name Specifies a new name for the VV set.
PAGE 475
InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 21.
PAGE 476
Command Line Interface Reference 21.96 InForm OS Version 2.3.
PAGE 477
InForm OS Version 2.3.1 Command Line Interface Reference 22 Show Commands In this chapter showalert 22.4 showauthparam 22.6 showbattery 22.8 showblock 22.14 showcage 22.17 showcim 22.23 showclienv 22.25 showcpg 22.26 showdate 22.33 showdomain 22.34 showdomainset 22.36 showeeprom 22.38 showeventlog 22.41 showfirmwaredb 22.45 showhost 22.47 Show Commands 22.
PAGE 478
Command Line Interface Reference 22.2 InForm OS Version 2.3.1 showhostset 22.52 showinventory 22.54 showiscsisession 22.56 showld 22.58 showldch 22.66 showldmap 22.71 showlicense 22.73 shownet 22.75 shownode 22.77 shownodeenv 22.87 showpatch 22.89 showpd 22.91 showpdata 22.108 showpdch 22.109 showpdvv 22.116 showport 22.121 showportarp 22.132 showportdev 22.134 showportisns 22.137 showportlesb 22.139 showrcopy 22.145 showrctransport 22.150 showrsv 22.
PAGE 479
InForm OS Version 2.3.1 Command Line Interface Reference showspace 22.161 showspare [-used] 22.166 showsshkey 22.169 showsys 22.171 showsysmgr 22.176 showtarget 22.179 showtask 22.180 showtemplate 22.184 showtoc 22.185 showtocgen 22.187 showuser 22.188 showuseracl 22.190 showuserconn 22.191 showversion 22.193 showvlun 22.195 showvv 22.201 showvvmap 22.217 showvvpd 22.219 showvvset 22.224 22.
PAGE 480
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showalert DESCRIPTION The showalert command displays the status of system alerts. When issued without options, all alerts are displayed. SYNTAX showalert [options] AUTHORITY Super, Service, Edit, Browse OPTIONS The selection of alerts to be displayed is controlled by selecting one of the following options: –n Specifies that only new alerts are displayed. –a Specifies that only acknowledged alerts are displayed.
PAGE 481
InForm OS Version 2.3.1 Command Line Interface Reference -wide Do not truncate the message text. Only valid if the -oneline option is also specified. SPECIFIERS None. RESTRICTIONS Without any options, the showalert command displays all alerts in the New state.
PAGE 482
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showauthparam DESCRIPTION The showauthparam command shows authentication parameters. SYNTAX showauthparam AUTHORITY Super OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 483
InForm OS Version 2.3.1 Command Line Interface Reference NOTES None. 22.
PAGE 484
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showbattery DESCRIPTION The showbattery command displays battery status information including serial number, expiration date, battery life, and so on, which could be helpful when determining battery maintenance schedules. SYNTAX showbattery [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed battery information, including battery test information, serial numbers, and expiration dates, is displayed.
PAGE 485
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays battery status information: cli% showbattery Node PS Bat Serial 0 0 0 FFFFFFFF 0 1 0 FFFFFFFF 1 0 0 -1 1 0 -- --State--- ChrgLvl(%) -ExpDate-- Expired OK 100 05/15/2007 No OK 100 05/15/2007 No NotPresent -- -No NotPresent -- -No Testing No No No No The columns in the previous example are identified as follows: ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID.
PAGE 486
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed battery information: cli% showbattery -d --------------Node 0 PS 0 Battery 0--------------Node ID : 0 Power Supply ID : 0 Battery ID : 0 Manufacturer : MAG Model : 0800-0016-50.0B Serial Number : 70315366 State : OK Charge State : FullyCharged Charge Level(%) : 100 Max Battery Life(mins) : 25 Expired : No Test in Progress : No Expiration Date : 2010-07-17 13:00:00 PD ...
PAGE 487
InForm OS Version 2.3.
PAGE 488
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays the detailed status of the battery using the showbattery –s command: cli% showbattery -s Node PS Bat -State0 0 0 OK 0 1 0 OK 1 0 0 OK 1 1 0 OK -Detailed_StateNormal Normal Normal Normal ■ State ■ Node. The controller node number. ■ PS. The power supply number. ■ Bat. The battery ID. ■ State. The current status of the battery and can be one of the following: ■ ◆ OK. The battery is operating normally.
PAGE 489
InForm OS Version 2.3.1 ■ Command Line Interface Reference For the E-Class and F-Class Storage Servers, the Power Supply 0's primary node is 0 and its secondary node is 1. The Power Supply 1's primary node is 1 and its secondary node is 0. The primary node can read and modify the power supply's properties. The secondary node can only read the power supply's properties.
PAGE 490
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showblock DESCRIPTION The showblock command displays block mapping information for Virtual Volumes (VVs), Logical Disks (LDs), and Physical Disks (PDs). SYNTAX showblock [options ] [] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed information is displayed for the specified device and block.
PAGE 491
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays block mapping information for block 0 in the user space of VV admin: cli% showblock vv admin usr 0 VVname Spc VVBlock admin usr 0x00000000 = = = LDname LDBlock PDid Chnk PDblock admin.usr.
PAGE 492
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed block mapping information from blocks 0x100 through 0x400 in the user space of VV admin: cli% showblock –d vv admin usr 0x100 0x400 VV/LD Name Block Region VV usr: admin 0x00000100 0x00000000–0x0007FFFF (0–256MB) LD : admin.usr.
PAGE 493
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showcage DESCRIPTION The showcage command displays information about drive cages. SYNTAX The syntax of the showcage command can be one of the following: ■ showcage [options] [-d] [...] ■ showcage [-sfp [-d|-ddm]] [...] ■ showcage -i [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that more detailed information about the drive cage is displayed.
PAGE 494
Command Line Interface Reference InForm OS Version 2.3.1 –i Specifies that inventory information about the drive cage is displayed. If this option is not used, then only summary information about the drive cages is displayed. SPECIFIERS ... Specifies a drive cage name for which information is displayed. This specifier can be repeated to display information for multiple cages. If no specifiers are used, the command defaults to displaying information about all cages in the system.
PAGE 495
InForm OS Version 2.3.1 ■ RevA. The cage firmware version for side A of the drive cage. ■ RevB. The cage firmware version for side B of the drive cage. ■ Model. The model can be DC1, DC2, DC3, or DC4. ■ Side. Specifies the right (1) or left (0) side of the drive cage. Command Line Interface Reference 22.
PAGE 496
Command Line Interface Reference InForm OS Version 2.3.1 Specifying the –d option provides more detailed information about the drive cages. See the following E200 Storage Server example for cage0: cli% showcage -d Id Name LoopA Pos.A LoopB Pos.
PAGE 497
InForm OS Version 2.3.1 Command Line Interface Reference Specifying the –d option provides more detailed information about the drive cages. See the following DC4 example from a T-Class Storage Server example for cage0: cli% showcage -d cage0 Id Name LoopA Pos.A LoopB Pos.B Drives Temp RevA RevB Model Side 0 cage0 0:1:1 0 1:1:1 0 40 24-33 2.05 2.
PAGE 498
Command Line Interface Reference InForm OS Version 2.3.1 When the power supply is switched off, it will be reported as Off through the showcage -d command as well as a degraded alert being posted.
PAGE 499
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showcim DESCRIPTION The showcim command displays the CIM server current status, either active or inactive. It also displays the current status of the HTTP and HTTPS ports and their port numbers. In addition, it shows the current status of the SLP port, that is either enabled or disabled. SYNTAX showcim AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 500
Command Line Interface Reference ■ SLP. Indicates the SLP port state. ◆ --. Cannot determine the SLP port state. ◆ Enabled. The SLP port state is enabled. ◆ Disabled. The SLP port state is disabled. ■ SLPPort. The SLP port. Default is 427. ■ HTTP. Indicates the HTTP port state. ◆ --. Cannot determine the HTTP port state. ◆ Enabled. HTTP port is enabled. ◆ Disabled. HTTP port is disabled. ■ HTTPPort. HTTP port (1024 - 65635). The default value is 5988. ■ HTTPS. The HTTPS port state.
PAGE 501
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showclienv DESCRIPTION The showclienv command displays the CLI environment parameters. SYNTAX showclienv AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 502
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showcpg DESCRIPTION The showcpg command displays Common Provisioning Groups (CPGs) in the system. SYNTAX showcpg [options ] [...|...] AUTHORITY Super, Service, Edit, Browse OPTIONS The following options can not be used together with other options except -hist and -domain: -d Show the detail information of CPGs. –r Specifies that raw space used by the CPGs is displayed. –alert Indicates whether alerts are posted.
PAGE 503
InForm OS Version 2.3.1 Command Line Interface Reference -domain Shows only CPGs that are in domains with names matching one or more of the argument. This option does not allow listing objects within a domain of which the user is not a member. Patterns are glob-style (shell-style) patterns (see Help on sub,globpat). SPECIFIERS [...|...
PAGE 504
Command Line Interface Reference ■ ■ ■ ■ InForm OS Version 2.3.1 Usage. Virtual Volumes using the CPG. ◆ Usr. The number of VVs whose User Space is using the CPG. ◆ Snp. The number of VVs whose Snapshot Space is using the CPG. Usr. User space. ◆ Total. The total logical disk space in MBs in the Usr space. ◆ Used. The total logical disk space in MBs used in Usr space. Snp. Snap space. ◆ Total. The total logical disk space in MBs in the Snp space. ◆ Used.
PAGE 505
InForm OS Version 2.3.1 ■ ■ ■ ■ ■ Command Line Interface Reference Usage. Virtual Volumes using the CPG. ◆ Usr. The number of VVs whose User Space is using the CPG. ◆ Snp. The number of VVs whose Snapshot Space is using the CPG. Usr. User space. ◆ Total. The total logical disk space in MBs in the Usr space. ◆ Used. The total logical disk space in MBs used in Usr space. Snp. Snap space. ◆ Total. The total logical disk space in MBs in the Snp space. ◆ Used.
PAGE 506
Command Line Interface Reference InForm OS Version 2.3.1 ■ Limit. The CPG’s snapshot data allocation limit threshold, or growth limit in MBs. ■ Grow. The CPG’s snapshot data space allocation limit threshold. ■ Args. The options used in the creation of the CPG.
PAGE 507
InForm OS Version 2.3.
PAGE 508
Command Line Interface Reference ■ InForm OS Version 2.3.1 Adm. Administration space. ◆ Total. The total logical disk space in MBs in the Adm space. ◆ RTotal. The total raw MBs of (raw) space in the Adm space. ◆ Used. The total logical disk space in MBs used in Adm space. ◆ RUsed. The total MBs of (raw) space used in the Adm space.
PAGE 509
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showdate DESCRIPTION The showdate command displays the date and time for each system node. SYNTAX showdate AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
PAGE 510
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showdomain DESCRIPTION The showdomain command displays a list of domains in a system. SYNTAX showdomain [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that detailed information is displayed. –sortcol [,
][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified.
PAGE 511
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays detailed information about a system’s domains: cli% showdomain -d ID Domain -----CreationTime-----1 TestDomain1 2009-08-22 14:23:30 PDT 2 TestDomain2 2009-08-22 14:23:30 PDT 3 TestDomain3 2009-08-22 14:23:30 PDT --Comments--- -VVRetentionTimeMaxBeef Test 0 Hours Chicken Test 0 Hours Pork Test 0 Hours In the example above: ■ ID. The domain ID. ■ Domain. The domain name. ■ CreationTime.
PAGE 512
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showdomainset DESCRIPTION The showdomainset command lists the host sets defined on the InServ and their members. SYNTAX showdomainset [options] [...] showdomainset -domain [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -domain Show domain sets that contain the supplied domains or patterns SPECIFIERS ...
PAGE 513
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES To show all domain sets defined to the system: cli% showdomainset Id Name Members 7 domainset domainset.1 domainset.2 23 newset testdomain Show details of a specific set: cli% showdomainset -d newset Id Name Members Comment 23 newset testdomain this set has been renamed and now has a comment Show domain sets containing domains matching the pattern domainset.*: cli% showdomainset -domain domainset.* Id Name Members 7 domainset domainset.
PAGE 514
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showeeprom DESCRIPTION The showeeprom command displays node EEPROM log information. SYNTAX showeeprom [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –dead Specifies that an EEPROM log for a node that has not started or successfully joined the cluster be displayed. If this option is used, it must be followed by a list of nodes. SPECIFIERS ...
PAGE 515
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the EEPROM log for all nodes: cli% showeeprom Node: 0 -------Board revision: 0920-1053-03.01 Assembly: FLH 2007/50 Serial 0039 System serial: 1000183 BIOS version: 2.1.3 OS version: 2.2.4.
PAGE 516
Command Line Interface Reference InForm OS Version 2.3.1 In the example above: ■ Board revision indicates the 3PAR part number for the node board, including any minor revision codes. ■ Assembly indicates the code of the assembly, the year or week the node was produced, and the node serial number. ■ System serial is the cluster serial number. ■ BIOS version displays the currently installed BIOS version. ■ OS version displays the currently installed OS version.
PAGE 517
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showeventlog DESCRIPTION The showeventlog command displays the current system event log. SYNTAX showeventlog [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –min Specifies that only events occurring after the specified number of minutes are shown. The is an integer from 1 through 2147483647. –more Specifies that you can page through several events at a time.
PAGE 518
Command Line Interface Reference InForm OS Version 2.3.1 –endt Specifies that only events before a specified time are to be shown. The time argument can be specified as either , , or both. Specified as the hour (hh), as interpreted on a 24 hour clock, where minutes (mm) and seconds (ss) can be optionally specified. Acceptable formats are hh:mm:ss or hhmm.
PAGE 519
InForm OS Version 2.3.1 Command Line Interface Reference –nnode Specifies that only events from nodes that do not match the specified pattern(s) are displayed. –type Specifies that only events with types that match the specified pattern(s) are displayed. –ntype Specifies that only events with types that do not match the specified pattern(s) are displayed. –msg Specifies that only events, whose messages match the specified patttern(s), are displayed.
PAGE 520
Command Line Interface Reference InForm OS Version 2.3.
PAGE 521
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showfirmwaredb DESCRIPTION The showfirmwaredb command displays the current database of firmware levels for possible upgrade. If issued without any options, the firmware for all vendors is displayed. SYNTAX showfirmwaredb [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –n Specifies that the firmware vendor from the SCSI database file is displayed. –l Reloads the SCSI database file into the system.
PAGE 522
Command Line Interface Reference InForm OS Version 2.3.1 SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the current database of firmware levels and prints firmware data: cli% showfirmwaredb Vendor Prod_rev Dev_Id Fw_status Cage_type HITACHI [C1C1] DK..DJ-18FC Current DC4 HITACHI [C1C1] DK..DJ-72FC Current DC4 HITACHI [JLAK] DK..CJ-18FC Current DC4 HITACHI [JLAK] DK..CJ-36FC Current DC4 HITACHI [JLAK] DK..CJ-72FC Current DC4 HITACHI [GLAK] DK..
PAGE 523
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showhost DESCRIPTION The showhost command displays information about defined hosts and host paths in the system. SYNTAX showhost [options ] [...|...|...] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Shows a detailed listing of the host and path information. This option can only be used with -agent and -domain options. -verbose Shows a verbose listing of all host information.
PAGE 524
Command Line Interface Reference InForm OS Version 2.3.1 -listpersona Lists the defined host personas. This option cannot be used with the -d option. Different host personas support different host operating systems and have different capabilities. Host personas may have the following additional capabilities: ◆ UARepLun. Sends a unit attention when the LUN list changes due to adding or removing VLUNs. ◆ RTPG.
PAGE 525
InForm OS Version 2.3.1 Command Line Interface Reference set:... Specifies that information about all the hosts that are members of set should be displayed. The set name must start with set:. Acts as if all members were individually specified as parameters to the comment. May be repeated to specify multiple host sets. RESTRICTIONS None.
PAGE 526
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays host CHAP properties: cli% showhost –chap Id Name -Initiator_CHAP_Name- -Target_CHAP_Name0 queasy10 queasy10 s019 1 foo --- The following example displays all host information: cli% showhost –verbose Id Name Persona -----WWN/iSCSI_Name----- Port IP_addr 0 queasy10 Generic 210000E08B027B60 0:0:1 n/a 1 foo Generic myiscsipath.3pardata.com --0.0.0.
PAGE 527
InForm OS Version 2.3.1 Command Line Interface Reference if the CLI was started with the TPDLISTDOM environment variable set. Please run cli -h and setclienv -h for details of the environment variables command. 22.
PAGE 528
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showhostset DESCRIPTION The showhostset command lists the host sets defined on the InServ and their members. SYNTAX showhostset [options] [...] showhostset -host [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -host Show host sets that contain the supplied hostnames or patterns. SPECIFIERS ...
PAGE 529
InForm OS Version 2.3.
PAGE 530
Command Line Interface Reference COMMAND showinventory DESCRIPTION Shows information about all the hardware components in the system. SYNTAX showinventory AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES None. 22.54 InForm OS Version 2.3.
PAGE 531
InForm OS Version 2.3.1 Command Line Interface Reference NOTES The inventory is divided into sections and inventory for each of these sections can be shown separately with the following command: Section Command Node shownode -i Battery showbattery -i Port showport -i Cage showcage -i Disk showpd -i 22.
PAGE 532
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showiscsisession DESCRIPTION The showiscsisession command shows the iSCSI sessions. SYNTAX showiscsisession [option ] AUTHORITY Super, Service, Edit, Browse OPTIONS –sortcol [,
][:[,]...] Sorts command output based on column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified.
PAGE 533
InForm OS Version 2.3.1 Command Line Interface Reference In the example above: ■ N:S:P. The port location in Node:Slot:Port format, where Slot is the PCI slot number in the node and Port is the port number in the PCI card. ■ IPAddr. The IP address of the Ethernet port. ■ TPGT. The Target Portal Group Tag. ■ TSIH. The Target Session Identifying Handle. ■ Conns. The number of connections for the session. ■ iSCSI_Name. The iSCSI name of the host. ■ StartTime. The time the session was started.
PAGE 534
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showld DESCRIPTION The showld command displays configuration information about the system’s Logical Disks (LDs). SYNTAX showld [options ] [|...] AUTHORITY Super, Service, Edit, Browse OPTIONS –cpg ... Requests that only logical disks in Common Provisioning Groups (CPGs) that match the specified CPG names or patterns be displayed.
PAGE 535
InForm OS Version 2.3.1 Command Line Interface Reference –sortcol [,
][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. You must specify a column number. In addition, you can specify the direction of sorting as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:).
PAGE 536
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information for al LDs in a two node system: cli% showld Id Name 0 log0.0 1 log1.0 2 pdsld0.0 3 admin.usr.0 4 admin.usr.1 5 VV111.usr.0 6 VV111.usr.
PAGE 537
InForm OS Version 2.3.1 ◆ Command Line Interface Reference removing. The logical disk is being deleted. The following State values indicate that an uncontrolled shutdown has occurred and the logical disk was not properly closed before the shutdown. ◆ auto_check. The logical disk is checked for validity. ◆ checking. The logical disk is checked for validity. ◆ need_check. The logical disk has been checked, and an inconsistency has been found. ◆ need_pd.
PAGE 538
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed information about the system LDs: cli% showld -d Id Name CPG RAID Own SizeMB RSizeMB RowSz StepKB SetSz Refcnt Avail CAvail -----CreationTime------ -CreationPattern0 log0.0 --1 0/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 1 log1.0 --1 1/- 20480 40960 1 256 2 0 mag mag 2007-11-29 18:44:02 PST -p -devtype FC 2 pdsld0.
PAGE 539
InForm OS Version 2.3.1 ◆ Command Line Interface Reference mag. A chunklet from another disk within the same drive magazine can be used as a replacement. ◆ cage. A chunklet from another drive cage can be used as a replacement. ◆ port. A chunklet from another port can be used as a replacement. ■ CAvail. Indicates the current, or actual, availability: disk, mag, port, or cage. ■ Creation Time. Indicates when the logical disk was created.
PAGE 540
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays detailed states of each LD: cli% showld -s Id Name 0 log0.0 1 pdsld0.0 2 pdsld0.1 3 pdsld0.2 4 admin.usr.0 5 vvfromcpg2.usr.0 6 vvfromcpg2.usr.1 7 Temple.usr.0 ... -Statenormal normal normal normal normal normal normal normal -Detailed_Statenormal normal normal normal normal normal normal normal The columns in the previous example are identified as follows: ■ Id. The logical disk ID. ■ Name.
PAGE 541
InForm OS Version 2.3.1 ◆ degraded_avail. The availability of the LD is degraded. ◆ degraded_perf. The performance of the LD is degraded. ◆ unknown. The LD state is unknown. Command Line Interface Reference NOTES ■ For this command, KB=1024 bytes and MB=1048576 bytes. ■ A Domain column may be included by using the setclienv command to set listdom to 1.
PAGE 542
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showldch DESCRIPTION The showldch command displays configuration information about the chunklet mapping for one Logical Disk (LD). SYNTAX showldch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -degraded Show only the chunklets in sets that cause the LD availability to be degraded.
PAGE 543
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the LD name. RESTRICTIONS None. EXAMPLES The following example displays information about chunklets for LD r1.usr.0: cli% showldch r1.usr.
PAGE 544
Command Line Interface Reference InForm OS Version 2.3.1 ◆ normal. The chunklet is available for use. ◆ normal,smag. A servicemag operation is being performed on the disks. ◆ stale. The chunklet is not available for use because of a medium failure or a connectivity failure. ■ ◆ logging. Writes to the chunklet are being logged to a separate logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. The chunklet does not process physical disk errors.
PAGE 545
InForm OS Version 2.3.1 Command Line Interface Reference The following example displays information about degraded chunklets for LD r1.usr.0. cli% showldch -degraded r1.usr.0 Ldch Row Set PdPos Pdid Pdch State Usage Media Sp 0 0 0 1:3:2 30 0 normal ld valid N 1 0 0 1:3:3 31 3 normal ld valid N 14 0 7 2:0:1 33 0 normal ld valid N 15 0 7 2:0:2 34 5 normal ld valid N cli% showldch -degraded r1.usr.1 No degraded sets in LD r1.usr.
PAGE 546
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays row and set layout including pdid and pdpos for chunklets for LD test.usr.0. cli% showldch -lformat set -linfo pdid,pdpos test.usr.
PAGE 547
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showldmap DESCRIPTION The showldmap command displays the mapping from a Logical Disk (LD) to Virtual Volumes (VVs). SYNTAX showldmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the LD name. RESTRICTIONS None. EXAMPLES The following example displays the region of LD v0.usr.0 that is used for a VV: cli% showldmap v0.usr.
PAGE 548
Command Line Interface Reference ■ VVName. The name of the virtual volume that contains the region. ■ VVSp. The type of the space-user (usr), snapshot data (snp), or snapshot administration (adm)-for which the region is being used. ■ VVOff(MB). The offset from the beginning of the space that contains the region. NOTES None. 22.72 InForm OS Version 2.3.
PAGE 549
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showlicense DESCRIPTION The showlicense command displays the currently installed license key and current license information. SYNTAX showlicense AUTHORITY Super, Service, Edit, Browse OPTIONS –raw Specifies that the license key originally entered (the raw license) be displayed. The license key is displayed in a manner that is acceptable input for the setlicense command. SPECIFIERS None. RESTRICTIONS None. 22.
PAGE 550
Command Line Interface Reference InForm OS Version 2.3.
PAGE 551
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownet DESCRIPTION The shownet command displays the configuration and status of the administration network interfaces, including the configured gateway and Network Time Protocol (NTP) server. SYNTAX shownet [option] AUTHORITY Super, Service, Edit, Browse OPTION –d Displays detailed information. SPECIFIERS None. RESTRICTIONS None. 22.
PAGE 552
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays the status of the system administration network interfaces: root@enodec34:S424# shownet -d IP Address: 192.168.5.191 Netmask 255.255.252.
PAGE 553
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownode DESCRIPTION The shownode command displays an overview of the node-specific properties and its component information. Various command options can be used to display the properties of PCI cards, CPUs, physical memory, disk drives, and power supplies. SYNTAX shownode [option] [...
PAGE 554
Command Line Interface Reference InForm OS Version 2.3.1 -drive Displays the disk drive information. –ps Displays power supply information. –s Displays the detailed state information for node or power supply (proceed with the -ps option) SPECIFIERS ... Displays the node information for the specified node ID(s). This specifier is not required. RESTRICTIONS None.
PAGE 555
InForm OS Version 2.3.1 ◆ Command Line Interface Reference Failed. The node has not initialized, is offline, has mismatching kernal versions has bad drive partitions, is rebooting, or has shutdown. ■ Master. Specifies is the node is the master node. ■ InCluster. Indicates if the node is in the cluster. ■ LED. The node LED information. Values are as follows: ◆ --. The node LED is unknown. ◆ off. The node LED is off. ◆ Green. The kernal is not running. ◆ GreenBlink.
PAGE 556
Command Line Interface Reference InForm OS Version 2.3.1 These columns and values are described in detail in the following examples. cli% Node 0 0 0 0 0 1 1 1 1 1 shownode -mem Riser Slot SlotID n/a 0 J4200 n/a 1 J4300 2-slot 0 J0901 4-slot 1 J0900 4-slot 2 J1300 n/a 0 J4200 n/a 1 J4300 2-slot 0 J0901 4-slot 1 J0900 4-slot 2 J1300 -Name-DIMM0 DIMM1 DIMM0.0 DIMM1.0 DIMM2.0 DIMM0 DIMM1 DIMM0.0 DIMM1.0 DIMM2.
PAGE 557
InForm OS Version 2.3.1 Command Line Interface Reference cli% shownode -drive ... Node Drive -Manufacturer- ---Model--- -Serial- -Firmware- Size(MB) Type 0 0 Seagate ST9100821AS 5NJ09DF3 3.AAB 95396 SATA 1 0 Seagate ST9100821AS 5NJ08NA4 3.AAB 95396 SATA In the example above: ■ Node. The node ID. ■ Drive. The disk drive ID. ■ Manufacturer. The manufacturer of the disk drive. ■ Model. The model number of the disk drive. ■ Serial. The serial number of the disk drive. ■ Firmware.
PAGE 558
Command Line Interface Reference ■ Rev. The revision number of the PCI card. ■ Firmware. The firmware version on the PCI card. InForm OS Version 2.3.1 cli% shownode -cpu --------------------------------CPUs-------------------------------Node CPU -Manufacturer- -----Serial----- CPUSpeed(MHz) BusSpeed(MHz) 0 0 GenuineIntel 000188AAF2AEA667 995 132.76 0 1 GenuineIntel 0000D8D47BD100A6 995 132.76 1 0 GenuineIntel 0000F5A65AAD5D6F 995 132.72 1 1 GenuineIntel 00028FE5F6E4068D 995 132.
PAGE 559
InForm OS Version 2.3.1 ■ ■ ■ ■ ■ Command Line Interface Reference ◆ Failed. The power supply is operating abnormally. ◆ NotPresent. The power supply is missing. ◆ Degraded. There is a fan failure, or the battery state is not OK. FanState. The power supply fan state. Values are as follows: ◆ --. Cannot determine the state. ◆ OK. The fan is operating normally. ◆ Failed. The fan is operating abnormally. ACState. The state of the AC power. Values are as follows: ◆ --.
PAGE 560
Command Line Interface Reference InForm OS Version 2.3.1 The following example displays the detailed state of the nodes: cli% shownode -s Node 0 1 2 3 -StateOK OK OK OK -Detailed_StateOK OK OK OK In the example above: ■ Node. The node ID. ■ State. The state of the node. Values are as follows: ◆ ◆ OK. The node and its components are operating normally. Degraded.
PAGE 561
InForm OS Version 2.3.1 Command Line Interface Reference ◆ cpu_vrm_overheating. The node CPU VRM overheating. ◆ control_cache_dimm_overheating. The node Control Cache DIMM is overheating. ◆ node_offline_due_to_failure. The node is offline due to failure. ◆ node_shutdown_manually. The node was shutdown manually. ◆ unknown. The node state is unknown.
PAGE 562
Command Line Interface Reference ◆ invalid_firmware. The power supply firmware is invalid. ◆ oscillating_presence. The power supply presence is oscillating. ◆ oscillating_dc. The power supply DC is oscillating. ◆ oscillating_ac. The power supply AC is oscillating. ◆ oscillating_fan. The power supply fan is oscillating. ◆ oscillating_charger. The power supply charger is oscillating. ◆ oscillating_bat. The power supply battery is oscillating. ◆ NotPresent. The power supply is not present.
PAGE 563
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND shownodeenv DESCRIPTION The shownodeenv command displays the node operating environment status, including voltages and temperatures. SYNTAX shownodeenv [options ...] AUTHORITY Super, Service, Edit, Browse OPTIONS –n ... Specifies the ID of the node whose environment status is displayed. Multiple node IDs can be specified as a series of integers separated by a space (1 2 3).
PAGE 564
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays the operating environment status for all nodes in the system: cli% shownodeenv Node 0 --------Measurement CPU0 1.32V: CPU1 1.32V: 82563 1.20V: 31154 1.30V: 82563 1.90V: 3.30V: PLX 3.30V: VCC 5.00V: V_PTT 1.20V: MCH 1.50V: ESB 1.50V: FBD 1.50V: FBD 1.80V: VTT_FBD 0.90V: ESB 1.20V: PLX 1.00V: Osprey DDR 1.25V: Osprey DDR 2.50V: Osprey Lnk 1.87V: FPGA 2.50V: 12.
PAGE 565
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpatch DESCRIPTION The showpatch command displays patches applied to a system. SYNTAX showpatch [option ] AUTHORITY Super, Service, Edit, Browse OPTIONS –hist Specifies the history of all patches and updates applied to the system. –d Specifies the details on a specified patch ID. SPECIFIERS None. RESTRICTIONS None.
PAGE 566
Command Line Interface Reference InForm OS Version 2.3.1 ■ Obsoletes. Specifies the patch IDs deleted by this patch. ■ Requires. Specifies the patch IDs of any other patches required by this patch. ■ Notes. Specifies any special instructions for the patch. NOTES This command displays all the patches currently affecting the system if options are not used. 22.
PAGE 567
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpd DESCRIPTION The showpd command displays configuration information about a system’s Physical Disks (PDs). SYNTAX showpd [options] [...] showpd -listcols AUTHORITY Super, Service, Edit, Browse OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showpd for help on each column).
PAGE 568
Command Line Interface Reference InForm OS Version 2.3.1 –i Specifies a request for disk (inquiry) data. The following columns are shown: Id, CagePos, State, Node_WWN, Manuf, Model, Serial, FW_Rev. –e Specifies a request for the disk environment and error information. Note that reading this information places a significant load on each disk. The following columns are shown: Id, CagePos, Type, State, Rd_CErr, Rd_UErr, Wr_CErr, Wr_UErr. –c Specifies a request for chunklet use totals for each PD.
PAGE 569
InForm OS Version 2.3.1 Command Line Interface Reference –sortcol [,
][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting () can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:).
PAGE 570
Command Line Interface Reference InForm OS Version 2.3.1 –st Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3). A range of slots is separated with a hyphen (0–3). The primary path of the disks must be on the specified PCI slot(s). –pt Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3).
PAGE 571
InForm OS Version 2.3.1 Command Line Interface Reference NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive. –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected. –tc_lt Specifies that physcial disks with total chunklets less than the number specified are selected.
PAGE 572
Command Line Interface Reference InForm OS Version 2.3.1 -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed.
PAGE 573
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None.
PAGE 574
Command Line Interface Reference InForm OS Version 2.3.1 ◆ new - The PD is new, needs to be admitted before it can be used (see help admitpd) ◆ failed - The PD has failed. ■ Total. Total size of the disk in MB (1024^2 bytes). ■ Free. Free size of the disk in MB (1024^2 bytes). This includes the size that is available to use, uninitialized, and unavailable to use. ■ Port_A. The port location for the A port of the physical disk. If the primary path, the port location is followed by an asterisk (*).
PAGE 575
InForm OS Version 2.3.1 ◆ ■ Command Line Interface Reference SSD - Solid State Drive State. State of the PD can be one of the following: ◆ normal - PD is normal ◆ degraded - The PD is not operating normally. Use showpd -s to find out the detail information. ■ ■ ◆ new - The PD is new, needs to be admitted before it can be used (see help admitpd) ◆ failed - The PD has failed. Total. Total size of the disk in MB (1024^2 bytes). Normal Chunklets.
PAGE 576
Command Line Interface Reference ■ InForm OS Version 2.3.1 CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine.
PAGE 577
InForm OS Version 2.3.1 ■ Command Line Interface Reference CagePos. Position of PD, in the format :.: where is the cage number, is 0 or 1 depending on whether the cage is on the left or right (from the front view) of the disk chassis, is the magazine number (0 through 4) and is the disk number (0 through 3) within the magazine.
PAGE 578
Command Line Interface Reference InForm OS Version 2.3.
PAGE 579
InForm OS Version 2.3.1 Command Line Interface Reference ■ Write_Error_UnCorr. Number of uncorrectable write errors. ■ T(C). Temperature in degrees celsius.
PAGE 580
Command Line Interface Reference InForm OS Version 2.3.
PAGE 581
InForm OS Version 2.3.1 Command Line Interface Reference the current position of the drive is not known (for example, the drive may be missing), and the position shown is the last known position. ■ ■ Type. Device type of the PD. ◆ FC - Fibre Channel ◆ NL - Nearline ◆ SSD - Solid State Drive Speed(K). The maximum RPM speed of the physical disk. The number does not represent a rotational speed for the drives without spinning media (SSD).
PAGE 582
Command Line Interface Reference InForm OS Version 2.3.
PAGE 583
InForm OS Version 2.3.1 ■ Command Line Interface Reference Without the -i, -c, -e, -s, -path or -space options, basic information about the PD is printed. Note that the primary path to the disk is shown by an asterisk(*) in either the APort or BPort column, and a minus (-) sign following a path indicates the port is disabled. ■ If the specifier and the -w option is not specified, all disks are displayed. 22.
PAGE 584
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showpdata DESCRIPTION The showpdata command displays information about the preserved data in the system. SYNTAX showpdata [] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [] Requests that preserved data for a specific Logical Disk (LD) is displayed. This specifier is not required on the command line. If not specified, then the amount of preserved data by LD is displayed.
PAGE 585
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showpdch DESCRIPTION The showpdch command displays the status of selected Physical Disk (PD) chunklets. SYNTAX showpdch [options] showpdch [options] |... (deprecated usage) AUTHORITY Super, Service, Edit, Browse OPTIONS The following filtering options specify conditions that a chunklet should meet in order for the chunklet to be displayed.
PAGE 586
Command Line Interface Reference InForm OS Version 2.3.1 –tgt Specifies that information for chunklets marked as targets of relocation is displayed. –src Specifies that information about chunklets that are marked as sources of relocation, is displayed. –spr Specifies that information about chunklets that are marked as spares, is displayed. –log Specifies that information about chunklets that are logging is displayed.
PAGE 587
InForm OS Version 2.3.1 Command Line Interface Reference –nd Specifies one or more nodes. Nodes are identified by one or more integers (item). Multiple nodes are separated with a single comma (1,2,3). A range of nodes is separated with a hyphen (0–7). The primary path of the disks must be on the specified node(s). –st Specifies one or more PCI slots. Slots are identified by one or more integers (item). Multiple slots are separated with a single comma (1,2,3).
PAGE 588
Command Line Interface Reference InForm OS Version 2.3.1 –dk Specifies one or more PDs. Disks are identified by one or more integers (item). Multiple disks are separated with a single comma (1,2,3). A range of disks is separated with a hyphen (0–3). Disks must match the specified ID(s). NOTE: The following arguments, –tc_gt, –tc_lt, –fc_gt, –fc_lt, –devid, and –devtype are used to limit the disks that are used to create logical disks based on the characteristics of the disk drive.
PAGE 589
InForm OS Version 2.3.1 Command Line Interface Reference -rpm Disks must be of the specified speed. Device speeds are shown in the Speed column of the showpd command. The number does not represent a rotational speed for the drives without spinning media (SSD). It is meant as a rough estimation of the performance difference between the drive and the other drives in the system. For FC and NL drives, the number corresponds to both a performance measure and actual rotational speed.
PAGE 590
Command Line Interface Reference ■ LdCh. The position of the chunklet on the logical disk. ■ State. The state of the chunklet as identified by the kernel. InForm OS Version 2.3.1 ◆ logging. I/O to the chunklet is written to the logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. Chunklets do not process physical disk errors. ◆ preserved. Any I/O to the chunklet is written to the preserved logical disks. ◆ preserved playback.
PAGE 591
InForm OS Version 2.3.1 ■ Command Line Interface Reference Cl. The clean status of the chunklet. N indicates that the chunklet is in-use. Y indicates that the chunklet is clean. Cg indicates that the chunklet is being cleaned. ■ From. The initial location of the chunklet before relocation in the syntax :. ■ To. The destination location of the chunklet during relocation in the syntax :. NOTES None. 22.
PAGE 592
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showpdvv DESCRIPTION The showpdvv command displays the virtual volumes hat are mapped to a particular physical disk. SYNTAX showpdvv [options] [ [:]...] AUTHORITY Super, Service, Edit, Browse OPTIONS -sum Shows number of chunklets used by virtual volumes for different space types for each physical disk. –p PDs matching the specified pattern are displayed.
PAGE 593
InForm OS Version 2.3.1 Command Line Interface Reference –pt Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–3). The primary path of the disks must be on the specified port(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3).
PAGE 594
Command Line Interface Reference InForm OS Version 2.3.1 –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected.
PAGE 595
InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows with the same information in them as earlier columns will be sorted by values in later columns. SPECIFIERS Specifies the physical disk ID using an integer. This specifier is not required if -p option is used, otherwise it must be used at least once on the command line.
PAGE 596
Command Line Interface Reference NOTES None. 22.120 InForm OS Version 2.3.
PAGE 597
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showport DESCRIPTION The showport command displays information about ports in the system. SYNTAX The syntax of the showport command can be one of the following: ■ showport [options] [-failed] [-sortcol [,
]] AUTHORITY Super, Service, Edit, Browse OPTIONS -i Show hardware and inventory formation. -c Displays all devices connected to each loop (by position on the loop).
PAGE 598
Command Line Interface Reference InForm OS Version 2.3.1 -rcip Displays information specific to the Ethernet Remote Copy ports. -iscsi Displays information about iSCSI ports. -iscsiname Displays iSCSI names associated with iSCSI ports. -sfp Displays information about hot pluggable SFPs attached to ports. -ddm Displays information about the SFPs DDM. This option must be used with the -sfp option. -d Displays detailed information about the SFPs attached to ports.
PAGE 599
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS None. RESTRICTIONS None.
PAGE 600
Command Line Interface Reference ◆ loss_sync. The port is not physically connected to anything. ◆ config_wait. Firmware has yet to be initialized. ◆ InForm OS Version 2.3.1 login_wait. Fibre Channel adapter is attempting port and process logins with all loop ports. ◆ error. Fibre Channel adapter has experienced an unrecoverable error. ◆ non_participate. Port is logically isolated from the Fibre Channel loop. ◆ offline. The port is offline. ◆ pending_reset.
PAGE 601
InForm OS Version 2.3.
PAGE 602
Command Line Interface Reference InForm OS Version 2.3.
PAGE 603
InForm OS Version 2.3.1 Command Line Interface Reference The following example displays information about all Remote Copy ports: cli% showport –rc N:S:P State HwAddr Rate 5:3:2 ready 25320002AC000006 2Gbps 4:1:1 ready 24110002AC000006 2Gbps 0:5:1 ready 0002B39B2013 100Mbps Type rcip rcip rcip The columns in the previous example are identified as follows: ■ N:S:P. The physical position of the port, in the syntax node:slot:port. ■ State. State of the port. ◆ ready.
PAGE 604
Command Line Interface Reference The following example displays the detailed state of the port: cli% showport –s N:S:P --State-- -Detailed_State0:0:1 ready loss_sync 0:0:2 ready loss_sync 0:3:1 ready offline 0:3:1 ready offline 0:5:1 ready loss_sync -------------------------------10 The columns in the previous example are identified as follows: ■ N:S:P. The physical position of the port, in the syntax node:slot:port. ■ State. State of the port. ■ 22.128 ◆ OK. Port SFP is operating normally.
PAGE 605
InForm OS Version 2.3.1 ◆ Command Line Interface Reference unknown. The link state is unknown. The following example displays information about RCIP ports: cli% showport N:S:P State 0:1:1 offline 0:1:1 offline 1:2:1 offline 1:2:1 offline -rcip ---HwAddr--- IPAddr Netmask Gateway MTU Rate Duplex AutoNeg 000423C21B72 - n/a n/a n/a 000423C21B73 - n/a n/a n/a 000423ADE95E - n/a n/a n/a 000423ADE95F - n/a n/a n/a The columns in the previous example are identified as follows: ■ N:S:P.
PAGE 606
Command Line Interface Reference ■ InForm OS Version 2.3.1 AutoNeg. Values can either be Yes or No. The following example displays information about iSCSI ports: cli% showport -iscsi N:S:P State IPAddr Netmask Gateway TPGT MTU Rate DHCP iSNS_Prim iSNS_Sec iSNS_Port 1:3:1 ready 192.168.9.163 255.255.255.0 192.168.9.1 131 1500 1Gbps 0 0.0.0.0 0.0.0.0 3205 1:3:2 loss_sync 0.0.0.0 0.0.0.0 0.0.0.0 132 1500 n/a 0 0.0.0.0 0.0.0.
PAGE 607
InForm OS Version 2.3.1 Command Line Interface Reference The following examples display both standard and detailed information about SFPs attached to ports: cli% showport N:S:P -State0:0:1 OK 0:0:2 OK 0:3:2 OK 1:0:1 OK 1:0:2 OK cli% -sfp -Manufacturer- MaxSpeed(Gbps) TXDisable TXFault RXLoss DDM FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2.10 No No Yes Yes SIGMA-LINKS 2.10 No No Yes Yes FINISAR_CORP. 2.10 No No No Yes FINISAR_CORP. 2.
PAGE 608
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showportarp DESCRIPTION The showportarp command shows the ARP table for iSCSI ports in the system. SYNTAX showportarp [::
~~] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [::~~
~~] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node.~~
~~PAGE 609~~
InForm OS Version 2.3.1 ■ Command Line Interface Reference HwAddr. The MAC address of a remote host discovered through the MAC address resolution process. ■ IPAddr. The IP address of the remote host to which the port is attempting to connect. ■ Time (mins). The amount of time (in minutes) that the entry has been in the table. When the entry has been in the table for 20 minutes, it is removed. NOTES None. 22.
~~PAGE 610~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showportdev DESCRIPTION The showportdev command displays detailed information about either all devices or only arbitrated loop devices on a Fibre Channel port. SYNTAX showportdev loop|all|ns AUTHORITY Super, Service, Edit, Browse SUBCOMMANDS loop|all|ns loop Specifies that information is returned for arbitrated loop devices that are attached to the specified port.
~~PAGE 611~~
InForm OS Version 2.3.1 Command Line Interface Reference slot Specifies the PCI bus slot in the specified node. port Specifies the Fibre Channel port number of the PCI card in the specified PCI bus slot. RESTRICTIONS The loop subcommand is functional only in a private loop topology.
~~PAGE 612~~
~~Command Line Interface Reference NOTES None. 22.136 InForm OS Version 2.3.~~
~~PAGE 613~~
~~InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showportisns DESCRIPTION The showportisns command shows iSNS host information for iSCSI ports in the system. SYNTAX showportisns [::~~
] AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS [] Specifies the port for which information about devices on that port are displayed. node Specifies the node. slot Specifies the PCI bus slot in the specified node.
~~PAGE 614~~
Command Line Interface Reference ■ N:S:P. Represents the node:slot:port of the iSCSI port. ■ Host_IPAddr. The IP address of a remote host. ■ Host_iSCSI_Name. Represents the iSCSI name of the host. ■ Host_alias. Represents the iSCSI alias of the host. NOTES None. 22.138 InForm OS Version 2.3.
~~PAGE 615~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showportlesb DESCRIPTION The showportlesb command displays Fibre Channel Link Error Status Block (LESB) counters (the number of errors accumulated for Fibre Channel devices). The LESB is composed of six counters that can measure Fibre Channel signal integrity or status.
~~PAGE 616~~
Command Line Interface Reference InForm OS Version 2.3.1 Displays differences between historical samples of LESB counters on the specified port of loop devices. OPTIONS –startt Specifies that samples taken of LESB counters should commence after the indicated time (). Time can be specified in hours or as a specific date. When specifying the time in hours, the following formats can be used: ◆ hh[:mm[:ss]], where hh is the hour, mm is the minute (optional), and ss is the second (optional).
~~PAGE 617~~
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS Specifies the port for which information about devices on that port are displayed. This specifier is required for the single, both, hist, and diffhist subcommands, and optional for the compare subcommand. If this specifier is not used with the compare subcommand, then all ports are compared. The port is specified as follows: node Specifies the node. slot Specifies the PCI bus slot in the specified node.
~~PAGE 618~~
Command Line Interface Reference The following example displays the comparison of all ports: cli% showportlesb compare Port <1:0:1> Loop <1:0:1> Time since last save: 0:00:28 ID ALPA LinkFail LossSync LossSig PrimSeq InvWord InvCRC <1:0:1> 0xef 1 19 19 0 0 0 pd7 0x6d 1 5 0 0 270 0 pd6 0x72 1 4 0 0 524 0 pd5 0x73 1 4 0 0 335 0 pd4 0x76 1 4 0 0 334 0 pd3 0x79 1 4 0 0 401 0 pd2 0x80 1 4 0 0 344 0 pd1 0x81 1 4 0 0 270 0 pd0 0x88 1 4 0 0 401 0 Port <0:0:1> Loop <0:0:1> Time since last save: 0:00:28 ID ALPA Link
~~PAGE 619~~
~~InForm OS Version 2.3.~~
~~PAGE 620~~
Command Line Interface Reference ■ InForm OS Version 2.3.1 PrimSeq. Primitive Sequence Protocol Error. There were errors during the transmission of a Fibre Channel primitive sequence. This might indicate an error during the loop recovery or initialization. ■ InvWord. Invalid Transmission Word. Illegal Fibre Channel transmission word received. ■ InvCRC. Invalid Cyclical Redundancy Check. Data corruption in the Fibre Channel frame.
~~PAGE 621~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showrcopy DESCRIPTION The showrcopy command displays details of the Remote Copy configuration. SYNTAX The syntax for the showrcopy command can be one of the following: ■ showrcopy [options ] [links] ■ showrcopy [options ] [groups []] ■ showrcopy [options ] [targets []] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Displays more detailed configuration information.
~~PAGE 622~~
Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. EXAMPLES The following example displays output from the showrcopy command: cli% showrcopy Remote Copy System Information Status: Started, Normal Target Information Name ID Type Status Options Policy InServ2 9 IP ready mirror_config Link Information Target InServ2 InServ2 receive receive Node 0 1 0 1 Address 10.100.33.11 10.
~~PAGE 623~~
InForm OS Version 2.3.1 Command Line Interface Reference ■ New. Volume is configured, but has not yet been started. ■ Syncing. Volume is currently synchronizing. ■ NotSynced. The volume is not synchronized, likely the result of an initial sync failure or some other failure. ■ Stopped. The volume was synced the last time the group was started, but the group is currently stopped. There might be writes that have not been sent to the secondary site. ■ Stale.
~~PAGE 624~~
Command Line Interface Reference ◆ Starting. Currently attempting to start the group. ◆ Started. Group is started (has Remote Copy running). ◆ Stopped. Group was stopped. ■ Role. The role of the group as either Primary or Secondary. ■ Mode. The mode of the group as either Periodic or Synchronous. ■ Options. The options set for the group. ■ LocalVV and ID. The name and ID of this system. ■ RemoteVV and ID. The name and ID of the target system. ■ SyncStatus.
~~PAGE 625~~
InForm OS Version 2.3.1 Command Line Interface Reference ■ See Help on sub,globpat for information on glob-style patterns. ■ A Domain column may be included by using the setclienv command to set listdom to 1. The -listdom option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable set. See Help on sub,glopat for information on glob-style patterns. Please run cli -h and setclienv -h for details of the environment variables.
~~PAGE 626~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showrctransport DESCRIPTION The showrctransport command shows status and information about end-to-end transport for Remote Copy in the system. SYNTAX showcrtransport [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –rcip Show information about Ethernet end-to-end transport. –rcfc Show information about Fibre Channel end-to-end-transport. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 627~~
InForm OS Version 2.3.1 ■ Command Line Interface Reference Peer_Address. IP address of the Remote Copy storage server port connected to this Remote Copy port. ■ Address. IP address of the Remote Copy storage server port. ■ State. Remote copy end-to-end transport state. Can include one of the following results: ◆ new. Configuration is not completed on this port. ◆ incomplete. Configuration is not yet completed on the peer port. ◆ ready.
~~PAGE 628~~
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.
~~PAGE 629~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showrsv DESCRIPTION The showrsv command displays SCSI reservation and registration information for Virtual Volume Logical Unit Numbers (VLUNs) bound for a specified port. SYNTAX showrsv [options ] [] AUTHORITY Super, Service, Edit, Browse OPTIONS –l Specifies that either SCSI–3 persistent reservation or SCSI–2 reservation information is displayed.
~~PAGE 630~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about reservation and registration information for VLUNs bound with host name w2k_emx1_cisco. cli% showrsv –host w2k_emx1_cisco VVname Host Owner w2k_clusterd.10 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd.11 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd.12 w2k_emx1_cisco 10000000C92B9909 w2k_clusterd.
~~PAGE 631~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsched DESCRIPTION The showsched command shows the state of tasks currently scheduled on the system. SYNTAX showsched [options][|] AUTHORITY Super, Service OPTIONS -all Specifies that all scheduled tasks will be displayed. -sortcol [,
~~][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified.~~
~~PAGE 632~~
~~Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None. EXAMPLES The following example displays information of all scheduled tasks.~~
~~PAGE 633~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsnmpmgr DESCRIPTION The showsnmpmgr command displays a list of registered SNMP managers for receiving traps. SYNTAX showsnmpmgr AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays a list of registered managers: cli% showsnmpmgr Manager IP 82.185.98.76 82.162.9.7 5def:2008:abcd::161a Port 162 8004 9162 In the example above: Host IP.
~~PAGE 634~~
Command Line Interface Reference InForm OS Version 2.3.1 EXIT STATUS The following codes are returned indicating success or failure: ■ 0 indicates that the command was successful. ■ 1 indicates that the command failed. NOTES Managers are registered using the addsnmpmgr command. See addsnmpmgr on page 4.2 for additional information. 22.
~~PAGE 635~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsnmppw DESCRIPTION The showsnmppw command displays the SNMP community string passwords. SYNTAX showsnmppw [options] AUTHORITY Super, Edit, Browse OPTIONS –rw|–r|–w Specifies that the read-write (–rw), read-only (–r), or write-only (–w) password is displayed. If not specified, the read/write community string password is displayed. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 636~~
~~Command Line Interface Reference InForm OS Version 2.3.1 NOTES SNMP passwords are registered using the setsnmppw command. See setsnmppw on page 21.68 for more information. 22.~~
~~PAGE 637~~
~~InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showspace DESCRIPTION The showspace command displays estimated free space for logical disk creation.~~
~~PAGE 638~~
Command Line Interface Reference InForm OS Version 2.3.1 –rs Specifies the number of sets in a row using an integer from 1 through 2147483647. If not specified, no row limit is imposed. –ss Specifies the step size in kilobytes using 32 KB to 512 KB. The step size should be a power of 2 and a multiple of 32. If no value is entered, the step size defaults to 256 KB for RAID-0 and RAID-1, and 128 KB for RAID-5. For RAID-6, the default is a function of the set size.
~~PAGE 639~~
InForm OS Version 2.3.1 Command Line Interface Reference –pt Specifies one or more ports. Ports are identified by one or more integers (item). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–4). The primary path of the disks must be on the specified port(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (item). Multiple drive cages are separated with a single comma (1,2,3).
~~PAGE 640~~
Command Line Interface Reference InForm OS Version 2.3.1 –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected. Models can be specified in a comma-separated list. Models can be displayed by issuing the showpd -i command.
~~PAGE 641~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the estimated free space for a RAID-1 LD: cli% showspace –t r1 --Estimated(MB)--RawFree UsableFree 13824 6912 NOTES ■ The showspace command includes chunklets in the process of being initialized as shown by the Normal, Unused, Uninit column of showpd -c. The space represented by these chunklets will not actually be available until the initialization process is complete.
~~PAGE 642~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showspare [-used] DESCRIPTION The showspare command displays information about chunklets in the system that are reserved for spares and previously free chunklets selected for spares by the system. SYNTAX showspare AUTHORITY Super, Service, Edit, Browse OPTIONS -used Show only used spare chunklets. By default all spare chunklets are shown. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 643~~
InForm OS Version 2.3.1 Command Line Interface Reference ■ LdName. The name of the logical disk that is using the spare chunklet. ■ LdCh. The position of the chunklet on the logical disk. ■ State. The state of the chunklet as identified by the kernel. ◆ logging. I/O to the chunklet is written to the logging logical disk. ◆ playback. Data is played back from the logging logical disks. ◆ passthru. Chunklets do not process physical disk errors. ◆ preserved.
~~PAGE 644~~
Command Line Interface Reference ■ InForm OS Version 2.3.1 Sp. The spare status of the chunklet; Y indicates the chunklet is reserved for spare, N indicates a previously free chunklet selected by the system as a spare. ■ Cl. The clean status of the chunklet. N indicates that the chunklet is in-use. Y indicates that the chunklet is clean. Cg indicates that the chunklet is being cleaned. ■ From. The initial location of the chunklet before relocation. ■ To.
~~PAGE 645~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsshkey DESCRIPTION The showsshkey command will displays all SSH public keys that have been set with setsshkey. SYNTAX showsshkey AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 646~~
Command Line Interface Reference InForm OS Version 2.3.1 NOTES The public SSH keys that are displayed by this command are used to determine that the private keys that are paired with them are valid, and are not useful in determining the contents of that private key. As such, the contents of the public keys are not sensitive, and having access to them will not aid someone attempting to access an account to which they should not have access. 22.
~~PAGE 647~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showsys DESCRIPTION The showsys command displays the InServ system properties includes system name, model, serial number, and system capacity information, etc. SYNTAX showsys [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies that more detailed information about the system is displayed. –param Specifies that the system parameters are displayed. –fan Displays the system fan information.
~~PAGE 648~~
Command Line Interface Reference InForm OS Version 2.3.1 –devtype FC|NL|SSD Displays the system capacity information where the disks must have a device type string matching the specified device type; either Fibre Channel (FC), Nearline (NL), Solid State Drive (SSD). This option can only be issued with the -space option. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 649~~
~~InForm OS Version 2.3.~~
~~PAGE 650~~
~~Command Line Interface Reference InForm OS Version 2.3.~~
~~PAGE 651~~
InForm OS Version 2.3.1 Command Line Interface Reference The following example shows system parameters (–param option) for an InServ Storage Server: cli% showsys -param System parameters from configured settings ---Parameter---RawSpaceAlertFC RawSpaceAlertNL RemoteSyslog RemoteSyslogHost SparingAlgorithm CopySpaceReclaim EventLogSize VVRetentionTimeMax : : : : : : : : ---Value---0 0 1 192.168.6.15 Minimal 0 3M 336 Hours NOTES ■ See setsys on page 21.
~~PAGE 652~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showsysmgr DESCRIPTION The showsysmgr displays startup state information about the system manager. SYNTAX showsysmgr AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the startup state information about the system manager. In this example, the system manager reports that it is up and running.
~~PAGE 653~~
InForm OS Version 2.3.1 Command Line Interface Reference If the system has attempted powerfail recovery three times, and during the recovery attempts encountered kernal panics because of hardware or software errors, the following message is displayed. See Notes in the following section for additional information. cli% showsysmgr System is recovering from a previous power failure. Please use the 'showvv', 'showld', 'showpd' CLI commands to check for not started vvs, lds, pds.
~~PAGE 654~~
Command Line Interface Reference InForm OS Version 2.3.1 disks and virtual volumes upon restarting. See setsysmgr on page 21.79 for more information. ■ During powerfail recovery, a kernal panic because of hardware or software errors might indicate a damaged volume. In such cases, after the system restarts, it waits for user intervention. Issue the setsysmgr force_iderecovery command to force the system to start another powerfail recovery.
~~PAGE 655~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtarget DESCRIPTION The showtarget command displays information about unrecognized targets. SYNTAX showtarget AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays information about unrecognized targets: cli% showtarget no unknown targets listed In the previous example, there are no unknown targets.
~~PAGE 656~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showtask DESCRIPTION The showtask command displays information about tasks. By default, this command displays all non-system tasks on the system within the last 24 hours. SYNTAX showtask [options ] [ | ] AUTHORITY Super, Service, Edit, Browse OPTIONS –all Specifies that all scheduled tasks will be displayed. Unless the -all option is specified, system tasks are not displayed.
~~PAGE 657~~
InForm OS Version 2.3.1 Command Line Interface Reference –d ... Show detailed task status for specified tasks. Tasks must be explicitly specified using their task IDs . Multiple task IDs can be specified. This option cannot be used in conjunction with other options. -sortcol [,
~~][:[,]...] Sorts command output based on column number (). Columns are numbered from left to right, beginning with 0. At least one column must be specified.~~
~~PAGE 658~~
Command Line Interface Reference InForm OS Version 2.3.1 ◆ move_regions. Track region move operations (movereg command). ◆ promote_sv. Track virtual copy promotes (promotesv command). Requires a 3PAR Virtual Copy license. ◆ remote_copy_sync. Track Remote Copy volume group synchronizations (syncrcopy and startrcopygroup commands). Requires a 3PAR Remote Copy license. ◆ tune_vv. Track 3PAR System Tuner volume tuning operations (tunealdvv command). Requires a 3PAR Dynamic Optimization license.
~~PAGE 659~~
~~InForm OS Version 2.3.1 Command Line Interface Reference The following example shows details about a specific task using the task ID (task ID is 3).~~
~~PAGE 660~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showtemplate DESCRIPTION The showtemplate command displays existing templates that can be used for Virtual Volume (VV), Logical Disk (LD), or Common Provisioning Group (CPG) creation. SYNTAX showtemplate [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –t VV|LD|CPG Specifies that the template type displayed is a VV, LD, or CPG template.
~~PAGE 661~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtoc DESCRIPTION The showtoc command displays the system table of contents summary that provides a summary of the system’s resources. SYNTAX showtoc AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the system table of contents.
~~PAGE 662~~
~~Command Line Interface Reference NOTES None. 22.186 InForm OS Version 2.3.~~
~~PAGE 663~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showtocgen DESCRIPTION The showtocgen command displays the table of contents generation number. SYNTAX showtocgen AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 664~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showuser DESCRIPTION The showuser command displays information about one or all users, including the username, authority level, and system resources to which a given user has access. The showuser command shows account information for local users (those created with the createuser command) or shows the SSH key information for local and LDAP users (enabled by the setauthparam command).
~~PAGE 665~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES cli% showuser root Username Domain Privilege Default root all super N cli% The previous example indicates user root being a member of all domains. Valid output includes all, or . The columns are identified as follows: ■ Username. Your user name. ■ Domain. The domain to which the user belongs. ■ Privilege. The privilege level required to run the command. ■ Default.
~~PAGE 666~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showuseracl DESCRIPTION The showuseracl command displays a user’s access control list (ACL). SYNTAX showuseracl AUTHORITY Super, Edit, Browse, Service OPTIONS None. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 667~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showuserconn DESCRIPTION The showuserconn command displays information about users who are currently connected (logged in) to the InServ Storage Server. SYNTAX showuserconn [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -current Shows all information about the current connection only. –sortcol [,
~~][:[,]...] Sorts command output based on column number .~~
~~PAGE 668~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about user connections: cli% showuserconn Id Name --IP_Addr--- Domain Level ----Connected_since---- Current 23180 root 192.168.17.7 all super 2007/05/31 15:02:53 PDT current --------------------------------------------------------------------1 total The columns in the previous example are identified as follows: ■ Id. Your InServ Storage Server identification number. ■ Name.
~~PAGE 669~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showversion DESCRIPTION The showversion command displays information about the storage server software. Use this command to determine if your system is using the latest software version. SYNTAX showversion [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –a Show all component versions. –b Show build levels. –s Show release version number only (useful for scripting).
~~PAGE 670~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays comprehensive information about the system software: cli% showversion Release version 2.3.1.60 (DEVEL) Patches: None Component Name CLI Server CLI Client System Manager Kernel TPD Kernel Code Version 2.3.1 2.3.1 2.3.1 2.3.1 2.3.1 NOTES ■ When displaying all versions, for certain components multiple versions might be installed. In such cases, multiple lines are displayed. ■ 22.
~~PAGE 671~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvlun DESCRIPTION The showvlun command displays information about Virtual Volume Logical Unit Numbers (VLUNs) in the system, such as all active and template VLUNs. The display is divided into two sections: the upper provides information about active VLUNs and the lower provides information about VLUN templates.
~~PAGE 672~~
Command Line Interface Reference InForm OS Version 2.3.1 –a Shows only active VLUNs. –t Shows only VLUN templates. -pathsum Shows path summary information for active VLUNs. –host {}... Specifies that only VLUNs exported to hosts that match the hostname or glob-style patterns (see Help on sub,globpat). –v {|}... Requests that only Logical Disks (LD) mapped to VVs that match any of the specified names or patterns be displayed.
~~PAGE 673~~
InForm OS Version 2.3.1 Command Line Interface Reference -domain {}... Shows only the VLUNs whose VVs are in domains with names that match one or more of the options. This option does now allow listing objects within a domain of which the user is not a member. Multiple domain names or patterns can be repeated using a comma-separated list. –sortcol [,
~~][:[,]...] Sorts command output based on column number .~~
~~PAGE 674~~
Command Line Interface Reference EXAMPLES The following example displays all active and template VLUNs: cli% showvlun Active VLUNs Lun VVname Host ----Host_WWN---- Port Type 0 tpv.0 pe750–07 210000E08B056C21 0:2:1 host 1 tpv.1 pe750–07 210000E08B056C21 0:2:1 host 2 tpv.2 pe750–07 210000E08B056C21 0:2:1 host 3 tpv.3 pe750–07 210000E08B056C21 0:2:1 host 0 tpv.0 pe750–07 210100E08B256C21 1:2:1 host 1 tpv.1 pe750–07 210100E08B256C21 1:2:1 host 2 tpv.2 pe750–07 210100E08B256C21 1:2:1 host 3 tpv.
~~PAGE 675~~
InForm OS Version 2.3.1 Command Line Interface Reference The following example displays all active and template VLUNs using glob-style patterns: cli% showvlun –v *.2,*.3 Active VLUNs Lun VVname Host ----Host_WWN---- Port Type 2 tpv.2 pe750–07 210000E08B056C21 0:2:1 host 3 tpv.3 pe750–07 210000E08B056C21 0:2:1 host 2 tpv.2 pe750–07 210100E08B256C21 1:2:1 host 3 tpv.3 pe750–07 210100E08B256C21 1:2:1 host 2 test.2 sun 210000E08B023F71 0:2:2 host 3 test.3 sun 210000E08B023F71 0:2:2 host 2 test.
~~PAGE 676~~
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ A Domain column may be included by using the setclienv command to set listdom to 1. The listdom option is also set to 1 if the CLI was started with the -listdom option or if the CLI was started with the TPDLISTDOM environment variable set. Please run cli -h and setclienv -h for details of the environment variables. ■ 22.200 See Glob-Style Pattern on page 2.4 for more information.
~~PAGE 677~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvv DESCRIPTION The showvv command displays information about all Virtual Volumes (VVs) or a specific VV in a system. SYNTAX ■ showvv [options ] [...] ■ showvv -listcols AUTHORITY Super, Service, Edit, Browse OPTIONS -listcols List the columns available to be shown in the -showcols option described below (see clihelp -col showvv for help on each column).
~~PAGE 678~~
Command Line Interface Reference InForm OS Version 2.3.1 –d Displays detailed information about the VVs. The following columns are shown: ID, Name, Rd, Mstr, Prnt, Roch, Rwch, PPrnt, PBlkRemain, VV_WWN, CreationTime. –pol Displays policy information about the VV. The following columns are shown: ID, Name, Policies. –s Displays Logical Disk (LD) space use by the VVs.
~~PAGE 679~~
InForm OS Version 2.3.1 Command Line Interface Reference –alert Indicates whether alerts are posted on behalf of the VVs. The following columns are shown: ID, Name, Prov, Type, VSize_MB, Snp_Used_Perc, Warn_Snp_Perc, Limit_Snp_Perc, Usr_Used_Perc, Warn_Usr_Perc, Limit_Usr_Perc, Alert_Adm_Fail_Y, Alert_Snp_Fail_Y, Alert_Snp_Wrn_Y Alert_Snp_Lim_Y, Alert_Usr_Fail_Y, Alert_Usr_Wrn_Y, Alert_Usr_Lim_Y. –alerttime Shows times when alerts were posted (when applicable).
~~PAGE 680~~
~~Command Line Interface Reference InForm OS Version 2.3.1 –sortcol [,~~
][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. At least one column must be specified. In addition, the direction of sorting can be specified as follows: inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:).
~~PAGE 681~~
InForm OS Version 2.3.1 Command Line Interface Reference –host {}... Displays only VVs that are exported as VLUNs to hosts with names that match one or more of the specified or . See Specifiers for additional information on patterns as used with this command. Multiple or specifiers can be repeated using a comma-separated list (for example -host ,...). -baseid {}...
~~PAGE 682~~
Command Line Interface Reference InForm OS Version 2.3.1 -retained Shows only VVs that have a retention time. -failed Shows only failed VVs. The following VV filtering options are deprecated and will be removed in a future release. Instead, use the appropriate -p option described above. -cpg ... Show only VVs whose UsrCPG or SnpCPG matchs the one or more of the or specifier. This option is deprecated without the preceding -p option.
~~PAGE 683~~
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS NOTE: If one or more are specified, then the virtual volumes with names that match any of the patterns are listed. Otherwise, all virtual volumes are listed. The virtual volumes shown include snapshots. Patterns are glob-style (shell-style) patterns (see Help for sub,globpat). ...
~~PAGE 684~~
Command Line Interface Reference InForm OS Version 2.3.1 ◆ tpvv. Thin Provisioned VV, with space for the base volume allocated from the Usr space that is associated with the UsrCPG. Snapshots allocate space from the Snp space associated with the SnpCPG (if any). ◆ cpvv. Commonly Provisioned VV. The Usr space for this VV is fully provisioned and the Snp space is associated with a SnpCPG. ◆ tpsd. An old-style Thin Provisioned VV (created on a 2.2.
~~PAGE 685~~
InForm OS Version 2.3.1 Command Line Interface Reference ◆ started. The virtual volume has been started and is available for use. ◆ started,stl. The virtual volume is stale. ◆ started,cpf. The virtual volume copy or promote has failed. ◆ not_started. The virtual volume has not yet been started (perhaps because one of its underlying logical disks has not yet been started). ◆ pmt. A promote is currently occurring on the base volume.
~~PAGE 686~~
Command Line Interface Reference InForm OS Version 2.3.1 ■ Name. The virtual volume’s name. ■ Rd. The read/write permissions for the volume. Values can be RW (read and write) or RO (read only). ■ Mstr. The master node for the volume responsible for assigning mapping zones. ■ Prnt. The ID of the volume’s parent in the snapshot tree. ■ Roch. The ID of the read only child volume in the snapshot tree. ■ Rwch.The ID of the read write child volume in the snapshot tree. ■ PPrnt.
~~PAGE 687~~
InForm OS Version 2.3.1 ◆ Command Line Interface Reference tpsd. An old-style Thin Provisioned VV (created on a 2.2.4 release or earlier) where both the base VV and snapshot data are allocated from the Snp space associated with the UsrCPG. ◆ snp. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ Adm_Rsvd_MB. Adm (snapshot admin or SA) reserved space in megabytes. ■ Adm_Used_MB. Adm used space in megabytes. ■ Snp_Rsvd_MB.
~~PAGE 688~~
Command Line Interface Reference InForm OS Version 2.3.1 The columns in the previous example are identified as follows: ■ Id. The virtual volume ID. ■ Name. The virtual volume name. ■ Domain. The domain to which the virtual volume belongs. Valid values are – or . If the domain does not exist, - is displayed. The Domain column can be included by using the setclienv command to set listdom to 1.
~~PAGE 689~~
InForm OS Version 2.3.1 Command Line Interface Reference ◆ cpvv. Commonly Provisioned VV. The Usr space for this VV is fully provisioned and the Snp space is associated with a SnpCPG. ◆ tpsd. An old-style Thin Provisioned VV (created on a 2.2.4 release or earlier) where both the base VV and snapshot data are allocated from the Snp space associated with the UsrCPG. ◆ -. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ ■ ■ Type.
~~PAGE 690~~
Command Line Interface Reference ◆ copy_target. The volume is currently the target of a copy. ◆ tuning. The volume is currently tuning. ◆ closing. The volume is currently closing. ◆ removing. The volume is currently removing. ◆ creating. The volume is currently creating. ◆ copy_source. The volume is a copy source. ◆ unknown. The volume state is unknown. InForm OS Version 2.3.
~~PAGE 691~~
InForm OS Version 2.3.1 ◆ Command Line Interface Reference -. Since the VV is Type vcopy (snapshot) it is the provisioning that is associated with the base VV. ■ ■ Type. Indicates the copy type of virtual volume and can be one of the following: ◆ base. Base volume (not a copy). ◆ pcopy. Physical copy (full copy). ◆ vcopy. Snapshot copy (virtual copy). Adm_RawRsvd_MB. Raw (including RAID overhead) Adm reserved space in MB (1024^2 bytes). ■ Adm_Rsvd_MB.
~~PAGE 692~~
Command Line Interface Reference InForm OS Version 2.3.1 ■ Grown_Snp_MB. The amount of snapshot space that the volume has grown. ■ Grown_Snp_SD_MB. The amount of snapshot SD space that the volume has grown. ■ Reclaimed_Adm_MB. The amount of administrator space that the volume has had reclaimed. ■ Reclaimed_Snp_MB. The amount of snapshot space that the volume has had reclaimed. ■ Reclaimed_Snp_SD_MB. The amount of snapshot SD space that the volume has had reclaimed. ■ Name.
~~PAGE 693~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvvmap DESCRIPTION The showvvmap command displays information about how Virtual Volume (VV) regions are mapped to logical disks. SYNTAX showvvmap AUTHORITY Super, Service, Edit, Browse OPTIONS None. SPECIFIERS Specifies the VV name, using up to 31 characters in length. RESTRICTIONS None.
~~PAGE 694~~
Command Line Interface Reference InForm OS Version 2.3.1 The columns in the previous example are identified as follows: ■ Space. The type of the space (user (usr), snapshot data (snp), or snapshot administration (adm) for which the region is being used followed by the ID of the region. The number to the right of the space type are the chunklets for each space. ■ Start(MB). The offset from the beginning of the region, in MB. ■ Length(MB). The length, or size, of the region in MB. ■ LdId.
~~PAGE 695~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND showvvpd DESCRIPTION The showvvpd command displays Virtual Volume (VV) distribution across Physical Disks (PDs). SYNTAX showvvpd [option ] {}... AUTHORITY Super, Service, Edit, Browse OPTIONS –sortcol [,
~~][:[,]...] Sorts command output based on the column number (). Columns are numbered from left to right, beginning with 0. You must specify a column number.~~
~~PAGE 696~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays information about multiple VVs. In this case multi.0, multi.1, multi.2 and multi.3 were created using the -cnt 4 option. Using multi.*, the aggregate chunklets for all the physical disks is displayed: cli% showvvpd multi.
~~PAGE 697~~
InForm OS Version 2.3.1 Command Line Interface Reference For the example above, if you only specified a single volume you would get the same result. That is because the four VVs are interleaved across the same logical disks and share the same chunklets. The following example displays the distribution of space for a single VV (multi.0): cli% showvvpd multi.
~~PAGE 698~~
~~Command Line Interface Reference InForm OS Version 2.3.~~
~~PAGE 699~~
InForm OS Version 2.3.1 Command Line Interface Reference for all the VVs that match the or list. This can be useful in determining how evenly the VV is striped across the disks. ■ Not all the data in the chunklets is necessarily allocated exclusively to the selected VV. In some cases, only part of a chunklet could be data that is allocated for the VVs. 22.
~~PAGE 700~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND showvvset DESCRIPTION The showvvset command lists the Virtual Volume (VV) sets defined on the InServ and their members. SYNTAX showvvset [options] [...] showvvset -vv [options] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Show a more detailed listing of each set. -vv Show VV sets that contain the supplied vvnames or patterns SPECIFIERS ...
~~PAGE 701~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES To show all VV sets defined to the system: cli% showvvset Id Name Members 0 oravv oravv.0 oravv.1 oravv.2 oravv.3 oravv.4 oravv.5 oravv.6 oravv.7 oravv.8 oravv.9 20 sia-1 test ttpvv.rw test-sv bar Show the sia-1 set only, with detail: cli% showvvset -d sia-1 20 sia-1 test This set has a comment ttpvv.rw test-sv bar Show VV sets containing VVs matching test*: cli% showvvset -vv test* Id Name Members 20 sia-1 test ttpvv.
~~PAGE 702~~
~~Command Line Interface Reference 22.226 InForm OS Version 2.3.~~
~~PAGE 703~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 23 Shutdown Commands In this chapter shutdownnode 23.2 shutdownsys 23.4 Shutdown Commands 23.~~
~~PAGE 704~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND shutdownnode DESCRIPTION The shutdownnode command shuts down a system node. SYNTAX shutdownnode halt|reboot [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Forces the operation so that the command does not require confirmation before proceeding. SPECIFIERS Specifies the node, identified by its ID, to be shut down.
~~PAGE 705~~
InForm OS Version 2.3.1 ■ Command Line Interface Reference If any of the following conditions exists, the shutdown operation will not proceed: ◆ The system software upgrade is in progress. ◆ The target node is not online. ◆ The system is processing tasks that should not be interrupted, such as tunevv and remote copy related tasks. ◆ If any other node is online but not yet integrated into the cluster. ◆ If another shutdown node operation is already in progress.
~~PAGE 706~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND shutdownsys DESCRIPTION The shutdownsys command shuts down an entire system. SYNTAX shutdownsys halt|reboot AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. SUBCOMMANDS halt Specifies that the system should be halted after shutdown. If this subcommand is not specified, the reboot subcommand must be used. reboot Specifies that the system should be restarted after shutdown.
~~PAGE 707~~
~~InForm OS Version 2.3.~~
~~PAGE 708~~
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ The execution of shutdownsys command can affect service. Hence, a confirmation is required before proceeding with this command. ■ After the shutdownsys command is issued, there is no indication from the CLI that the shutdown is occurring. You can issue the showsys command (showsys on page 22.171) to display the current status of the system during the initial stage of the shutdown process and after the system has fully restarted.
~~PAGE 709~~
InForm OS Version 2.3.1 Command Line Interface Reference 24 Start Commands In this chapter startcim 24.2 startld 24.3 startrcopy 24.4 startrcopygroup 24.5 starttask 24.7 startvv 24.8 Start Commands 24.
~~PAGE 710~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startcim DESCRIPTION The startcim command starts the CIM server to service CIM requests. By default, the CIM server is not started until this command is issued. SYNTAX startcim AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS Access to all domains is required to run this command.
~~PAGE 711~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND startld DESCRIPTION The startld command starts data services on a Logical Disk (LD) that has not yet been started. SYNTAX startld [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the LD is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the LD name, using up to 31 characters.
~~PAGE 712~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startrcopy DESCRIPTION The startrcopy command starts the Remote Copy Service. SYNTAX startrcopy AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. OPTIONS None. SPECIFIERS None. RESTRICTIONS This command requires the 3PAR Remote Copy license. Contact your local service provider for more information.
~~PAGE 713~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND startrcopygroup DESCRIPTION The startrcopygroup command enables Remote Copy for the specified Remote Copy volume group. SYNTAX startrcopygroup [options ] AUTHORITY Super, Edit OPTIONS –nosync Prevents the initial synchronization and sets the virtual volumes to a synchronized state. –wait Specifies that the command waits until the initial synchronization is completed.
~~PAGE 714~~
Command Line Interface Reference InForm OS Version 2.3.1 NOTES ■ If a group’s target has the mirror_config policy set and the group is a primary group, then this command is mirrored to that target and the corresponding secondary group is started. If the policy is set and the group is a secondary, then this command fails. ■ If the mirror_config policy is not set, then the corresponding secondary group must already be started or this command fails.
~~PAGE 715~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND starttask DESCRIPTION The starttask command provides users with the ability to execute commands with long running times. The commands run in the background. SYNTAX starttask AUTHORITY Super, Service OPTIONS None. SPECIFIERS Specifies the command to be run by the starttask command. RESTRICTIONS None.
~~PAGE 716~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND startvv DESCRIPTION The startvv command starts data services on a Virtual Volume (VV) that has not yet been started. SYNTAX startvv [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –ovrd Specifies that the logical disk is forced to start, even if some underlying data is missing. SPECIFIERS Specifies the VV name, using up to 31 characters.
~~PAGE 717~~
InForm OS Version 2.3.1 Command Line Interface Reference 25 Stat Commands In this chapter statch 25.2 statcmp 25.7 statcpu 25.10 statiscsi 25.12 statiscsisession 25.16 statld 25.18 statlink 25.23 statpd 25.25 statport 25.33 statrcopy 25.39 statvlun 25.42 statvv 25.48 Stat Commands 25.
~~PAGE 718~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statch DESCRIPTION The statch command displays chunklet statistics in a timed loop. SYNTAX statch [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483.
~~PAGE 719~~
InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified and separated by a colon (:). Rows that have the same information in them as earlier columns will be sorted by values in later columns. –filt Specifies that statistics that fall below the threshold as specified by the arguments, where is , , , , are filtered out and not displayed.
~~PAGE 720~~
Command Line Interface Reference InForm OS Version 2.3.1 The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument.
~~PAGE 721~~
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays the collection of statistics: cli% statch -iter 1 12:47:54 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Ldid Ldname LdCh Pdid PdCh Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg ----------------------------------------------------------------------------------------total t 0 0 0 0 0.0 0.0 0.0 0.
~~PAGE 722~~
Command Line Interface Reference ■ Qlen. The queue length. ■ Util % Cur. The percentage of current use. ■ Util % Avg. The percentage of average use. InForm OS Version 2.3.1 NOTES ■ For this command: KB = 1000 bytes. ■ If no options are used, the command defaults to show reads, writes, and totals separately for all chunklets in intervals of 2 seconds. ■ The statch command can only be used after the setstatch command has been issued to enable chunklet statistics. See page 21.
~~PAGE 723~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statcmp DESCRIPTION The statcmp command displays Cache Memory Page (CMP) statistics by node or by Virtual Volume (VV). SYNTAX statcmp [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Specifies that CMP statistics by VV instead of by node are displayed. By default, all VVs are displayed unless the –n option is specified.
~~PAGE 724~~
~~Command Line Interface Reference InForm OS Version 2.3.1 RESTRICTIONS None.~~
~~PAGE 725~~
InForm OS Version 2.3.1 Command Line Interface Reference ■ WrtSched. Number of pages scheduled to be written to disk. ■ Writing. Number of pages being currently written by the flusher to disk. ■ RecFlush. During node down, number of recovered pages currently being written by the flusher to disk. ■ LockBlk. Number of pages being modified by host I/O that are temporarily blocked because page is being written to disk by the flusher. NOTES ■ Patterns are specified as regular expressions.
~~PAGE 726~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statcpu DESCRIPTION The statcpu command displays CPU statistics for all nodes. SYNTAX statcpu [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 727~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays two iterations of CPU statistics for all nodes: cli% statcpu –iter 2 15:11:03 node,cpu user sys idle intr/s ctxt/s 0,0 0 0 100 0,1 0 0 100 0,total 0 0 100 162 412 1,0 0 1 99 1,1 0 1 99 1,total 0 1 99 158 Press the enter key to stop... 15:11:05 node,cpu 0,0 0,1 0,total user sys 0 0 19 7 10 4 1,0 0 0 1,1 0 0 1,total 0 0 Press the enter key 269 idle intr/s ctxt/s 100 74 87 183 444 100 100 100 158 to stop...
~~PAGE 728~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statiscsi DESCRIPTION The statiscsi command displays the iSCSI statistics. SYNTAX statiscsi [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined of iterations. -nodes List of nodes for which the ports are included. -slots List of PCI slots for which the ports are included.
~~PAGE 729~~
InForm OS Version 2.3.1 Command Line Interface Reference This option cannot be used with the -prot option. If the -fullcounts option is not specified, the metrics from the start of the command are displayed. -prot [,,...] Shows the statistics for the specified protocols. The available protocols are: ◆ Eth - Ethernet. ◆ IP - Internet Protocol (IP). ◆ TCP - Transmission Control Protocol (TCP). ◆ iSCSI - iSCSI. ◆ all - All protocols (default).
~~PAGE 730~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays basic iSCSI statistics collection: cli% statiscsi 16:37:59 04/06/06 ----Receive---- ---Transmit---- -----Total----port Protocol Pkts/s KBytes/s Pkts/s KBytes/s Pkts/s KBytes/s Errs/s 0:4:1 Eth 15633.2 1116.7 30115.9 45164.4 45749.1 46281.1 0.0 0:4:1 IP 15632.7 522.6 30116.4 44020.8 45749.1 44543.3 0.0 0:4:1 TCP 15632.7 22.3 30116.4 43057.0 45749.1 43079.4 0.0 0:4:1 iSCSI 547.7 0.0 1477.3 50452.8 2025.0 50452.
~~PAGE 731~~
InForm OS Version 2.3.1 Command Line Interface Reference NOTES The statistics for the TCP, IP, and iSCSI protocols listed are the combined values for both ports of the HBA. Each port reports the combined stats for both ports for these protocols. The total reported at the bottom for these protocols is therefore twice the actual values. 25.
~~PAGE 732~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statiscsisession DESCRIPTION The statiscsisession command displays the iSCSI session statistics. SYNTAX statiscsisession [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -d Looping delay in seconds . The default is 2. -iter The command stops after a user-defined number of iterations. -nodes List of nodes for which the ports are included.
~~PAGE 733~~
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS None. RESTRICTIONS None. EXAMPLES The following example displays the session statistics for the iSCSI: cli% statiscsisession 15:31:35 04/04/06 --From start of statiscsisession command------PDUs/s---- --KBytes/s--- ----Errs/s---port ----------------------iSCI_Name---------------------- TPGT Cmd Resp Total Tx Rx Total Digest TimeOut 1:3:1 iqn.1991-05.com.microsoft:dt-ashok-xp.hq.3pardata.com 131 1.0 1.0 2.0 4.0 0.0 4.0 0.0 0.
~~PAGE 734~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statld DESCRIPTION The statld command displays read/write (I/O) statistics about Logical Disks (LDs) in a timed loop. SYNTAX statld [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -vv {}... Show only LDs that are mapped to Virtual Volumes (VVs) with names matching any of names or patterns specified.
~~PAGE 735~~
InForm OS Version 2.3.1 Command Line Interface Reference –begin Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Specifies the percent of idle columns in the output. –sortcol [,
~~][:[,]...] Sorts command output based on the column number . Columns are numbered from left to right, beginning with 0. You must specify a column number.~~
~~PAGE 736~~
Command Line Interface Reference InForm OS Version 2.3.1 The operation argument can be specified with one of the following arguments: r Specifies that read-only statistics are displayed. w Specifies that write-only statistics are displayed. t|rw Specifies that statistics for read and write totals are displayed. The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed.
~~PAGE 737~~
InForm OS Version 2.3.1 Command Line Interface Reference SPECIFIERS ... Only statistics are displayed for the specified LD or pattern. Multiple LDs or patterns can be repeated (for example ...). RESTRICTIONS None. EXAMPLES The following example displays one iteration of I/O statistics for all LDs: cli% statld -iter 1 13:03:04 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Ldname Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg log0.
~~PAGE 738~~
Command Line Interface Reference ■ Svt ms Max. The maximum service time in milliseconds. ■ Svt ms Cur. The current service time in milliseconds. ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. ■ Util % Cur. The percentage of current use. ■ Util % Avg. The percentage of average use. InForm OS Version 2.3.1 NOTES ■ For this command: KB = 1000 bytes.
~~PAGE 739~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statlink DESCRIPTION The statlink command displays statistics for link utilization for all nodes in a timed loop. SYNTAX statlink [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 740~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example displays one iteration of statistics for the internode link: cli% statlink –iter 1 11:37:28 03/11/08 XCB_sent_per_second KBytes_per_second XCBSz_KB Node Q ToNode Cur Avg Max Cur Avg Max Cur Avg 0 CM 0 15134 14911 15134 61951 61038 61951 4.1 4.1 0 PCI0 0 22336 21852 22336 79831 77128 79831 3.6 3.5 0 PCI1 1 15312 12103 19805 62106 63198 77324 4.0 4.1 0 L0 1 10339 10307 10339 69673 69384 69673 6.7 6.7 1 1 1 1 NOTES None.
~~PAGE 741~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statpd DESCRIPTION The statpd command displays the read/write (I/O) statistics for physical disks in a timed loop. SYNTAX statpd [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –w Specifies that statistics for a particular Physical Disk (PD) identified by World Wide Names (WWNs) are displayed. –nodes Specifies that the display is limited to specified nodes and PDs connected to those nodes.
~~PAGE 742~~
Command Line Interface Reference InForm OS Version 2.3.1 –rw Specifies that reads and writes are displayed separately. If this option is not used, then the total of reads plus writes is displayed. –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 743~~
InForm OS Version 2.3.1 Command Line Interface Reference The type argument can be specified with one of the following arguments: curs Specifies that only devices with current statistics above the threshold are displayed. avgs Specifies that only devices with average statistics above the threshold are displayed. maxs Specifies that only devices with maximum values above the threshold are displayed.
~~PAGE 744~~
Command Line Interface Reference InForm OS Version 2.3.1 size Specifies that statistics for I/O operations in bytes are displayed. [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer. The integer can be optionally followed with k or K to indicate a multiple of 1,000, m or M to indicate a multiple of 1,000,000, or g or G to indicate a multiple of 1,000,000,000.
~~PAGE 745~~
InForm OS Version 2.3.1 Command Line Interface Reference –pt Specifies one or more ports. Ports are identified by one or more integers (). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–4). The primary path of the disks must be on the specified port(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (). Multiple drive cages are separated with a single comma (1,2,3).
~~PAGE 746~~
Command Line Interface Reference InForm OS Version 2.3.1 –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected. –fc_lt Specifies that physical disks with free chunklets less than the number specified are selected. –devid Specifies that physical disks identified by their models are selected.
~~PAGE 747~~
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS None. EXAMPLES The following example displays one iteration of I/O statistics for all PDs: cli% statpd -iter 1 16:03:44 04/06/06 r/w I/O per second KBytes per sec Svt ms IOSz KB Util % Pdid Port Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen Cur Avg 0 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 1 0:0:2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 2 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0 0 4 1:0:1 t 0 0 0 0 0 0 0.0 0.0 0.0 0.
~~PAGE 748~~
Command Line Interface Reference ■ KBytes per Max. The maximum number of KB per second. ■ KBytes per Cur. The current number of KB per second. ■ KBytes per Avg. The average number of KB per second. ■ Svt ms Max. The maximum service time in milliseconds. ■ Svt ms Cur. The current service time in milliseconds. ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. ■ Util % Cur.
~~PAGE 749~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statport DESCRIPTION The statport command displays read/write (I/O) statistics for ports. SYNTAX statport [options] AUTHORITY Super, Service, Edit, Browse OPTIONS –both|–ctl|–data Show data transfers only (–data), control transfers only (–ctl), or both data and control transfers (–both). If no option is included on the command line, the command shows data transfers only.
~~PAGE 750~~
Command Line Interface Reference InForm OS Version 2.3.1 –host|-disk|-rcfc Specifies to display only host ports (target ports), only disk ports (initiator ports), or only Fibre Channel Remote Copy configured ports. If no option is specified, all ports are displayed. –rcip Includes only statistics for Ethernet configured Remote Copy ports. –rw Specifies that the display includes separate read and write data. If not specified, the total is displayed.
~~PAGE 751~~
InForm OS Version 2.3.1 Command Line Interface Reference –filt Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed. The –filt option applies to data transfers only. The , , , and arguments are separated with one comma.
~~PAGE 752~~
Command Line Interface Reference InForm OS Version 2.3.1 bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the argument. svct Specifies that statistics for service time in milliseconds are displayed. size Specifies that statistics for I/O operations in bytes are displayed. [k|K]|[m|M]|[g|G] Specifies the minimum threshold using any integer.
~~PAGE 753~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays one iteration of I/O statistics for all ports: cli% statport -iter 1 10:38:56 09/14/09 r/w I/O per second KBytes per sec Svt ms IOSz KB Port D/C Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen 0:0:1 Data t 2 2 2 34 34 34 13.0 13.0 17.4 17.4 0 0:0:2 Data t 0 0 0 4 4 4 8.2 8.2 8.2 8.2 0 0:2:1 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0:2:2 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 0:3:1 Data t 0 0 0 0 0 0 0.0 0.0 0.0 0.
~~PAGE 754~~
Command Line Interface Reference ■ Errs. Number of errors on the port. ■ Drops. Number of dropped packets. InForm OS Version 2.3.1 NOTES 25.38 ■ For this command: KB = 1000 bytes. ■ The -filt option applies only to data transfers and not control transfers.
~~PAGE 755~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND statrcopy DESCRIPTION The statrcopy command displays statistics for Remote Copy links. SYNTAX statrcopy [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS –d Specifies the interval, in seconds, that statistics are sampled using an integer from 1 through 2147483. If no interval is specified, the option defaults to an interval of two seconds.
~~PAGE 756~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES The following example shows statistics for sending links link0 and link1: cli% statrcopy 17:37:01 05/17/07 -Throughput(KBytes per sec)Target Node Address IPC Total(KBytes) Current Average --------------------------------------------------------------------------amp1 0 10.100.33.96 RCs041 404761.15 4.95 4.95 amp1 1 10.101.33.96 RCs142 404661.63 3.30 3.30 --------------------------------------------------------------------------amp1 809422.
~~PAGE 757~~
InForm OS Version 2.3.1 Command Line Interface Reference NOTES ■ This command repeats until directed to stop. ■ Within the context of this command, KB is 1000 bytes, MB is 1000KB, and GB is 1000MB. ■ The numbers displayed by this command might be somewhat less than those displayed with statport, as statrcopy output does not include TCP/IP overhead 25.
~~PAGE 758~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statvlun DESCRIPTION The statvlun command displays statistics for Virtual Volumes (VVs) and Logical Unit Number (LUN) host attachments. SYNTAX statvlun [options ] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only Virtual Volume Logical Unit Number (VLUNs) whose VVs are in domains with names that match one or more of the specified domain names or patterns.
~~PAGE 759~~
InForm OS Version 2.3.1 Command Line Interface Reference (1,2,3). The list can also consist of a single integer (1). If the node_list is not specified, all disks on all nodes are displayed. –slots Specifies that the display is limited to specified PCI slots and PDs connected to those PCI slots. The slot_list is specified as a series of integers separated by commas (1,2,3). The list can also consist of a single integer (1).
~~PAGE 760~~
Command Line Interface Reference InForm OS Version 2.3.1 –iter Specifies that the histogram is to stop after the indicated number of iterations using an integer from 1 through 2147483647. –begin Specifies that I/O averages are computed from the system start time. If not specified, the average is computed since the first iteration of the command. –idlep Includes a percent idle columns in the output. –sortcol [,
~~][:[,]...~~
~~PAGE 761~~
InForm OS Version 2.3.1 Command Line Interface Reference maxs Specifies that only devices with maximum values above the threshold are displayed. The argument can be specified with one of the following arguments: r Specifies that read-only statistics are displayed. w Specifies that write-only statistics are displayed. t|rw Specifies that statistics for read and write totals are displayed.
~~PAGE 762~~
Command Line Interface Reference InForm OS Version 2.3.1 –ni Specifies that statistics for only nonidle devices are displayed. This option is shorthand for the option –filt curs,t,iops,0. SPECIFIERS None. RESTRICTIONS None.
~~PAGE 763~~
InForm OS Version 2.3.1 ■ Svt ms Avg. The average service time in milliseconds. ■ IOSz KB Cur. The current I/O size in KB. ■ IOSz KB Avg. The average I/O size in KB. ■ Qlen. The queue length. Command Line Interface Reference NOTES ■ For this command: KB = 1000 bytes. ■ A Domain column may be included by using the setclienv command to set listdom to 1.
~~PAGE 764~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND statvv DESCRIPTION The statvv command displays statistics for Virtual Volumes (VVs) in a timed loop. SYNTAX statvv [options ] [...] AUTHORITY Super, Service, Edit, Browse OPTIONS -domain ... Shows only the VVs that are in domains with names that match the specified domain names or patterns. –rw Specifies that the display includes separate read and write data.
~~PAGE 765~~
InForm OS Version 2.3.1 Command Line Interface Reference inc Sort in increasing order (default). dec Sort in decreasing order. Multiple columns can be specified separated by a colon (:) Rows with the same information in them as earlier columns will be sorted by the values in the later columns. –filt Specifies that statistics that fall below the threshold as specified by the arguments where is , , , , are filtered out and not displayed.
~~PAGE 766~~
Command Line Interface Reference InForm OS Version 2.3.1 The meas argument can be specified with one of the following arguments: iops Specifies that I/O operations per second are displayed. If this argument is used, the minimum threshold value must be specified using the value argument. bw Specifies that statistics for bandwidth in bytes per second are displayed. If this argument is used, the minimum threshold value must be specified using the value argument.
~~PAGE 767~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays I/O statistics for all VVs: cli% statvv -iter 1 15:31:21 05/31/07 r/w I/O per second KBytes per sec Svt ms IOSz KB VVname Cur Avg Max Cur Avg Max Cur Avg Cur Avg Qlen admin t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 test2 t 0 0 0 0 0 0 0.0 0.0 0.0 0.0 0 -----------------------------------------------------------------------total t 0 0 0 0 0.0 0.0 0.0 0.
~~PAGE 768~~
Command Line Interface Reference ■ InForm OS Version 2.3.1 In addition to external accesses by hosts, VVs may be read internally by the system readahead prefetcher. The histvv data includes read-ahead accesses from the prefetcher, which can cause the read data to appear more than seen by the hosts. Use the histvlun -vvsum command to see data for only accesses from the host. ■ 25.52 For this command KB = 1000 bytes.
~~PAGE 769~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 26 Stop Commands In this chapter stopcim 26.2 stoprcopy 26.4 stoprcopygroup 26.6 Stop Commands 26.~~
~~PAGE 770~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stopcim DESCRIPTION The stopcim command stops the CIM server from servicing CIM requests. SYNTAX stopcim [option] AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Specifies that the operation is forced. If this option is not used, the command requires confirmation before proceeding with its operation.
~~PAGE 771~~
InForm OS Version 2.3.1 Command Line Interface Reference The following example stops the CIM server immediately without graceful shutdown notice and confirmation: cli% stopcim -f -x CIM server stopped successfully. NOTES By default, the CIM server is not started until the startcim command is issued. 26.
~~PAGE 772~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stoprcopy DESCRIPTION The stoprcopy command stops the Remote Copy service and optionally stops any started Remote Copy volume groups. AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command. SYNTAX stoprcopy [options] OPTIONS –f Specifies that any started copy will not ask for confirmation for the -clear option. –stopgroups Specifies that any started Remote Copy volume groups are stopped.
~~PAGE 773~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example disables the Remote Copy functionality of all primary Remote Copy volume groups: cli% stoprcopy –stopgroups NOTES ■ Unless the -stopgroups option is used, the command will fail if there are any Remote Copy groups that are started. If the -clear option has been used, the configuration is completely erased. Consequently, Remote Copy operations can not be restarted using only the startrcopy command.
~~PAGE 774~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND stoprcopygroup DESCRIPTION The stoprcopygroup command stops the Remote Copy functionality for the specified Remote Copy volume group. SYNTAX stoprcopygroup [options] AUTHORITY Super, Edit OPTIONS –nosnap In synchronous mode, this option turns off the creation of snapshots. This is useful if removercopygroup is to be run to remove Remote Copy.
~~PAGE 775~~
InForm OS Version 2.3.1 Command Line Interface Reference NOTES In sync mode, this command creates snapshots that are used for synchronizing the primary and secondary groups if startrcopygroup is run later. 26.
~~PAGE 776~~
~~Command Line Interface Reference 26.8 InForm OS Version 2.3.~~
~~PAGE 777~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 27 Sync Command In this chapter syncrcopy 27.2 Sync Command 27.~~
~~PAGE 778~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND syncrcopy DESCRIPTION The syncrcopy command manually synchronizes Remote Copy volume groups. SYNTAX syncrcopy [options] AUTHORITY Super, Edit OPTIONS –w Wait for synchronization to complete before returning to a command prompt. –n Do not save resynchronization snapshot. This option is only relevant for asynchronous periodic mode volume groups. NOTE: Using the -n option requires a full synchronization at the next sync.
~~PAGE 779~~
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS ■ This command requires the 3PAR Remote Copy license. Contact your local service provider for more information. ■ Using the -n option requires a full synchronization at the next sync.
~~PAGE 780~~
~~Command Line Interface Reference 27.4 InForm OS Version 2.3.~~
~~PAGE 781~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 28 Tune Commands In this chapter tunealdvv 28.2 tunepd 28.10 tunetpvv 28.15 tunevv 28.18 Tune Commands 28.~~
~~PAGE 782~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunealdvv DESCRIPTION This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the tunevv command in the future. If virtual volumes were created with deprecated commands then only deprecated commands can be used to modify virtual volumes. The tunealdvv command changes the layout of a virtual volume.
~~PAGE 783~~
InForm OS Version 2.3.1 Command Line Interface Reference OPTIONS The following options can be used on all commands: –f Forces the command. The command completes without prompting for confirmation. –waittask Specifies that the command will wait for any created tasks to complete. The following options cannot be used with the restart or rollback subcommands: –cpg Name of the Common Provisioning Group (CPG) to which the snapshot data space is moved.
~~PAGE 784~~
Command Line Interface Reference InForm OS Version 2.3.1 –ss Specifies the step size from 32 KB to 512 KB. The step size should be a power of 2 and a multiple of 32. If no value is entered, the step size defaults to 256 KB for RAID-0 and RAID-1, and 128 KB for RAID-5. For RAID-6, the default is a function of the set size. –ha port|cage|mag Specifies that the layout must support the failure of one port pair, one cage, or one drive magazine (mag). This option has no meaning for RAID-0.
~~PAGE 785~~
InForm OS Version 2.3.1 Command Line Interface Reference –pt Specifies one or more ports. Ports are identified by one or more integers (). Multiple ports are separated with a single comma (1,2,3). A range of ports is separated with a hyphen (0–5). The primary path of the disks must be on the specified port number(s). –cg Specifies one or more drive cages. Drive cages are identified by one or more integers (). Multiple drive cages are separated with a single comma (1,2,3).
~~PAGE 786~~
Command Line Interface Reference InForm OS Version 2.3.1 –tc_gt Specifies that physical disks with total chunklets greater than the number specified are selected. –tc_lt Specifies that physical disks with total chunklets less than the number specified are selected. –fc_gt Specifies that physical disks with free chunklets greater than the number specified are selected.
~~PAGE 787~~
InForm OS Version 2.3.1 Command Line Interface Reference –wait If the tunealdvv command fails due to the lack of clean space, the -wait option specifies the number of seconds to wait for the system to clean the dirty space before returning. If -wait 0 is issued, the command returns immediately. If this option is not used, the command will keep waiting for dirty chunklets to be cleaned if enough space will be available with the dirty chunklets cleaned.
~~PAGE 788~~
Command Line Interface Reference ■ InForm OS Version 2.3.1 This command requires sufficient available physical space, equivalent to the user size of the volume being tuned. ■ When changing the layout of a virtual volume, you can optionally apply arguments originally defined for logical disk creation through the createtemplate command by issuing the tunealdvv -templ command. The -templ option is only valid for logical disk template object types.
~~PAGE 789~~
InForm OS Version 2.3.1 Command Line Interface Reference cli% canceltask 1 Are you sure you want to cancel task 1? select q=quit y=yes n=no: y cli% tunealdvv –restart testvol Task 2 started. NOTES ■ This command was deprecated in the 2.2.4 release and will be changed or removed in a future release. Please use the tunevv command in the future. ■ Automatic chunklet selection for relocations will prefer selection of chunklets on physical disks with the same device type as the source.
~~PAGE 790~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunepd DESCRIPTION The tunepd command identifies physical disks with high service times and optionally executes load balancing. SYNTAX The syntax for the tunepd command can be one of the following: ■ tunepd [options ] maxsvct |highest ■ tunepd [options ] avgsvct |highest AUTHORITY Super, Edit NOTE: You need access to all domains in order to run this command.
~~PAGE 791~~
InForm OS Version 2.3.1 Command Line Interface Reference –ports Specifies that the display is limited to specified port slots and physical disks connected to those port slots. The port list is specified as a series of integers separated by commas (1,2,3). A list can also consist of a single integer (1). If the port list is not specified, all disks on all ports are displayed.
~~PAGE 792~~
Command Line Interface Reference InForm OS Version 2.3.1 –maxpd Specifies that only the indicated number of physical disks with high service times are displayed. If this option is not specified, 10 PDs are displayed. –movech auto|manual Specifies that if any disks with unbalanced loads are detected that chunklets are moved from those disks for load balancing. auto Specifies that the system chooses source and destination chunklets.
~~PAGE 793~~
InForm OS Version 2.3.1 ■ Command Line Interface Reference Use the –chstat force option only when you have verified that no other tunepd processes are running. EXAMPLES In the following example, PDs with average service times exceeding 50 milliseconds are identified and their chunklets automatically relocated to rebalance the PDs’ load. cli% tunepd –vvlayout –chstat –movech auto avgsvct 50 Collecting I/O statistic for physical disks (PDs) ...
~~PAGE 794~~
~~Command Line Interface Reference InForm OS Version 2.3.~~
~~PAGE 795~~
InForm OS Version 2.3.1 Command Line Interface Reference COMMAND tunetpvv DESCRIPTION This command was deprecated in the 2.2.3 release and will be changed or removed in a future release. Please use the tunevv command in the future. If Virtual Volumes (VVs) were created with deprecated commands then only deprecated commands can be used to modify VVs. The tunetpvv command allows the RAID and Availability characteristics of an exiting Thin Provisioned Virtual Volume (TPVV) to be dynamically modified.
~~PAGE 796~~
Command Line Interface Reference InForm OS Version 2.3.1 –dr Specifies that the command is a dry run and that no logical disks or Virtual Volumes (VVs) are actually tuned. –cnt Specifies the number of identical VVs to tune using an integer from 1 through 999. The default will tune one VV. The following option is only used for tuning a legacy single-space TPVV: –cpg Specifies the CPG to which the snapshot data space is moved. This option is not valid with either subcommands.
~~PAGE 797~~
InForm OS Version 2.3.1 Command Line Interface Reference The following example shows how to use the tunetpvv command to increase the availability level of a TPVV (testvol). Note that there is mag availability because testvol was originally on cpg1, which is created with option (–ha mag). To increase cage availability, create a CPG with cage availability and tune testvol to the associated CPG.
~~PAGE 798~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND tunevv DESCRIPTION The tunevv command is used to change the properties of a virtual volume that was created with either the createvv or createtpvv command by associating it with a different Common Provisioning Group.
~~PAGE 799~~
InForm OS Version 2.3.1 Command Line Interface Reference rollback Returns to a previously issued tunevv operation call that was interrupted. The canceltask command needs to run before the rollback. This cannot be used on Thinly Provisioned Virtual Volumes. OPTIONS –f Forces the command. The command completes without prompting for confirmation. –waittask Specifies that the command will wait for any created tasks to complete.
~~PAGE 800~~
Command Line Interface Reference InForm OS Version 2.3.1 EXAMPLES In the following example, the LDs used for user space are moved to CPG cpg_sn1.0_p for VV nf_st_tp_22.0: cli% tunevv usr_cpg cpg_sn1.0_p nf_st_tp_22.0 Task 999 started NOTES When canceling a tunevv command task, the canceltask command can return before a cancellation is completed. Therefore, resources reserved for the task might not be immediately available. This can prevent actions such as restarting the canceled tunevv command task.
~~PAGE 801~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 29 Update Commands In this chapter updatesnapspace 29.2 updatevv 29.4 Update Commands 29.~~
~~PAGE 802~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND updatesnapspace DESCRIPTION The updatesnapspace command starts a non-cancelable task to update the snapshot space usage accounting. The snapshot space usage displayed by showvv -snapspace is not necessarily the current usage and the TimeCalculated column will show when it was last calculated. This command causes the system to start calculating current snapsnot space usage.
~~PAGE 803~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the actual snapshot space used by all VVs: cli% updatesnapspace Task 2 has been started to calculate actual space usage.
~~PAGE 804~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND updatevv DESCRIPTION The updatevv command updates a snapshot Virtual Volume (VV) with a new snapshot. SYNTAX updatevv [options] ... AUTHORITY Super, Edit, Browse OPTIONS –ro Specifies that if the specified VV () is a read/write snapshot the snapshot’s read-only parent volume is also updated with a new snapshot if the parent volume is not a member of a virtual volume set.
~~PAGE 805~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example displays the snapshot update of snapshot VV avvro: cli% updatevv –f avvro Updating VV avvro NOTES ■ The updatevv command attempts to use the same VV IDs for new snapshots as the snapshots that they replace so that the new VV have the same World Wide Names (WWNs) as the originals (this might be important for hosts using the VV WWN to identify the VV).
~~PAGE 806~~
~~Command Line Interface Reference 29.6 InForm OS Version 2.3.~~
~~PAGE 807~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 30 Upgrade Commands In this chapter upgradecage 30.2 upgradepd 30.4 Upgrade Commands 30.~~
~~PAGE 808~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND upgradecage DESCRIPTION The upgradecage command downloads new firmware into the specified cage. SYNTAX The syntax for the upgradecage command can be one of the following: ■ upgradecage [options ] ... ■ upgradecage [options ] -a AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command.
~~PAGE 809~~
InForm OS Version 2.3.1 Command Line Interface Reference –file Use firmware in file , where is the full path name of the file on the node. The default is to use the firmware that is marked current in the firmware database (see the showfirmwaredb command). –minlevel Minimum firmware level that the cage firmware must be at for the upgrade to be allowed. This option is deprecated and will be removed in a future release.
~~PAGE 810~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND upgradepd DESCRIPTION The upgradepd command upgrades the Physical Disk (PD) firmware. SYNTAX upgradepd [-f] [-skiptest] {-a | -w ... | ...} AUTHORITY Super, Service NOTE: You need access to all domains in order to run this command. OPTIONS –f Upgrades the PD firmware without requiring confirmation. –skiptest Skips the 10 second diagnostic test normally completed after each PD upgrade.
~~PAGE 811~~
InForm OS Version 2.3.1 Command Line Interface Reference RESTRICTIONS Access to all domains is required to run this command. EXAMPLES The following example displays the upgrade of all PDs: cli% upgradepd –a NOTES ■ PDs can be upgraded while I/O is occurring. ■ If a disk with RAID-0 chunklets is upgraded, I/O to those chunklets at the time of the upgrade results in data loss. This is not applicable to other RAID types. ■ Specify the –w option when upgrading unadmitted PDs. 30.
~~PAGE 812~~
~~Command Line Interface Reference 30.6 InForm OS Version 2.3.~~
~~PAGE 813~~
~~InForm OS Version 2.3.1 Command Line Interface Reference 31 Wait Command In this chapter waittask 31.2 Wait Command 31.~~
~~PAGE 814~~
Command Line Interface Reference InForm OS Version 2.3.1 COMMAND waittask DESCRIPTION The waittask command asks the CLI to wait for a task to complete before proceeding. The command automatically notifies you when the specified task is finished. SYNTAX The syntax for the waittask command can be one of the following: waittask –v waittask [...] AUTHORITY Super, Service, Edit, Browse OPTIONS –v Displays the detailed status of the task specified by as it executes.
~~PAGE 815~~
InForm OS Version 2.3.1 Command Line Interface Reference EXAMPLES The following example shows how to wait for a task using the task ID. When successful, the command returns only after the task is complete. cli% waittask 1 Task 1 done NOTES ■ See the InForm OS CLI Administrator’s Manual for additional information and examples regarding task management and task management commands. ■ This command returns an error if any of the tasks it is waiting for fail. 31.
~~PAGE 816~~
~~Command Line Interface Reference 31.4 InForm OS Version 2.3.~~
~~PAGE 817~~
InForm OS Version 2.3.1 Command Line Interface Reference Index . . . (ellipsis), multiuse option specifier 2.2 admitrcopyvv 5.10 () (parentheses), grouped elements 2.2 alerts removing from system 19.3 [] (brackets) optional elements 2.2 service, registered SNMP software for 22.155 | (vertical bar), or option specifier 2.2 system A removing preregistered SNMP software 19.24 access status of 22.4 status of, setting 21.3 user information about 22.186 using addsnmpmgr for 4.2 active VLUN 22.
~~PAGE 818~~
Command Line Interface Reference InForm OS Version 2.3.1 C clusters, shutting down 23.4 cages, new firmware, downloading into 30.2 cmd (command) operations 2.2 cancel command See also specific commands (cancel*) canceltask 6.2 CBIOS version 3.10 chapters, overview of 1.4 characters, length limits 2.3 check commands See also specific commands (check*) syntax for 2.3 command (cmd). See cmd (command) command line interface (CLI). See CLI (command line interface) commands 7.1 startrcopygroup 26.
~~PAGE 819~~
InForm OS Version 2.3.1 link to remote storage server 5.6 create commands See also specific commands (create*) createald 11.3 createaldvv 11.9 createavv 11.18 Command Line Interface Reference D data services starting on logical disk 24.3 virtual volume, starting 24.7, 24.8 databases, current firmware levels, displaying 22.45 date and time createcpg 11.22, 11.30 for system nodes 22.33 createdomain 11.30 setting nodes 21.27 creategroupsv 11.34 definitions, removing 12.2 creategroupvvcopy 11.
~~PAGE 820~~
Command Line Interface Reference InForm OS Version 2.3.1 virtual volumes, mapping information 22.115 replacing 10.5 controlling 10.9 firmware dismiss command 12.1 levels of 22.45 See also specific commands (dismiss*) new, downloading into cages 30.2 physical disks, upgrading 30.4 dismisspd 12.2 specific cages, downloading into 30.2 dismissrcopylink 12.3 dismissrcopytarget 12.5 freespace 13.2 dismissrcopyvv 12.6 G display group configuration details 22.143 add virtual volume to 5.
~~PAGE 821~~
InForm OS Version 2.3.1 Command Line Interface Reference for ports 15.18 create to remote storage server 5.6 physical disks, of 15.10 remove 12.3 VLUNs 15.23 link utilization statistics 25.23 histpd 15.10 LIP 10.10 histport 15.18 locate command histvlun 15.23 See also specific commands (locate*) histvv 15.28 locatecage 16.2 host name, length limit 2.3 locatesys 16.4 host sees VLUN template 11.79 logical disk name, length limit 2.3 hosts logical disks creating new system 11.
~~PAGE 822~~
Command Line Interface Reference InForm OS Version 2.3.1 movechtodomain 17.18 SNMP removing access 19.26 movechtospare 17.6 updating access 21.68 movepdtospare 17.9 moverelocpd 17.12 moving chunklet lists 17.2 persistent repository 22.173 physical disks 12.2, 17.6, 17.9 allocatable, marking as 21.53 moving domains 17.18 displaying mapping information 22.14 moving physical disks to spare 17.6, 17.9 firmware, upgrading 30.4 multiuse option specifier. See . . .
~~PAGE 823~~
InForm OS Version 2.3.1 Command Line Interface Reference related documents 1.3 removevlun 19.39 Remote Copy 26.4 removevv 19.43 enable 24.4 ports 10.9 stop 26.6 remove group 19.18 removing hosts 19.12 removing users 19.35 removing virtual volumes 19.43 replacing drive magazines or disk drives 10.5 link 12.3 revision history RH.1 target designation 19.20 RSCN 10.10, 22.124 virtual volume from group 12.6 rules, syntax 2.3 remove commands See also specific commands (remove*) removealert 19.
~~PAGE 824~~
Command Line Interface Reference setcpg 21.20 setdate 21.27 IX.8 InForm OS Version 2.3.1 show commands See also specific commands (show*) setdomain 21.31, 21.33 showalert 22.4 setdomainset 21.33 showauthparam 22.6 sethost 21.35 showbattery 22.8 sethostset 21.39 showblock 22.14 setlicense 21.39, 21.40 showcage 22.17 setnet 21.42 showcim 22.23 setnode 21.47 showclienv 22.25 setntp 2.5 to 2.6, 21.49 showcpg 22.26 setpassword 21.51 showdate 22.33 setpd 21.53 showdomain 22.
~~PAGE 825~~
InForm OS Version 2.3.1 showpdvv 22.115 showport 22.119 Command Line Interface Reference shutdown commands See also specific commands (shutdown*) showportarp 22.130 shutdownnode 23.2 showportdev 22.132 shutdownsys 23.4 showportisns 22.135 shutting down system nodes 23.2 showportlesb 22.137 snapshot volumes (copies), creating 11.58 showrcopy 22.143 SNMP access showrctransport 22.148 showrsv 22.151 showsched 22.153 showsnmpmgr 22.155 removing passwords for 19.26 updating 21.
~~PAGE 826~~
Command Line Interface Reference InForm OS Version 2.3.1 statcmp 25.7 stoprcopy command 22.144 statcpu 25.10 stoprcopygroup 26.6 statiscsi 25.12 storage server, information about 22.191 statiscsisession 25.16 subcmd (subcommand) operations 2.2 statistics subcommand (subcmd). See subcmd (subcommand) cache memory page 25.7 chunklet collection mode 21.72, 21.74 sync command 27.1 to 27.3 See also specific commands (sync*) chunklets, timed loop display 25.2 CPU, for all nodes 25.
~~PAGE 827~~
InForm OS Version 2.3.1 templates creating 11.61 Thinly Provisioned Virtual Volume (TPVV), length limit 2.3 time and date for system nodes 22.33 setting nodes 21.27 traps removing preregistered SNMP software 19.24 using addsnmpmgr for 4.2 tunealdvv 28.2 tunepd 28.10 Command Line Interface Reference of virtual volumes 7.13 VCN 10.10, 22.124 verifying controlport command success 10.18 physical disk admittance 5.5 physical disk status 21.54 vertical bar (|), or option specifier 2.
~~PAGE 828~~
Command Line Interface Reference InForm OS Version 2.3.1 host sees 11.79 template 22.193 matched set 11.79 template conflicts in 11.42 port presents 11.79 voltage status 22.87 VLUNs active 22.193 W deleting 19.39 wait command information about 22.193 of virtual volumes, creating 11.79 service time, histograms of 15.23 IX.12 Index See also specific commands (wait*) waittask 31.
~~PAGE 829~~
InForm OS Version 2.3.1 Command Line Interface Reference Revision History Release Level Revision Summary 320–200166 Rev A October 2009 First release of this manual to support initial release of the 2.3.1 InForm OS. 320-200166 Rev B March 2010 Second release of this manual to support the 2.3.1 MU1 InForm OS release. Revision History RH.
~~PAGE 830~~
~~Command Line Interface Reference RH.2 Revision History InForm OS Version 2.3.~~