AT&T G3 User Manual
Table of
Contents
585-229-107
Issue 2
April, 1996
OneVision DEFINITY G3
Proxy Agen t Installation and
Connectivity
Graphics © AT&T 1988
Contents
About Th is Book xiii
Book Overview xiii
Intended Audiences xiv
Typographical Conventions xvi
■ Keyboard conventions xvii
Your Proxy Ag ent Package xix
Trademarks xxi
Related Resources xxii
Reader Comments xxiv
1 Before You Begin 1-1
Chapter Overview 1-1
■ About the Proxy Agent 1-2
Section Overview 1-2
Stages of Translating PBX Data 1-3
Supported PBXs 1-4
■ Requirements 1-5
Section Overview 1-5
PC Requirements 1-6
To Check Disk Space 1-7
Recom mended Hardwar e 1-9
Recommended Software 1-10
■ About Installations 1-11
Section Overview 1-11
Issue 2 April 1996 iii
Contents
UnixWare Method ology 1-12
Installation and Setup Task List 1-13
2 PC Hardware Installation 2-1
Chapter Overview 2-1
PC Setup Checklist 2-2
3 UnixWare Installation 3-1
Chapter Overview 3-1
■ Installation Procedures 3-2
Section Overview 3-2
New Installations 3-3
UnixWare 2.01 Upgrades 3-6
To S et System and Node Names 3-9
■ TCP/IP Administration 3-11
Section Overview 3-11
To Configure the Ethernet Interface 3-12
To Set the Hosts File 3-14
To Test the TCP/IP Connection 3-16
To Tr oubleshoot the TCP/IP Connection 3-17
iv Issue 2 April 1996
Contents
4 Uni xWare Administrati on 4-1
Chapter Overview 4-1
■ Login Administration 4-2
Section Overview 4-2
About Logins 4-3
To Add New Logins: UNIX Shell 4-4
To Add New Logins: OA&M 4-6
To Add New Login s: Desktop 4-9
To Verify Group Assignments 4-11
■ Maintenance Administration 4-13
Section Overview 4-13
About Port Monitors 4-14
To Assign Devices to Ports 4-15
To Back Up and Restore 4-17
5 Planning Connectivity 6-1
Chapter Overview 6-1
■ About Connectivity 6-2
Section Overview 6-2
Proxy Agent Connectivity 6-3
Communications Hardware 6-5
■ Data Commu nications Hardware 6-6
Section Overview 6-6
To Choose the Hardware 6-8
Proxy Age nt an d Mod e m Connections 6-9
Proxy Age nt a n d Data Module Connections 6-10
Issue 2 Ap ril 1996 v
Contents
■ PC Hardware Connections 6-23
■ Alarm Stream 6-31
Proxy Agent and ADU Connections 6-11
To Choose Circuit Packs 6-12
PBX and Modem Connections 6-13
PBX and Data Module Connections 6-14
PBX and ADU Connections 6-15
Cables for Modems 6-16
Cables for Data Modules 6-19
Cables for ADUs 6-21
Section Overview 6-23
PC Hardware Connections 6-24
Cables and Connectors 6-25
To Validate D ial Strings 6-27
To Set the Dip Switch 6-28
Section Overview 6-31
To Connect the Modem to the PC 6-32
Alarm Path 6-33
6 Connectiv ity 7-1
Chapter Overview 7-1
■ Dial-Up Connections 7-2
Section Overview 7-2
Port Terminations 7-3
Analog Connections 7-4
Digital Connections 7-7
vi Issue 2 April 1996
Contents
To Program P BX Ports 7-9
Site-Specific Connections 7-13
Multiple Connections 7-14
■ Direct Connection s 7-15
Section Overview 7-15
Requirements 7-16
Proced ural Overview 7-18
To Install the Hardware 7-18
To Configure Data Modules 7-19
To Set Data Mod ule Extensions 7-22
To Update the Abbreviat e d Dial ing List 7-24
To Edit the Devices File 7-26
To Set Up a Hotline Connection 7-27
To Administer the Proxy Agent 7-28
7 Serial I/O Cards 8-1
Chapter Overview 8-1
■ Installation Procedures 8-2
Section Overview 8-2
DigiBoard Xem 8-3
Equinox SST 8-6
Equinox XP 8-7
Specialix XIO 8-10
■ Administration Procedures 8-11
Section Overview 8-11
To Assign Devices to the Proxy Agent 8-12
Issue 2 April 1996 vii
Contents
To Verify Device Types 8-14
To Verify Dial Strings 8-15
To Create Port Monitor Entries 8-17
8 Proxy Agen t Installat ion 9-1
Chapter Overview 9-1
About the Proxy Agent 9-2
Making Preparations 9-3
To Verify Hardware Co nnect ions 9-4
To Verify Installed Software 9-5
Proxy Agent Installation 9-6
9 Proxy Agent Admini st ration 10-1
Chapter Overview 10-1
■ Maintenance 10-2
Section Overview 10-2
UNIX Permissions 10-3
Printers 10-4
Back Up Your System 10-5
Remove the Software 10-6
■ Proxy Agent Configuration 10-7
Section Overview 10-7
To Verify the Installation 10-8
viii Issue 2 Apr i l 199 6
Contents
To Change Hardware Configuration 10-10
To Change the User Interface 10-13
■ Pr oxy Agent Connectivity 10-17
Section Overview 10-17
To Define External Systems 10-18
To Connect to a PBX 10-20
To Dis connect from a PBX 10-22
■ Proxy Agent Customization 10-23
Section Overview 10-23
To Start the Proxy Agent 10-24
The Online Guide 10-25
To Check the Proxy Agent Status 10-26
To Change Clients 10-27
To Change Managers 10-28
10 Alarms 11-1
Chapter Overview 11-1
■ Alarm Reception 11-2
Section Overview 11-2
Program the Alarm Receiver Port 11-3
Set Mo d em Options for Alarm Reception 11-9
■ Alarm Forwarding 11-12
Section Overview 11-12
Program the Alarm Sender Port 11-13
Edit the Dialers File 11-14
Set the Mode m Op t ions fo r Alarm Forwarding 11-15
Issue 2 April 1996 ix
Contents
■ Program the Proxy Agent 11-16
Section Overview 11-16
Change Alarm Forwarding 11-17
11 Post-Installati on Te sts 12-1
Chapter Overview 12-1
Technician Checklist 12-2
Customer Checklist 12-3
A PA001 Form A-1
Appendix Overview A-1
PA001 Administration Request Form A-2
B Design Configuration B-1
Appendix Overview B-1
■ Proxy Agent Network B-2
Digital Switch On-Network B-2
Analog On-Network B-4
“Other” On-Network B-6
Customer-Provided Multiplexor Data Networks B-8
x Issue 2 April 1996
Contents
■ Proxy Agent Connectivity B-11
Local Connection: 200 0’ or Less
Sys75 R1V3; G1; G3i V1, V2, V3; G3 vsV1, V2, V3 B-12
Local Connection: 200 0’ or Less
G3rV1, V2, V3 B-13
Local Connection: 200 0’ or Less
Sys75 R1V3; G1; G3i V1, V2, V3; G3 vsV1, V2, V3 B-14
Local Connection: 500 0’ or Less
G3rV1, V2, V3 B-15
Remo te Connection:
Sys75 R1V3; G1; G3i V1, V2, V3; G3 vsV1, V2, V3 B-16
Remo te Connection:
G3rV1, V2, V3 B-17
C Basic vi C-1
Appendix Overview C-1
vi Edito r C-2
D Proxy Agent Quick Reference D-1
Appendix Overview D-1
Hotkeys D-2
Commands D-3
Issue 2 April 1996 xi
Contents
GL Glossary GL-1
IN Index IN-1
xii Issue 2 April 1996
About This Book
Book Overview
In this
preface
This preface explains how to use this book and includes the
following topics.
For this in formation … See page …
Intended Audiences xiv
Typographical Conventions xvi
Your Proxy Agent Package xix
Trademarks xxi
Re lated Resources xxii
Reader Comments xxiv
Issue 2 Apr il 1996 xiii
About This Book
Intende d Au diences
Intended Audiences
Introduction This book is intended fo r AT& T customers who use OneVision
Network Management Solutions DEFINITY
G3 applications to
manage their PBXs on a network management system (NMS). In
particular, this book is intended for:
■ Network managers who use a SNMP-b ased network
management system as a management tool
■ System a d minist rators who se t up t he OneVision Net work
Management Solutions DEFIN ITY G3 Proxy Agent and
ensure that it performs correctly
■ AT&T support personnel who are responsible for setting up
and insta lling the Proxy Agent
What you
should know
Before you use this book to help you install the Proxy Agent, you
should already understand how to:
■ Install the require d hardw a re
■ Use UnixWare
■ Execute the UNIX
Release 2.01 for system ad minist ra tio n
commands necessary to move around
in the d irectories and fil es
■ Verify that the o p erati n g s ystem is running a n d in g ood
healt h
■ Use one of the UNIX Ed itors (v i o r ed) to customize Proxy
Agent to meet site requirements
Earlier
versions of
UNIX
Because administration tools vary across different versions
of UNIX, knowledge of an earlier version of UNIX may be
insufficient.
xiv Issue 2 Ap ril 1996
About This Book
Intended Audiences
How to use
this book
This book is d e si gned to help you get the infor m ati on you ne e d
quickly. Mos t likely, you will not need to use the enti re book, but
will need particular information in it to meet your requirement s.
Issue 2 April 1996 xv
About This Book
Typographical Conventions
Typographical
Conv entions
Introduction Before you start installin g the Proxy Age n t, it is im p or tant to
understand the typographical conventions used in this document.
Formatting
conventions
The following kinds of formatting in the text identify sp ecial
informati o n.
Format of text Typ e of inform ation
constant width
■ Words or characters that you type.
Examp le: Ente r Proxy Agent.
■ Text that displays on your screen.
Example: Please remove the
installation diskette and
continue when ready.
italic
type Specialized terms.
Titles of other books in the OneVision
docume nt set.
[Bracketed text] Placeholders for informat ion t hat you
supply.
Example: Ent er public!g3mgt!
[client string] means that you
type public!g3mgt! exactly as shown,
but de t ermi ne the value of the cl i ent
string.
End In a table, signifies the end of a
xvi Issue 2 Ap ril 1996
procedure.
About This Book
Typographical Conventions
Keyboard conventions
This book uses the following keyboard conventions.
Keys Comments
Key names All keys are shown in small type.
Example: Press
Enter.
The keys on your keyboard may not
be labeled exactly a s they are i n this
book.
Combination keys You will frequently hold down one
key while you press another key.
These combination keys are
sep arate d by a h y p hen.
Example: Press
Ctrl-Y.
Sequential keys You press sequential key
co mbinations in the o rd er shown.
Example : Press
Esc Esc means to
press the Escape key twice.
Sometimes a co m bination key is
immediately followed by another
key.
Example : Press
hold down
release both keys and press
Ctrl-G G means to
Ctrl while pressing G, then
G
again.
Enter and Return These keys generally perform the
same function. This bo ok uses
Enter.
If your keyboard does not have an
Enter key, you can substitute the
Return ke y.
Issue 2 April 1996 xvii
About This Book
Typographical Conventions
Syntax
conventions
Window
conventions
Some conventions i n syntax are:
Syntax Comments
Enter The word "enter" means to type the word
shown in constant width type, then press
Enter key.
the
Examp le: Ente r installpkg means type
installpkg and then press the
Enter key.
Procedures for window-style screens use the following
co nventi ons.
Format Comments
à
Shows menu selections.
Examp le: Sel ect O p tions
à
Print, means to
select Options, then select Print from the
pull-down menu.
Bold In dicates buttons on the window that you
click.
xviii Issue 2 April 1996
Example : Click on Apply.
About This Book
Your Proxy Agent Package
Your Proxy Agent
Package
What’s in
your
package
Online
documents
How to
access online
documents
Your Proxy Agent p ackage includes the following resources:
■ This book,
and Connectivity
■ Proxy Age nt softwa re an d online d ocuments
■ Novell's UnixWare Release 2.01 o perating system software
OneVision DEFINITY G3 Proxy Agent Installation
and documentation
In addition to this book, your Proxy Agent p ackage includes the
following online documents:
■ Comman d-line help provides a list of commands.
■ Field help briefly exp lai ns the fie l d s on a Proxy Age n t form.
■ T he Proxy Agent online guide has an overview of Proxy
Agent applications and fea tur es, tells you about menus and
forms, and provides information about each application
and how to use it. It also contai ns a table of contents, an
index, and a glossary.
You can access the online docume nts anyti me you are using the
Proxy Agent.
If you want to access
this type of help … Then press these keys …
Field help
Online g uide
Ctrl-Y
Ctrl-G G
Issue 2 April 1996 xix
About This Book
Your Proxy Agent Package
Closing the
online guide
You can exit the Proxy Agent online guide at any time by pressing
Ctrl-X.
xx Issue 2 April 1996
About This Book
Trademarks
Trademarks
AT&T
trademarks
Third-party
trademarks
■ DEFINITY is a registered trademark.
■ OneVision is a trademark.
All other brand and product names are the trademarks of their
respective holders.
Issue 2 April 1996 xxi
About This Book
Related Resources
Related Resources
Ty pes of
documents
Fault Management
documents
Other d o c uments that are related to the Proxy Agent, b ut not
included with your Proxy Agent package are:
■
AT&T OneVision Definity Enterprise Management Project
Provisioning Packag e
■ Fault Management do c u m ents
■ DEFINITY
G3 docume nts
The Fault Management do c u m ents are:
■
OneVision Network Management Solutions DEFINITY G3
F ault Management Installation and Integration
—
for HP Open View on a HP9000
—
for HP OpenView on a Sun Sparc OS
—
for Cabletron SPECTRU M o n a S un Sparc OS
, 585-229-104
, 585-229-105
,
585-229-110
for IBM NetView
—
■
OneVision Network Management Solutions DEFINITY G3
, 585-229-114
F ault Management Online User Guide
DEFINI TY
documents
Some useful DEFINITY docu m ents are:
■ Str ea mlined Implemen ta tion Librar y
■
DEFINITY Communications System Generic 3 Feature
Description
■
DEFINITY Communications System Generic 3 Capabilities
555-230-499
xxii Issue 2 A pril 1996
, 555-230-204
,
About This Book
Related Resources
■
DEFINITY Communications System Generic 1 and Generic
3 System M anagement
■
DEFINITY Communications System Generic 3r
Implementation
■
DEFINITY Communications System Generic 3i
Implementation
, 555-230-651
, 555-230-650
, 555-230-500
Ordering
information
Third-party
documents
For more informat ion about t hese books an d other AT&T
pu bl ications, see the
Publications Catalog
Glo bal Business Comm unications Sy s te ms
, 555-000-010.
You may find it helpful to refer to the installat ion do c ume nts tha t
come with your hardware and software.
Issue 2 April 1996 xxiii
About This Book
Reader Comments
Reader Comments
Comment
card
Where to
find the card
If the card is
missing
We are interested in your suggestions for documentation
imp rovem ents a n d u rg e you to fill out the co mm ent c ard a n d
return it to us.
The reader comment card is behind the title page.
If the comment card is missing, please send your comments to the
following add ress:
AT&T
Product Documentation Development
Room 22-2C11
11900 North Pecos Street
Denver, Colorado 80234
Fax: (303) 538-1741
Remember to write down the document name and number on
your com me nt sheet.
Example Proxy Agent Installation and Connectivity guide, 585-229-107.
xxiv Issue 2 A p r i l 1996
Before You Begin
Chapter Overview
1
In this
chapter
This chapter c overs infor mat ion you need to know before you
be g in installing and setting up the Proxy Agent.
For this in formation … See page …
About the Proxy Agent 1-2
Requirements 1-5
Abo ut Installations 1-12
Issue 2 April 1996 1-1
Before You Begin
Section Overview
About the Proxy Agent
Section Overview
In this
section
This section contains the following information.
For this in formation … See page …
Stages o f Translating PBX Data 1-3
Supported PBXs 1-4
1-2 Issue 2 April 1996
Before You Begin
Stages of Translating PBX Data
Stages of Translating
PBX Data
Description The Proxy Age nt tran slates data from a DEFIN ITY G3 PBX i nto a
format that yo ur ne twork man agement system can understand.
Process The following table shows the p rocess for translati n g PBX data.
Step What does it Description
Other
functions
1 DEFINITY G3
PBX
2 Proxy Agent Translates the data from the
3 Proxy Agent Forwards the P BX management data
The Proxy Agent also provides administrative access to th e switch
to accommodate those functions not p rovided by SNMP.
Sends PBX management d a ta to the
Proxy Agent.
D EFINITY OSSI (Operating Support
Sys te m Interface) and alarm format
to the SNMP (Simple Network
Managemen t Protocol) format.
to the network mana g e m ent system.
Issue 2 April 1996 1-3
Before You Begin
Supported PBXs
Supported PBXs
Ty pes of
PBXs
The Proxy Agent supports the following DEFINITY G3 PBXs.
G3vs G3s G3i G3r
V1.1 - ABP/PBP V1.1 - ABP/PBP V1.1 - 286 V1.1
V2 - ABP/PBP V2 - ABP/PBP V2 - 386
V2 - 286
V3 - ABP/PBP V3 - ABP/PBP V3 - 386 V3
V4 - ABP/PBP V4 - ABP/PBP V4 - 386 V4
V2
1-4 Issue 2 April 1996
Before You Begin
Section Overview
Requirements
Section Overview
In this
section
This section contains the following information.
For this in formation … See page …
PC Requirements 1-6
T o Check Disk Spac e 1-7
Recommended Hardware 1-10
Recommended Software 1-11
Issue 2 April 1996 1-5
Before You Begin
PC Requirements
PC Requirements
Type of PC The Proxy Ag e nt req uires an industry standard Intel 486 (or later)
processor-based personal comp uter with ISA BUS slots.
Required
configuration
Required
disk spac e
For the Proxy Agent to run properly, your PC must have:
■ A 3.5-inch, 1.44-MB diskette drive
■ 16 MB of random access memory
■ A h ard disk of at least 500 MB
■ A CD-ROM drive , 2x or gre ater
■ A Serial I/O ports board
■ Uni xWare Release 2.01 com p at ible, 10 Mbit network
interface card
See Recomm ended Hard wa re on page 1-10 for more inform at ion.
Estimates of the disk space that the Proxy Agent requires during
installation are in the following table. Disk space on UnixWare is in
512-byte blocks.
Directory Blocks
/tmp 2,000
/usr 2,000
Remember, space re quirements expand as you generate d at a
files.
1-6 Issue 2 April 1996
Total 4,000
Before You Begin
To Check Disk Space
To Check Disk Space
When to use Check the amount of unused disk space before you install the
Proxy Agent to ensure that there is enough room.
Ty pes of
directories
The install script for th e Proxy Agent uses the following directories.
Issue 2 April 1996 1-7
Loading...