HP System Reporter Software User Manual

HP 3PAR System Reporter 2.9 Software

User’s Guide
Abstract
This guide provides the information you need to install and use HP 3PAR System Reporter to monitor performance, create charge back reports, and plan storage resources for HP 3PAR Storage Systems, and is intended for system and storage administrators who monitor and direct system configurations and resource allocation for HP 3PAR Storage Systems.
HP Part Number: QL226-96085 Published: June 2011
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks or registered trademarks of Intel Corporation or its subsidiaries
in the United States and other countries.
Microsoft®, Windows®, Windows® XP, and Windows NT® are U.S. registered trademarks of Microsoft Corporation.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
Perl DBD, MySQL Driver Copyright & License
This module is Copyright (c) 2003 Rudolf Lippan; Large Portions Copyright (c) 1997-2003 Jochen Wiedmann, with code portions Copyright (c)1994-1997 their original authors. This module is released under the same license as Perl itself. See the Perl README for details.
MySQL TCL Copyright & License
Copyright (c) 1994, 1995 Hakan Soderstrom, Enskede, Sweden and Tom Poindexter, Denver, Colorado Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice and this permission notice appear in all copies of the software and related documentation.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
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.
Neither the names of the copyright owners nor the names of its contributors may be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
OraTcl Copyright and License
Copyright (c) 2000-2005 Todd M. Helfter
Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the name of Todd Helfter may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Todd Helfter.
THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL TODD HELFTER BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
MySQL Client Library Copyright & License
Copyright © 1989, 1991 Free Software Foundation, Inc. 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
SQLite Copyright & License
The original author of SQLite has dedicated the code to the public domain. Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original SQLite code, either in source code form or as a compiled binary, for any purpose, commercial or noncommercial, and by any means.
Apache HTTP Server Copyright & License
Licensed under the Apache License Version 2.0, January 2004, http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide,
non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide,
non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications,
and in Source or Object form, provided that You meet the following conditions:
a. You must give any other recipients of the Work or Derivative Works a copy of this License; and
b. You must cause any modified files to carry prominent notices stating that You changed the files; and
c. You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices
from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
d. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable
copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You
to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides
its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required
by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge
a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
TWAPI Copyright & License
Copyright (c) 2003-2008, Ashok P. Nadkarni All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
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.
The name of the copyright holder and any other contributors may not be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
GNU General Public License
PREAMBLE
The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software---to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.
When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.
Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributes of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and modification follow.
GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The ``Program'', below, refers to any such program or work, and a ``work based on the Program'' means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term ``modification''.) Each licensee is addressed as ``you''.
Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.
You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.
You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.
You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:
Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
Accompany it with a written offer, valid for at least three years, to give any third-party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.
Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.
If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.
This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.
The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and ``any later version'', you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.
If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions
for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.
Documentation
For the latest version of this document, go to http://www.hp.com/go/3par/, navigate to your product page, click Support for your product, and then click Manuals.

Contents

1 Introduction.............................................................................................18
User Interfaces.......................................................................................................................18
Related Documentation............................................................................................................18
Typographical Conventions......................................................................................................19
Advisories..............................................................................................................................19
2 Overview and Features.............................................................................20
About System Reporter............................................................................................................20
Configuring System Reporter Policy Settings................................................................................20
Choosing a Method for Accessing Reports.................................................................................21
Creating Customized Reports...................................................................................................21
Formatting Reports for Presentation...........................................................................................23
Customizing the Reporting Format.............................................................................................23
Generating Email Alerts..........................................................................................................23
Accessing Report Data using Web Queries................................................................................23
Using the Database Schema to Build Custom Reports..................................................................24
Analyzing and Optimizing Storage Utilization............................................................................24
3 Installation, Configuration, Update, and Removal..........................................25
Before You Begin....................................................................................................................25
System Reporter CD Contents...................................................................................................25
System Requirements...............................................................................................................26
Using the System Reporter Sizing Spreadsheet............................................................................27
System Reporter Components...................................................................................................28
Installing the System Reporter Components.................................................................................30
Required Components........................................................................................................30
Optional Components........................................................................................................30
Installing the Web Server.........................................................................................................31
Installing the Database Server..................................................................................................32
Choosing the Appropriate Database....................................................................................32
SQLite.........................................................................................................................32
Microsoft SQL...............................................................................................................33
MySQL........................................................................................................................33
Oracle.........................................................................................................................33
Installing and Setting Up the Microsoft SQL Server Database (Optional)....................................34
System Reporter Host Configuration.................................................................................34
Installing and Setting Up the MySQL Database (Optional).......................................................38
Installing MySQL Server.................................................................................................38
Configuring the MySQL Database...................................................................................39
Setting the max_allowed_packet parameter......................................................................40
Creating MySQL Users and Schema................................................................................40
Setting Up the Oracle Database (Optional)...........................................................................41
Creating an Oracle database.........................................................................................41
Creating the Oracle Users for System Reporter..................................................................42
Creating the Oracle Net Service.....................................................................................42
Installing or Upgrading the System Reporter Tools.......................................................................43
Installing or Upgrading System Reporter Tools on Windows.....................................................43
Installing System Reporter Tools on Linux...............................................................................46
Adding Storage Systems.....................................................................................................47
Setting File Permissions (Optional)...................................................................................48
Verifying Installation......................................................................................................48
Installing the Excel Client (Optional)..........................................................................................48
8 Contents
About Apache HTTP Server Authorization and Access Control......................................................49
Removing the System Reporter Components................................................................................50
Removing the System Reporter Tools on Windows..................................................................50
Removing the System Reporter Tools on Linux.........................................................................51
Removing the MySQL Database (Optional)............................................................................51
4 Getting Started........................................................................................52
Accessing the Main System Reporter Interface............................................................................52
System Reporter Main Menu Window.......................................................................................52
Getting Help..........................................................................................................................54
Using the Object Selection Controls..........................................................................................54
Simple Selection List...........................................................................................................54
Filtered Multi-Selection Control.............................................................................................54
Accessing the Optional Excel Client..........................................................................................55
Starting the System Reporter Excel Client...............................................................................55
Setting the Security Level for Excel........................................................................................56
Setting the Security for Excel 2003..................................................................................56
Setting the Security Level for Excel 2007..........................................................................57
Connecting to the Web Server from the Excel Client...............................................................59
Changing the Excel Client Server and Resetting the Workbook.....................................................61
Changing the Web Server..................................................................................................61
Resetting the Workbook......................................................................................................61
Accessing the Excel Client Query Log........................................................................................61
Deleting Excel Sheets..............................................................................................................61
Deleting Menu Sheets.........................................................................................................61
Deleting Data Sheets..........................................................................................................62
Deleting the Query Log.......................................................................................................62
Saving and Exiting the Excel Client......................................................................................62
5 Accessing and Creating Reports.................................................................64
Accessing Quick Reports.......................................................................................................103
Accessing Scheduled Reports...................................................................................................65
Creating Custom Reports.........................................................................................................66
Building the Report Menu....................................................................................................67
Sample Resolution.........................................................................................................67
Report.........................................................................................................................68
Select Systems..............................................................................................................68
Select Domains.............................................................................................................69
Generating the Report........................................................................................................69
Controls Available by Report...............................................................................................72
Report Selection.................................................................................................................76
Standard Report Types...................................................................................................76
Select Summary Columns...............................................................................................81
Compare.....................................................................................................................81
Max. Number..............................................................................................................82
Select Peak...................................................................................................................82
Group By.....................................................................................................................82
Order By......................................................................................................................83
Low Bucket...................................................................................................................84
High Bucket..................................................................................................................84
Sum End Buckets...........................................................................................................84
Time Selection...................................................................................................................84
Reload After (mins)........................................................................................................84
Begin/At Time..............................................................................................................84
End Time.....................................................................................................................85
Count..........................................................................................................................85
Contents 9
Object Selection................................................................................................................85
Select PDIDs.................................................................................................................85
Include Chunklets..........................................................................................................85
Select Cage IDs............................................................................................................86
Select Disk Types...........................................................................................................86
Select Disk Speed.........................................................................................................86
Include PDs in States......................................................................................................86
Select Usr CPGs............................................................................................................87
Select Snp CPGs...........................................................................................................87
Select CPGs.................................................................................................................87
Select LDs....................................................................................................................88
Select RAID Types.........................................................................................................88
Select LD Usage............................................................................................................88
Select LUN...................................................................................................................88
Select VVs....................................................................................................................89
Select Prov Types...........................................................................................................89
Select VV Types............................................................................................................89
Select Port Types...........................................................................................................90
Select Port Rates............................................................................................................90
Select Ports (n:s:p).........................................................................................................90
Select Hosts..................................................................................................................91
Select Nodes................................................................................................................91
Select To Nodes............................................................................................................91
Select Queues..............................................................................................................91
Format Selection (Web interface only)...................................................................................91
Report Information.........................................................................................................92
Chart Lib......................................................................................................................92
Chart Types..................................................................................................................92
Chart X Pixels...............................................................................................................96
Chart Y Pixels...............................................................................................................96
Time Labels..................................................................................................................96
Legend Position.............................................................................................................96
Time Format.................................................................................................................96
Select Space Unit..........................................................................................................97
Working with Excel Charts.......................................................................................................97
Choosing a Chart Type.......................................................................................................97
Refreshing Charts...............................................................................................................98
Retaining Charts................................................................................................................99
Exporting Executable Reports............................................................................................100
Customizing Excel Reports................................................................................................100
Adding Custom Columns to a Data Sheet.......................................................................101
Creating a Custom Chart.............................................................................................101
Saving Customized Settings..........................................................................................102
6 Interpreting Report Metrics.......................................................................103
Summary Report...................................................................................................................103
Space Reports......................................................................................................................106
PD Space Reports............................................................................................................106
CPG Space Reports.........................................................................................................106
LD Space Reports.............................................................................................................107
VV Space Reports............................................................................................................107
Performance Reports.............................................................................................................108
Common Performance Metrics...........................................................................................108
VV Cache Performance Reports..........................................................................................109
Node Cache Performance Reports.....................................................................................109
10 Contents
CPU Performance Reports..................................................................................................110
Link Performance Reports..................................................................................................110
Adaptive Optimization Reports...............................................................................................111
7 Configuring the System Reporter Policy Settings..........................................112
Accessing the System Reporter Policies.....................................................................................112
Configuring Sampling Policies................................................................................................112
Compacting Databases....................................................................................................113
Editing Sampling Policies..................................................................................................114
Adding, Removing and Re-Configuring HP 3PAR Storage Systems...............................................115
Adding a Storage Server..................................................................................................115
Verifying Addition of a Storage Server................................................................................115
Removing a Storage Server...............................................................................................115
Re-Configuring a Storage Server Sampling..........................................................................116
Configuring Rules for Email Alerts...........................................................................................116
Adding an Alert Rule........................................................................................................117
Changing an Alert Rule....................................................................................................117
Removing an Alert Rule.....................................................................................................118
Alert Rule Parameters........................................................................................................118
Data Table.................................................................................................................118
Resolution..................................................................................................................119
System.......................................................................................................................119
Metric........................................................................................................................119
Direction....................................................................................................................121
Limit Value.................................................................................................................121
Limit Count.................................................................................................................121
Condition...................................................................................................................121
Condition Value..........................................................................................................121
Recipient....................................................................................................................121
Example of an Alert Rule...................................................................................................121
Scheduling Reports...............................................................................................................122
Adding a Scheduled Report..............................................................................................123
Changing a Scheduled Report...........................................................................................123
Removing a Scheduled Report...........................................................................................124
Configuring Adaptive Optimization.........................................................................................124
About File Permissions...........................................................................................................124
Modifying the Apache HTTP Server Configuration Files..............................................................125
8 Web Queries.........................................................................................126
About Web Queries..............................................................................................................126
Data Format Version Report...................................................................................................190
About Reports and Options....................................................................................................127
Report Options.....................................................................................................................128
category.........................................................................................................................128
example:....................................................................................................................128
compare.........................................................................................................................128
values:.......................................................................................................................128
example:....................................................................................................................130
comparesel.....................................................................................................................130
values:.......................................................................................................................130
table..............................................................................................................................131
values:.......................................................................................................................131
example:....................................................................................................................131
refresh............................................................................................................................131
values:.......................................................................................................................131
example:....................................................................................................................132
Contents 11
charttab..........................................................................................................................132
values:.......................................................................................................................132
example:....................................................................................................................132
charttype........................................................................................................................132
values:.......................................................................................................................132
example:....................................................................................................................133
graphx...........................................................................................................................133
value:........................................................................................................................133
example:....................................................................................................................133
graphy...........................................................................................................................133
value:........................................................................................................................133
example:....................................................................................................................133
graphlegpos...................................................................................................................134
value:........................................................................................................................134
example:....................................................................................................................134
tableformat.....................................................................................................................134
value:........................................................................................................................134
example:....................................................................................................................134
alllabels..........................................................................................................................134
values:.......................................................................................................................134
example:....................................................................................................................135
timeform.........................................................................................................................135
values:.......................................................................................................................135
example:....................................................................................................................135
begintsecs.......................................................................................................................135
value:........................................................................................................................135
example:....................................................................................................................136
endtsecs.........................................................................................................................136
value:........................................................................................................................136
example:....................................................................................................................136
groupby.........................................................................................................................136
values:.......................................................................................................................136
example:....................................................................................................................138
orderby..........................................................................................................................138
values:.......................................................................................................................138
example:....................................................................................................................140
histbegin........................................................................................................................140
values:.......................................................................................................................140
example:....................................................................................................................141
ldspaceunit.....................................................................................................................141
values:.......................................................................................................................141
examples:..................................................................................................................141
pdspaceunit....................................................................................................................141
values:.......................................................................................................................141
examples:..................................................................................................................142
vvspaceunit.....................................................................................................................142
values:.......................................................................................................................142
examples:..................................................................................................................142
selcageid........................................................................................................................142
value:........................................................................................................................143
examples:..................................................................................................................143
selchunks........................................................................................................................143
values:.......................................................................................................................143
example:....................................................................................................................144
selcpg............................................................................................................................144
12 Contents
value:........................................................................................................................144
example:....................................................................................................................144
selusrcpg........................................................................................................................144
selsnpcpg.......................................................................................................................145
seldisktype......................................................................................................................145
value:........................................................................................................................145
example:....................................................................................................................145
seldiskspeed...................................................................................................................145
value:........................................................................................................................145
example:....................................................................................................................145
seldomain.......................................................................................................................146
value:........................................................................................................................146
example:....................................................................................................................146
selhost............................................................................................................................146
value:........................................................................................................................146
example:....................................................................................................................146
selld...............................................................................................................................147
value:........................................................................................................................147
example:....................................................................................................................147
sellduse..........................................................................................................................147
values:.......................................................................................................................147
example:....................................................................................................................148
selnode..........................................................................................................................148
value:........................................................................................................................148
example:....................................................................................................................148
selnsp.............................................................................................................................148
value:........................................................................................................................148
example:....................................................................................................................149
selpdid...........................................................................................................................149
value:........................................................................................................................149
example:....................................................................................................................149
selpdstate.......................................................................................................................149
values:.......................................................................................................................149
example:....................................................................................................................150
selporttype......................................................................................................................150
values:.......................................................................................................................150
example:....................................................................................................................150
selraidtype......................................................................................................................150
values:.......................................................................................................................150
example:....................................................................................................................151
selsys.............................................................................................................................151
values:.......................................................................................................................151
example:....................................................................................................................151
selvv..............................................................................................................................151
values:.......................................................................................................................151
example:....................................................................................................................152
selvvtype........................................................................................................................152
values:.......................................................................................................................152
selprovtype.....................................................................................................................152
values:.......................................................................................................................152
Report Types........................................................................................................................153
Summary Report...................................................................................................................153
summary........................................................................................................................153
example:....................................................................................................................153
Space Reports......................................................................................................................153
Contents 13
pd_space_time................................................................................................................153
example:....................................................................................................................153
pd_space_group..............................................................................................................154
example:....................................................................................................................154
ld_space_time.................................................................................................................154
example:....................................................................................................................154
ld_space_group...............................................................................................................154
example:....................................................................................................................154
vv_space_time.................................................................................................................154
example:....................................................................................................................155
vv_space_group..............................................................................................................155
example:....................................................................................................................155
Performance Reports.............................................................................................................155
pd_perf_time...................................................................................................................155
example:....................................................................................................................155
pd_perf_group................................................................................................................155
example:....................................................................................................................156
pd_svt_hist......................................................................................................................156
example:....................................................................................................................156
pd_svt_histvstime.............................................................................................................156
example:....................................................................................................................156
port_perf_time.................................................................................................................156
example:....................................................................................................................156
port_perf_group..............................................................................................................156
example:....................................................................................................................157
port_svt_hist....................................................................................................................157
example:....................................................................................................................157
port_svt_histvstime............................................................................................................157
example:....................................................................................................................157
ld_perf_time....................................................................................................................157
example:....................................................................................................................157
ld_perf_group.................................................................................................................157
example:....................................................................................................................158
ld_svt_hist.......................................................................................................................158
example:....................................................................................................................158
ld_svt_histvstime..............................................................................................................158
example:....................................................................................................................158
vlun_perf_time.................................................................................................................158
example:....................................................................................................................158
vlun_perf_group..............................................................................................................158
example:....................................................................................................................159
vlun_svt_hist....................................................................................................................159
example:....................................................................................................................159
vlun_svt_histvstime...........................................................................................................159
example:....................................................................................................................159
vv_cmp_time...................................................................................................................159
example:....................................................................................................................159
vv_cmp_group.................................................................................................................159
example:....................................................................................................................159
cpu_perf_time.................................................................................................................160
example:....................................................................................................................160
cpu_perf_group...............................................................................................................160
example:....................................................................................................................160
Adaptive Optimization Reports...............................................................................................160
regiodensity....................................................................................................................160
14 Contents
regiondensity example.................................................................................................160
regmoves........................................................................................................................160
regmoves example......................................................................................................161
vvtier..............................................................................................................................161
vvtier example............................................................................................................161
Options Available by Report..................................................................................................161
Objects Present Reports.........................................................................................................167
objectpres= cageid..........................................................................................................168
example:....................................................................................................................168
output:..................................................................................................................169
objectpres= cpg_name.....................................................................................................169
example:....................................................................................................................169
output:.......................................................................................................................169
objectpres= diskspeed......................................................................................................170
example:....................................................................................................................170
output:.......................................................................................................................170
objectpres= disktype........................................................................................................170
example:....................................................................................................................170
output:.......................................................................................................................170
objectpres= domain_name................................................................................................171
example:....................................................................................................................171
output:.......................................................................................................................171
objectpres= host_name.....................................................................................................171
example:....................................................................................................................171
output:.......................................................................................................................171
objectpres= ld_name........................................................................................................172
example:....................................................................................................................172
output:.......................................................................................................................172
objectpres=node..............................................................................................................172
example:....................................................................................................................172
output:.......................................................................................................................173
objectpres=pdid..............................................................................................................173
example:....................................................................................................................173
output:.......................................................................................................................173
objectpres=port...............................................................................................................174
example:....................................................................................................................174
output:.......................................................................................................................174
objectpres= system...........................................................................................................174
example:....................................................................................................................174
output:.......................................................................................................................174
objectpres= vv_name.......................................................................................................175
example:....................................................................................................................175
output:.......................................................................................................................175
objectpres= vv_name_nosnap............................................................................................175
example:....................................................................................................................175
output:.......................................................................................................................176
objecctpres= porttype.......................................................................................................176
example:....................................................................................................................176
output:.......................................................................................................................176
sample_times..................................................................................................................177
example:....................................................................................................................177
output:.......................................................................................................................177
9 Using Adaptive Optimization...................................................................178
Overview............................................................................................................................178
Contents 15
Selecting an HP 3PAR Storage System for Adaptive Optimization................................................179
Configuring Adaptive Optimization.........................................................................................179
Tier Definition (CPG Name and GiB)..................................................................................180
Schedule........................................................................................................................182
Measurement Hours.........................................................................................................182
Adaptive Optimization Mode............................................................................................183
Adaptive Optimization Active............................................................................................183
Adding an Adaptive Optimization Configuration..................................................................183
Changing an Adaptive Optimization Configuration..............................................................184
Removing an Adaptive Optimization Configuration...............................................................184
Adaptive Optimization Reports...............................................................................................184
Region IO Density Report..................................................................................................184
VV Tiers Report................................................................................................................186
Adaptive Optimization Space Moved Report.......................................................................187
The showvvcpg CLI extension.................................................................................................188
10 Database Schema.................................................................................190
Using The Database Schema..................................................................................................190
Table Versions and Naming Conventions.................................................................................190
Administrative Tables............................................................................................................190
The policy Table..............................................................................................................190
The sampleinserv Table.....................................................................................................190
The system Table..............................................................................................................191
The alertconfig Table........................................................................................................192
The scheduled_report Table...............................................................................................193
The scheduled_report_log Table.........................................................................................193
The adprovconfig Table....................................................................................................193
The adprov_log Table.......................................................................................................194
The ldrgmoves Table.........................................................................................................194
The recentsample Table....................................................................................................195
The Sample Data and Inventory Tables....................................................................................196
The pdspace Table...........................................................................................................196
The pdspaceinv Table.......................................................................................................197
The ldspace Table............................................................................................................198
The ldspaceinv Table........................................................................................................198
The vvspace Table...........................................................................................................199
The vvspaceinv Table........................................................................................................201
The cpgspace Table.........................................................................................................201
The cpgspaceinv Table.....................................................................................................203
Common Performance Table Columns.................................................................................203
Calculating Common Performance Metrics......................................................................205
Service Time Histogram Buckets....................................................................................206
IO Size Histogram Buckets............................................................................................206
The statpd Table..............................................................................................................206
The statpdinv Table..........................................................................................................207
The statld Table...............................................................................................................207
The statldinv Table...........................................................................................................208
The statport Table............................................................................................................208
The statportinv Table........................................................................................................209
The statvlun Table............................................................................................................209
The statvluninv Table........................................................................................................210
The statvvcmp Table.........................................................................................................210
The statvvcmpinv Table.....................................................................................................211
The statcpu Table.............................................................................................................211
The statcpuinv Table.........................................................................................................212
16 Contents
The statlink Table.............................................................................................................212
The statlinkinv Table.........................................................................................................213
The statldrg Table.............................................................................................................213
The statldrg_timeinv Table.................................................................................................214
The perf_timeinv Table......................................................................................................214
The space_timeinv Table...................................................................................................214
11 Troubleshooting....................................................................................215
Troubleshooting Overview......................................................................................................215
Troubleshooting the Sampling Components..............................................................................215
Sampling Component Log Files..........................................................................................215
Installation Configuration..................................................................................................216
Sampling Errors...............................................................................................................216
Errors incurred by the inservsample process....................................................................216
Errors incurred by the CLI sampler process......................................................................217
Sampler Service/Daemon Errors........................................................................................217
Troubleshooting Adaptive Optimization Components.................................................................217
Troubleshooting the Web Server Components...........................................................................217
Troubleshooting the Excel Client..............................................................................................217
Extracting Data from the Database with sysbck.........................................................................218
Examples of Using sysbck for Various Databases..................................................................219
Dumping the Entire Database.................................................................................................222
Dumping the Entire SQLite Database..................................................................................222
Dumping the Entire MySQL Database.................................................................................222
Index.......................................................................................................223
Contents 17

1 Introduction

This guide provides the information you need to install and use HP 3PAR System Reporter to monitor performance, create charge back reports, and plan storage resources for HP 3PAR Storage Systems. An optionally licensed component called Adaptive Optimization is also included with System Reporter that can be used to monitor and automatically optimize utilization of storage resources. If you do not have a licence for Adaptive Optimization, the monitoring and system reporting features are still accessible but the optimization capabilities are inactivated.

User Interfaces

NOTE: The InServ Storage Server has been rebranded as HP 3PAR Storage Systeem. There are
instances in this document where screenshots and/or menu items and command output refer to the HP 3PAR Storage System as InServ or InServ Storage Server.
The HP 3PAR InForm® Operating System (InForm OS) has two user interfaces: the HP 3PAR InForm Command Line Interface (CLI) and the HP 3PAR InForm Management Console (IMC). You can use the IMC or the InForm CLI to monitor storage servers and access statistics. From the IMC or InForm CLI, you also can export table data to a.CSV (Comma-Separated Variable) file and then use Microsoft® Excel® or similar software to import that file. However, to generate reports directly in Microsoft Excel and to access historical information, you must use the system reporting tools described in this guide.
Two user interfaces are offered as part of the HP 3PAR Storage System: a Web-based interface and an Excel client.
The Web-based interface enables you to monitor HP 3PAR Storage Systems and access statistics
using a standard Web browser. Configuration of the System Reporter database sampling policies must be done via a Web browser.
The Excel client enables you to monitor HP 3PAR Storage Systems and access statistics using
Microsoft® Excel®. This option also offers additional customization options not offered by the Web-based interface.

Related Documentation

The following documents provide information related to HP 3PAR Storage Systems, the InForm® Operating System, the InForm® Management Console and InForm® CLI:
environmental considerations, power requirements, cabling, network configurations and third-party rack implementations
(CLI)
using the InForm Management Console (IMC)
Read the…For information about…
HP 3PAR Storage System Physical Planning ManualStorage system hardware specifications, site-planning,
HP 3PAR InForm OS Message and Operator’s GuideIdentifying storage server components and fixing problems
HP 3PAR InForm OS Command Line Interface ReferenceUsing the HP 3PAR InForm OS Command Line Interface
HP 3PAR InForm OS Management Console Online HelpConfiguring and managing HP 3PAR Storage Systems and
18 Introduction

Typographical Conventions

This guide employs the following typographical conventions:
ExampleMeaningTypeface
ABCDabcd
ABCDabcd

Advisories

To avoid unexpected configuration or operational problems, be sure to observe the notes and cautions in this guide.
WARNING! Warnings alert you to actions that can cause injury to people or irreversible damage
to data or the operating system.
CAUTION: Cautions alert you to actions that can cause damage to equipment, software, or data.
NOTE: Notes are reminders, tips, or suggestions that supplement the procedures included in this
guide.
Used for dialog elements such as titles, button labels, and other .
output.
When prompted, click Finish to complete the installation.
Open the fileUsed for paths, filenames, and screen
\gui\windows\setup.exe
Typographical Conventions 19

2 Overview and Features

This chapter provides a brief overview of the features and capabilities offered by System Reporter.

About System Reporter

System Reporter monitors performance and the usage of storage resources and allows you to generate charts and graphs that report useful statistics for planning and configuring the operation of HP 3PAR Storage Systems.
System Reporter provides the following main features:
Convenient access to configuration options for selecting systems to include for reporting,
specifying sampling parameters, scheduling reports, and generating alerts.
Extensive selection of reports for obtaining performance and storage utilization statistics on
selected objects (i.e., hosts, ports, nodes, physical disks, virtual volumes, etc.).
Quick access to pre-defined reports that contain useful statistics for most common types of
installations.
Scheduling of reports with predefined parameters that are initiated at predetermined times
and can then be accessed when needed.
Customization of reports using the standard web interface, (or through the provided Excel
client), that provide specifically selected and formatted reports for specified systems.
Options for choosing the time and duration for the collection of reporting statistics which can
be initiated at a specific time, collected over a period of time, and/or compared between a range of times.
Options for viewing and comparing report information in a variety of formats through a
selection of charts and tables.
Alerts that can be configured to send email notifications to a specified address when certain
reporting criterion are met.
Support for customized formatting of report data via the Comma Separated Values (CSV) file
formatting standard for inclusion in web or Excel applications.
Support for creating custom web or Excel reports using well documented Web queries.
Access to the database schema for direct queries to the reporting data stored in the database
used by System Reporter.
Inclusion of an optionally licensed component called Adaptive Optimization that can analyze
access rates for sub-volume level regions and move regions between tiers of storage for more optimal and efficient storage utilization.

Configuring System Reporter Policy Settings

Although you can begin using System Reporter immediately after it has been installed to quickly access reports, you may want to make some adjustments or set up some of the capabilities for your particular operating environment by selecting the appropriate configuration options through the Policy Settings.
The following configuration options are available from the Policy Settings:
Sampling Policies -- Specifies the report sampling policies that determine sampling intervals,
how long reports are stored, when to perform database compaction, etc.
InServ Systems -- Selects the HP 3PAR Storage Systems to include for sampling, report generation
and optional optimization. The systems are generally added during the installation, but you can access this option to add or remove systems as needed.
20 Overview and Features
Alert Rules -- Used to add, modify and remove alert rules and to specify the parameters for
generating email reports.
Scheduled Reports -- Used to add, modify, and remove scheduled reports for generation at a
specified time.
Adaptive Optimization -- Configures the optionally licensed Adaptive Optimization components
that are used to monitor and optimize storage utilization.
See for details on how to configure the policy settings for your site.

Choosing a Method for Accessing Reports

There are three basic methods for accessing reports through System Reporter: Quick Reports -- Allows you to immediate access a variety of pre-defined reports (created through
CGI programs) that are deemed useful for most installations. The reports are made available through a menu tree that you expand and collapse to select the systems and options of interest. For instance, one of the reports provides a comparison of the peak hourly system CPU utilization for the past seven days for all systems while another compares the utilization of the most active physical disks for a given system.
Scheduled Reports -- Allows you to view reports that were created at scheduled times based on pre-selected parameters and stored in a reserved directory structure. You can either view the reports via the web interface provided through System Reporter or you can copy the report subdirectories to another area and view them there. Maintaining a report directory for scheduled reports allows an administrator to limit the users who have access to each report directory. One example where this may be useful is when multiple departments share an array. In this case, the administrator can schedule various reports specifically designed for each department, place them in different report directories, and then grant each department access to the relevant scheduled reports in their own report directory.
Custom Reports -- Custom reports are more complex to generate because they allow for a great deal of customization, but they are also very useful. You can select the resolution, the type of report, and then specify which systems and domains are to be monitored for the reporting information that is collected. You also have the choice of specifying how the information is to be formatted for presentation through a selection of tables and graphs.

Creating Customized Reports

System Reporter provides a number of options for building customized reports as follows:
Report Selection. Allows you to select from one of the reports shown in Table 1 (page 21):
Table 1 Available Reports
Summary
PD Space
CPG Space
LD Space
VV Space
Port Performance
Report Metrics Cross ReferenceDescriptionReport Name
“Accessing Quick Reports” (page 103)Displays summary
information.
“PD Space Reports” (page 106)Displays physical disk
space usage.
“PD Space Reports” (page 106)Displays CPG disk space
usage.
“LD Space Reports” (page 107)Displays logical disk
space usage.
“VV Space Reports” (page 107)Displays virtual volume
space usage.
“Common Performance Metrics” (page 108)Displays port
performance.
Choosing a Method for Accessing Reports 21
Table 1 Available Reports (continued)
Report Metrics Cross ReferenceDescriptionReport Name
VLUN Performance
LD Performance
PD Performance
VV Cache Performance
Node Cache Performance
CPU Performance
Link Performance
Adaptive Optimization
(volume-LUN) performance.
performance.
performance.
volume) cache performance.
Displays Node Cache Performance.
performance.
links between nodes.
Optimization reports.
“Common Performance Metrics” (page 108).Displays VLUN
“Common Performance Metrics” (page 108)Displays logical disk
“Common Performance Metrics” (page 108)Displays physical disk
“VV Cache Performance Reports” (page 109)Displays VV (virtual
“Node Cache Performance Reports” (page 109)
“CPU Performance Reports” (page 110)Displays CPU
“Link Performance Reports” (page 110)Displays performance of
“Adaptive Optimization Reports” (page 111)Displays Adaptive
Sample Resolution – Specifies how often operational metrics are sampled for a given report:
Daily – Sampling is performed once a day.
Hourly – Sampling is performed on an hourly basis.
Hi Resolution – Sampling is performed at much more frequent intervals as defined by the
"Requested High-Res sampling interval in minutes" option defined through the Sampling Policies setting which offers the finest granularity of operational statistics.
The retention period for the sampled data in the database tables is set through the sampling policy (see “Configuring Sampling Policies” (page 112)). The data is purged based on the limit set through the policy settings. You also have the ability to set the data retention period for individual systems (see for details).
System and Domain Selection – Specifies the systems and domains that are to be included in
the report.
Scope of Report Selection – The options for all reports (except for the Summary report), are
divided into four sections: Versus Time reports plot data over a period of time (time is along the X-axis). These reports
can either plot aggregate metrics or separate metrics for up to 16 objects. If you want to compare more than 16 objects, or do more complex object selection you must use the At Time reports described below.
At Time reports allow you to compare a large number of objects, defined in more complex
ways, but only at a specific point in time. The objects are plotted along the X-axis.
Histogram At Time reports show the distribution of service times and IO sizes at a specific
point in time.
Histogram vs Time reports show the distribution of service times and IO sizes over a
period of time (time is along the X-axis).
Time Selection – Selects the time or range of times when the report is to be generated.
22 Overview and Features
Object Selection – Selects the list of objects that are to be included in the reporting data. For
example, you can select the VVs, ports and hosts for a VLUN.
Format Selection – Selects the format of the report including whether the report should show
charts and/or tables and the type and size of charts.
See for complete details on how to build customized reports.

Formatting Reports for Presentation

When building customized reports, you can specify how the reporting data is formatted for viewing by selecting the appropriate table or type of chart. You can choose from the following chart types:
Stacked Bars
Staked Vertical Bars
Stacked Area
Bars
Vertical Bars
In addition to choosing the type of chart that is best suited for the report being generated, you can also fine tune the presentation by selecting the position of the legend, choosing a time format and specifying how the units of storage measurement are represented (i.e., MBs, TBs, chunklets, etc.).
When using the Excel client to build reports, you have additional flexibility in the formatting of a report by modifying the datasheet and including customized columns.
See for descriptions and options available for formatting reporting data.
NOTE: Access to a currently unsupported charting package is also available in this version and
offered as one of the formatting options (under Chart Lib) when generating a report. To use the unsupported charting capabilities offered through this “Dynamic” charting option, you
must use a browser that supports html5 canvas tags (the latest versions of Windows E9, Firefox and Google Chrome browsers currently offer this support).

Customizing the Reporting Format

Although System Reporter provides a number of built-in controls for specifying the format of a report, in some cases you may want to present the data using a different format that is not available from the standard selection. In this case, you can save the data for the report using the Comma Separated Values (CSV) format as an option that is accessible with the click of an icon next to the heading of the report. You can then open the CSV formatted file in an application (such as a spreadsheet) where it can then be charted or formatted as desired. If the browser is set up to open files with a .csv extension in a spreadsheet application, this can be done automatically.

Generating Email Alerts

You can configure System Reporter to send email alerts when certain metrics meet specified conditions. For example, suppose you want to receive an email alert when any VLUN has an average read service time of more than 100 ms in any high-resolution sampling interval. To do this, all you need to do is fill in a form with the specified details and then submit the query.
See for complete details on how to configure email alerts.

Accessing Report Data using Web Queries

The querying mechanism employed by System Reporter is made available for specialized customization of reports. For instance, instead of using the Excel client provided with System Reporter, you can use web queries in an Excel spreadsheet to bring various report data into your spreadsheets. As another alternative, you might like to view multiple standard reports presented
Formatting Reports for Presentation 23
together in a single web page. You can do this by creating an html file that includes multiple iframe elements, each of which includes a standard web report query.
See “Web Queries” (page 126)for details on how to instigate web queries.

Using the Database Schema to Build Custom Reports

The databases used by System Reporter are standard relational databases capable of supporting SQL queries. The default (built-in) database is SQLite (see http://www.sqlite.org) but MySQL and Oracle database servers can optionally be used instead. The database schema is documented so you can write your own reports by directly querying the System Reporter database.
See for details on how to utilize the database schema.

Analyzing and Optimizing Storage Utilization

An optionally licensed component called Adaptive Optimization is included with System Reporter. Adaptive Optimization analyzes sub-volume, region level disk access rates for a given array over a scheduled period of time and then performs a data migration of regions between tiers according to a cost versus performance preference. Disk utilization is optimized by having frequently accessed data moved to the higher performance tier (e.g., RAID 1 using Solid State Disks or SSDs) while infrequently accessed data is moved to the lower cost tier (e.g., RAID 6 on Nearline disks). By using Adaptive Optimization, you can achieve a much higher degree of control over disk usage by reserving your faster and more expensive storage resources for the data that is frequently accessed and relegating your slower and less expensive drives to storing data that is only occasionally accessed.
24 Overview and Features

3 Installation, Configuration, Update, and Removal

This chapter describes how to install and configure as well as remove the HP 3PAR System Reporter components.

Before You Begin

Before installing HP 3PAR System Reporter components, select a system on which to run the System Reporter sampler and Web server. This system must use Windows® Server 2003, Windows® Server 2008 or Red Hat® Enterprise Linux 5.
If necessary, perform the following setup activities on the designated Windows® or Red Hat® Linux server:
Install the InForm OS Command Line Interface (CLI), version 2.3.1 or above.
Install the Apache Server.
If you are using an Oracle database, you must install the Oracle client.
(Optional). To avoid a DHCP-assigned address changing, assign a fixed IP address to the
system.
NOTE: The CLI installer executable for the InForm OS can be found on the System Reporter CD
at: Windows\CLI\setup.exe (for Windows) or Linux/CLI/setup.bin (for Linux) See the InForm OS Management Console Online Help, located on the System Reporter CD at:
Document/CLI\231_CLI_Administrator_Manual.pdf, for instructions on installing the InForm CLI.

System Reporter CD Contents

InServ Storage ServerCD includes the following contents (Table 2 (page 25)):
Table 2 InServ Storage Server CD Contents
/Documents/
231_CLI_Admininstrator_Manual.pdf
nl
SR_Sizing.xls
nl
nl
/Linux/
/Linux/ CLI/
/Scripts/
nl
nl
nl
showvvcpg.tcl
nl
DescriptionFilenameDirectory
HP 3PAR InForm OS CLI Administrators Guide.CLI\
System Reporter server sizing spreadsheet (see “Using the System Reporter
Sizing Spreadsheet” (page 27)).
HP 3PAR System Reporter Software User Guide (this document).System_Reporter.pdf
System Reporter sampleloop package for Red Hat Linux.sampleloop-2.9-1.i386.rpm
System Reporter sysrptwebsrv package for Red Hat Linux.sysrptwebsrv-2.9-1.i386.rpm (Version 2.3.1 of the InForm CLI has only been validated for RedHat 5.2.
Version 2.2.4 of the InForm CLI has been validated for RedHat 5.0 and
5.1.).
HP 3PAR InForm OS CLI installer executable for Red Hat Linux.setup.bin
CLI script implementing the CLI showvvcpg extension command (see “The
showvvcpg CLI extension” (page 188)).
/Windows/
apache_2.2.14-win32-x86-openssl-0.9.8k.msi
nl
Apache HTTP Server installer executable for Microsoft Windows. This installer is provided only as a convenience. You may choose to download and install directly from: http://httpd.apache.org.
Before You Begin 25
Table 2 InServ Storage Server CD Contents (continued)
CLI/

System Requirements

HP 3PAR System Reporter supports the use of the HP 3PAR InForm OS, versions 2.2.4 through
2.3.1 MU1 and beyond. Observe the following minimum system hardware requirements:
Table 3 Minimum Hardware Requirements
For better performance, it is recommended that you use separate disks for application data and database data.
DescriptionFilenameDirectory
System Reporter installer executable for Microsoft Windows.installer.exe
HP 3PAR InForm OS CLI installer executable for Microsoft Windows.setup.exe/Windows/
Minimum RequirementSystem Component
Pentium 4, 3GHz (or faster)CPU
1 GBMemory
20 GB free space (application and data)Disk
NOTE: When running System Reporter on a Virtual Machine, it is best to have the database
server running on a separate VM, especially for Microsoft SQL, MySQL or Oracle.
HP 3PAR System Reporter components have the following requirements (Table 4 (page 26):
Table 4 HP 3PAR Storage System Requirements
Additional RequirementsSupported Operating SystemsComponent
Database
Microsoft SQL Server Note that Microsoft SQL is not supported on Linux platforms.
Sampling service
Web server
Web Browser (one of the following)
Windows® Server 2008 Red Hat Enterprise Linux 5.4 32 or 64-bit OS versions are supported except that only the 32-bit versions of Linux are supported for the Sampling service when using the Oracle 11g Database since we need to use the 32-bit Oracle 11g client which is only supported on the 32-bit Linux.
MySQL® Database Server version version
5.1(Optional) Oracle 11g® Database (Optional) (Oracle RAC is not currently supported.)
Microsoft SQL Server Note that Microsoft SQL is not supported on Linux platforms.
Oracle 11g Client (32-bit only) when used with Oracle 11g Database
Apache HTTP Server 2.0 or later (installer provided for version 2.2.14 on Microsoft Windows)
Internet Explorer 7 or later
Mozilla Firefox 3.0 or later
(To use the dynamic charting capabilities offered as an unsupported formatting option, you must have Firefox 3.6 or later or IE 9.)
Excel client
26 Installation, Configuration, Update, and Removal
Microsoft® Excel 2003, 2007 (not supported on Mac OS X)
Table 4 HP 3PAR Storage System Requirements (continued)
Additional RequirementsSupported Operating SystemsComponent
Adaptive Optimization
NOTE: The optionally licensed Adaptive Optimization component is only supported by InForm
OS versions 2.3.1 MU 1 and beyond. Adaptive Optimization is not supported for SQLite databases; only Oracle and MySQL are supported.

Using the System Reporter Sizing Spreadsheet

Before installing System Reporter, you need to determine the system resources that are required to adequately run System Reporter and the selected data base server. The optimal computing power (CPU cores), memory and storage space needed to accommodate the data that is sampled by System Reporter and used to generate reports depends on the number of systems and the amount of storage that is being monitored for your particular installation. An Excel spreadsheet named SR_Sizing.xls (Figure 1 (page 28)) is included with System Reporter for the purpose of determining the optimal system resources that are recommended for running System Reporter and the database server at your site. This spreadsheet is included on the installation CD.
NOTE: The System Reporter Sizing Spreadsheet is protected except for the cells in red, but you
can turn off the protection to see the formulas that are used to derive a given value.
InForm OS version 2.3.1 MU1 and beyond. Not supported when using SQLite database.
Adobe Acrobat ReaderOn-Line Help (User’s Guide)
Entities in the spreadsheet are color coded. Only the values into controls or cells colored red need to be set. Cells or ranges in yellow are output values that you can use to size or configure the server that you will use to run System Reporter. Values in blue are empirically determined parameters used to drive the sizing model.
Using the System Reporter Sizing Spreadsheet 27
Figure 1 System Reporter Sizing Spreadsheet
1. Click on the appropriate type of database that you are using for System Reporter at your site. You will notice that SQlite only supports one HP 3PAR Storage System for use with System
Reporter. Please consider another database if you plan on using System Reporter to monitor more than a single HP 3PAR Storage System.
2. Modify the Sampling Parameters in red to reflect the approximate values for your installation. The values for Table Row Sizes in blue are approximate table row sizes (bytes) based on
observations derived by HP during testing System Reporter instances and includes some extra space to accommodate typical inventory tables, indexes, etc.
3. Observe the requirements that are shown in the yellow cells to determine the suggested allocation of system resources for your System Reporter server or database server.
NOTE: The database server should have roughly the same amount of memory and CPU
cores as the System Reporter server.

System Reporter Components

System Reporter includes the following components (Figure 2 (page 29)):
28 Installation, Configuration, Update, and Removal
Figure 2 HP 3PAR Storage System and User Interface Components
Database. The HP 3PAR System Reporter database is capable of supporting SQL queries.
Four types of databases are supported: Microsoft SQL Server, SQLite, MySQL and Oracle (see “Installing the Database Server” (page 32)).
Sampler components. The sampler components are responsible for sampling performance
and space information from the HP 3PAR Storage System arrays, saving the data in the database, and removing old samples from the database. The sampler components include the following:
The sampling service (sampleloop) runs as a service on Windows or as a daemon on
Linux. It creates and coordinates other sampler components.
A separate inservsample process is created for each HP 3PAR Storage System being
sampled. This process in turn creates a separate CLI process that runs the sampler script which logs into the array and collects the required data. The inservsample process then inserts the data into the database. Along with the tables that contain the space and performance data, the database also includes inventory tables that allow quicker creation of report menus. The inservsample process also update the inventory tables.
For MySQL, Microsoft SQL Server (Windows only), and Oracle databases, the sampleloop
service/daemon creates a separate process to maintain the database (since SQLite supports limited concurrency, these functions are performed by the sampleloop process). These include:
The trimdb process removes samples that are older than the sample retention period
specified in the sampling policies (see “Configuring Sampling Policies” (page 112)).
The dedupinv process removes duplicate entries from the inventory tables. The compactdb process periodically compacts and optimizes the database when
necessary.
Adaptive Optimization components. The sampleloop process also creates a regionmover
process for each HP 3PAR Storage System array for which Adaptive Optimization is configured (see “Selecting an HP 3PAR Storage System for Adaptive Optimization” (page 179)). Each regionmover process analyzes region level performance data for each Adaptive Optimization configuration and generates region moves between tiers. The regionmover process creates a separate CLI process that logs into the array and executes the mvrg program that executes the data movement commands on the array.
System Reporter Components 29
Web server components. The HP 3PAR System Reporter Web server has customized scripts
that access the database to generate reports to standard browsers as clients, enabling users to access the reports and configure System Reporter without installing any additional software.
Excel client. The customized HP 3PAR System Reporter Excel client has built-in Web queries
to the Web server. Use of the Excel client is optional, but offers you additional options. You must have Microsoft® Excel® in order to use the HP 3PAR System Reporter Excel client.

Installing the System Reporter Components

Required Components

To begin using HP 3PAR System Reporter, you must install the following components which are supplied on the installation CD:
CLI for InForm OS
Web server (Apache HTTP Server)
System Reporter tools (sampler, default SQLite database, and web server tools for generating
reports)
Windows installer.exe Linux sysrptwebsrv-2.9-1.i386.rpm sampleloop-2.9-1.i386.rpm
NOTE: To install and use System Reporter, you must have a valid license. If you plan use Adaptive
Optimization, you must also have an additional license to take advantage of the storage optimization capabilities offered by this optional component.

Optional Components

Installation of the following components are optional:
Excel client (optional). While the necessary Excel sheet is automatically included, Microsoft
Excel is required by the machine accessing the Excel sheet from the System Reporter server.
The Microsoft SQL, MySQL or Oracle database (optional). Except for the SQLite database
which is supplied with System Reporter, any other choice of database must be obtained from the respective vendor.
Adaptive Optimization (Offered by HP as an option and requires a separate license)
NOTE: If you are upgrading an existing System Reporter installation to the 2.9 release, you do
not need to re-install the CLI, optional MySQL database or Apache web server. You only need to re-install the System Reporter Tools as described in “Installing or Upgrading the System Reporter
Tools” (page 43). If you wish to keep the previously collected data, you must specify the same
database during the installation process. The System Reporter installer for Microsoft Windows will automatically detect previous settings and offer the option to upgrade the existing installation.
System Reporter 2.9 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.
All table updates are logged in the Sampleloop.log. Contact your customer service representative if any tables fail to update properly.
The following flowchart (Figure 3 (page 31)) provides a visual representation of the installation process for a new installation that is described in detail in the following sections.
30 Installation, Configuration, Update, and Removal
Loading...
+ 194 hidden pages