® 3PAR InForm OS 2.3.1 CLI Administrator’s Manual 3PAR, Inc. 4209 Technology Drive Fremont, CA 94538 USA Part No.
Revision Notice This is the second release of this manual. A complete revision history is provided at the end of this document. 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.
All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the University of California, Berkeley and its contributors. 4 Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. Copyright (c) 1996, 1998 Christopher G. Demetriou. All rights reserved.
Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here, provided that the new terms are clearly indicated on the first page of each file where they apply.
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3.
Redistribution and use of the libssl OpenSSL library in source and binary forms, with or without modification, is permitted provided that the following conditions are met: 1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3.
Trademarks 3PAR, InServ, InForm, InSpire and Serving Information are registered trademarks of 3PAR, Inc. Intel and Pentium are registered trademarks of Intel Corporation. Linux is a registered trademark of Linus Torvalds. Redhat is a registered trademark of Red Hat, Inc. SuSE is a registered trademark of Novell, Inc. Microsoft, Windows, and Windows NT are either registered trademarks or trademarks of Microsoft Corporation. Oracle is a registered trademark of Oracle Corporation.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Table of Contents 1 Introduction 1.1 Audience 1.1 1.2 User Interfaces 1.2 1.3 Units of Measure 1.2 1.4 Related Documentation 1.3 1.5 Organization 1.4 1.6 Typographical Conventions 1.5 1.7 Advisories 1.6 2 Installing the InForm Command Line Interface 2.1 About the InForm Command Line Interface 2.2 2.2 Supported Platforms 2.2 2.3 System Requirements 2.3 2.4 Disk Space Requirements 2.3 2.5 Installation 2.4 2.5.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 2.6 Troubleshooting the Installation 2.5 2.7 Removing the InForm CLI 2.6 2.7.1 On Windows 2.6 2.7.2 On Solaris and Linux 2.6 2.8 Scripting Considerations 2.7 3 Running the InForm Command Line Interface 3.1 Introduction 3.2 3.2 Global Options and Environment Variables 3.3 3.2.1 General Control and Help Commands 3.6 3.2.2 Commands with Column Help 3.7 3.2.3 Using SSL 3.7 3.2.4 Setting the CLI Client Network Port 3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.1.3 Viewing Users 4.5 4.1.4 Viewing User Connections 4.5 4.1.5 Removing User Connections 4.6 4.1.6 Removing a User 4.6 4.2 Users and Domains 4.6 4.2.1 Adding a User to a Domain 4.6 4.2.2 Removing a User From a Domain 4.7 4.2.3 Setting a User’s Default Domain 4.7 4.2.4 Removing a User’s Default Domain 4.7 4.2.5 Setting a User’s Current Domain 4.7 4.2.6 Removing a User’s Current Domain 4.8 4.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 5.8.2 Adding Virtual Domains to Virtual Domain Sets 5.7 5.8.3 Modifying Virtual Domain Sets 5.7 5.8.4 Removing Virtual Domain Sets 5.8 6 Managing Ports and Hosts 6.1 Overview 6.2 6.2 Modifying Port Parameters 6.2 6.2.1 FC Port Settings 6.3 6.2.2 iSCSI Port Settings 6.4 6.3 Port Target, Initiator, and Peer Modes 6.5 6.4 Active and Inactive Hosts 6.6 6.5 Managing Hosts 6.7 6.5.1 Host Management CLI Commands 6.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 6.10.4 6.15 Removing Host Sets 6.11 Managing Host Personas 6.16 6.11.1 Viewing Host Personas 6.18 6.11.2 Displaying Host Persona Settings 6.18 6.11.3 Creating a Host with an Assigned Host Persona 6.18 6.11.4 Assigning a Host Persona to a Host 6.18 6.11.5 Converting a Legacy Host Persona to a Host Persona 6.18 6.12 The Host Explorer Agent 6.19 6.13 Hosts and Virtual Domains 6.20 6.13.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 7.8.2 Creating Thinly-Provisioned Virtual Volumes 7.9 Modifying Virtual Volumes 7.13 7.10 Growing Virtual Volumes 7.14 7.11 Reducing Volume Size with 3PAR Thin Conversion 7.14 7.11.1 Converting an InServ Storage Server Virtual Volume 7.16 7.13 Managing Virtual Volume Autonomic Groups 7.16 7.13.1 Creating Virtual Volume Sets 7.17 7.13.2 Adding Virtual Volumes to Virtual Volume Sets 7.17 7.13.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 8 Managing Virtual Volume Copies 8.1 Overview 8.2 8.2 Virtual Copies 8.2 8.2.1 Creating a Virtual Copy 8.3 8.2.2 Promoting a Virtual Copy 8.3 8.2.3 Modifying a Virtual Copy 8.4 8.2.4 Removing a Virtual Copy 8.4 8.2.5 Creating a Group of Virtual Copies 8.4 8.3 Physical Copies 8.5 8.3.1 Creating a Physical Copy 8.6 8.3.2 Resynchronizing a Physical Copy 8.7 8.3.3 Promoting a Physical Copy 8.8 8.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 10.2.2 Determining System Capacity by Physical Disk Type 10.4 10.3 Physical Disk Capacity 10.4 10.3.1 Determining Total Physical Disk Capacity 10.4 10.3.2 Determining Physical Disk Capacity by Disk Type 10.6 10.3.3 Determining the Capacity of a Specific Physical Disk 10.6 10.4 Spare Chunklets 10.4.1 Viewing Spare Chunklets 10.7 10.7 11 Managing Events and Alerts 11.1 Overview 11.1 11.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 12.2.6 Viewing Statistics for CPU Usage 12.3 Viewing Histograms 12.5 12.5 12.3.1 Viewing Histograms for Chunklets 12.5 12.3.2 Viewing Histograms for Logical Disks 12.6 12.3.3 Viewing Histograms for Physical Disks 12.6 12.3.4 Viewing Histograms for Ports 12.7 12.3.5 Viewing Histograms for VLUNs 12.7 12.3.6 Viewing Histograms for Virtual Volumes 12.8 13 Managing Tasks 13.1 Overview 13.2 13.2 Task Manager 13.2 13.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 13.3.13 system_task 13.4 System Scheduler 13.19 13.19 13.4.1 System Scheduler Commands 13.20 13.4.2 Displaying Scheduled Tasks 13.22 13.4.3 Scheduling Tasks 13.23 13.4.4 Modifying a Scheduled Task 13.23 13.4.5 Suspending and Resuming Scheduled Tasks 13.23 13.4.6 Removing Scheduled Tasks 13.24 14 Using SNMP 14.1 Overview 14.1 14.2 The 3PAR SNMP Agent 14.2 14.2.1 Locating the 3PAR MIB 14.2 14.2.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 16.3.2 Fully-Provisioned Virtual Volumes 16.4 Changing Virtual Volume RAID Types 16.5 16.5 16.4.1 Thinly-Provisioned Virtual Volumes 16.5 16.4.2 Fully-Provisioned Virtual Volumes 16.6 16.5 Changing Virtual Volume Availability Levels 16.6 16.5.1 Thinly-Provisioned Virtual Volumes 16.6 16.5.2 Fully-Provisioned Virtual Volumes 16.7 16.6 Changing Virtual Volume Parameters 16.7 16.6.1 Thinly-Provisioned Virtual Volumes 16.
3PAR InForm CLI Administrator’s Manual xiv Table of Contents InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 1 Introduction In this chapter 1.1 Audience 1.1 1.2 User Interfaces 1.2 1.3 Units of Measure 1.2 1.4 Related Documentation 1.3 1.5 Organization 1.4 1.6 Typographical Conventions 1.5 1.7 Advisories 1.6 This administrator’s guide provides the information you need to configure and manage a 3PAR InServ® Storage Server. 1.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 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. For information about the InForm Management Console, refer to the 3PAR InForm OS Management Console Online Help.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 1.
3PAR InForm CLI Administrator’s Manual 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 guide, including information on audience, related documentation, and typographical conventions. ■ Chapter 2, Installing the InForm Command Line Interface, gives instructions for installing the InForm CLI and connecting to storage servers.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual Chapter 13, Managing Tasks, describes how to use the task management mechanisms built into the InForm OS and the InForm CLI task management commands to manage longrunning operations on the system. ■ Chapter 14, Using SNMP, describes the 3PAR SNMP agent and explains how to register a manager with this agent. ■ Chapter 16, Performance Tuning, explains how to use the 3PAR Dynamic Optimization, an optional feature of the InForm OS.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Typeface Meaning Example Used for variables Modify the content string by in filenames, adding the -P paths, and screen option after -jar output. inform.jar Used for variables #.\java -jar inform.jar in user input. -P 1.7 Advisories To avoid injury to people or damage to data and equipment, be sure to observe the cautions and warnings in this guide.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 2 Installing the InForm Command Line Interface In this chapter 2.1 About the InForm Command Line Interface 2.2 2.2 Supported Platforms 2.2 2.3 System Requirements 2.3 2.4 Disk Space Requirements 2.3 2.5 Installation 2.4 2.5.2 Graphical Installation on Windows 2.4 2.5.3 Command-Line Installation on Solaris and Linux 2.5 2.6 Troubleshooting the Installation 2.5 2.7 Removing the InForm CLI 2.6 2.8 Scripting Considerations 2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 2.1 About the InForm Command Line Interface Use the 3PAR InForm Command Line Interface (CLI) to monitor, manage, and configure 3PAR InServ Storage Servers. Refer to the InForm CLI installation readme file on the InForm CLI and SNMP CD, part number 780-200051 before installing the CLI. All platforms use this same CD, but the installation files are different for each of the supported platforms. 2.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 2.3 System Requirements The InForm CLI uses port number 5783 for secure communications and port 5782 for unsecure communications. If you intend to keep the InForm CLI connected to your InServ Storage Server for an extended period of time, you must configure your firewall to allow the CLI to remain connected when there is no activity.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 2.5 Installation The following sections describe how to install the InForm CLI on remote systems running compatible versions of Microsoft® Windows®, Sun™ Solaris™, and Linux® operating systems. You have a choice between a graphical installation and a command line installation. For graphical installation instructions, see 2.5.2 Graphical Installation on Windows on page 2.4. For command-line installation instructions, see 2.5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 2.5.3 Command-Line Installation on Solaris and Linux To install the InForm CLI on Solaris platforms: 1 Log in as root. 2 Insert the InForm CLI and SNMP CD into your drive. 3 Start the installation using the setup.bin file: /cdrom/InFormCLI_and_SNMP/solaris|linux/setup.bin 4 Log out and log back in. The default installation location is /opt/3PAR/inform_cli_. 2.5.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 For Windows, if you installed the InForm CLI in the default location, this log file is located at: C:\Program Files\3PAR\inform_cli_\log\install.log The is the current release version, for example 2.3.1. 2.7 Removing the InForm CLI The following section describes how to remove InForm CLI on systems running on Microsoft® Windows®, Sun™ Solaris™, and Linux operating environments.
InForm OS Version 2.3.1 2 3PAR InForm CLI Administrator’s Manual Change directories as follows: /opt/3PAR/inform_cli_/uninstall/uninstall where is the current release version, for example 2.3.1. 3 Follow the instructions that appear in the Uninstaller to uninstall all InForm CLI. 4 When prompted, click Finish to finish removing the InForm CLI from your system. 2.
3PAR InForm CLI Administrator’s Manual 2.8 Scripting Considerations InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3 Running the InForm Command Line Interface In this chapter 3.1 Introduction 3.2 3.2 Global Options and Environment Variables 3.3 3.2.1 General Control and Help Commands 3.6 3.2.2 Commands with Column Help 3.7 3.2.3 Using SSL 3.7 3.2.4 Setting the CLI Client Network Port 3.8 3.2.5 Setting the TPDSYSNAME Environment Variable 3.8 3.2.6 Setting Your Name and Password 3.10 3.2.7 Caching Client Bytecode 3.12 3.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.3 Stand-alone Commands 3.18 3.4 SSH 3.19 The purpose of this chapter is to explain how to get help from the InForm CLI, and how to configure environmental variables. 3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3.2 Global Options and Environment Variables Global options are provided to help configure the CLI and control the operation of the InServ Storage Server. Environment variables are provided to customize the CLI. The global CLI options and environment variables are listed in Table 3-1. ■ You can use the global options with the CLI program and individual CLI commands.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Table 3-1. Global CLI Options and Environment Variables Environment Global Option Variable Specifies... –sockssl TPDSOCKSSL that the connection between the client and server is secure. For additional information, see 3.2.3 Using SSL on page 3.7. –tpdportnum –– the IP port of the CLI server to which the CLI client connects. For additional information, see 3.2.4 Setting the CLI Client Network Port on page 3.8.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Table 3-1. Global CLI Options and Environment Variables (continued) Environment Global Option Variable Specifies... –– TPDSTARTFILE the Tcl script the system sources before entering the command loop. For additional information, see 3.2.8 Startup Files on page 3.12. –csvtable TPDCSVTABLE that commands that use the table formatting routines will print comma-separated output. For additional information, see 3.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.1 General Control and Help Commands Table 3-2 shows the general control and help commands that you can use to view help text online while using the InForm CLI. Table 3-2. General Control Commands Command Action cmore Pages the output of commands. Valid syntax for using this command is cmore . exit Terminates the program. help –search Lists all commands or details for the specified topic.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3.2.2 Commands with Column Help Column help is provided for some commands to clarify the meaning of each column of data by defining the meaning of the column headers. Access column help as follows: cli% clihelp –col When column help is not available, the following message appears: No help for columns of command “”. 3.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.3.2 Setting the TPDSOCKSSL Environment Variable On Windows To set the TPDSOCKSSL environment variable in Windows: 1 On the taskbar, click the Start > Settings > Control Panel. 2 In Control Panel, double-click the System icon. 3 In the System Properties dialog box, click the Advanced tab. 4 Click Environment Variables. 5 Enter TPDSOCKSSL in the Variable box. 6 Enter 1 in the Value box. 7 Click OK. 3.2.3.
InForm OS Version 2.3.1 ■ Use the –sys command line global option. ■ Enter the system name when prompted. 3PAR InForm CLI Administrator’s Manual 3.2.5.1 Setting the TPDSYSNAME Environment Variable on Solaris and Linux To set the environment variable on Solaris or Linux, see the following system output example. Substitute your system name for and use the correct syntax for your shell. $ TPDSYSNAME= $ export TPDSYSNAME $ cli 3.2.5.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.5.3 Using the -sys Option The global option –sys (system) overrides any setting of the environment variable TPDSYSNAME. On the command line, enter –sys after the command name, followed by your system name. See the following output example. Substitute your system name for . $ showhost –sys 3.2.5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3.2.6.1 Using the setpassword Command To store a six character minimum password on your system, issue the setpassword command to create a password file as displayed in the following example. Substitute a valid password file for . $ setpassword –saveonly –file See the 3PAR InForm OS Command Line Interface Reference for additional information about the setpassword command.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.7 Caching Client Bytecode Client bytecode contains the majority of functionality of the InForm CLI and is version specific. The CLI caches the code required for communication for each different version of the InForm OS running on the system. The TPDCACHEDIR environment variable controls the location of the cache directory used by the CLI to determine the version of the InForm OS running on the system.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3.2.8.1 Setting the TPDSTARTFILE Environment Variable on Solaris and Linux To set the TPDSTARTFILE environment variable in Solaris and Linux, see the following system output example. Substitute the name of your startup file for and use the correct syntax for your shell. $ TPDSTARTFILE= $ export TPDSTARTFILE $ cli 3.2.8.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Once set, data is displayed as shown in the following example: cli% showvv ---Rsvd(MB)--- -(MB)- Id Name Prov Type CopyOf BsId Rd -Detailed_StateAdm Snp Usr VSize 0 admin full base --0 RW normal 0 0 10240 10240 1 par full base Scott 1 RW normal 128 512 16384 256 2 copy cpvv vcopy Jeff 2 RW normal 0 0 16384 5120 3 vvcp.1.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 3.2.10 Listing Domains If you are using 3PAR Virtual Domains, you can configure data output to display a domain column. You can configure the output by using the following: ■ The -listdom global option. ■ The TPDLISTDOM environment variable. ■ The setclienv -listdom command (if changing within the Tcl shell; see the InForm OS Command Line Interface Reference for details about this command).
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.10.2 Setting the TPDLISTDOM Environment Variable on Windows To set the TPDLISTDOM environment variable in Windows: 1 Perform step 1 through step 4 of the procedure for setting the TPDSOCKSSL environment variable in Windows as described in 3.2.3 Using SSL on page 3.7. 2 In the Environment Variable dialog box, enter TPDLISTDOM in the Variable box. 3 Enter 1 in the Value box. 4 Click OK. 3.2.10.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual The following example displays CLI output with and without column headings and totals: cli% showvv -nohdtot 0 admin full base --... 30 V3 full base --31 V3.ro snp vcopy V3 29 VV5 full base --32 VV5.ro snp vcopy VV5 17 VV_TechPubs_1 full base --18 VV_TechPubs_2 full base --8 vvfromcpg2.0 full base --9 vvfromcpg2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.2.12 Forcing Commands A number of CLI commands return confirmation prompts before executing the command operations. For these commands, an –f option is provided allowing you to bypass the confirmation and force the execution of the command.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual If you are running the CLI commands as individual commands, you can put each command in a script or pipe them to other commands. You can use the shell of your choice for scripting or initiating interactive sessions that provide history and line editing capabilities. ■ Enter cli at your DOS or Solaris and Linux prompt to run the cli script. Running this script places you into an interactive Tcl shell where all CLI commands are available.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 3.4.1 Benefits of Using SSH SSH provides the following benefits: ■ No InForm CLI installation. CLI clients are not required to access and use the CLI (assuming SSH client is installed). ■ No version matching. The InForm CLI and InForm OS versions do not need to match because the CLI does not need to be installed remotely. ■ Strong encryption. All information exchanged between client machines and InServ systems are encrypted.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual list 3.4.2.1 New Users When creating a new user, specify a new user name that is different from those listed previously. 3.4.2.2 Existing Users To delete a user, issue the removeuser command. cli% removeuser pw1 User removed In the previous example, a user with the reserved user name of pw1 is removed. To create a new user, issue the createuser command.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 To access the CLI for the first time using SSH: 1 From any host that has SSH client, enter the following example: $ ssh 3paradm@ In the previous example, 3paradm is the first default user with super level privilege and is the InServ system’s host name. 2 If this is the first login from the client host (e.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual You are now in the CLI shell and can issue any CLI command as documented in this manual. 5 If you need to create CLI additional users, issue the createuser command. cli % createuser –c testpw user2 all edit In the previous example, new user user2 with password testpw is created. 6 Terminate the CLI session by typing exit at the prompt.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 In the previous example, user user1 logs into InServ system system1 and creates user user3 with the password testpw3. 2 Create a key pair using the ssh–keygen utility. Both rsa and dsa key formats are supported by the InServ system and recommended key length is 1024. NOTE: For additional information about the ssh–keygen utility and rsa and dsa key formats, consult your SSH client documentation. To create a key pair using rsa format:.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual Ensure that only the owner has access and read/write permission on the private key file, otherwise the SSH client refuses the key file. 3 Log onto an InServ system from any system with the SSH client installed. $ssh user3@system1 user3@system1’s password: testpw3 4 Issue the setsshkey command. system1 cli% setsshkey setsshkey Please enter the SSH public key below. When finished, press enter twice. The key is usually long.
3PAR InForm CLI Administrator’s Manual 6 InForm OS Version 2.3.1 If you specified a pass phrase when creating the key pair, run ssh-agent and ssh-add to decrypt the key before running your script ( in the following example). $ ssh–agent echo Agent pid 24216 $ ssh–add Enter passphrase for /home/usr/user3/.ssh/id_dsa: ****** Identity added: /home/usr/user3/.ssh/id_dsa (/home/usr/user3/.ssh/id_dsa) $ 3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4 Managing User Accounts and Connections In this chapter 4.1 User Accounts 4.2 4.1.1 Default User Accounts 4.3 4.1.2 Creating a User 4.4 4.1.3 Viewing Users 4.5 4.1.4 Viewing User Connections 4.5 4.1.5 Removing User Connections 4.6 4.1.6 Removing a User 4.6 4.2 Users and Domains 4.6 4.2.1 Adding a User to a Domain 4.6 4.2.2 Removing a User From a Domain 4.7 4.2.3 Setting a User’s Default Domain 4.7 4.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.1 Active Directory LDAP Configuration with SASL Binding 4.9 4.3.2 Active Directory LDAP Configuration with Simple Binding Over SSL 4.17 4.3.3 OpenLDAP Configuration with Simple Binding Over SSL 4.26 4.4 LDAP Connection on Systems Using Domains 4.31 The purpose of this chapter is to explain how to create and manage user accounts. 4.1 User Accounts A user account is required to access an InServ Storage Server.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual NOTE: If the first user created does not have sufficient privileges to create additional users, operations are limited to what the first user can do. Therefore, it is recommended that the first user be created with super user privileges by specifying super for your user class when issuing the createuser command. See the 3PAR InForm OS Command Line Interface Reference for additional information about the createuser command.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 3parsvc is a user ID with Super level CLI user privileges. This Super user ID is used by the InServ Service Processor to monitor the InServ Storage Server. If the 3parsvc user ID is removed or modified, the service processor will be unable to communicate with the storage server. If the service processor is unable to communicate with the storage server, the ability to monitor and service the InServ Storage Server is severely restricted.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual When you create a user, you can optionally use all in place of a domain_name to specify privileges over the entire system. In this case, the created user can be assigned a privilege level of Browse, Edit, Super, or Service. For additional information about user privilege levels and domains, see the InForm OS Concepts Guide. 4.1.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.1.5 Removing User Connections To terminate a user’s connection to the system, issue the removeuserconn command, where: ◆ is the user’s numeric ID. ◆ is the user’s assigned name. ◆ is the user’s IP address. Refer to the InForm OS Command Line Interface Reference for details about this command. 4.1.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.2.2 Removing a User From a Domain To remove a user from a domain, issue the setuser -rmdomain command, where: ◆ is the name of the domain from which the specified user is being removed. ◆ is the name of the user being removed from the specified domain. You can specify all in place of a specific domain name to remove the user from all domains. 4.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 To set a user’s current domain, issue the setclienv currentdomain command, where is the domain you wish to set as the working domain for the current CLI session. 4.2.6 Removing a User’s Current Domain NOTE: When issuing the setclienv currentdomain -unset command, you are not returned to your default domain. To remove a user’s current domain, issue the setclienv currentdomain -unset command. 4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.1.1 Configuring Connection Parameters To configure connection parameters: 1 If not already known, obtain the LDAP server’s host name and Kerberos server information by running the ldapsearch command or using ldp.exe (available as part of the downloadable Windows Support Tools from Microsoft). You must know the LDAP server’s IP address. NOTE: If you do not have access to the ldapsearch command, use the ldp.exe command shown below.
InForm OS Version 2.3.1 2 3PAR InForm CLI Administrator’s Manual Set the address to which the LDAP server will connect by issuing the setauthparam ldap-server command, where is your LDAP server’s IP address. 3 Set the LDAP server’s host name by issuing the setauthparam ldap-server-hn command, where is the value displayed by either using the ldapsearch command or ldp.exe in step 1 on page 4.10.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.1.2 Configuring Binding Parameters After you have configured the connection parameters to your LDAP server, you must configure the binding (authentication) parameters for users. 1 Issue the setauthparam binding sasl command. 2 Issue the setauthparam sasl-mechanism command, where is specified as PLAIN, DIGEST-MD5, or GSSAPI.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Example: % ldapsearch -LLL -x -H ldap://192.168.10.13 -D 'NTDOM1\joeadmin' -W -b DC=3par,DC=com -s sub '(cn=3PARuser)' dn Enter LDAP Password: dn: CN=3PAR User,OU=Engineering,OU=Users,DC=3par,DC=com The example above corresponds to step 1 on page 4.12, and displays the following: ■ joadmin is the user name of the NT Windows domain (NTDOM1) administrator searching for group information for user 3PARuser (cn=3PAR User).
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 InServ1 cli% checkpassword 3PARuser password: + attempting authentication and authorization using system-local data + authentication denied: unknown username + attempting authentication and authorization using LDAP + using Kerberos configuration file: [domain_realm] domaincontroller.3par.com = NTDOM1.3PAR.COM [realms] NTDOM1.3PAR.COM = { kdc = 192.168.10.13 } + temporarily setting name-to-address mapping: domaincontroller.3par.com -> 192.168.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.3.1.4 Configuring Group-To-Privilege Mapping Parameters Once you have configured the group location parameters, you must now decide what privilege you wish to assign the users for a given group. To configure group-to-privilege mapping: 1 Issue the setauthparam command, where: ◆ ◆ is one of: ◆ super-map - provides super level privileges within the specified group.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 InServ1 cli% checkpassword 3PARuser ...
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.2.1 Configuring Connection Parameters To configure connection parameters: 1 If not already known, obtain the LDAP server’s host name by running the ldapsearch command or using ldp.exe (available as part of the downloadable Windows Support Tools from Microsoft). You must know the LDAP server’s IP address. NOTE: If you do not have access to the ldapsearch command, use the ldp.exe command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Example: % ldapsearch -LLL -x -H ldap://192.168.10.13 -b "" -s base dnsHostName ldapServiceName defaultNamingContext dn: dnsHostName: domaincontroller.3par.com ldapServiceName: 3par.com:domaincontroller$@NTDOM1.3PAR.COM defaultNamingContext: DC=3par,DC=com The example above corresponds to step 1 on page 4.18 and displays the following: ■ The LDAP server’s IP address is 192.168.10.13. ■ The DNS_HostName is domaincontroller.3par.com.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.2.3 Configuring the CA Certificate To configure the CA certificate: 1 Obtain the location of the CA certificate from the Active Directory server’s administrator. NOTE: If the certificate ends in the file extension .crt, it will need to be converted to a form compatible with the setauthparam command. 2 If necessary, convert the certificate to .cer file format. On a Windows system: a Double-click the certificate.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual setauthparam -f ldap-ssl-cacert ca.cer In the example above, the setauthparam command is issued to set the CA certificate to the ca.cer file. 4.3.2.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 dn: CN=3PAR User,OU=Engineering,OU=Users,DC=3par,DC=com displays user locations in the LDAP server directory information tree (DIT). InServ1 InServ1 InServ1 InServ1 cli% cli% cli% cli% setauthparam setauthparam setauthparam setauthparam -f -f -f -f accounts-dn OU=Users,DC=3par,DC=com account-obj user account-name-attr sAMAccountName memberof-attr memberOf The example above corresponds to step 2 on page 4.21 through step 5 on page 4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual InServ1 cli% checkpassword 3PARuser password: + attempting authentication and authorization using system-local data + authentication denied: unknown username + attempting authentication and authorization using LDAP + using Kerberos configuration file: [domain_realm] domaincontroller.3par.com = NTDOM1.3PAR.COM [realms] NTDOM1.3PAR.COM = { kdc = 192.168.10.13 } + temporarily setting name-to-address mapping: domaincontroller.3par.com -> 192.168.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.2.5 Configuring Group-To-Privilege Mapping Parameters Once you have configured the group location parameters, you must now decide what privilege you wish to assign the users for a given group. To configure group-to-privilege mapping: 1 Issue the setauthparam command, where: ◆ ◆ is one of: ◆ super-map - provides super level privileges within the specified group.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual InServ1 cli% checkpassword 3PARuser ...
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 4.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 4.3.3.1 Configuring Connection Parameters 1 To configure connection parameters, issue the setauthparam ldap-server command, where is the OpenLDAP server’s IP address. 2 Issue the setauthparam ldap-ssl 1 command. Example: InServ1 cli% setauthparam -f ldap-server 192.168.10.13 InServ1 cli% setauthparam -f ldap-ssl 1 In the example above: ■ The OpenLDAP server’s IP address is 192.168.10.13.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 InServ1 cli% setauthparam -f user-dn-base ou=people,dc=ldaptest,dc=3par,dc=com In the example above, the base of the user entries in the OpenLDAP server DIT is ou=people,dc=ldaptest,dc=3par,dc=com. InServ1 cli% setauthparam -f user-attr uid In the example above, uid is the attribute with the value of the user’s user name of the posixAccount object class. 4.3.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual InServ1 cli% setauthparam -f group-obj posixGroup InServ1 cli% setauthparam -f group-name-attr cn InServ1 cli% setauthparam -f member-attr memberUid In the example above: ■ posixGroup is the group object class. ■ cn is the attribute of the posixGroup, which has a value of the group’s name. ■ memberUid is the attribute with the value of the user’s username. 4.3.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 In the example above: ■ Users belonging to the software group are configured to have super privileges within the system. ■ Users belonging to the engineering group are configured to have edit privileges within the system. ■ Users belonging to the hardware group are configured to have browse privileges within the system.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual In the example above: ■ User 3PARuser is found to be a member of the software group and is assigned super level privileges within the system. ■ Although 3PARuser is also a member of the engineering and hardware groups, the super privilege associated with the Software group supersedes the edit and browse privileges associated with the engineering and software groups.
3PAR InForm CLI Administrator’s Manual ■ ◆ setauthparam memberof-attr memberOf ◆ checkpassword Configure group-to-privilege mapping parameters using the following command: ◆ ■ InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Example using only the domain-name-attr parameter: InServ cli% setauthparam domain-name-attr name The example above corresponds to the first bullet in step 2 on page 4.32. As shown, name is the attribute used as the basis of the domain name search. InServ1 cli% checkpassword 3PARuser ...
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 3PARuser is also found to be a member of the Eng group with browse level privileges. The Eng group is mapped to the Engineering domain. 3PARuser is assigned browse level privilege within the Eng domain. Example using the domain-name-prefix parameter: InServ cli% setauthparam domain-name-attr description InServ cli% setauthparam domain-name-prefix InServDomain= The example above corresponds to the second bullet in step 2 on page 4.32.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual InServ1 cli% checkpassword 3paruser ... + temporarily setting name-to-address mapping: domaincontroller.3par.com -> 192.168.10.13 + attempting to obtain credentials for 3paruser@NTDOM1.3PAR.COM + connecting to LDAP server using URI: ldap://192.168.10.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 3PARuser is also found to be a member of the Eng group with browse level privileges. The Engineering group is mapped to the Engineering domain. 3PARuser is assigned browse level privilege within the Engineering domain. 4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 5 Managing Virtual Domains In this chapter 5.1 Overview 5.2 5.3 Creating a Domain 5.3 5.4 Viewing Domains 5.3 5.5 Modifying a Domain 5.4 5.6 Removing a Domain 5.5 5.7 Managing Domain Objects 5.5 5.8 Managing Virtual Domain Autonomic Groups 5.6 The purpose of this chapter is to explain how to create and manage 3PAR Virtual Domains. NOTE: 3PAR Virtual Domains requires a 3PAR Virtual Domains license.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 5.1 Overview 3PAR Virtual Domains (Domains) allows an administrator to create multiple domains, or spaces, within an InServ Storage Server, where each domain is dedicated to a specific application. In effect, using Domains restricts users to a subset of the volumes and hosts in a system and prevents users from exporting virtual volumes to hosts outside of the users’ assigned domains.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Session 1 User belonging to edit user class default domain: set for ALL sessions (Domain A) Session 2 Domain A Session 3 Domain A current domain: set for a SINGLE session (Domain B) Domain B SINGLE assigned domain’s (either default or current) objects viewable and operable. Figure 5-1. Assigned Default and Current Domains 5.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 NOTE: To set your system output to display domain information, you must first set the TPDLISTDOM environment variable, the -listdom global option, or if you are working in a Tcl shell, issue the setclienv listdom 1 command. See 3.2.10 Listing Domains on page 3.15 for further information. ■ To view a system object’s domain association, issue the showhost, showvv, or showcpg commands. 5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 5.6 Removing a Domain Prior to removing a domain, any users belonging to that domain must be removed (4.2.2 Removing a User From a Domain on page 4.7) and assigned to another domain (4.2.1 Adding a User to a Domain on page 4.6), or must be removed completely (4.1.6 Removing a User on page 4.6). Any objects belonging to the domain must be removed form the domain, or moved to another domain before removing the domain.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 5.7.2 Removing the Domain Association from a Domain Object To remove the domain association from a domain object, issue the movetodomain -vv|-cpg|-host -unset command, where: ◆ -vv|-cpg|-host is the type of object (VV, CPG, host, respectively) from which you are removing the domain association. ◆ is the name of the VV, CPG, or host from which you are removing the domain assocation. 5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual system. Removing a virtual domain set does not remove the virtual domains in that set. Changing the name of a virtual domain in a set does not change the privileges of the virtual domain or remove it from the virtual domain set. 5.8.1 Creating Virtual Domain Sets To create a domain set, issue the createdomainset command, where: ◆ is the name of the domain set being created.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 5.8.4 Removing Virtual Domain Sets To remove a domain set from the system, or to remove domains from a set, issue the removedomainset command, where: ◆ is the name of the virtual volume set being removed or modified. ◆ are the names of the domains being removed from the domain set. This specifier is optional and it is not required if you are removing the entire set.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 6 Managing Ports and Hosts In this chapter 6.1 Overview 6.2 6.2 Modifying Port Parameters 6.2 6.3 Port Target, Initiator, and Peer Modes 6.5 6.4 Active and Inactive Hosts 6.6 6.5 Managing Hosts 6.7 6.6 Creating Hosts 6.7 6.7 Modifying Hosts 6.9 6.8 Moving, Removing and Disconnecting Hosts 6.12 6.10 Managing Host Autonomic Groups 6.14 6.11 Managing Host Personas 6.16 6.12 The Host Explorer Agent 6.19 6.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.1 Overview The InServ Storage Server sees a host as a set of initiator port WWNs (World Wide Names) or iSCSI Names. Hosts that are physically connected to ports on the InServ Storage Server are automatically detected. The Fibre Channel port WWNs and iSCSI port iSCSI Names are displayed in the InForm CLI. You can also add new WWNs or iSCSI Names for unestablished host paths and assign them to a host before they are physically connected.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual Node: Valid node numbers are 0-7 for each storage server, depending on the number of nodes and the storage server model. ■ Slot: Valid slot numbers are 0-7 for S-Class and T-Class storage server nodes, and 0-5 for EClass and F-Class storage server nodes. Slots are numbered consecutively from left to right.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 Set the port’s Class 2 service support level with the cl2 sub-command followed by ack0, ack1, or disable and then by the port location in Node:Slot:Port format. To set the port’s Class 2 service support level, issue the controlport cl2 command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual To set the TCP port number for the iSNS server, issue the controliscsiport isnsport command. NOTE: Other options are available for the controliscsiport command, including options setting the primary and secondary iSNS server IP addresses, setting the Maximum Transmission Unit (MTU) size for the iSCSI port, and using the Dynamic Host Configuration Protocol (DHCP).
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 CAUTION: Ports in the same Fibre Channel adapter should be set to the same mode. ■ For dual-port LSI cards, both ports must use the same mode. ■ For quad-port LSI cards, each port pair (ports 1&2 and 3&4) must use the same mode. ■ For QLogic cards, it is strongly recommended that all ports in a card be set to the same mode. 6.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 6.5 Managing Hosts The InServ Storage Server sees a host as a set of initiator port WWNs (World Wide Names) or iSCSI Names. The InForm administration tools allow you to create, modify, and remove Fibre Channel and iSCSI host paths and their properties. When creating a new host, you can either create a host with or without assigning WWNs or iSCSI Names.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 annotation purposes only and it does not affect the operation of the storage server. See the InForm OS Command Line Interface Reference or InForm CLI Help for further information. To create a host with an assigned host persona, see section 6.11.3 Creating a Host with an Assigned Host Persona. NOTE: There should be at least two paths to each host to facilitate updates to the InServ Storage Server.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual ◆ is the user-designated name of the host being defined. ◆ is the host iSCSI Name as determined from step 1 above. If the Host Explorer agent is running on the host, the createhost -iscsi command automatically creates a host with the path information received from the Host Explorer agent. 6.6.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.7.1 Changing a Host Name To change a host name, issue the sethost -name command, where: ◆ is the new name you wish to assign to the existing host. ◆ is the original name of the host you are modifying. 6.7.2 Adding Fiber Channel Path WWNs To add a WWN to an existing host: 1 Determine the HBA’s WWN by issuing the showhost command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 6.7.5 Removing iSCSI Path iSCSI Names To remove an iSCSI Name from an existing host, issue the removehost -iscsi command, where: ◆ is the name of the host being modified. ◆ is the iSCSI path being removed. 6.7.6 Configuring iSCSI CHAP Authentication Information A host with an iSCSI path can be modified as an initiator or target with iSCSI CHAP authentication information.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.8 Moving, Removing and Disconnecting Hosts Use the following commands display active hosts and the volumes exported to the hosts: ■ showhost ■ showvlun To display inactive hosts and the volumes that were exported to the hosts, use the servicehost list command. The showhost, showvlun, and servicehost CLI commands are described in detail in the InForm OS Command Line Interface Reference and the CLI Help Pages.
InForm OS Version 2.3.1 ◆ 2 3PAR InForm CLI Administrator’s Manual is the destination port location. Remove the host definition(s) from the old port or ports. Removing the host definitions does not remove the old host paths. To remove the host paths, see 6.9 Removing Host Paths on page 6.13. To remove host definitions and all VLUNs associated with the old host port, issue the servicehost remove [ [ ...
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 NOTE: Physically disconnecting a host server from the storage server port does not delete the host from the system. 6.10 Managing Host Autonomic Groups Hosts can be combined into autonomic groups, which are sets that can be managed as one object. Host sets are part of the Autonomic Groups feature.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 6.10.2 Adding Hosts to Host Sets To add a host to an existing host set, issue the createhostset -add command, where: ◆ is the name of the host set that will include the added hosts. ◆ are the names of the hosts being added to the host set. For a complete list of options available for the createhostset command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 6.10.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.11 Managing Host Personas Host personas are a set of behaviors that permit hosts connected to FC or iSCSI ports on the InServ Storage Server to deviate from the default host behavior. By assigning a persona to a host, multiple host types that require distinct customized responses can share a single InServ Storage Server port. For example, hosts running Windows, Linux, and AIX operating systems can all connect to the same InServ port.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Table 6-1 describes the specific functionality for each host persona number. Refer to the 3PAR InForm OS Configuration Matrix for a list of supported host operating systems. Table 6-1.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.11.1 Viewing Host Personas To view a list of all host personas, issue the showhost -listpersona command. 6.11.2 Displaying Host Persona Settings To display the host persona parameters, issue the showhost -persona command, where is the name of the host or hosts. 6.11.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual is the name of the host with the legacy host persona to be converted to the new host persona. The sethost CLI command is described in detail in the InForm OS Command Line Interface Reference and the CLI Help Pages. 6.12 The Host Explorer Agent The 3PAR Host Explorer agent is a program that runs on a host connected to an InServ Storage Server.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 6.13 Hosts and Virtual Domains NOTE: 3PAR Virtual Domains requires the use of the 3PAR Virtual Domain license. Contact your local 3PAR representative for details. If you are using 3PAR Virtual Domains, you can create and modify domain-specific Fiber Channel or iSCSI hosts. In many instances, you follow the same process for creating and modifying hosts just as you would for hosts that do not use domains. 6.13.
InForm OS Version 2.3.1 ■ ◆ 6.7.4 Removing Fibre Channel Path WWNs on page 6.10. ◆ 6.7.5 Removing iSCSI Path iSCSI Names on page 6.11. 3PAR InForm CLI Administrator’s Manual By adding or removing iSCSI CHAP authentication information. This operation is restricted to super or edit level user in the all domain (refer to the InForm OS Concepts Guide for details about this restriction). See the following for instructions: ◆ 6.7.6 Configuring iSCSI CHAP Authentication Information on page 6.11 ◆ 6.7.
3PAR InForm CLI Administrator’s Manual 6.22 Hosts and Virtual Domains InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7 Managing CPGs and Virtual Volumes In this chapter 7.1 Overview 7.3 7.2 Common Provisioning Groups 7.4 7.3 Common Provisioning Group CLI Commands 7.6 7.4 Creating a Common Provisioning Group 7.6 7.5 Modifying a Common Provisioning Group 7.7 7.6 Virtual Volume Types 7.9 7.7 Virtual Volume CLI Commands 7.11 7.8 Creating Virtual Volumes 7.11 7.9 Modifying Virtual Volumes 7.13 7.10 Growing Virtual Volumes 7.14 7.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 7.16 Setting Retention Times for Virtual Volumes 7.19 7.17 Removing Virtual Volumes 7.21 7.18 Exporting Virtual Volumes 7.21 7.19 Unexporting Virtual Volumes 7.23 7.20 Virtual Domains, CPGs, and Virtual Volumes 7.25 The purpose of this chapter is to explain how to create and modify Common Provisioning Groups (CPGs) and virtual volumes, and to explain how to export virtual volumes to hosts. 7.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.1 Overview A Common Provisioning Group (CPG) creates a virtual pool of logical disks that allows up to 4,095 virtual volumes to share the CPG's resources and allocate space on demand. Virtual volumes draw their resources from CPGs, and virtual volumes are exported as Logical Unit Numbers (LUNs) to hosts. Virtual volumes are the only data layer visible to hosts.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 7.2 Common Provisioning Groups By default, a CPG is configured to auto-grow new logical disks when the amount of available logical disk space falls below a configured threshold. CPGs are initially empty. The initial buffer pool of logical disks starts off at a fraction of the exported virtual capacity of mapped volumes and automatically grows over time as required by application writes.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual ■ Total available space on your system. ■ Nature of the data running on the system. ■ Number of CPGs in the system. ■ Number of volumes associated with those CPGs. ■ Anticipated growth rate of the volumes associated with the CPGs. CAUTION: Use caution in planning CPGs. The system does not prevent you from setting growth warnings or growth limits that exceed the amount of currently available storage on a system.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 Chunklets in the same row should be from different physical disks. In other words, a physical disk should not appear twice in the same row. ■ Chunklets should belong to a disk that is connected through the primary path to the logical disk’s owner node. ■ The growth increment is limited to 40 chunklets. ■ The system should use as many physical disks as possible. ■ The load on all physical disks should be balanced.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual -sdgw is the space limit for logical disk space before a warning alert is generated. If 0 (default) is specified, no warning limit is enforced. ◆ -t is the RAID type, specified as r0 (RAID 0), r1 (RAID 1), r5 (RAID 5), or r6 (RAID MP). ◆ is the name of the CPG being created.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 To set or modify a CPG’s autogrow size, issue the setcpg -sdgs command, where: ◆ -sdgs is the amount of logical disk storage created during each autogrow operation. Refer to Table 7-1 on page 7.4 for the minimum default growth sizes per number of nodes. ◆ is the name of the CPG being created. 7.5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.6 Virtual Volume Types There are three types of virtual volumes: ■ Fully-provisioned virtual volumes ■ Thinly-Provisioned Virtual Volumes (TPVVs) ■ Administrative Volumes Administrative volumes are created by the system and are for system usage only. CAUTION: It is strongly recommended that you do not tamper with the admin volumes.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 snapshot space are on a different CPGs, the user space remains available to the host if the CPG containing the snapshot space becomes full. To save time by not repeating tasks, you can create many identical virtual volume’s at one time. For planning information about virtual volumes and copies of volumes, refer to the InForm OS Concepts Guide. NOTE: Automatic copy space reclamation is enabled by default in the 2.3.1 release of the InForm OS.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual size limit is 16 TB. For detailed information about TPVV growth warnings and growth limits, see the 3PAR InForm OS Concepts Guide. 7.7 Virtual Volume CLI Commands Use the following CLI commands to manage fully-provisioned virtual volumes and ThinlyProvisioned Virtual Volumes (TPVVs): ■ showvv - display virtual volumes in the system. ■ createvv - create virtual volumes. ■ setvv - modify existing volumes.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 NOTE: Creating virtual copies or snapshots requires the 3PAR Virtual Copy license. Creating Thinly-Provisioned Virtual Volumes (TPVVs) requires the 3PAR Thin Provisioning license. Contact your 3PAR sales representative for more information. 7.8.1 Creating Fully-Provisioned Virtual Volumes A fully-provisioned virtual volume has a set amount of user space that is allocated for user data.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.8.2 Creating Thinly-Provisioned Virtual Volumes A TPVV allocates user space and snapshot space on demand. If you do not specify a CPG to be used for snapshot space with the -snp_cpg option, the TPVV will have no snapshot space.
3PAR InForm CLI Administrator’s Manual ◆ InForm OS Version 2.3.1 is the name of the CPG from which the modified virtual volume will draw its user space. ◆ is the name of the virtual volume being modified. For a complete list of options available for the setvv command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 7.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual NOTE: Converting fully-provisioned volumes to Thinly-Provisioned Virtual Volumes (TPVVs) with the Thin Conversion feature requires an InServ F-Class or TClass Storage Server, a 3PAR Thin Provisioning license, and a 3PAR Thin Conversion license. Contact your 3PAR representative for more information. 7.11.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 7.12 Reducing Volume Size with 3PAR Thin Persistence 3PAR Thin Persistence is an optional feature keeps InServ TPVVs small by detecting pages of zeros during data transfers, and not allocating space for the zeros in the destination TPVV. This feature works in real-time and analyzes the data before it is written to the destination TPVV. You must have an InServ F-Class or T-Class Storage Server to use Thin Persistence with TPVVs.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual The opposite is also true. If a virtual volume is removed from a set, all the privileges of that virtual volume set are revoked for the removed virtual volume. A virtual volume in a virtual volume set cannot be removed from the system until it has been removed from the virtual volume set, or until the virtual volume set is removed from the system. Removing a virtual volume set does not remove the virtual volumes in that set.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 For a complete list of options available for the setvvset command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 7.13.4 Removing Virtual Volume Sets To remove a virtual volume set from the system, or to remove virtual volumes from a set, issue the removevvset command, where: ◆ is the name of the virtual volume set being removed or modified.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.15 Setting Expiration Times for Virtual Volumes You can set virtual volume expiration times with the -exp option of the following commands: ■ createvv ■ setvv ■ createsv ■ creategroupsv Use the -exp option to set an expiration time for any volume or copy of a volume. The expired virtual volumes are not automatically removed, you must use the removevv command or the System Scheduler to remove the expired volumes.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 ■ The retention time can be increased but it cannot be decreased. ■ If both of the retention time and expiration time are specified, the retention time cannot be greater than the expiration time. ■ The retention time can be set in hours or days. The minimum retention time is 1 hour and the maximum retention time is 43800 hours (1,825 days or 5 years). The default is 336 hours (14 days).
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual is the size of the volume in MB, GB, or TB. If g|G|t|T is not specified, VV_size is the number of MBs. For example, 50g specifies 50 GBs. 7.17 Removing Virtual Volumes To virtual volumes, issue the removevv or removevv command, where: ◆ is the name(s) of the virtual volume(s) to be removed. ◆ is the name of the pattern according to which virtual volumes are to be removed.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 ■ Port presents - allows any host on a specific port to see the volume. ■ Matched set - allows only a specific host on a specific port to see the volume. 7.18.1.1 Creating a Host Sees or Host Set VLUN Template To create a host sees or host set VLUN template, issue the createvlun |set: |set: command, where: ◆ is the name of the virtual volume being exported to the host.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.18.1.3 Creating a Matched Set VLUN Template To create a matched set VLUN template, issue the createvlun |set: |set: command, where: ◆ is the name of the virtual volume being exported to the host. ◆ is the name of the virtual volume set being exported to the host.
3PAR InForm CLI Administrator’s Manual ◆ InForm OS Version 2.3.1 is the name of the host set to which the virtual volume is exported. This option creates a host set VLUN template. For detailed information about the removevlun command, refer to the InForm OS Command Line Interface Reference. 7.19.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 7.20 Virtual Domains, CPGs, and Virtual Volumes You can use the CLI to create and manage virtual volumes belonging to domains just as you would manage virtual volumes that do not use 3PAR Virtual Domains. NOTE: 3PAR Virtual Domains requires the use of the 3PAR Virtual Domains license. Contact your 3PAR sales representative for details. 7.20.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 All arguments are identical to those specified in 7.4 Creating a Common Provisioning Group on page 7.6. For a complete list of options available for the createcpg command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 7.20.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual If you are an edit level user belonging to a specified domain, all options for the setvv command are available for use for virtual volumes that belong to the same specified domain. Refer to the InForm OS Concepts Guide and the setvv command in the InForm OS Command Line Interface Reference for additional information about this restriction. To modify a virtual volume in a domain, see 7.9 Modifying Virtual Volumes on page 7.13. 7.20.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 7.20.6.1 Creating VLUN Templates in the All Domain You can create host sees, matched set, and port presents VLUN templates if you are a super or edit level user belonging to the all domain. For instructions on creating each type, see 7.18.1.1 Creating a Host Sees or Host Set VLUN Template on page 7.22, 7.18.1.2 Creating a Port Presents VLUN Template on page 7.22, and 7.18.1.3 Creating a Matched Set VLUN Template on page 7.23. 7.20.6.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 8 Managing Virtual Volume Copies In this chapter 8.1 Overview 8.2 8.2 Virtual Copies 8.2 8.2.1 Creating a Virtual Copy 8.3 8.2.2 Promoting a Virtual Copy 8.3 8.2.3 Modifying a Virtual Copy 8.4 8.2.4 Removing a Virtual Copy 8.4 8.2.5 Creating a Group of Virtual Copies 8.4 8.3 Physical Copies 8.5 8.3.1 Creating a Physical Copy 8.6 8.3.2 Resynchronizing a Physical Copy 8.7 8.3.3 Promoting a Physical Copy 8.8 8.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 8.1 Overview There are two types of copies that can be created from virtual volumes: virtual copies and physical copies. ■ A virtual copy is a snapshot of an original or base volume. A virtual copy only records the changes to the original virtual volume. ■ A physical copy is a complete duplicate of all the data from a base volume to a destination volume. For more information about virtual copies, see the 3PAR InForm OS Concepts Guide.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 8.2.1 Creating a Virtual Copy Virtual copies can be read-only or read/write. Read-only and read/write copies must alternate. You can only make a read-only copy of a read/write volume and a read/write copy of a read-only volume. Expiration dates can be set for virtual copies to save space. The system allows you to make a maximum of 500 virtual copies of a base volume. Up to 256 virtual copies can be read/write copies.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 For a complete list of options available for the createsv command, see the InForm OS Command Line Interface Reference and InForm OS Command Line Interface Help. If you are using 3PAR Remote Copy, you can optionally promote the virtual copy if the base volume is in a Remote Copy group. See the InForm OS Command Line Interface Reference for detailed information about the promotesv command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual For information on arguments which can be optionally specified with the creategroupsv command, refer to the InForm OS Command Line Interface Reference. 8.3 Physical Copies A physical copy duplicates all the data from a base volume to a destination volume. The base volume is the original volume that is copied to the destination volume.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 8.3.1 Creating a Physical Copy To create a physical copy of a virtual volume, issue the createvvcopy -p -s | set: command, where: ◆ -p creates a snapshot of the parent volume, as identified by , and copies the snapshot data to the destination volume. ◆ is the name of the destination volume.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual is the name of the destination volume. The destination volume must be equal or greater in size to the parent volume, must be a writeable base volume, and must not be exported as a VLUN. NOTE: If you wish to copy multiple volumes, the : argument can be repeated multiple times on the command line for a single instance of the creategroupvvcopy command.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 8.3.3 Promoting a Physical Copy Over time, physical copies and their base volumes can change as data is written to each. At some point the association between the two volumes may no longer be relevant. The association between a physical copy and a base volume is broken by promoting the physical copy back to the base volume.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 8.4.1 Moving Snapshots Like other domain objects, snapshots can be moved from one domain to another using the movetodomain command. This action is restricted to super level users in the all domain. NOTE: If a snapshot is moved from one domain to another, the snapshot’s base volume is also moved. For further instructions see 5.7.1 Moving Domain Objects to Another Domain on page 5.5. Snapshots and Domains 8.
3PAR InForm CLI Administrator’s Manual 8.10 Snapshots and Domains InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 9 Creating and Applying Templates In this chapter 9.1 Overview 9.1 9.2 Creating Templates 9.2 9.3 Applying Templates 9.3 9.4 Modifying Templates 9.4 9.5 Removing Templates 9.5 The purpose of this chapter is to explain how to create and modify templates to quickly create standardized data objects. 9.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Properties are virtual volume, logical disk, or common provisioning group attributes such as set size. ■ A property included in a template can have a defined value or have a value that is left unspecified. A property with a defined value has had a specific value assigned to it (for example, a set size of 2). A property with an unspecified value does not have a specific value assigned to it.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 9.3 Applying Templates Once you have created a template, you can apply that template to create logical disks, virtual volumes, or common provisioning groups (CPGs). 9.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 9.4 Modifying Templates You can modify a template at any time by adding, replacing, or removing template parameters, regardless of whether the template has been applied to create logical disks, virtual volumes, or common provisioning groups. When you edit a template, no changes are made to objects you have created with that template. 9.4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 9.5 Removing Templates Removing a template deletes the template from the system, but does not delete objects created with that template. To remove a template from the system, issue the removetemplate command, where is the name of the template being removed. You can optionally remove templates matching a specific pattern by issuing the removetemplate -pat command.
3PAR InForm CLI Administrator’s Manual 9.6 Removing Templates InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 10 Monitoring System and Physical Disk Capacity In this chapter 10.1 Overview 10.2 10.2 System Capacity 10.2 10.2.1 Determining Total System Capacity 10.3 10.2.2 Determining System Capacity by Physical Disk Type 10.4 10.3 Physical Disk Capacity 10.4 10.3.1 Determining Total Physical Disk Capacity 10.4 10.3.2 Determining Physical Disk Capacity by Disk Type 10.6 10.3.3 Determining the Capacity of a Specific Physical Disk 10.6 10.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 10.1 Overview The InForm CLI provides commands to show the amount of used space and available space in an InServ Storage Server. The commands allow you to review space usage information at the system level and for each physical disk. Use the following CLI commands to review space usage information: ■ showpd - displays configuration information about the physical disks in the system.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 10.2.1 Determining Total System Capacity To determine system capacity, issue the showsys -space command.
3PAR InForm CLI Administrator’s Manual ◆ InForm OS Version 2.3.1 The free space includes the total free initialized and uninitialized spaces available for use. 10.2.2 Determining System Capacity by Physical Disk Type You can display the total capacity for all physical disks of a specific type. There are three types of physical disks: Fibre Channel (FC), Near Line (NL), and Solid State Drives (SSD).
InForm OS Version 2.3.
3PAR InForm CLI Administrator’s Manual ◆ InForm OS Version 2.3.1 failed - The disk has failed. Use showpd -state to display detailed state information. ◆ Size - The disk’s capacity. ◆ Volume - The volume’s capacity. ◆ Spare - The disk’s space reserved for spare chunklets. ◆ Free - The disk’s free space. ◆ Unavail - Unavailable disk space. ◆ Failed - Space in failed chunklets. 10.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 10.4 Spare Chunklets Some chunklets are identified as spares when the storage server is first set up at installation. Data from other chunklets is moved or reconstructed onto these spare chunklets in response to a chunklet or disk failure or when a drive magazine needs to be serviced. This initial spare storage totals the amount of storage in a single drive magazine, using the largest size physical disks.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 The following example displays information about two spare chunklets, 0 and 1, on physical disk 23: %cli PdId 23 23 showspare Chnk LdName 0 ---1 sales1.0 LdCh State --- normal 2 normal Usage Media available valid ld valid Sp Cl From Y Y --Y Y --- To ----- The fields in this output provide the following information: ■ PdId. The physical disk on which the chunklets reside. ■ Chnk.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual From. The initial location of the chunklet prior to relocation. The format is PD:CH, where PD is the physical disk ID and CH is the chunklet ID. ■ To. The destination location of the chunklet during relocation in the format PD:CH. Spare Chunklets 10.
3PAR InForm CLI Administrator’s Manual 10.10 Spare Chunklets InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 11 Managing Events and Alerts In this chapter 11.1 Overview 11.1 11.2 Checking the Status of an InServ Storage Server 11.2 11.3 Monitoring and Managing Alerts 11.2 11.4 Setting System Alerts 11.3 11.5 Monitoring and Managing the Event Log 11.4 11.6 Stopped Logical Disks and Missing Physical Disks 11.4 The purpose of this chapter is to explain how to display system alerts. 11.1 Overview The system tracks system events internally.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 11.2 Checking the Status of an InServ Storage Server The checkhealth command checks the status of an InServ Storage Servers’s hardware and software components, and reports any issues. You can specify which components you want the checkhealth command to examine or check all system components. ■ Use the checkhealth command to view a status summary of all system components.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 11.4 Setting System Alerts While most system alerts are generated automatically without any need for user configuration, there are several types of alerts that you can specifically configure. ■ Limits relating to Common Provisioning Groups (CPG) can be set by the user when creating a CPG and can later trigger alerts. For information on setting the growth increment limits, see 7.2 Common Provisioning Groups on page 7.4.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 11.5 Monitoring and Managing the Event Log The eventlog has information about all notable occurrences on the InServ. System events include all alerts the system has generated and alerts marked as acknowledged or fixed. These system events are generated and logged in the system events log. For detailed information about the events log, see the InForm OS Concepts Guide. 11.5.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 11.6.1 Preserved Data When the InServ storage system is holding data in cache but is not able to write that data to the destination disk for any reason, it saves the data to the preserved data logical disk. This logical disk is automatically created at the time that the storage system is installed and initially configured.
3PAR InForm CLI Administrator’s Manual 11.6 Stopped Logical Disks and Missing Physical Disks InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 12 Viewing Statistics and Histograms In this chapter 12.1 Overview 12.2 12.2 Viewing Statistics 12.2 12.2.1 Viewing Statistics for Physical Disks 12.2 12.2.2 Viewing Port Statistics 12.3 12.2.3 Viewing VLUN Statistics 12.4 12.2.4 Viewing Virtual Volume Statistics 12.4 12.2.5 Viewing Statistics for Data Cache Memory 12.4 12.2.6 Viewing Statistics for CPU Usage 12.5 12.3 Viewing Histograms 12.5 12.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 The purpose of this chapter is to explain how to display detailed statistics about the InServ Storage Server. 12.1 Overview The InForm CLI allows you to view aspects of system performance over time. You can view statistics for the performance of VLUNs, virtual volumes, ports, physical disks, data cache memory, and CPU usage using variations of the stat command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual ◆ specific PCI slots. ◆ specific ports. Additional filters can be used to refine the data output. Refer to the InForm OS Command Line Reference for complete details about statpd command options and for sample command data output. NOTE: The Device Speed number does not represent a rotational speed for Solid State Drives (SSD) without spinning media.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 12.2.3 Viewing VLUN Statistics To view VLUN statistics, issue the statvlun command. The data output can be further refined to display only VLUN statistics from: ◆ specific domains. ◆ specific hosts. ◆ specific virtual volumes. ◆ specific LUNs. ◆ ports from specific nodes, slots, or ports. You can use additional filters to refine the data output.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual By default, data cache memory statistics are displayed by node. You can optionally display data cache memory statistics by virtual volume by issue the statcmp -v command. You can use additional filters to refine the data output. Refer to the InForm OS Command Line Reference for complete details about statcmp command options and for sample command data output. 12.2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Several filters are provided to refine the data output to display only data from specific chunklets and logical disks,. Additional filters are provided to customize the way the histogram data is displayed. Refer to the InForm OS Command Line Reference for complete details about histch command options and for sample command data output. 12.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 12.3.4 Viewing Histograms for Ports To view histogram data for ports, issue the histport command. By default, only histogram data for data transfers are displayed. You can optionally display histogram data for control transfers or both data and control transfers by issuing the histport -ctl or histport -both command, respectively. Histogram data output can be further refined to display only port data from: ◆ specific nodes.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 12.3.6 Viewing Histograms for Virtual Volumes To view histogram data for virtual volumes, issue the histvv command. You can use additional filters to refine the histogram data output and specify how that data is displayed. Refer to the InForm OS Command Line Reference for complete details about histvv command options and for sample command data output. 12.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13 Managing Tasks In this chapter 13.1 Overview 13.2 13.2 Task Manager 13.2 13.2.1 Task IDs 13.3 13.2.2 Task Manager Commands 13.4 13.2.3 Starting a Task 13.4 13.2.4 Displaying Task Information 13.5 13.2.5 Waiting for Tasks 13.6 13.2.6 Removing a Task 13.8 13.2.7 Canceling a Task 13.8 13.3 Task Types 13.9 13.4.1 System Scheduler Commands 13.20 13.4.2 Displaying Scheduled Tasks 13.22 13.4.3 Scheduling Tasks 13.23 13.4.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 13.4.6 Removing Scheduled Tasks 13.24 The purpose of this chapter is to explain how manage and schedule long-running system tasks. 13.1 Overview Some InServ Storage Server operations with long running times can be managed as system tasks and initiated at scheduled times. The larger your system, the longer some CLI command operations take to complete. With the task manager you can pause, cancel, or remove tasks running on the system.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.2.1 Task IDs Each task is identified by a task ID. When a task is started with the InForm CLI, the system displays the task ID as part of the command output. For example, when you issue the tunevv command with the InForm CLI, a task is started in order to track the progress of the tunevv operation. The task ID is indicated in the output for the tunevv command. In the following example Task 454 is started as part of the tunevv operation.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 13.2.2 Task Manager Commands You can use the task manager commands to display, cancel, and remove tasks running on the system. See Table 13-1 for a list of the InForm CLI task manager commands. Table 13-1. Task Manager Commands Command Description Privilege Level canceltask Cancel one or more tasks. Super, Edit removetask Remove information about one or more tasks Super, Edit, Service and their details.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual To start a background_command task, issue the starttask command, where: ◆ is the name of the CLI command to run as a background_command. For a complete list of options available for the starttask command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 13.2.4 Displaying Task Information Once a task is started, you can use the task ID to obtain information about the task.
3PAR InForm CLI Administrator’s Manual ■ InForm OS Version 2.3.1 ◆ done. - The task has completed successfully. ◆ active - The task is still in process. ◆ cancelled - The task was cancelled by the user. ◆ failed - The task failed to complete due to a reason other than user cancellation. Phase - For active tasks, indicates the number of completed phases and the total number of phases in the current step, using the format <#completed_phase>/<#total_phases>.
InForm OS Version 2.3.1 cli% waittask -v 454 Id Type Name 454 tune_vv testvol Active 3PAR InForm CLI Administrator’s Manual Status Phase Step -----StartTime---- -----FinishTime-2/3 0/4 Fri Apr 29 11:42:06 PDT 2005 Detailed status: {Fri Apr 29 11:42:06 PDT 2005} Created task. {Fri Apr 29 11:42:06 PDT 2005} Tuning VV 'testvol'. {Fri Apr 29 11:42:06 PDT 2005} Scheduled region move of 256MB from (testvol.usr.1:0MB) to (testvol.usr.2:0MB).
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 NOTE: To cancel the waittask command, use CTRL+C. This stops the waittask command and returns a command prompt, but does not affect the task that is running in the background. 13.2.6 Removing a Task The removetask command only works on completed, failed, and cancelled tasks. Information about a task remains on the system unless it is manually removed using the removetask command and the task ID.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.3 Task Types See Table 13-2 for a list of all task types and the their associated operations. The table also includes information about the CLI commands associated with each operation. For a complete list of options available for the CLI commands listed in Table 13-2, see the InForm OS Command Line Interface Reference and InForm CLI Help. Table 13-2.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Table 13-2. Task Types by Operation and Command (continued) Operation Task Type (Feature or Product) Commands Description promote_sv Virtual copy promote promotesv Copies the (3PAR Virtual Copy) differences of a (3PAR Remote Copy). virtual copy back to its base volume. remote_copy_ Remote copy volume sync synchronization copy volume (3PAR Remote Copy).
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Table 13-2. Task Types by Operation and Command (continued) Operation Task Type (Feature or Product) Commands Description tune_sd Change the layout of tunevv snp _cpg Moves the logical a virtual volume disks used for the (3PAR Dynamic volume’s snapshot Optimization) space to the specified CPG.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Specific system tasks require the following licenses: ■ The promote_sv task type requires the 3PAR Virtual Copy license. ■ The remote_copy_sync task types require the 3PAR Remote Copy license. ■ The tune_vv task types require the 3PAR Dynamic Optimization license. ■ The tune_sd task type requires the 3PAR Dynamic Optimization license. NOTE: Contact your 3PAR representative for more information about 3PAR licenses. 13.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.3.4 vv_copy The vv_copy task type is used to track physical copy operations. This includes creating physical copies and resynchronizing a physical copy with its parent base volume. You can create physical copies using the createvvcopy command (see the InForm OS Command Line Interface Reference for details). You can resynchronize a physical copy using the createvvcopy command with the -r (resync) option (see 8.3.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 groups using the startrcopygroup command can also initiate a remote copy synchronization on the system. However, note that with periodic mode volume groups the startrcopygroup command will only initiate synchronization the first time that it is issued for that volume group.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.3.7 tune_vv The tune_vv task type is used to track tunevv operations performed with the 3PAR System Tuner tunevv command. The 3PAR System Tuner is an optional InForm OS feature that allows you to identify over-used physical disks as candidates for load balancing and perform load balancing on them. The tunevv command enables you to perform load balancing and to dynamically change certain volume parameters.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 13.3.8 tune_vv_restart The tune_vv_restart task type is used to track tunevv restart operations performed with the 3PAR System Tuner tunevv restart command. The tunevv restart command enables you to resume a failed or cancelled tunevv operation. The following examples shows how to start, cancel, and then restart a tunevv operation on virtual volume testvol: cli% tunevv -t r5 -ha mag testvol Task 1 started.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.3.9 tunevv_rollback The tune_vv_rollback task type is used to track tunevv rollback operations performed with the 3PAR System Tuner tunevv rollback command. The tunevv rollback command enables you to reverse any changes that resulted from a previously interrupted tunevv operation.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 For more information about the 3PAR System Tuner and the tunevv command, see Chapter 16, Performance Tuning. NOTE: The tune_vv task type and tunevv CLI command require the 3PAR Dynamic Optimization license. 13.3.10 tune_sd The tune_sd task type is used to track the movement of the logical disks used for the volume’s snapshot space to the specified CPG.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual virtual volumes, run the showvv -hist command. The TimeCalculated column shows the last time the usage was last calculated. The updatesnapspace command causes the system to start calculating current snapshot space usage. If one or more virtual volume names or patterns are specified, only the specified virtual volumes are updated. If no virtual volume names are specified, all virtual volumes are updated.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 13.4.1 System Scheduler Commands Table 13-3 summarizes the System Scheduler commands. Table 13-3. System Scheduler Commands Command Description Privilege Level showsched Show the state of tasks Super, Service currently scheduled on the system. createsched Create tasks to be Super, Service initiated by the System Scheduler. setsched Modify tasks started by Super, Service the System Scheduler.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Table 13-4. Commands Initiated by the System Scheduler Command Description Privilege Level compactld Consolidates space on Super, Edit the logical disks. creategroupsv Creates consistent group Super, Edit virtual copies or snapshots of a list of virtual volumes. creategroupvvcopy Creates consistent group Super, Edit physical copies of a list of virtual volumes.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 Table 13-4. Commands Initiated by the System Scheduler Command Description Privilege Level updatesnapspace Updates the snapshot Super, Edit space actually used by a virtual volume. This task cannot be cancelled. updatevv Updates a snapshot Super, Edit virtual volume with a new snapshot. The canceltask command cannot be used with the CLI commands initiated by the System Scheduler commands.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 13.4.3 Scheduling Tasks To create a scheduled task, issue the createsched command, where: ◆ is the name of the CLI command to be initiated. The CLI command must be one of the commands listed in Table 13-4. ◆ is a crontab-style argument that specifies when the CLI command is initiated.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 NOTE: You can use the -suspend_all and -resume_all options in place of the -suspend and -resume options to suspend or resume all scheduled tasks in the system. For a complete list of options available for the setsched command, see the InForm OS Command Line Interface Reference and InForm CLI Help. 13.4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 14 Using SNMP In this chapter 14.1 Overview 14.1 14.2 The 3PAR SNMP Agent 14.2 14.3 Registering an SNMP Manager 14.3 14.3.1 Viewing Registered Managers 14.3 14.3.2 Removing a Manager 14.4 14.3.3 Agent Community Strings 14.4 The purpose of this chapter is to explain how to monitor the InServ Storage Server with SNMP. 14.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 14.2 The 3PAR SNMP Agent The 3PAR SNMP agent runs on the InServ Storage Server and provides a management interface to enable other software products to manage 3PAR hardware using SNMP.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 14.3 Registering an SNMP Manager NOTE: For all InForm CLI commands used in this section, refer to the InForm OS Command Line Interface Reference for additional information and examples. To register the manager with the agent, use the addsnmpmgr command followed by the manager’s IP address. If you need to use one of the following options, enter it after the command and before the IP address.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 14.3.2 Removing a Manager To remove a manager from the agent’s list of registered managers, thus preventing that manager from receiving traps, use the removesnmpmgr command. If there is more than one manager running on the same server, you can distinguish between them with the -p option followed by the port to which the manager is listening.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 15 Using mySnapshot In this chapter 15.1 Overview 15.1 15.2 About mySnapshot 15.2 15.3 Setting Administrative Permissions 15.2 15.4 Replacing Virtual Volume Snapshots 15.3 15.4.1 Replacing a Read-Only Snapshot 15.3 15.4.2 Replacing a Read-Write Snapshot 15.4 The purpose of this chapter is to explain how to use the mySnapshot feature to for development environments. 15.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 15.2 About mySnapshot mySnapshot is a copy utility that uses an access control list to associate a user with certain administrative permissions and specified storage resources. Once these administrative permissions are granted for the specified resources, the user can easily replace and restore copies of their own test database with the InForm CLI updatevv command.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual You can view current administrative permissions for all users with the showuseracl command as follows: cli% showuseracl User Operation Object_Names_or_Patterns testuser1 updatevv test.rw1, test.rw2 testuser2 updatevv avvro* 15.4 Replacing Virtual Volume Snapshots A user with the appropriate permissions set (see 15.3 Setting Administrative Permissions on page 15.2) can use the updatevv command to replace a copy of a test database.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 This command removes test.ro and replaces it with a new read-only snapshot of test. This new volume is also called test.ro. NOTE: In this example, test.ro can have a VLUN associated with it. The command will remember the VLUN, remove the snapshot, create the new snapshot, and re-create the VLUN with the new snapshot. After the snapshot is replaced, testuser1 must remount the filesystem on the host. 15.4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual NOTE: In this example, test.rw1 can have VLUNs associated with it. The command will remember the VLUN, remove the snapshot, create the new snapshot, and re-create the VLUN with the new snapshot. After the snapshot is replaced, testuser1 must remount the filesystem on the host. Note that, in the above example, the replaced copy (test.rw1) is a new copy of the database made from the reference copy (test.ro1) and not the database itself (test).
3PAR InForm CLI Administrator’s Manual 15.6 Replacing Virtual Volume Snapshots InForm OS Version 2.3.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 16 Performance Tuning In this chapter 16.1 Overview 16.2 16.2 Dynamic Optimization 16.2 16.3 Changing Virtual Volume Layouts 16.4 16.4 Changing Virtual Volume RAID Types 16.5 16.5 Changing Virtual Volume Availability Levels 16.6 16.6 Changing Virtual Volume Parameters 16.7 16.7 Tracking Dynamic Optimization Progress 16.8 16.8 Compacting Logical Disks 16.10 16.9 Compacting Common Provisioning Groups 16.10 16.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 16.1 Overview The InForm OS automatically creates a balanced system layout by mapping virtual volumes to many logical disks, and creating logical disks from chunklets drawn from many physical disks. The I/O for each volume is striped across many physical disks, increasing the throughput of the volume. As the system grows and new applications are introduced, new storage usage patterns can emerge and the system performance can degrade.
InForm OS Version 2.3.1 ■ 3PAR InForm CLI Administrator’s Manual Volume layout changes after hardware upgrades. Existing virtual volumes only take advantage of resources that were present at the time of volume creation. When an InServ Storage Server is upgraded by adding nodes, cages, or disks, the original volume and logical disk layouts may no longer be optimal. Changing the layout of a virtual volume enables volumes to take full advantage of new system resources.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 16.3 Changing Virtual Volume Layouts With the tunevv command you can change the virtual volume’s parameters, RAID levels, set sizes, and disk filters by associating the virtual volume with a new CPG. You must purchase a 3PAR Dynamic Optimization license to use this command. To change the layout of volumes following a hardware upgrade, perform the following: 1 Create a new CPG. See 7.4 Creating a Common Provisioning Group on page 7.
InForm OS Version 2.3.1 ◆ 3PAR InForm CLI Administrator’s Manual is the TPVV you are modifying. 16.3.2 Fully-Provisioned Virtual Volumes To change the layout of fully-provisioned virtual volumes following a hardware upgrade, perform the following: 1 Create a new CPG. See 7.4 Creating a Common Provisioning Group on page 7.6 for instructions.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 16.4.2 Fully-Provisioned Virtual Volumes To change the RAID type of a fully-provisioned virtual volume, perform the following: 1 Create a new CPG with the RAID type to which you wish to change the volume. See 7.4 Creating a Common Provisioning Group on page 7.6 for instructions.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual 16.5.2 Fully-Provisioned Virtual Volumes To change the volume availability level of a fully-provisioned virtual volume, perform the following: 1 Create a new CPG with the device availability and RAID type to which you wish to change the volume. See 7.4 Creating a Common Provisioning Group on page 7.6 for instructions.
3PAR InForm CLI Administrator’s Manual 3 InForm OS Version 2.3.1 ◆ usr_cpg is the name of the CPG created previously in step 1. ◆ is the fully-provisioned virtual volume you are modifying. Tune the snapshot space of the volume by issuing the tunevv snp_cpg command. ◆ snp_cpg indicates the CPG to where the snapshot space is moved. ◆ is the fully-provisioned virtual volume you are modifying. 16.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual NOTE: Rollback and restart operations should not be performed on ThinlyProvisioned Virtual Volumes. 16.7.2 Rolling Back a Dynamic Optimization Operation Rolling back a Dynamic Optimization task restores a volume to its state prior to the initiation of the task. Essentially, issuing a rollback command performs an undo of the operation.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 16.8 Compacting Logical Disks Reclaim unused Logical Disk (LD) space with the compactcpg command. When multiple identical virtual volumes are created as a result of a single volume creation operation, the underlying logical disks that support those volumes are shared by the volume group. If several of the members of that volume group are later deleted, the underlying logical disks may become less efficient in the usage of space.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual To consolidate CPG space, issue the compactcpg or compactcpg command, where: ◆ is the name of the CPG you wish to compact. ◆ displays all CPGs that match the pattern. Refer to the InForm OS Command Line Interface Reference and CLI Help for detailed information about this command. 16.
3PAR InForm CLI Administrator’s Manual InForm OS Version 2.3.1 ◆ specifies that the layout of the virtual volume is displayed. ◆ specifies that chunklet statistics are displayed. ◆ specifies that if any disks with unbalanced loads are detected, the chunklets are moved from those disks for load balancing ◆ specifies that the system automatically chooses source and destination chunklets. ◆ specifies the average service time threshold in milliseconds.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Index 3PAR Domains 5.2, 6.20 3PAR MIB, location 14.2 3PAR system, requirements for connecting to 3.2 A accessing the CLI 3.22 accessing the CLI using SSH 3.22 Active Directory 4.8 Active Directory configuration SASL binding 4.9 simple binding over SSL 4.17 Active Directory LDAP configuration 4.9 using simple binding over SSL 4.17 active VLUNs 7.20, 7.22 adding and replacing template parameters 9.4 adding users to domains 4.
3PAR InForm CLI Administrator’s Manual setting path to Solaris 2.5, 3.2 user name restrictions 3.20 client-side version (-v) global option 3.5 clihelp -col 3.6 column help 3.6 commands getting help for 3.6 global options effect on 3.3 listing for specific command 3.6 listing for specific commands 3.6 non CLI. See general control and help commands compactcpg command 7.7, 16.11 configuring CHAP 6.11 connecting to a 3PAR system, requirements 3.2 consolidating CPG space 7.7 controlport command 6.2, 6.3, 6.
InForm OS Version 2.3.1 TPDFORCE 3.18 TPDPWFILE 3.11 TPDSTARTFILE 3.12 error log installation 2.5 events alerts triggered by 11.1 events log, removing 11.4 events log, viewing 11.4 exit command, definition of 3.6 export rule 7.20 exporting domain VVs 7.26 exporting virtual volumes 7.20 F Fibre Channel adapter ports setting parameters 6.2, 6.3, 6.4 creating a host path 6.8 free chunklets, defined 10.7 freeing domain VV space 7.26 freeing virtual volume snapshot space 7.17, 7.20 freespace command 7.
3PAR InForm CLI Administrator’s Manual LDAP user 4.8 limitations in Tcl shell 3.3 -listdom global option 3.5, 4.5 log files installation error log 2.6 logging logical disk allocated at set up 10.7 logical disk histograms, viewing 12.6 LUN 7.20 M management consoles registered displayed using showsnmpmgr 14.3 registering for SNMP 14.3 unregistering with removesnmpmgr 14.4 managing domain objects 5.5 matched set 7.21 minimum growth increments 7.3 modifying domain hosts 6.20 modifying domain VVs 7.
InForm OS Version 2.3.1 removing the current domain 4.8 removing the default domain 4.7 removing the events log 11.4 removing user connections 4.6 removing users from domains 4.6, 4.7 removing VLUN templates 7.22 replacing and restoring copies 15.2 replacing read-only snapshots 15.3 replacing read/write snapshots 15.4 replacing snapshots 15.3 reserved user names 3.20 resynchronizing physical copies 8.7 revision history RH.1 rolling back a virtual copy 8.3 S SASL binding 4.9 scripting 2.7, 3.
3PAR InForm CLI Administrator’s Manual modifying 9.4 removing 9.5 viewing parameters 9.4 templates, allowing overrides 9.2 templates, and default values 9.2 templates, defined values 9.2 templates, included properties 9.2 templates, rules for using 9.1 templates, specified and unspecified values 9.2 total system capacity 10.3 TPDCACHEDIR environment variable 3.4 TPDCSVTABLE environment variable 3.5 TPDFORCE environment variable 3.5 TPDHAFTER environment variable 3.5 TPDLISTDOM enivronment variable 4.
InForm OS Version 2.3.1 3PAR InForm CLI Administrator’s Manual Revision History Release Level Revision Summary 320-200180 Rev A First release of this manual to support the release of InForm OS October 2009 version 2.3.1. 320-200180 Rev B Second release of this manual to support the release of InForm OS February 2010 version 2.3.1 MU1. Revision History RH.
3PAR InForm CLI Administrator’s Manual RH.2 InForm OS Version 2.3.
