HP System Reporter E-Media Kit, System Reporter Media Kit specification

3PAR System Reporter User’s Guide

System Reporter 2.8

NOTE: If you are upgrading from an earlier version of the System Reporter or re- installing an existing 2.8 version for SQLite, and if you wish to retain the data collected from the previous installation, you must specify the same (existing) database, otherwise a new database will be created.

System Reporter 2.8 will automatically convert the earlier release database tables into the format that it needs. If you wish to retain the tables in an earlier format you must make a backup copy of the database before upgrading.

NOTE: When upgrading from an earlier version of System reporter (for MySQL only), the Sampling process may take a while to start sampling. This delay is necessary to address an issue related to case insensitiveness with default installs of MySQL.

8When prompted, type the webuser password in the Web reports password field and the cliuser password in the Sampler and policy change password field and then click Next.

NOTE: See 3.8.2.4 Creating MySQL Users and Schema on page 3.20 and 3.8.3.2 Creating the Oracle Users for System Reporter on page 3.22 for additional information about cliuser and webuser.

These users correspond with the Apache HTTP Server privilege levels (see About

Apache HTTP Server Authorization and Access Control on page 3.34) and are also defined in the Apache Server HTTP config.tcl files (see Modifying the Apache

HTTP Server Configuration Files on page 7.23).

The installer places these user names and passwords in the Apache HTTP Server config.tcl files and the cliuser user name and password in the database password file called dbpwfile located in the installation directory for the 3PAR System Reporting Tools sampler (default file path C:/Program Files/3PAR/System Reporter/dbpwfile).

See 3.9.1.1 Setting File Permissions (Optional) on page 3.32 for information on setting the appropriate permissions for the files.

9Enter optional SMTP (Simple Mail Transfer Protocol) parameters to allow System Reporter to send email. If you do not wish to use the email alerts feature (see 7.4 Configuring Rules

3.26

Installing or Upgrading the System Reporter Tools

Image 62

HP System Reporter E-Media Kit, System Reporter Media Kit manual Installing or Upgrading the System Reporter Tools

Contents

3PAR System Reporter 2.8 User’s Guide Revision Notice Oractcl Copyright and License Page Page Page Preamble Page Page No Warranty Table of Contents Installation, Configuration, Update, and Removal Xii Xiii Removing the System Reporter Components Xiv Creating Custom Reports Working with Excel Charts Xvi Interpreting Report Metrics Xvii Web Queries Xviii Xix Performance Reports Using Adaptive Optimization Database Schema Xxi Troubleshooting Xxii Xxiii Xxiv Audience User Interfaces Related Documentation For information about… Read the… Organization Typeface Meaning Example ABCDabcd Typographical ConventionsAdvisories Overview and Features About 3PAR System Reporter Configuring System Reporter Policy Settings Choosing a Method for Accessing Reports Creating Customized Reports Report Name Description Report Metrics Cross Reference Node Cache Performance Formatting Reports for Presentation Generating Email Alerts Accessing Report Data using Web QueriesCustomizing the Reporting Format Using the Database Schema to Build Custom Reports Analyzing and Optimizing Storage Utilization Installation, Configuration, Update, and Removal Before You Begin System Reporter CD Contents Apache2.2.14 Installer.exeSetup.exe Win32-x86-openssl System Requirements System Component Minimum Requirement InServ Storage Server System Requirements Using the System Reporter Sizing Spreadsheet System Reporter Sizing Spreadsheet Using the System Reporter Sizing Spreadsheet System Reporter Components InServ Storage Server and User Interface Components System Reporter Components Installing the System Reporter Components Installing the System Reporter Components Section Installing the Web Server SQLite Installing the Database ServerChoosing the Appropriate Database MySQL Oracle Installing and Setting Up the MySQL Database Optional Comment SQLite MySQL Oracle Installing MySQL Server Configuring the MySQL Database Select Multifunctional Database then click Next Setting the maxallowedpacket parameter Maxallowedpacket=32M Creating MySQL Users and Schema Mysql -u root -p Creating an Oracle database Setting Up the Oracle Database OptionalStart the Oracle Database Configuration Assistant Creating the Oracle Users for System Reporter Creating the Oracle Net Service 3PAR System Reporter Installer window opens Installing or Upgrading the System Reporter ToolsInstalling or Upgrading System Reporter Tools on Windows Installing or Upgrading the System Reporter Tools Installing or Upgrading the System Reporter Tools Installing or Upgrading the System Reporter Tools Installing System Reporter Tools on Linux Rpm --install sampleloop-2.8-1.i386.rpm Etc/init.d/sampleloop start Adding InServ Systems 3PAR System Reporter window appears Click Submit Query Setting File Permissions OptionalVerifying Installation Installing the Excel Client Optional About Apache Http Server Authorization and Access Control Directory cgi-bin/3par-rpts AuthType Basic Removing the System Reporter Components Removing the System Reporter Tools on Windows Removing the System Reporter Tools on Linux Removing the MySQL Database Optional Drop user cliuser drop user webuser Accessing the Main System Reporter Interface Getting Started Connection Dialog Box System Reporter Main Menu Window System Reporter Main Window Getting Help Filtered Multi-Selection Control Using the Object Selection ControlsSimple Selection List Accessing the Optional Excel Client Starting the System Reporter Excel Client Setting the Security Level for Excel Setting the Security for Excel Security Warning for Enabling Macros in Excell Setting the Security Level Setting the Security Level for Excel Macro Security Alert for Excel Click Trust Center Click Trust Center Settings Trust Center Screen Connecting to the Web Server from the Excel Client Connection Parameters dialog box appears Figure Changing the Excel Client Server and Resetting the Workbook Changing the Web Server Accessing the Excel Client Query LogResetting the Workbook Deleting Menu Sheets Deleting Data SheetsDeleting Excel Sheets Deleting the Query Log Saving and Exiting the Excel Client 10.Security Alerts Multiple Issues Accessing and Creating Reports Accessing Quick Reports Quick Reports Window Accessing Scheduled Reports Scheduled Reports Window Creating Custom Reports Building the Report Menu Custom Reports Window Sample Resolution Report Common Performance Metrics on page 6.11 for Select Systems Option Purpose Select Domains Generating the Report Report Menu for Daily Vlun Performance Creating Custom Reports Creating Custom Reports Query Results Controls Available by Report Report Selection Object Selection ReportTime Selection 3PAR System Reporter User’s Guide Report Selection Format Selection At Time Standard Report TypesReport Type Purpose Versus Time Time Report Type Purpose HistogramHistogram At Versus Time Report Example Versus Time with Compare=System Report Example Group By SystemHost At Time Report Example Histogram Versus Time Report Example Select Summary Columns 10.Histogram At Time Report Example Group By CompareSelect Peak Pdid System Reporter Order By Order by the CPG that the LD belongs to Sum End Buckets Low BucketHigh Bucket Begin/At Time Time SelectionReload After mins End Time Count Include Chunklets Object SelectionSelect PDIDs Select Cage IDs Select Disk Types Select Disk Speed Include PDs in States Select Usr CPGs Select Snp CPGs Select CPGs Select LDs Select RAID Types Select LD Usage Select VVs Select Prov Types CTRL+CLICK Select VV Types Select Ports nsp Select Port Types Select Hosts Select Nodes Select To Nodes Report Information Format Selection Web interface onlySelect Queues Chart Types 11.Example of a Table Stacked Bars Stacked Vert Bars Stacked Area Lines Bars Vert Bars Time Labels Chart X PixelsChart Y Pixels Time Format Select Space Unit Choose Change Chart Type Working with Excel ChartsChoosing a Chart Type Refreshing Charts 18.Change Chart Type Menu for the Excel Client External Data Range Properties dialog box appears 19.Data Range Properties Shortcut Menu Retaining Charts 20.External Data Range Properties Dialog Box Exporting Executable Reports Adding Custom Columns to a Data Sheet Customizing Excel Reports =IFN530,H53/N53*100,0 Creating a Custom Chart=H53+J53+K53 Working with Excel Charts Saving Customized Settings Chart Interpreting Report Metrics Summary Report Metric Description Summary Report Metrics 3PAR System Reporter User’s Guide Metric Description Space Reports PD Space Reports Totals LD Space ReportsUsage Type Description Spare, Unused, Failed VV Space Reports VV Space Report Metrics 3PAR System Reporter User’s Guide Performance Reports Common Performance Metrics 3PAR System Reporter User’s Guide VV Cache Performance Reports Node Cache Performance Reports CPU Performance Reports Adaptive Optimization Reports Link Performance Reports Configuring the System Reporter Policy Settings Accessing the System Reporter Policies CLI password files Configuring Sampling PoliciesPolicy Default Full path to directory containing InForm Etc/clipwdir on Linux Compacting Databases See Compacting Databases on Editing Sampling Policies Connection Dialog Box Adding, Removing and Re-Configuring InServ Storage Systems Removing a Storage Server Adding a Storage ServerVerifying Addition of a Storage Server Click Remove InServ Re-Configuring a Storage Server Sampling 3PAR System Reporter Policies window appears Configuring Rules for Email AlertsAdding an Alert Rule Click Add Alert Changing an Alert Rule Removing an Alert Rule Click Remove Alert Alert Rule ParametersData Table Data Table Description Resolution Metric Resolution DescriptionSystem Metrics Description Data Tables Averaged over the sample Direction Limit Value Condition Example of an Alert RuleLimit Count Condition Value Scheduling Reports Scheduledreports/report directory/report name/YYYYMMDDHH Click Add Scheduled Report Adding a Scheduled ReportChoose the Scheduled Reports tab Changing a Scheduled Report Removing a Scheduled Report Configuring Adaptive Optimization About File Permissions Modifying the Apache Http Server Configuration Files Modifying the Apache Http Server Configuration Files Web Queries About Web Queries Data Format Version Report System Reporter Version Report Category About Reports and OptionsReport Options Option=value Daily CompareExample Hourly Values ProvType HostVVType LDUsage Comparesel Totalspace InterruptsCtxtsws Rawspace Statpd PdspaceVvspace Statld Refresh CharttabChart Both Stackedvbars CharttypeStackedbars Stackedarea Value GraphxGraphy Bottom Right GraphlegposTableformat Alllabels Excel Timeform Begintsecs Endtsecs Tsecs Groupby PortNode Groupby=System Orderby Order results by Virtual Volume VV Type Bandwidth Service TimeIOPs IO Size Intr TotalAccessesIdle Ctxt Histbegin Ldspaceunit MiB 220 bytes PdspaceunitExamples GB 109 bytes Vvspaceunit Chunklets Selcageid All cage IDs Selchunks Nrmavaildrty Selchunkls=NRMAVAILCLEAN Selchunkls=NRMAVAILCLEAN&selchunks=SPRAVAILCLEAN Selsnpcpg SelcpgSelusrcpg Seldisktype All Disk Speeds SeldiskspeedAll Disk Types Domainname SeldomainALL Domains ALL Hosts SelhostDomain2 Hostname All LDs SelldSellduse Ldname Selnode Log All Ports SelnspAll Nodes Selpdid ALL PDIDs All PD States SelpdstateSelporttype Valid Selraidtype Selraidtype=1&selraidtype=5 SelsysSelraidtype= All Systems Selvv Selvvtype Selprovtype Report Types Pdspacegroup SummaryPdspacetime Ldspacetime Ldspacegroup Pdperftime VvspacetimeVvspacegroup Pdperfgroup Pdsvthist Portperfgroup PdsvthistvstimePortperftime Ldperftime PortsvthistPortsvthistvstime Compare=System Ldsvthistvstime LdperfgroupLdsvthist Vlunsvthist VlunperftimeVlunperfgroup Vvcmpgroup VlunsvthistvstimeVvcmptime Cpuperftime Cpuperfgroup Vvtier RegiodensityRegmoves Regiondensity example Report Option Options Available by ReportVvtier example M M Report Option Histsvtpd M M M M M M Objects Present Reports Http//localhost/cgi-bin/3par-rpts Using tableformat=excel Without using tableformat=excel Objectspresent&objectpres= ldname on Report Table values Objectpres= cageid Sampletimes on Objectspresent&objectpres=cageid Objectpres= cpgnameOutput Objectpres= diskspeed Objectspresent&objectpres=cpgname Objectspresent&objectpres=disktype Objectpres= disktypeObjectspresent&objectpres=diskspeed Objectspresent&objectpres=domainname Objectpres= domainnameObjectpres= hostname Objectpres= ldname Objectspresent&objectpres=hostname Objectpres=node Objectspresent&objectpres=ldname Objectpres=pdid Objectspresent&objectpres=node Objectpres=port Objectspresent&objectpres=pdid Objectpres= system Objectspresent&objectpres=port Objectspresent&objectpres=vvname Objectspresent&objectpres=system usingObjectpres= vvname Objectpres= vvnamenosnap Objectspresent&objectpres=vvnamenosnap Objecctpres= porttype Objectspresent&objectpres=porttype Sampletimes Time string with format yyyy-mm-dd hhmmss Objects Present Reports Objects Present Reports Using Adaptive Optimization Overview Overview Selecting an InServ for Adaptive Optimization Configuring Adaptive Optimization Adaptive Optimization Configuration Main Window Tier Definition CPG Name and GiB Configuring Adaptive Optimization Configuring Adaptive Optimization Schedule Measurement Hours Add Adaptive Optimization Configuration window appears Adaptive Optimization ModeAdding an Adaptive Optimization Configuration Adaptive Optimization Active Changing an Adaptive Optimization Configuration Change Adaptive Optimization Configuration window appears Removing an Adaptive Optimization Configuration Region IO Density Report Region IO Density with Adaptive Optimization Region IO Density without Adaptive Optimization VV Tiers Report Adaptive Optimization Space Moved Report Space Moved Report Showvvcpg CLI extension Cli% source showvvcpg.tcl CPG Showvvcpg CLI extension Using The Database Schema 10.1 10.2 Administrative TablesTable Versions and Naming Conventions Policy Table 10.3 Sampleinserv Table 10.4 System Table Alertconfig Table 10.5 10.6 Datatable value 10.7 Scheduledreport Table 10.8 Scheduledreportlog Table Adprovconfig Table10.9 10.10 10.11 Adprovlog Table 10.12 Ldrgmoves Table 10.13 Recentsample Table Sample Data and Inventory Tables10.14 10.15 Pdspace Table 10.16 10.17 10.18 Pdspaceinv Table 10.19 Ldspace Table 10.20 10.21 Ldspaceinv Table 10.22 Vvspace Table 10.23 10.24 10.25 Vvspaceinv Table 10.26 10.27 Cpgspace Table 10.28 10.29 Cpgspaceinv Table 10.30 Common Performance Table Columns 10.31 10.32 10.33 10.34 Metric SQL Expression 10.35Calculating Common Performance Metrics IO Size Histogram Buckets Service Time Histogram Buckets10.36 10.37 Statpd Table 10.38 10.39 Statpdinv Table 10.40 Statld Table 10.41 Statldinv Table 10.42 Statport Table 10.43 Statportinv Table 10.44 10.45 Statvlun Table 10.46 Statvluninv Table 10.47 Statvvcmp Table 10.48 Sysuid 10.49Statvvcmpinv Table 10.50 Statcpu Table 10.51 Null CPU Statlink Table 10.52Statcpuinv Table 10.53 10.54 Statlinkinv Table 10.55 Statldrg Table 10.56 Statldrgtimeinv Table Spacetimeinv Table 10.57Perftimeinv Table 10.58 Troubleshooting Overview 11.1 Sampling Component Log Files Troubleshooting the Sampling Components11.2 11.3 Installation ConfigurationInServ Sampling Errors Errors incurred by the inservsample process Troubleshooting Adaptive Optimization ComponentsSampler Service/Daemon Errors Errors incurred by the CLI sampler process 11.5 Troubleshooting the Web Server ComponentsTroubleshooting the Excel Client Extracting Data from the Database with sysbck 11.6 11.7 Examples of Using sysbck for Various Databases 11.8 11.9 From MySQL to Oracle 11.10 11.11 Dumping the Entire SQLite Database Dumping the Entire Database11.12 11.13 Dumping the Entire MySQL Database 11.14 Index IX.1 IX.2 IX.3 IX.4 IX.5 IX.6 RH.1 Release level Revision summary Configuration, Update, and Removal RH.2 RH.3 RH.4 RH.5 RH.6 RH.7 RH.8