3PAR Policy Advisor 2.1.1 User’s Guide 3PAR Inc.
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.
PAR Policy Advisor User’s Guide Table of Contents 1 Introduction 1.1 Overview 1.1 1.2 Audience 1.1 1.3 Related Documentation 1.2 1.4 Organization 1.2 1.5 Typographical Conventions 1.3 1.6 Advisories 1.3 2 Overview 2.1 Policy Advisor for Dynamic Optimization 2.1 3 Installation and Deinstallation 3.1 Overview 3.1 3.2 Installation Requirements 3.2 3.3 Policy Advisor Installation Package 3.2 3.4 Installing the Policy Advisor on Linux or Solaris 3.2 3.
3PAR Policy Advisor User’s Guide 4 Using the Policy Advisor 4.1 Overview 4.2 4.2 Requirements and Restrictions 4.2 4.3 The Policy Advisor Script 4.3 4.4 Using the Policy Advisor on Linux or Solaris 4.6 4.5 Using the Policy Advisor on Windows 4.8 4.6 Understanding the Policy Advisor Analysis Process 4.9 4.6.1 Physical Disk Analysis 4.10 4.6.2 Virtual Volume Analysis 4.11 4.7 Analyzing the Policy Advisor Results for Hardware Changes 4.7.
3PAR Policy Advisor User’s Guide 1 Introduction In this chapter 1.1 Overview 1.1 1.2 Audience 1.1 1.3 Related Documentation 1.2 1.4 Organization 1.2 1.5 Typographical Conventions 1.3 1.6 Advisories 1.3 1.1 Overview This guide provides information for installing and using the 3PAR Policy Advisor for Dynamic Optimization. 1.2 Audience This guide is for use by administrators who are responsible for maintaining the 3PAR operating environment and who understand the InServ Storage Server.
3PAR Policy Advisor User’s Guide 1.
3PAR Policy Advisor User’s Guide 1.5 Typographical Conventions This guide employs the following typographical conventions: Typeface Meaning Example ABCDabcd Used for dialog elements When prompted, click Finish to such as titles, button labels, complete the installation. and other screen elements. ABCDabcd Blue Bold Text Used for paths, filenames, Open the file and screen output. \gui\windows\setup.
3PAR Policy Advisor User’s Guide 1.
3PAR Policy Advisor User’s Guide 2 Overview In this chapter 2.1 Policy Advisor for Dynamic Optimization 2.1 2.1 Policy Advisor for Dynamic Optimization The 3PAR Policy Advisor script for Dynamic Optimization analyzes how your virtual volumes use physical disk space and recommends actions to improve the performance of your InServ Storage Server.
3PAR Policy Advisor User’s Guide There are four general cases where using the Policy Advisor for Dynamic Optimization may be desirable: ■ 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.
3PAR Policy Advisor User’s Guide 3 Installation and Deinstallation In this chapter 3.1 Overview 3.1 3.2 Installation Requirements 3.2 3.3 Policy Advisor Installation Package 3.2 3.4 Installing the Policy Advisor on Linux or Solaris 3.2 3.5 Installing the Policy Advisor on Windows 3.3 3.6 Deinstalling the Policy Advisor on Linux or Solaris 3.5 3.7 Deinstalling the Policy Advisor on Windows 3.5 3.
3PAR Policy Advisor User’s Guide 3.2 Installation Requirements The following requirements must be satisfied to install the Policy Advisor: ■ You must have access to the 3PAR Document Control System at http://stdev.3pardata.com/ docs/docs_main.php to download the 3PAR Policy Advisor package. ■ The Policy Advisor must be installed on a host computer with access to the InServ Storage Server you want to analyze. ■ The 3PAR InForm CLI must be installed on the host computer running the Policy Advisor.
3PAR Policy Advisor User’s Guide 3 Go to the /PolicyAdvisor directory on the host computer and change the permissions on the PolicyAdvisor.tcl file to make it executable. chmod 555 ./PolicyAdvisor.tcl You can now use the Policy Advisor PolicyAdvisor.tcl script. For details about using the 3PAR Policy Advisor for Dynamic Optimization, see Using the Policy Advisor on Linux or Solaris on page 4.6. 3.
3PAR Policy Advisor User’s Guide 3.5.1 Troubleshooting Windows Installations In some system configurations, an application other than the InForm CLI may start when you run the policyadvisor script. If a different application starts when you run the policyadvisor script, move the InForm CLI installation path to the beginning of the Windows PATH variable. To move the 3PAR CLI installation path to the beginning of the Windows PATH variable: 1 Open the Control Panel. 2 Open System.
3PAR Policy Advisor User’s Guide 3.6 Deinstalling the Policy Advisor on Linux or Solaris To deinstall the 3PAR Policy Advisor from a host computer running Linux or Solaris: 1 Go to the CLI user account directory on the host computer where the PolicyAdvisor subdirectory is located. 2 Remove the PolicyAdvisor sub-directory form the CLI user account directory of the CLI user account. rm –rf PolicyAdvisor The PolicyAdvisor sub-directory and the Policy Advisor files are now removed from the host computer.
3PAR Policy Advisor User’s Guide 3.
3PAR Policy Advisor User’s Guide 4 Using the Policy Advisor In this chapter 4.1 Overview 4.2 4.2 Requirements and Restrictions 4.2 4.3 The Policy Advisor Script 4.3 4.4 Using the Policy Advisor on Linux or Solaris 4.6 4.5 Using the Policy Advisor on Windows 4.8 4.6 Understanding the Policy Advisor Analysis Process 4.9 4.7 Analyzing the Policy Advisor Results for Hardware Changes 4.16 4.8 Analyzing the Policy Advisor Results for RAID Level Changes 4.19 4.
3PAR Policy Advisor User’s Guide 4.1 Overview This chapter provides instructions for using the 3PAR Policy Advisor script for Dynamic Optimization. 4.2 Requirements and Restrictions Using the 3PAR Policy Advisor script for Dynamic Optimization has the following requirements and restrictions: ■ All of the Installation Requirements on page 3.2 must be satisfied. ■ Running the Policy Advisor script, and the tunevv and tunealdvv CLI commands requires the 3PAR Dynamic Optimization license.
3PAR Policy Advisor User’s Guide 4.3 The Policy Advisor Script SCRIPT NAME On Linux or Solaris: PolicyAdvisor.tcl On Windows: policyadvisor DESCRIPTION Analyzes how your virtual volumes use physical disk space and recommends actions to improve the performance of your InServ Storage Server. SYNTAX On Linux or Solaris: ./PolicyAdvisor.tcl [options] [...]|[...] On Windows: policyadvisor [options] [...]|[...
3PAR Policy Advisor User’s Guide -ha Specifies the availability of the virtual volume. Volumes can be made available to ports, cages or magazines. The default is to keep current setting of the virtual volume. -devtype The device type is FC, NL or SSD. The devtype must be explicitly specified as FC, NL or SSD. If the devtype is current, the virtual volume is skipped and is not analyzed.
3PAR Policy Advisor User’s Guide -cpg | The is the name of the Common Provisioning Group (CPG) specified for analysis by the Policy Advisor. A pattern of CPGs may also be specified. The CPGs are analyzed and tuning suggestions are generated for CPGs where the layout can be improved. If no CPG name or pattern is specified, all CPGs are analyzed. The -cpg option can only be used in conjunction with the -tunepct and -list options. Linux and Solaris wildcards.
3PAR Policy Advisor User’s Guide 4.4 Using the Policy Advisor on Linux or Solaris To run the PolicyAdvisor.tcl script: 1 Go to the directory where the script is located. The recommended location is /PolicyAdvisor. 2 Run the script. ./PolicyAdvisor.tcl [options] [...]|[...] For example: ./PolicyAdvisor.tcl –t r5 –ssz 5 –ha mag my_vvol\* This example examines all virtual volumes starting with my_vvol. The PolicyAdvisor.
3PAR Policy Advisor User’s Guide See Chapter 2, Overview for more information about when the Policy Advisor for Dynamic Optimization should be run. NOTE: Use the Ctrl-C command to cancel the Policy Advisor script. Using the Policy Advisor on Linux or Solaris 4.
3PAR Policy Advisor User’s Guide 4.5 Using the Policy Advisor on Windows To run the policyadvisor script: 1 Open a Windows DOS cmd window and go to the directory where the policyadvisor script is located. For example: cd "C:\Program Files\3PAR" 2 Run the script. policyadvisor [options] [...]|[...] For example: policyadvisor –t r5 –ssz 5 –ha mag my_vvol* This example examines all virtual volumes starting with my_vvol.
3PAR Policy Advisor User’s Guide 4 Analyze the results displayed by the Policy Advisor. You should carefully review the suggestions before running any suggested tuning operations. 5 Run the Dynamic Optimization tuning commands suggested by the Policy Advisor. See Chapter 2, Overview for more information about when the Policy Advisor for Dynamic Optimization should be run. NOTE: Use the Ctrl-C command to cancel the Policy Advisor script. 4.
3PAR Policy Advisor User’s Guide 4.6.1 Physical Disk Analysis The analysis of physical disks has two functions. Failed and degraded disks in the system are identified so that you can resolve any issues, and a summary report of physical disks in the system is created for your information. For more information about physical disk analysis requirements and restrictions, see Requirements and Restrictions on page 4.2.
3PAR Policy Advisor User’s Guide 4.6.1.2 Summary Report of Physical Disks in the System The following example shows the top level overview of PDs on a system: ./PolicyAdvisor.
3PAR Policy Advisor User’s Guide ■ -t - Generates tuning suggestions for virtual volumes not matching the specified RAID type. If a -ssz value is not supplied, the default values are used. The defaults for each RAID type are 2 for r1, 4 for r5, and 8 for r6. Only one RAID type can be specified. ■ -ssz - This option is only applicable when used in conjunction with the -t option.
3PAR Policy Advisor User’s Guide they change characteristics of the CPG. The following Policy Advisor script options can be used to generate tuning suggestions for virtual volumes created from CPGs: Understanding the Policy Advisor Analysis Process 4.
3PAR Policy Advisor User’s Guide ■ -cpg | - Specifies the names of CPGs to be considered for analysis. ■ -tunepct <1-100> - Each group of Logical Disks associated with the specified CPGs is analyzed for the number of PDs used by the LD. If this number is less than the supplied percentage of available PDs, then tuning suggestions are generated. The default is 90%. ■ -list - Displays Tune Criteria, Tune Reasons, and Skip Reasons as a list rather than a table.
3PAR Policy Advisor User’s Guide tunevv usr_cpg c2 cpvv1 --------------------------Split CPG Analysis --------------------------***************************************************************** ** The following VV is split between CPGs. This can happen if ** a tune command is currently executing, or a tune is cancelled ** or fails in the middle of a tune. ** ** VVs split between CPGs are not analyzed by the Policy Advisor.
3PAR Policy Advisor User’s Guide 4.7 Analyzing the Policy Advisor Results for Hardware Changes After hardware upgrades or reconfigurations, running the Policy Advisor produces results similar to the following example. While the script is running information about virtual volumes or logical disks is intermittently displayed to show the progress of the script. If there are any system issues, the script displays the information before running. 4.7.
3PAR Policy Advisor User’s Guide The system is checked for active tuning operations: --------------------------Active Tune analysis --------------------------No active tunes detected on Target InServ The virtual volumes are analyzed: -------------------------------------------------------------------VV USR Space Analysis (VVs in USR space size order, smallest first) -------------------------------------------------------------------A total of 1 Virtual Volumes (VVs) will be analyzed --Rsvd(MB)---(MB)-- ---
3PAR Policy Advisor User’s Guide 4.7.2 Hardware Change Example for Virtual Volumes Created from CPGs In the following example, the virtual volume vv1 was created with the createvv command while one cage of a two cage system was offline. Virtual volume vv1 draws space from CPG c1. The Policy Advisor script analyzes the system and displays analysis and suggested actions for improving performance. The following example analyzes all virtual volumes in the InServ Storage Server that draw space from CPG c1.
3PAR Policy Advisor User’s Guide The CPG logical disk groupings are displayed showing both the current and possible layout information: -----------------CPG to LD Analysis -----------------Tune ----------Current---------- ---------Possible---------LD? CPG LDIds Space TotalCh LD# Disks MinCh MaxCh AvgCh LD# Disks MinCh MaxCh AvgCh Yes c1 9 USR 80 1 16 5 5 2 4 32 2 3 2 The Policy Advisor identified 16 physical disks used to create the LD associated with this virtual volume.
3PAR Policy Advisor User’s Guide 4.8.1 RAID Level Change Example The following example attempts to change all virtual volumes in the InServ Storage Server to RAID 5 with magazine level availability. On Linux or Solaris: ./PolicyAdvisor.tcl -t r5 -ha mag On Windows: policyadvisor -t r5 -ha mag ------------------------------------------------------------3PAR, Inc.
3PAR Policy Advisor User’s Guide If a virtual volume cannot be tuned, the reason is displayed.
3PAR Policy Advisor User’s Guide 4.
3PAR Policy Advisor User’s Guide A Frequently Asked Questions This appendix provides answers to general questions about the 3PAR Policy Advisor script for Dynamic Optimization. Can you give me an overview of how Policy Advisor analyzes virtual volumes that provision space directly from Logical Disks (LDs)? ■ The virtual volume space allocation per Physical Disk (PD) is analyzed to determine how well the virtual volume is distributed across the disks in the system.
3PAR Policy Advisor User’s Guide Can you give me an overview of how Policy Advisor analyzes virtual volumes that provision space from Common Provisioning Groups (CPG)? ■ When a virtual volume is created or grown, one or more groups of LDs are associated with the CPG. The Policy Advisor performs the following analysis tasks on these groups of LDs: ◆ Analyzes the current group of LDs for the number of disks used.
3PAR Policy Advisor User’s Guide How does Policy Advisor handle virtual volumes that provision space from CPGs with Shared LDs? ■ If the groups of LDs associated with virtual volumes created with the -cnt option have an inefficient layout, all of the virtual volumes associated with the LDs will be suggested for tuning. One side effect of these tuning operations is that the virtual volumes will have individual groups of LDs after the tuning operations complete. The virtual volumes will no longer share LDs.
3PAR Policy Advisor User’s Guide Why can’t I tune Thinly-Provisioned Virtual Volumes (TPVVs) and virtual volume snapshot space to use the same CPG? ■ Tuning operations work by creating a fixed mapping from regions in the original LDs to regions in the new target LDs. Regions are then moved from the original source LDs to the new target LDs. With fully-provisioned volumes, the original LD region to new LD region mapping is fixed and doesn’t change during the tuning operation.
3PAR Policy Advisor User’s Guide Why do I sometimes get an error message saying that the system configuration has changed and that I should re-run the Policy Advisor? ■ Policy Advisor gathers internal state information for all of the various virtual volumes in the system. If a virtual volume is deleted while this information is being processed, Policy Advisor needs to be re-run in order to perform an accurate analysis of the entire system.
3PAR Policy Advisor User’s Guide A.
3PAR Policy Advisor User’s Guide Revision History Release level Revision summary 320-200237 Rev A First release of this manual. June 2010 Revision History RH.
3PAR Policy Advisor User’s Guide RH.