OVNPM 1.6.1 - Performance Agent for NonStop Display

OVNPM 1.6.1 - Performance Agent for NonStop Display
HP Performance Agent for NonStop
Display Agent Guide
Part number: 871256-001
Seventh edition: 11/2015
Legal notices
Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect,
special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Warranty: A copy of the specific warranty terms applicable to your Hewlett-Packard product can be obtained from your local Sales and
Service Office.
Restricted Rights Legend: All rights are reserved. No part of this document may be copied, reproduced, or translated to another language
without the prior written consent of Hewlett-Packard Company. The information contained in this material is subject to change without notice.
Use, duplication or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in
Technical Data and Computer Software clause at DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and (c) (2) of the
Commercial Computer Software Restricted Rights clause at FAR 52.227-19 for other agencies.
HEWLETT-PACKARD COMPANY
United States of America
Copyright Notices: ©Copyright 1983-2015 Hewlett-Packard Company, all rights reserved.
Reproduction, adaptation, or translation of this material without prior written permission is prohibited, except as allowed under the
copyright laws.
Part number: 871256-001
Seventh edition: 11/2015
Printing History
The printing date and part number of the manual indicate the edition of the manual. The printing date will change when a new edition is
printed. Minor changes may be made at reprint without changing the printing date. The part number of the manual will change when
extensive changes are made.
Manual updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or
new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details.
First Edition: 07/2004
Contents
Preface
Before You Begin ...................................................................................................................................... 11
Audience ................................................................................................................................................. 11
Goals of Documentation ............................................................................................................................ 11
Organization............................................................................................................................................ 11
OVNPM Documentation Map .................................................................................................................... 12
Electronic Versions of the Manuals .............................................................................................................. 12
OVNPM Manuals ..................................................................................................................................... 13
About OVNPM Online Help....................................................................................................................... 13
1 Introducing
1-1
1-2
1-3
1-4
OVNPM Display Agent
OVNPM Display Agent ......................................................................................................... 14
Display Agent Operating Components .................................................................................... 14
Display Agent Modules ......................................................................................................... 14
Features ............................................................................................................................... 15
2 Installing OVNPM Display Agent
2-1
Prerequisites ......................................................................................................................... 16
2-2
Contents of the Installation Exe ............................................................................................... 16
2-3
Installing Display Agent ......................................................................................................... 17
2-4
Modifying OVNPM Display Agent ......................................................................................... 19
3 OVNPM Display Agent: The Interface
3-1
Menu Bar............................................................................................................................. 23
3-1-1
Node Menu ......................................................................................................................... 23
3-1-2
Options Menu ...................................................................................................................... 25
3-1-3
Tools Menu .......................................................................................................................... 26
3-1-4
Help Menu ........................................................................................................................... 28
3-2
Window Tabs ...................................................................................................................... 29
3-3
Status Bar ............................................................................................................................ 29
4 Working with Display Agent
4-1
Starting the Display Agent ..................................................................................................... 30
4-2
Creating a Node .................................................................................................................. 31
4-3
Connecting to a Node .......................................................................................................... 33
4-4
Starting the Display Agent on a Node .................................................................................... 34
5 Dashboards
5-1
5-2
5-3
5-4
5-5
5-6
5-6-1
5-6-2
5-7
5-8
5-8-1
5-8-2
5-9
5-9-1
5-9-2
5-10
5-10-1
5-10-2
What are Dashboards? ......................................................................................................... 35
Predefined Dashboards ......................................................................................................... 36
Opening a Dashboard .......................................................................................................... 37
Launching a Dashboard at Startup.......................................................................................... 39
Organizing Views in a Window ............................................................................................ 41
Creating a User-Defined Dashboard ....................................................................................... 43
Creating a Dashboard .......................................................................................................... 43
Creating a Dashboard from an Open View ............................................................................. 43
Renaming User-Defined Dashboards ....................................................................................... 43
Adding Views to User-Defined Dashboards ............................................................................. 44
Adding Views without Opening the Dashboard ....................................................................... 44
Adding Views to an Open Dashboard .................................................................................... 46
Removing Views from User-Defined Dashboards ...................................................................... 48
Removing Views from a Dashboard ........................................................................................ 48
Removing Views from an Open Dashboard ............................................................................. 48
Time Periods of Views ........................................................................................................... 49
Linking Time Periods of Views ...................................................................................... 49
Creating New Time Reference ..................................................................................... 51
5-10-3
5-11
5-11-1
5-11-2
5-12
5-12-1
5-12-2
5-13
5-13-1
5-13-2
5-14
5-14-1
5-14-2
5-14-3
Removing Time Reference ............................................................................................ 52
Sharing Dashboards ............................................................................................................. 53
Sharing Dashboards with Other Computers ................................................................... 53
Accessing Shared Dashboards ..................................................................................... 55
User-Defined Dashboards ...................................................................................................... 57
Saving/Exporting Dashboard Configurations ................................................................ 57
Printing User-Defined Dashboard Configurations ............................................................ 59
Masking and Redisplaying Predefined Dashboards .................................................................. 60
Masking Predefined Dashboards .................................................................................. 60
Redisplaying Predefined Dashboards ............................................................................ 60
Printing from Dashboard........................................................................................................ 61
Printing a View ........................................................................................................... 61
Printing Multiple Views ................................................................................................ 62
Scheduling Automatic Dashboard Printing ..................................................................... 63
6 Using Views: SystemInsight
6-1
What is SystemInsight? .......................................................................................................... 64
6-2
Exploring Domains................................................................................................................ 64
6-3
Opening a View ................................................................................................................... 65
6-4
Selecting Units ...................................................................................................................... 66
6-4-1
Temporarily Assigning Units to a Generic View ....................................................................... 66
6-4-2
Permanently Assigning Units to a Generic View ....................................................................... 67
6-4-3
Identifying Units: Distributed OVNPM System .......................................................................... 67
6-5
Using Metrics to Build Views .................................................................................................. 68
6-5-1
Copying an Existing View...................................................................................................... 68
6-5-2
Adding Metrics to a User-Defined View ................................................................................... 68
6-5-3
Adding a Metric to a View with Different Units ........................................................................ 68
6-5-4
Replacing Metrics in a View .................................................................................................. 69
6-5-5
Removing Metrics from a View ............................................................................................... 69
6-5-6
Creating a Customized View ................................................................................................. 70
6-5-7
Saving User-Defined Views and Metric Configurations.............................................................. 71
6-5-8
Printing User-Defined Views and Metric Configurations ............................................................. 73
6-6
Managing Information in Views ............................................................................................. 74
6-6-1
Changing the Time Interval .................................................................................................... 74
6-6-2
Stopping and Starting the Display .......................................................................................... 74
6-7
Display Modes ..................................................................................................................... 75
6-7-1
Changing the Display Mode .................................................................................................. 76
6-7-2
Curve Mode ......................................................................................................................... 77
6-7-3
Layer Mode ......................................................................................................................... 78
6-7-4
Displaying Values for a Specific Interval.................................................................................. 79
6-7-5
Plot Mode ............................................................................................................................ 80
6-7-6
Changing Metrics Used to Plot the Line at Any Time ................................................................. 81
6-8
Displaying Values Independently ............................................................................................ 82
6-9
Customizing Appearance of Views ......................................................................................... 83
6-9-1
Applying Colors to Areas between Curves .............................................................................. 84
6-9-2
Setting a Background Pattern ................................................................................................. 86
6-9-3
Hiding One or More Metrics.................................................................................................. 87
6-9-4
Setting a Marker ................................................................................................................... 88
6-9-5
Setting a High Mark for Gauges ............................................................................................ 89
6-9-6
Setting a Scale for the Display ............................................................................................... 91
6-10
Using Style Sheets................................................................................................................. 92
6-10-1
Applying Style Sheets .................................................................................................. 92
6-10-2
Creating a Style Sheet ................................................................................................. 93
6-11
Viewing Recent-Past Data ...................................................................................................... 94
6-11-1
Specifying Exact Time Reference for Recent-Past Data ..................................................... 94
6-11-2
Creating a Time Reference........................................................................................... 95
6-11-3
Deleting a Time Reference ........................................................................................... 95
6-11-4
Scrolling Through Recent-Past Data ............................................................................... 95
6-11-5
6-11-6
6-12
6-13
6-13-1
6-13-2
6-13-3
6-14
6-15
6-16
6-16-1
6-16-2
6-17
6-18
6-19
Animating Recent-Past Data ......................................................................................... 96
Switching from Replay to Real-Time Monitoring .............................................................. 96
Using Comments in a View .................................................................................................... 96
Drilling Down for Detailed Information .................................................................................... 97
Drilling Down on Domains ........................................................................................... 97
Drilling Down on Units ................................................................................................ 99
Drilling Down from an Open View.............................................................................. 101
Exporting Data to a File....................................................................................................... 102
Printing a View ................................................................................................................... 102
Copying a View ................................................................................................................. 103
Copying a View to a Dashboard ................................................................................ 103
Copying a View to another Domain ........................................................................... 104
Locating Metrics and Units ................................................................................................... 105
Renaming a View ............................................................................................................... 106
Deleting a View .................................................................................................................. 106
7 Analyzing Trends: SystemTrend
7-1
What is SystemTrend? ......................................................................................................... 107
7-2
Understanding SystemTrend Views ....................................................................................... 107
7-2-1
History Views ..................................................................................................................... 108
7-2-2
Profile Views ...................................................................................................................... 109
7-3
Opening a SystemTrend View .............................................................................................. 110
7-3-1
Opening a SystemTrend View with an Existing Time Reference ................................................ 110
7-3-2
Adding a New Time Reference and Data Wrap .................................................................... 111
7-4
Copying an Existing Trend View .......................................................................................... 111
7-5
Creating a SystemTrend View .............................................................................................. 112
7-6
Customizing Appearance of Views ....................................................................................... 113
7-6-1
Changing Report Intervals.................................................................................................... 113
7-6-2
Scrolling Between Time Periods ............................................................................................ 113
7-6-3
Hiding Values .................................................................................................................... 113
8 Using Tabular Data: SystemReport
8-1
What is SystemReport? ........................................................................................................ 114
8-2
Opening a Report ............................................................................................................... 115
8-3
Opening a Report from SystemInsight ................................................................................... 117
8-4
Using Metrics to Build Reports .............................................................................................. 118
8-4-1
Copying an Existing Report ................................................................................................. 118
8-4-2
Modifying Metrics in a Report .............................................................................................. 118
8-4-3
Creating a Customized Report ............................................................................................. 119
8-5
Sorting a Report ................................................................................................................. 120
8-6
Deleting a Report ................................................................................................................ 120
9 Using SystemAlert
9-1
What is SystemAlert? .......................................................................................................... 121
9-2
Opening SystemAlert .......................................................................................................... 121
9-3
Thresholds and Threshold Groups ......................................................................................... 122
9-3-1
Accessing the Expert Mode.................................................................................................. 122
9-3-2
Configuring Thresholds and Threshold Groups ....................................................................... 122
9-4
Managing Thresholds.......................................................................................................... 123
9-4-1
Creating a Threshold........................................................................................................... 123
9-4-2
Assigning or Modifying a Threshold Expression ..................................................................... 125
9-4-3
Modifying Time Parameters ................................................................................................. 125
9-4-4
Setting Monitoring Periods ................................................................................................... 127
9-4-5
Requesting Recurrent Notifications ........................................................................................ 127
9-4-6
Setting a Severity Level ........................................................................................................ 128
9-4-7
Adding a Threshold to a Group ........................................................................................... 128
9-4-8
Creating an Alarm Message ................................................................................................ 128
9-4-9
Using a Log File.................................................................................................................. 129
9-4-10
Declaring a Console to Receive Alerts ......................................................................... 129
9-4-11
9-5
9-5-1
9-5-2
9-5-3
9-5-4
9-5-5
9-5-6
9-5-7
9-6
9-7
9-8
9-8-1
9-9
9-9-1
9-9-2
9-9-3
9-10
9-10-1
9-10-2
9-11
9-12
9-13
10
11
Deleting Thresholds ................................................................................................... 129
Managing Threshold Groups ............................................................................................... 130
Creating a Threshold Group ................................................................................................ 130
Adding Threshold to a Group .............................................................................................. 130
Removing Thresholds from a Group ...................................................................................... 130
Deleting a Threshold Group ................................................................................................. 130
Assigning a Triggering Condition to a Group ........................................................................ 130
Setting a Severity Level for a Group ...................................................................................... 131
Creating an Alarm Message for a Group .............................................................................. 131
Activating Thresholds .......................................................................................................... 131
Activating Alarm Reception .................................................................................................. 132
Alarm Log .......................................................................................................................... 133
Opening a View from the Alarm Log Window ....................................................................... 134
Alarm Status ....................................................................................................................... 135
Displaying Individual and Group Alarms ............................................................................... 135
Displaying Threshold Details ................................................................................................ 136
Opening a View from the Alarm Status Tab Page .................................................................. 136
Defining Alarm Behavior ..................................................................................................... 137
Setting Severity Level Options .................................................................................... 137
Defining E-Mail Recipients ......................................................................................... 138
Detecting Runaway Process Loops ........................................................................................ 139
Detecting Changes in Availability ......................................................................................... 140
Detecting Incidents on a File ................................................................................................ 140
Managing Scheduled Jobs
10-1
Scheduler .......................................................................................................................... 141
10-2
Scheduling a New Job ........................................................................................................ 142
10-3
Executing Scheduled Jobs Immediately .................................................................................. 143
10-4
Examining the Contents of Scheduled Jobs ............................................................................ 144
10-5
Modifying a Scheduled Job ................................................................................................. 145
10-6
Removing a Scheduled Job .................................................................................................. 145
10-7
Purging Jobs....................................................................................................................... 145
Exporting Data: DataSet
What is DataSet? ............................................................................................................... 146
Creating a DataSet ............................................................................................................. 147
Data Extraction ................................................................................................................... 149
Defining Time Parameters .......................................................................................... 149
Starting Data Extraction ............................................................................................. 150
Stopping Data Extraction ........................................................................................... 150
Modifying a DataSet ........................................................................................................... 150
Saving DataSet Configurations............................................................................................. 150
Printing DataSet Configurations ............................................................................................ 151
Scheduling DataSet Results for Export ................................................................................... 152
Opening a DataSet ............................................................................................................. 153
11-1
11-2
11-3
11-3-1
11-3-2
11-3-3
11-4
11-5
11-6
11-7
11-8
12
Real-Time Monitoring: Navigator
What is Navigator? ............................................................................................................ 154
Getting Started with Navigator ............................................................................................ 154
Navigation Menu ............................................................................................................... 155
12-1
12-2
12-3
13
Creating
13-1
13-2
13-3
13-4
13-5
13-6
SystemInsight Metrics
SystemInsight Metrics .......................................................................................................... 156
Selecting Metrics to Combine ............................................................................................... 156
Building a Metric Expression ................................................................................................ 158
Designating Units in a Combined Metric ............................................................................... 158
Modifying a Combined Metric ............................................................................................. 159
Deleting a Combined Metric ................................................................................................ 159
14
Working with Finder
What is Finder? .................................................................................................................. 160
Starting Finder .................................................................................................................... 160
Understanding Search Results .............................................................................................. 161
Copying Search Results to a Dashboard ............................................................................... 162
14-1
14-2
14-3
14-4
15
Uninstalling OVNPM Display Agent
Appendix A: Managing the Server Using Display Agent
Communicating with the Host Machine ..................................................................................................... 165
Creating a Connection Script File ............................................................................................................. 165
Script File Commands.............................................................................................................................. 166
Debugging a Script File ........................................................................................................................... 166
Figures
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
2-1 OVNPM Display Agent Setup – Welcome Page ................................................................................ 17
2-2 OVNPM Display Agent Setup – License Agreement Page ................................................................... 17
2-3 OVNPM Display Agent Setup – Check Setup Information Page ........................................................... 18
2-4 OVNPM Display Agent Setup – Setup Completed Page ..................................................................... 18
2-5 OVNPM Display Agent Information Box ........................................................................................... 19
2-6 OVNPM Display Agent Maintenance – Welcome Page ..................................................................... 19
2-7 OVNPM Display Agent Maintenance – Select Features Page .............................................................. 20
2-8 OVNPM Display Agent Maintenance – Setup Completed Page ........................................................... 21
3-1 OVNPM Display Agent GUI ............................................................................................................ 22
3-2 OVNPM Menu Bar ......................................................................................................................... 23
3-3 Display Agent Node Menu .............................................................................................................. 23
3-4 OVNPM Node Selection Dialog Box ................................................................................................ 23
3-5 Node Trace Window...................................................................................................................... 24
3-6 About Connection Message Box ...................................................................................................... 24
3-7 Display Agent Options Menu........................................................................................................... 25
3-8 Settings Dialog Box ........................................................................................................................ 25
3-9 Server Messages Window .............................................................................................................. 26
3-10 Display Agent Tools Menu............................................................................................................. 26
3-11 Finder Dialog Box ........................................................................................................................ 27
3-12 Display Agent Help Menu ............................................................................................................. 28
3-13 Display Agent Window Tabs ......................................................................................................... 29
3-14 Display Agent Status Bar ............................................................................................................... 29
4-1 OVNPM Node Selection Dialog Box ................................................................................................ 30
4-2 OVNPM Create Node Dialog Box ................................................................................................... 31
4-3 OVNPM Node Selection Dialog Box ................................................................................................ 32
4-4 OVNPM Node Selection Dialog Box ................................................................................................ 33
4-5 Connect Dialog Box ....................................................................................................................... 33
5-1 Dashboard .................................................................................................................................... 36
5-2 Dashboard Tab Page ...................................................................................................................... 37
5-3 Principal Resources Dashboard ........................................................................................................ 38
5-4 Dashboard Tab Page ...................................................................................................................... 39
5-5 Select Dashboard to Launch at Startup Dialog Box ............................................................................. 39
5-6 Monthly CPU Availability Dashboard Selected for Automatic Display at Startup .................................... 40
5-7 Organizing Views in a Dashboard Window ..................................................................................... 42
5-8 Copy to Dashboard Dialog Box ....................................................................................................... 43
5-9 Create Dashboard Dialog Box ......................................................................................................... 43
5-10 Dashboard Tab Page – Add Button ................................................................................................ 44
5-11 Add View Dialog Box ................................................................................................................... 44
5-12 Dashboard Window – Add View Icon ............................................................................................ 46
5-13 Add View Dialog Box ................................................................................................................... 46
5-14 Dashboards Tab Page – Remove Button .......................................................................................... 48
5-15 Remove View Confirmation Box ..................................................................................................... 48
5-16 Dashboard Menu – Link Time Option ............................................................................................. 49
5-17 Time Reference Selection Dialog Box .............................................................................................. 50
5-18 Trend Time Reference Dialog Box .................................................................................................. 51
5-19 Delete Time Reference Confirmation Box ......................................................................................... 52
5-20 Dashboards Tab Page – Share Menu ............................................................................................. 53
5-21 Export Dashboard Dialog Box ....................................................................................................... 54
5-22 Dashboards Tab Page – Share Menu ............................................................................................. 55
5-23 Import Dashboard Dialog Box ....................................................................................................... 55
5-24 Node Menu – Export Options ........................................................................................................ 57
5-25 Export Dashboards Dialog Box ...................................................................................................... 58
5-26 Node Menu – Print Options........................................................................................................... 59
5-27 Printer Selection Dialog Box .......................................................................................................... 59
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
5-28 Mask Dashboards Dialog Box ....................................................................................................... 60
5-29 Printer Selection Dialog Box .......................................................................................................... 61
5-30 Edit Layout Dialog Box .................................................................................................................. 62
5-31 Schedule Printing Dialog Box......................................................................................................... 63
6-1 Insight Tab Page ............................................................................................................................ 65
6-2 %CPU-BUSY View .......................................................................................................................... 65
6-3 Unit Selection Dialog Box ................................................................................................................ 66
6-4 Modify Insight View Dialog Box ....................................................................................................... 67
6-5 Create View Dialog Box ................................................................................................................. 70
6-6 Insight Metric Selection Dialog Box .................................................................................................. 70
6-7 Node Menu – Export Options .......................................................................................................... 71
6-8 Export Views and Metrics Dialog Box ............................................................................................... 72
6-9 Node Menu – Print Options ............................................................................................................. 73
6-10 Printer Selection Dialog Box .......................................................................................................... 73
6-11 View Window ............................................................................................................................. 74
6-12 Options Menu – Mode Options ..................................................................................................... 76
6-13 Curve View Window .................................................................................................................... 77
6-14 Layer View Mode ......................................................................................................................... 78
6-15 Curve View with a Point Selected ................................................................................................... 79
6-16 Plot View Window ....................................................................................................................... 80
6-17 Metrics Dialog Box ....................................................................................................................... 81
6-18 Values Dialog Box ........................................................................................................................ 82
6-19 Curve View.................................................................................................................................. 84
6-20 Curve View with Area Option Selected........................................................................................... 85
6-21 Curve View with 9 Lines Background Pattern Selected ...................................................................... 86
6-22 Curve View.................................................................................................................................. 87
6-23 Curve View with One Metrics Hidden ............................................................................................ 87
6-24 Marker Dialog Box ....................................................................................................................... 88
6-25 High Mark Dialog Box .................................................................................................................. 89
6-26 High Mark Dialog Box .................................................................................................................. 89
6-27 Scale Dialog Box ......................................................................................................................... 91
6-28 Style Sheet Dialog Box .................................................................................................................. 92
6-29 Configure Insight Style Sheet Dialog Box ........................................................................................ 93
6-30 Add Style Sheet Dialog Box .......................................................................................................... 93
6-31 Time Reference Selection Dialog Box .............................................................................................. 94
6-32 Time Reference Dialog Box............................................................................................................ 95
6-33 Edit Comment Dialog Box ............................................................................................................. 96
6-34 Insight Tab Page with Drill-Down Menu ........................................................................................... 97
6-35 Navigator ................................................................................................................................... 98
6-36 Navigator Drill-Down Result ........................................................................................................... 98
6-37 Metrics/Units Tab Page ................................................................................................................ 99
6-38 Metrics/Units Tab Page Drill-Down Menu ..................................................................................... 100
6-39 Options - Drill down Menu .......................................................................................................... 101
6-40 Navigator Drill Down ................................................................................................................. 102
6-41 Printer Selection Dialog Box ........................................................................................................ 102
6-42 View Copy Dashboard Option .................................................................................................... 103
6-43 Copy to Dashboard Dialog Box ................................................................................................... 103
6-44 Copy to Desktop Dialog Box ....................................................................................................... 104
6-45 Locate Metric Dialog Box ............................................................................................................ 105
6-46 Locate Unit Dialog Box ............................................................................................................... 105
6-47 Rename View Dialog Box ............................................................................................................ 106
6-48 Delete View Confirmation Box ..................................................................................................... 106
7-1 Trend History View ....................................................................................................................... 108
7-2 Trend Profile View ........................................................................................................................ 109
7-3 Display Agent Trend Tab Page ...................................................................................................... 110
7-4 Trend Time Reference Dialog Box................................................................................................... 111
7-5 Create View Dialog Box ............................................................................................................... 112
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
7-6 Trend Metric Selection Dialog Box ................................................................................................. 112
8-1 Display Agent Report Tab Page ..................................................................................................... 115
8-2 CPU Report .................................................................................................................................. 116
8-3 Open Report Option ..................................................................................................................... 117
8-4 Modify Report View Dialog Box ..................................................................................................... 118
8-5 Create View Dialog Box ............................................................................................................... 119
8-6 Report Metric Selection Dialog Box ................................................................................................ 119
9-1 Display Agent Alert Tab Page ........................................................................................................ 121
9-2 Expert Mode Dialog Box ............................................................................................................... 122
9-3 Groups and Threshold Configuration Dialog Box ............................................................................. 122
9-4 Groups and Threshold Configuration Dialog Box Thresholds Tab Page .............................................. 123
9-5 Create Thresholds Tab Page .......................................................................................................... 124
9-6 Expression Dialog Box .................................................................................................................. 125
9-7 Time Parameters Dialog Box .......................................................................................................... 126
9-8 Monitoring Period Dialog Box ....................................................................................................... 127
9-9 Setting the Severity Level ............................................................................................................... 128
9-10 Message Dialog Box .................................................................................................................. 128
9-11 Create Group Dialog Box ........................................................................................................... 130
9-12 Starting and Stopping Alerts ........................................................................................................ 132
9-13 Alert Alarm Log Tab Page ........................................................................................................... 133
9-14 Alarm Information Dialog Box ..................................................................................................... 134
9-15 View Window ........................................................................................................................... 134
9-16 Alert Alarm Status Tab Page ........................................................................................................ 135
9-17 Threshold Information Dialog Box ................................................................................................ 136
9-18 Configure Alarm Notification Dialog Box ...................................................................................... 137
9-19 E-mail Settings Dialog Box ........................................................................................................... 138
10-1 Scheduler Tab Page ................................................................................................................... 141
10-2 Add Job Dialog Box ................................................................................................................... 143
10-3 Show Job Dialog Box ................................................................................................................. 144
10-4 Modify Job Dialog Box ............................................................................................................... 145
11-1 Adding New DataSet ................................................................................................................. 147
11-2 Add Insight Metric Dialog Box ..................................................................................................... 148
11-3 DataSet Tab Page ...................................................................................................................... 149
11-4 Time Parameters Dialog Box ........................................................................................................ 149
11-5 Node Menu – Print DataSet Configurations ................................................................................... 151
11-6 Printer Selection Dialog Box ........................................................................................................ 151
11-7 Schedule Export Dialog Box ........................................................................................................ 152
11-8 DataSet Window ....................................................................................................................... 153
12-1 Display Agent Navigator Tab Page .............................................................................................. 154
13-1 Build New Metric Dialog Box ...................................................................................................... 156
13-2 Build New Metric Dialog Box ...................................................................................................... 157
13-3 Modify Metric Dialog Box ........................................................................................................... 159
14-1 Display Agent Status Bar Finder Icon ............................................................................................ 160
14-2 Finder Dialog Box ...................................................................................................................... 160
14-3 Finder Dialog Box with Search Results .......................................................................................... 161
14-4 Copy to Dashboard Dialog Box ................................................................................................... 162
15-1 OVNPM Display Agent Message Box .......................................................................................... 163
15-2 OVNPM Display Agent Welcome Page Remove Option ................................................................. 163
15-3 Confirm Uninstall Box ................................................................................................................. 164
Preface
HP Performance Agent for NonStop (OVNPM), formerly known as HP OpenView NonStop Server Performance
Management, is an out-of-the-box solution that provides performance monitoring of HP NonStop servers. The
software is a natural extension of HP Operations (formerly known as HP OpenView) and provides you with true
end-to-end management of your NonStop environment. The various OVNPM Guides provides information about
how to get started and use the product.
Before You Begin
Before reading the documentation, you are expected to have a basic understanding of the Windows Operating
System, as well as the HP NonStop environment. Familiarity with the HP NonStop Distributed Systems
Management software, especially the Event Management Service, would be helpful.
Audience
This guide is intended for the following two types of users.
•
Administrators, who plan, set up, and maintain OVNPM and HP Operations Manager.
•
Operators, who perform daily tasks using OVNPM and HP Operations Manager.
Goals of Documentation
After reading this guide, you should know the following information.
•
Explanation of the OVNPM graphical user interface on the personal computer
•
Procedures for using the different modules and features of OVNPM
Organization
The guide is organized as follows:
Sr. No
Chapter Name
Description
Chapter 1
Introducing OVNPM Display Agent
Presents an overview of OVNPM Display agent
along with its features.
Chapter 2
Installing OVNPM Display Agent
Presents the steps to install OVNPM Display
Agent on a Windows computer.
Chapter 3
Getting Started
Gives detailed information on creating and
connecting to a node, communicating with the
host machine, using the desktop window and
starting a new session.
Chapter 4
OVNPM Display Agent
The InterfaceCovers the various OVNPM
Display Agent interface components, such as
menus and toolbars.
Chapter 5
Dashboards
Describes how to open, modify, create, and
print dashboards.
Chapter 6
Using Views SystemInsight
Describes in detail how to create, modify,
display and print views.
Chapter 7
Analyzing Trends SystemTrend
Explains SystemTrend views and how to create,
open, copy, and customize the appearance of
these views
Chapter 8
Using Tabular Data SystemReport
Describes how to open, sort, and delete a
report and how to build a report from metrics.
Preface 11
Sr. No
Chapter Name
Description
Chapter 9
Using SystemAlert
Describes how to open SystemAlert. It explains
what threshold and threshold groups are and
how to configure and manage them. It includes
how to activate thresholds and alarm reception,
display the alarm log and the alarm status,
define alarm behavior and detect runaway
process loops.
Chapter 10
Managing Scheduled Jobs
Describes how to schedule a new job, carry out
a scheduled job, examine the contents of a
scheduled job, remove, and purge jobs.
Chapter 11
Correlating Curves SystemInsight
Explains how to use the correlation feature and
to copy correlation results into a dashboard. It
also gives examples of correlation use.
Chapter 12
Exporting Data: DataSet
Explains how to create, open, and modify a
DataSet. It also specifies how to schedule
DataSet results for export and how to define
data extraction parameters.
Chapter 13
Real-Time Monitoring: Navigator
Describes the Navigator
Chapter 14
Creating SystemInsight Metrics
Describes how to combine SystemInsight
metrics to form a new metric, select the metrics
to combine, modify, and delete combined
metrics.
Chapter 15
Availability
Explains how to gain access to detailed
information concerning devices and
applications.
Chapter 16
SystemCloseup
Explains how to open SystemCloseup, export a
report to a data file, and print a report.
Chapter 17
SystemAccounting
Explains how to open SystemAccounting,
request disc usage and spooler reports, export
a SystemAccounting report to a data file, and
print a report.
Chapter 18
Using Finder
Explains how to start and close the finder, to
understand search results and to copy them to
a dashboard.
Chapter 19
Uninstalling OVNPM Display Agent
Explains how to uninstall OVNPM Display
Agent from a Windows computer
Appendix A
Managing the Server Using Display
Agent
Describes the backup solution for diagnostic
purpose if the Host Management Client fails
OVNPM Documentation Map
HP Performance Agent for NonStop (OVNPM) provides a set of manuals and online help that help you use the
product and understand the concepts underlying the product. This section describes what information is available
and where you can find it.
Electronic Versions of the Manuals
All manuals are available as Adobe Portable Document Format (PDF) files in the documentation directory on the
OVNPM product CD-ROM. All manuals are also available in the HP web server directory. For details, contact the
appropriate HP support service.
Preface 12
OVNPM Manuals
This section provides an overview of the OVNPM manuals and their contents.
Manual
Description
Media
OVNPM Concepts Guide
Explains OVNPM features, functions, benefits, architecture, and data
flow.
PDF
OVNPM Display Agent Guide
Explains the OVNPM Display Agent interface and the instructions on
how to install and use it effectively. Also presents the product and
illustrates all the facets of the software.
PDF
OVNPM Installation Guide
Explains how to install and uninstall OVNPM Server components. Also
includes the steps for Navigator Deployment on Jetty
PDF
OVNPM Navigator Guide
Explains OVNPM Navigator and how to use the component
effectively.
PDF
OVNPM Report Portal User and
Installation Guide
Explains the OVNPM Report Portal interface and the instructions on
how to install and use it effectively. Also presents the product and
illustrates all the facets of the software
PDF
OVNPM Server Management Guide
Explains how to work with OVNPM Server components.
PDF
OVNPM Server Monitoring Guide
Explains how to configure OVNPM Server components.
PDF
XPNET Plug-in Manual
Explains how to install and configure XPNET Plug-in for the OVNPM
environment.
PDF
About OVNPM Online Help
This section provides an overview of the OVNPM Online Help and their contents
Help File
Description
OVNPM Host Installation Client
Provides information on OVNPM Host Installation Client
OVNPM Host Management Client
Provides information on OVNPM Host Management Client
OVNPM Navigator
Provides information on OVNPM Navigator.
Preface 13
1 Introducing OVNPM Display Agent
1-1 OVNPM Display Agent
OVNPM Display Agent provides performance and capacity management with four principal processes that
enable various departments to access crucial information concerning the diverse areas of production quality. The
Display Agent is designed to fully support the following activities.
•
Real-Time Supervision
Dashboards and alarms permit immediate reactions to production problems that have just occurred,
before degradation of service occurs.
•
In-Depth Analysis
Drill-down features of real-time or replay information enables system support to investigate production
anomalies and eliminate recurring incidents by pinpointing their causes.
•
Daily Production Control
Resource consumption profiles allow continuous improvement of production quality and an increase in
service levels. System tuning enables continuous improvement in availability and response times.
•
Trend Analysis
Reports on business and production trends permit high level management to gain control over change
and optimize the return on IS investment.
It also provides a broad range of capabilities, including a replay for after-the-fact troubleshooting, complex
alarms management with multi-criteria thresholds, automated load balancing, automated performance events
correlation, and a user-defined interface for direct application monitoring.
Distributed OVNPM (DSV) enables a user to have a view of all machines from a single Display Agent.
1-2 Display Agent Operating Components
The OVNPM Display Agent has two operating components:
•
Data Server that runs on the host computer.
•
Display Agent that runs at a client personal computer.
The Data Server monitors the host and collects data about its status. It supplies this data to Display Agent clients
on request.
The Display Agent is the Windows-based graphical user interface. It requests information from the Data Server to
satisfy end-user requests and then displays this information in an organized and meaningful way.
1-3 Display Agent Modules
The Display Agent modules give you different outlooks of your system. The following list describes the functions of
these various modules.
•
SystemInsight gives you current and recent short-term information in easy to understand graphical displays.
The graphical displays make it easy to identify abnormal system behavior. Once you identify a situation,
you can view all the data items that relate to it. The correlation feature of SystemInsight is not available in
the distributed access mode (DSV).
•
SystemReport shows detailed data in tabular reports that complement the graphic displays of SytemInsight.
SystemReport is the tool you use to analyze data that was used to calculate a graphic display.
•
SystemTrend shows patterns of usage over a broad period of time. SystemTrend is the trend analysis tool.
You can analyze past performance patterns to help in capacity planning, resource allocation, scheduling,
and problem diagnosis. SystemTrend complements SystemInsight. SystemInsight monitors current and past
performance. SystemTrend reports on behavior across historical periods.
•
SystemAlert issues alarms when the configured thresholds are reached. SystemAlert is the alarm system. The
alarms displayed by SystemAlert complement the real-time supervision capability provided by supervision
dashboards. You can set threshold conditions for certain events. SystemAlert issues an alarm when the
threshold is reached. In the distributed access mode (DSV), you can only receive alarms. You cannot define
or change any threshold parameter.
Introducing OVNPM Display Agent
14
•
SystemCloseup captures detailed performance information for analysis. With SystemCloseup you can focus
attention on a particular entity over a discrete period of time. You can measure behavior for activities
taking place on that entity along with the affects of related system activities upon it. The entity can be a
CPU, a file, a process, or a disk. This module is not available in the distributed access mode.
•
SystemAccounting provides detailed disk and spooler usage reports. You can observe usage by groups or
by individual users within groups. This module is not available in the distributed access mode.
1-4 Features
OVNPM Display Agent features provide you with additional information concerning your system. The following
list describes the functions of the various features.
•
Dashboards display multiple views in a single window. Each dashboard contains a set of OVNPM views
and reports that you can manage as a single unit. Dashboards simultaneously display the individual
elements. Alternatively, dashboards display views one at a time in an automatic cycle.
•
Correlation helps determine the cause, or effect, or both of unusual situations, which appear in a
SystemInsight view. It is an automatic investigative tool that helps you pinpoint areas you need to explore.
•
DataSet allows you to combine collected data into one report from SystemInsight, or SystemTrend, or both.
The Display Agent displays the results in tabular form, and can export the data to another application. You
can use DataSet results in a spreadsheet of a program such as MS-EXCEL.
•
Scheduler manages all the printing and exporting of data. It displays the status of all the Dashboards and
DataSets that you have scheduled to print and export.
•
Finder locates the occurrences of a particular character string in the basic elements of operation.
Introducing OVNPM Display Agent
15
2 Installing OVNPM Display Agent
2-1 Prerequisites
Before installing OVNPM Display Agent, ensure that the following tasks have been accomplished:
1.
The OVNPMDisplayAgentInstallation.exe is available on the computer.
2.
The user installing OVNPM Display Agent must have Administrator rights/privileges on the computer.
(Administrator privileges are not required for individuals using OVNPM after it is installed).
3.
Before starting the installation, it is recommended that you exit from any other Windows programs that are
running.
2-2 Contents of the Installation Exe
The OVNPMDisplayAgentInstallation.exe contains components necessary to install the OVNPM Display Agent on
a Windows computer. This self extracting exe file Includes the following:
Display Agent (For Windows (32/64 bit)
This is the Graphical User Interface of OVNPM.
Technical Info Report (For 98/NT/2000/XP)
This generates the OVNPMINFO.TXT file, used for Display
Agent maintenance.
OVNPM Display Agent Guide
Contains detailed installation and user information on
OVNPM Display Agent.
XP/Vista/Windows7 or Server 2003 /2008)
Installing OVNPM Display Agent 16
2-3 Installing Display Agent
1.
Execute the OVNPMDisplayAgentInstallation.exe provided in the installation package. The Install Shield
prepares the Setup program for use and the OVNPM Display Agent Setup Welcome page is displayed.
Figure 2-1 OVNPM Display Agent Setup – Welcome Page
2.
Click the Next button to continue with the Setup program. The License Agreement page is displayed.
Figure 2-2 OVNPM Display Agent Setup – License Agreement Page
Installing OVNPM Display Agent 17
3.
Review the software license agreement and click the Yes button to continue. The Check Setup Information
page is displayed.
Figure 2-3 OVNPM Display Agent Setup – Check Setup Information Page
NOTE: You should check the location of the directory where Display Agent is to be installed. In case the
location has to be changed after installation, you will have to reinstall the product.
4.
The Check Setup Information page displays the information that the user had entered for confirmation. Use
the Back button to change the installation directory. To continue, click the Next button. The OVNPM Display
Agent Setup Completed page is displayed.
Figure 2-4 OVNPM Display Agent Setup – Setup Completed Page
5.
Click the Finish button to complete the Setup process.
Installing OVNPM Display Agent 18
2-4 Modifying OVNPM Display Agent
1.
Execute the OVNPMDisplayAgentInstallation.exe provided in the installation package. The Install Shield
prepares the Setup program for use and prompts you to close all the OVNPM components running on the
computer.
Figure 2-5 OVNPM Display Agent Information Box
2.
3.
4.
5.
6.
7.
8.
2.
Click the OK button. The OVNPM Display Agent Maintenance Welcome page is displayed.
Figure 2-6 OVNPM Display Agent Maintenance – Welcome Page
3.
The page has the Modify, Repair and Remove options. The Modify option is selected by default. We
strongly recommend that you use the Modify option.
Installing OVNPM Display Agent 19
4.
Click the Next button to continue with the maintenance process. The Select Features page is displayed with
a list of all the installed OVNPM components.
Figure 2-7 OVNPM Display Agent Maintenance – Select Features Page
5.
The page also provides the information about the space required for the modifications. Select the OVNPM
components you want to install and click the Next button.
NOTE: If you clear an option that was already selected, the Install Shield will REMOVE that feature from the
computer.
Installing OVNPM Display Agent 20
The OVNPM Display Agent Setup Completed page denotes the completion of the installation process. Click the
Open Readme file check box to view the Readme file.
Figure 2-8 OVNPM Display Agent Maintenance – Setup Completed Page
6.
Click the Finish button to complete the setup process.
Installing OVNPM Display Agent 21
3 OVNPM Display Agent: The Interface
The following figure illustrates the interface of the OVNPM Display Agent.
Figure 3-1 OVNPM Display Agent GUI
When you connect to the OVNPM Display Agent, the program opens to the tabbed pages of its desktop window.
Each tab represents a component of the product and displays a different desktop window. Through each window
you define real-time supervision of your host system.
OVNPM Display Agent: The Interface
22
3-1 Menu Bar
The first bar at the top of the Display Adapter window is the menu bar, giving access to various menus. The
menus available are Node, Options, Tools, and Help.
Figure 3-2 OVNPM Menu Bar
3-1-1 Node Menu
This is the first menu on the Menu bar. The various options available in this menu are as follows.
•
Connect: Select this option to connect to a HP NonStop Host.
Figure 3-3 Display Agent Node Menu
The OVNPM Node Selection dialog box is displayed.
Figure 3-4 OVNPM Node Selection Dialog Box
•
Disconnect: Select this option to disconnect from the HP NonStop Host.
OVNPM Display Agent: The Interface
23
•
Trace: Select this option for tracing. Clicking the option displays the Trace window for the connected
node.
Figure 3-5 Node Trace Window
•
About Connection: Select this option to view the Node Connection information box for the connected HP
NonStop Node, with the information related to the current connection.
Figure 3-6 About Connection Message Box
•
Save Configuration: Select this option to save the current configurations.
•
Export: Select this option to export the results of an investigation. You can use the Export menu to
export the following.
•
•
•
Dashboard Configurations
•
View/Metric Configurations
•
Alert Status and Log
•
DataSet Configurations
Print: Select this option to print the results of an investigation. You can use the menu to print the
following:
•
Dashboard Configurations
•
View/Metric Configurations
•
Alert Status and Log
•
DataSet Configurations
Exit: Select this option to exit from the OVNPM Display Agent application.
OVNPM Display Agent: The Interface
24
3-1-2 Options Menu
This is the second menu on the Menu bar. The various options available in this menu are as follows.
•
Settings: Select this option to view the Settings dialog box for the corresponding node.
Figure 3-7 Display Agent Options Menu
You can configure printers, style sheets, alarm notifications, units, and navigator using this dialog box.
Figure 3-8 Settings Dialog Box
OVNPM Display Agent: The Interface
25
•
Server Messages: Select this option to view the Server Messages window for the corresponding node.
This window can be used to get messages from the HP NonStop Server.
Figure 3-9 Server Messages Window
•
Icons: Select this option to change domain icons.
•
Export Mode: Select this option to run the application in the expert mode.
•
Password: This option enables the user to change the password.
3-1-3 Tools Menu
This is the third menu on the Menu bar.
Figure 3-10 Display Agent Tools Menu
The various options available in the Tools menu are as follows.
•
New Session: This option allows you to monitor several nodes at one time. If you are already using
OVNPM, then you can select the New Session option from the Tools menu to connect to another
OVNPM node. This command allows you to start another local session from any open OVNPM module
or feature.
OVNPM Display Agent: The Interface
26
•
Finder: Select this option to view the Finder dialog box for the corresponding node. The Finder dialog
box is used to perform searches and access monitoring options for nodes.
Figure 3-11 Finder Dialog Box
•
Show Missing Units: Select this option to list missing units in the referenced dashboards, views or userdefines metrics.
•
Bring to Front: Select this option to toggle between various sessions of Display Agent.
•
Tile: Select this option to display various sessions of Display Agent in a tiled format.
•
Availability: Select this option to get status information for devices and applications.
•
SystemAccounting: Select this option to create DISK and SPOOLER usage reports.
•
SystemCloseup: Select this option to create performance information reports.
NOTE: The Availability, SystemAccounting, and SystemCloseup features are not available OVNPM
1.6 Release onwards.
OVNPM Display Agent: The Interface
27
3-1-4 Help Menu
This is the last menu on the Menu bar.
Figure 3-12 Display Agent Help Menu
The various options available in the Help menu are as follows.
•
Help on Display Agent: Select this option to access online help on Display Agent.
•
Help on Server: Select this option to access online help on Server.
•
What’s This: Select this option to get help on a component in the Display Agent window by clicking on
it.
•
How to Use Help: Select this option to view information on how to use the OVNPM online help
effectively.
•
About OVNPM: Select this option to view the version numbers of the various OVNPM components and
the copyright and license information.
OVNPM Display Agent: The Interface
28
3-2 Window Tabs
The desktop window contains tabs, which represent the different modules and features of the OVNPM Display
Agent product.
Figure 3-13 Display Agent Window Tabs
The various tabs available in the Display Agent are as follows.
•
Dashboard
•
Insight
•
Trend
•
Report
•
Alert
•
Scheduler
•
Correlation
•
DataSet
•
Navigator
When you first connect to OVNPM, the Dashboard desktop window appears by default on the page. This feature
permits you to examine several graphical displays at one time. To open the desktop window of a different
OVNPM module or component, click its corresponding tab.
For example, when you first open to the Dashboard tab, there are two areas.
•
The Dashboards area, containing icons, which represent the names of different dashboards, and
buttons.
•
The Contents area listing the graphical displays that comprise a selected dashboard.
3-3 Status Bar
The Status bar can be seen at the base of window.
Figure 3-14 Display Agent Status Bar
The status bar contains
icon called as Finder button. Use it to locate a particular view, metric or unit.
OVNPM Display Agent: The Interface
29
4 Working with Display Agent
4-1 Starting the Display Agent
The Display Agent is the 32/64-bits OVNPM Graphical User Interface, which runs under Windows XP, Windows
Vista, Windows7 or Server 2003 /2008. You can open all OVNPM modules along with the Navigator from the
Display Agent.
1.
To start the Display Agent, click the Start  Programs  HP OVNPM  Display Agent  Display Agent
option. The OVNPM Node Selection dialog box is displayed.
Figure 4-1 OVNPM Node Selection Dialog Box
2.
Select a node to connect, from the list or click the Create button to create a new node connection.
Working with Display Agent
30
4-2 Creating a Node
The first time you connect to a new host, you must create a node. A node is the name of a connection site.
To create a node, perform the following steps.
1.
Open the OVNPM Node Selection dialog box and click the Create button. The OVNPM Create Node dialog
box is displayed.
Figure 4-2 OVNPM Create Node Dialog Box
2.
Enter a name for the node in the Label box. The name can contain up to 15 alphanumeric characters.
3.
Enter the description for the node in the Description box.
4.
Select the type of Host using the Host Type drop-down box. The list of hosts available for connection
depends on the selected communication protocol.
5.
Select the AdapterWinSocket32 communication protocol from the Adapter Type list box and click the OK
button. The other options available in the box are for diagnostic purpose and are not recommended.
Working with Display Agent
31
The OVNPM Node Selection dialog box is displayed with the name of the new node, as shown in the following
figure.
Figure 4-3 OVNPM Node Selection Dialog Box
6.
6.
Click the OK button to complete the procedure.
Working with Display Agent
32
4-3 Connecting to a Node
To connect to a node, perform the following steps.
1.
Open the Display Agent dialog box, and select the Connect option from the Node menu. The OVNPM Node
Selection dialog box is displayed.
Figure 4-4 OVNPM Node Selection Dialog Box
2.
Select the node and click the OK button. The Connect dialog box is displayed.
Figure 4-5 Connect Dialog Box
3.
Enter the Host address and the port number in corresponding fields, and click the OK button. For
information regarding host and port numbers, contact your system administrator.
NOTE: When you start a session, if any units are missing from the configuration that are referenced in
dashboards, views, DataSets or user-defined metrics, a dialog box opens to notify you of the missing
information. You can also search for missing units at any time during a session. To display a list of missing
units, from the Tools menu, select Show Missing Units.
Working with Display Agent
33
4-4 Starting the Display Agent on a Node
You can directly start the Display Agent on a node using a command line or a shortcut icon that you create. To
start the Display Agent with a node parameter, enter the following command on the command line.
<path to OVNPM.exe> node=NodeName
You can create a shortcut icon to start the Display Agent on the node. The features of the shortcut depend on
your connection type.
•
For Telnet connection: You can select the Automatically Run Logon Script option, the Display Agent will
execute the logon script on the specified node. Otherwise, your shortcut opens the appropriate
connection dialog box for the specified node.
If the session on the node is already started, the shortcut brings the session window to the front.
•
For TCP/IP connection: The shortcut displays the Display Agent on the node.
Before you create your shortcut, if you are using a Telnet connection to connect to a node, verify that the
Automatically Run Logon Script option is selected.
To create a shortcut, from the site selection dialog box, click Create Shortcut. A shortcut icon is displayed on the
Windows NT desktop, or in the specified directory for Windows 95/98.
Working with Display Agent
34
5 Dashboards
5-1 What are Dashboards?
A dashboard is a set of OVNPM views and reports that you manage as a group.
There are the following two types of dashboards in the Dashboard desktop window.
•
Server-Defined or Predefined dashboards, represented by the
•
User-Defined dashboards, represented by the
icon.
icon.
You can modify user-defined dashboards; however, you cannot modify server-defined dashboards. Serverdefined dashboards are created during the installation phase, and are automatically sent to the Display Agent.
You can create any number of user-defined dashboards. This enables you to keep a series of display sets
available, each tailored for particular requirements or groups of resources.
Within a user-defined dashboard you maintain full control over the individual views and reports, such as their
display mode, appearance, and granularity of detail. All functions that apply to individual views and reports are
accessible from a dashboard.
A dashboard can include any combination of display elements from the OVNPM components as listed in the
following table.
Table 5-1 Display Elements Combination
OVNPM Component
Display Element (View)
Data
SystemInsight
Five Display Modes
Current and Recent Past
SystemReport
Tabular Data
Current and Recent Past
SystemTrend
One Display Mode
Historical Trend Analysis
Within the context of a dashboard, all display elements that you include in a dashboard are known as views.
Since dashboards are an ideal medium to provide monitoring of many dynamic resources simultaneously, they
often contain real-time graphic views.
You can designate a dashboard for OVNPM to open automatically whenever the Display Agent is started.
Dashboards 35
A dashboard normally displays all individual elements simultaneously. However, you have the option to display
one or several view(s) at a time.
Figure 5-1 Dashboard
5-2 Predefined Dashboards
Predefined dashboards are created on the server. By default, OVNPM has eight predefined dashboards.
The following table lists the predefined dashboards appearing on the Dashboard desktop window.
Table 5-2 OVNPM Dashboards
Dashboard
Description
Principal Resources
Displays resources such as Disks, Line, Netline, Memory and TMF in a live
time reference.
Most Consuming Processes
Displays the processes that use the most CPU time for all CPUs in a live time
reference.
Weekly CPU-Busy
Displays the CPU-Busy of the node for 8 days.
Weekly Highest CPU Busy
Displays the highest CPU-Busy of the node for 8 days.
Weekly Lowest Free Memory
Displays the lowest CPU-Busy of the node for 8 days.
Weekly Low-Pin Processes
Displays the low-pin processes number of the node for 8 days.
Weekly High-Pin Processes
Displays the high-pin processes number of the node for 8 days.
Monthly CPU Availability
Displays the CPU availability for the current month.
Dashboards 36
5-3 Opening a Dashboard
To open a dashboard, perform the following steps.
1.
On the Dashboard tab in the Display Agent window, select a dashboard icon in the Dashboards area.
Figure 5-2 Dashboard Tab Page
2.
To open the selected dashboard, click the Open button or double-click the icon.
Dashboards 37
A dashboard window, which contains each view, appears on the page. OVNPM also displays a dashboard
toolbar that represents commands from the Dashboard and Window menus.
Figure 5-3 Principal Resources Dashboard
NOTE: You cannot open a dashboard if units are missing. If any of the units is missing from a dashboard, an
error message is displayed. To view missing units, from the Tools menu, select the Show Missing Units option.
Dashboards 38
5-4 Launching a Dashboard at Startup
OVNPM enables you to automatically open a specified dashboard each time you start the Display Agent.
To automatically open a Dashboard at startup, perform the following steps.
1.
Open the OVNPM Display Agent window and select the Dashboard tab page.
2.
From the Dashboards area, click the Select button, as shown in the figure.
Figure 5-4 Dashboard Tab Page
3.
The Select Dashboard to Launch at Startup dialog box is displayed with the list of available dashboards.
Figure 5-5 Select Dashboard to Launch at Startup Dialog Box
4.
Select the dashboard that you want to launch at startup, and click the OK button.
Dashboards 39
5.
The newly selected dashboard is displayed with a yellow line inside the icon associated with the
dashboard, as shown in the following figure.
Figure 5-6 Monthly CPU Availability Dashboard Selected for Automatic Display at Startup
6.
To cancel automatic launching of a dashboard, select the None button in the Select Dashboard to Launch at
Startup dialog box.
Dashboards 40
5-5 Organizing Views in a Window
You can organize the views of a dashboard into a single window for a global view of the activities that you want
to monitor. You have the following three options from the Window menu of the selected dashboard for displaying
views.
•
Cascade
•
Tile Horizontally
•
Tile Vertically
When you display views using Tile Horizontally or Tile Vertically, you have the following three filtering choices.
•
By Creation Order
•
By Name
•
By Date
Alternatively, you have the following icons on the Dashboard window Toolbar that access the same viewing
options.
Table 5-3 Dashboard Toolbar Icons
Window Icons
Action
Displays cascade windows.
Displays tile windows by name horizontally.
Displays tile windows by name vertically
When you organize views using the icons, you can only filter the views by name for Tile Horizontally and Tile
Vertically. There are no filtering options for the Cascade option.
Dashboards 41
To organize views in a dashboard window, perform the following steps.
1.
Select the dashboard to be viewed, and click the Open button. The views of the corresponding dashboard
open in a dashboard window.
2.
From the Window menu, select a viewing option. The shortcuts for the various options are also available on
the Toolbar as icons.
OVNPM organizes the views according to your selection.
Figure 5-7 Organizing Views in a Dashboard Window
Dashboards 42
5-6 Creating a User-Defined Dashboard
OVNPM provides eight predefined dashboards, but you can build customized dashboards as per your business
requirements.
5-6-1 Creating a Dashboard
To create a new dashboard, perform the following steps.
1.
Click the Create button in the Display Agent window Dashboard tab page. A new dashboard icon appears
in the window.
2.
Type the name of the new dashboard next to the insertion point. After you have created the dashboard,
you can add the required views.
5-6-2 Creating a Dashboard from an Open View
To create a new dashboard from an Open View, perform the following steps.
1.
Open a view. For details, refer to the Opening a View topic.
2.
From the View menu, select the Copy to Dashboard option. The Copy to Dashboard dialog box is
displayed.
Figure 5-8 Copy to Dashboard Dialog Box
3.
To add the open view to a new dashboard, click the Create button in the Copy to Dashboard dialog box.
The Create Dashboard dialog box is displayed.
Figure 5-9 Create Dashboard Dialog Box
4.
Type the name for the dashboard in the Enter a dashboard name box and the click OK button.
5.
Alternatively, select a dashboard from the Dashboards box in the Copy to Dashboard dialog box and click
the OK button.
5-7 Renaming User-Defined Dashboards
To rename a dashboard, perform the following steps.
1.
Select the dashboard icon to be renamed in the Dashboards area in the Display Agent window Dashboard
tab page, and click the Rename button.
2.
Type the new name of the dashboard next to the insertion point.
Dashboards 43
5-8 Adding Views to User-Defined Dashboards
From the Dashboards area in the Dashboard tab page, select the dashboard icon to which the views are to be
added. When you select a dashboard, the corresponding views are displayed in the Contents area.
5-8-1 Adding Views without Opening the Dashboard
To add views without opening the dashboard, perform the following steps.
1.
Click the Add button in the Contents area in the Dashboard tab page.
Figure 5-10 Dashboard Tab Page – Add Button
The Add View dialog box is displayed.
Figure 5-11 Add View Dialog Box
Dashboards 44
2.
From the Type list, select the OVNPM component that contains the display element.
3.
Select a domain from the Domains list. The views associated with the selected domain appear in the
View(s) list box.
4.
Select a view from the View(s) list, and then click the Select button in the Add View dialog box.
5.
The selected view is added to the dashboard. Repeat the above steps to add more views to the dashboard.
Click the Close button in the Add View dialog box to close the dialog box after adding the required views.
After you select a view, there are two possible results.
•
If units are already assigned to the view metrics, the view is now added to the dashboard. If the view is
generic, and there is only one unit in the domain, the view for the single unit is added to the dashboard.
•
If the view is generic, the name of the view is followed by […] and there is more than one unit to select, the
Unit Selection dialog box is displayed. You must assign units to a view to add it to the dashboard.
Dashboards 45
5-8-2 Adding Views to an Open Dashboard
To add views to an open dashboard, perform the following steps.
1.
Select the Add option from the View menu in the Dashboard window. Alternatively, click the Add a view
icon on the dashboard Toolbar.
Figure 5-12 Dashboard Window – Add View Icon
The Add View dialog box is displayed.
Figure 5-13 Add View Dialog Box
Dashboards 46
2.
Select the view type, domain and view using the Type, Domains and View(s) boxes, respectively, and click
the OK button.
If units are already assigned to the metrics of the view, the view opens and starts displaying data. If the view is
generic, and there is more than one unit to select, the Unit Selection dialog box opens. In this case, select units
accordingly and click the OK button. The view is temporarily added to the dashboard.
To permanently add the view to the dashboard, click the Yes button in the confirmation dialog box to save the
dashboard changes. The time reference of the new view is the same as the selected view of the open dashboard.
Dashboards 47
5-9 Removing Views from User-Defined Dashboards
5-9-1 Removing Views from a Dashboard
OVNPM allows you to delete views from the user-defined dashboards. To remove views from a Dashboard,
perform the following steps.
1.
From the Dashboards area, select the dashboard from which a view has to be deleted.
2.
The Contents area displays the views of the selected dashboard. Select the view to be deleted from the list
of views and click the Remove button.
Figure 5-14 Dashboards Tab Page – Remove Button
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
3.
A confirmation box is displayed. To remove the selected view, click the Yes button.
Figure 5-15 Remove View Confirmation Box
5-9-2 Removing Views from an Open Dashboard
To remove any view from an open dashboard, select the view, and choose the Remove option from the View
menu. Alternatively, click the
icon in the dashboard Toolbar, or close the window.
Dashboards 48
5-10 Time Periods of Views
5-10-1 Linking Time Periods of Views
When you link the views in a dashboard, you can change the time reference, the time period, or the time interval
of all the views of an open dashboard.
For example, the current time period for one view is July 2003. You link time periods, and then select the
previous time period. If the time intervals of the views are identical, all the views in the dashboard will display
data for July 2003. OVNPM maintains compatibility among the views, if the time intervals of the views are not
identical. The dashboard will only link the views that have common time intervals.
To link dashboard time periods, perform the following steps.
1.
Select a dashboard in the Dashboard tab page and click the Open button. The views of the corresponding
dashboard open in a dashboard window.
2.
Select the Link Time option from the Dashboard menu in the Dashboard window.
Figure 5-16 Dashboard Menu – Link Time Option
TIP: The shortcut for the Link Time option is available on the Toolbar as the
icon.
Dashboards 49
3.
Select any of the following choices from the Options menu.
a. Time Reference: To specify a time reference, select the Time Reference option from the Options menu.
This opens the Time Reference Selection dialog box, which lists 20 previous time references used.
Figure 5-17 Time Reference Selection Dialog Box
If the time reference you need appears in the list, select it and then click the OK button. The view
changes to display data for the selected time period. If the time reference and interval you need are not
included in the list, you can add a new reference.
For details refer to the Creating New Time Reference topic.
b. Next Period or Previous Period: You can scroll back and forth between time intervals to view specific
information using the Next Period and Previous Period options, respectively. The shortcuts for the same
are available on the Toolbar as the Go to next time period and the Go to previous time period icons.
c.
Interval: Select the interval as Day, Month, or Year using the Interval option.
OVNPM moves the display of the dashboard views according to the selected command.
Dashboards 50
5-10-2 Creating New Time Reference
If the time reference and interval you need are not included in the list. To add a new reference, perform the
following steps.
1.
From the dashboard Options menu, select the Time Reference option. The Time Reference Selection dialog
box is displayed.
2.
Click the Create button. The Trend Time Reference dialog box is displayed.
Figure 5-18 Trend Time Reference Dialog Box
3.
Select the mode as History or Profile using the corresponding option buttons in the Mode area.
4.
Select a report interval using the Interval spin box. You can select any day, month, or year; however, day
is not an available selection for the profile mode.
5.
Select a report period using the Period box. You indicate the ending day for the month interval, and the
ending month for the year interval. For example, if the report interval is a month, and you want the report
to include all the days of the month, you need to select an ending day of 30 or 31 in the Period box.
6.
To change the right most hour in the view, select the new hour using the Wrap after Hour box.
7.
To exclude data for certain days or time periods from the view, select the days and time from the Hours
and Days list boxes in the Exclude area. You can select more than one hour and day from the list.
8.
Click the OK button to complete the process of creating a time reference.
Dashboards 51
5-10-3 Removing Time Reference
To remove a time reference, perform the following steps.
1.
From the dashboard window’s Options menu, select the Time Reference option. The Time Reference
Selection dialog box is displayed.
2.
Select the time reference to be deleted from the list and click the Delete button.
3.
The delete time reference confirmation box is displayed.
Figure 5-19 Delete Time Reference Confirmation Box
4.
Click the Yes button to delete the reference.
TIP: You can click the Delete All button in the Time Reference Selection dialog box to delete all the time
references.
Dashboards 52
5-11 Sharing Dashboards
When you create a user-defined dashboard, you can share that dashboard between several computers. This
option increases the accessibility of user-defined dashboards among users.
The following procedures explain how to share dashboards with other computers and how to gain access to
shared dashboards.
5-11-1 Sharing Dashboards with Other Computers
To share a dashboard with other computers, perform the following steps.
1.
From the Dashboards area, select the dashboard that you want to share.
2.
Click the Share button to access the Share menu. Select the Export option from the Share list, as shown in
the following figure.
Figure 5-20 Dashboards Tab Page – Share Menu
Dashboards 53
The Export Dashboard dialog box is displayed. The name of the dashboard appears in the File name text box,
with the file extension .dsh.
Figure 5-21 Export Dashboard Dialog Box
3.
Select the folder where you want to save the dashboard and click the Save button.
Dashboards 54
5-11-2 Accessing Shared Dashboards
To access a shared dashboard, perform the following steps.
1.
Click the Share button in the Dashboard tab page.
2.
From the Share menu, select the Import option, as shown in the following figure.
Figure 5-22 Dashboards Tab Page – Share Menu
The Import Dashboard dialog box is displayed.
Figure 5-23 Import Dashboard Dialog Box
Dashboards 55
3.
Select the dashboard that you want to copy to your Dashboard window and click the Open button.
Dashboard files have the file extension .dsh. OVNPM copies the dashboard to your Dashboards box.
NOTE: If you access a shared dashboard that has views without units, these views become generic and you
must assign new units to these views.
For details, refer to the Selecting Units topic.
Dashboards 56
5-12 User-Defined Dashboards
For user-defined dashboards, you can save a description of the views in the dashboards. When you save
dashboards that contain user-defined metrics, a description of the formula of the metrics is saved in the file. You
can save this information to a text file. This information provides a summary of your dashboard configuration,
which you can use at a later time for backup purposes.
5-12-1 Saving/Exporting Dashboard Configurations
To export dashboard configurations to a text file, perform the following steps.
1.
From the Display Agent Node menu, select the Export option.
2.
Select the Dashboard Configurations option from the displayed Export menu., as shown in the following
figure.
Figure 5-24 Node Menu – Export Options
Dashboards 57
The Export Dashboards dialog box is displayed.
Figure 5-25 Export Dashboards Dialog Box
3.
Select a name and location for the text file and click the Save button.
Dashboards 58
5-12-2 Printing User-Defined Dashboard Configurations
To print a description of the configuration of user-defined dashboards, perform the following steps.
1.
Select the Dashboard tab page in the Display Agent window.
2.
From the Node menu, select the Print option, as shown in the following figure.
Figure 5-26 Node Menu – Print Options
3.
Select the Dashboard Configurations option from the displayed Print menu. The Printer Selection dialog box
is displayed.
Figure 5-27 Printer Selection Dialog Box
4.
Select a printer using the Printer drop-down box, and select the Style Sheet from the drop-down list.
5.
Specify other printer configurations using the Configure button and click the OK button.
Dashboards 59
5-13 Masking and Redisplaying Predefined Dashboards
OVNPM is delivered with eight predefined dashboards. These dashboards cannot be deleted. However, when
you create user-defined dashboards, you may no longer need the original predefined dashboards.
5-13-1 Masking Predefined Dashboards
To mask or hide any predefined dashboards, perform the following steps.
1.
Click the Mask button in the Dashboards tab page. The Mask Dashboards dialog box is displayed. The
check boxes corresponding to all the dashboards, which are currently displayed, are selected.
Figure 5-28 Mask Dashboards Dialog Box
2.
From the Predefined Dashboards list box, clear the check boxes of the dashboards that you want to mask.
Click the Hide All button to mask all dashboards.
3.
Click the OK button. The dashboards disappear from the Dashboard tab page.
5-13-2 Redisplaying Predefined Dashboards
To redisplay any predefined dashboards, perform the following steps.
1.
Click the Mask button in the Dashboard tab page. The Mask Dashboards dialog box is displayed.
2.
From the Predefined Dashboards box, select the dashboards that you want to redisplay. To display all the
dashboards, click the Show All button.
3.
Click the OK button. The dashboards are redisplayed in the Dashboard tab page.
Dashboards 60
5-14 Printing from Dashboard
5-14-1 Printing a View
To print a view from dashboards, perform the following steps.
1.
From an open dashboard, click the window of the view you want to print.
2.
Select the Print option from the View menu. This displays the Printer Selection dialog box.
Figure 5-29 Printer Selection Dialog Box
3.
Select a printer using the Printer drop-down box.
4.
To change printers or review printing options, click the Configure button.
Select the Style Sheet from the drop-down list, and click the OK button.
To print all the views in the dashboard, select the Print All option from the Dashboard menu. Alternatively, click
the
icon on the dashboard Toolbar.
Dashboards 61
5-14-2 Printing Multiple Views
In a dashboard, you can print from one to nine views per page. By default, views appear on a page by groups
of nine. You can choose to print a specific number of views on each page, or you can print the same number of
views on each page.
1.
Select the Edit Layout option from the Dashboard menu. The shortcut for the same is available on the
Toolbar
icon. The Edit Layout dialog box is displayed. You can customize the printing of views from
this dialog box.
Figure 5-30 Edit Layout Dialog Box
2.
Specify the page titles for the various pages using the Title box in the Edit Layout dialog box.
3.
Use the
4.
Use the various icons in the Views area to specify the number of views to be printed per page.
and
icons to add and delete dashboard pages from printing.
Table 5-4 Views Area Icons
Icons
Explanation
Prints one view on each page
Prints two views on each page
Prints four views on each page
Opens a dialog box to choose one to nine views per page
5.
Click the
and
icons to determine the page on which a particular view is to be printed by moving
the view up or down the list displayed in the Layout box.
6.
Click the OK button.
To print several views on a page, from a closed dashboard, click the Edit Layout button in the Contents area on
the Dashboard tab page in the Display Agent window.
Dashboards 62
5-14-3 Scheduling Automatic Dashboard Printing
You can schedule the printing of all the windows in a dashboard at a future date.
To Schedule automatic printing, perform the following steps.
1.
Open the Dashboard and click the Schedule Printing option in the Dashboard menu. If the dashboard is
closed, select a dashboard icon, and click the Schedule button in the Dashboards area. This displays the
Schedule Printing dialog box.
Figure 5-31 Schedule Printing Dialog Box
2.
Enter the various print parameters, like Frequency, Date, Date Offset, Time, and Printer and click the OK
button.
3.
To view the print schedule of the dashboard, click the Scheduler tab in the Dashboard tab page in the
Display Agent window. The name of the dashboard and its printing parameters appear in the Scheduled
Jobs box. The graphical results will be printed at the designated time.
Dashboards 63
6 Using Views: SystemInsight
6-1 What is SystemInsight?
SystemInsight is an OVNPM component, which displays current system information in easy to understand
graphical and tabular displays. The displays are called views, which are a collection of related system metrics
that are displayed together. Metrics are informative interpretations developed from the observations made of host
activity.
There are two types of views: server-defined and user-defined. An extensive set of server-defined views is created
during the installation phase and automatically sent to the Display Agent.
You cannot modify server-defined views. But you can tailor views or build new ones to suit your own special
requirements. In the Insight tab page in the Display Agent window, the
icon precedes these user-defined views
OVNPM’s graphical displays make it easy to identify abnormal system behavior. Once you identify a situation,
you can view all the data items that relate to it. The actual data used to calculate metrics is always available for
further analysis.
6-2 Exploring Domains
In the Insight tab page, the Domain Hierarchy box displays all the entities that make up your host system. An icon
in this list represents a logical entity in the system hierarchy.
A domain is an entity that makes up your system such as a disk or CPU. A domain may contain other domains
called sub-domains, which have their own sub-domains.
To simplify the display, the parent domain can hide sub-domains. If the box next to a domain icon contains a
plus sign, there are sub-domains, but these elements are not displayed. To display hidden sub-domains, click the
box next to the icon. Continue this procedure until all the sub-domains are displayed.
Using Views: SystemInsight
64
6-3 Opening a View
Views belong to domains and are unit-specific or generic. A unit-specific view is permanently assigned actual
units (instances of a domain). A view that shows I/O activity metrics on the disc, $SYSTEM, is an example of a
unit-specific view. A specific unit is temporarily assigned to a generic view at the time the view is opened. The
names of generic views appear in the view selection list followed by the [..] symbol.
To open a view, perform the following steps.
1.
Open the Display Agent window and click the Insight tab. The Insight tab page is displayed.
Figure 6-1 Insight Tab Page
2.
From the Domain Hierarchy box, select a domain or sub-domain.
3.
The Views tab is displayed by default in the Insight tab page. The Available Views box displays a list of the
available views for the selected domain or sub-domain. Select a view name from the Available Views list.
4.
The metrics for the view display is in the View Contents box.
5.
Click the Open button to open the selected view.
Figure 6-2 %CPU-BUSY View
Using Views: SystemInsight
65
6-4 Selecting Units
After you open a view, there are two possible results.
•
If units are already assigned to the view’s metrics, the view displays data. If the view is generic and there is
only one unit in the domain, the view displays data for the single unit.
•
If the view is generic and there is more than one unit, the Unit Selection dialog box is displayed. You must
select units before displaying the view.
6-4-1 Temporarily Assigning Units to a Generic View
Generic views do not have assigned units. Each time you open a generic view, you must temporarily assign
units.
1.
Open a generic view. The Unit Selection dialog box opens.
Figure 6-3 Unit Selection Dialog Box
2.
Select a metric from the Selected Metrics list box. A list of available units for the selected metric is displayed
in the Units box.
3.
Select a unit from the Units box. The unit name is added to the metric.
4.
To define a different unit to each metric, repeat Step 2 and Step 3. To define the same unit to all metrics,
click the Set All button.
5.
Click the OK button. The view with data is displayed.
To clear the unit name for a single or several metrics at one time, select the metric(s) and click the Reset button.
The unit name is no longer associated with the selected metrics.
Using Views: SystemInsight
66
6-4-2 Permanently Assigning Units to a Generic View
You can change a generic view into a unit specific view. You can also modify the unit selection for unit specific
views.
To assign units to a generic view, perform the following steps.
1.
Select a generic or unit specific view in the Views tab page.
NOTE: Generic views are followed by the symbol [..]. Unit specific views are followed by the symbol <>. The
angle brackets contain the specific unit
2.
Click the Duplicate button. A copy of the view is added to the Available Views box. The duplicated view
has the same name as the original view followed by the word copy. A user icon precedes the duplicated
view.
3.
Select the duplicated view and click the Modify button. The Modify Insight View dialog box is displayed.
Figure 6-4 Modify Insight View Dialog Box
4.
Select a metric from the Selected Metrics list box.
5.
A list of available units is displayed in the Units list. Select a unit from the Units list. The unit name is
displayed next to the metric.
6.
To assign the same unit to all metrics in the view, click the Set All button. Otherwise, repeat Step 4 and
Step 5 for each metric.
7.
To clear the unit name for a single metric or several metrics at one time, select the metric(s) and click the
Reset button. The unit name is no longer incorporated into the selected metrics.
8.
Click the OK button to save the settings and close the Modify Insight View dialog box. The unit specific
view is displayed in the Available Views box in the Views tab.
6-4-3 Identifying Units: Distributed OVNPM System
With Distributed OVNPM (DSV), a user can have a view of all machines from a single Display Agent. The
machines must be part of a HP NonStop EXPAND network with a maximum of 12 simultaneous users. If this
feature is installed on your system, the unit names are prefixed by the machine name.
For details, refer to Chapter 10: Managing Distributed Servers in the OVNPM Server Guide.
Using Views: SystemInsight
67
6-5 Using Metrics to Build Views
A metric is a discrete measurement calculated from system values collected by OVNPM. When you use metrics to
build views, you have the ability to supervise related activities during the same time interval.
You can choose up to 16 real-time metrics to be shown at the same time in a view. However, each combined
metric is counted as only one metric. Selected metrics that form a combined metric are not counted individually.
For details, refer to the Selecting Metrics to Combine topic in Chapter 12: Creating SystemInsight Metrics.
If a domain does not have a view with the metrics that you need, you can create a new view or modify an
existing view to fit your requirements.
Refer to the Exploring Domains topic.
6-5-1 Copying an Existing View
When you copy a view, you can add, replace and remove metrics from an existing view to create a view. In this
case, select a view that contains a set of metrics that is similar to the view you want to create.
You cannot modify metrics in a view supplied by OVNPM. To change metric selection in the OVNPM view, you
must first copy the supplied view. For this, perform the following steps.
1.
Select a view from the Available Views list in the Views tab page. The metric(s) of the selected view are
displayed in View Contents box.
2.
Click the Duplicate button. A copy of the view appears in the Available Views box. The duplicated view has
the same name as the original view with the word copy and a number if you make more than one copy.
For example, if the name of the selected view is CPU-BUSY, the name of the duplicate view is CPU-BUSY
copy.
6-5-2 Adding Metrics to a User-Defined View
When you select a view, the View Contents box displays the metrics that make up the view. To add a metric to a
user-defined view, you must use the Modify Insight View dialog box.
To add Metrics to a user-defined view, perform the following steps.
3.
Select a user-defined view from the Available Views list.
4.
Click the Modify button. Display Agent displays the Modify Insight View dialog box. The Selected Metrics
box lists the metrics, which comprise the selected view.
5.
Select a metric from the Metrics box that is associated with the chosen domain.
6.
Click the Add button. The metric appears in the Selected Metrics box.
7.
The Units box displays the chosen domain with a list of available units. Select a unit for the new metric in
the Units box.
8.
The unit appears next to the metric. In the Selected Metrics box, you can change the order of the metrics.
Click the up or down arrows to move a selected metric to a different position in the Metric list.
9.
Click the OK button to close the dialog box. The selected view displays the new metric in the View Contents
box.
6-5-3 Adding a Metric to a View with Different Units
To add Metrics to a view with different units, perform the following steps.
1.
Select a user-defined view from the Available Views list box.
2.
Click the Modify button. The Modify Insight View dialog box opens.
3.
Select one metric, and then click the Add button.
4.
Select all the available units for that metric in the Units box.
5.
Click the Repeat button. The Selected Metrics box displays the same metric with each unit.
6.
Click the OK button.
NOTE: To gain access to metrics from other domains, select the alternative domain from the Metrics list in the
Modify Insight View dialog box. The Metrics list displays the corresponding metrics.
Using Views: SystemInsight
68
6-5-4 Replacing Metrics in a View
When you select a view, the View Contents box displays the metrics that make up that view. To replace a metric
in a view with another metric, you use the Modify Insight View dialog box.
To replace metrics in a view, perform the following steps.
1.
Select a user-defined view from the Available Views list.
2.
Click the Modify button. This opens the Modify Insight View dialog box.
3.
Select the metric that you want to replace in the Selected Metrics box.
4.
Select the new metric in the Metrics box and click the Replace button. The new metric replaces the selected
metric in the Selected Metrics box.
5.
Click the OK button.
6-5-5 Removing Metrics from a View
To remove a metric from a view, you use the Modify Insight View dialog box. Follow the instructions below to
remove metrics from view.
To remove metrics from a view, perform the following steps.
1.
Select a user-defined view from the Available Views list.
2.
Click the Modify button. This opens the Modify Insight View dialog box.
3.
Select the metric name in the Selected Metrics box.
4.
Click the Remove button.
5.
Repeat the steps to remove more metrics and click the OK button.
Using Views: SystemInsight
69
6-5-6 Creating a Customized View
If no view contains a set of metrics similar to the view you wish to display, you can create a customized view.
When you create a view, it does not have assigned units.
To create a customized view, perform the following steps.
1.
Select a domain from the Domains Hierarchy box.
2.
Click the Create button. The Create View dialog box is displayed.
Figure 6-5 Create View Dialog Box
3.
Enter a name for the view in the Enter a view name box.
4.
Click the OK button. The Insight Metric Selection dialog box is displayed.
Figure 6-6 Insight Metric Selection Dialog Box
5.
Select a metric from the Metric area. To include a metric that is associated with a different domain, select
that domain from the domain list in the Metrics area and then select the metric.
6.
Click the Add button.
7.
The metric appears in the Selected Metrics list.
8.
Select a unit for the metric using the Units area.
9.
Add metrics and select units until the view is complete and then click the OK button to save the settings and
close the dialog box.
The customized view in listed in the Available Views box.
Using Views: SystemInsight
70
6-5-7 Saving User-Defined Views and Metric Configurations
You can save a description of the configuration of metrics and views as a text file. This information provides a
summary of your configuration, which you can use for back-up purposes.
To save user-defined views and metric configurations, perform the following steps.
1.
From the Display Agent Node menu, select the Export option, as shown in the following figure.
Figure 6-7 Node Menu – Export Options
2.
Select the View/Metric Configurations option from the displayed Export menu.
Using Views: SystemInsight
71
The Export Views and Metrics dialog box is displayed.
Figure 6-8 Export Views and Metrics Dialog Box
3.
Choose a folder to save the file and click the Save button.
NOTE: When you export views that contain user-defined metrics, a description of the metric formula is saved in
the file
Using Views: SystemInsight
72
6-5-8 Printing User-Defined Views and Metric Configurations
The following procedure explains how to print the description of the configuration of views and metrics.
1.
From the Display Agent Node menu, select the Print option.
2.
Click the View/Metric Configurations option from the Print menu.
Figure 6-9 Node Menu – Print Options
The Printer Selection dialog box is displayed.
Figure 6-10 Printer Selection Dialog Box
3.
Select a printer using the Printer list.
4.
To configure other printer settings, use the Configure button.
5.
From the Style Sheet list, select a style sheet.
6.
Click the OK button.
Using Views: SystemInsight
73
6-6 Managing Information in Views
When a view is opened it displays real-time information for the host system. The data in the view is updated at
regular intervals. In most cases, the display moves as it is updated, with the latest values added to the right as
each interval expires. The prior values shift left, one interval, with the earliest one no longer visible.
6-6-1 Changing the Time Interval
You can change the time interval for updating the display. The duration of time covered by a display is dictated
by the interval. For example, for the time interval one minute, a curve graph presents results for half an hour.
Shorter intervals provide greater granularity of detail. Larger intervals provide greater time coverage. The time
interval ranges from 15 seconds to 32 minutes.
To change the Time Interval, perform the following steps.
1.
From the Available Views list, select a view and click the Open button. The corresponding view window is
displayed.
Figure 6-11 View Window
2.
Select the Interval option from the menu. A submenu listing time intervals is displayed. The interval currently
in use is selected.
3.
Select a new interval from the Interval. The display is automatically updated.
6-6-2 Stopping and Starting the Display
You can stop and restart the update of displayed information at any time. For this, perform the following steps.
•
To stop the display, select the Stop option from the view window Options menu.
•
To restart the display, select the Resume option from the view window Options menu.
Using Views: SystemInsight
74
6-7 Display Modes
A view can be displayed in any of the modes listed in the table below.
Table 6-1 Display Modes
Mode
Description
Bar
Displays the last 5 values of each metric as a separate horizontal bar.
Curve
Displays individual metric values as separate curves with the same scale.
Gauge
Displays each metric as an automotive-type gauge. The gauge shows the data value as an
area filled with a color or a pattern.
Layer
Builds an area chart in the form of layered curves. The areas between the layers are filled with
color or patterns to highlight relative differences.
Plot
Displays a chart of metric values around a line plotted by OVNPM.
Select the display mode that best suits the way you would like to see the information. For example, one set of
metrics may be meaningful when viewed, as curves while another, such as distribution, may be best understood
when displayed in layered mode. Data concerning resource utilization has a test visual impact when viewed as
automotive type gauges.
The Menu bar contains a menu title for the view’s current display mode. For example, if the current view display
mode is gauge, the menu title Gauge appears in the Menu bar. Each mode specific menu contains commands
that customize characteristics unique to that display mode such as its appearance.
Using Views: SystemInsight
75
6-7-1 Changing the Display Mode
When you open a view it returns to its most recent display mode. This procedure explains how to change the
display mode.
To change the display mode, perform the following steps.
1.
From the Available Views list, select a view and click the Open button.
2.
In the displayed view window select the Modes option from the Options menu, as shown in the following
figure.
Figure 6-12 Options Menu – Mode Options
3.
A mode selection submenu appears. Choose a new graphic mode from the submenu. Display Agent
reformats the data to fit the new graphic mode.
Using Views: SystemInsight
76
6-7-2 Curve Mode
The curve mode displays individual metric values as separate curves with the same scale.
OVNPM builds a legend box, whenever space permits. If the legend is not visible, resize the window so the
legend box appears. The legend lists each metric along with its corresponding color or pattern in the display and
additional data; as shown in the following table.
Table 6-2 Curve Mode Labels
Label
Description
A
Average of all interval values
V
Exact value for a specific time interval
S
Scale selected for the display
M
Marker, if one is in use
NOTE: The exact amount of data that can be shown within a legend box depends upon the resolution of the
display terminal
Figure 6-13 Curve View Window
Using Views: SystemInsight
77
6-7-3 Layer Mode
The layer mode builds an area chart in the form of layered curves. The areas between the layers are filled with
color or patterns to highlight relative differences.
Whenever space permits, OVNPM builds a legend box. If the legend is not visible, resize the window so the
legend box appears. The legend lists each metric along with its corresponding color or pattern in the display and
additional data as follows.
Table 6-3 Layer Mode Labels
Label
Description
A
Average of all interval values
V
Exact value for a specific time interval
NOTE: The exact amount of data that can be shown within a legend box depends upon the resolution of the
display terminal
Figure 6-14 Layer View Mode
Using Views: SystemInsight
78
6-7-4 Displaying Values for a Specific Interval
To display the actual values for any interval in Layer or Curve display mode, perform the following steps.
1.
Click a specific point in the displayed view. A vertical line appears at that point. This line marks a specific
time interval.
Figure 6-15 Curve View with a Point Selected
2.
The time of the interval is shown above the line (for example, 2:46:30 PM). You can adjust the interval, if
necessary, either by clicking on another point or by dragging the vertical line with the left and right cursor
keys. The legend box displays the actual values preceded by V.
To remove the vertical line, click it. As a result, the corresponding actual values are removed from the legend.
Using Views: SystemInsight
79
6-7-5 Plot Mode
The plot display mode presents data as points scattered around a reference line. The slope of the line is plotted
from two metric values. The equation used to plot the line is displayed above the plot diagram. By default,
OVNPM uses the first two metrics in the view definition to plot the line.
OVNPM builds a legend box, whenever space permits. If the legend is not visible, resize the window so the
legend box appears. The following legend lists two metrics used to plot the line and additional data.
Table 6-4 Plot Mode Labels
Label
Explanation
X
Metric plotted on the X axis
Y
Metric plotted on the Y axis
E:
Estimates of the X and Y values for any selected point on the line.
NOTE: The exact amount of data that can be shown within a legend box depends upon the resolution of the
display terminal.
Figure 6-16 Plot View Window
Using Views: SystemInsight
80
6-7-6 Changing Metrics Used to Plot the Line at Any Time
To change metrics used to plot the line at any time, perform the following steps.
1.
Open the view and select the Plot display mode
2.
From the view window Plot menu, select the Metrics option. The Metrics dialog box is displayed.
Figure 6-17 Metrics Dialog Box
3.
Select the metrics to the new line using the Y and X drop-down boxes.
4.
Click the OK button to complete the procedure.
You can see estimates of the X and Y values for any point on the line by clicking it. A vertical index line appears
and the estimates are displayed in the legend box preceded by E.
You can shift the index to another position, either by clicking on another point or by dragging the vertical line
with the left and right cursor keys.
Using Views: SystemInsight
81
6-8 Displaying Values Independently
You can open a related, non-graphic window to display the actual values for any interval. This window is
independent of the graphic display. You can shift time intervals for values displayed without changing the period
covered in the graphic display.
To open an independent window, select the Values option from one of the display mode menus: Bar, Curve,
Gauge, Layer or Plot. This displays the Values dialog box for the selected view.
Figure 6-18 Values Dialog Box
This window displays the values at the initial time interval selected or the current time interval. You can shift time
periods using the three buttons provided:
•
Click the left arrow button to move one interval back in time.
•
Click the right arrow button to move one interval forward in time.
•
Click the middle button containing a dash, to return to the initial contents of the Values window.
Using Views: SystemInsight
82
6-9 Customizing Appearance of Views
OVNPM provides a set of controls to customize the appearance of views. The following table lists the controls,
describes their purpose, and display modes.
Table 6-5 OVNPM Controls
Control
Purpose
Display Modes
Area
Paints colors and/or patterns in areas between curves
for emphasis. The colors and/or patterns are defined
in active style sheet.
Curve
Background Pattern
Defines a set of horizontal lines or grid lines to make
values on a graph easier to interpret.
Curve, Layer Plot
Hidden
Temporarily hides one or more metrics to make a view Curve
easier to read.
Marker
Places a reference line at a user defined level on the
display. This marker makes it easier to see data that
reaches that level.,
Bar Curve
High Mark
Sets a starting point for a shaded area at the top of a
gauge
Gauge
Scale
Value that determines the range of the data display
Bar, Curve, Layer, Gauge
Style Sheet
Describes the colors and patterns used for page
display/hard copy.
All Modes
Using Views: SystemInsight
83
6-9-1 Applying Colors to Areas between Curves
You can apply colors and patterns to emphasize the space between individual metrics on a view in the curve
mode. The active style sheet dictates the colors and patterns to use.
To apply colors or patterns to areas between curves, select the Area option from the Curve menu.
Figure 6-19 Curve View
Using Views: SystemInsight
84
When this option is active, the Area option is displayed a check mark.
Figure 6-20 Curve View with Area Option Selected
To turn off the feature, click the Area option again.
Using Views: SystemInsight
85
6-9-2 Setting a Background Pattern
For visual clarity, you can apply a background pattern to certain display modes. For curve or layer modes, you
can add a series of horizontal lines. For plot mode, you can add a grid to the display.
To display the current background selection, select the Background Pattern option from the menu appropriate to
the current view mode. A check mark appears next to the current background selection. To add or change the
background pattern, select the pattern from this menu.
To remove the current background pattern, choose the No Line or No Grid options from this menu.
Figure 6-21 Curve View with 9 Lines Background Pattern Selected
Using Views: SystemInsight
86
6-9-3 Hiding One or More Metrics
The Hidden attribute temporarily hides one or more metrics to make a view easier to read. To hide a metric in
curve mode, perform the following steps.
1.
Select the view. If the legend is not visible, maximize the view. In the legend, select the metric you want to
hide.
Figure 6-22 Curve View
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
2.
From the Curve menu, select the Hidden option. The metric disappears from the display and its reference in
the legend appears gray.
Figure 6-23 Curve View with One Metrics Hidden
TIP: When the Hidden option in the Curve menu appears with a check mark, it is active. To include the hidden
metric in the display, clear the Hidden option.
Using Views: SystemInsight
87
6-9-4 Setting a Marker
Setting a marker is the way to set your own reference point for a metric. OVNPM draws a line in the display at
the marker value. This makes it easier to notice when a metric value reaches a high or low point.
Actual performance can be measured against the visual level highlighted by the marker. A view can contain a
single marker or a separate marker for each metric.
To set a marker, perform the following steps.
1.
Select the view. If the legend is not visible, maximize the view.
2.
If you want to set a marker for an individual metric, select the metric in the legend. Otherwise, a single
marker is set for all metrics in the view.
3.
Select the Marker option from the menu appropriate to the current view mode. This displays the Marker
dialog box.
Figure 6-24 Marker Dialog Box
4.
Select the Level check box.
5.
Enter a value in the Level box. The maximum value allowed is shown in the dialog box.
6.
Click the OK button. The marker value(s) are displayed in the legend. As soon as the view is redisplayed,
you can restore it to its previous size.
To turn off the marker, uncheck the Level check box in the Marker dialog box.
Using Views: SystemInsight
88
6-9-5 Setting a High Mark for Gauges
You can set a high mark in a gauge. This mark delimits an area distinctly colored or shaded in the display.
Actual performance is easy to notice if a metric value reaches the area delimited by the high mark. The same
high mark can apply to all gauges in a view.
To set a high mark, perform the following steps.
1.
Select the view. If the legend is not visible, maximize the view.
Figure 6-25 High Mark Dialog Box
2.
To set a high mark for an individual gauge, select the metric name beneath the gauge. Otherwise, this high
mark value is applied to all gauges in the current view.
3.
Select the High Mark option from the Gauge menu.
4.
In the displayed High Mark dialog box, select the Level check box.
Figure 6-26 High Mark Dialog Box
Using Views: SystemInsight
89
5.
Enter a value in the Level box. The dialog box shows the maximum value allowed for the gauges.
6.
Click the OK button.
The portion of the gauge(s) beginning with the high mark is shaded or colored. As soon as the view is
redisplayed you can restore it to its previous size.
To turn off the high mark, uncheck the Level check box in the High Mark dialog box.
Using Views: SystemInsight
90
6-9-6 Setting a Scale for the Display
Scaling defines the peak values represented by each metric display. In the case of a gauge display mode,
scaling defines the maximum value shown on a gauge.
You can choose any of these options to set a scale for the display.
•
Value: Scales all metrics to the maximum metric value
•
Automatic: Scales all the values to fill the panel or gauge
•
Default: Uses the scaling assigned to the metric at installation time.
If the display mode is a curve, bar, or gauge, you can apply the same scale to all metrics or apply a different
scale to each metric.
To change the scale, perform the following steps.
1.
Select the view. If the legend is not visible, maximize the view.
2.
To set the scale for an individual metric, select it from the legend. Otherwise, the same scale will be applied
to all metrics in the view.
3.
Select the Scale option from the menu appropriate to the current view mode. The Scale dialog box is
displayed.
Figure 6-27 Scale Dialog Box
4.
Select one of the following types of scales using the various options in the Scale dialog box and click the
OK button.
•
Value: To enter your won scale
•
Automatic: For automatic scaling
•
Default: To use the scale defined with the metric
In curve mode, if all metrics in a view have the same scale, then numerical values appear to the left of the scale
marks. As soon as the view is redisplayed you can restore it to its previous size.
Using Views: SystemInsight
91
6-10 Using Style Sheets
Style sheets control the color and pattern used in a view for display and printing. A set of style sheets is provided
with OVNPM. You can build any number of additional style sheets. Any style sheet can be specified as the
default. Defaults can be declared for page displays and printer output.
For up to 16 metrics, each style sheet provides the following formatting options:
•
Background Color or Transparent Background
•
Background Pattern
•
Line Style
•
Line Color
In addition, a background color can be set for non-data areas.
6-10-1 Applying Style Sheets
When you open a view it uses the style sheet that it was assigned the last time it was open. If you change the
style sheet for a page display, the appearance of the view changes immediately.
To apply a style sheet, perform the following steps.
1.
Select the Style Sheet option from the menu corresponding to the display mode. This displays the Style
Sheet dialog box.
Figure 6-28 Style Sheet Dialog Box
2.
Select a style sheet for the page display and a style sheet for the printer using the Page and Printer areas.
To use the default style sheet, select the Default Style Sheet options.
3.
To use a different style sheet, select the Name option, and select a style sheet from the drop-down list.
4.
To designate a style sheet as the page display default, in the Default Style Sheets area, select its name from
the Page drop-down list.
5.
To designate a style sheet as the printer default, in the Default Style Sheets area, select the style sheet from
the Printer drop-down list.
6.
Click the OK button to complete the procedure.
Using Views: SystemInsight
92
6-10-2 Creating a Style Sheet
OVNPM is delivered with a set of style sheets. You cannot modify these style sheets unless you save them under a
different name thereby creating a new style sheet. You can modify your own style sheets at any time.
To create a style sheet, perform the following steps.
1.
Access the Style Sheet dialog box and click the Configure button. This displays the Configure Insight Style
Sheet dialog box. This dialog box contains a preview panel that displays the effect of the latest settings as
you select them.
Figure 6-29 Configure Insight Style Sheet Dialog Box
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
2.
Set options for the preview panel by selecting one of the following options:
•
Area: Sets the preview box to show the effect on area or layered displays.
•
Line: Sets the preview box to show the effect on curve display mode.
3.
To modify an existing style sheet, select its name from the Name drop-down box.
4.
To add a new style sheet, click the Add button.
5.
The Add Style Sheet dialog box is displayed. Type a name for the new style sheet in the Name box and
click the OK button.
Figure 6-30 Add Style Sheet Dialog Box
6.
7.
8.
9.
6.
Select one of the following background options:
•
Transparent Mode: Suppresses the background color for any metric in area or layer displays if the
metric has a brush pattern defined.
•
Background: Sets a color to be used for non-data areas in the display.
7.
Select a metric from the metrics list box.
8.
The current settings for the metric are displayed in the Pattern area. Select options for the selected metric
from any of the lists in the Pattern panel:
•
Foreground: Color for the metrics line
Using Views: SystemInsight
93
9.
•
Line: Line style applied to curves
•
Brush: Pattern to delineate area and layer displays
•
Background: Background color for area and layer separations
Repeat the previous two steps for any other metrics you wish to change and then click the OK button.
6-11 Viewing Recent-Past Data
You can switch the display between incoming real-time data and replaying saved data for recent activity.
For replay, you can view only data included in the active data collection cycle (for example, within the last day).
The amount of active data retained in the OVNPM database at any site is determined at installation. Check with
your OVNPM administrator to determine the active data collection period at your site. There are two methods to
display recent-past data.
•
Scroll: View snapshots of recent-past data across a period of time
•
Animate: View the animated replay of recent-past data
To switch to recent-past data from real-time monitoring, choose the Previous Period option from the Options
menu. As a result, the display freezes on the previous period.
To access recent-past data for a specific time period, you must first specify an exact time reference.
6-11-1 Specifying Exact Time Reference for Recent-Past Data
Time references affect the information displayed by providing the following information.
•
Date and time of the data to be displayed
•
Collection time interval, which determines the degree of granularity of the data.
To specify a time reference, select the Time Reference option from the Options menu. This opens the Time
Reference Selection dialog box, which lists the previous 20-time references, used.
Figure 6-31 Time Reference Selection Dialog Box
If the time reference you need appears on the list, select it and then click the OK button. The view changes to
display data for the selected time period. If the time reference and interval you need are not included in the list,
then you can add a new reference.
Using Views: SystemInsight
94
6-11-2 Creating a Time Reference
To create a time reference, perform the following steps.
1.
From the Options menu, select the Time Reference option.
2.
In the displayed Time Reference Selection dialog box, click the Create button. This displays the Time
References dialog box.
Figure 6-32 Time Reference Dialog Box
3.
4.
5.
6.
7.
8.
9.
10.
3.
4.
Select a time interval using the Interval spin box.
Select one of the time options and click the OK button.
•
Live: For the current time
•
Replay: For specifying a specific date or time
6-11-3 Deleting a Time Reference
To delete a time reference, perform the following steps.
1.
From the Options menu, select the Time Reference option. The Time Reference Selection dialog box is
displayed,
2.
Select the time reference to be deleted and click the Delete button. To delete all the time references from the
list of available references, click the Delete All button.
3.
A confirmation dialog box appears on the page. Click the Yes button to confirm your choice.
6-11-4 Scrolling Through Recent-Past Data
When using views, you can scroll back and forth between time intervals to view specific information. To scroll
back and forth through recent and past time intervals, select the Previous Period or Next Period options from the
Options menu.
Alternatively, you can use the following icons in the view window:
Each selection moves the display one-time interval in the direction specified
When viewing data in a view that is at the edge of the page, you can center the data in the middle of the page
using buttons that display half of the time interval.
To scroll back and forth through half time intervals, use the following buttons in the window of a view.
Each option moves the display half of a time interval in the direction specified.
Using Views: SystemInsight
95
6-11-5 Animating Recent-Past Data
The Animate function plays back recent and past data with a rapid refresh rate. To animate data you select a
starting date, time, and a refresh rate. The starting date and time can be the previous time period, or a specific
time period in the past. Each refresh updates the display by one time period. The amount of data shown for each
time period depends on the time interval. You can stop and restart the animation at any time.
Follow the steps below to start an animated replay of recent-past data or to restart a stopped display.
1.
Select the time reference to start the animation.
2.
From the Options menu, select the Animate option. Alternatively, click the
3.
The Animate dialog box is displayed. Use the spin box to select a refresh rate for the display and click the
OK button.
4.
To stop the animation, select the Stop option from the Options menu. This action can also be performed
using the
icon.
icon.
6-11-6 Switching from Replay to Real-Time Monitoring
To switch from a replay of historical data to real-time monitoring select the Resume option from the Options menu.
6-12 Using Comments in a View
You can attach your own notes or comments to any view. The comment is not displayed with the view. However,
you can view, change, or remove comments at any time. For example, this is a convenient way to connect a
reminder about prior occurrences or future activities to the view.
The comment appears when the view is printed. For example, you can use a comment to annotate the printed
output of a view for record keeping or presentations.
NOTE: This procedure is valid for both views and reports.
When you edit a comment you can include additional text or replace all the text.
To create or modify comments of a view, perform the following steps.
1.
From the Available Views list in the Insight tab page, select a view and click the Open button.
2.
In the displayed view window, select the Edit Comment option from the View menu. The Edit Comment
dialog box opens. If there is an existing comment, it is displayed in this box.
Figure 6-33 Edit Comment Dialog Box
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
3.
Type a new or replacement comment in the Comments box and click the OK button. The comment is
displayed any time Edit Comment is selected from the View menu.
To delete a comment, open the Edit Comment dialog box and delete the comment text from the Comments box
and click the OK button.
Using Views: SystemInsight
96
6-13 Drilling Down for Detailed Information
From the Display Agent Insight tab page, you can investigate Domains and Units for detailed information in the
real-time mode.
Navigator, which is an optional feature of OVNPM, displays the results of an investigation in tabular format on
Web pages. Data entries in the table can appear as hyperlinks to more detailed information, which is then
displayed on another Web page. This procedure of gaining access to progressively more precise information is
known as drilling down.
The following procedures explain how to drill down for more information from SystemInsight.
6-13-1 Drilling Down on Domains
To drill-down domain, perform the following steps.
1.
From the Display Agent Insight tab page, select a domain from the Domain Hierarchy list box.
2.
Click the Drill Down button. A list of metrics associated with the domain appears.
Figure 6-34 Insight Tab Page with Drill-Down Menu
Using Views: SystemInsight
97
3.
Select the metric to target for drilling down from the Drill Down menu.
Navigator is displayed on a Web page with parameters to define for the investigation after you enter the
Login ID and Password.
Figure 6-35 Navigator
4.
Enter parameter values in the various fields and then click the Submit button. The Navigator displays the
results of the investigation.
Figure 6-36 Navigator Drill-Down Result
Using Views: SystemInsight
98
6-13-2 Drilling Down on Units
To drill down on units, perform the following steps.
1.
From the Display Agent Insight tab page, select a domain from the Domain Hierarchy list box.
2.
Click the Metrics/Units tab to display the corresponding tab page.
Figure 6-37 Metrics/Units Tab Page
3.
From the Metrics/Units page, select a unit to target for drilling down in the Available Units box.
Using Views: SystemInsight
99
4.
Click the Drill Down button in the Metrics/Units tab page, next to the Available Units box.
Figure 6-38 Metrics/Units Tab Page Drill-Down Menu
5.
Select the metric to target for drilling down from the Drill Down menu.
6.
The Navigator opens a Web page containing the results of the investigation. From the Web page
containing the results of an investigation, you have the following possibilities:
•
You can modify the investigation, by entering different parameter values.
•
You can drill down for more detailed information by clicking a hyperlink in the tabular results.
Alternatively, you can drill down for more detailed information from an open view.
Using Views: SystemInsight
100
6-13-3 Drilling Down from an Open View
To drill down from an Open View, perform the following steps.
1.
From the Insight tab page, open a view.
2.
Select the Drill down option from the view window Options menu.
Figure 6-39 Options - Drill down Menu
3.
A list of associated units is displayed. Select a unit from the displayed list.
4.
A list of associated metrics appears. Select a metric from the list.
Using Views: SystemInsight
101
5.
The Navigator opens a Web page containing the results of the investigation.
Figure 6-40 Navigator Drill Down
6-14 Exporting Data to a File
You can export data from a view to another application, such as a spreadsheet, by creating a file. The file is
copied in the text format, delimited by tabulation and line-feed characters.
To export data to a file, perform the following steps.
1.
From the Insight tab page Available Views list, select a view and click the Open button to open the selected
view.
2.
The view window is displayed. Click the Export option in the View menu.
3.
This opens a standard Windows Export dialog box. Enter the filename and directory of the file to be
created for export.
4.
Click the OK button.
6-15 Printing a View
To print a view, perform the following steps.
1.
Open the view to be printed.
2.
From the view window View menu, select the Print option. This displays the Printer Selection dialog box.
Figure 6-41 Printer Selection Dialog Box
3.
4.
5.
6.
7.
8.
9.
10.
11.
3.
Select a printer from the Printer drop-down list box.
4.
Select a style from the Style Sheet drop-down list box.
5.
To change printers or review printing options, use the Configure button.
6.
Click the OK button to print the view.
Using Views: SystemInsight
102
6-16 Copying a View
6-16-1 Copying a View to a Dashboard
OVNPM dashboard displays multiple views in a single window. OVNPM also provides you with the ability to
copy a view to a dashboard. This can have either of the following results:
•
If the dashboard is currently open, the view is added to its display immediately.
•
If the dashboard is closed, the view is added to the dashboard’s definition and is displayed the next
time the dashboard is opened.
6-16-1-1 Copying an Open View to a Dashboard
To copy the graphical results of an open view to a dashboard, perform the following steps.
1.
From the view window View menu, select the Copy option.
2.
Select the Dashboard option from the Copy submenu.
Figure 6-42 View Copy Dashboard Option
The Copy to Dashboard dialog box is displayed.
Figure 6-43 Copy to Dashboard Dialog Box
3.
Select an existing dashboard from the Dashboards list. Alternatively, click the Create button to create a new
dashboard.
4.
Click the OK button to complete the procedure.
Using Views: SystemInsight
103
6-16-1-2 Copying an Closed View to a Dashboard
To copy a closed view to a dashboard, perform the following steps.
1.
Select a view from the Insight tab page Available Views list box.
2.
Click the Copy to Dashboard button.
3.
A Copy to Dashboard dialog box is displayed. Select an existing dashboard from the Dashboards list.
Alternatively, click the Create button to create a new dashboard.
4.
Click the OK button to complete the procedure.
6-16-2 Copying a View to another Domain
Every view belongs to the domain in which it is created. OVNPM allows a view to be copied to other domains.
To copy a view to another domain, perform the following steps.
1.
From the view window View menu, select the Copy option.
2.
From the displayed Copy submenu, select the Desktop option.
3.
A Copy to Desktop dialog box is displayed.
Figure 6-44 Copy to Desktop Dialog Box
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
4.
Select the target domain from the Domains list, and click the OK button.
Using Views: SystemInsight
104
6-17 Locating Metrics and Units
OVNPM can indicate the views and dashboards that contain a particular metric or unit. Use the following
instructions to locate an Insight Metric or Unit.
To locate metrics and units, perform the following steps.
1.
From the Display Agent Insight tab page, select a domain in the Domains Hierarchy box
2.
Click the Metrics/Units tab to display the corresponding tab page. The Available Metrics box displays the
list of metrics, which are available for that particular domain. The Available Units box displays the list of
units that are available for that particular domain.
3.
Select a metric or a unit using the Available Metrics and Available Units boxes, respectively.
4.
Click the Locate Metric button to locate a metric.
Figure 6-45 Locate Metric Dialog Box
5.
Alternatively, click the Locate Unit button to locate the selected unit. OVNPM displays the names of all the
views and dashboards, which contain the selected metric or unit in the Locate Metric or Locate Unit dialog
boxes, respectively.
Figure 6-46 Locate Unit Dialog Box
Using Views: SystemInsight
105
6-18 Renaming a View
You can change the name of any view you create. You cannot change the name of a view, which is supplied
with OVNPM.
To rename a duplicated or customized view, perform the following steps.
1.
Open a view and click the Rename option from the View menu. This action can also be performed by
clicking the Rename button in the Insight – Views tab page.
2.
The Rename View dialog box is displayed.
Figure 6-47 Rename View Dialog Box
3.
Enter the new name in the Enter a view name box. Click the OK button.
6-19 Deleting a View
You may delete any view you create. You cannot delete a view supplied with OVNPM. To delete a duplicated or
customized view, perform the following steps.
1.
Select the view to delete from the Insight tab page Available Views list.
2.
Click the Delete button.
3.
A confirmation box is displayed.
Figure 6-48 Delete View Confirmation Box
4.
Click the Yes button to delete the selected view.
Using Views: SystemInsight
106
7 Analyzing Trends: SystemTrend
7-1 What is SystemTrend?
SystemTrend is OVNPM’s trend analysis tool. With SystemTrend you can observe patterns of usage over broad
periods of time. You can analyze past performance patterns to help in capacity planning, resource allocation,
scheduling, and problem diagnosis.
SystemTrend complements SystemInsight. SystemInsight monitors current and recent-past performance whereas,
SystemTrend reports on behavior across historical periods. In addition, SystemTrend uses different display modes
than SystemInsight. However, both types of views can incorporate the same metrics and units.
The following actions apply to both SystemInsight and SystemTrend views.
•
Selecting Units
•
Displaying Values for a Specific Interval
•
Displaying Values Independently
•
Setting a Background Pattern
•
Setting a Marker
•
Setting a Scale for the Display
•
Using Style Sheets
•
Using Comments
•
Exporting Data
•
Printing a View
•
Copying a View
•
Locating Metrics and Units
•
Renaming a View
7-2 Understanding SystemTrend Views
SystemTrend presents data as vertical bar graphs (histograms) in the following display modes.
Table 7-1 SystemTrend Display Modes
Mode
Type of Information
Report Intervals
History
Actual Activity
Day, Month, or Year
Profile
Average Day (Hourly)
Month or Year
Analyzing Trends: SystemTrend 107
7-2-1 History Views
History views show actual activity during the report interval for a day, month, or year.
Table 7-2 History Views – Report Interval
Report Interval
Each X-Axis Point Equals
Values at Each Point
Day
One Hour (1 - 24)
Hourly Maximum, Minimum, Average
Months
One Day (1 - 31)
Daily Maximum, Minimum, Average;
Maximum and Minimum Hourly Average
Year
One Month (1 - 12)
Monthly Maximum, Minimum, Average;
Maximum and Minimum Daily Average
Figure 7-1 Trend History View
Analyzing Trends: SystemTrend 108
7-2-2 Profile Views
Profile views show an average day computed for a report interval, which can be a month or a year.
Table 7-3 Profile Views – Report Interval
Report Interval
Each X-Axis Point Equals
Values at Each Point
Month
One Hour (1 - 24)
Maximum, Minimum, Average
Year
One Hour (1 - 24)
Maximum, Minimum, Average
Figure 7-2 Trend Profile View
Analyzing Trends: SystemTrend 109
7-3 Opening a SystemTrend View
Like SystemInsight views, SystemTrend views belong to domains and can be generic or unit-specific. Both types of
views need unit assignments in order to be displayed. In the Trend desktop window, the Available Views box lists
the SystemTrend views that are associated with a selected domain.
SystemTrend time references contain three values: a mode (profile or history), a report interval (day, month, or
year) and a time period. You can exclude specific days or times of a day from a time reference.
7-3-1 Opening a SystemTrend View with an Existing Time Reference
To open a SystemTrend View with an Existing Time Reference, perform the following steps.
1.
Click the Trend tab in the Display Agent window. The Trend tab page is displayed.
Figure 7-3 Display Agent Trend Tab Page
2.
From the Domain Hierarchy box, select a domain.
3.
Select a trend analysis view from the Available Views list. The metric contained in the trend analysis view
appears in the View Contents list.
4.
Click the Time Scale button to choose a time reference period. Alternatively, select a period from the dropdown list.
5.
Click the Open button.
You have two possible results when you open a view:
•
If units are already assigned to the view, the view opens in a new window and starts displaying data. If
the view is generic, and there is only one unit in the domain, the view opens and starts displaying data
for the single unit.
•
If the view is generic, and there is more than one unit to select, the Unit Selection dialog box opens.
You must select units before displaying the view.
Analyzing Trends: SystemTrend 110
7-3-2 Adding a New Time Reference and Data Wrap
If the desired time reference is not included in the drop-down list, you can add a new time reference and then
select it from the drop-down list.
By default, views in profile mode and daily history views start with hour 01 on the left and end with hour 24 on
the right. At the same time you define a time reference, you can change the rightmost hour shown on the display,
which forces the remaining data to be wrapped to the left.
To add a new time reference and data wrap, perform the following steps.
1.
Click the Add button in the Trend tab page. The Trend Time Reference dialog box is displayed.
Figure 7-4 Trend Time Reference Dialog Box
2.
Select the History or Profile option in the Mode area.
3.
Select a report interval using the Interval spin box. You can select the interval as Day, Month, or Year;
however, day is not an available for the Profile mode.
4.
The next step is to select a report period using the Period spin box.
In the Period box, you indicate the ending day for the month interval, and the ending month for the year
interval. For example, if the report interval is a month, and you want the report to include all the days of the
month, you need to select an ending day of 30 or 31 in the Period box.
5.
To change the right most hour in the view, select the new hour using the Wrap after Hour box.
6.
To exclude data for certain days or time periods from the view, select the days and time from the Exclude
list box. You can select more than one day from the list.
7.
Click the OK button to complete the procedure.
7-4 Copying an Existing Trend View
You cannot modify, rename, or delete a trend view supplied by OVNPM. However, you can copy the supplied
OVNPM trend view, and then make your modifications.
To copy an existing trend view, perform the following steps.
1.
Select a trend view from the Available Views list in the Trend tab page.
2.
Click the Duplicate button.
A copy of the trend view appears in the Available Views box. The duplicated trend view has the same name as
the original view with the extension copy. You can modify and rename the duplicate trend view to create a new
view.
Analyzing Trends: SystemTrend 111
7-5 Creating a SystemTrend View
To create a SystemTrend view, perform the following steps.
1.
Click the Create button in the Trend tab page. This displays the Create View dialog box.
Figure 7-5 Create View Dialog Box
2.
Type a new name for the view in the Enter a view name box and click the OK button. The Trend Metric
Selection dialog box is displayed.
Figure 7-6 Trend Metric Selection Dialog Box
3.
Select a domain from the Domain list. A list of available metrics for the domain appears in the Metrics list.
Select a metric. Each trend analysis view reports on a single metric.
4.
Click the Add button. The metric appears in the Selected Metrics box.
5.
To modify your selection, select the metric and click the Replace or Remove button.
6.
Select a unit for the metric in the Units box.
7.
Click the OK button to complete the procedure.
Analyzing Trends: SystemTrend 112
7-6 Customizing Appearance of Views
7-6-1 Changing Report Intervals
After opening a SystemTrend view, you can change the interval of data displayed. For example, you can switch
from a monthly report to an annual report or vice versa. Follow the steps given below to change report intervals.
1.
Open a view and select the Interval option from the Options menu
2.
This opens a submenu of available intervals. The interval currently in use is selected. Select the new interval.
The view is recalculated and displayed.
7-6-2 Scrolling Between Time Periods
You can scroll back and forth between time periods by selecting Previous Period or Next Period options from the
Options menu. Each selection moves the display one time period in the specified direction. For example, if the
current view displays August 1995, selecting Next Period displays September 1995.
7-6-3 Hiding Values
Trend analysis views show several values for a metric, such as average, maximum, minimum. You can hide any
of these values in the display.
1.
Open a view and select the value you want to hide from the legend. If the legend is not visible, maximize
the view.
2.
Select the Hidden option from the Histogram menu. The value disappears from the display and it appears
shaded in the legend.
If the choice Hidden appears with a check mark, it is active. To turn off Hidden, clear this menu choice.
Analyzing Trends: SystemTrend 113
8 Using Tabular Data: SystemReport
8-1 What is SystemReport?
SystemReport shows detailed data in tabular reports that complement the graphic displays of SystemInsight.
SystemReport is the tool you use to analyze data that was used to calculate a graphic display.
In SystemReport, each column represents a metric and each row a metric value. You can sort the data in a report
by any of its columns.
you can use any of the following methods to view reports.
•
Open a report as you would a view to observe and analyze real-time data or playback recent past
data.
•
Open a report from within a SystemInsight view to analyze data at a specific interval in the display.
You can do this for views in curve, layer, or plot display modes.
OVNPM supplies an extensive set of predefined reports. You can adapt these reports to meet your needs, or
create your own.
SystemInsight and SystemReport display the same types of information, although they use different presentation
formats. For this reason, most actions that do not specifically involve graphics or tables are valid for both views
and reports.
The following actions apply to both views and reports.
•
Selecting Units
•
Changing the Time Interval
•
Stopping and Starting the Display
•
Viewing Recent-Past Data
•
Using Comments
•
Exporting Data
•
Printing a Report
•
Copying to Another Domain
•
Changing a Report Name
•
Locating Metrics and Units
•
Copying a Report to a Dashboard
Using Tabular Data: SystemReport
114
8-2 Opening a Report
Reports belong to domains. A report may be unit-specific or generic. A unit-specific report has a permanent
assignment to an actual unit (instance of a domain). A generic report is temporarily assigned to a specific unit at
the time it is opened. The names of generic reports appear in the Available Views list followed by the symbol [...].
The SystemReport icon precedes the names of reports supplied by OVNPM.
The SystemReport icon and a user icon precede the names of customized reports.
At the time you open a report, it displays real-time information for the host system. The data in the report is
updated at regular intervals as each interval expires.
To open a report, perform the following steps.
1.
Click the Report tab in the Display Agent window to display the corresponding tab page.
Figure 8-1 Display Agent Report Tab Page
2.
Select a domain from the Domain Hierarchy box. The Available Views list shows all available reports for
the selected domain.
3.
Select a report from the Available Views list. The data items that are contained in the report are displayed
in the View Contents box.
Using Tabular Data: SystemReport
115
4.
Click the Open button.
Figure 8-2 CPU Report
After you open a report, there are following two possible results.
•
If units are already assigned to the report, the report is displayed in a new window and starts
displaying data. If the report is generic, and there is only one unit in the domain, the report opens and
starts displaying data for the single unit.
•
If the report is generic, and there is more than one unit to select, the Unit Selection dialog box is
displayed.
Using Tabular Data: SystemReport
116
8-3 Opening a Report from SystemInsight
You can open a report directly from a SystemInsight graphic view to analyze data for a specific point in time.
The view can be a curve, layer, or plot display mode.
1.
Open a view, and click a specific point in the display. A vertical line appears at that point. This line marks
a specific time interval.
2.
The time of the interval is shown above the line (for example, 08:46:30 PM). To adjust the interval, if
necessary, click another point or drag the vertical line with the left and right cursor keys.
3.
Right-click in the display area to access a shortcut menu.
4.
Select the Open Report option from the menu.
5.
A list of available reports appears. Select a report from the list to open the report.
Figure 8-3 Open Report Option
Using Tabular Data: SystemReport
117
8-4 Using Metrics to Build Reports
If a domain doesn’t have a report with the exact metrics you need, you can create a new report or modify one to
fit your requirements.
8-4-1 Copying an Existing Report
You can create a user-defined report by simply copying an existing report and modifying its metrics. In this case,
select a report that contains a set of metrics that is similar to the report you want to create.
NOTE: You cannot modify metrics in a report supplied by OVNPM. To change metric selection in OVNPM
report, you must first copy the supplied report
To copy a report, perform the following steps.
1.
Select a report from the Available Views list. The View Contents displays the metrics of the selected report.
2.
Click the Duplicate button. A copy of the report appears in the Available Views box. The duplicated report
has the same name as the original report with the extension copy.
You can add, replace and remove metrics from the duplicated report, to create a new report.
8-4-2 Modifying Metrics in a Report
When you select a report, the metrics that make up that report are displayed in the View Contents list. A metric is
a discrete measurement calculated from system values gathered by OVNPM.
1.
Select a user-defined report from the Available Views list in the Reports tab page.
2.
Click the Modify button. The Modify Report View dialog box displays the domain to which the report
belongs.
Figure 8-4 Modify Report View Dialog Box
3.
To add a metric to the report, select a metric from the Metrics list and click the Add button. The metric
appears in the Selected Metrics list.
4.
Select a unit for the new metric in the Units box. The unit appears next to the metric.
5.
Click the OK button. The results of the metric appear in the View Contents box.
To replace a metric in a report with another metric, select the metric to replace in the selected Metrics box. Select
the new metric in the Metrics box, and click the Replace button.
To remove a metric from the report, select the metric from the Selected Metrics list and click the Remove button. As
a result, the metric is removed from the Selected Metrics list.
In the Selected Metrics box, you can also change the order of the metrics. Use the arrows to move a selected
metric to a different position in the metric list.
Using Tabular Data: SystemReport
118
8-4-3 Creating a Customized Report
If there is not a report containing the set of metrics similar to the report you wish to generate, you can create a
customized report. At the time you create a report, it does not have assigned units.
1.
Select a domain from the Domain Hierarchy list.
2.
Click the Create button. The Create View dialog box opens.
Figure 8-5 Create View Dialog Box
3.
Type the report name in the Enter a view name box.
4.
Click the OK button. The Report Metric Selection dialog box opens.
Figure 8-6 Report Metric Selection Dialog Box
5.
To add a metric to the report, select a metric from the Metrics list and then click the Add button.
6.
Select a unit for the new metric in the Units box. The unit appears next to the metric. Add metrics and select
units until the report contains all the required metrics.
7.
Click the OK button.
To replace a metric in a report with another metric, select the metric to replace in the Selected Metrics box. Select
the new metric in the Metrics box click the Replace button.
To remove a metric from the report, select the metric from the Selected Metrics list, and then click the Remove
button.
Using Tabular Data: SystemReport
119
8-5 Sorting a Report
You can sort the report table by any one of its columns. The sort order can be ascending or descending. After
you specify a sort order for a table, it remains in that order every time the data is updated. The heading of the
column used for the sort appears highlighted.
1.
From an open report, select a column heading.
2.
Select the Local Sort option from the Table menu.
3.
The Table submenu displays sort options. The option currently in use is selected. Select one of the sorting
options for the column: Ascending, or Descending.
8-6 Deleting a Report
You may delete any report you create. You cannot delete reports supplied with OVNPM.
1.
Select the report that you want to delete from the Available Views list.
2.
Click the Delete button.
3.
A confirmation box appears. Click the Yes button to delete the report.
Using Tabular Data: SystemReport
120
9 Using SystemAlert
9-1 What is SystemAlert?
SystemAlert is the OVNPM alarm system. The alarms displayed by SystemAlert complement the real-time
supervision capability provided by supervision dashboards.
A threshold is a user-defined condition that triggers a SystemAlert. A single set of threshold information is
maintained on the host server and is downloaded to one user at a time.
The right to create, modify, and activate thresholds should be restricted. However, the ability to receive alarms
can be available to any number of users.
If the server sends an alarm while you are using another OVNPM module or feature, a flashing alarm icon
appears on the Alert tab in the Display Agent window. The severity of the alarm determines the icon color.
The Runaway process loop detection is another feature of SystemAlert. This feature provides automatic
supervision of your system. It detects and reports any process that uses excessive CPU or memory resources. This
information automatically appears in the Server Messages window. For further information, select the Help on
Server option from the Help menu.
9-2 Opening SystemAlert
To open SystemAlert, perform the following steps.
1.
To open SystemAlert, click the Alert tab in the Display Agent desktop window.
Figure 9-1 Display Agent Alert Tab Page
2.
3.
The Alert window consists of two tab pages: the Alarm Status page and the Alarm Log page.
From the Alarm Status page, you can do the following tasks:
•
Configure Thresholds
•
Define Alarm Messages
•
View the Status of Defined Thresholds
4.
From the Alarm Log page, you can view the history of alarm messages.
5.
Using the command buttons in the Alert tab page, you can also do the following tasks:
•
Start and Stop the Receipt of Alarm Messages
Using SystemAlert
121
•
Set the Parameters for Threshold and Group Alarms
•
Define Alarm Behavior
•
Purge the Log
9-3 Thresholds and Threshold Groups
You set threshold conditions for a SystemInsight metric. When these conditions are met, SystemAlert issues an
alarm.
Any number of thresholds can be combined into a threshold group with a special alert behavior for the entire
group.
The triggering condition of a threshold group is based on the alert status of its individual members. A group can
be triggered into alert status when any threshold in the group reaches alert status or when all thresholds in the
group reach alert status.
Before you can create or modify threshold and group alarms and define alarm behavior, you must be in the
Expert Mode.
9-3-1 Accessing the Expert Mode
To access the Expert Mode, perform the following steps.
1.
Select the Expert Mode Option from the Options menu. The Expert Mode dialog box is displayed.
Figure 9-2 Expert Mode Dialog Box
2.
Type the Password and click the OK button.
3.
The default password is password. To change the password, use the Password option from the Options
menu.
9-3-2 Configuring Thresholds and Threshold Groups
To configure Thresholds and Threshold Groups, perform the following steps.
1.
Click the Configuration button in the Alert tab page. The Groups and Thresholds Configuration dialog box
is displayed.
Figure 9-3 Groups and Threshold Configuration Dialog Box
2.
To create or modify a threshold, click the Thresholds tab. To create or modify a threshold group, use the
Groups tab. Threshold configuration is available to only one user at a time.
3.
To save all thresholds, or threshold group modifications, and close the Groups and Thresholds
Configuration dialog box, click the OK button.
Using SystemAlert
122
4.
To save threshold or threshold group modifications, and remain in threshold configuration, click the Apply
button.
5.
To print, export, or import threshold configuration, click the Action button. The available commands allow
you to print a configuration, export or import the configuration.
6.
To cancel threshold or threshold group modifications, click the Cancel button. A confirmation message asks
you to confirm your choice. Click the Yes button to continue.
9-4 Managing Thresholds
Creating a threshold includes choosing a critical SystemInsight metric for monitoring, setting limits for the metric,
and defining the alarm that should be sent when the limit is reached.
You can adapt a threshold as follows:
•
Set delays before an alarm is sent to avoid triggering alarms on noise conditions.
•
Limit the monitoring period of a threshold. For example, you may not want to monitor certain thresholds
during the night.
•
Set the severity level, from low to urgent. Each user can determine appropriate actions, which are
based on the severity level.
•
Send a single alarm or repeat the alarm as long as the threshold remains in alert status.
•
Select additional destinations for alarm messages. For example, you may want to send alarm messages
to host log files, or to the host console.
9-4-1 Creating a Threshold
When you create a threshold, you must select a metric and unit. Follow the instructions below to select a Metric
and Unit for the threshold.
1.
From the Alert tab page, click the Configuration button. The Groups and Thresholds Configuration dialog
box is displayed.
2.
Click the Thresholds tab to access the corresponding tab page.
Figure 9-4 Groups and Threshold Configuration Dialog Box Thresholds Tab Page
Using SystemAlert
123
3.
On the Thresholds tab page, click the Create button. The Create Thresholds dialog box is displayed.
Figure 9-5 Create Thresholds Tab Page
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
4.
In the Metrics area, select a domain and a metric and click the Add button.
5.
In the Units area, select a specific unit for the domain to be monitored.
6.
Verify that the Selected Metrics list contains the desired metric and unit.
7.
To set the threshold limit, click the OK button. You return to the Groups and Thresholds Configuration dialog
box.
You must assign a threshold test expression in order for the threshold definition to be complete.
Using SystemAlert
124
9-4-2 Assigning or Modifying a Threshold Expression
A threshold expression indicates the condition that triggers an alarm. A threshold expression is an arithmetic
operator followed by a test value, for example, >= 50.
9-4-2-1 Assigning a Threshold Expression to a Single Threshold
1.
Open the Groups and Thresholds Configurations dialog box and click the Thresholds tab to access the
corresponding tab page.
2.
Select a threshold from the list.
3.
Select an operator in the box next to the selected metric. For example, you can select the >= operator.
4.
Type a value following the operator in the same text box. OVNPM copies the value to the metric in the
Threshold list.
9-4-2-2 Assigning the Same Test Expression to More than one Threshold
1.
Open the Groups and Thresholds Configurations dialog box and click the Thresholds tab to access the
corresponding tab page.
2.
Select two or more thresholds from the Threshold list.
3.
The operator box changes to an Expression button. Click the Expression button. This displays the Expression
dialog box.
Figure 9-6 Expression Dialog Box
4.
Select an operator from the Enter an expression drop-down list box. For example, you can select the >=
operator.
5.
Type a new or changed value in the Enter an expression box following the operator and click the OK
button. The Expression box closes and the new test expression is copied to each threshold selected in the
Threshold list.
9-4-3 Modifying Time Parameters
Time parameters control the following characteristics:
Time Parameter
Description
Interval
Amount of time between each verification of a threshold status.
Trigger notice delay
Amount of time that a threshold violation is maintained before triggering an alarm. By
default, an alarm is issued as soon as a condition is detected.
Normal notice delay
After triggering an alarm, amount of time with no threshold violation before the alarm
status is removed from the threshold. By default, a normal notice is issued as soon as a
violation is no longer detected.
Using SystemAlert
125
To modify any time parameters, perform the following steps.
1.
Open the Groups and Thresholds Configurations dialog box and click the Thresholds tab to access the
corresponding tab page.
2.
Click the Time Parameters button. The Time Parameters dialog box is displayed.
Figure 9-7 Time Parameters Dialog Box
A threshold with these parameters verifies a threshold condition as per the specified monitoring interval. If the
condition is reached, and remains that way for a specified time (Trigger Notice Delay), an alarm is issued. After
the alarm is issued, if the condition returns to its normal state, and remains in that state for a specified time
(Normal Notice Delay), the threshold is reset to normal.
3.
Select an interval from the Monitoring Interval box.
4.
To activate a trigger notice delay, select the Trigger Notice Delay check box and select a delay time.
5.
To activate a normal notice delay, select the Normal Notice Delay check box and select a delay time.
6.
Click the OK button.
Using SystemAlert
126
9-4-4 Setting Monitoring Periods
By default, thresholds are monitored on a 24-hour basis. However, you can limit monitoring to specific time
periods. Time periods are delimited by starting and ending times.
NOTE: A single threshold can have up to two monitoring periods.
To set one or two monitoring periods, perform the following steps.
1.
Open the Groups and Thresholds Configurations dialog box and click the Thresholds tab to access the
corresponding tab page.
2.
Click the Monitoring Period button. The Monitoring Period dialog box is displayed.
Figure 9-8 Monitoring Period Dialog Box
3.
Use the Start and End boxes in the Time Setting area to set a starting and ending time for the monitoring
period.
4.
Click the << button to copy the new time setting into the Daily Monitoring Period box. If the time setting
conflicts with a monitoring period already in the box, an error message appears.
5.
To remove a monitoring period, select the monitoring period from the Daily Monitoring Period box and
click the >> button.
6.
Click the OK button to complete the procedure.
9-4-5 Requesting Recurrent Notifications
OVNPM checks thresholds at regular monitoring intervals. As soon as a threshold condition is detected, the
threshold is put into alert status. You choose whether you want a notification sent only once, at the first interval
that the condition is detected, or at each monitoring interval that the threshold remains in alert status.
To request notification at each monitoring interval; select the Recurrent Notification check box on the Thresholds
tab page in the Groups and Thresholds Configuration dialog box.
To request a single notification, clear the Recurrent Notification check box.
Using SystemAlert
127
9-4-6 Setting a Severity Level
You can assign a severity level to a threshold. The user can define behavior for each level of severity. You can
select the severity level using the Severity drop-down box on the Thresholds tab page in the Groups and
Thresholds Configuration dialog box. You can set the severity as Severe, High, Medium or Low.
Figure 9-9 Setting the Severity Level
9-4-7 Adding a Threshold to a Group
You can add a threshold to an existing group. To include a threshold as a member of a group or to switch
membership from one group to another, use the Group drop-down box on the Thresholds tab page in the Groups
and Thresholds Configuration dialog box.
To cancel group membership, select None from the Group list.
9-4-8 Creating an Alarm Message
When a threshold condition occurs, OVNPM sends notification in the form of a message.
To specify the text of the message, select the threshold in the Groups and Thresholds Configuration dialog box
and type the message in the Message box.
If you select more than one threshold, the Message box changes to a Message button. Click the Message button
and type your message in the displayed dialog box. You can use any combination of characters.
Figure 9-10 Message Dialog Box
You may want to develop a standard format for your messages. For example, the message below uses the form
of a standard prefix, the identity of the unit involved, and the metric:
Alert on PROCESS 00007:Cpu-Busy.%[$ACM]
Using SystemAlert
128
9-4-9 Using a Log File
In addition to normal alarm destinations, you can also send alert messages to a log file on the host. The host
maintains the list of available log files.
To specify a log file, select it from the Log File list, on the Thresholds tab page of the Groups and Thresholds
Configuration dialog box.
To remove an external log file destination, select <None> from the Log File list.
9-4-10 Declaring a Console to Receive Alerts
In addition to normal alarm destinations, in some host configurations you can also send alert messages to a
console on the host.
To specify a console destination, select your destination from the Console list on the Thresholds tab page of the
Groups and Thresholds Configuration dialog box.
To remove a console destination, select <None> from the Console list.
9-4-11 Deleting Thresholds
To delete thresholds, select one or more thresholds and click the Delete button in the Groups and Thresholds
Configuration dialog box.
A confirmation message box asks if you want to delete the threshold. Click the Yes button to delete the selected
threshold(s).
Using SystemAlert
129
9-5 Managing Threshold Groups
You can associate a set of thresholds to form a group. This is a way to create a single alarm for multiple
conditions. A threshold group can contain simple thresholds.
Each group has its own behavior including severity level and message. The status of individual thresholds
determines whether an alert is triggered for the group.
For a group, you have two triggering options.
•
Trigger the group alert when any of its individual members is triggered
•
Trigger the group alert only when all of its members are triggered.
9-5-1 Creating a Threshold Group
Before you create a threshold group, you must first create a group name. For this, perform the following steps.
1.
Open the Groups and Thresholds Configuration dialog box and click the Create button on the Groups tab
page. The Create Group dialog box is displayed.
Figure 9-11 Create Group Dialog Box
2.
Type a group name in the Enter a group name box. A name can contain any combination of letters and
numbers; however, the name cannot have more than 30 characters.
3.
Click the OK button.
9-5-2 Adding Threshold to a Group
After creating a group, you can add thresholds to the group. For details, refer to the Adding a Threshold to a
Group topic.
9-5-3 Removing Thresholds from a Group
1.
Open the Groups and Thresholds Configuration dialog box.
2.
Select a threshold group from the Groups box in the Group tab page.
3.
Select one or more thresholds from the Threshold(s) list box.
4.
Click the Remove button.
5.
A confirmation message box asks if you want to remove the threshold. Click the Yes button to delete the
selected threshold(s).
9-5-4 Deleting a Threshold Group
1.
Open the Groups and Thresholds Configuration dialog box.
2.
Select the group from the Group list.
3.
Click the Delete button.
4.
A confirmation message box asks if you want to delete the threshold group. Click the Yes button.
9-5-5 Assigning a Triggering Condition to a Group
For a group, you have two triggering options.
•
Any: Trigger the group alert when any of its individual members is triggered.
•
All: Trigger the group alert only when all of its members are triggered
To assign the group triggering condition, select All or Any from the Operator list on the Groups tab page of the
Groups and Thresholds Configuration dialog box.
Using SystemAlert
130
9-5-6 Setting a Severity Level for a Group
You can assign a severity level to a group threshold. The end user can define behavior for each level of severity.
Select a severity level from the Severity list on the Groups tab page of the Groups and Thresholds Configuration
dialog box.
9-5-7 Creating an Alarm Message for a Group
When a group threshold is triggered, OVNPM sends notification in the form of a message. You write the text of
the message.
Type the message text in the Message box in the Groups tab page of the Groups and Thresholds Configuration
dialog box. You can use any combination of characters.
9-6 Activating Thresholds
A threshold can be active or inactive, as follows.
•
Active: SystemAlert monitors this threshold
•
Inactive: SystemAlert does not monitor this threshold
Threshold groups only take into account thresholds that are active. If any threshold in a group is active, then the
group is automatically active.
When a threshold is active, a threshold alarm can be in a normal or an alert state.
•
Normal: Threshold condition has not occurred
•
Alert: SystemAlert detected that the threshold condition has occurred
To activate one or more thresholds, perform the following steps.
1.
Open the Groups and Thresholds Configuration dialog box and click the Thresholds tab to access the
corresponding tab page.
2.
Select one or more thresholds from the Threshold list box.
3.
Select the ON check box. The word ON appears next to the name in the Threshold list.
To deactivate a threshold, clear the ON check box.
Using SystemAlert
131
9-7 Activating Alarm Reception
You can switch alarm receipt on or off using the Alert tab page in the Display Agent window.
The Start and Stop buttons, which appear in the Alert tab page, are toggle commands. To start receiving alarms,
click the Start button. Alarm receipt is active. To stop receiving alarms, click the Stop button. Alarm receipt is
inactive. You can switch back and forth from one state to another.
To automatically display alarms when you open the Alert tab page, select on the Launch at Startup check box.
Figure 9-12 Starting and Stopping Alerts
Using SystemAlert
132
9-8 Alarm Log
The Alarm Log tab page shows the date and time an alarm was issued and threshold information.
Figure 9-13 Alert Alarm Log Tab Page
The following table explains the icons in the Alarm Status and Alarm log windows.
Table 9-1 Alarm Status and Alarm log Windows Icons
Icons
Explanation
Represents alarms that are in alert status.
Represents alarms that have returned to normal status.
Represents an alert for server problems.
Represents group alarms in normal status.
Represents group alarms in alert status.
To gain access to the Alarm Log tab page, click the Alarm Log tab as soon as a threshold or group threshold
reaches alert status. The alarm is displayed in one of the following boxes on the Alarm Log page:
•
The Group Alarms box displays alarms resulting from group thresholds.
•
The Threshold Alarms box displays alarms resulting from simple thresholds.
The Group Alarms and Threshold Alarms boxes display concise summaries of the thresholds issuing the alarm.
Using SystemAlert
133
9-8-1 Opening a View from the Alarm Log Window
When a threshold alarm occurs, you may want to open a view containing the threshold metric in order to
examine current or past behavior.
To open a View from the Alarm Log Window, perform the following steps.
1.
Click the Alarm Log tab to access the corresponding tab page.
2.
Select an alarm from the Threshold Alarms box and right-click it.
3.
Click the Open View option in the displayed menu. The Alarm Information dialog box opens.
Figure 9-14 Alarm Information Dialog Box
4.
Select a view from the View(s) list. This box lists all views containing the metric referenced by the threshold.
5.
Click the Open View button. The view window is displayed.
Figure 9-15 View Window
Using SystemAlert
134
9-9 Alarm Status
The Alarm Status tab page is displayed by default when you access the Alert tab page.
Figure 9-16 Alert Alarm Status Tab Page
From the Alarm Status page, SystemAlert displays the status of all active thresholds in one of the following boxes:
•
The Activated Groups box displays group thresholds that are in alert status, or group thresholds that
were in alert status, but are currently in normal status.
•
The Activated Thresholds box displays simple thresholds that are in alert status, or simple thresholds that
were in alert status, but are currently in normal status.
Thresholds in alert status display an alarm indicator.
9-9-1 Displaying Individual and Group Alarms
When you receive numerous alarms, you can organize them to easily target the source of a problem. From the
Alarm Status tab page, you can display the following type of alarms:
•
All threshold alarms at the same time.
•
Threshold alarms associated with a specific group.
•
Threshold alarms that do not belong to any groups.
To display all threshold alarms, click the
icon in the Activated Groups box.
icon in the Activated
To display all threshold alarms that do not belong to a group alarm, click the
Groups box.
The threshold alarms that are not in a group alarm appear in the Activated Thresholds box.
Using SystemAlert
135
When investigating details about alarms from the Alarm Log tab page, you can display or hide the threshold
alarms that belong to group alarms. To display the threshold alarms that belongs to a group, right-click a
threshold alarm in the Threshold Alarms box. A short-cut menu appears. Select the Show Individual Thresholds of
Group Alarms option. The threshold alarms appear in the Activated Thresholds box.
NOTE: Although you can view threshold alarms that belong to a group alarm, they do not trigger alarm
notifications, such as popup windows or e-mail notifications
9-9-2 Displaying Threshold Details
By default, both the Activated Groups and the Activated Thresholds boxes display concise summaries of the
thresholds issuing the alarm.
To include threshold details, in the Activated Thresholds box of the Alarm Status tab page, double-click any group
threshold icon or threshold. Alternatively, right-click the line and select the Enlarge option from the shortcut menu.
To return to a concise display format, in the Activated Thresholds box of the Alarm Status window, double-click
any line. Alternatively, right-click the line and select the Shrink option from the shortcut menu.
9-9-3 Opening a View from the Alarm Status Tab Page
When a threshold is in alert status, you may want to open a view containing the threshold metric in order to
examine current or past behavior.
To open a view from the Alarm Status tab page, perform the following steps.
1.
Select and right-click an alarm in the Activated Thresholds box.
2.
From the menu displayed, click the Open View option. The Threshold Information dialog box opens.
Figure 9-17 Threshold Information Dialog Box
3.
Select a view from the View(s) list and click the Open View button. The selected view opens in the view
window.
Using SystemAlert
136
9-10 Defining Alarm Behavior
For each severity level, you can define alarm behavior. Behavior options apply to the current user of the Display
Agent. Different users can personalize alarm behavior in their workspace.
NOTE: To define alarm behavior, you must be in Expert Mode
9-10-1 Setting Severity Level Options
You can set the following options for each severity level.
Table 9-2 Severity Level Options
Option
Description
Color
Sets the color used to display the threshold text on your page
Sound
Issues the system beep or plays a sound file
Popup a Window
Opens a pop-up window with the alarm message
Send an E-Mail
Sends E-mail to a list of addressees
Follow the steps below to define alarm behavior for a severity level.
1.
From the Alert tab page, click the Notification button. The Configure Alarm Notification dialog box opens.
Figure 9-18 Configure Alarm Notification Dialog Box
2.
From the Alarm Levels box, select the severity level for which you want to define alarm behavior.
3.
Select a color from the Color box.
4.
To display the alarm message in a pop-up window, select the Popup a Window check box.
5.
To attach a sound file, select the Sound check box and select the file. You can accept the default system
beep or specify a .WAV sound file.
6.
Select the Send an E-mail to check box to send alarms using electronic mail. This activates the options in the
Mail area. You can specify the Recipients and Send a Test Message using the fields in the Mail area. Use
the E-mail Settings button to configure the e-mail settings.
7.
You can control the maximum number of messages that a log window contains. When the number reaches
the maximum, older messages are removed as new ones are added. To set the maximum number of
messages, specify the number of alarms using the Number of Alarms spin box.
8.
To save the severity level options and to close the dialog box, click the OK button.
Using SystemAlert
137
9-10-2 Defining E-Mail Recipients
If you have an electronic mail system, you can designate your own set of recipients to notify by e-mail. Before
defining e-mail recipients that you want to receive alarm notifications, you must have a basic understanding of
the e-mail program installed on your computer.
You configure e-mail settings according to the type of e-mail program available on your computer. The OVNPM
Display Agent can use Messaging Application Program Interface (MAPI) or Simple Mail Transfer Protocol (SMTP)
to send alarm notifications.
If MAPI is installed on your computer, MAPI is selected as the default option to send e-mail notifications. SMTP is
selected otherwise.
If you use an e-mail program that uses the SMTP protocol, such as Lotus Notes, you must have the numerical IP
address of the SMTP server to configure an alarm notification using e-mail. This information is available from your
network administrator.
To define e-mail recipients of alarm notifications, perform the following steps.
1.
From the Alert tab page, click the Notification button. The Configure Alarm Notification dialog box is
displayed.
2.
Click the E-mail Settings button. The E-mail Settings dialog box is displayed.
Figure 9-19 E-mail Settings Dialog Box
3.
Select a setting click the OK button. For e-mail programs that use the SMTP protocol, you must enter the IP
address and your e-mail account, if required by your SMTP server.
4.
In the Configure Alarm Notification dialog box, select the Send an E-Mail to check box. This activates the
Mail area becomes available.
5.
Perform any one of the following.
•
If your e-mail program uses MAPI, click the Select button. The Address Book dialog box opens.
•
Select the name and e-mail addresses of the recipients and click the OK button.
•
The e-mail addresses appear in the Recipients box. If the recipients are not on the internal address list,
type the addresses in the Recipients box.
•
If your e-mail program uses the SMTP protocol, you must enter the e-mail addresses of the recipients
manually in the Recipients box. Separate each address with a semi-colon. The SMTP protocol does not
support interactive selection of e-mail addresses from an address book nor does it support address
aliases.
6.
If you want to test the e-mail settings, click the Send a Test Message button. A test message is sent to each email address in the list.
7.
Click the OK button.
Using SystemAlert
138
9-11 Detecting Runaway Process Loops
The runaway loop detection feature of the SystemAlert module provides automatic supervision of your system. It
informs you of disturbing events on any process in the following areas:
•
Excessive CPU Consumption
•
Excessive Memory Consumption
Default values, which set a limit, exist for both CPU consumption and memory consumption.
Due to the continuous collection of data every 15 or 30 seconds, OVNPM can immediately detect and report if
CPU and memory consumption have exceeded their default values. This situation indicates a runaway process
loop. OVNPM automatically sends SystemAlert messages to the Display Agent. The Display Agent immediately
opens the Server Messages window with the appropriate message.
Reading Alert Messages
The first item in an alert message indicates if the process loop is an excessive CPU use (CpuLoop) or an excessive
memory use (MemLoop).
The table below explains the different elements in an alert message.
Table 9-3 Alert Message Components
Item
Description
Cpu
CPU number where the process is running.
Cpu Busy
Percentage of time the CPU spent executing the process.
CpuDist
Percentage of time usage of the CPU where the process is
running, in proportion to the CPU activity during the last
collect interval.
CreatTime
Creation time of the process.
CurPages
Number of memory pages that have been swapped by the
process.
MsgRcvd
Number of messages received by the process during the last
collect interval.
MsgSent
Number of messages sent by the process during the last
collect interval.
OldPg
For MemLoop, previous number of used memory pages
followed by the number of times memory use has continuously
increased (prefixed by the symbol #).
OldPri
For CpuLoop, previous priority of the process.
PageFlt
Number of page-faults for the process during the last interval
collection.
Pin
Process Identification Number of the current process.
Pri
Executing priority of the process.
Process
Process name or unit name of the process.
Program
Complete program file name of the process.
PrsTime
Process time of the process.
RcvQLen
Number of messages on the process reception queue.
Term
Full name of the HomeTerm of the process.
User
Owner (Group, User) of the process.
You can clear or copy the content of the server messages in the information window. Use the right mouse button
to display a shortcut menu, and click the appropriate command. For details, refer to Configuring Loop Detection
chapter in the OVNPM Server Guide.
Using SystemAlert
139
9-12 Detecting Changes in Availability
The ability of the SystemAlert module to detect changes in availability provides automatic supervision of your
system. It informs you of disturbing changes in the following areas:
•
Devices Configured on a Node
•
Processes in Applications Defined on a Node
Each time a device or a process belonging to an application changes status, an alert message is sent to the
SystemAlert window.
For details, refer to Configuring Availability Chapter in the OVNPM Server Guide.
9-13 Detecting Incidents on a File
The ability of the SystemAlert module to detect incidents on a file provides monitoring of the size of files.
Each time a monitored file exceeds designated or default thresholds of related metrics, an alert message is sent to
the Display Server process that will forward it to designate output devices.
For details, refer to Configuring File Scanning chapter in the OVNPM Server Guide.
Using SystemAlert
140
10 Managing Scheduled Jobs
10-1 Scheduler
Dashboards and DataSets that you schedule for printing and exporting are known as jobs within the context of
Scheduler.
To display the Scheduler tab page, click the Scheduler tab in the Display Agent window.
Figure 10-1 Scheduler Tab Page
This tab page lists the names of all jobs that are scheduled for printing or exporting, along with the date, time,
and job status code.
After a job is completed, a status code appears next to its name and a new job is scheduled for the next print
cycle.
The Display Agent may not be running at the time of a scheduled job. The first time you open the Display Agent
after the print or export time, a message box indicates that you can recover any unperformed jobs.
Managing Scheduled Jobs
141
The status codes for a print job are listed in the table below.
Table 10-1 Print Job Status Codes
Status Code
Explanation
Print job
To be printed or exported
Done
Printed or exported
Error
An error occurred while printing or exporting
Recoverable
Can be printed or exported at the current time, instead of the
scheduled time
NOTE: You cannot schedule a dashboard or DataSet if units are missing. If there are units missing from a
dashboard, an error message appears. To display missing units, select the Show Missing Units option from the
Tools menu.
10-2 Scheduling a New Job
You can schedule a dashboard for printing or a DataSet for exporting from the Scheduler tab page. When
scheduling a job, you set the following parameters.
Table 10-2 Scheduler tab page - Parameters
Parameters
Option
Description
Frequency
Once
Prints or exports the job one time only.
Daily
Prints or exports the job daily.
Weekly
Prints or exports the job weekly.
Monthly
Prints or exports the job monthly.
Specific Date
Indicates the job date.
Day of the Week
Indicates the job day.
Day of the Month
Indicates the job month.
Date Offset
An Integer
Indicates the numerical relationship
between the job results and schedule
date. For example, to print or export a
job from yesterday, enter a Date Offset
of 1.
Weekdays Only
(Check Box)
Indicates whether to exclude weekends
when calculating date offset. For
example, if the job date falls on a
Monday and the date offset is 1, the
selection Weekdays only schedules the
job for the preceding Friday.
Time
Time of Day
Indicates the job time.
Date
Always Add Date to File Name
This option applies to all scheduled jobs
in the Scheduler desktop window.
If you select this option, the date of the
data is added to the file name.
If you clear this option, the file is saved
using the name as indicated in the Path
box.
This information is also added to jobs
scheduled at a later date.
Managing Scheduled Jobs
142
To schedule a new job, perform the following steps.
1.
Click the Add DataSet or Add Dashboard buttons in the Scheduler tab page. The Add Job dialog box is
displayed.
Figure 10-2 Add Job Dialog Box
2.
Select a job from the DataSet box. DataSet box will be replaced with the Dashboard box in case you
clicked on the Add Dashboard button in the previous step.
3.
Select a frequency option using the Frequency area. The options available are: Once, Daily, Weekly and
Monthly.
4.
Set the job date using the Date spin box. The Date box is not available when you select the frequency as
Daily.
5.
To schedule a job whose results are before the scheduled date, indicate the number of days in the
DateOffset box.
6.
To schedule jobs on weekdays only, select the Weekdays only check box. This option enables the scheduler
to print or export the jobs from Monday to Friday. This field is available only when the Daily or Monthly
frequency options area selected.
7.
In the Time box, select the time when the job will be performed.
8.
If you are printing a dashboard, select a printer from the Printer list.
9.
If you are exporting a DataSet, choose the folder to save the file in the File area. You can save the file in
any folder on your disk or network.
10.
Click the OK button to complete the procedure. The job name is copied to the Scheduled Jobs box in the
Scheduler tab page.
10-3 Executing Scheduled Jobs Immediately
You can print or export any job, or any job with a recoverable status. This does not affect the schedule of future
printing or exporting. To carry out a scheduled or recoverable job immediately, perform the following steps.
1.
Select the job name from the Name column in the Scheduled Jobs list.
2.
Click the Do It button. The name of the job is copied to the Job Queue box. The job is removed from the job
queue list as soon as it is complete.
Managing Scheduled Jobs
143
10-4 Examining the Contents of Scheduled Jobs
To examine the Contents of Scheduled Job, perform the following steps.
1.
Select the job from the Scheduled Jobs box.
2.
Click the Show button. A Show Job dialog box opens, which displays the contents of the job.
Figure 10-3 Show Job Dialog Box
3.
To close this dialog box after reviewing the information, click the Close button.
Managing Scheduled Jobs
144
10-5 Modifying a Scheduled Job
To change any of the printing options for an existing job, perform the following steps.
1.
Select the job name from the Name list in the Scheduled Jobs box.
2.
Click the Modify button. This opens a Modify Job dialog box.
Figure 10-4 Modify Job Dialog Box
3.
Change the job options using the various fields in the dialog box. The options are the same as those used
for scheduling a new job.
4.
Click the OK button to modify the job.
10-6 Removing a Scheduled Job
To delete a scheduled job, perform the following steps.
1.
To delete a scheduled job, select the job name from the Name list.
2.
Click the Remove button.
3.
A confirmation dialog box appears to confirm your choice. Click the Yes button to complete the procedure.
10-7 Purging Jobs
You can remove all jobs from the Scheduler tab page that have a status of Done, Error, or Recoverable. To clear
all past jobs at one time, click the Purge button.
Managing Scheduled Jobs
145
11 Exporting Data: DataSet
11-1 What is DataSet?
DataSet is your access to the stored data of SystemInsight and SystemTrend metrics. SystemInsight, SystemTrend,
and DataSet display the same type of information, however, each option uses a different presentation format.
You can design one report that meets your particular needs.
DataSet permits flexibility in the investigation process with the following options:
•
You select the time reference of each metric. In a DataSet, time references can be independent of each
other.
•
You determine the time to start and stop data extraction. DataSet permits a larger number of extracted
values than a SystemInsight or SystemTrend graphical display. The maximum size of a DataSet for a
SystemInsight metric is 5760 values.
•
The maximum size of a DataSet for a SystemTrend metric is 744 values.
•
You can combine the metrics from SystemInsight and SystemTrend into the same DataSet.
You can use DataSet to export results to another application. DataSet displays the collected data in tabular
reports, which allows you to preview the collected data before export. OVNPM takes this data and creates a file
in text format. You can export this file to a spreadsheet program, such as MS-EXCEL.
SystemInsight, SystemTrend and DataSet display the same type of information, although they use different
presentation formats.
Exporting Data: DataSet
146
11-2 Creating a DataSet
When you select the DataSet tab in the Display Agent desktop window, the DataSet tab page appears on your
page. The first time you open this page, you have empty list boxes.
To create a dataset, perform the following steps.
1.
Click the Create button in the Dataset tab page.
2.
The New DataSet icon appears in the DataSets box. Enter the name of the new DataSet, as shown in the
following figure.
Figure 11-1 Adding New DataSet
3.
Click the Add Insight button to add a SystemInsight metric to the DataSet. Click the Add Trend button to add
a SystemTrend metric to the DataSet.
Exporting Data: DataSet
147
4.
The Add Insight Metric or Add Trend Metric dialog box is displayed depending on the button you selected
in the previous step. Select a domain from the domain list. In the Metrics area.
Figure 11-2 Add Insight Metric Dialog Box
5.
A list of available metrics appears in the Metrics list. Select a metric from the Metrics list.
6.
Click the Add button. The metric and its related icon appear in the Selected Metrics box.
7.
Select a unit from the Units box. The unit is displayed next to the selected metric.
Exporting Data: DataSet
148
8.
Click the OK button. The DataSet tab page displays the metric in the Contents box.
Figure 11-3 DataSet Tab Page
11-3 Data Extraction
Time parameters affect results by influencing the following information:
•
Date and time of the data extraction
•
Extraction time interval which determines the degree of granularity of the results
11-3-1 Defining Time Parameters
To define time parameters, perform the following steps.
1.
Select one or more metric name(s) from the Metric list in the Contents box.
2.
Click the Time button. The Time Parameters dialog box appears on the page.
Figure 11-4 Time Parameters Dialog Box
3.
Select the frequency of data extraction using the Granularity box. There are different frequency rates for
SystemInsight and SystemTrend metrics.
4.
Select the basic time period for data extraction in the Time Unit box. This period becomes the time unit for
the Offset box. There are different time units for SystemInsight and SystemTrend metrics.
Exporting Data: DataSet
149
11-3-2 Starting Data Extraction
After you select the granularity and time unit parameters, you must define the starting point for data extraction.
This can be done using the From area in the Time Parameters dialog box.
To define the point when data extraction starts, in relation to the amount of time before data extraction stops,
enter a number in the Offset box.
For example, you choose month as the time unit, and an offset of 2 months as the starting point. You decide to
stop data extraction at the current time, which is July 24th. DataSet displays results from June 1st to July 31st.
To choose a data extraction period that varies according to the current time, select the Floating check box.
For example, you choose month as the time unit, and an offset of 2 months as the starting point. You select the
Floating box. You stop data extraction at the current time, which is July 24th. DataSet displays results from May
24th to July 24th at 11:59:59.
You can also select an exact time to start data extraction. Select the Time option and enter the time in the
corresponding boxes.
11-3-3 Stopping Data Extraction
After you choose the time that data extraction starts, you must choose the time when the extraction stops. You use
the To area in the Time Parameters dialog box.
You can define the point when data extraction stops, in relation to its starting point. You can also select an exact
time to stop data extraction.
To stop data extraction at the current time, select the Current Time option.
To select a time to stop data extraction, in relation to an amount of time after the extraction starts, enter a number
in the Offset box. For example, you choose day as the time unit. You decide to start data extraction on July 22,
1996. You want to stop data extraction 14 days after July 22nd. You enter an offset of 14. The closing date is
14 days after July 22nd.
To stop data extraction at an exact time, other than the current time, select the Time option. Enter a date In the
corresponding boxes.
After choosing all the time parameters, the dialog box displays the data extraction interval and the estimated
data size. Estimated data size refers to the estimated number of data extraction values in the tabular report for
the selected metric.
Click the OK button. The DataSet window displays the metric with its parameters.
11-4 Modifying a DataSet
From the DataSet tab page, you can modify a DataSet or the metrics that comprise the DataSet.
•
To delete a DataSet, select the DataSet and click the Delete button.
•
To rename a DataSet, select it and click the Rename button.
•
To remove a metric from the DataSet, select the metric and click the Remove button.
•
To replace a metric, or change the metric unit, select the metric and click the Metric button.
•
To change the order that a metric appears in the tabular report, select the metric and use the arrows to
move the selected metric to a different position in the Metric list.
11-5 Saving DataSet Configurations
You can save a description of the configuration of all user-defined dashboards as a text file. This information
provides a summary of your configuration, which you can use for backup purposes.
To export DataSet configurations to a text file, perform the following steps.
1.
From the Node menu, select the Export option.
2.
Select the DataSet Configurations option from the displayed menu. The Export DataSets dialog box opens.
3.
Choose a folder to save the file and click the Save button. The configurations save as a text file.
NOTE: When you export DataSets that contain user-defined metrics, a description of the formula of the metric
is saved in the file.
Exporting Data: DataSet
150
11-6 Printing DataSet Configurations
To print the description of the configuration of DataSets, perform the following steps.
1.
From the Node menu, click Print  DataSet Configurations.
Figure 11-5 Node Menu – Print DataSet Configurations
The Printer Selection dialog box is displayed.
Figure 11-6 Printer Selection Dialog Box
2.
From the Printer list, select a printer.
3.
From the Style Sheet list, select a style sheet.
4.
Click the OK button.
Exporting Data: DataSet
151
11-7 Scheduling DataSet Results for Export
After you define all parameters of the DataSet, you can display the results in tabular format or export the table to
another application.
To export DataSet results to another application at a specified date and time, click the Schedule button. The
Schedule Export dialog box opens.
Figure 11-7 Schedule Export Dialog Box
Enter the export parameters, and click the OK button.
For details, refer to the Scheduling a New Job topic.
To view the export schedule of a DataSet file, click the Scheduler tab. The name of the DataSet and its export
parameters appear in the Scheduled Jobs box. The tabular results will be exported to another application at the
designated time.
Exporting Data: DataSet
152
11-8 Opening a DataSet
To open an existing dataset, perform the following steps.
1.
Click the DataSet tab of the Display Agent desktop window to access the corresponding tab page.
2.
Select a DataSet icon from the DataSets box. The Contents box displays the associated metrics and
parameters.
3.
Click the Open button. Alternatively, double-click the DataSet icon.
A secondary window displays the collected data of the DataSet. The amounts of time to process the data and
display the extraction results depend on the number of metrics in the DataSet, and the time reference period of
each metric.
Figure 11-8 DataSet Window
In a DataSet report, you scroll vertically through the table to display the collected values of a particular metric.
You scroll horizontally through the table to display the collected values of the next metric.
Exporting Data: DataSet
153
12 Real-Time Monitoring: Navigator
12-1 What is Navigator?
Navigator enables you to analyze critical system performance information on a microscopic level, in real-time
mode. It monitors CPU usage, applications, processes and devices.
You can request information about specific areas, and then view the results in tabular format on Web pages.
Data entries in the table can appear as hyperlinks to more detailed information, which is then displayed on
another Web page. The new Web page displays another table that can then contain hyperlinks to finer details.
Navigator functions are accessible by Display Agent or any Web browser that is compliant with HTTP 1.0, HTML
3.2, JavaScript 1.2, Netscape 4.7 and Microsoft IE 4.0 and higher versions.
You can add Web pages from the Navigator to the Favorites list in the Microsoft Internet Explorer, or as
bookmarks in the Netscape Navigator.
12-2 Getting Started with Navigator
Click the Navigator tab on the Display agent window to access the Navigator features. The tab page contains
various icons for various activities. To access the Navigator menu, click the Navigator Menu icon.
Figure 12-1 Display Agent Navigator Tab Page
Real-Time Monitoring: Navigator 154
12-3 Navigation Menu
The menu displayed on the left side of the Navigator window provides access to various Navigator
functionalities. The various options available are as follows.
•
Dashboard: Dashboards display multiple views in a single window. Each dashboard contains a set of views
and reports that you can manage as a single unit. Dashboards simultaneously display the individual
elements. Alternatively, dashboards display views one at a time in an automatic cycle.
•
Availability: The Availability feature allows you to display the status information of devices and
applications. You can monitor the devices configured on your node as well as the processes in your
applications.
•
Activity: The Activity feature allows you to display the status information for the CPUs, files and user &
group activities.
•
Events: The Events feature allows you to display pending processes and process transitions information.
•
Zoom: The Zoom feature allows you to display detailed information on selected processes, files and
devices.
•
DataBase: This feature allows you to extract data form OVNPM Trend database on the selected node.
•
Help: The Help link can be used to access the Navigator Online Help.
•
Admin: The Admin link allows the user to perform the administrative functions like Computer resource
location setup, password and user profile maintenance along with registration.
•
Switch Menu: Navigator allows the user to expand and collapse the Navigation pane to show/hide the
sub-menus available for different menus using the Switch Menu link.
For details on the various functionalities of Navigator, refer to the OVNPM Navigator Guide.
Real-Time Monitoring: Navigator 155
13 Creating SystemInsight Metrics
13-1 SystemInsight Metrics
You can combine existing SystemInsight metrics to form a new metric. You can also include the new metric in any
SystemInsight view.
The process of metric creation includes the following:
•
Selecting metrics to combine
•
Building a metric expression
•
Selecting units for metrics.
After you create a metric, you can use the new metric as you would use any SystemInsight metric. For example,
you can display a new metric in both real-time and replay modes.
To build a new metric, you must be in Expert mode.
13-2 Selecting Metrics to Combine
To create a user-defined combined metric, the first step is to select the metrics to combine.
1.
From the Insight tab page, select the Metrics/Units tab, and click the Build button, as shown in the following
figure.
Figure 13-1 Build New Metric Dialog Box
Creating SystemInsight Metrics 156
The Build New Metric dialog box is displayed.
Figure 13-2 Build New Metric Dialog Box
2.
Enter a name for the new metric in the Name box.
3.
Select a domain using the Metric area. The list of available metrics for the domain appears in the list.
4.
Select one or more metrics from the list.
5.
Click the << button to add the metric(s) to the Selected Metrics list.
As each metric is added to the list, it is identified by a letter (A, B, C,...). Each unit reference is identified by
a question mark and is assigned a relative number within its domain (?1 node, ? CPU,...).
6.
Repeat the previous three steps until you have selected all the metrics you want to combine.
You can also build a metric expression that designates several units for a metric. For example, you can
build a metric that computes the sum of all disk connections.
NOTE: To build a metric with several units, select the metric from the Metrics box. The corresponding units are
displayed in the Unit box. Select the required units and click the Repeat button. Repeat the steps to add more
metrics and units.
Creating SystemInsight Metrics 157
13-3 Building a Metric Expression
After you select the metrics to combine, you must build a metric expression and designate a unit for each metric.
The value of a combined metric is the result of a particular operation on the values of its constituent metrics. A
metric expression indicates the operation to carry out on constituent metrics.
The following table explains the operators that you can use.
Table 13-1 Metric Expression - Allowed Operators
Operators
Description
+, -, *, /
Arithmetic Operators
Sum(), Max(), Min(), Ave(), Abs(),
Raise to a Power Mathematical & Statistical Functions
<, <=, =, >=, >
Comparative Operators
And, Or
Logical Operators
Log, Exponent
Scientific Functions
sin, cos, tan
Trigonometric
()
Value in Parenthesis
Steps to build a metric expression have been listed below.
1.
From the Build New Metric dialog box, select an operator from the Expression list.
2.
To select a metric, double click a metric from the Selected Metrics box, the letter that represents the metric
appears in the Expression box.
When necessary, replace the letter references in the metric expression (for example, A,B,C,...) by the
identification letters of the selected metrics. Delete any letter references unneeded from the metric
expression.
3.
Enter a value in the Scale box. This is the default value for the metric when it is displayed in a view. The
value already in the box is the sum of the scales for all the individual metrics used.
NOTE: In a comparative expression, OVNPM substitutes zero if the result is false and one if it is true. Example,
if A > B is true, the value of the expression is 1
13-4 Designating Units in a Combined Metric
To complete the creation of a combined metric, you must designate either an actual or a generic unit for each of
its constituent metrics.
If you designate an actual unit, the metric is calculated only for that unit.
If you designate a generic unit, the actual unit is assigned at the time any view containing the metric is opened.
If you build a combined metric with generic unit references, you can designate the way in which actual units are
assigned at execution time. This enables you to avoid ambiguous assignments and assure that calculations are
performed correctly.
For example, assume that you are building a combined metric to compute an average of three individual, but
identical, metrics, Avg (A,B,C). You want to be sure that each of the individual metrics refers to a different unit.
Otherwise, your result is unreliable because there is no other way to assure that the same unit would not be used
more than once in the calculation.
In this example, the desired relative unit assignment is metric A[?1 unit], metric B[?2 unit], and metric C[?3 unit].
Because of this unit specification, OVNPM ensures that a different unit is assigned to each metric.
Creating SystemInsight Metrics 158
You designate your choice of relative unit assignments by changing the default unit numbers (?1 node, ?2
CPU,...) that were assigned at the time the metric was selected.
To assign either an actual unit or to change the generic unit for one or more metrics, perform the following steps.
1.
From the Build New Metric dialog box, choose one of the lettered metrics from the Selected Metrics list. The
relative unit names assigned to that domain (?1 node, ?2 node,...) appear in the left window in the Unit
box. The actual units available within the domain appear in the right window.
2.
From the Unit box, select one of the generic unit references or actual unit names. The unit appears next to
the selected metric in the metrics list. Repeat Step 1 and Step 2 until the unit assignments are complete for
each of the metrics being combined.
3.
Click the OK button to save the new metric. The Metrics/Units page appears with the new metric in the
Available Metrics box.
13-5 Modifying a Combined Metric
You can modify any aspect of a combined metric. You cannot modify metrics supplied by OVNPM.
Before you can modify a combined metric, close any open view or dashboard that uses the combined metric.
1.
From the Insight tab page, select the Metrics/Units tab.
2.
Select a combined metric from the Available Metrics list.
3.
Click the Modify button. The Modify Metric dialog box opens. You can make any changes to the metric
following the same procedures described for creating a combined metric.
Figure 13-3 Modify Metric Dialog Box
4.
Click the OK button. The Metrics/Units page appears with the modified combined metric in the Available
Metrics box.
13-6 Deleting a Combined Metric
To delete a combined metric, perform the following steps.
1.
From the Insight tab page, select the Metrics/Units tab.
2.
Select a combined metric to be deleted from the Metric list.
3.
Click the Delete button.
4.
A confirmation box is displayed. Click the Yes button to continue with the procedure.
Creating SystemInsight Metrics 159
14 Working with Finder
14-1 What is Finder?
The Finder is a tool for locating the occurrences of a particular character string within views, metrics, or units.
14-2 Starting Finder
The Finder can match on a full or partial search string. OVNPM also provides the option for case-sensitive
search.
1.
Click the Finder icon on the Display Agent Status bar.
Figure 14-1 Display Agent Status Bar Finder Icon
This action can also be performed using the Finder option in the Display Agent Tools menu.
2.
The Finder dialog box is displayed.
Figure 14-2 Finder Dialog Box
3.
Select the search option using the Type area. The options available are: View, Metric and Unit.
4.
Enter a full or partial search string in the Search on drop-down box. If you have performed searches in the
past, your previous ten search strings are listed in the Search on list.
5.
To perform a case-sensitive search, select the Case-Sensitive check box.
6.
Click the Find Now button. All elements that contain the search string appear in a scrollable list box.
Working with Finder 160
7.
If no match is found, the box is empty and the Finder displays the Pattern not found message.
Figure 14-3 Finder Dialog Box with Search Results
14-3 Understanding Search Results
The following table explains the results returned by the Finder based on search type.
Type
List
Is Used In
Unit
Unit List by Domain/Unit Occurrence
Component/Domain/View
Metric
Metric List
Dashboard/View
Component/Domain/View
View
View List
Dashboard Component/Domain
To locate other elements that use an item in the returned list, select an item in the list box. All references to that
item appear in the Is Used in list box. To open an element in the Is Used in list, select the element, and then click
the Open button.
Working with Finder 161
14-4 Copying Search Results to a Dashboard
You can view the search results as part of a dashboard. A dashboard displays multiple views in a single
window.
To copy search results to a dashboard, perform the following steps.
1.
Select a view from your search results in the Finder dialog box to display in a dashboard.
2.
Click the Copy to Dashboard button. The Copy to Dashboard dialog box is displayed.
Figure 14-4 Copy to Dashboard Dialog Box
3.
Select an existing dashboard. You can also create a new dashboard using the Create button.
4.
Click the OK button. The view appears as a window when you open the selected dashboard.
Working with Finder 162
15 Uninstalling OVNPM Display Agent
To uninstall OVNPM Display Agent from the computer, perform the following steps.
NOTE: Before beginning the un-installation, ensure that none of the OVNPM components are running.
1.
Click Start  Programs  HP OVNPM  Display Agent  Uninstall to start the un-installation process. The
OVNPM Display Agent Maintenance message box is displayed.
Figure 15-1 OVNPM Display Agent Message Box
2.
Click the OK button to continue. The OVNPM Display Agent Maintenance Welcome page is displayed. By
default the Remove option is selected.
Figure 15-2 OVNPM Display Agent Welcome Page Remove Option
Uninstalling OVNPM Display Agent
163
3.
To continue, click the Next button. The Confirm Uninstall box is displayed.
Figure 15-3 Confirm Uninstall Box
4.
Click the OK button to complete the process.
Uninstalling OVNPM Display Agent
164
Appendix A: Managing the Server Using Display Agent
OVNPM provides the Host Management Client to automate the server management procedures. This topic
describes the backup solution for diagnostic purpose if the Host Management Client fails.
Communicating with the Host Machine
You use the emulation window to communicate with the host machine to start the OVNPM server. The emulation
window contains an information box that displays all information that was received from the host machine. From
the emulation window, you can do the following tasks:
1.
To type commands to send to the host, use the entry box which is preceded by the greater than character.
Alternatively, select a command in the list box. The command appears in the entry field. The scrollable list
contains the most frequently used commands to connect, logon, and disconnect. These commands are
particular to your site.
2.
To add commands to the list, click the Edit button. A dialog box opens to type new commands.
3.
To enter commands in the entry box with non-standard characters, click the Advanced Commands button.
4.
To display all commands in the information window, click the Send button.
5.
To filter the presentation characters in the emulation window, select a filter in the Filter box. The default
value is TTY.
Figure A-1 OVNPM Modify Script Dialog Box
Creating a Connection Script File
You can create a connection script file that enables you to connect to an OVNPM node via a Telnet connection.
A connection script file contains the commands to start a Display Agent session. This file allows you to start a
Display Agent session without having to manually enter commands.
1.
Open the OVNPM Node Selection dialog box.
2.
Create or select an existing node. The Adapter Type must be set to AdapterTelnet32.
3.
Connect to the node.
4.
The emulation window opens.
5.
To enter the commands in the script, click the Edit button. The Modify Script dialog box opens. Most scripts
wait for a specific string pattern to be received and send a corresponding command. The script must
contain at least one session statement to indicate where the interactive Display Agent session takes place
and ends with the disconnection commands.
6.
To save your commands in the script, click the OK button.
7.
To test the script, from the emulation window, click the GO button. If the script works correctly, the
commands contained in the script appear in the emulation window and the Display Agent session starts.
8.
To verify the disconnection part of the script, from the Node menu, select Disconnect to return to the
emulation window.
Appendix A: Managing the Server Using Display Agent
165
9.
To set the option that automatically runs the logon script, from the site selection dialog box, click the Modify
button. Select Automatically Run Logon Script check box in the displayed dialog box.
Script File Commands
All script commands that start with a reserved keyword is automatically run. Reserved keywords are commands
that use SEND, RECEIVE and DELAY. If you use commands that do not begin with reserved keywords, they are
considered manual commands, which will stop the execution of the script. The following table explains the script
commands you can use in the emulator window.
Table 2 Script File Commands
Command
Explanation
SEND “command”
Sends the command between the quotation marks to the server.
If the command string contains quotation marks (“), you must use double quotation
marks.
SEND PASSWORD “crypted password”
Decrypts the password between the quotation marks, then sends it to the server.
This command ensures that passwords do not appear in the logon file.
To generate an encrypted password, from the Modify Script dialog box, insert a
SEND PASSWORD statement in the script. When you encrypt a password, you can
no longer decrypt the value.
RECEIVE“sentence” [TIMEOUT=NN]
Waits for the command to be sent by the server using the optional parameter
TIMEOUT. NN, which represents a time specified in milliseconds.
If the Display Agent waits longer than the time specified in the TIMEOUT parameter,
it stops at the sequence in the script when the time elapsed. When this occurs you
must continue manually
If you do not specify a value for the TIMEOUT parameter, the Display Agent
automatically waits sixty seconds to receive the command
DELAY NN
NN represents a pause in milliseconds that you specify.
STOP
Stops the execution of the script and enters debug mode. The execution of the script
also stops if a manual command is encountered. When this occurs, you can run the
script step-by-step, or continue to automatically execute the script.
SESSION
Indicates where the Display Agent interactive session occurs in the script. This
command must be inserted after the command that starts the Display Agent session.
Comments
Ignores the text after the semicolon (;).
Debugging a Script File
From the emulation window, you can troubleshoot errors that occur in a script file.
To start the debug mode from the emulation window, click Stop. The execution of the script stops and the debug
buttons are available. The following table explains the buttons that you can use to navigate through a script when
debugging statements.
Table 3 Debug Buttons
Button
Description
Stop
Stops the execution of the script. The debugging buttons become available.
Step
Executes the current statement.
Skip
Skips over the current statement to the next statement.
Go
Resumes execution of the script starting from the current statement. The debug buttons are grayed.
Restart
Starts at the first statement of the script. If the script is set to run in automatic mode, the script starts to carry
out the commands.
Appendix A: Managing the Server Using Display Agent
166
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising