Professional Documents
Culture Documents
Version 1.1
June 9, 2000
Copyright 2000 BMC Software, Inc., as an unpublished work. All rights reserved. BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc. IBM and DB2 are registered trademarks of International Business Machines Corp.; Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corp. Actuate is a registered trademark, and the Actuate product names are registered trademarks or trademarks of Actuate Corporation. All other registered trademarks or trademarks belong to their respective companies.
Telephone Fax
Customer Support
You can obtain technical support by using Response Online (support from the Web) or Response On Demand. To expedite your inquiry, please see Before Contacting BMC Software, below.
Response Online
You can obtain technical support from BMC Software 24 hours a day, seven days a week by accessing the technical support Web site at http://www.bmc.com/support.html. From this site, you can read overviews about support services and programs that BMC Software offers nd the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released nd worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers
Response On Demand
In the USA and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the USA and Canada, please contact your local support center or your local sales ofce for assistance.
operating-system and environment information machine type operating system type, version, and service pack or program temporary x (PTF) system hardware conguration serial numbers related software (database, application, and communication) including type, version, and service pack or PTF
sequence of events leading to the problem commands and options that you used messages received (and the time and date that you received them) product error messages messages from the operating system, such as file system full messages from related software
iii
iv
Contents
Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Chapter 1 Introducing Reporting
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Checking Reporting System Components . . . . . . . . . . . . . . . . . . . . . 1-3 QuickReport Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Report Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Report Viewers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Looking at the Integrated Application . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Providing the Data for Reporting . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Understanding Basic Reporting Concepts . . . . . . . . . . . . . . . . . . . . . 1-7 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Report Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Chapter 2 Introducing the Reporting Tools
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Understanding Reporting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 QuickReport Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Actuate Desktop Applications . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Using the Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Accessing the Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . 2-5 Using the Report Encyclopedia . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Looking at the Report Encyclopedia using the Web Desktop . . . 2-7
BMC Software, Inc., Condential and Proprietary Information
Contents
Navigating the Report Encyclopedia with the Web Desktop . . .2-9 Navigating in the Report Encyclopedia . . . . . . . . . . . . . . . . . . . .2-11
Chapter 3 Planning Your Reporting Strategy
Introducing Report Types and Templates . . . . . . . . . . . . . . . . . . . . . .3-2 Describing QuickReport Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2 Planning QuickReports Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4 QuickReports Reporting Checklist . . . . . . . . . . . . . . . . . . . . . . .3-4 Example: Locating Servers with the Least Available Space . . . .3-5 Example: Examining Servers with Highest CPU Usage . . . . . . .3-7 Example: Finding Server Hot Spots . . . . . . . . . . . . . . . . . . . . . .3-10 Example: Verifying Parameter Collection . . . . . . . . . . . . . . . . . .3-13 Using Solution-Specic Reporting . . . . . . . . . . . . . . . . . . . . . . . . . .3-15 Solution Reporting Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 Example: Selecting Windows NT Servers for Upgrading . . . . . .3-16 Example: Locating Heavily Used Unix Servers . . . . . . . . . . . . .3-17 Planning Strategies for Mixing Reporting Types . . . . . . . . . . . . . . . .3-17 Mixing Reporting Types Checklist . . . . . . . . . . . . . . . . . . . . . . .3-17 Example: Getting a Picture of the Enterprise . . . . . . . . . . . . . . .3-18
Chapter 4 Creating, Scheduling, Viewing, and Printing Reports
Creating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2 Creating a New Report Template with the QuickReport Editor .4-2 Creating a New Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3 Editing a Report Template with the QuickReport Editor . . . . . .4-12 Editing an Existing Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-13 Deleting a QuickReport Template that you Created . . . . . . . . . .4-16 Deleting a Template with the QuickReport Editor . . . . . . . . . . .4-17 Scheduling and Generating Reports . . . . . . . . . . . . . . . . . . . . . . . . . .4-19 Scheduling QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-19 Scheduling a QuickReport Template . . . . . . . . . . . . . . . . . . . . . .4-20 Generating Solution Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-23 Generating a Solution Report . . . . . . . . . . . . . . . . . . . . . . . . . . .4-24 Locating and Viewing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-28 Locating and Viewing QuickReports . . . . . . . . . . . . . . . . . . . . .4-29 Viewing a QuickReport from the Report Encyclopedia . . . . . . .4-30 Locating and Viewing a Solution Report . . . . . . . . . . . . . . . . . .4-30 Viewing a Solution Report from the Report Encyclopedia . . . . .4-31 Printing and Distributing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31 Printing a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-32
BMC Software, Inc., Condential and Proprietary Information
vi
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Describing QuickReport Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Interpreting QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Looking at Hot Spots Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5 Looking at Data Collection Tables . . . . . . . . . . . . . . . . . . . . . . . 5-6 Summarizing Enterprise Events and Measurements . . . . . . . . . . . . . 5-7 Taking a Closer Look at Enterprise Measurements . . . . . . . . . . . . . . 5-10 Locating Enterprise Hot Spots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Checking Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Chapter 6 Working with Solution Reports for Microsoft Windows 2000 Server
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Dening Windows Server Status Reports . . . . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Parameter Reports . . . . . . . . . . . . . . . . . . 6-3 Describing Server Cache Parameter Reports . . . . . . . . . . . . . . . 6-4 Describing Server CPU Parameter Reports . . . . . . . . . . . . . . . . 6-4 Describing Server Logical Disk Parameter Reports . . . . . . . . . . 6-5 Describing Server Memory Parameter Reports . . . . . . . . . . . . . 6-6 Dening Windows Server Service Availability Reports . . . . . . . . . . 6-7 Interpreting Windows Server Solution Reports . . . . . . . . . . . . . . . . . 6-9 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Chapter 7 Working with Solution Reports for Unix
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Dening Unix Status and Availability Reports . . . . . . . . . . . . . . . . . 7-2 Dening Unix Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . . 7-4 Dening Unix Capacity and Utilization Reports . . . . . . . . . . . . . . . . 7-5 Interpreting Solution Reports for Unix . . . . . . . . . . . . . . . . . . . . . . . 7-7 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Looking at Summary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
Chapter 8 Working with Solution Reports for Microsoft Exchange Server
Contents
vii
Dening Microsoft Exchange Server Performance Reports . . . . . . .8-3 Dening Microsoft Exchange Server Capacity or Usage Reports . . .8-4 Interpreting Solution Reports for Microsoft Exchange . . . . . . . . . . .8-7 Looking at Summary Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-8 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-9
Chapter 9 Working with Solution Reports for Oracle
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2 Dening Oracle Availability Reports . . . . . . . . . . . . . . . . . . . . . . . . .9-3 Dening Oracle Performance Reports . . . . . . . . . . . . . . . . . . . . . . . .9-4 Oracle SGA Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-5 Dening Oracle Capacity Reports . . . . . . . . . . . . . . . . . . . . . . . . . . .9-6 Interpreting Solution Reports for Oracle . . . . . . . . . . . . . . . . . . . . . .9-7 Looking at Trend Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-7 Looking at Summary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9
Glossary Index
viii
About
This book assumes that you are familiar with your host operating system. You should know how to perform basic actions in a window environment, such as choosing menu commands and dragging and dropping icons.
ix
Related Documentation
BMC Software products offer several types of documentation: online and printed books online Help release notes
In addition to this book and the online Help, you can nd useful information in the publications listed in the following table. As Actuate Software Corporation Documentation on page xi explains, these publications are available on request from BMC Software.
Category
Installation documents Core documentation
Document
Service Reporting Getting Started Guide DataStore Administrator Guide Reporting User Guide
Description
contains the installation and basic conguration instructions for Service Reporting provides instructions for using DataStore and the DataStore Console provides instructions for creating, analyzing, viewing, and distributing enterprise-wide reports contain the latest updates to Service Reporting products
Release Notes
BMC Software also provides documentation for the Actuate Software Corporation components of Service Reporting.
Description
describes new features, identies known limitations, and lists customer-reported defects that have been xed provides information about managing users, groups, roles, privileges, printers, process groups, and print requests describes the tasks you can perform with reports that have been designed, compiled, and generatedincludes using e.reports on the Web or a desktop, viewing and running a report, searching for and exporting data, printing and distributing a report describes the tasks you can perform using the Actuate Viewerincludes the same topics as Using e.Reports except for running a report describes the tasks you can perform using Microsoft Internet Explorer in combination with the Actuate LRX describes the tasks you can perform using Netscape Navigator in combination with the Actuate LRX
File Name
readme.pdf
Size
51 KB
admin-report-encycolpedia.pdf
2,744 KB
Using e.Reports
using-ereports.pdf
4,331 KB
Viewing e.Reports
viewing-ereports.pdf
3,791 KB
lrx-microsoft.pdf
3,153 KB
lrx-netscape.pdf
3,163 KB
xi
Document
Building an e.Reporting Web Site
Description
provides information on accessing the Actuate Report Encyclopedia on the World Wide Web provides information about managing the interaction between client and server to enable activities such as scheduling and running reports
File Name
reportcast.pdf
Size
3,456 KB
ereporting-server.pdf
2,548 KB
Online books are formatted as Portable Document Format (PDF) files. You can view them, print them, or copy them to your computer by using Acrobat Reader 3.0 or later. You can access online books from the documentation compact disc (CD) that accompanies your product or from the World Wide Web. In some cases, installation of Acrobat Reader and downloading the online books is an optional part of the product-installation process. For information about downloading the free reader from the Web, go to the Adobe Systems site at http://www.adobe.com. To view any online book that BMC Software offers, visit the support page of the BMC Software Web site at http://www.bmc.com/support.html. Log on and select a product to access the related documentation. (To log on, first-time users can
xii
request a user name and password by registering at the support page or by contacting a BMC Software sales representative.)
To Request Additional Printed Books
BMC Software provides a core set of printed books with your product order. To request additional books, go to http://www.bmc.com/support.html.
Online Help
You can access Help for a product through the products Help menu. The online Help provides information about the products graphical user interface (GUI) and provides instructions for completing tasks.
Release Notes
Printed release notes accompany each BMC Software product. Release notes provide up-to-date information such as summary of new features updates to the installation instructions last-minute product information listing of the related documentation
The latest versions of the release notes are also available on the Web at http://www.bmc.com/support.html.
xiii
Conventions
The following conventions are used in this book: This book includes special elements called notes, warnings, examples, tips, and see online help:
Note
Warnings alert you to situations that can cause problems, such as loss of data, if you do not follow instructions carefully.
Example
Tip
A tip provides useful information that may improve product performance or make procedures easier to follow. Directs you to product Online Help for information to supplement the printed documentation. The symbol => connects items in a menu sequence. For example, Actions => Create Test instructs you to choose the Create Test command from the Actions menu.
xiv
Introducing Reporting
This chapter provides information on using the reporting components of Service Reporting and describes how the reporting components relate to the other components of the Service Reporting product. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Checking Reporting System Components . . . . . . . . . . . . . . . . . . . . . 1-3 Looking at the Integrated Application . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Understanding Basic Reporting Concepts . . . . . . . . . . . . . . . . . . . . . 1-7
Introducing Reporting
1-1
Overview
Reporting is the part of Service Reporting that provides report creation and viewing facilities. The Service Reporting system allows users to generate, view, distribute, and manage reports. Service Reportings report creation and viewing tool provides predened (Solution Reports) and user-dened (QuickReports) reports. You can use any combination of Solution Reports or QuickReports to look at information from different points of view. Key features and benets of Service Reporting include: An enterprise-scale perspective of systems management Easy report creation Report scheduling options for proactive, exception-based management Quick identication of problem sources through summary and detailed information Easy access to system management information through the Web Enhanced system management productivity through broad-based exception reporting Diagnosis of complex problems through historical insight on similar problems and related symptoms
1-2
Actuate Software Corporation components: Report Server Report Encyclopedia Report viewers
QuickReport Editor
The QuickReport Editor allows you to dene new report templates based on specic PATROL parameters and events, to copy and modify report templates, and to delete report templates. The QuickReport Editor is part of a Web-based graphical user interface (GUI), the Web Desktop. You use the QuickReport Editor to create reports from user-dened templates.
Solution Reports
Solution Reports are predened reports created for the management of a specic technology or application. These reports require little or no user setup. Solution Reports might provide information on service management, enterprise resource management, or on other requirements specic to the management of a particular application or technology.
Introducing Reporting
1-3
These reports consist of a set of pre-dened reports for specic operating systems and applications. The basic operating system (OS) report packages, are shipped as part of Service Reporting. The basic Solution Reports for Service Reporting are: Solution Reports for Microsoft Windows 2000 Server - used to view Windows 2000 and Windows NT measurements across your enterprise Solution Reports for Unix - used to view Unix measurements across your enterprise
Other Solution Reports are available as optional packages specic to a given application, for example: Solution Reports for Microsoft Exchange Server Solution Reports for Oracle
Report Server
The Report Server is the central point for creating and managing reports. From the Report Server, you can: generate on-demand or scheduled reports print reports manage report documents and folders manage users and roles validate users and requests for on-demand reports with run-time parameters
The Actuate Administrator Desktop is the interface for managing report server users and reports. For information on using the Actuate Administrator Desktop, refer to the Actuate documentation.
1-4
Report Encyclopedia
The Report Encyclopedia is an online storage area for Actuate information that relates to reporting. Information in the Report Encyclopedia is organized into the following directories: administrative directory - stores users, roles, and privileges information requests and scheduling directory - contains active and scheduled requests for report generation report item directory - includes report templates, executables, parameters, and generated reports
You can access a Report Encyclopedia remotely by using a Web-based graphical user interface (GUI), the Web Desktop. For information on how to access and move through the Report Encyclopedia, see Accessing the Report Encyclopedia on page 2-5 and Navigating the Report Encyclopedia with the Web Desktop on page 2-9.
Report Viewers
You can review reports using several applications. BMC Software recommends the use of your Web browser, referred to as the Web Desktop. With a Web browser, you can generate, schedule, view, and print reports. You access the Report Encyclopedia remotely by entering a URL in a Web browser on a supported system. For information on how to access reports through the Web and navigate the Report Encyclopedia, see Using the Web Desktop on page 2-5. You can also use the following Windows applications to view reports: Actuate End User Desktopuse to request immediate report generation, for local report viewing, and for local printing Actuate Administrator Desktopuse to schedule report generation, for local report viewing, and for local printing
Introducing Reporting
1-5
For information on the Actuate Windows applications, refer to Viewing e.Reports, Using e.Reports, or the respective applications online help.
The following sections show how the major components of Service Reporting work together to provide an environment to enhance your enterprise reporting capabilities.
See the DataStore Administrator Guide for more information on collectors, aggregators, and DataStore.
1-6
Reports
Reports are generated presentations (graphs, tables, or charts) based on stored PATROL event and parameter data that you can view remotely using a Web browser on supported platforms.
QuickReports
QuickReports are reports created from user-dened templates. The reports (graph, table, or chart) are created when you specify parameters, selection criteria, labels, and scheduling options using the QuickReport Editor.
Solution Reports
Solution Reports are packages of reports created for the management of a particular technology or application. The Solution Reports require little or no user setup.
Report Templates
Report templates are denitions for Service Reporting that direct the extraction of data from the DataStore for a given time span and generate a presentation in the form of a graph, table, or chart.
Introducing Reporting
1-7
1-8
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Understanding Reporting Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Using the Web Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2-1
Overview
Service Reporting lets you create, schedule, view, and print reports, as well as manage report users and report storage. BMC Software provides several tools to accomplish many of these reporting tasks depending on your requirements. Will you create reports? Are you interested in viewing and printing reports? Will you manage report storage?
Table 2-1 Overview of Reporting Tasks and Tools
Task
creating a report template modifying a report template scheduling a report to run now
Tools to Use
QuickReport Editor QuickReport Editor QuickReport Editor Web Desktop Actuate End User Desktop Actuate Administrator Desktop QuickReport Editor Web Desktop Actuate End User Desktop Actuate Administrator Desktop Web Desktop Report Viewer Actuate End User Desktop Actuate Administrator Desktop Web Desktop Report Viewer Actuate End User Desktop Actuate Administrator Desktop Actuate Administrator Desktop
viewing a report
printing a report
QuickReport Editor Actuate Report Viewer (view and print only) Actuate End User Desktop Actuate Administrator Desktop
Web Desktop
You use the Web Desktop to view the contents of the Report Encyclopedia generate and schedule reports locate and view reports print and distribute reports Access the QuickReport Editor
You access the Web Desktop from a Web browser on a supported system. For information on how to access the Web Desktop and navigate through the Report Encyclopedia, see Using the Web Desktop on page 2-5.
QuickReport Editor
You use the QuickReport Editor to create reports by dening new report templates based on specic PATROL parameters and events copy and modify report templates delete report templates
2-3
Report Viewer
You can use the Report Viewer to view and print reports on Windows machines. For information on how to use the Report Viewer application, refer to Viewing e.Reports or the Report Viewer online help.
Actuate End User Desktop
You can use the Actuate End User Desktop to do the following on Windows machines: request immediate report generation view reports print reports
For information on how to use the Actuate End User Desktop application, refer to Viewing e.Reports, Using e.Reports, or the Actuate End User Desktop online help.
Actuate Administrator Desktop
You can use the Actuate Administrator Desktop to do the following on Windows machines: schedule report generation view reports locally print reports locally
For information on how to use the Actuate Administrator Desktop application, refer to Viewing e.Reports, Using e.Reports, or the Actuate Administrator Desktop online help.
2-4
The QuickReport Editor, a Java-based application where you can dene and adjust reports, requires Microsoft Internet Explorer, version 5.0 or later, with the Java Virtual Machine installed or Netscape Navigator with the Java plug-in.
2-5
Step 1
<Web server> is the name of the Web server that is running the Web interface to the Report Encyclopedia acweb is a keyword that is associated with the Report Encyclopedia <report server> is the name of the volume of the Report Server where the Encyclopedia that you want to access is located For example, to access reports from volume jsmith on Web server jsmith, you enter the following URL in your Web browser:
http://jsmith/acweb/jsmith
Step 2
Enter the user name and password provided by your administrator. The Web Desktop appears.
BMC Software, Inc., Condential and Proprietary Information
2-6
You must have Actuate administrator privileges to access the administrative directory. Contact your administrator for more information.
Figure 2-2 Report Encyclopedia Web Page
Current folder Tab pages
The Report Encyclopedia Web page lets you: view the contents of the Report Encyclopedia access the Report Encyclopedia hierarchy get detailed information about reports sort the folders by name, type, or date and time created check on active and scheduled requests access your completed reports folder using My Headlines request to generate a report using the QuickReport Editor
2-7
The Report Encyclopedias tab pages let you access additional functionality.
Table 2-2 Report Encyclopedia Tab Pages
Description
Documents
My Headlines
Requests
Administration My Prole
The Report Encyclopedias work area, located by clicking the Documents tab, lists the available reports and folders you can explore. When you select a report, each report contains the date of the report, the time it was created, and a Details icon containing additional information about each le.
Note
You can click the Details icon to get general status and privileges information for the folder or le.
2-8
Table 2-3 describes the components of the Report Encyclopedia Web page.
Table 2-3 Report Encyclopedia Components
Component
Name Version Date Details
Description
The Name column contains the list of available reports. The Version shows the version of the report that is available. The Date column contains the date that the administrator or user created the folder or le. The Details column contains status and other information for the associated folder or le, including the name of the log le.
Additional links: QuickReport EditorUse to create custom reports HelpClick to view the Reporting Online Help and the Actuate ReportCast Online Documentation My DocumentsClick to view the ReportCast Channels Personal Channel Page
If your administrator set up an anonymous user, you can access the Report Encyclopedia without logging in. To view reports, however, you need to log in using the name and password provided to you by your administrator.
2-9
You can navigate the Report Encyclopedia just like any other Web site. Just enter a URL, click the available hyperlinks, or use the Tab pages to see the information youre looking for. After clicking the BMCReports link, some of the report types you may be able to view include: Daily Reports Weekly Reports Monthly Reports Yearly Reports ROX & ROV Objects/OnDemand Reports NT Unix Exchange Oracle Cleanup
Table 2-4
Hyperlinks (Folder)
BMCReports Exchange Windows NT Oracle Unix
Links to
QuickReports, ROV les, and ROX les Solution Reports for Microsoft Exchange Server, ROV les, and ROX les Solution Reports for Microsoft Windows 2000 Server, ROV les, and ROX les Solution Reports for Oracle, ROV les, and ROX les Solution Reports for Unix, ROV les, and ROX les
Navigating in the Report Encyclopedia on page 2-11 provides an example of using hyperlinks to navigate from a top-level folder to a subfolder that contains a Report Document that you can view.
2-10
This task describes how to navigate in the Report Encyclopedia. Log in to the Report Encyclopedia (refer to Using the Report Encyclopedia on page 2-6). The Report Encyclopedia main page displays to show the top-level folders. On the Report Encyclopedia main page, click a folders link (BMCReports) to display its available reports. The available report types appear on the left side of your browser. In the subfolder, click a link to display its contents.
Note
Step 2
Step 3
You can click Back in the browsers main toolbar to return to the Report Encyclopedias main page. Alternatively, you can click the link to the folder or subfolder located above the list of contents.
Step 4
In the Report Encyclopedia, you can continue to click hyperlinks to explore the folders and les of the Report Encyclopedia.
BMC Software provides a top-level folder, BMCReports, for access to both the QuickReports you create with the QuickReport Editor and the technology and application Solution Reports packages that came with Service Reporting. Click a link to navigate the folders and subfolders to locate a document that you can view.
2-11
2-12
This chapter describes the QuickReports and Solution Reports, proposes reporting checklists, and provides some examples that might help you plan a reporting strategy to manage resources in your distributed environment. You need to determine what reports you need and who needs to access these reports. Introducing Report Types and Templates . . . . . . . . . . . . . . . . . . . . . . 3-2 Planning QuickReports Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 Using Solution-Specic Reporting. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Planning Strategies for Mixing Reporting Types . . . . . . . . . . . . . . . . 3-17
3-1
Report Types
Data Collection Table Hot Spots Table
Description
Lists all of the components, measurements, and event types collected in the DataStore database. Provides the measurement value of a particular enterprise component for a specied time span of the report and lists the top n or bottom n readings for a measurement or parameter. Given a PATROL parameter, list n component values where the user-specied threshold was crossed. The time span is specied by the user. Displays a customer-dened number of components and their associated events. Displays n number of components with the highest or lowest values of a parameter in bar graph format. Displays n number of components and their associated parameter values, in table format. Displays a measurement value of a set of components representing a specic time period. The time span is specied by the user.
Hot Spots Threshold Table Event Summary Table Summary Graph Summary Table Trend Graph
3-2
Table 3-1
Report Types
Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter)
Description
Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user. Displays the measurement value of a set of components representing a specic time period, in table format. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.
3-3
3-4
The system manager also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-1 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Microsoft Exchange Server Message Size report.
3-5
Figure 3-1
Figure 3-2 is an example of a Summary Graph Data Display page that the planner used to create the new report template for the Microsoft Exchange Server Message Size report.
3-6
Figure 3-2
The system manager requested and receives notication that the report is nished. The system manager views and prints the report after accessing the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.
3-7
the report typeSummary Graph the node[All] (to select all nodes) the applicationNT_CPU the instance[All] (to select all instances) the parameterCPUprcrProcessorTimePercent the valueTop the number of values5 the summarization typeAverage the summarization periodWeekly the unit of measurepercentage, count, average scheduleSundays at 13:30:00
The system manager also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-3 a sample of the Data Selection page the planner used to create the new report template for the Windows NT CPU Utilization report.
3-8
Figure 3-3
Figure 3-4 is an example of a Summary Graph Report Parameters page that the planner used to create the new report template for the Windows NT Server Percent CPU Utilization report.
3-9
Figure 3-4
The system manager requested and receives notication that the report is nished. The system manager views and prints the report after accessing the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.
3-10
the report typeHot Spots Table the applicationNT_CPU the parameterCPUprcrProcessorTimePercent the valueTop the number of values10 the summarization typeAverage the summarization periodWeekly the sub-span summarization periodDaily the unit of measurepercentage, count, average schedule typePeriodic schedule settingsSundays at 06:00
Also enter labels that the report displays in the title, the subtitle, and unit label for the y-axis (which shows the unit of measure). Figure 3-5 is a sample of the Data Selection Criteria page used to create the new report template for the Windows NT CPU Hot Spots report.
3-11
Figure 3-5
Figure 3-6 is an example of a Hot Spots Table Report Parameters page used to create the new report template for the Windows NT CPU Hot Spots report.
3-12
Figure 3-6
3-13
The administrator also species a le name and a location to save the report to on the Template Folder and Filename page. Figure 3-7 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Data Collection Table report.
Figure 3-7 Windows NT Data Collection Data Selection Criteria Page
Figure 3-8 is an example of a Data Collection Table Schedule page that the planner used to create the new report template for the Windows NT Data Collection Table report.
3-14
Figure 3-8
The administrator requested and receives notication that the report is nished. The system manager views the report from the Report Encyclopedia using a Web browser and the Web Desktop. For more information on notication of report generation, refer to the Actuate documentation or online help for the Administrator Desktop.
3-15
3-16
3-17
you already created a similar QuickReport type report and a simple edit would provide the report you require
The manager asks a junior capacity planner to provide information to help make budget-planning decisions for the coming year. To provide the manager with the information, the junior capacity planner decides to: create a Data Collection Table report with the QuickReport Editor to understand what application and parameter data exists in the DataStore check CPU usage and server memory availability measurements for Windows NT and Unix operating systems, as well as for the Microsoft Exchange and Oracle applications check for hot spots or peak use periods for Windows NT and Unix servers
The organization uses the Service Reporting product for predened Solution Reports for Windows 2000 and Unix servers and the QuickReport Editor to customize report templates to meet their requirements. The enterprise also collects PATROL data for Microsoft Exchange Server and Oracle. The junior planner needs to use a combination of customized reports and Solution Reports to provide the information the manager requires.
BMC Software, Inc., Condential and Proprietary Information
3-18
The junior planner created a table like Table 3-2 to list the information needed, the report type, and the PATROL application classes and parameters that need to be analyzed.
Table 3-2 Reporting Requirements for the Enterprise
Requirement
Determine what application and parameters are collected for the devices in the organization Find Windows NT CPU utilization hot spots (readings) daily for a week Find the Unix CPU utilization hot spots (readings) daily for a week Find the Oracle servers with the least capacity Find the Oracle servers with the least available space Find the Microsoft Exchange servers with the highest memory usage Find the Microsoft Exchange servers with the greatest number of messages Find the busiest Windows NT servers Find the Windows NT servers with the least available virtual memory Find the Unix servers with highest CPU usage Find the Unix server with the least available space
Reporting Type
customized Data Collection Table report
PATROL Application/Parameter
All
customized Top N Hot Spots (Readings) Table report customized Top N Hot Spots (Readings) Table report predened Solution Report customized Bottom N Summary Graph report customized Top N Summary Graph report customized Top N S Summary Graph report predened Solution Report predened Solution Report
NT_CPU/ CPUcrprProcessorTimePercent CPU/ CPUUtil ORACLE_CAPACITY/ CusorsLeft ORACLE_AVAILABILITY/ FreeSpace MSEXCH_Server/ ServerMemory MSEXCH_Server/ ServerMsgSize NT_CPU/ CPUcrprProcessorTimePercent NT_MEMORY/ MEMmemAvailableBytes CPU/ CPUCpuUtil FILESYSTEM/ FSAvailableSpace
3-19
The junior planner uses the QuickReport Editor to determine what information is available in the DataStore for reporting CPU. The planner uses a Data Collection Table report template and selects: report typeData Collection Table node[All] (to select all nodes) applicationCPU schedule Once, December 5, 1999 at 07:00
The junior planner wants to create reports that show the 10 peak CPU utilization times for the Window NT and Unix servers in the domain for a period of a week. The planner uses the QuickReport Editor and creates new report templates with the Top N Hot Spots (Readings) Table template. For the Windows NT Hot Spots report, the junior planner selects the following to create a new report template: the report typeTop N Hot Spots (Readings) Table the applicationNT_CPU the parameterCPUprcrProcessorTimePercent the number of values10 the summarization valueAverage the summarization periodWeekly the sub-span periodDaily schedule typePeriodic schedule settingsSundays at 06:00
For the Unix Servers Hot Spots report, the junior planner selects the following to create another new report template: the report typeTop N Hot Spots (Readings) Table the applicationCPU the parameterCPUUtil the number of values10 the summarization valueAverage the summarization periodWeekly
BMC Software, Inc., Condential and Proprietary Information
3-20
Figure 3-9 is a sample of the Data Selection Criteria page the planner used to create the new report template for the Unix CPU Hot Spots report.
Figure 3-9 Sample Unix Hot Spots Data Selection Criteria Page
Figure 3-10 is an example of a Top N Summary Graph Report Parameters page that the planner used to create the new report template for the Unix CPU Hot Spots report.
3-21
For an example of a Windows NT Hot Spots Report Parameters page, see Figure 3-6 on page 3-13.
Gathering Information on Oracle Servers Using the QuickReport Editor
The junior planner uses the QuickReport Editor to create the Oracle server reports. Servers with the least available capacity Servers with the least available space
The planner uses a Bottom N Summary Graph report for both reports. In the QuickReport Editor, the planner species the following report parameters for a report that shows the Oracle servers with the least available capacity:
3-22
the report typeBottom N Summary Graph the node[All] (to select all nodes) the applicationORACLE_CAPACITY
BMC Software, Inc., Condential and Proprietary Information
the instance[All] (to select all instances) the parameterCursorsLeft the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00
The planner also enters report labelsOracle Servers and Capacity, a units labelCursors, and a le name and location into which to copy the report after the report is generated. Other parameters to look at to get a picture of the Oracle server capacity include: Locks Free (LocksFree), Processes Left (ProcsLeft), Sessions Left (SessionsLeft), and Transactions Left (TransLeft). Figure 3-11 is a sample of the Data Selection Criteria page, the planner used to create the new template for this report.
3-23
For the second report, the planner uses the QuickReport Editor, then species the following report parameters for a report that highlights the Oracle servers with the least available free space: the report typeBottom N Summary Graph the node[All] (to select all nodes) the applicationORACLE_AVAILABILITY the instance[All] (to select all instances) the parameterFreeSpace the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00
The planner also enters report labelsOracle Servers and Least Available Space, a units label%, and a le name and location into which to copy the report after the report is generated.
3-24
Figure 3-12 is a sample of the Data Selection page the planner used to create the new template for the Oracle Least Available Space report.
Figure 3-12 Oracle Availability Data Selection Criteria Page
The junior planner uses the QuickReport Editor to create the Microsoft Exchange server reports. Servers with the highest memory usage Servers with the greatest number of messages
The planner uses a Top N Summary Graph report for both reports. In the QuickReport Editor, the planner species the following report parameters for a report that shows the Microsoft Exchange servers with the highest memory usage: the report typeTop N Summary Graph the node[All] (to select all nodes) the applicationMSEXCH_Server
3-25
the instance[All] (to select all instances) the parameterServerMemory the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00
The planner also enters report labelsMS Exchange Server and Memory Usage, a units labelMegabytes, and a le name and location into which to copy the report after the report is generated. Figure 3-13 is a sample of the Data Selection Criteria page the planner used to create the new template for this report.
Figure 3-13 Microsoft Exchange Memory Data Selection Criteria Page
For the second report, the planner uses the QuickReport Editor, then species the following report parameters for a report that highlights the Microsoft Exchange servers with the greatest number of messages: the report typeTop N Summary Graph
BMC Software, Inc., Condential and Proprietary Information
3-26
the node[All] (to select all nodes) the applicationMSEXCH_Server the instance[All] (to select all instances) the parameterServerMsgSize the number of values5 the summarization typeAverage the time spanWeekly scheduleRecurring on Mondays at 13:30:00
The planner also enters report labelsMicrosoft Exchange Servers and Server Messages, a units labelCount, and a le name and location into which to copy the report after the report is generated.
Figure 3-14 Microsoft Exchange Messages Data Selection Criteria Page
The junior planner looks in the Report Encyclopedia for the weekly solution reports for the Windows 2000 servers for reports on the busiest servers
3-27
The junior planner looks in the Report Encyclopedia for the weekly solution reports for the Unix servers. Servers with the highest CPU usage Servers with least available space
The planner produces a sample report that shows the weekly summary of the ve Unix servers with the highest CPU load as measured by the CPULoad parameter. The report is based on a Top N Summary Graph provided as part of the Solution Reports for Unix servers.
3-28
4-1
Creating Reports
You use the QuickReport Editor to create new report templates based on QuickReport types. With the QuickReport Editor, you can also edit existing report templates to create new report templates. You cannot design new report types or templates with the QuickReport Editor.
Additional parameters and selection criteria you can choose include: all or selected nodes parameters all or selected instances applications level of summarization (daily, weekly, monthly, yearly) time frame (current day, month of December, and so on) input to the report title, subtitle, and axis labels
Before you create and save the report template, you choose whether to generate the report immediately, to save the report to generate later, or schedule the report to generate on a periodic basis.
4-2
Step 1
Step 2
Step 3
Step 4
4-3
Figure 4-1
Step 5
Click Create a new report template to create a new report. The Template Type Selection page displays.
4-4
Note
Clicking Previous on the QuickReport Editor page moves back to the previous page in the QuickReport Editor. Clicking Cancel on any QuickReport Editor page cancels your report selections and returns to the rst page of the QuickReport Editor. Clicking on the main Web browser window returns the Report Encyclopedia to the front.
Figure 4-2 QuickReport Editor Template Style Selection Page
Step 6
On the Template Type Selection page, select the type of report template that you want to create: Data Collection Table Event Summary Table Hot Spots Table Hot Spots Threshold Table Summary Graph
Creating, Scheduling, Viewing, and Printing Reports 4-5
Summary Table Trend Graph Trend Graph (Multi-Parameter) Trend Table Trend Table (Multi-Parameter) Then, click Next. The Data Selection Criteria page displays.
Figure 4-3
Step 7
On the Data Selection Criteria page, you construct your data parameters. The values you need to select for this page depend on the report type you selected on the previous page.
4-6
7.A
Select values for the Node, Application, Instance, and Parameter from the available choices in their respective drop-down list boxes. To include all Nodes and Instances, select [All] from their respective drop-down list boxes.
Note
Choices available on the Data Selection Criteria page depend on the report type you selected on the Template Type Selection page. For example, if you selected to create a Data Collection Table, only Node and Application Data elements display.
7.B
Change the labels for the Application and Parameter, as appropriate. The QuickReport Editor inserts your inputs into the titles for the new report. Then, click Next. The Display Choices page appears.
7.C
4-7
Figure 4-4
Step 8
On the Data Display page, select the parameters you want your report to display.
Note
Choices available on the Data Display page depend on the report type you selected on the Template Type Selection page. For example, if you selected to create a Data Collection Table, a Report Parameter page does not display. If you selected to create a Hot Spot Table or Trend Graph, you need to enter additional parameters, for example, a sub-span period or a threshold value.
8.A
Input or select the top order values or the bottom order values that you want your report to display. The default number is ve. Select the summarization type parameter: Average, Maximum, Minimum, Sample_Count, Standard_Deviation, Variance, or Sum.
BMC Software, Inc., Condential and Proprietary Information
8.B
4-8
8.C
Select Daily, Weekly, Monthly or Yearly for the period to summarize. Then, click Next. The Template Folder and Filename page displays.
8.D
Figure 4-5
Step 9
On the Template Folder and Filename page, enter the report le name and folder for the report in the input box. Click Browse if you need to nd or add a folder. Then, click Next. The Schedule page displays. To add a folder, click the Create New Folder button, type the folder name, press the Enter key, and click OK.
4-9
Figure 4-6
Step 10
Select the check box for the schedule you want to use to generate the report: Periodic, Now, Once, or None (postpone scheduling). If you choose Periodic or Once, select the appropriate times from the drop-down boxes in the Settings area. If you choose None, the QuickReport Editor creates a Report Template (Parameter Values le) from which you can generate a report at a later time.
10.B
10.C
4-10
Figure 4-7
Step 11
On the Template Creation Summary page, click Cancel to return to the Welcome page or Previous to go back to previous pages and change any information. If you are satised with the report, click Finish to complete the report. The Successfully Completed page displays.
4-11
Figure 4-8
4-12
Step 1
Step 5
The name of the report le displays in the Report Template input box.
4-13
Step 6
After you make your edit selection, click Next. The Edit Data Selection page displays.
Figure 4-11 QuickReport Editor Edit Data Selection Criteria Page
Step 7
On the Data Selection Criteria page, create the parameters for your new report.
4-14
7.A
Change the values for Node, Application, Instance, and Parameter, as required for your new report. Again, the values displayed on the Data Selection page depend on the generic report type of the report you chose to edit.
7.B
Change the values for the Application and Parameter, as appropriate. Click the tab of the next QuickReport Editor page where you need to make changes: Data Display, Template Name (required, unless you want to overwrite the existing report), or Schedule. These are the same set of pages that you use when you create a new report.
7.C
7.D
After you change report parameters, summarizations, scheduling, name and location to satisfy your new report requirements, click Finish on the Schedule page. The Successfully Completed page displays.
Note
You can click Cancel to quit without saving or generating a report or Previous to go back to previous pages and change any information for the report.
4-15
4-16
Step 1
Step 2 Step 3
Step 4
Select the Delete a report template link. The Report Deletion dialog box displays.
4-17
Step 5
On the Report Deletion dialog, select a report le, and then click Delete. A conrmation message appears. Click OK to delete the report. Repeat to delete additional reports.
4-18
For information specic to QuickReports, refer to Scheduling QuickReports on page 4-19 specic to Solution Reports, refer to Generating Solution Reports on page 4-23
Scheduling QuickReports
To schedule and generate reports, BMC Software recommends that you use the editing function of the QuickReport Editor.
4-19
Step 1
Step 2
Click the My Headlines tab. The QuickReport Editor link appears. Click the QuickReport Editor link. The QuickReport Editor launches. Click Modify an existing report templates properties to edit an existing report template. Click Browse and select the report template you want to modify. The name of the report le displays in the Report Template input box.
BMC Software, Inc., Condential and Proprietary Information
Step 6
4-20
Step 7
After you make your selection, click Next. The Data Selection Criteria page displays.
Figure 4-16 QuickReport Editor Data Selection Page
Step 8
To schedule the report template to generate the selected report, click the Schedule tab. On the Schedule tab, set up the schedule to generate the report.
Step 9
4-21
9.A
Select the check box for the schedule you want to use to generate the report: Periodic, Now, Once or None. If you choose Periodic or Once, select the appropriate times from the drop-down boxes in the Settings area. Then, select Finish. The Successfully Completed page displays.
9.B
9.C
4-22
Check with your Report Server administrator to see if you can access parameter value les and report executables on the Web. You can also schedule and generate reports from the Report Encyclopedia using the Administrator Desktop or the End User Desktop. The interfaces you use and the tasks you perform to schedule and generate a report using these desktop application are different from those of the Web Desktop. For information on scheduling reports and generating reports using the Administrator Desktop or the End User Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help.
4-23
Step 1
Step 2
Step 3
Step 4
Step 5
4-24
Step 6
In the Schedule section, select the time you want the report to generate: Right Now, Once, or Recurring. The default is to generate right now. Enter dates and times as required by your schedule selection. Then, scroll to the Priority section of the Request Report page.
Figure 4-20 Request Report Priority Options
Step 7
In the Priority section, set the priority at which to generate the report: High (800), Medium (500), Low (200), or Other (1-1000). This is the priority the server assigns to generating the report, Medium (500) is the default. Scroll to the Version section of the Request Report page.
Figure 4-21 Request Report Version Options
Step 8
In the Version section, select the version information for the report.
4-25
8.A
Select the Create new version or the Overwrite existing version option button. The default is to create a new version. Enter a name for the version in the Version Name input box, if you are maintaining versions. A version number is used by default, for example, Version 1 or Version 2. Enter a full path name in the Output Name input box.
8.B
8.C Step 9
Scroll down to the Archive Policy section and create archive information for this report. You can set the Archive Policy to: use the default archive policy - Use the archive policy for the distribution folder(s) never delete the report - Do not automatically delete items delete a report after a set time period - Delete objects older than: set a specic date to delete - Delete objects on:
4-26
Step 10
After entering all of your information, click Submit Request on the left side of the browser. On the Conrmation page, click Request Status to check on the status of your request. To cancel the request, click Cancel Request. You can also check on the status of your report by clicking the Active Request folder in the Report Encyclopedia left panel.
Step 11
4-27
Check with your Report Server administrator to see if you can access reports on the Web. You can also locate and view reports from the Report Encyclopedia using the Report Viewer, the End User Desktop, or the Administrator Desktop. For information on locating reports and viewing reports using the Report Viewer, the End User Desktop or the Administrator Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help. The following sections describe how to locate and view generic reports that you create using the QuickReport Editor and predened Solution Reports provided by Service Reporting.
Note
When viewing a report using the Web Desktop, the Search function is not available.
4-28
4-29
Step 1
Step 2
Step 3
Step 4 Step 5
4-30
Step 1
Step 2
Step 3 Step 4
Click the Report Document that you want to view. For example, click MEMmemAvailableBytes19991001. The report displays. Click Back in the Web browsers toolbar to return to the Report Encyclopedia and to locate other Solution Reports that you want to view.
Step 6
4-31
You can also request the printing of a report when you create a request to generate a report in the Report Encyclopedia from the End User Desktop, or the Administrator Desktop, using the applicationss Requester dialog box. For more information on printing and distributing reports using the End User Desktop or the Administrator Desktop, see Viewing e.Reports, Using e.Reports, or the respective applications online help.
Printing a Report
To print and distribute reports from the Report Encyclopedia, BMC Software recommends that you use the Web Desktop.
4-32
Note
Because printing using the following method may clip portions of your report, BMC Software recommends that you save the report as a .PDF le and then print from the .PDF viewer. To do this, click the Print/Download link on the Web Desktop and follow the screens to save the report. See your Adobe Acrobat documentation for information on printing a .PDF le.
Step 1
Open your Web browser, enter the URL for the Report Server for your Report Encyclopedia, and log in using the user name and password assigned to you. For more information on accessing the Report Encyclopedia from a browser, see Using the Report Encyclopedia on page 2-6.
Step 2
Locate and open the report that you want to print. See Locating and Viewing Reports on page 4-28.
4-33
Step 3
With the report in the browser window, choose File => Print. The Print dialog box displays.
4-34
Step 4
Click Properties to change printer properties, as required. The Document Properties dialog box displays.
4-35
Step 5
To avoid possible clipping of your reports, you should reduce the size of your report or change printer properties as required. For example, you might try to change the report size from 100% to 75% and the print orientation to Landscape. If you are printing the report on a color printer, you might want to check color options. After selecting printer properties, click OK. When the Print dialog box displays again, click OK to print the report.
Note
Step 6
You can also save a report as a .PDF le and print from the .PDF viewer. Click the Print/Download link on the Web Desktop and follow the screens to save the report. See your Adobe Acrobat documentation for information on printing a .PDF le.
4-36
This chapter describes the QuickReport types included with the Service Reporting product for use with the QuickReport Editor, and explains how to use QuickReports to manage resources in your enterprise. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Interpreting QuickReports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Summarizing Enterprise Events and Measurements . . . . . . . . . . . . . 5-7 Taking a Closer Look at Enterprise Measurements . . . . . . . . . . . . . . 5-10 Locating Enterprise Hot Spots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Checking Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
5-1
Overview
Service Reporting provides QuickReport templates for use with the QuickReport Editor to allow users to dene the report templates that they require to manage the resources in their enterprise. You can easily transform QuickReport types into the report templates you need by specifying or lling in options in a series of Web pages. You start by selecting a report type with the QuickReport Editor, then choose additional parameters based on the report type.
Report Types
Data Collection Table Hot Spots Table
Description
Lists all of the components, measurements, and event types collected in the DataStore database. Provides the measurement value of a particular enterprise component for a specied time span of the report and lists the top n or bottom n readings for a measurement or parameter. Given a PATROL parameter, list n component values where the user-specied threshold was crossed. The time span is specied by the user. Displays a customer-dened number of components and their associated events. Displays n number of components with the highest or lowest values of a parameter in bar graph format. Displays n number of components and their associated parameter values, in table format. Displays a measurement value of a set of components representing a specic time period. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.
Hot Spots Threshold Table Event Summary Table Summary Graph Summary Table Trend Graph Trend Graph (Multi-Parameter)
5-2
Table 5-1
Report Types
Trend Table Trend Table (Multi-Parameter)
Description
Displays the measurement value of a set of components representing a specic time period, in table format. The time span is specied by the user. Displays multiple measurements for multiple components representing a specic time period. The time span is specied by the user.
Interpreting QuickReports
You create report templates using the QuickReport Editor. This section looks at selected reports you can create by customizing QuickReport types: Summary Graph Hot Spots Data Collection
5-3
Table 5-2
Item
title
Example
Bottom 5 Available Virtual Memory
Origin
selection typeTop or Bottom selection limitN selected on the Parameters page (optimum number is ve) labelmeaning of the graph entered in input box on Data selection page (Available Virtual Memory) date for which the measurements were collected span of the graphselected on the Parameters page (Daily) summary typeselected on the Parameters page (Average) selection typeTop or Bottom (as in title) selection limitN selected on the Parameters page labelcomponent label entered in input box on Data Selection page (NT Workstation) labelmeaning of the graph entered in input box on Data Selection page (Available Virtual Memory) selection typeTop or Bottom selection limitN selected on the Parameters page labelcomponent label entered in input box on Data Selection page (NT Workstation) the parameter nameselected on the Data Selection page the value typeunit label selected on the Parameters page (MB)
for Fri 1999-Aug-20 Daily Average of Bottom 5 NT Workstation by Available Virtual Memory
X-axis
Bottom 5 NT workstation
Y-axis
5-4
Item
title
Example
Bottom 10 NT CPU Utilization Readings
Origin
selection typeTop or Bottom selection limitN selected on the Parameters page labelmeaning of the graph entered in input box on the Data Selection page (NT CPU Utilization) Readingsset by report type date for which the measurements were collected span of the graphselected on the Parameters page (Daily) summary typeselected on the Parameters page (Average) Readings ofset by report type selection typeTop or Bottom (as in title) selection limitN selected on the Parameters page labelmeaning of the graph entered in input box on the Data Selection page (NT CPU Utilization) node and instance where a top reading was observedfrom DataStore subspan interval when reading was observedfrom DataStore value of the readingfrom DataStore (percent CPU utilization)
5-5
Item
title subtitles
Example
PATROL 3 Data Collection Table Collection on or After Wed 1999-Aug-01
Origin
PATROL 3 Data Collection Tableset by report type Collection on or Afterset by report type date for which the measurements were collected NT indicates that NT application classes were selected on the Data Selection page for Application % wildcard that indicates [all] was selected on the Data Selection page for Node application classset by Application selection node where measurement was collected set by Node selection parameters measuredset by Application selection instanceset by node selection last date the measurement was collectedfrom the DataStore
Report Patterns
AppClass Pattern NT
Node Pattern%
5-6
With the summary reports, you can determine the highest or lowest server measurements for Windows NT enterprise-wide parameters, such as the following: memory availability CPU utilization logical and physical disk usage cache usage
For a list of Windows NT parameters available for reporting, see the Data Selection page of the QuickReport Editor. You can customize the summary report templates to investigate Unix server parameters, such as available space NFS read and write calls CPU utilization or load memory availability busiest disks disk reads and writes incoming network packets user or session counts
For a list of Unix parameters available for reporting, see the Data Selection page of the QuickReport Editor. If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the summary reports to investigate parameters of these applications.
BMC Software, Inc., Condential and Proprietary Information
5-7
Looking at the top ve servers based on the highest or lowest measurements for several parameters can provide information to help: plan for redistribution of your enterprise resources determine the need for upgrades and replacements aid in troubleshooting device problems
You can create the rst report based on a summary template, then edit the report as many times as you need to create other similar reports.
Note
You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection page for the selected report type displays. On this page, you nd listed all nodes, applications, instances, and parameters available for a report in their respective drop-down list boxes. Figure 5-1 shows a sample list of application classes available for Top N Summary Graph reports for Windows NT servers. These same application classes are available if you wanted to create a Bottom N Summary Graph, a Top N Summary Table, or a Bottom N Summary Table report.
5-8
Figure 5-1
After selecting an Application on the Data Selection Criteria - Summary Graph page, for example, NT_CACHE, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-2 shows a sample NT_Memory application class and the associated parameters available for a report.
5-9
Figure 5-2
5-10
With a trend graph report, you can view the highest or lowest hourly, daily, or weekly server measurements for Windows NT parameters, such as: memory availability CPU utilization logical and physical disk usage cache usage network usage services availability
For a list of Windows NT parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor. You can customize the trend report templates to investigate Unix server parameters, such as: available space NFS read and write calls CPU utilization or load memory availability busiest disks disk reads and writes incoming network packets user or session counts
For a list of Unix parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor. If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the trend graph reports to investigate parameters of these applications.
5-11
You can create the rst report based on the Top N Trend Graph template, then edit the report as many times as you need to create other similar reports.
Note
You need to change the le name of each new report template you create to save as a new template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection Criteria page for the selected report type displays. On this page, you nd listed all nodes, applications, instances, and parameters available for a report in their respective drop-down list boxes. Figure 5-3 shows a sample list of application classes available for Trend Graph reports for Windows NT servers.
5-12
Figure 5-3
After selecting an Application on the Data Selection Criteria - Top N Trend Graph page, for example, NT_SYSTEM, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-4 shows a sample NT_SYSTEM application class and the associated parameters available for a report.
5-13
Figure 5-4
5-14
The hot spot reports show the highest or lowest readings for a subspan for the selected parameter regardless of which server or when the reading occurs. The threshold hot spot report lists only those component-interval pairs that cross the specied threshold. For the selected parameter you can create: a daily report listing hourly hot spots a weekly report listing daily hot spots a monthly report listing daily hot spots
Parameters available for hot spot reporting for Windows NT servers include: memory availability, cache faults, or page faults CPU utilization logical disk space physical queue length cache hits or read rate system availability service availability
For a list of Windows NT parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor Parameters available for hot spot reporting for Unix servers include: space availability percentage of NFS read and write calls CPU utilization CPU load memory availability
5-15
busiest disks disk reads and writes incoming network packets user or session counts
For a list of Unix parameters available for reporting, see the Data Selection Criteria page of the QuickReport Editor If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the hot spot reports to investigate parameters of these applications. You can use the Hot Spot Reports as a troubleshooting tool to locate problems before they cause server downtime. You can create the rst report based on the Hot Spots (Readings) Table template or the Hot spots (Readings) Threshold Table template, then edit the report as many times as you need to create other similar reports.
Note
You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection Criteria page displays. On this page, you nd listed the applications and parameters available for these reports in their respective drop-down list boxes. Figure 5-5 shows a sample list of application classes available for Hot Spots (Readings) Table reports for Windows NT servers. The same application classes are available for a Bottom N Hot Spots Table report and Top and Bottom N Hot Spots Threshold Table reports.
5-16
Figure 5-5
After selecting an Application on the Data Selection Criteria - Hot Spots Table page, for example, NT_CPU, click the Parameter drop-down list box to display the parameters for the selected Application. Figure 5-6 shows the NT_CPU application class and the parameters available for a Top N Hot Spots (Readings) Table report. The same parameters are available for a Bottom N Hot Spots Table report and Top and Bottom N Hot Spots Threshold Table reports.
5-17
Figure 5-6
5-18
Using a Data Collection Table report, you can check if the parameters for the following Unix application classes and nodes are collected and stored in the DataStore on or after a given date: CPU DISK FILESYSTEM MEMORY NETWORK NFS SWAP USERS
5-19
If data for Microsoft Exchange and Oracle is collected and stored in the DataStore, you can use the Data Collection Table report to investigate parameters of these applications. Use the Data Collection Table report to verify that data exists for the nodes, applications, parameters, and instances in your enterprise. That is, that the expected data is discovered, collected, and available. You can create the rst report based on the Data Collection Table template, then edit the report as many times as you need to create other similar reports.
Note
You need to change the le name of each new report template you create, if you want to keep the template. Editing a report template without changing its le name, overwrites the report template. After you select the report type and click Next in the QuickReport Editor, the Data Selection - Data Collection Table page displays. On this page, you nd the nodes and applications available for a report listed in their respective drop-down list boxes. Selecting a node or nodes determines the instances for the report. Selecting the application or applications determines the parameters for the report. Figure 5-7 shows a sample list of nodes available for Data Collection Table reports. The default selection is all [All] nodes.
5-20
Figure 5-7
Figure 5-8 shows a sample list of application classes available for Data Collection Table reports for Windows NT servers.
5-21
Figure 5-8
5-22
This chapter describes the Solution Reports for Microsoft Windows 2000 Server. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2 Dening Windows Server Status Reports . . . . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Parameter Reports . . . . . . . . . . . . . . . . . . 6-3 Dening Windows Server Service Availability Reports. . . . . . . . . . . 6-7 Interpreting Windows Server Solution Reports . . . . . . . . . . . . . . . . . 6-9
6-1
Overview
Solution Reports for Microsoft Windows 2000 Server provide a pre-dened set of reports for the management of your Windows 2000 Servers and Windows NT Servers. These reports provide the ability to analyze availability data across multiple Windows 2000 Server and Windows NT Server hosts in a distributed enterprise. You can highlight the enterprise-wide availability of a particular Windows service, or of the Windows host, or of selected server parameters that affect enterprise network availability and performance. Reports are based on Windows management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Windows PATROL Agents in your enterprise.
6-2
Report Title
5 Least Stable NT Servers
This report shows the top N busiest servers based on the highest total percentage of processor time used. Use this report to determine which servers are the busiest and could benet from the redistribution of system processes or the addition of central processing units.
This report shows the top N servers based on the largest processor queue length. Use this report to locate those servers with the longest processor queues.
6-3
Report Title
5 Worst NT Cache Copy Read Requests
Report Title
5 Busiest NT Server CPUs (user time)
This report shows top N busiest servers based on the highest percent of process processor time. Use this report to locate the servers with the highest use of process processor time.
6-4
Report Title
5 Highest NT Servers in Logical Disk Queue Lengths
This report shows the top N servers based on the highest percent of disk time use. Use this report to locate servers with the highest logical disk use.
6-5
Report Title
5 Lowest NT Servers in Available Virtual Memory
This report shows the top N servers based on the highest measurement of memory cache faults per second. Use this report to nd and troubleshoot those servers with the highest number of memory cache faults per second.
This report shows the top N servers based on the highest measurement of memory page faults per second. Use this report to nd and troubleshoot those severs with the highest number of page faults per second.
This report shows the top N servers based on the highest measurement of disk pages per second. Use this report to locate the server with the highest number of disk pages per second.
6-6
Service
DHCP
EventLog
This Service Availability report shows the top N servers where the service EventLog is the least available. Use this report to nd and troubleshoot those systems where EventLog is least available.
IISADMIN
This Service Availability report shows the top N servers where the service IISADMIN is the least available. Use this report to nd and troubleshoot those systems where IISADMIN is least available.
LanmanServer
This Service Availability report shows the top N servers where the service LanmanServer is the least available. Use this report to nd and troubleshoot those systems where LanmanServer is least available.
6-7
Table 6-6
Service
LanmanWorkstation
LicenseService
This Service Availability report shows the top N servers where the service LicenseService is the least available. Use this report to nd and troubleshoot those systems where LicenseService is least available.
MSExchangeCCMC
This Service Availability report shows the top N servers where the service MSExchangeCCMC is the least available. Use this report to nd and troubleshoot those systems where MSExchangeCCMC is least available.
6-8
When data is not found for a report, a blank report is created displaying the report header only.
6-9
Figure 6-1 is a top N summary graph that shows the Windows Server CPU processor time percentage. The height of each bar represents the percentage of CPU processor uptime for the server over the 24 hour period. The key explains which color represents each server. This report gives you a good picture of those servers that you need to investigate further.
Figure 6-1 Summary Graph Showing Top NT CPU
For the trend graph that completes the Top CPU Usage report, see Figure 6-2 on page 6-11.
6-10
6-11
Figure 6-2
6-12
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Dening Unix Status and Availability Reports . . . . . . . . . . . . . . . . . 7-2 Dening Unix Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . . 7-4 Dening Unix Capacity and Utilization Reports . . . . . . . . . . . . . . . . 7-5 Interpreting Solution Reports for Unix. . . . . . . . . . . . . . . . . . . . . . . . 7-7
7-1
Overview
Solution Reports for Unix provide a predened set of reports for the management of your Unix systems. These reports provide the ability to analyze availability data across multiple Unix hosts in a distributed enterprise. You can highlight the enterprise-wide availability, performance, and capacity of a particular Unix host or of Unix system parameters. Reports are based on Unix management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Unix PATROL Agents in your enterprise.
Report Title
Top 10 Busiest Disks
This report shows the top N Unix servers based on the highest combination of disk reads and writes. Use this report to which disks on what servers are the busiest. Use this information to plan system resources.
7-2
Table 7-1
Report Title
Top 5 NFS Client Calls to Read and Write Data
This report shows the top N Unix servers with the greatest percentage of NFS server calls to read data from les. Use this le to help identify potential network bottlenecks.
This report shows the top N Unix servers based on the highest percentage of NFS server calls to write data to les. Use this report to help identify potential network bottlenecks.
7-3
Report Title
Top 5 CPU Load
This report shows the top N Unix servers with the greatest percentage of CPU time used. Use this report to locate the servers with the least CPU time available.
This report shows the top N Unix servers based on the highest total network trafc, packets in, packets out, and errors. Use this report to help identify potential network problems.
This report shows the top N Unix servers with the greatest amount of free space in a swap area. Use this report to locate servers with the most free swap space.
This report shows the top N Unix servers with the least amount of free space in a swap area. Use this report to locate servers with the least free swap space.
7-4
Table 7-2
Report Title
Top 5 Summary Swap Used %
Bottom 5 Summary Swap Used % Top 5 Summary Swap Size Bottom 5 Summary Swap Size Top 5 Free Memory Top 5 Memory Page Out Top 5 Memory Page In
7-5
Table 7-3
Report Title
Top 5 Highest Capacity
This report shows the top N Unix servers with the least percentage of the available space in use. Use this report to locate servers with the most le system space available for use.
This report shows the top N Unix servers with the most available le system space. Use this report to determine what servers have the most le system space available.
This report shows the top N Unix servers with the least available le system space. Use this report to determine what servers have the least space available.
This report shows the top N Unix servers with the most used le system space. Use this report to determine what servers have the least available space.
This report shows the top N Unix servers with the least used le system space. Use this report to determine what servers have the most available space.
This report shows the top N Unix servers with the greatest number of users. Use this report to locate the servers with the greatest number of users.
This report shows the top N Unix servers with the greatest number of user sessions.
7-6
When data is not found for a report, a blank report is created displaying the report header only.
7-7
7-8
A summary bar graph with the same information would show only one of the value types: minimum, average, or maximum. You view more details in a summary table report than a summary bar graph. The type you choose depends on the information you require and the report templates available with your solution report package.
7-9
Figure 7-2
The trend graph provides more detail than the accompanying summary bar graph. You can see the hourly averages during the 24 hour period on the trend report. You can also tell during what time periods the disk usage increases or decreases and during which time periods no information on a server was available. This example shows that the average disk usage on a particular server did not change from one hour to the next.
The sample trend graph below shows the Unix servers with the Top 5 le system used space in your enterprise. Each color-coded symbol represents the le system space percentage for a server. The key associates each symbol and color with a server instance.
7-10
Figure 7-3
7-11
This chapter describes the Solution Reports for Microsoft Exchange Server. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Dening Microsoft Exchange Server Availability Reports . . . . . . . . 8-2 Dening Microsoft Exchange Server Performance Reports . . . . . . . 8-3 Dening Microsoft Exchange Server Capacity or Usage Reports . . . 8-4 Interpreting Solution Reports for Microsoft Exchange . . . . . . . . . . 8-7
8-1
Overview
Solution Reports for Microsoft Exchange Server provides a pre-dened set of reports for the management of your Microsoft Exchange Server systems. These reports provide the ability to analyze availability, performance, and capacity data across multiple Microsoft Exchange Servers in a distributed enterprise. Reports are based on Microsoft Exchange Server management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Microsoft Exchange Server PATROL Agents in your enterprise.
Report Title
Server Downtime (5 Least Available)
8-2
Report Title
Top 5 Server Memory
This report shows the top N Microsoft Exchange Servers based on the highest average message send rates per hour of the top senders. Top senders is a value congured for a host by a menu command from the PATROL console. Use this report to locate servers of top message senders with the highest message send rates per hour.
8-3
Table 8-2
Report Title
Top 5 Messages Received/ Hour
This report shows the top N Microsoft Exchange Servers based on the slowest delivery of messages to MTA. Use this message to determine and troubleshoot the servers with the slowest delivery to MTA.
8-4
Table 8-3
Report Title
Top 5 Count Private Folders
This report shows the top N Microsoft Exchange Servers based on the greatest number of public folders. Use this report to nd the servers with the greatest number of public folders.
This report shows the top N Microsoft Exchange Servers based on the greatest number of server messages. Use this report to nd the servers with the greatest number of server messages.
This report shows the top N Microsoft Exchange Servers based on the largest message size (space). Use this report to nd the server with the largest message size.
This report shows the top N Microsoft Exchange Servers based on the greatest number of client connections. Use this report to nd the server with the largest number of client connections.
This report shows the top N Microsoft Exchange Servers based on the greatest size of public folder messages. Use this report to nd the servers with the greatest public folder message sizes.
8-5
Table 8-3
Report Title
Top 5 Count Messages Sent
This report shows the top N Microsoft Exchange Servers based on the highest average number of messages received by the top receivers. Top receivers is a value congured for a host by a menu command from the PATROL console.
This report shows the top N Microsoft Exchange Servers based on the measurement of the total volume of messages stored in the MTA in kilobytes.
8-6
When data is not found for a report, a blank report is created displaying the report header only.
8-7
8-8
8-9
8-10
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 Dening Oracle Availability Reports . . . . . . . . . . . . . . . . . . . . . . . . . 9-3 Dening Oracle Performance Reports . . . . . . . . . . . . . . . . . . . . . . . . 9-4 Dening Oracle Capacity Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6 Interpreting Solution Reports for Oracle . . . . . . . . . . . . . . . . . . . . . . 9-7
9-1
Overview
Solution Reports for Oracle provide a predened set of reports for the management of your Oracle servers. These reports provide the ability to analyze data across multiple Oracle databases in a distributed enterprise. You can determine the enterprise-wide Oracle server availability, performance, and capacity. Reports are based on PATROL management data that is collected and deposited in the DataStore. The DataStore is the central database that contains both event and parameter information gathered from Oracle PATROL Agents in your enterprise.
9-2
Report Title
Oracle Lock Conicts (5 most frequent)
This report shows the top N Oracle database servers based on the Oracle availability parameter Minimum Extents Left. Use this report to determine which database servers have space allocation problems.
This report shows the status of the top/bottom N Oracle databases based serverss average response time and on the time the server was available. Use this report to determine what servers have the least or most downtime and what servers have the best or worst response times.
9-3
Report Title
Oracle Redo Rate
This report shows top N busiest Oracle database servers based on the highest transaction rates. Use this report to nd database servers with the highest transaction rates.
This report shows the top N Oracle database servers based on the highest measurements of the Disk Sort Rate performance parameter. Use this report to track disk sort rate performance of the Oracle servers.
9-4
Table 9-2
Report Title
Oracle Lock Wait Ratio
This report shows the status of the top/bottom N Oracle databases based serverss average response time and on the time the server was available. Use this report to determine what servers have the most up or down time and what servers have the best or worst response times.
Report Title
Oracle Cache (Bottom 5)
9-5
Report Title
Oracle Capacity (5 to Watch)
This report shows the top N busiest Oracle database servers based the highest number of user sessions. Use this report to locate the database servers with the most users.
9-6
When data is not found for a report, a blank report is created displaying the report header only.
9-7
9-8
Figure 9-1
9-9
9-10
Glossary
1 1Review copyRrr
Glossary
Actuate Live Report Extension (LRX)
A Web browser plug-in that an end user can use to nd, view, and print reports (not generate reports) accessed over the Internet. Component of Service Reporting used to manage the Report Server. Using the Administrator Desktop, you can add or remove report executables and documents, generate reports, set and maintain user information, and congure security for report server resources. A component that compiles the information collected from one or more retrievers and stores the data in the DataStore as raw and summarized data. See data aggregator A way to classify related namespace data (application classes, application instances, and parameters) used for a common purpose. Data can be associated by location, organization, and category. The subject of a measurement or event. Examples in PATROL include, an Oracle database instance; a host running a Windows NT server.
Administrator Desktop
aggregator
associations
component
Glossary
data aggregator
A data aggregator receives event and parameter data from retrievers and forwards that data to the DataStore. Data aggregators control the DataStores summarizing activities, normalize and synchronize time values between different data sources, control and monitor a retrievers status, and downloads conguration parameters to a retriever. A process that converts raw data located in the DataStore into summary data. When raw data is converted, it is organized into the summary time periods of hourly, daily, weekly, and monthly summary values of maximum, average, sum, standard deviation, and variance. The summarized data is then used in the QuickReport Editor and Solution Reports. The DataStore is the database used by Service Reporting to store parameter and event data collected from your PATROL environment. The database stores raw data, measurement values, and time-summarized measurements. Time-summarized measurements are the inputs to reports. The DataStore Console is the graphical user interface (GUI) for the DataStore. With the DataStore Console, you can determine what data is collected, as well as monitor and maintain aggregators and retrievers. The knowledge module (KM) that Service Reporting uses to congure and monitor DataStore components, including data aggregators and retrievers. The DataStore KM lets you congure local or remote data aggregators and retrievers, as well as start, stop, and monitor the current status or performance of these components. See Knowledge Module (KM). While viewing a report, the ability to view the same information in more detail as part of the same report. A command line utility that lets you save parameter history data from databases on PATROL Agents to ASCII text les.
data summarization
DataStore
DataStore Console
DataStore KM
drill down
dump_hist utility
On Windows NT platforms, a graphical user interface that end users can use to request local report generation, as well as local printing and viewing of reports. All the components, measurements, and events in the PATROL Datastore valid for a given time. A subset of the components, measurements, and events stored in the DataStore for a given time span. Examples include: all Windows NT nodes located in Houston and their KM parameter values for yesterday all Microsoft Exchange servers on nodes whose name starts hou and their Exchange KM parameter TotalMsgSize averaged daily for the last week
enterprise
enterprise view
event lter
Created in the DataStore Console, an event lter controls the collection of event data. Criteria an event lter may contain includes type, status, and severity. An event lter lets you collect information, state change, error, and warning events. A component that collects data when an event matches criteria specied in the event lter. Once the event occurs, the event retriever forwards the raw event data to the data aggregator. A lter is used to determine what information is collected. Service Reporting uses the following lters: history lterscollect parameter information event lterscollect event information
event retriever
lters
generic report
A presentation (graph, table, or chart) generated by specifying parameters, selection criteria, and labels using the QuickReport Editor.
Glossary
history lter
A history lter lets you specify what parameter data is collected from a PATROL Agent. Parameter data you can collect depends upon the KMs installed on the agent being queried. Once dened, you must add the history lter to at least one history lter group before it can start gathering parameter data. See history lter group. A history lter group is the mechanism that forwards history lter settings to the data aggregator. The data aggregator sends the history lter settings to a retriever, which uses the settings to determine what data to collect. All history lters must belong to one or more history lter groups. A process that collects parameter information from an agents local cache. To provide a set of denitions and instructions to be used as a starting point for a component or executable. Usually, you can redene these settings at any point. A computer or discovered application that is running in the PATROL-managed environment. An instance has all the attributes of the class that it belongs to. A computer instance is a monitored computer that has been added to the PATROL Console. An application instance is discovered by PATROL. See associations. The time unit, for example hour, day, week, month, and year. See Knowledge Module (KM). A list of KMs to be loaded by a PATROL Agent. See also Knowledge Module (KM).
history retriever
initialize
instance
KM tree
A feature of PATROL for Windows NT only. One of two views of folders available in Windows NT. The KM tree displays computer classes, application classes, and their customized instances in the knowledge hierarchy and also displays the Standard Event Catalog. A PATROL Operator Console can only view the KM tree; only the PATROL Developer Console can change KM properties and attributes. See also Knowledge Module (KM). A set of les from which a PATROL Agent receives information about resources running on a monitored computer. A KM le can contain the actual instructions for monitoring objects or simply a list of KMs to load. KMs are loaded by a PATROL Agent and a PATROL Console. KMs provide information for the way monitored computers are represented on the PATROL Desktop, for the discovery of application instances and the way they are represented, for parameters that are run under those applications, and for the options available on object menus. A PATROL Developer Console can change KM knowledge for its current session, save knowledge for all of its future sessions, and commit KM changes to specied PATROL Agent computers. See also KM list, KM tree, and load KMs.
load applications
Same as load KMs; most KMs are composed of application les with a *.kml extension. To place KM les into memory for execution. After conguration and during startup, the PATROL Agent loads the KM les that are listed in its conguration le and that reside on the PATROL Agent machine. When a PATROL Console connects to the PATROL Agent, the KM versions that the Agent executes depend on whether the Console is an Operator Console or a Developer Console. See also Knowledge Module (KM). The history (stored parameter values) for an object or instance. The user-dened length of time during which stored parameter values for an object or instance are retained.
load KMs
Glossary
manual collection
Lets you start or stop collection of parameter data regardless of the settings in a history lter. Manual collection lets you be very specic about what data is or is not collected. Once you use manual collection, those settings remain in effect until you clear them. Process that reads a comma separated value le and lets you load dump_hist data into the DataStore. See retrievers A graphical user interface that you can use to create new reports based on generic report templates to meet your management reporting requirements. A series of dialogs help you dene the input parameters for your report. One of several report denitions or templates that a user can select to generate a specic report. The denition includes a visual presentation and a list of parameters that control the presentation a family of content and a list of required parameters to specify the content
QuickReport Editor
QuickReport Template
For example, the top/bottom N summary graph denes the visual presentation as a bar graph and denes the input as at the most N rows of data, sorted in ascending or descending order.
report
Generated presentations (graphs, tables, or charts) based on stored PATROL event and parameter data that you can view remotely using a Web browser on supported platforms. Person who locates, runs, schedules, and views report documents.Typically, this person is a manager or senior IT professional in charge of managing a portion of the enterprise infrastructure.
report consumer
report composer
Person who creates schedules and runs report templates, creates new report templates, and ensures that the necessary data is being collected. Typically, this person is a technical IT professional who needs certain kinds of PATROL information to appear in reports. A component of Service Reporting that is used to control access to reporting data. With the report server, you can: manage users request (on-demand reports with run-time parameters) control the report encyclopedia and validate users and requests generate report instances print reports manage persistent objects, such as report instances, folders, users, and roles
Report Server
A person who installs and sets up components, and periodically cleans up the report store/encyclopedia (removes or archives old reports, removes unused report templates, and the like). Report templates (RTs) are denitions for Service Reporting that direct Service Reporting to extract data from the DataStore for a given time span and generate a presentation in the form of a graph, table, or chart. Components that compile, lter, and forward agent data to an aggregator. Aggregrators send lter settings to the retrievers that specify which parameter data and event data to collect. Service Reporting includes the following types of retrievers: History Retrievercollects parameter data from an agents local cache Event Retrievercollects event data Open Data Retrieverreads a comma separated value le and lets you load dump_hist data into the DataStore
report template
retrievers
Glossary
ROI les
Report document les. The reports that you view and print. ROI les are stored in the Report Encyclopedia. You can use the End User Desktop or the Administrator Desktop to create report document les. Parameter value les. The les that store parameter values specied for a specic report executable. The values in the le lter the data for a report document. You use a parameter values les to generate a report with a specied set of criteria. Report template executable les. The les that you execute to generate report documents with current data. A package of report templates created for the management of a particular technology or application. The reports require little or no user setup. A particular interval dened by its interval type and start time, for example, week of October 10, 1999. For simple time spans, the interval type. For nested time spans, the interval type and number of sub-intervals, for example, weekly span shown as 168 hours. Component of Service Reporting that provides access to reporting. Using the Web Desktop, you can view contents of the Report Encyclopedia, create your own reports with the QuickReport Editor, and generate, schedule, locate, view, print, and distribute reports. On Windows NT platforms, an application that an end user can use to print and view reports.
ROV les
ROX les
Solution Reports
time span
Web Desktop
Windows NT Viewer
Index
Index
A
Actuate components of Service Reporting 1-3 desktop applications 2-3 documentation xi Actuate Administrator Desktop 1-4 Actuate Viewer 1-6 Administration 2-8 Administrative directory 1-5 administrator privileges needed for access 2-7 Administrator Desktop 1-5 available space 5-7 CPU utilization 5-7 CPU utilization or load 5-7 Creating reports 4-2
D
Data Collection Table 4-2, 5-6 DataStore Unix data 7-2 Windows NT data 6-2 Deleting reports 4-16 Details icon 2-8 disk reads and writes 5-7 document conventions xiv documentation related x Documents 2-8
B
Basic reporting concepts 1-7 blank reports 7-7 BMCReports 4-29 busiest disks 5-7
E
Editing reports 4-12 End User Desktop 1-5 Enterprise Events and Measurements 5-7 Enterprise Hot Spots 5-15 Event Summary Table 4-2 Examining Server CPU Usage 3-7
C
cache usage 5-7 conventions,document xiv
BMC Software, Inc., Condential and Proprietary Information
Index
Exchange server availability reports 8-2 server capacity and usage reports 8-4 server performance parameter data 8-3 server performance reports 8-3 solution reports 8-7 summary graphs 8-8 trend graphs 8-9 view daily data 8-3 view data 8-3 view monthly data 8-3 view performance reports 8-3 view weekly data 8-3 Exchange Server Solution Reports for 3-18
L
Locating Servers with low Message Space 3-5 logical and physical disk usage 5-7
M
memory availability 5-7 Microsoft Exchange PATROL Agents 8-2 Microsoft Internet Explorer 2-5 My Documents link on Web Desktop 2-9 My Headlines 2-8 My Prole 2-8
F
Finding Server Hot Spots 3-10
H
Help link on Web Desktop 2-9 Hot Spot Information 3-20 Hot Spots 5-5 Hot Spots Table 4-2 Hot Spots Threshold Table 4-2
N
Netscape Navigator 2-5 New reports creating using the QuickReport Editor 4-3 NFS read and write calls 5-7
I
incoming network packets 5-7 Internet Explorer 2-5
O
online documentation xiii Oracle availability reports 9-3 capacity reports 9-6 PATROL Agents 9-2 performance reports 9-4 server availability 9-2
J
Java plug-in
BMC Software, Inc., Condential and Proprietary Information
SGA reports 9-5 Solution Reports for 3-18 Oracle Solution Reports 1-4
P
Parameter Collection verifying 3-13 Parameters for QuickReports 4-2 PATROL data deposited in the DataStore 9-2 events 1-3 management data 9-2 parameters 1-3 PATROL application classes 3-19 Planning solution-specic reporting 3-15 Predened reports 1-3 Solution Reports 1-3 Print/Download link 4-33 Printing Reports 4-33
nding 2-11 interpreting 5-3 locating and viewing 4-29 planning 3-4 scenarios 3-4 scheduling 4-19 using the QuickReport Editor 3-4
R
related documentation xiii related publications x release notes xiii Report Encyclopedia 1-3, 1-5 accessing 2-5 navigation of 2-8, 2-9 remote access 1-5 requirements for the Web page 2-5 Tab pages 2-8 Web access 1-5 Web page 2-7 Report item directory 1-5 Report Object Value (.ROV) 4-24 Report Server 1-3, 1-4 functions of 1-4 parameter value les 4-23 Report viewers 1-3, 1-5 overview 1-5 Reporting overview 2-2 planning 2-2 Reporting concepts overview 1-7 understanding 1-7 Reports locating and viewing 4-28 scheduling and generating 4-19 Requests 2-8 Requests directory 1-5
Q
QuickReport Editor 1-3 copy and modify reports 2-3 creating new reports 4-2 customized report templates 3-18 dene new reports 2-3 delete reports 2-3 introduction to 1-3 Oracle reports 3-22 planning your reporting strategy 3-4 reporting checklist 3-4 QuickReport types 3-2 description of 3-2 QuickReports creating report templates 4-2
BMC Software, Inc., Condential and Proprietary Information
Index
S
Sample trend graph Exchange Servers 8-9 Saving reports as .PDF 4-33 Scheduling directory 1-5 Server CPU Usage examining 3-7 Server Hot Spots nding 3-10 Servers locating with low Message Space 3-5 Service Reporting Actuate Software Corporation components 1-3 BMC Software components 1-3 components of 1-3 features and benets 1-2 introducing report types and templates 3-2 Solution Report generate and schedule 4-24 Solution Reporting Checklist 3-16 Solution Reports 1-3 checklist for 3-16 for Microsoft Exchange 1-4 for Microsoft Exchange Server 1-4 for Microsoft Windows 2000 Server 1-4 for Oracle 1-4, 9-2 for Unix 1-4 for Windows 2000 1-4 generating 4-23 locating and viewing 4-30 planning 3-15 Solution specic reporting 3-15 Summary Graph 4-2, 5-3 report parameters 3-6 Summary Table 4-2
T
Top 10 Busiest Disks 7-2 Top 10 Disk Read/Writes 7-2 Trend Graph 4-2 Trend Graph (Multi-Parameter) 4-2 Trend Graphs 6-10 Trend Table 4-2 Trend Table (Multi-Parameter) 4-2
U
Unix capacity and utilization reports 7-5 capacity parameters 7-5 data stored in DataStore 7-2 performance parameters 7-4 performance reports 7-4 Solution Reports 7-7 status and availability reports 7-2 summary graphs 7-7 summary tables 7-8 trend graphs 7-9 utilization parameters 7-5 Unix reports overview 7-1 Unix server parameters investigation of 5-7 Unix Servers locating heavy usage 3-17 user or session counts 5-7
V
Verifying Parameter Collection 3-13
W
Web browsers required for reporting 2-5 Web Desktop using 2-5 web user interface 1-3 Windows NT looking at enterprise-wide parameters 5-7 PATROL Agents 6-2 server status 6-3 Solution Reports 6-9 summary graphs 6-9 Windows NT Reports availability 6-7 server cache parameter 6-4 server CPU parameter 6-4 server logical disk parameter 6-5 server memory parameter 6-6 server parameter 6-3 server status 6-3 Windows NT Servers selecting for upgrading 3-16
Index
Notes