® 3PAR InForm OS 2.2.4 CLI Administrator’s Manual 3PAR, Inc. 4209 Technology Drive Fremont, CA 94538 USA Part No.
Revision Notice This is the first release of this manual. A complete revision history is provided at the end of this 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.2.4 3PAR InForm OS 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 Administration Tools 2.1 About the InForm Administration Tools 2.2 2.2 Meeting System Requirements 2.2 2.2.1 Supported Platforms 2.3 2.2.2 Operating System Update Requirements 2.3 2.2.
3PAR InForm OS CLI Administrator’s Manual 2.3.3 InForm OS Version 2.2.4 Console Installation 2.9 2.4 Setting the Path to the CLI on Solaris and Linux 2.11 2.5 Launching the InForm Management Console 2.11 2.6 Troubleshooting Installation 2.11 2.7 Removing the InForm Administration Tools 2.12 2.7.1 On Windows 2.12 2.7.2 On Solaris and Linux 2.13 2.8 Upgrading the InForm Administration Tools 2.14 2.9 Scripting Considerations 2.14 3 Running the CLI x Table of Contents 3.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4 Managing User Accounts and Connections 4.1 User Accounts 4.2 4.1.1 Creating a User 4.3 4.1.2 Viewing Users 4.4 4.1.3 Viewing User Connections 4.4 4.1.4 Removing User Connections 4.4 4.1.5 Removing a User 4.4 4.2 Users and Domains 4.5 4.2.1 Adding a User to a Domain 4.5 4.2.2 Removing a User From a Domain 4.5 4.2.3 Setting a User’s Default Domain 4.6 4.2.4 Removing a User’s Default Domain 4.6 4.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 5.4.3 Adding iSCSI Path iSCSI Names 5.6 5.4.4 Removing Fibre Channel Path WWNs 5.6 5.4.5 Removing iSCSI Path iSCSI Names 5.6 5.4.6 Configuring iSCSI CHAP Authentication Information 5.7 5.4.7 Removing iSCSI CHAP Authentication Information 5.7 5.5 Removing a Host 5.7 5.6 Hosts and Domains 5.8 5.6.1 Creating a Domain-Specific Host 5.8 5.6.2 Modifying a Domain-Specific Host 5.8 5.6.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7.5 Growing Virtual Volumes 7.5 7.6 Freeing Virtual Volume Snapshot Space 7.6 7.7 Exporting Virtual Volumes 7.7 7.7.1 Creating VLUN Templates 7.8 Unexporting Virtual Volumes 7.7 7.9 7.8.1 Removing a Host Sees VLUN Template 7.9 7.8.2 Removing a Port Presents VLUN Template 7.9 7.8.3 Removing a Matched Set VLUN Template 7.9 7.9 Removing Virtual Volumes 7.10 7.10 Common Provisioning Groups 7.10 7.10.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.13.5 Exporting Virtual Volumes in Domains 7.19 7.13.6 Creating a Common Provisioning Group in a Domain 7.20 7.13.7 Moving a Common Provisioning Group to a Domain 7.21 8 Creating and Working with Snapshots 8.1 Overview 8.2 8.2 Snapshot Volumes 8.2 8.3 Virtual Copies 8.3 8.3.1 Creating a Virtual Copy 8.3 8.3.2 Promoting a Virtual Copy 8.3 8.3.3 Modifying a Virtual Copy 8.4 8.3.4 Removing a Virtual Copy 8.4 8.3.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 10 Space Usage 10.1 Overview 10.1 10.2 System Capacity 10.2 10.2.1 Determining Total System Capacity 10.2 10.2.2 Determining System Capacity by Storage Device Type 10.3 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 Device Type 10.5 10.3.3 Determining a Single Physical Disk’s Capacity 10.6 11 Managing Events and Alerts 11.1 Overview 11.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 12.3 Viewing Histograms 12.5 12.3.1 Viewing Histograms for Chunklets 12.5 12.3.2 Viewing Histograms for Logical Disks 12.5 12.3.3 Viewing Histograms for Physical Disks 12.6 12.3.4 Viewing Histograms for Ports 12.6 12.3.5 Viewing Histograms for VLUNs 12.7 12.3.6 Viewing Histograms for Virtual Volumes 12.7 13 Task Management 13.1 Overview 13.2 13.2 About Tasks 13.2 13.2.1 Task IDs 13.2 13.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 14.3.1 Viewing Registered Managers 14.3 14.3.2 Removing a Manager 14.4 14.3.3 Agent Community Strings 14.4 15 Using Dynamic Optimization 15.1 Overview 15.2 15.2 Types of Virtual Volumes 15.2 15.3 Dynamic Optimization 15.3 15.3.1 15.4 Dynamic Optimization CLI Commands 15.4 Volume Re-Layout Following Hardware Upgrade 15.4 15.4.1 Base VVs 15.4 15.4.2 TPVVs 15.5 15.4.3 CPVVs 15.5 15.5 Changing Volume RAID Level 15.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 15.10.1 Rolling Back a Dynamic Optimization Operation 15.14 15.10.2 Restarting a Dynamic Optimization Operation 15.14 16 Using mySnapshot IX RH xviii Table of Contents 16.1 Overview 16.1 16.2 About mySnapshot 16.2 16.3 Setting Administrative Permissions 16.2 16.4 Replacing Virtual Volume Snapshots 16.3 16.4.1 Replacing a Read-Only Snapshot 16.3 16.4.2 Replacing a Read-Write Snapshot 16.
InForm OS Version 2.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual 1.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 1.5 Organization This guide is organized as follows: Chapter 1, Introduction (this chapter), provides an overview of this guide, including information on audience, related documentation, and typographical conventions. Chapter 2, Installing the InForm Administration Tools, gives instructions for installing the InForm CLI and connecting to storage servers.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Chapter 13, Task Management, 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.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Typeface Meaning Example Used for variables Modify the content string by in filenames, adding the -P option paths, and screen after -jar inform.jar output. 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.2.4 3PAR InForm OS CLI Administrator’s Manual 2 Installing the InForm Administration Tools In this chapter 2.1 About the InForm Administration Tools 2.2 2.2 Meeting System Requirements 2.2 2.3 Installation 2.6 2.4 Setting the Path to the CLI on Solaris and Linux 2.11 2.5 Launching the InForm Management Console 2.11 2.6 Troubleshooting Installation 2.11 2.7 Removing the InForm Administration Tools 2.12 2.8 Upgrading the InForm Administration Tools 2.14 2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 2.1 About the InForm Administration Tools The InForm Administrative Tools are composed of the following components. If you choose the standard installation, all components are installed by default: Table 2-1. InForm Administrative Tools Component Description InForm InForm graphical user interface used to manage Management InServ Storage Servers. Console InForm CLI InForm Command Line Interface used to manage InServ Storage Servers.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 2.2.1 Supported Platforms The InForm Administration Tools are supported on the following operating systems: Table 2-2. Supported Operating Systems and Versions Operating System Versions Sun™ Solaris™ 8, 9 Microsoft® Windows® Windows® 2000 Windows XP® Professional Windows Server™ 2003 Windows Server™ 2003 x64 Edition Redhat® Enterprise Linux 5 SuSE® Enterprise Linux 10 Linux® 2.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 For Windows, Table 2-3 lists the required service packs for installing and running the InForm Administration Tools. Table 2-3. Windows Required Service Packs Windows OS Service pack Windows 2000 Service Pack 3 or later Windows XP Professional Service Pack 2 or later Windows Server 2003 Service Pack 1 or later Windows Server 2003 x64 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual The application requires free space equal to 3 times the size of the installation package. If the application cannot find enough free space on the volume, the application prompts the user for an alternate temporary location. Table 2-4.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 2.2.5 Changing Temporary Space Location This section describes how to change the InstallAnywhere temporary space location on Windows, Solaris and Linux systems. See Table 2-5 for instructions. Table 2-5.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Verify that all system requirements have been met. See 2.2 Meeting System Requirements on page 2.2 for specifics. CAUTION: Do not run multiple installations of the InForm OS Administration Tools at the same time. If you install or remove one or more versions of the InForm OS Administration Tools simultaneously, the procedure may fail. You have a choice between the graphical installation (default) and a character-based installation.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Alternatively, if you wish to add runtime options to the install (for instance, to specify the location of InstallAnywhere’s temporary directory), you must run the installation from a command window as follows: 1 Insert the InForm OS Administration Tools CD into your drive. 2 Open a command window and type the following command, followed by any runtime options: :\windows\setup.exe 2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 2.3.2.2 On Solaris On Solaris systems, you must start the installation manually as follows: 1 Log in as root. 2 Insert the InForm OS Administration Tools CD into your drive. 3 Start the installation using the setup.bin file as follows: NOTE: To to add runtime options to the install (for instance, to specify the location of InstallAnywhere’s temporary directory), add those options to the end of the statement in step 3.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 2.3.3.1 On Windows It is not recommended that you use console installation on Windows systems. 2.3.3.2 On Solaris Complete the console InstallAnywhere installation of the InForm Administration Tools on Solaris as follows: 1 Insert the InForm OS Administration Tools CD into your drive. 2 Start the installation using the setup.bin file as follows: /cdrom/inform_adm_tools/solaris/setup.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 2.4 Setting the Path to the CLI on Solaris and Linux Once the CLI has been installed on your system, the InstallAnywhere application attempts to automatically set the path to the CLI for the root user by adding an entry to your local login file. The modified file is specific to the shell that you are using during CLI installation. If InstallAnywhere is unable to modify the login file, you will need to set the path the CLI manually.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 For Solaris and Linux, if you installed the InForm Administration Tools in the default location, this log file is located at: /opt/3par/install.log For Windows, if you installed the InForm Administration Tools in the default location, this log file is located at: C:\Program Files\3PAR\install.log 2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 2.7.2 On Solaris and Linux NOTE: For Solaris and Linux, you can remove the InForm Administrative Tools from your Desktop Windows Manager by running an X server (your DISPLAY variable must also be set correctly). However, you can also use -i console option to remove the application using text-only menus. Follow the instructions on your screen to complete the deinstallation.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 2.8 Upgrading the InForm Administration Tools To upgrade the InForm Administration Tools: 1 Remove the current version of the InForm Administration Tools using the instructions provided in 2.7 Removing the InForm Administration Tools on page 2.12. 2 Install the upgraded version of the InForm Administration Tools using the instructions provided in 2.3 Installation on page 2.6. 2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 3 Running the CLI 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 TPD Port 3.8 3.2.5 Setting the System Name 3.9 3.2.6 Setting Your Name and Password 3.10 3.2.7 Caching Client Bytecode 3.12 3.2.8 Startup Files 3.12 3.2.9 Comma Separated Values 3.13 3.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 3.3 Stand-alone Commands 3.19 3.4 SSH 3.19 3.
InForm OS Version 2.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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 TPD Port on page 3.8.
InForm OS Version 2.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual 3.2.5 Setting the System Name By setting the system name, you are not prompted for your system name, user name, and password when running the CLI, which can be useful for scripting. You can specify the system name in the following three ways: Set the TPDSYSNAME environment variable. Use the –sys command line global option. Enter the system name when prompted. 3.2.5.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual 3.2.8.1 Setting the TPDSTARTFILE Environment Variable On Solaris X To set the TPDSTARTFILE environment variable in Solaris, 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 3.2.9.1 Setting the TPDCVSTABLE Environment Variable On Solaris X To set the TPDCVSTABLE environment variable in Solaris, see the following system output example.: $ TPDCSVTABLE=1 $ export TPDCVSTABLE $ cli 3.2.9.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual The following example displays CLI output with and without the domain column: cli% showvv Id Name Domain Type CopyOf BsId Rd State AdmMB SnapMB userMB 0 admin - Base --0 RW started 0 0 10240 1 test1 - Base --1 RW started 0 0 1024 5 test2 dom1 Base --5 RW started 0 0 10240 6 test3 dom2 Base --6 RW started 0 0 10240 ...
3PAR InForm OS CLI Administrator’s Manual 4 InForm OS Version 2.2.4 Click OK. 3.2.10.3 Using the -listdom Option To set the -listdom global option, see the following example: $ cli -listdom 3.2.11 Table Headers and Totals InForm CLI output can be configured to either display or not display column headings and totals. If you are using scripts, you may want to set the CLI output to omit the display of headings and totals to facilitate parsing by your scripts.
InForm OS Version 2.2.
3PAR InForm OS CLI Administrator’s Manual 3 Enter 1 in the Value box. 4 Click OK. InForm OS Version 2.2.4 3.2.11.3 Using the -nohdtot Option To set the -nohdtot or -hafter global option, see the following example: $ cli -nohdtot Substitute -hafter for -nohdtot in the example above as necessary. 3.2.12 Forcing Commands A number of CLI commands return confirmation prompts before executing the command operations.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 3.3 Stand-alone Commands There are two ways to issue CLI commands from a shell prompt in Solaris or from a Windows command prompt: CLI commands can be executed like typical UNIX and MS-DOS commands. If the CLI commands are run as individual commands, you are prompted for your username and password for each command. This can be avoided by setting your system to read your username and password from a file. See 3.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 SSH client applications are typically provided with the following operating systems: AIX HP–UX Linux Sun™ Solaris™ For Microsoft® Windows® users, an SSH client is available at http://www.openssh.org. 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.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 3.4.2 CLI User Name Restrictions Using SSH There are several CLI user names that are reserved for use by 3PAR®. Reserved names are as follows: root daemon bin console nobody sshd telnetd sys sync man proxy 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 If you upgraded your system from InForm O.S.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 In the previous example, a user with the reserved user name of pw1 is removed. X To create a new user, issue the createuser command. cli% createuser ROOT1 all edit In the previous example, new user ROOT1 is created. NOTE: See the 3PAR InForm OS Command Line Interface Reference for complete information about these commands. 3.4.3 Accessing the CLI Using SSH NOTE: The following screen examples display output for UNIX systems.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual When prompted to continue, enter yes. This is normal SSH behavior because the client host does not have the InServ system’s public key. If InServ system’s public key has been stored on the client host before this connection, this message will not be displayed. After you have set the key, on subsequent connections this message will not be displayed.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 3.4.4 CLI Scripting Through SSH You can use SSH key authentication to issue CLI commands in scripts. No password is required, however you will need to generate a public/private key pair. The public key must be stored on the InServ system using the setsshkey command to enable log in without a password. The private key must be kept in a file accessible by scripts that use CLI commands.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual To create a key pair using dsa format: $ ssh–keygen –b 1024 –t dsa Generating public/private dsa key pair. Enter file in which to save the key (/home/usr/user3/.ssh/id_dsa): Created directory '/home/usr/user3/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/usr/user3/.ssh/id_dsa. Your public key has been saved in /home/usr/user3/.ssh/id_dsa.pub.
3PAR InForm OS CLI Administrator’s Manual 4 InForm OS Version 2.2.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. It's better to copy it from inside an editor and paste it here. (Please make sure there is no extra blanks.) ssh–rsa AF5afPdciUTJ0PYzB6msRxFrCuDSqDwPshqWS5tGCFSoSZdE= user3’s pubic key SSH public key successfully set! 5 Write your script.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4 Managing User Accounts and Connections In this chapter 4.1 User Accounts 4.2 4.1.1 Creating a User 4.3 4.1.2 Viewing Users 4.4 4.1.3 Viewing User Connections 4.4 4.1.4 Removing User Connections 4.4 4.1.5 Removing a User 4.4 4.2 Users and Domains 4.5 4.2.1 Adding a User to a Domain 4.5 4.2.2 Removing a User From a Domain 4.5 4.2.3 Setting a User’s Default Domain 4.6 4.2.4 Removing a User’s Default Domain 4.6 4.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 4.3.2 Active Directory LDAP Configuration with Simple Binding Over SSL 4.15 4.3.3 OpenLDAP Configuration with Simple Binding Over SSL 4.24 4.4 LDAP Connection on Systems Using Domains 4.29 4.1 User Accounts A user account is required to access an InServ Storage Server. The first user account must be set up on the node itself. A user class is assigned to each user that wishes to access an InServ storage system.
InForm OS Version 2.2.4 3PAR InForm OS 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 superuser 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 4.1.2 Viewing Users X To view a list of users, their user classes, and domain associations (if you are using domains), issue the showuser command. Refer to the InForm OS Command Line Interface Reference for details about this command. If you are using domains, users with Super level privilege can view all system users across all domains. If you belong to a specific domain, you can only view users within that particular domain.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4.2 Users and Domains If you are using domains your existing users can be modified in the following ways: Users can be added to a domain. Users can be removed from a domain. Users can be set to work in a default domain. Users can be set to work in a current domain. 4.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 4.2.3 Setting a User’s Default Domain A user’s default domain is the domain that user will access upon each working CLI session. NOTE: Prior to setting a specific domain as a user’s default, the user must previously have been assigned accessibility within that domain.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4.3 LDAP Connection The InForm OS provides an LDAP client that can be configured to use an LDAP server for authentication and authorization of InServ Storage Server users. Currently, the only supported LDAP server implementation is Active Directory. NOTE: At the current time, support for the OpenLDAP directory implementation with the InServ Storage Server is also available, however, on a limited basis.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Issue the ldapsearch command and record the displayed dnsHostName (the value used for the ldap-server-hn parameter) and ldapServiceName (the value used for the kerberos-realm parameter) attributes for later use. Run ldp.exe as follows: 1) Click Start > Run. 2) In the Open box, enter ldp and click OK. 3) The Ldp window opens. 4) In the Ldp window, click Connection > Connect.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.8 and displays the following: The LDAP server’s IP address is 192.168.10.13. The DNS_HostName is domaincontroller.3par.com.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4.3.1.3 Configuring Account Location Parameters To configure the account location parameters: 1 If you are unsure of the user’s account information, select a known user’s full name (to be entered as the cn value) and run the ldapsearch command using the defaultNamingContext value previously displayed in 4.3.1.1 Configuring Connection Parameters on page 4.8. Make a note of the group information displayed in the command’s output.
3PAR InForm OS CLI Administrator’s Manual InServ1 InServ1 InServ1 InServ1 cli% cli% cli% cli% setauthparam setauthparam setauthparam setauthparam InForm OS Version 2.2.4 -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.11 through step 5 on page 4.11. The Users group within the 3par group is set as the basis for any user search when authenticating with the LDAP server.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual The example above corresponds to step 6 on page 4.11, and shows that 3PARuser is a member of the following hierarchy of groups: Engineering Software Eng Golfers In this example, 3PARuser is not yet authenticated or authorized because 3PARuser’s groupto-privilege mapping has not been configured. 4.3.1.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Example: InServ1 cli% setauthparam -f edit-map CN=Software,CN=Users,DC=3par,DC=com InServ1 cli% setauthparam -f browse-map CN=Eng,CN=Users,DC=3par,DC=com In the example above: Users belonging to the Software group are configured to have edit privileges within the system. Users belonging the Eng group are configured to have browse privileges within the system. InServ1 cli% checkpassword 3PARuser ...
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 4.3.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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.16 and displays the following: The LDAP server’s IP address is 192.168.10.13. The DNS_HostName is domaincontroller.3par.com.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 3PAR InForm OS 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.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual InServ1 cli% checkpassword 3PARuser ...
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 4.3.
InForm OS Version 2.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual setauthparam account-name-attr sAMAccount setauthparam memberof-attr memberOf checkpassword Configure group-to-privilege mapping parameters using the following command: InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS 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.30. As shown, name is the attribute used as the basis of the domain name search. InServ1 cli% checkpassword 3PARuser ...
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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. 4.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 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.30. As shown, InServDomain= is the start point of the domain name search within the information returned from the domain-name-attr description parameter described above.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 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. LDAP Connection on Systems Using Domains 4.
3PAR InForm OS CLI Administrator’s Manual 4.36 LDAP Connection on Systems Using Domains InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 5 Adding, Modifying, and Removing Hosts In this chapter 5.1 Overview 5.1 5.2 Creating a Host 5.2 5.3 Setting the Port Persona 5.3 5.4 Modifying a Host 5.5 5.5 Removing a Host 5.7 5.6 Hosts and Domains 5.8 NOTE: To install and setup host connectivity with the 3PAR InServ Storage Server, refer to the 3PAR Best Practice document for a given operating system and follow the step-by-step instructions. 5.
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 To display WWNs and/or iSCSI Names from connected devices, issue the showhost command. However, you can also use the InForm CLI to add new WWNs or iSCSI Names for unestablished host paths and assign them to a host before they are physically connected. 5.2 Creating a Host NOTE: To maintain system redundancy, 3PAR recommends establishing a physical connection between your host and node pairs.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 5.2.3 Creating a Host without Assigning a Path In instances where the HBA’s Fibre Channel WWN or iSCSI Name is unavailable, you can create a host as a “placeholder” until the path information becomes available. X Issue the createhost command, where is the userdesignated name of the host being defined. 5.2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Table 5-1. Port Persona Settings 5.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Table 5-1. Port Persona Settings (continued) Persona number Vendor Adapter type OS Level Connection 18 Generic Generic Data 0 Direct connect (DC) 0 Fabric attached (FA) ONTAP® 19 Generic Generic Data ONTAP® NOTE: This list of persona numbers may be expanded in the future. To see all the personas currently available, use the controlport -h command to display the help for this command.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 is the original name of the host you are modifying. 5.4.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. 2 Issue the createhost -add command, where: 3 is the name of the host being modified. is the HBA’s WWN. Repeat as necessary for any additional WWNs you wish to add to the host definition. 5.4.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 5.4.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. X To configure a host as a CHAP initiator, issue the sethost initchap command. X To configure a host as a CHAP target, issue the sethost targetchap command.
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 If VLUNs have been exported to the host, issue the removehost -rvl command. For information about exporting VLUNs, see 7.7 Exporting Virtual Volumes on page 7.7. 5.6 Hosts and Domains NOTE: 3PAR Virtual Domains requires the use of the 3PAR Virtual Domains license. Contact your local 3PAR representative for further details.
InForm OS Version 2.2.4 5.4.2 Adding Fiber Channel Path WWNs on page 5.6. 5.4.3 Adding iSCSI Path iSCSI Names on page 5.6. 5.4.4 Removing Fibre Channel Path WWNs on page 5.6. 5.4.5 Removing iSCSI Path iSCSI Names on page 5.6. 3PAR InForm OS 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).
3PAR InForm OS CLI Administrator’s Manual 5.10 Hosts and Domains InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 6 Managing Virtual Domains In this chapter 6.1 Overview 6.1 6.2 Creating a Domain 6.2 6.3 Viewing Domains 6.2 6.4 Modifying a Domain 6.3 6.5 Removing a Domain 6.3 6.6 Managing Domain Objects 6.4 NOTE: 3PAR Virtual Domains requires a 3PAR Virtual Domains license. Contact your local service provider for details. 6.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 provides instructions on creating domains and describes the administration tasks associated with maintaining domains. 6.2 Creating a Domain X To create a domain, issue the createdomain command, where is the name you wish to assign the domain. The can be a maximum of 31 characters in length.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 6.4 Modifying a Domain For any existing domain, you can change the domain’s name or add comments to that domain using the setdomain command. Refer to the InForm OS Command Line Interface Reference for details about the command. 6.4.0.1 Changing a Domain Name X To change a domain’s name, issue the setdomain -name command, where: is the new name you wish to assign the domain.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 6.6 Managing Domain Objects Domain objects can be moved from one domain to another, or have their domain associations entirely removed. In doing so, all objects related either directly or indirectly to the domain object being managed are also moved or removed. These relationships include, but are not limited to, VLUNs between hosts and VVs, VVs which are drawing from CPGs, and multiple VVs sharing the same LD.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 6.6.2 Removing the Domain Association from a Domain Object X 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.
3PAR InForm OS CLI Administrator’s Manual 6.6 Managing Domain Objects InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7 Creating, Modifying, and Removing Virtual Volumes In this chapter 7.1 Overview 7.3 7.2 System Guidelines for Volume Creation 7.3 7.3 Creating Logical Disks and Virtual Volumes 7.3 7.3.1 Creating Stand-Alone Virtual Volumes 7.4 7.3.2 Creating Virtual Volumes Using Common Provisioning Groups 7.4 7.4 Modifying Virtual Volumes 7.5 7.4.1 Modifying a Virtual Volume to Draw from a CPG 7.5 7.5 Growing Virtual Volumes 7.5 7.
3PAR InForm OS CLI Administrator’s Manual 7.9 Removing Virtual Volumes 7.10 7.10 Common Provisioning Groups 7.10 7.10.1 Growth Increment Considerations 7.11 7.10.2 Creating a Common Provisioning Group 7.12 7.10.3 Modifying a Common Provisioning Group 7.13 7.10.4 Consolidating Common Provisioning Group Space 7.14 7.10.5 Removing a Common Provisioning Group 7.14 7.11 Thinly Provisioned Virtual Volumes 7.14 7.11.1 Creating a Thinly Provisioned Virtual Volume 7.14 7.11.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7.1 Overview Virtual volumes are built on logical disks, which are built on physical disks, and are the only logical storage component visible to hosts. 7.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.3.1 Creating Stand-Alone Virtual Volumes X To create virtual volumes and their underlying logical disks where the objects’ layout is automatically configured by the system, issue the createaldvv -t -ssz command, where: -t is the RAID type for the created volume, specified as r0 (RAID 0), r1 (RAID 1), or r5 (RAID 5).
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Concepts Guide for information about CPGs and 7.10 Common Provisioning Groups on page 7.10 for information about creating and allocating storage using CPGs. 7.4 Modifying Virtual Volumes Any existing virtual volume can be modified to have a new name, draw from a CPG, or to adhere to specific policies. To modify an existing VV, issue the setvv command.
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 If you used the createaldvv command to create your virtual volume (as described in 7.3.1 Creating Stand-Alone Virtual Volumes on page 7.4), grow the volume by issuing the growaldvv command, where: is the area of the volume you wish to grow followed by the grow size. Valid arguments are: -szu specifies the user volume. -sza specifies the administration volume.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual is the name of the pattern from which snapshot space is to be made available from all volumes matching that pattern name. NOTE: The freespace command is only applicable to volumes which do not have snapshots or volumes which are not TPVVs. For additional information, see the InForm OS Command Line Interface Reference. For information about TPVVs, see the InForm OS Concepts Manual.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.7.1.1 Creating a Host Sees VLUN Template X To create a host sees VLUN template, issue the createvlun command, where: is the name of the virtual volume. is the LUN where the virtual volume is to be exported, expressed as an integer from 0 through 65536. is the name of the host to which the virtual volume is exported.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7.8 Unexporting Virtual Volumes In order to halt the export of a virtual volume, you must remove the VLUNs associated with that volume. You must remove a VLUN template in order to remove the active VLUNs associated with that template. Removing all VLUNs for a host stops the host from accessing any volumes. 7.8.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 is the location of the target port used to export the virtual volume. is the name of the host to which the virtual volume was exported. For information on arguments which can optionally be specified with the removevlun command, refer to the InForm OS Command Line Interface Reference. 7.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual You can create two types of base volumes that draw from the CPG's logical disk pool: Thinly Provisioned Virtual Volumes (TPVVs) and Commonly Provisioned Virtual Volumes (CPVVs). These two volume types draw from the pool in different ways. For information on TPVVs and CPVVs, refer to the 3PAR InForm Concepts Guide. 7.10.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 In order to take full advantage of CPG functionality, it may be desirable in some cases to use a larger growth increment. However, a smaller growth increment carries less risk in that it can prevent the CPG from automatically allocating a large amount of space at an inopportune time. The growth increment you choose will depend on several factors including but not limited to the following: Total available space on your system.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7.10.3 Modifying a Common Provisioning Group You can modify CPGs in several ways. The following modifications are commonly performed on CPGs using variations of the setcpg command and are described in the sections that follow: Specify the percentage of used snapshot administration space or snapshot data space that will generate an alert. Specify the amount of logical disk storage space created on each auto-grow operation.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.10.4 Consolidating Common Provisioning Group Space Over time you may wish to consolidate space in your CPGs for better efficiency. X To consolidate CPG space, issue the compactcpg or compactcpg command, where: is the name of the CPG you wish to compact. is the pattern name to which matching CPGs are compacted.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual -usr_al is the allocation limit of the user data space specified in percentage. This prevents the user data space from exceeding a specified percentage of the volume’s size. is the name of the CPG from which the created volume is provisioned. is the name of the volume being created. The name can be up to 31 characters. is the size in MB or GB of the volume being created.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.11.4 Removing a Thinly Provisioned Virtual Volume X To remove a TPVV, issue the removevv command, where is the name of the TPVV being removed. The logical disks belonging to the CPG from which the TPVV draws remain. For a complete list of arguments that can be used with the removevv command, see the InForm OS Command Line Interface Reference. 7.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Additional parameters can optionally be specified when issuing the createaldvv command. Refer to the InForm OS Command Line Interface Reference for detailed information. 7.12.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 7.13 Virtual Volumes and Domains NOTE: 3PAR Virtual Domains requires the use of the 3PAR Virtual Domains license. Contact your local 3PAR representative for further details. 3PAR Virtual Domains allows you to create and manage VVs belonging to domains just as you would VVs in 3PAR systems not using domains. 7.13.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 7.13.2 Modifying Virtual Volumes in Domains Domain virtual volumes can be modified just as VVs in systems without domains can be modified. However, some restrictions apply to domain VV modification. If you are super or edit level user belonging to the all domain, all VV modification options for the setvv command are available for use and you can modify any VV in the system.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Edit level users belonging to a specified domain can only export VVs to hosts belonging to that domain. Refer to the InForm OS Concepts Guide and the createvlun command in the InForm OS Command Line Interface Reference for details about this restriction. 7.13.5.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual -sdgl is the growth limit which cannot be exceeded during autogrow operations. If 0 (default) is specified, no limit is enforced. -sdgw is the space limit for logical disk space before a warning alert is generated. If 0 (default) is specified, no warning limit it enforced. -t is the RAID type, specified as r0 (RAID 0), r1 (RAID 1), or r5 (RAID 5). is the name of the CPG being created.
3PAR InForm OS CLI Administrator’s Manual 7.22 Virtual Volumes and Domains InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 8 Creating and Working with Snapshots In this chapter 8.1 Overview 8.2 8.2 Snapshot Volumes 8.2 8.3 Virtual Copies 8.3 8.3.1 Creating a Virtual Copy 8.3 8.3.2 Promoting a Virtual Copy 8.3 8.3.3 Modifying a Virtual Copy 8.4 8.3.4 Removing a Virtual Copy 8.4 8.3.5 Creating a Group of Virtual Copies 8.4 8.4 Physical Copies 8.5 8.4.1 Creating a Physical Copy 8.5 8.4.2 Resynchronizing a Physical Copy 8.7 8.4.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 8.1 Overview This chapter explains how to use the InForm CLI to create virtual and physical copies of virtual volumes. NOTE: 3PAR Thin Provisioning and snapshot functionality are optional system features which must be licensed separately from other 3PAR software products and features. 8.2 Snapshot Volumes There are two types of copy volumes, or snapshots, that can be created from virtual volumes: virtual copies and physical copies.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 8.3 Virtual Copies A virtual copy is a snapshot of another virtual volume (a base volume or another virtual copy) created using copy-on-write techniques available only with a 3PAR Virtual Copy license. Virtual copies can be: Created Promoted Modified Removed You can also create a group of virtual copies. For additional information about virtual copies, see the 3PAR InForm OS Concepts Guide. 8.3.
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 To promote a virtual copy to a base volume or to any of the virtual copy’s RW parents in the same VV family tree, issue the promotesv command. The is the name of the virtual copy being promoted. The virtual copy and the target of the promote must not be exported. Only one promote operation is allowed at a time within a VV family tree.
InForm OS Version 2.2.4 3PAR InForm OS 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.4 Physical Copies A physical copy is a snapshot-in-time that duplicates all the data from one base volume to another base volume (the destination volume).
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 To create a physical copy of a virtual volume, issue the createvvcopy -p -s 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.2.4 3PAR InForm OS CLI Administrator’s Manual 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. For information on arguments which can be optionally specified with the creategroupvvcopy command, refer to the InForm OS Command Line Interface Reference. 8.4.
3PAR InForm OS CLI Administrator’s Manual X InForm OS Version 2.2.4 To promote a physical copy to a base volume, issue the promotevvcopy command, where is the name of the physical copy being promoted. During promotion, the saved snapshot of the physical copy is removed. 8.5 Snapshots and Domains NOTE: 3PAR Virtual Domains requires the use of the 3PAR Virtual Domains license. Contact your local 3PAR representative for further details.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 8.5.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 6.6.1 Moving Domain Objects to Another Domain on page 6.4. Snapshots and Domains 8.
3PAR InForm OS CLI Administrator’s Manual 8.10 Snapshots and Domains InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS 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 9.1 Overview You can use the InForm CLI to create templates that enable you to apply a set of parameters that automatically create logical disks, virtual volumes, or common provisioning groups with the same or similar characteristics.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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. When you apply a template that includes a property with one or more unspecified values, the system will either use the default value (when applicable) or calculate the optimized setting for you.
InForm OS Version 2.2.4 3PAR InForm OS 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual is the name of the template being modified. 9.5 Removing Templates Removing a template deletes the template from the system, but does not delete objects created with that template. X To remove a template from the system, issue the removetemplate command, where is the name of the template being removed.
3PAR InForm OS CLI Administrator’s Manual 9.6 Removing Templates InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 10 Space Usage In this chapter 10.1 Overview 10.1 10.2 System Capacity 10.2 10.2.1 Determining Total System Capacity 10.2 10.2.2 Determining System Capacity by Storage Device Type 10.3 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 Device Type 10.5 10.3.3 Determining a Single Physical Disk’s Capacity 10.6 10.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 10.2 System Capacity The InForm CLI provides detailed views of the InServ system’s total capacity, as well as the system’s total capacity by storage device type. 10.2.1 Determining Total System Capacity X To determine system capacity, issue the showsys -space command.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual The allocated space includes the following: all base volumes and the volumes’ user, copy, and administration spaces. provisioned groups and volumes and their used and unused copy and administration spaces. unmapped volumes. system space, which includes administration volumes, log files, and physical disk system data, as well as used and unused spare space.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 10.3 Physical Disk Capacity The InForm CLI allows you to view capacity for all physical disks in your system, capacity of physical disks by device type, as well as the capacity for a single physical disk in your system. 10.3.1 Determining Total Physical Disk Capacity X To view the total physical disk capacity of the system, issue the showpd -space command.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual State - The state of the physical disk. The following disk states can appear: valid - The disk is valid. invalid - The disk has an invalid label. missing - The disk is marked as missing. notready - The disk is not ready for use. new - The disk is new and must be admitted before it can be used. failed - The disk has failed. invdrvtp - The disk type is invalid. indrvfw - The disk’s firmware is invalid.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 10.3.3 Determining a Single Physical Disk’s Capacity Physical disk capacity can be filtered by disk ID to display a specific disk’s capacity information. NOTE: The output for the command listed below is displayed in the same format as the showpd -space command output example in 10.3.1 Determining Total Physical Disk Capacity on page 10.4.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 11 Managing Events and Alerts In this chapter 11.1 Overview 11.1 11.2 Monitoring and Managing Alerts 11.2 11.3 Setting System Alerts 11.2 11.4 Monitoring and Managing the Events Log 11.3 NOTE: To install and set up host connectivity with the 3PAR InServ Storage Server, refer to the appropriate 3PAR Implementation Guide for a given operating system, and follow the step-by-step instructions. 11.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 11.2 Monitoring and Managing Alerts Alerts are system events that require your immediate attention. An alert may be triggered by a single event, a combination of events, or by repeated occurrences of the same event. The system administrator is responsible for responding to alerts. For detailed information about alerts, see the InForm OS Concepts Guide and the InForm OS Messages and Operator’s Guide. 11.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual The raw space alert is a global threshold that can be set for the storage system in order to alert administrators when available space on the system falls below a user-specified level. When the available space on the storage system falls below this user-specified threshold, an alert is generated. The following section describes how to set and change this raw space alert threshold. 11.3.
3PAR InForm OS CLI Administrator’s Manual 11.4 Monitoring and Managing the Events Log InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS 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.3 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.4 12.3 Viewing Histograms 12.5 12.3.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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. In addition, the InForm CLI provides service time and I/O size histograms for system resources such as chunklets, logical and physical disks, ports, VLUNs, and virtual volumes. 12.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 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. 12.2.2 Viewing Port Statistics To view port statistics, issue the statport command. By default, only statistics for data transfers are displayed.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 You can use additional filters to refine the data output. Refer to the InForm OS Command Line Reference for complete details about statvlun command options and for sample command data output. 12.2.4 Viewing Virtual Volume Statistics NOTE: Virtual volumes may be accessed externally by hosts and internally by the system prefetcher.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 12.3 Viewing Histograms This section provides instructions on using commonly used CLI commands to access histogram data on system resources. The commands described here are a subset of the histogram commands available. For a complete list of histogram commands, see the InForm OS Command Line Interface Reference.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 Reference for complete details about histld command options and for sample command data output. 12.3.3 Viewing Histograms for Physical Disks To view histogram data for physical disks, issue the histpd command. Histogram data output can be further refined to display physical disk data from: a specific physical disk by either its ID or WWN. specific nodes. specific PCI slots. specific port slots.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 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 histport command options and for sample command data output. 12.3.5 Viewing Histograms for VLUNs To view histogram data for VLUNs, issue the histvlun command. Histogram data output can be further refined to display only VLUN data from: specific domains.
3PAR InForm OS CLI Administrator’s Manual 12.8 Viewing Histograms InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 13 Task Management In this chapter 13.1 Overview 13.2 13.2 About Tasks 13.2 13.2.1 Task IDs 13.2 13.2.2 Showing Task Information 13.3 13.2.3 Waiting for a Task 13.5 13.2.4 Removing a Task 13.6 13.2.5 Cancelling a Task 13.6 13.2.6 Task Management Commands 13.7 13.3 Task Types 13.3.1 vv_copy 13.8 13.9 13.3.2 move_regions 13.10 13.3.3 promote_sv 13.10 13.3.4 remote_copy_sync 13.10 13.3.5 tune_vv 13.12 13.3.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 13.3.7 tunevv_rollback 13.14 13.1 Overview A set of InForm CLI task management commands enable you to display status for and manage certain long-running system operations on the InServ Storage Server. This chapter describes how to use the task management mechanisms built into the InForm OS and the InForm CLI task management commands to manage long-running operations on the system. 13.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual When a task is started via the InForm CLI, (for example, by creating a physical copy as illustrated in Chapter 8, Creating and Working with Snapshots), it is necessary to use the InForm CLI to obtain the task ID manually. Use the InForm CLI showtask command to obtain task IDs manually. The following section provides more information about this command.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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>. See individual task type descriptions for an indication of the number of phases for all tasks of that type.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 13.2.3 Waiting for a Task You can also use the task ID and the waittask command to ask the system to wait for a task to complete before returning a command prompt.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 NOTE: To cancel the waittask, use CTRL+C. This stops the waittask command and returns a command prompt, but does not impact the task that is running in the background. 13.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 13.2.6 Task Management Commands Table 13-1 summarizes the InForm CLI task management commands illustrated in the above sections. NOTE: A task can be started by actions performed via the InForm Management Console (for example, creating a physical copy), but the task management features available via the commands listed in Table 13-1 are not currently supported by the InForm Management Console. Table 13-1.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 13.3 Task Types There are seven types of tasks designed to track long running system operations. Table 13-2 lists all task types and the their associated operations. The table also includes information about the commands associated with each operation. Table 13-2. Task Types by Operation and Command Operation Task Type (Feature or Product) Command Description vv_copy Physical Copy createvvcopy Copies a virtual volume.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Table 13-2. Task Types by Operation and Command Operation Task Type (Feature or Product) Command Description tune_vv_restart Restart tuning virtual tunealdvv Restarts a volumes -restart** tunealdvv (3PAR System Tuner) operation that was previously interrupted. tune_vv_rollback Rollback tuning tunealdvv Rolls back a virtual volumes -rollback** tunealdvv (3PAR System Tuner) operation that was previously interrupted.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 13.3.2 move_regions The move_regions task type is used to track operations that move data between logical disks by issuing the movereg command. This is a low-level command not commonly issued by users. For more information on the movereg command, see the InForm OS Command Line Interface Reference. For move_regions tasks, there is only one phase. The number of steps in that phase is equal to the number of regions being moved. 13.3.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual copy volume 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.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 13.3.5 tune_vv The tune_vv task type is used to track tunealdvv operations performed with the 3PAR System Tuner tunealdvv command. The 3PAR System Tuner is an optional InForm OS feature that allows you to identify over-utilized physical disks as candidates for load balancing and perform load balancing on them. The tunealdvv command enables you to perform load balancing and to dynamically change certain volume parameters.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 13.3.6 tune_vv_restart The tune_vv_restart task type is used to track tunealdvv -restart operations performed with the 3PAR System Tuner tunealdvv -restart command. The tunealdvv - restart command enables users to resume a failed or cancelled tunealdvv operation. Use of this feature requires a 3PAR System Tuner license.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 13.3.7 tunevv_rollback The tune_vv_rollback task type is used to track tunealdvv -rollback operations performed with the 3PAR System Tuner tunealdvv rollback command. The tunealdvv -rollback command enables users to reverse any changes that resulted from a previously interrupted tunealdvv operation. Use of this feature requires a 3PAR System Tuner license.
InForm OS Version 2.2.4 3PAR InForm OS 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 a Management Console 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 14.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual 14.3 Registering a Management Console 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 OS CLI Administrator’s Manual InForm OS Version 2.2.4 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.2.4 3PAR InForm OS CLI Administrator’s Manual 15 Using Dynamic Optimization In this chapter 15.1 Overview 15.2 15.2 Types of Virtual Volumes 15.2 15.3 Dynamic Optimization 15.3 15.3.1 Dynamic Optimization CLI Commands 15.4 15.4 Volume Re-Layout Following Hardware Upgrade 15.4 15.5 Changing Volume RAID Level 15.7 15.6 Changing Volume Availability Level 15.8 15.7 Changing Volume Service Level 15.10 15.8 Reclaiming Unused LD Space 15.11 15.8.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 15.10.2 Restarting a Dynamic Optimization Operation 15.14 15.1 Overview The 3PAR Dynamic Optimization is an optional InForm OS feature that enables you to dynamically tune volumes by changing volume parameters (for example, RAID levels, set sizes, and disk filters). 3PAR Dynamic Optimization requires the use of the InForm CLI and also requires a 3PAR Dynamic Optimization license. 15.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 15.3 Dynamic Optimization Dynamic optimization enables you to non-disruptively re-layout virtual volumes. This functionality promotes system optimization through improved utilization of all physical resources present at a given time. In addition, dynamic optimization enables you to alter the service levels associated with a given volume by changing volume parameters (for example, RAID levels, set sizes, and disk filters).
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 If more than eight dynamic optimization tasks are started, task number nine and above are queued until one or more of the initial eight tasks are completed. 15.3.1 Dynamic Optimization CLI Commands The following commands are used for dynamic optimization tasks. Refer to the InForm OS Command Line Interface Reference for complete information about the optional and required arguments for each command.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual logical disks use chunklets on physical disks with primary paths to the specified controller nodes only. If your volume was created using the createvv command, perform the following: 1 Create a new CPG. See 7.10.2 Creating a Common Provisioning Group on page 7.12 for instructions.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 NOTE: When using the tunealdvv command, it is recommended that in addition to the options listed in the following procedure, the same options used during volume creation, minus the -cnt option, are also specified when tuning to maintain consistency (RAID type, etc.) between the untuned and tuned volumes. See the complete tunealdvv command and option information available in the InForm OS Command Line Interface Reference.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 15.5 Changing Volume RAID Level 15.5.1 Base VVs If your volume was created using the createaldvv command, change the volume’s RAID level by issuing the tunealdvv -t command. 1 If your volume was created using the createvv command, perform the following: Create a new CPG with the RAID type to which you wish to change the volume. See 7.10.2 Creating a Common Provisioning Group on page 7.12 for instructions.
3PAR InForm OS CLI Administrator’s Manual 2 InForm OS Version 2.2.4 Tune the user space of the volume by issuing the tunevv usr_cpg command, where: usr_cpg is the name of the CPG created previously in step 1, indicating the user space of the new CPG will be used. 3 is the CPVV you are re-laying out. Tune the snapshot space of the volume by issuing the tunevv snp_cpg command.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 15.6.2 TPVVs To change the volume availability level of a TPVV, 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.10.2 Creating a Common Provisioning Group on page 7.12 for instructions.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 15.7 Changing Volume Service Level 15.7.1 Base VVs If your volume was created using the createaldvv command, issue the tunealdvv [-service_level_options] command to change the service level characteristics of the volume. If your volume was created using the createvv command, perform the following: 1 Create a new CPG with the service level characteristics you wish to apply to the volume. See 7.10.
InForm OS Version 2.2.4 3 3PAR InForm OS CLI Administrator’s Manual usr_cpg is the name of the CPG created previously in step 1. is the CPVV 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 CPVV you are modifying. 15.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 15.8.1 Tuning Volumes Individually This section shows you how to tune a group of individual volumes so that they do not share logical disks. This procedure also compacts the logical disks used by the volumes so that they do not have any unused space.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 15.8.3 Compacting CPGs As with logical disks, CPGs can also be compacted to consolidate and reclaim unused space. X To consolidate space in a common provisioning group (CPG), issue the compactcpg command. Refer to the InForm OS Command Line Interface Reference for detailed information about this command. 15.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 15.10.1 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. You may choose to roll back a dynamic optimization task if the operation was interrupted because of: Lack of space. User-initiated cancellation of a task.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual 16 Using mySnapshot In this chapter 16.1 Overview 16.1 16.2 About mySnapshot 16.2 16.3 Setting Administrative Permissions 16.2 16.4 Replacing Virtual Volume Snapshots 16.3 16.4.1 Replacing a Read-Only Snapshot 16.3 16.4.2 Replacing a Read-Write Snapshot 16.4 16.1 Overview This chapter describes how to use the 3PAR mySnapshot utility.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 16.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.2.4 3PAR InForm OS 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* 16.4 Replacing Virtual Volume Snapshots A user with the appropriate permissions set (see 16.3 Setting Administrative Permissions on page 16.2) can use the updatevv command to replace a copy of a test database.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 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. 16.4.
InForm OS Version 2.2.4 3PAR InForm OS 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.
3PAR InForm OS CLI Administrator’s Manual 16.6 Replacing Virtual Volume Snapshots InForm OS Version 2.2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Index 3PAR Domains 5.8, 7.18 3PAR MIB, location 14.2 registering with addsnmpmgr command 14.3 alerts removing 11.2 3PAR system, requirements for connecting to 3.2 setting states 11.2 A system administrator response required 11.2 accessing the CLI 3.22 triggered by events 11.1 accessing the CLI using SSH 3.22 viewing 11.2 Active Directory 4.7 applying templates 9.3 Active Directory configuration assigning host paths 5.
3PAR InForm OS CLI Administrator’s Manual changing domain names 6.3 connecting to a 3PAR system, requirements 3.2 CHAP consolidating CPG space 7.14 configuring authentication information 5.7 removing authentication information 5.7 CHAP initiator setting up 5.7 CHAP target setting up 5.7 chapter overviews 1.4 to 1.5 chunklet histograms, viewing 12.5 CLI controlport command 5.3, 5.5 conventions advisories 1.6 conventions, typographical 1.5 copies, replacing and restoring 16.
InForm OS Version 2.2.4 creating a host 5.2, 5.3 3PAR InForm OS CLI Administrator’s Manual domain adding users 4.5 creating CPGs 7.12 changing host 5.9 creating CPGs with templates 9.3 creating 6.2 creating CPVVs 7.16 creating CPGs 7.20 creating domain CPGs 7.20 creating hosts 5.8 creating domain hosts 5.8 creating users 4.3 creating domain users 4.3 creating VVs 7.18 current 4.6 creating domains 6.2 default 4.6 creating physical copies 8.5 exporting VVs 7.19 creating templates 9.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 TPDFORCE 3.18 growing domain VVs 7.19 TPDPWFILE 3.11 growing virtual volumes 7.5 TPDSTARTFILE 3.12 growth increment error log installation 2.11 events considerations 7.12 growth increment considerations 7.11 growth increments alerts triggered by 11.1 default 7.11 events log, removing 11.3 events log, viewing 11.3 minimum increment 7.11 grrowvv command 7.6 exit command, definition of 3.6 export rule 7.7 exporting domain VVs 7.
InForm OS Version 2.2.4 default installation location 2.14 Solaris installation 2.14 Windows installation 2.14 installation 2.6 error log 2.12 requirements 2.3 troubleshooting 2.11 installation requirements 2.4 InstallShield installation troubleshooting 2.11 uninstalling the CLI 2.12 interfaces, user 1.2 IP port, CLI server connects to using (-tpdportnum) global option 3.4 iSCSI creating a host path 5.2 3PAR InForm OS CLI Administrator’s Manual installation error log 2.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 N physical disk histograms, viewing 12.6 native shell, searching for topics in 3.6 port histograms, viewing 12.6 -nohdtot global option 3.5 port persona settings 5.4 notes, about 1.6 port personas 5.3 port presents 7.7 O online help 3.6 OpenLDAP configuration port statistics, viewing 12.3 ports Fibre Channel 5.1 simple binding over SSL 4.24 iSCSI 5.1 using simple binding over SSL 4.24 operating systems 2.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual removing a domain 6.3 searching by topic and in native shell 3.6 removing alerts 11.2 searching by topic, command for in native shell 3.6 removing CPGs 7.14 removing CPVVs 7.17 removing domain objects 6.5 removing domains 6.3 removing hosts 5.7 removing tasks 13.6 removing template parameters 9.4 removing templates 9.5 removing the current domain 4.6 removing the default domain 4.6 removing the events log 11.3 removing TPVVs 7.
3PAR InForm OS CLI Administrator’s Manual snapshot space usage warnings 7.13 T snapshot volumes 8.2 task snapshot-in-time 8.5 snapshots 8.1 replacing 16.3 SNMP (Simple Network Management Protocol) 14.1 to 14.4 agent passwords 14.4 registering the management console 14.3 SNMP agent 14.2 sockssl global option 3.4 Solaris operating environment 2.3, 2.5, 2.9, 2.13 cancelling 13.6 removing 13.6 task ID, viewing 13.2 task information, displaying 13.3 task management 13.2 task management commands 13.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual TPDCACHEDIR environment variable 3.4 U TPDCSVTABLE environment variable 3.5 unexporting virtual volumes 7.9 TPDFORCE environment variable 3.5 uninstalling the CLI 2.12, 2.14 TPDHAFTER environment variable 3.5 unused logical disk space 15.11 TPDLISTDOM enivronment variable 4.4 upgrading the CLI 2.14 TPDLISTDOM environment variable 3.5 -user global option 3.4 TPDNOHDTOT environment variable 3.5 user accounts, setting up 4.
3PAR InForm OS CLI Administrator’s Manual InForm OS Version 2.2.4 creating 8.3 VLUN statistics, viewing 12.3 rules 8.2 VLUN template virtual volume histograms, viewing 12.7 creating host sees 7.8 virtual volume statistics 12.4 types 7.7 virtual volume statistics, viewing 12.4 virtual volumes creating 7.4 creation guidelines 7.3 exporting 7.7 growing 7.5 modifying 7.5 VLUN templates 7.7 creating matched set 7.8 creating port presents 7.8 host sees 7.7 matched set 7.7 port presents 7.7 removing 7.
InForm OS Version 2.2.4 3PAR InForm OS CLI Administrator’s Manual Revision History Release level Revision summary 320-200113 Rev A Added information about the InServ F-Class Storage Servers. This March 2009 document was previously released under part number 320-1463. Revision History RH.
3PAR InForm OS CLI Administrator’s Manual RH.2 InForm OS Version 2.2.