Avaya PeriReporter User Manual

PeriReporter User’s Guide

(Software Release 1.0)

Publication#:

Document Release:

Release Date:

P0988093 Rev. 1.5 April 10, 2002

PeriReporter User’s Guide

Important Notice

Nortel Networks reserves the right to make cha nges in the content s of this publ icat ion including functions and specifications identified herein without notice.

The material contained in this document is intended for Nortel Networks personnel and licensed customers with a non-disclosure agreement or standard contract.

In the absence of a written agreement to the contrary, Nortel Networks assumes no liability for applications assistance, customer’s product/application/concepts, or infringements of patents or copyrights of third parties arising from the use of systems and architectures described herein. Nor does Nortel Networks warrant or represent that any license, either expressed or implied, is granted under any patent right, copyright, or other combina tion of technolo gy, archit ecture, or software as might be or is already in use.

This document should not be reproduced, disseminated, or otherwise disclosed without prior written consent from an officer of Nortel Networks.

This document has been copyrighted by Nortel Networks and may not be duplicated.

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

How to Use This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Organization of this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Conventions Used in This Manual . . . . . . . . . . . . . . . . . . . . . . . . . x

UNIX and Windows NT Conventions . . . . . . . . . . . . . . . . . . . . . xi

Manual (Man) Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Reference Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

What is PeriReporter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Three Components of PeriReporter . . . . . . . . . . . . . . . . . . . . . . . 19

PeriConsolidator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

PeriDefiner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

PeriReporter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Launch PeriReporter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Schedule A Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Sharing Data Between UNIX and NT . . . . . . . . . . . . . . . . . . . . . 24

Time Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Statistical Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Collection and Maintenance of Statistical Data . . . . . . . . . . . . . . 28

Single vs. Multi-node Environments . . . . . . . . . . . . . . . . . . 28

Defining Stat Events in a Single Node Environment . . . 29

Application Stat Events in a Multi-Node Environment . 30

PeriReporter and the VPS/is Network . . . . . . . . . . . . . . . . . 32

System and Application Statistics. . . . . . . . . . . . . . . . . . . . . 34

System Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Application Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

PeriProducer and VRAM Applications . . . . . . . . . . . . . 40

Gathering Application Statistics (Block Execution Statistics)41

Defining Application (Block Execution) Statistics . . . . 41

Determining Blocks Associated With a Counter . . . . . . 42

Passing Statistics Folders to a Linked Application . . . . . 43

PeriConsolidator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Data Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

# P0988093 Nortel Networks Confidential Page iii

PeriReporter User’s Guide

Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

PeriDefiner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

PeriDefiner Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Open a Report Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Defining a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

pchistory.log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Launch PeriDefiner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Launching PeriDefiner through PeriView . . . . . . . . . . . 54

Launch PeriDefiner through PeriReporter . . . . . . . . . . . 55

Save the Report Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Update the Report Settings. . . . . . . . . . . . . . . . . . . . . . . . . . 59

Lines for Report Title . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Report Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Column Heading Rows . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Rows per Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Rows for Subtotals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Rows for Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Report Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Default Detail Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Default Start/End Time . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Define Column Formulas and Mappings . . . . . . . . . . . . . . . 61

Column Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Data Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Update Individual Columns and Cells . . . . . . . . . . . . . . . . . 65

Display Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Column Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Define Subtotals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Define Totals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Column Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Column Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Global Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Screen Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Fill/Empty Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Print the Report Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

PeriReporter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Launch PeriReporter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Launching PeriReporter through PeriView . . . . . . . . . . 80

PeriReporter Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Page iv Nortel Networks Confidential # P0988093

Table of Contents

Generating a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Open a Report Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Select a Report Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Start Date and End Date . . . . . . . . . . . . . . . . . . . . . . . . . 84

Start Time and End Time . . . . . . . . . . . . . . . . . . . . . . . . 85

Override Column VPS Numbers . . . . . . . . . . . . . . . . . . 85

VPS Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Detail Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

List Files in Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Generate the Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Graph Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Plot Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Bar Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Area Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Candle Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Hilo Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Pie Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Scatter Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Stacking Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Grid Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Columns Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Titles Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Selected Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Global Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Screen Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Preview a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Export/Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Print a Generated Report. . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Other Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Step-by-Step

Sample Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Step-by-Step Sample Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

# P0988093 Nortel Networks Confidential Page v

PeriReporter User’s Guide

This page has been intentionally left blank.

Page vi Nortel Networks Confidential # P0988093

Preface

PeriReporter User’s Guide

Scope

The PeriReporter User’s Guide provides information for the use of the PeriReporter tool. It gives step-by-step instructions on gathering and displaying data from the Nortel Networks Media Processing Series system.

In addition to this document, the PeriView Reference Manual #9090722(I) may be particularly helpf ul when working with PeriReporter. It descr ibe s how to wor k within PeriView’s Graphical User Interface (GUI) and individually documents each of PeriView’s tools.

Intended Audience

This document is targeted for any PeriView user. That is, any person responsible for using PeriView to interact with the Nortel Networks Media Processing Server Series could use this information. This guide assumes that PeriView users have completed a Periphonics training program conducted as part of the initial system installation.

How to Use This Manual

This manual uses many standard terms relating to computer system and software application functions. However, it contains some terminology that can only be explained in the context of the Nortel Networks Media Processing Server Series system. Refer to the Glossary of MPS Terminology publication # 9090788(I) for definitions of these specific terms.

Initially, you should re ad this manual at least once, fr om sta rt to finish. Later, you can use the Table of Contents to locate topics of interest for reference and review.

If you are reading this document online, use the hypertext links to quickly locate related topics. Click onc e with your mouse while pos itio ned with you r cursor over the hypertext link. Click on any point in a Table of Contents entry to move to that topic. Click on the page number of any Index entry to access that topic page. Use the hyperlinks at the top and bottom of each online “page” to help you navigate the documentation. Pass your cursor over the Nortel Globemark to display the title, software release, publicat ion an d revision number , and rel ease date for the manual you are using.

For additional related information, use the Reference Material link in PeriDoc. To familiarize yourself with various specialized textual references within the manual, see

Conventions Used in This Manual on page x.

Periphonics is now part of Nortel Networks. The name Periphonics, and variations thereof, appear i n t his manua l only where it is ref err ed to i n a product. (For examples, a PeriProducer application, the PERImps package, the perirev command, etc.)

At certain points in this manual, MPS (Nortel Networks Media Processing Server Series) is analogous with VPS (Voice Processing Series). This is reflected in specific file names and directories, as well as certain software features.

Page viii Nortel Networks Confidential # P0988093

Organization of this Manual

This manual contains separate sections that describe the features and functions of the PeriReporter tool.

• Chapter 1: Introduction

This chapter discusses the general characteristics of the PeriReporter tool, including function, terminology, and individual components.

• Chapter 2: Statistical Maintenance

This chapter discusses the differences between single and multi node environments along with System and Application statistics. This chapter further discusses the collection and storage of statistical information for the Nortel Networks Media Processing Server Series system.

• Chapter 3: PeriConsolidator

This chapter discusses the various ways statistical data is gathered for use by the PeriReporter tool.

• Chapter 4: PeriDefiner

This chapter discusses how reports are designed for generation at a later time.

Preface

• Chapter 5: PeriReporter

This chapter discusses how reports are generated for specific dates and times.

• Chapter 6: Step-by-Step Sample Report

This chapter contains a step-by-step construction of a sample report.

# P0988093 Nortel Networks Confidential Page ix

PeriReporter User’s Guide

Conventions Used in This Manual

This manual uses different fonts and symbols to differentiate between document elements and types of information. These conventions are summarized in the following table.

Notation Description

Conventions Used in This Manual

Normal text

important term

system command

file name / directory

on-screen field

Book Reference

cross refer ence

Normal text font is used for most of the document. The Italics font is used to introduce new terms, to highlight

meaningful words or phrases, or to distinguish specific terms from nearby text.

This font indicates a system command and/or its arguments. Such keywords are to be entered exactly as shown (i.e., users are not to fill in their own values).

This font is used for highlig hting the names of disk directories , files, and extensions for file names. It is also used to show displays on text-based screens (e.g., to show the contents of a file.)

This font is used for field labels, on-screen menu buttons, and action buttons.

A term that appears within angled brackets denotes a terminal keyboard key, a telephone keypad button, or a system mouse button.

This font indicates the names of other publications referenced within the document.

A cross reference or man page reference is shown on the screen in blue. Click on the cross reference to access the referenced location. A cross reference that refers to a section name accesses the first page of that section. Click on the man page reference to elicit a pop-up window displaying the subject man page.

The Note icon identifies notes, important facts, and other keys to understanding.

The Caution icon identifies procedures or events that require special attention. The icon indicates a warning that serious problems may arise if the stated instructions are improperly followed.

The flying Window icon identifies procedures or events that apply to the Windows NT operating system only.

The Solaris icon identifies procedures or events that apply to the Solaris operating system only.

Page x Nortel Networks Confidential # P0988093

a. Windows NT and the flying Window logo are either trademarks or registered

trademarks of the Microsoft Corp orat ion .

b. Solaris is a trademark or registered trademark of Sun Microsystems, Inc. in the

United States and other countries.

Solaris and Windows NT Conventions

This manual depicts examples (command line syntax, configuration files, and screen shots) in Solaris format. In certain instances Windows NT specific commands, procedures, or screen shots are shown where required. The following table lists examples of general operating system conventions to keep in mind when using this manual with either the Solaris or NT operating system.

Solaris Windows NT

Environment $VPSHOME %VPSHOME% Paths $VPSHOME/common/etc %VPSHOME%\common\etc

Preface

Command <command> & start /b <command>

# P0988093 Nortel Networks Confidential Page xi

PeriReporter User’s Guide

Trademark Conventions

The following trademark information is presented here and applies throughout for third party products discussed within this manual. Trademarking information is not repeated hereafter.

Solaris is a tr adema rk or regist ered trade mark of Su n Micro systems , Inc. in the United States and other countries.

Microsoft, Windows, Windows NT, Internet Explorer, and the Flying Windows logo are either trademarks or registered trademarks of Microsoft Corporation.

Netscape Communications Corporation in the United States and other countries. Netscape’s logos and Netscape product and service names are also trademarks of Netscape Communications Corporation, which may be registered in other countries.

Manual (Man) Pages

Manual (man) pages provide access to documentation about Solaris system commands, Nortel Networks Media Processing Server Series commands, status/exception co nditions, and a larm information. Man pa ges may be disp layed from any command line on Solaris systems. On NT systems, man pages may be displayed from a DOS prompt/VSH prompt (the man page appears in a separate browser window: the browser used depends on what browsers are installed and what browser is set as the default). In addition, man pages are always accessible through PeriDoc’s Search page and through hypertext links in the documents.

and Netscape Navigator® are registered trademarks of Netscape

To access a Man Page for:

• a Solaris system command, use the syntax man <command> (Solaris only).

• a Nortel Networks Media Processing Server Series command, use the syntax

vpsman <processname> <command>.

On Solaris systems on ly, enter man vpsman for a det ailed description of using Nortel Networks Media Processing Server Series command manual pages.

• a Nortel Networks Media Processing Server Series alarm, use the syntax vpsalarm <processname> <alarm#>. On Solaris systems only, enter man vpsalarm for a detailed description of using alarm manual pages, or man alarmintro for an overvie w of Nortel Networks Media Processing Server Series alarms and the alarm database.

• a Nortel Networks Media Processin g Server Series statu s/exception condition, use the syntax conman <condition>. On Solaris systems on ly, enter man conman for a det ailed description of using Nortel Networks Media Processing Server Series condition manual pages.

The man page scripts rely on the Windows NT registry settings for default browser information. Older browsers do not set the registry entries required by the man page scripts. Do not use command line man pages if you are using browsers older than Netscape Navigator 4/Internet Explorer 4.

If you are viewing this document online, click any command highlighted in blue to open a window displaying the manual page for that command.

Page xii Nortel Networks Confidential # P0988093

Introduction

This chapter covers:

1. What is PeriRe porter?

2. Three Components of PeriReporter

3. Launch PeriReporter

4. Schedule a Report

5. Sharing Data Between Solaris and NT

6. Time Zones

PeriReporter User’s Guide

What is PeriReporter?

PeriReporter is a PeriView tool, consisting of three subtools - PeriConsolidator, PeriDefiner, and PeriReporter - each contributing to the process of collecting, maintaining, defining, and reporting statistical data for the Nortel Networks Media Processing Server Ser ies ne twork. Usi ng a Gra phical User I nterf ace (GUI ), it al lows a point and click specification of multiple report formats for each statistics record type. A report is viewed as a set of columns, with each column representing an application or system statistics defined counter. There is a row of cells for each time interval recorded in a statistics file.

When the PeriReporter Tools package is installed a .perireporter file is created in the default PeriReporter home directory ($VPSHOME/PERIprpt/prpt). When any changes are made i n the Global Sett ings, Scree n Color s, or Pr int S etup p ortio ns of the PeriDe finer or PeriRe porter components a new .perireporter file is created in your home directory. These changes are then saved in this new file. The original .perireporter file will remain unchanged. Eliminating the file residing in your home directory will reset all parameters back to their de fault settings. For additional in f orma ti on o n the installation of t he PeriReporter Tools pa ckage, refer to the Installing Graphical Tools on a Customer Supplied Workstation (9090504(I)) manual.

In a single node environment, each of PeriView’s tools reside on the Nortel Networks Media Process ing Serve r Serie s node and all tools will display on the tool bar. In a multi-node environment, PeriV i ew tool s resi de on e ach nod e i n the Nor tel Networks Media Processing Server Series network, but the PeriReporter tool typically reside s only on the node t h a t is designated as the si te for statistical collection and reporting. Therefore, in a multi-node environment, the PeriReporter tool will only display on the tool bar at the node(s) at which PeriReporter resides.

For additional information on single node environments, see

Defining Stat Events in a Single Node Environment on page 25.

Page 14 Nortel Networks Confidential # P0988093

Three Components of PeriReporter

PeriReporter consists of three parts, each dependent on previous input for required information.

PeriConsolidator

This program gathers all system and application statistics and consolidates them into 15 minute, hourly, daily, weekly, monthly and yearly file s. PeriConsol idator shou ld be configured in the crontab and set to run once a day at a convenien t time, pre ferab ly when the Nortel Networks Media Processing Server Series system lo ad is relatively light.

For additional information, see the PeriConsolidator chapter.

PeriDefiner

This program is a graphical utility which is use d to set up the contents and t he display of a specific report. After a report definition is created and saved it can be generated using the PeriReporter tool.

Introduction

For additional information, see the PeriDefiner chapter.

PeriReporter

This program is a graphical utility which is used to generate reports. The report (created in PeriDefiner) must be specified, along with the date and the con solidation type, after which it can be generated and printed.

For additional information, see the PeriReporter chapter.

# P0988093 Nortel Networks Confidential Page 15

PeriReporter User’s Guide

Launch PeriReporter

Launch PeriReporter by typing PeriReporter at the command line or from the PeriView Launcher using either the Launch menu button or the tool bar.

Open PeriReporter Tools from the menu bar

Select:

• Launch

• PeriReporter Tools

Open PeriReporter Tools from the tool bar

Either double click the PeriReporter Tools button on the tool bar or drag a tree object onto PeriReporter Tools.

Launch a PeriReporter Tools component

Select from:

• PeriReporter

• PeriDefiner

• Schedule A Report

Page 16 Nortel Networks Confidential # P0988093

Introduction

Schedule A Report

The Schedule A Report feature is available on Solaris only, and does not work on PeriReporter systems running on Windows NT. All reports on Windows NT must be manually started.

Specific reports are scheduled to be run in the Schedule Statistics Reports window. The parameters selected here include the name of the report to be generated, the MPS/VPS for which to rep ort da ta, th e star ting and endi ng dat e rang e, the st artin g and ending time range, the type of report, and the report destination (printer, postscript file, export file or HTML file). To launch the Schedule Statistics Reports window, choose Schedule A Report from the PeriReporter Tools launch window.

# P0988093 Nortel Networks Confidential Page 17

PeriReporter User’s Guide

To Schedule a report, define the following paramete rs:

• MPS/VPS selection Select the MPS/VPS for which the report is to be generated. One or all MPSs/VPSs may be sele ct ed. Alt ernatively, no MPSs/VPSs nee d be se lected here as they may be selected in the PeriDefiner and/or PeriReporter component.

An MPS/VPS chosen in the MPS/VPS Selection window will override any MPSs/VPSs selected in either component.

• Report to Generate Select the r eport to generate from the scrolling list of existing reports.

• Start Date/End Date Enter a specific a date range for which data is to be reported. The date must be entered as MM/DD/CCYY.

If no End Date is entered then a report will be run for the Start Date only.

If no Start Date is entered then the request will be invalid.

If no Start or End Dates are entered then a report will run for the previous specified period. (A 15 Minute, Hourly, or Daily report will run for the previous day. A Weekly report will run for the previous week. A Monthly report will run for the previous month. A Yearly report will run for the previous year.)

• Start Tim e/ End Time Enter a specific time range for which data is to be reported. The time must be entered in military time as HH:MM. The default Start Time is 00:00. The default End time is 23:59.

Start Time and End Time are only used for 15 minute and hourly consolidated reports.

• Report Directory Enter the directory which contains the reports to be displayed in the Report to Generate window.

Page 18 Nortel Networks Confidential # P0988093

Introduction

• Destination

Enter the device on which the report will be displayed. Se lect from Printer, PostScript, Export or HTML File.

Choosing PostScri pt File cr ea tes a postscript fi le which can be viewed or p ri nted at a later tim e. The file format is Reportname.VPS#.MMDDYY.ps.

Choosing Export File creates a tab-separated file which can later be imported into a spreadsheet program. The file format is Reportname.VPS#.MMDDYY.exp.

Choosing HTML File creat es a file which can la ter b e opened and viewed from a Web browser. The file format is Reportname.VPS#.MMDDYY.html.

PeriReporter stores PostScript, Export and HTML files in the following directories. If a fil e cannot be saved in one directory, beca use of size or permi ssion restrictions, P eriRepo rter will a ttempt the nex t dir ectory until an acc eptabl e one i s found.

• Directory where report being saved is found.

• Current working directory

• Home directory

• /tmp or /temp

• Type

Enter the consolida tion per iod of the report. Se lect fr om 15 Minute , Hourly, Daily, Weekly, Monthly, or Yearly.

• Select Scheduler, Update, or Cancel

• Scheduler: Launches the Task Scheduler tool.

When the Task Scheduler is launched, report informatio n for the selected report will automatically be entered as commands in the Task Scheduler’s properties windows and the report will be ready for scheduling.

• Update: The Report To Gener ate fie ld will d isplay al l repor ts contai ned in th e

folder selected in the Report Directory field.

• Cancel: Exit from the Schedule Statistics Reports widow.

For additional information on the Task Scheduler tool, see the PeriView Reference Manual #9090701(I).

# P0988093 Nortel Networks Confidential Page 19

PeriReporter User’s Guide

Sharing Data Between Solaris and NT

If PeriReporter is going to be used to collect data from both Solaris and NT terminals certain configuration changes have to be made to the .rhosts file.

On Solaris terminals the .rhosts file is located in the /home/peri directory . This configuration change onl y needs to be made if dat a will be collect ed from both Solar is and NT terminals.

On NT terminals the .rhosts file is located in the \WinNT directory. This configuration change al ways needs to be made, r egardl ess of whether data wil l or will not be collected from both Solaris and NT terminals.

Open the .rhosts file and add the identifications of all terminals from where statistics a re to be collected.

The following example represents a system which has three Solaris terminals and three NT term inals, where th e .rhosts file from the first Solaris terminal (UNIX1) is being changed.

UNIX2_NAME peri UNIX2_NAME SYSTEM UNIX3_NAME peri UNIX3_NAME SYSTEM NT1_NAME peri NT1_NAME SYSTEM NT2_NAME peri NT2_NAME SYSTEM NT3_NAME peri NT3_NAME SYSTEM

Seeing as how the statistics are being collected on the UNIX1 terminal from the terminals UNIX2, UNIX3, NT1, NT2 and NT3, only those terminals need be listed.

Page 20 Nortel Networks Confidential # P0988093

Time Zones

Introduction

In certain areas of the world, Java will not recognize the time zones set on the system which it is instal led. I f thi s occ urs, Pe ri Reporte r wil l defa ult t o Gree nwich M ean Time and report times will be off by several hours. It is also possible that the consolidation will not be performed correctly.

To be sure this does not occur the .perireporter file, residing in your home directory, must be modified. A line stating timezone= along with your three-digit time zone identification code must be added.

For example, if your system is installed in Hong Kong, and runs on China Standard Time, the following line would need to be added to the .perireporter file.

timezone=CTT

To determine your time zone identificatio n code, refer to the following table.

All times are listed in Standard Time. Adjust for Daylight Saving Time accordingly.

Time Zones Sheet 1 of 2

Time Zone Name Offset From GMT ID Countries/Cities/Regions

Greenwich Mean Time GMT + 0 hours GMT Africa/Casablanca Romance Standard Time GMT + 1 hour ECT Europe/Paris Egypt Standard Time GMT + 2 hours EET Arica/Cairo Saudi Arabia Standard Time GMT + 3 hours EAT Asia/Riyadh Iran Standard Time GMT + 3 1/2 hours MET Asia/Tehran Arabian Standard Time GMT + 4 hours NET Asia/Yerevan West Asia Standard Time GMT + 5 hours PLT Asia/Karachi India Standard Time GMT + 5 1/2 hours IST Asia/Calcutta Central Asia Standard Time GMT + 6 hours BST Asia/Dacca Bangkok Standard Time GMT + 7 hours VST Asia/Bangkok China Standard Time GMT + 8 hours CTT Asia/Shanghai Tokyo Standard Time GMT + 9 hours JST Asia/Tokyo Central Australia Standard

Time

GMT + 9 1/2 hours ACT Australia/Adelaide

Sydney Standard Time GMT + 10 hours AET Australia/Sydney Central Pacific Standard Time GMT + 11 hours SST Pacific/Guadalcanal New Zealand Standard Time GMT + 12 hours NST Pacific/Auckland Samoa Standard Time GMT - 11 hours MIT Pacific/Apia

# P0988093 Nortel Networks Confidential Page 21

PeriReporter User’s Guide

Time Zone Name Offset From GMT ID Countries/Cities/Regions

Hawaiian Standard Time GMT - 10 hours HST Pacific/Honolulu Alaskan Standard Time GMT - 9 hours AST America/Anchorage Pacific Standard Time GMT - 8 hours PST America/Los Angeles US Mountain Standard Time GMT - 7 hours MST America/Denver Central Standard Time GMT - 6 hours CST America/Chicago Eastern Standard Time GMT - 5 hours EST America/New York Atlantic Standard Time GMT - 4 hours PRT America/Halifax Newfoundland Standard Time GMT - 3 1/2 hours CNT America/St. Johns

Time Zones Sheet 2 of 2

South America Eastern Standard Time

East South America Standard Time

Azores Standard Time GMT - 1 hours CAT Atlantic/Azores

GMT - 3 hours AGT America/Buenos Aires

GMT - 3 hours BET America/San Paulo

Page 22 Nortel Networks Confidential # P0988093

Statistical

Maintenance

This chapter covers:

1. Collection and Maintenance of Statistical Data

2. PeriReporter and the Media Processing Server Network

3. System and Application Statistics

4. Gathering Application Statistics

PeriReporter User’s Guide

Collection and Maintenance of Statistical Data

Statistics are collected and stored in 15-minute intervals, on a per Nortel Networks Media Processing Server Series basis, for all Nortel Networks Media Processing Servers configured for the network. The $VPSHOME/common/etc/vpshosts file lists all networked servers and th e nodes at which they are configured.

When collecting stat s fr om re mo te s yst em s, Pe ri Repor ter will look in the vpshosts file. For both system and application stats, PeriReporter will retrieve data for all systems that are of TYPE vps in the vpshosts file.

For system sta ts, Peri Report er g oes thr ough e ach v ps entr y, conver ts t he d ata to bina ry form and brings it back to the PeriReporter node.

For application stats, PeriReporter goes through each vps entry. If it is not the local node and it has not already been copied from another vps entry, the data is brought back to the PeriReporter node.

The vpshosts file determines which system s will be used to gather statistics from. Use the vhman or xvhman command to configure the vpshosts file.

For additional information on configuring the vpshosts file, refer to the PeriView Reference Manual (9090722 (I)).

Statistics may be categorized as being either system statistics or user-defined, application-specific statistics. All statistics data is stored and is available for creating and generating reports.

• Each Nortel Networks Medi a Proc essin g Serve r’s VST AT process collects system statistics and writes them to raw statistics files in the directory $VPSHOME/vps(#)/stats. One VSTAT process exists for each server.

• Each node’s VSUPD process collects ap plica tion stat isti cs and wri tes t hem to raw statistics files in the directory: $ASEHOME/stats. One VSUPD process exists for each node.

The process of system statistics collection and reporting is transparent to the user. However, the process of collecting and reporting application statistics requires user intervention.

Once a report is generated, report data is always static. Statistical updates can only be displayed by generating a new report.

Single vs. Multi-node Environments

In a single no de envi ronment , t he Per iRepor ter too l, st atis tics fil es and appli ca tions all exist on the same node. (Stat events are defined generated and collected on this same node.)

In a multi-node environment, applications can execute on nodes where PeriReporter does not reside. Sta ti st ic s ar e t ra nsferred from the node at which they are generated t o the statistics node via scripts which run on the collection node.

Page 24 Nortel Networks Confidential # P0988093

Statistical Maintenance

Defining Stat Events in a Single Node Environment

This process applies to a configuration in which application statistics are to be collected from Nortel Networks Media Processing Server Series and VAS resources that reside on the statistics node. The node’s VSUPD process is responsible for collecting application statistics from all resources on the node. Each server’s VSTAT process is responsible for collecting system statistics for the unit. A single Nortel Networks Media Pr ocess ing Serv er 1000 c onsist s of TMS (Telephony Media Server) hardware a nd both ASE (Applicatio n Ser vi ces Envi ro nment) and VOS (Voice Operating Software) software processes. The UNIX node consists of Nortel Networks Media Processing Server Series elements common to all units configured for the node. The following diagrams ill ustrate the rela tionships betwe en the components in a single node Nortel Networks Media Processing Server Series 1000 from the PeriReporter point of view.

In this example, the UNIX node consists of a

MPS 1000

UNIX Node

VSUPD

PeriView & PeriReporter

MPS 1

VSTAT

Application(s)

ASE / VOS

VSUPD process and PeriView—with PeriReporter, and a single Nortel Networks Media Processing Server on which applications execute. The Nortel Networks Media Processing Server consists of a VSTAT process; applications; ASE and VOS processes; and TMS hardware.

Application stat events are defined within each application, to the statistics node, and to the VSUPD process. The VSUPD process collects application statistics for the node and writes them to $ASEHOME/stats as raw statistics files.

MPS 1000

UNIX Node

VSUPD

PeriView & PeriReporter

MPS 1

VSTAT

Application(s)

ASE / VOS

TMS

MPS 2

VSTAT

Application(s)

ASE / VOS

TMS

After System statistics for the Nortel Networks Media Processing Server are collected they are converted and stored in $ASEHOME/stats as raw statistics files.

In this example, the UNIX node consists of a VSUPD process and PeriView—with PeriReporter, and two Nortel Networks Media Processing Servers on which applications execute. The Nortel Networks Media Processing Servers each consist of a VSTAT process; applications; ASE and VOS processes; and TMS hardware.

After System statistics for the Nortel Networks Media Processing Server are collected they are converted and stored in $ASEHOME/stats as raw statistics files.

# P0988093 Nortel Networks Confidential Page 25

PeriReporter User’s Guide

Application Stat Events in a Multi-Node Environment

This process applies to a configuration in which application statistics may have to be collected from the Nortel Networks Media Processing Server Series Network and VAS resources that reside on the statistics node and from Nortel Networks Media Processing Server and VAS resources that reside on nodes at which the statistics files do not reside. Typically, in a multi-node environment, the PeriReporter tool resides at one node only.

A node’s VSUPD process is responsible for collecting application statistics from all Nortel Networks Media Processing Server and VAS resources on the node. Each servers VSTAT process is respons ible for collecti ng system statistics for the uni t.

VSUPD must be running on all nodes at which application statistics are to be collected. This inc lud es all Nortel Networks Medi a Processing Server a nd VAS nodes at which applications are running.

The following diagram illustrates the relationship between the components in a multi-node Nortel Networks Media Processing Server Series Network configuration, from the PeriReporter tool point of view.

In this example, the Nortel Networks Media Processing Server Series Network is configured with t wo UNIX nod es, and a VSUPD proce ss is a ssociat ed with e ach node. Although PeriView reside s at bot h nodes, Per iReporter reside s only on No de A, which is configured with a single Nortel Networks Media Processing Server 100. Node B consists of two Nortel Networks Media Processing Server 100s. Each Nortel Networks Media Processing Server consists of ASE and VOS software processes, a VSUPD process, TMS hardware, and applications.

Applications assigned to Node A are executing locally with respect to PeriReporter. Applications assigned to N ode B are execut ing remotely wi th respect to PeriReporter.

Stat Events are defined within each application and to each node’s VSUPD process (which collects application statistics for the node and writes them to the directory $ASEHOME/stats as raw statistics files).

The strec#.sre files must be copied from Node A to Node B.

Application statistics, collected at Node B, need to be transferred to Node A.

MPS 1000

Node A

VSUPD

PeriView & PeriReporter

VSTAT

Application(s)

ASE / VOS

MPS 1

MPS network

Application(s)

ASE / VOS

VSTAT

MPS 1000

Node B

VSUPD

PeriView

MPS 3MPS 2

VSTAT

Application(s)

ASE / VOS

TMS

Page 26 Nortel Networks Confidential # P0988093

Statistical Maintenance

In a multi-node environment, the stat event definition process may involve defining stat events for applications that are executing on both local and remote nodes. Fields in a stat record file must be defined once for each unique application for which statistics are to be collected, whereas stat record code stub files must exist on each node at which application statistics are to be collected.

Example:

If multiple instances of the same application are to execute on different nodes in the network, fields in a stat record file have to be defined only once for the application, regardless of the number of locations at which it will execute. However, stat record code stub files must be located on all nodes running applications for which statistics are to be collected.

# P0988093 Nortel Networks Confidential Page 27

PeriReporter User’s Guide

PeriReporter and the MPS Network

Typically, a single node in a Nortel Networks Media Processing Server Series Network is designated to collect and re port stat istical data. PeriRe porter re sides on the node designated for this purpose.

System statistics are collected from each Nortel Networks Media Processing Server Series by the server’s VSTAT process. One VSTAT process exists for each unit.

• In a single node environment, all Nortel Networks Media Processing Server Series exist on the same (local) node. System statistics are collected once each hour by each unit’s VSTAT process. The script pr-sys-v5-sh run s and collects the raw data files from the $VPSHOME/vpsN/stats directory and creates bin ary files in the $ASEHOME/stats directory.

• In a multi-node environment, Nortel Networks Media Processing Server Series can be configured for nodes at which PeriReporter does not reside (remote) as well as for the statistics collection node (local). Scripts run on the collection node only and are transferred from the remote nodes to the $ASEHOME/stats directory of the collection node.

• System statistics generated at remote nodes are collected by each remote

Nortel Networks Media Proc essing Server Seri es’ VST AT process, transferred to the statistics node and stored in sysstats and accstats files.

• System statistics generated by Nortel Networks Media Processing Server

Series configured for the statistics node (local) are collected by each local server’s VSTA T pr oces s and s tored in sysstats a nd accstats fi les. Two types of files are created by the script pr-sys-v5-sh.

• sysstats - system statisti cs files by Nort el Networks Medi a Processi ng Server, line, span, and host

• accstats - system statistics files by time

• The System Variables are predefined. Of the System Variables available, ea ch

report definition can specify only one of the following.

• System.VPS

• System.Line

• System.Host

• System.Span

If one of the abov e syst em vari ables is chosen in a repo rt th en all vari ables for the report definitio n will be col lect ed from sysstats fi les. Count ers for the rest of the report definition can be any combination of remaining System Variables.

These variables are usually mapped to the first column of a report in place of the date. When these variables are used, no column may be mapped to record the date. If one of these variables is chosen for a particular column and Date is chosen for another column an error message will appear.

• With th e excepti on of the above vari ables, report d efinitions can be mapped to any combination of Application and System Variables.

For additional information on mapping of columns for report definitions, refer to the

Data Mapping section of this manual.

Page 28 Nortel Networks Confidential # P0988093

Statistical Maintenance

Application statistics are generated during an application’s execution cycle and

collected by each node’s VSUPD process. One VSUPD process exists for each node.

• In a single node environment, all Nortel Networks Media Processing Server

Series exist on the same (local) node. Application statistics are collected by the node’s VSUPD process and written to raw statistics files in the directory $ASEHOME/stats.

• Application statistics generated at remote nodes are collected by each remote

node’s VSUPD process, transferred to the statistics node and stored in appstats files in $ASEHOME/stats.

• appstats - application statistics files

• Application statisti cs generated by Nortel Ne tworks Media Processing Ser ver

Series configured for the statistics node (local) are collected by the node’s VSUPD process and stored in appstats files.

To view these files, use the vsupdump -f command.

The VSUPD process must be running on all nodes at which applicat ions are exec uting and statistics are to be collected. If VSUPD is not running on a node at which applications are executing, any statistics that are generated at that node will not be collected.

To run the VSUPD process, uncomment the VSUPD line within the gen.cfg file in the $VPSHOME/common/etc directory.

# P0988093 Nortel Networks Confidential Page 29

PeriReporter User’s Guide

System and Application Statistics

Statistical data originates from user defined, application-specific stat events and system def ined stat events.

System statistics and application statistics reports can be generated individually for each Nortel Networks Media Processing Server, or for all units configured for the network.

On systems configured with more than one node, application statistics will be collected for a ll of the n ode’s res ources by a s ingle VSUPD proce ss. Howeve r, system statistics will be collected for each Nortel Networks Media Processing Server by individual VSTAT processes.

System Statistics

System statistics report data related to phone line usage, digital span activity, and host interactio n. System statistics are Nortel Networks Media Processing Server-specific and include all statistics generated by all applications on each unit.

System stat events are predefined by Nortel Networks. System statistical reports are predefined by Nortel Networks and should not be modified without consulting Nortel Networks. System statistics can be viewed with PeriReporter, which is used to select and generate a report.

VSTAT is the VOS (Voice Operating Software) process responsible for collecting system statistics. System stat events are maintained by stat event counters. Each Nortel Networks Media Processing Server Series designates one counter for each unique occurrence of a specified event. System statistics are collected on a per Nortel Networks Media Processing Server Series basis, by each unit’s VSTAT process. At regular intervals, da ta is collect ed from each un it to the collect ion node and trans ferred to binary fi les, where it is stored on a per unit basis.

These files are located in $ASEHOME/stats and are called sysstats and accstats.

Page 30 Nortel Networks Confidential # P0988093

+ 92 hidden pages