PeriView Reference Manual
(Software Release 1.0)
Publication #:
Document Release:
Release Date:
P0988094
Rev: 1.0
April 30, 2002
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.
Copyright © 2002 Nortel Networks, All Rights Reserved
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Scope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
How To Use This Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Organization of This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Conventions Used in This Manual . . . . . . . . . . . . . . . . . . . . . . . xix
Solaris and Windows NT Conventions. . . . . . . . . . . . . . . . . . . . . xx
Trademark Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Manual (man) Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xxii
Introduction to PeriView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
What is PeriView? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
What are PeriView’s Tools?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What is the Work Environment? . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configurations and Naming Conventions. . . . . . . . . . . . . . . . . 6
Single Processing Server . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Processing Server Network Configuration . . . . . . . . . . . . 7
Components in the Processing Server . . . . . . . . . . . . . . . . . . . 8
Types of Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Component Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Sharing Network Resources . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Network Configuration with VAS Support . . . . . . . . . . . 12
Network Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Configuring the Network for Sharing Resources . . . . . . . . . . 15
Sample Network Configuration . . . . . . . . . . . . . . . . . . . . 16
Sample Configuration Files and Reports . . . . . . . . . . . . . . . . . . . 17
vpshosts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
ase.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
gen.cfg File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
IP Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Ethernet Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
SRP Group Status Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
SRP Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
SRP State Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Sample Installation/Configuration Procedure. . . . . . . . . . . . . . . . 33
Edit the vpshosts File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
VHMAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
XVHMAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
How is the PeriView Graphical Environment Organized?. . . . . . 45
Elements in the Graphical Environment. . . . . . . . . . . . . . . . . 46
Tree Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
About ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
# P0988094 Ver: 1.0 Nortel Networks Confidential Page iii
PeriView Reference Manual
Tool Bars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Progress Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Tree Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Nodes in the Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Tree Object States. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Component States. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Domain, Group, Node States . . . . . . . . . . . . . . . . . . . . . . . . . 55
Summary of Tree Object States . . . . . . . . . . . . . . . . . . . . . . . 58
PeriView Topology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Security and Data Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
The PeriView Workspace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
The Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
The Window Pane. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Optimize GUI Display Option . . . . . . . . . . . . . . . . . . . . . . . . 67
Scrollbar Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Screen Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Scrolling Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
System Status, Error and Warning Messages. . . . . . . . . . . . . 74
How to Execute PeriView Operations . . . . . . . . . . . . . . . . . . . . . 75
Using GUI Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Using Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Working in PeriView on Solaris. . . . . . . . . . . . . . . . . . . . . . . . . . 77
Working in PeriView on NT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Solaris Login to PeriView. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
NT Login to PeriView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
File Path Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
File Chooser Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
PeriView Launcher Tools . . . . . . . . . . . . . . . . . . . . . . . . 49
Application Manager Tools . . . . . . . . . . . . . . . . . . . . . . . 49
Activity Monitor Tools . . . . . . . . . . . . . . . . . . . . . . . . . . 50
PeriView Launcher Tree Controls . . . . . . . . . . . . . . . . . . 51
Application Manager & Activity Monitor Tree Controls 51
Node States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Group and Domain States . . . . . . . . . . . . . . . . . . . . . . . . 57
Benefits and Consequences of Optimization . . . . . . . . . . 67
Set Display Option to Optimize GUI . . . . . . . . . . . . . . . . 69
Tool Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Tree Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
PeriView Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Section 1 — Define the Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Introduction to the Launcher. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Solaris Launch of the PeriView Launcher . . . . . . . . . . . . . . . . . . 89
NT Launch of the PeriView Launcher . . . . . . . . . . . . . . . . . . . . . 91
Menu Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Page iv Nortel Networks Confidential # P0988094 Ver: 1.0
Table of Contents
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Tree Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Define a Network as Groups and Domains . . . . . . . . . . . . . . . . . 97
Summary of Tree Object States . . . . . . . . . . . . . . . . . . . . . . . 99
Domain/Group/Icon Properties Menu Buttons. . . . . . . . . . . 103
Define a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Define a Domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Properties Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Change Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Load a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Expand and Collapse a Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Expand a Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Expand the Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Expand by Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Expand by Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Expand by Component . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Expand by VPS or MPS . . . . . . . . . . . . . . . . . . . . . . . . . 130
Expand by VAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Expand by TMSCOMM . . . . . . . . . . . . . . . . . . . . . . . . 134
Expand by OSCAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Collapse a Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Context Sensitive Launcher Menus . . . . . . . . . . . . . . . . . . . 139
Launcher Topology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Section 2 — Launcher Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
A Quick Look at Security. . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Login Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Global vs. Personal Data View . . . . . . . . . . . . . . . . . . . 145
Data Views and Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Data Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
root’s Privileges and Constraints . . . . . . . . . . . . . . . . . . . . . 147
Privileges for the User root . . . . . . . . . . . . . . . . . . . . . . 147
Constraints for the User root . . . . . . . . . . . . . . . . . . . . . 147
Data Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Global Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Personal Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Login Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Global Users Configuration File. . . . . . . . . . . . . . . . . . . . . . 151
Define Launcher Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Launcher Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Tree Proportions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Network Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Snapshot Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
# P0988094 Ver: 1.0 Nortel Networks Confidential Page v
PeriView Reference Manual
Refresh Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Data View Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Select Launcher Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Change Tree Orientation. . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Select a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Select a Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Compact/Full Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Launch PeriView Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Use Online Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Launch the Online Documentation System . . . . . . . . . . . . . 178
Application Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Section 1 — APPMAN Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Introduction to APPMAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Solaris Launch of the Application Manager. . . . . . . . . . . . . . . . 184
NT Launch of the Application Manager. . . . . . . . . . . . . . . . . . . 186
Menu Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Tree Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Expand and Collapse the Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Tree Object Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Context Sensitive Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Expand by Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Expand by Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Expand by VPS or MPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Expand by VAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Expand by Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
APPMAN Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
A Quick Look at Security. . . . . . . . . . . . . . . . . . . . . . . . . . . 220
User-Specific Phone Line Security. . . . . . . . . . . . . . . . . . . . 225
Topology and Data View Examples. . . . . . . . . . . . . . . . . . . 226
Define APPMAN Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Select APPMAN Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Application Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Types of Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Types of Phone Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Login Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Global Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Personal Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Security, Data View, Privileges Summary . . . . . . . . . . 223
Global Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Personal Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Application Management Tools . . . . . . . . . . . . . . . . . . . 230
Page vi Nortel Networks Confidential # P0988094 Ver: 1.0
Table of Contents
File Location Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 236
Application Assign/Start Order . . . . . . . . . . . . . . . . . . . . . . 238
Application Management Event Cycle. . . . . . . . . . . . . . . . . . . . 239
Section 2 — Assign/(Re)Start Lines . . . . . . . . . . . . . . . . . . . . . . . . 245
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Launch the Assign/(Re)Start Lines Tool . . . . . . . . . . . . . . . . . . 249
Assign, Start or Restart Lines. . . . . . . . . . . . . . . . . . . . . . . . . . . 251
The Assign/(Re)Start Lines Window . . . . . . . . . . . . . . . . . . 253
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Assign/(Re)Start Actions . . . . . . . . . . . . . . . . . . . . . . . 261
Enter Applications Information . . . . . . . . . . . . . . . . . . . 262
Enter Locations Information . . . . . . . . . . . . . . . . . . . . . 264
Designate the Assign, Start and Restart Order . . . . . . . 270
Select Assign Options . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Assign, Start, or Restart Lines . . . . . . . . . . . . . . . . . . . . 274
Assign/(Re)Start Lines Progress. . . . . . . . . . . . . . . . . . . . . . 281
Section 3 — Terminate/Un-Assign Lines . . . . . . . . . . . . . . . . . . . . 283
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Launch the Terminate/Un-Assign Lines Tool . . . . . . . . . . . . . . 287
Terminate/Un-Assign Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
The Terminate/Un-Assign Lines Window . . . . . . . . . . . . . . 290
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Terminate and Un-Assign Actions . . . . . . . . . . . . . . . . 295
Enter Locations Information . . . . . . . . . . . . . . . . . . . . . 296
Select Terminate/Un-Assign Options . . . . . . . . . . . . . . 302
Terminate, Un-Assign, Terminate & Un-Assign Lines . 304
Terminate/Un-Assign Lines Progress. . . . . . . . . . . . . . . . . . 309
Section 4 — Configure Applications . . . . . . . . . . . . . . . . . . . . . . . . 311
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Launch the Configure Application Tool. . . . . . . . . . . . . . . . . . . 315
Configure Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
The Configure Application Window . . . . . . . . . . . . . . . . . . 318
Identify the Application to Configure . . . . . . . . . . . . . . 319
Define the Application Type . . . . . . . . . . . . . . . . . . . . . 320
Define the Configuration Type . . . . . . . . . . . . . . . . . . . 321
Define Custom Configurations . . . . . . . . . . . . . . . . . . . 323
Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Assign/Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Configuration Options’ Categories. . . . . . . . . . . . . . . . . . . . 325
Data Processing Options . . . . . . . . . . . . . . . . . . . . . . . . 326
Shared Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Host Communications Options . . . . . . . . . . . . . . . . . . . 336
Execution Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
# P0988094 Ver: 1.0 Nortel Networks Confidential Page vii
PeriView Reference Manual
Section 5 — Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Launch the Status Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Component Status Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Component Status Information. . . . . . . . . . . . . . . . . . . . . . . 372
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Application Status Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Application Status Information. . . . . . . . . . . . . . . . . . . . . . . 378
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Section 6 — Line Start Order During Reboot . . . . . . . . . . . . . . . . . 383
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Launch the Line Start Order During Reboot Tool . . . . . . . . . . . 386
How are applications assigned to the list? . . . . . . . . . . . . . . . . . 388
Which applications are assigned and started?. . . . . . . . . . . . . . . 388
What determines the assigned/started order? . . . . . . . . . . . . . . . 388
Why reorder the list?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
What affects the order of items on the list? . . . . . . . . . . . . . . . . 389
Where is the information stored? . . . . . . . . . . . . . . . . . . . . . . . . 390
How do I reorder the list? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Diagnostic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Vocabulary Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Section 7 — File Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Launch the File Maintenance Tool. . . . . . . . . . . . . . . . . . . . . . . 397
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Select and Remove Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Activity Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Section 1 — Working with the Monitor . . . . . . . . . . . . . . . . . . . . . 403
Introduction to the Activity Monitor . . . . . . . . . . . . . . . . . . . . . 404
Solaris Launch of the Activity Monitor . . . . . . . . . . . . . . . . . . . 406
NT Launch of the Activity Monitor . . . . . . . . . . . . . . . . . . . . . . 407
Working in the Activity Monitor . . . . . . . . . . . . . . . . . . . . . . . . 409
Menu Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
Tree Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Expand and Collapse the Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Tree Object Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
Context Sensitive Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Monitor Activity and Topology . . . . . . . . . . . . . . . . . . . . . . . . . 424
Monitor Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Monitor Topology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Page viii Nortel Networks Confidential # P0988094 Ver: 1.0
Table of Contents
Tree Objects Without Phone Lines. . . . . . . . . . . . . . . . . . . . 435
No Graph Launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
Application Graph Launch . . . . . . . . . . . . . . . . . . . . . . . 436
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
A Quick Look at Security. . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Login Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Global Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Personal Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Security, Data View, Privileges Summary . . . . . . . . . . 440
Topology and Data View Examples. . . . . . . . . . . . . . . . . . . 441
Global Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Personal Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Section 2 — Activity Monitor Tools . . . . . . . . . . . . . . . . . . . . . . . . 443
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Phone Line Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Graph Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
Phone Line Status Graph Display. . . . . . . . . . . . . . . . . . . . . . . . 448
Phone Line Status Graph Types . . . . . . . . . . . . . . . . . . . . . . 450
Consolidated versus Individual Viewpoints. . . . . . . . . . . . . 452
Phone Line Status Graph Properties. . . . . . . . . . . . . . . . . . . 455
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Linked Application Status Bar Graph. . . . . . . . . . . . . . . . . . . . . 462
Launch the Linked Application Activity Graph . . . . . . . . . . 463
Graph Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Linked Graph Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Graph Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
Component Span Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Component Span Status Information . . . . . . . . . . . . . . . . . . 483
Component Span Status Security . . . . . . . . . . . . . . . . . . . . . 488
Component Host Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
Component Host Status Information . . . . . . . . . . . . . . . . . . 494
Define Monitor Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
Activity Polling Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
Save Graph State as Defaults . . . . . . . . . . . . . . . . . . . . . . . . 501
Select Monitor Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
Alarm Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
Introduction to the Alarm Viewer. . . . . . . . . . . . . . . . . . . . . . . . 504
Solaris Launch of the Alarm Viewer . . . . . . . . . . . . . . . . . . . . . 507
NT Launch of the Alarm Viewer . . . . . . . . . . . . . . . . . . . . . . . . 508
Working in the Alarm Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . 510
Menu Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
Source of Alarm Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
Live Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
# P0988094 Ver: 1.0 Nortel Networks Confidential Page ix
PeriView Reference Manual
Default Alarm Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
Historical Alarm Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . 516
Alarm Viewer Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Alarm Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Viewer Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Locate Alarm Information . . . . . . . . . . . . . . . . . . . . . . . . . . 519
View Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
View Live Alarms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
View Default Alarm Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . 525
View Historical Alarm Log Files . . . . . . . . . . . . . . . . . . . . . . . . 529
Filter Alarms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Designate Alarm Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Alarm Severity/Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Logging Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
Viewer Column Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
Alarm Ringing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Alarm Buffering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
Viewer Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
Load Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
Save Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
User Defined. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Source of Alarm Information . . . . . . . . . . . . . . . . . . . . . 518
Size for an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
VSH Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
Section 1 — Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
VSH Command Line on MPS Systems . . . . . . . . . . . . . . . . . . . 565
VSH Tool on VPS/is Systems . . . . . . . . . . . . . . . . . . . . . . . . . . 566
Introduction to the VSH Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . 567
Solaris Launch of the VSH Tool. . . . . . . . . . . . . . . . . . . . . . . . . 568
NT Launch of the VSH Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
Menu Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
Access a VSH Command Line . . . . . . . . . . . . . . . . . . . . . . . 571
Command Line Prompt . . . . . . . . . . . . . . . . . . . . . . . . . 571
Connection to a Component . . . . . . . . . . . . . . . . . . . . . 572
Component List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
Identify and Change the VSH Command Line. . . . . . . . . . . . . . 574
VSH Command Line Format . . . . . . . . . . . . . . . . . . . . . . . . 574
Identify and Change the Component . . . . . . . . . . . . . . . . . . 574
Use the VSH Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
Access Man Page Reference Material . . . . . . . . . . . . . . . . . . . . 576
Solaris Command Man Pages. . . . . . . . . . . . . . . . . . . . . . . . 576
MPS Command Man Page . . . . . . . . . . . . . . . . . . . . . . . . . . 577
Page x Nortel Networks Confidential # P0988094 Ver: 1.0
Table of Contents
MPS Alarm Reference Man Pages . . . . . . . . . . . . . . . . . . . . 578
VPS/is Command Man Page. . . . . . . . . . . . . . . . . . . . . . . . . 579
VPS/is Alarm Reference Man Pages . . . . . . . . . . . . . . . . . . 580
MPS and VPS/is Status/Exception Condition Man Pages . . 581
Menu Access to MPS Commands . . . . . . . . . . . . . . . . . . . . . . . 582
Comp Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
Section 2 — VSH Line & Vocabulary Commands . . . . . . . . . . . . . 587
Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
Line Commands—Reports . . . . . . . . . . . . . . . . . . . . . . . . . 590
Line Commands—Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
Vocabulary Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
Vocabulary Commands—Application . . . . . . . . . . . . . . . . . 608
Vocabulary Commands—MMF . . . . . . . . . . . . . . . . . . . . . 613
Vocabulary Commands—Status . . . . . . . . . . . . . . . . . . . . . 618
Section 3 — VSH Host, System & User Commands . . . . . . . . . . . 639
Host Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
Host—Parameters—Configuration. . . . . . . . . . . . . . . . . . . . 641
Host Commands—Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
System Commands—Database. . . . . . . . . . . . . . . . . . . . . . . 644
System Commands—SRP Status . . . . . . . . . . . . . . . . . . . . 657
SRP Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
SRP Group Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
SRP Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660
SRP Command Line Options . . . . . . . . . . . . . . . . . . . . . 662
SRP Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . 664
System Commands—IPC Status . . . . . . . . . . . . . . . . . . . . . 665
System Commands—Alarm Manager . . . . . . . . . . . . . . . . . 666
The Alarm Database . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
Manipulating the Alarm Database . . . . . . . . . . . . . . . . . 669
Alarm Database Record Format . . . . . . . . . . . . . . . . . . 670
System Commands—Shared Memory . . . . . . . . . . . . . . . . . 684
User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
User Command—Commands. . . . . . . . . . . . . . . . . . . . . . . . 690
User Command—Add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
User Command—Delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
File Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
Introduction to the File Transfer Tool . . . . . . . . . . . . . . . . . . . . 694
Host (Node) Equivalency Prerequisites . . . . . . . . . . . . . . . . . . . 695
Launch the File Transfer Tool . . . . . . . . . . . . . . . . . . . . . . . . . . 697
The File Transfer Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
Create, Edit and Delete a Package . . . . . . . . . . . . . . . . . . . . . . . 700
Transfer Package Procedure Summary. . . . . . . . . . . . . . . . . 702
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xi
PeriView Reference Manual
Package Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
Group Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
Transfer Task Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710
Execute a File Transfer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
Transfer Status Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713
Transfer Log Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714
Transfer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716
Display Transfer Status Information. . . . . . . . . . . . . . . . . . . . . . 717
View Transfer Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718
Schedule Transfer Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
Task Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723
Introduction to the Task Scheduler. . . . . . . . . . . . . . . . . . . . . . . 724
Host (Node) Equivalency Prerequisites . . . . . . . . . . . . . . . . . . . 726
Time Synchronization Between Nodes. . . . . . . . . . . . . . . . . . . . 728
Task Scheduler Prerequisite Checklist . . . . . . . . . . . . . . . . . . . . 729
Launch the Task Scheduler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731
Launch the Task Scheduler from the File Transfer Tool . . . . . . 733
Launch the Task Scheduler from PeriReporter Tools . . . . . . . . 734
Define and Schedule a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735
View the Scheduler Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . 743
sched.log File Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744
Define the sched.log File Size . . . . . . . . . . . . . . . . . . . . . . . 746
Tracing a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747
sched.table File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
at and cron Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749
at -l Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
crontab -l Command . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
cron_error.log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
Page xii Nortel Networks Confidential # P0988094 Ver: 1.0
Preface
PeriView Reference Manual
Scope
PeriView is a Graphical User Interface (GUI) tool that you use with the Nortel
Networks Media Processing Server Series and Voice Processing Series Platforms
(hereafter, collectively known as Processing Server).
The PeriView Reference Manual prov ides i nformat io n about h ow to use PeriView a nd
its subset of tools. A companion document, PeriView Quick Start Guide offers a
concentrated version of this material.
In addition to these docum ents, refer to the Processing Server reference materi al,
available from the Refere nce Ma ter ia l link in PeriDoc.
Intended Audience
This document is useful to any person who uses PeriView to interact with the
Processing Server systems. It is expected that you have complete the training
programs conducted as part of the initial system installation.
In addition, it is importan t to be familiar with site-specific proce dures relating to the
Processing Servers. Basic knowledge of the Solaris and/or Windows NT operating
system(s) is assumed.
Page xiv Nor tel Networks Confidential # P0988094 Ver: 1.0
How To Use This Manual
Initially, read this manual at least once, from start to finish. Later, you can use the
table of contents to locate specific topics. In addition to standard computer
terminology, this manual contains some language that can only be explained in the
context of the Processing Server systems. Refer to the following documents:
• Glossary of Nortel Networks Media Processing Server Series Terminology.
• Glossary of VPS/is Terminology.
If you are reading this document online, use the hypertext links marked in blue to
locate related topics. To move to the topic, <L
cursor is positioned over the hypertext link. Click on any point in a Table of Contents
entry to move to th at to pic. Cl ic k on t he page numb er of any I ndex en tr y to a ccess that
topic. Use the hyperlinks at the top and bottom of each online “page” to help you
navigate the documentation. Click on 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.
To familiarize yourself with various specialized textual references within the manual,
see Conventions Used in This Manual on page xix.
Preface
EFT> click the mouse once when the
Periphonics is now part of Nortel Networks. The name Periphonics, and variations
thereof, still appear in this manual only where it is referred to in a product. (Some
examples are: a PeriProducer applic ation, t he PERImps pack age, and the perirev
command.
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xv
PeriView Reference Manual
Organization of This Manual
This manual is designed to be a comprehensive reference guide to working within
PeriView’s GUI environment and using PeriView’s suite of tools. Each tool is
documented in a separate chapter. A summary of these chapters follow.
Chapter 1 — Introduction
Provides an overvi ew of Per iView’s suite of tools ; a conceptual vie w of the Processing
Server network; and a plan to setup your network environment. You can learn how to
work in a GUI environment and execute PeriView operations. Refer to What is
PeriView? on page 2.
Chapter 2 — PeriView Launcher
Documents the PeriView Launcher, which is PeriView’s administrative tool. You can
learn how to define the PeriView network and launch its suite of tools. Refer to
Introduction to the Launcher on page 88.
Chapter 2 — Section 1 — Define the Network
Documents how to use PeriView’s graphical environment to administer and
control the Processing Server environment. You can learn how to use GUI tools;
define and manipulate objects that represent Processing Server network entities;
and interpret network topologies. Refer to Section 1 — Define the Network on
page 87.
Chapter 2 — Section 2 — Launcher Tools
Documents security in the PeriView environment, working within the launcher,
and accessing the suite of PeriView tools. You can learn how to define Launcher
properties; select Launcher views; launch other PeriView tools; access the
Processing Server online documentation. Refer to Section 2 — Launcher Tools
on page 143.
Chapter 3 — Application Manager
Documents the Application Manger and its subset of tools, which you use to manage
applications in the Proc ess ing Server network. Refer to Introduction to APPMAN on
page 182.
Chapter 3 — Section 1 — Overview
Provides an introduction to APPMAN. You can learn to manipulate the
Processing Server network graphically to accomplish specific operations. This
section provides es sential informa tion about the el ements involve d with managing
applications in the Processing Server environment. Refer to Section 1 —
APPMAN Overview on page 181.
Page xvi Nortel Networks Confidential # P0988094 Ver: 1.0
Preface
Chapter 3 — Section 2 — Assign/(Re)Start Lines
Documents the Assign/(Re)Start Lines tool, which you use to associate
applications with phone lines and initiate their execution. You can learn how to
launch this tool and how to assign applications to phone lines and start, or restart,
applications. Refer to Section 2 — Assign/(Re)Start Lines on page 245.
Chapter 3 — Section 3 — Terminate/Un-Assign Lines
Documents the Terminate/Un-Assign Lines tool, which you use to halt the
execution of applications and disassociate them from phone lines. You can learn
how to launch this tool and how to terminate applications and un-assign them
from phone lines. Refer to Sec ti on 3 — Terminate/Un-Assign Lines on page 283.
Chapter 3 — Section 4 — Configure Application
Documents the Configure Application tool, which you use to define the
environment in which an application executes. You can learn how to launch this
tool and how to configure an appl ication’s run- time parameters . Refer to Sect ion 4
— Configure Applications on page 311.
Chapter 3 — Section 5 — Status
Documents the Status tool, which you use to display the status of a component or
an application. You can learn how to launch this tool and how to display
application and component status information. Refer to Section 5 — Status on
page 365.
Chapter 3 — Section 6 — Line Start Order During Reboot
Documents the Line Start Order During Reboot t ool , whi ch you use to control the
default order in which applications are assigned and started (if so configured)
when the system reboots. You can learn how to launch this tool and how to define
the default order for assigning, starting, and restarting applications. Refer to
Section 6 — Line Start Order During Reboot on page 383.
Chapter 3 — Section 7 — File Maintenance
Documents the File Maintenance tool, which you use to delete files from a
component. You can learn how to launch this tool and how to remove files. Refer
to Section 7 — File Maintenance on page 393.
Chapter 4 — Activity Monitor
Documents the Activity Monitor, which you use to monitor component and
application activ ity us ing a set o f g raphs. PLM (Phone Line Mana gement) Line Status
graphs monitor the l ine st ate of compon ents a nd a pplic ation s. The Li nked Appl icat ion
Activity graph depicts the activity of an application and the applications to which it
links. You can also graphically display the status of a digital span or an external host
that is associated with a specific component. Refer to Introduction to the Activity
Monitor on page 404.
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xvii
PeriView Reference Manual
Chapter 5 — Alarm Viewer
Documents the Alarm Viewer, which you use to view and log alarms. You can learn
how to launch the is tool; display and interpret alarm information; and filter, display,
and log alarms. Refer to Introduction to the Alarm Viewer on page 504.
Chapter 6 — VSH Tool
Documents the VSH tool, whi ch you use t o issue c ommands an d tra nsmit me ssages to
a component in the Processing Server network.
The VSH tool is available only on the Nortel Networks Voice Processing Series
Platform (VPS/is). It is not currently available on the Nortel Networks Media
Processing Server Series Platform (MPS100 and MPS 1000).
Chapter 6 — Section 1 — Overview
Describes how to launch the VSH tool and how to issue commands typed at the
command line. You can see examples of issuing of VSH commands , lear n how to
display Manual (Man) Refer ence Pages, and view t he menu structure used to issue
commands. Refer to Section 1 — Overview on page 565.
Chapter 6 — Section 2 — VSH Line & Vocabul ary Commands
Document the menu driven commands that display Phone Line and Vocabulary
information. You can learn how to issue these commands and how to inte rpr et th e
information they display. Refer to Section 2 — VSH Line & Vo cabulary
Commands on page 587.
Chapter 6 — Section 3 — VSH Host, System & User Commands
Documents the menu driven commands that display information about a
component’s external hosts associated with the Voice Processing Series Platform.
You can learn how to issue these commands and how to interpret the information
they display. Further, you can learn how to add commands to the menu structure.
Refer to Section 3 — VSH Host, System & User Commands on page 639.
Chapter 7 — File Transfer Tool
Documents the File Transfer tool, which you use to distribute files across the
Processing Server network. You can learn how to transfer files from one location to
one or more different network locations. A file transfer package can include a single
file, a single directory or a group of related files and/or directories. Refer to
Introduction to the File Transfer Tool on page 694.
Chapter 8 — Task Scheduler
Documents the Task Scheduler, which you use to schedule single occurrence or
recurrent tasks. You can learn how to launch the tool, create tasks, and schedule their
execution. Refer to Introduction to the Task Scheduler on page 724.
Page xviii Nortel Networks Confidential # P0988094 Ver: 1.0
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.
Conventions Used in This Manual
Notation Description
Preface
Normal text
important term
system
command
file name /
directory
on-screen field
<KEY NAME>
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 fr om
nearby text.
This font indicates a system command and/or its arguments. Such
keywords are to be entered exactly as shown (for example, 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 (for example, 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 can 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.
2
1
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xix
PeriView Reference Manual
1. Windows NT and the flying Window logo are either trademarks or registered
trademarks of the Microsoft Corp orat ion .
2. Solaris® is a registered trademark of The Open Group i n the U.S. 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%
Environment $MPSHOME %MPSHOME%
Paths $VPSHOME/common/etc %VPSHOME%\common\etc
Paths $MPSHOME/common/etc %MPSHOME%\common\etc
Command <command> & start /b <command>
Page xx Nortel Ne tworks Confidential # P0988094 Ver: 1.0
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
Netscape Communications Corporation in the U.S. and other countries. Netscape
Navigator is also a trademark of Netscape Communications Corporation and can be
registered outside the U.S.
Preface
®
and the Netscape N® and Ship’s Wheel® logos are register ed trade marks of
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xxi
PeriView Reference Manual
Manual (man) Pages
Manual (man) pages provide access to documentation about Solaris system
commands, Processing Server commands, status/exception conditions, and alarm
information.
• On Solaris systems, you can display man pages from any command line.
• On NT systems, you can display man pages from a DOS prompt/VSH prompt.
The man page appears in a separate browser window. The type of browser
window depends on which browsers are installed and what browser is set as the
default.
• man pages are always accessible through PeriDoc’s Search page and through
hypertext links in the documents.
When working with the Nortel Networks Media Processing Server Series, to access a
Man Page for:
• a Solaris system command, use the syntax man <command> (Solaris only).
• an MPS command, use the syntax mpsman <processname> <command>.
On Solaris systems on ly, enter man mpsman for a detailed description of using
MPS command manual pages.
• an MPS alarm, use the syntax mpsalarm <processname> <alarm#>.
On Solaris systems only, enter man mpsalarm for a detailed description of
using alarm manual pages, or man alarmintro for an overview of MPS
alarms and the alarm dat abase.
• an MPS status/excepti on conditi on, use the syn tax conman <condition>. On
Solaris systems only, enter man conman for a detailed description of using
MPS condition manual pages.
When working with the Voice Processing Series, to access a Man Page for:
• a Solaris system command, use the syntax man <command> (Solaris only).
• an VPS command, use the syntax vpsman <processname> <command>.
On Solaris systems on ly, enter man vpsman for a detailed description of using
VPS command manual pages.
• a VPS 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 overview of VPS/is alarms
and the alarm database.
• a VPS status/exception condition, use the syntax conman <condition>. On
Solaris systems only, enter man conman for a detailed description of using
VPS condition manual pages.
Page xxii Nortel Networks Confidential # P0988094 Ver: 1.0
Preface
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.
# P0988094 Ver: 1.0 Nortel Networks Confidential Page xxiii
PeriView Reference Manual
This page has been intentionally left blank.
Page xxiv Nor tel Networks Confidential # P0988094 Ver: 1.0
1
Introduction to PeriView
This chapter covers:
1. What is PeriView?
2. What ar e Pe riView’s Tools?
3. What is the Work Environment?
4. How is the Graphical Environment Organized?
5. Security
6. How are PeriView Operations Executed?
7. How do I Launch PeriView?
PeriView Reference Manual
What is PeriView?
PeriView is the suite of graphical tools that you use fo r admi ni str at ion, operation, and
control of Nortel Networks Media Processing Server Series and Voice Processing
Series Platforms, hereafter collectively known as Processing Server (PS).
You can use PeriView to manipulate and view network activity and to develop and
maintain applications in a GUI (Graphical User Interface) environment. The palate of
tools display on the tool bar when you log onto PeriView.
PeriView provides for distributive control over network activity. It lets you to define
virtual environments and operate within them. Each tool offers a wide range of
customization.
You launch each tool individually. You can launch tools sequentially so that you can
work with multiple tools. Once you launch a tool, you can iconify it and restore it to
view when you need it.
This flexibility permits simultaneous interaction with multiple PeriView operations
and allows for network awareness and control in the operating environment. For
example, you can view alarms in the Alarm Viewer, monitor applications in the
Activity Monitor, and issue commands with the VSH tool while you are assigning,
starting, or terminating appl ications.
Page 2 Nortel Networks Confidential # P0988094 Ver: 1.0
What are PeriView’s Tools?
You use PeriView’s suite of tools to administer, operate, control, and view network
activity; develop and maintain applications; and, create, manage, and edit speech
elements. Additionally, PeriView is equipped with a comprehensi ve online library that
you can launch, spontaneously, while working with its palate of tools.
The Launcher is PeriView’s main administrative tool. It displays when you log onto
PeriView. You use it to access to the entire palate of tools, which include: PeriView
Launcher, Applica tion Manager, Activit y Monitor, Alarm Viewer, VSH, File T r ansfer,
Task Scheduler, Spin, PeriReporter Tools, PeriStudio, PeriProducer, PeriWWWord,
PeriSQL, and PeriDoc.
Introduction to PeriView
Use the PeriView Launcher to customize the a network’s virtual
working environment by defining relationships between member
entities; display their hierarchical tree structure graphical l y; and,
launch other PeriView tools. See Introduction to the Launcher on
page 88.
Use the Applicatio n Manager (APPMAN) to associate
applications with phone lines and start applications; terminate
applications and disassociate them from phone lines; configure an
application’s run-time environment; display application and
component status information, control the default line start order
during reboot; and delete fil es from a component. See Introduction
to APPMAN on page 182.
Use the Activity Monitor to graphically represent the states of
phone line activity for components and applications and to
graphically monitor linked application activity. A set of graphs
depict activity in near real-time. You can view a component’s
digital span activity and external host status graphically. See
Introduction to the Activ ity Monitor on page 404.
Use the Alarm Viewer to view live and logged alarms. Logging
allows you to creat e ala rm log file s. A fi ltering mechani sm lets you
to control which alarms display and are logged. See Introduction
to the Alarm Viewer on page 504.
# P0988094 Ver: 1.0 Nortel Networks Confidential Page 3
PeriView Reference Manual
The VSH tool is supported only on the Voice Processing Series
platform. You can issue VSH commands on the MPS100 or
MPS1000 platform from a Solaris Command Tool and Windows
NT MSDOS window. See Section 1 — Overvie w on page 565.
Use the File Transfer to copy files across a network. Transfer
capability lets you duplicate a single file, a single directory, or a
group of related files and directories at one or more destination
locations. S ee Introduction to the File Transfer Tool on page 694.
Use the Task Scheduler to schedule operations as single
occurrence task or as recurrent tasks. You can launch the Task
Scheduler from the PeriView Launcher, the File Transfer tool, or
PeriReporter Tools. See Introduction to the Task Scheduler on
page 724.
SPIN is a diagnostic tool, which is u sed to ide ntify pr oblems on th e
VPS/is platform. The tool is intended for use, primarily, by Nortel
Networks support personnel only on the VPS/is platform.
SPIN (S
basic components of Processing Server of products to identify
problems: interprocess communication (IPC) and the ability of
firmware to echo messages back to SPIN.
The first co mponent tests that Nortel Networks operating system
software is properly sending messages among core processes. The
second component sends messages to firmware images to ensure
they can respond in a timely manner.
Typically, you will be working directly with Nortel Networks
support when you use this tool.
Use PeriReporter Tools for statistics and reports management.
You can generate predefined reports and define and report
application-specific statistics.
Typically, PeriReporter Tools reside on the node designated as the
site of statistical collection and reporting for the network. Th e tool
displays the PeriView tool bar only at the node where you install
the PeriReporter Tools software. For i nformation about
PeriReporter Tools, see the PeriReporter User’s Guide.
ystem Performance and INtegrity monitor) probes two
Page 4 Nortel Networks Confidential # P0988094 Ver: 1.0
Introduction to PeriView
Use PeriStudio to create and edit speech vocabularies for the
Processing Server systems. For infor mat ion about PeriSt udio, r efer
to the PeriStudio User’s Guide.
Use PeriProducer to cr eate and support i n t era ct ive voice respon se
and Web applications. You can build applications in a graphical
construction area with a set of building block icons that represent
basic functions. For information about PeriProducer, refer to the
PeriPr oduc er Us er’s Guid e.
Use PeriWWWord to launch the PeriWWWord utility. You can
create and modify the HTML dictionaries that PeriWeb
applications reference. For information about PeriWWWord, refer
to the PeriWeb User’s Guide.
Use the Nortel Networks SQL Generate and Display tool
(PeriSQL), to create, modify, and execute Structured Query
Language (SQL) SELECT commands through a graphical
interface. For information about PeriSQL, refer to the PeriRDB
User’s Guide.
Use the PeriDoc tool to access the comprehensive online resource
library, which contains Nortel Networks reference material. See
Use Online Documentation on page 177.
# P0988094 Ver: 1.0 Nortel Networks Confidential Page 5
PeriView Reference Manual
What is the Work Environment?
The Processing Server systems consists of the hardware and software required to
support interactive call processing functions for both voice and Web (Internet)
interaction.
In this Beta Version of the PeriView Reference Guide, the component names VPS and
MPS are synonymous, except where explicitly differentiated.
Configurations and Naming Conventions
The following description illustrates the Processing Server system concepts and
naming conventions used in the PeriView Reference Manual and Quick Start Guide.
Single Processing Server
A single node is the building block in the Processing Server
configuration. It is configured with one VPS or MPS
component which consists of:
• TMS (Telephony Media Server) hardware.
• ASE (Application Services Environment) and the VOS
(Voice Operating Software) software processes executing
on a node.
PS
Node
VPS
ASE
VOS
TMS
Page 6 Nortel Networks Confidential # P0988094 Ver: 1.0