AT&T OneVision DEFINITY G3 Guide Guide

585-229-107
Issue 2
April, 1996
OneVision DEFINITY G3
Proxy Agent Installation and
Connectivity
Graphics © AT&T 1988
Table of
Contents

Contents
Issue 2 April 1996 iii
About This Book xiii
Book Overview xiii
Intended Audiences xiv
Typographical Conventions xvi
■Keyboard conventions xvii
Your Proxy Agent Package xix
Trademarks xxi
Related Resources xxii
Reader Comments xxiv
1 Before You Begin 1-1
Chapter Overview 1-1
■About theProxy 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
Recommended Hardware 1-9
Recommended Software 1-10
■About Installations 1-11
Section Overview 1-11

Contents
iv Issue 2 April 1996
UnixWare Methodology 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 Set 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 Troubleshoot the TCP/IP Connection 3-17

Contents
Issue 2 April 1996 v
4 UnixWare Administration 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 Logins: 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 andRestore 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 Communications Hardware 6-6
Section Overview 6-6
To Choose the Hardware 6-8
Proxy Agent and Modem Connections 6-9
Proxy Agent and Data Module Connections 6-10

Contents
vi Issue 2 April 1996
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
■PC Hardware Connections 6-23
Section Overview 6-23
PC Hardware Connections 6-24
Cables and Connectors 6-25
To Validate Dial Strings 6-27
To Set the Dip Switch 6-28
■Alarm Stream 6-31
Section Overview 6-31
To Connect the Modem to thePC 6-32
Alarm Path 6-33
6 Connectivity 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

Contents
Issue 2 April 1996 vii
To Program PBX Ports 7-9
Site-Specific Connections 7-13
Multiple Connections 7-14
■Direct Connections 7-15
Section Overview 7-15
Requirements 7-16
Procedural Overview 7-18
To Install the Hardware 7-18
To Configure Data Modules 7-19
To Set Data Module Extensions 7-22
To Update the Abbreviated Dialing 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

Contents
viii Issue 2 April 1996
To Verify Device Types 8-14
To Verify Dial Strings 8-15
To Create Port Monitor Entries 8-17
8 Proxy Agent Installation 9-1
Chapter Overview 9-1
About the Proxy Agent 9-2
Making Preparations 9-3
To Verify Hardware Connections 9-4
To Verify Installed Software 9-5
Proxy Agent Installation 9-6
9 Proxy Agent Administration 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

Contents
Issue 2 April 1996 ix
To Change Hardware Configuration 10-10
To Change the User Interface 10-13
■Proxy Agent Connectivity 10-17
Section Overview 10-17
To Define External Systems 10-18
To Connect to aPBX 10-20
To Disconnect from a PBX 10-22
■Proxy Agent Customization 10-23
Section Overview 10-23
ToStart 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 Modem 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 Modem Options for Alarm Forwarding 11-15

Contents
xIssue 2 April 1996
■Program the Proxy Agent 11-16
Section Overview 11-16
Change Alarm Forwarding 11-17
11 Post-Installation Tests 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

Contents
Issue 2 April 1996 xi
■Proxy Agent Connectivity B-11
Local Connection: 2000’ or Less
Sys75 R1V3; G1; G3iV1, V2, V3; G3vsV1, V2, V3 B-12
Local Connection: 2000’ or Less
G3rV1, V2, V3 B-13
Local Connection: 2000’ or Less
Sys75 R1V3; G1; G3iV1, V2, V3; G3vsV1, V2, V3 B-14
Local Connection: 5000’ or Less
G3rV1, V2, V3 B-15
Remote Connection:
Sys75 R1V3; G1; G3iV1, V2, V3; G3vsV1, V2, V3 B-16
Remote Connection:
G3rV1, V2, V3 B-17
C Basic vi C-1
Appendix Overview C-1
vi Editor C-2
D Proxy Agent Quick Reference D-1
Appendix Overview D-1
Hotkeys D-2
Commands D-3

Contents
xii Issue 2 April 1996
GL Glossary GL-1
IN Index IN-1

Issue 2 April 1996 xiii
About This Book
Book Overview
In this
preface This preface explains how to use this book and includes the following topics.
For this information … See page …
Intended Audiences xiv
Typographical Conventions xvi
Your Proxy Agent Package xix
Trademarks xxi
Related Resources xxii
Reader Comments xxiv

xiv Issue 2 April 1996
About This Book
Intended Audiences
Intended Audiences
Introduction This book is intended for 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-based network
management system as a management tool
■System administrators who set up the OneVision Network
Management Solutions DEFINITY G3 Proxy Agent and
ensure that it performs correctly
■AT&T support personnel who are responsible for setting up
and installing 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 required hardware
■Use UnixWareRelease 2.01 for system administration
■Execute the UNIXcommands necessary to move around
in the directories and files
■Verify that the operating system is running and in good
health
■Use one of the UNIX Editors (vi or 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.

Issue 2 April 1996 xv
About This Book
Intended Audiences
How to use
this book This book is designed to help you get the information you need quickly. Most likely, you will not need to use the entire book, but
will need particular information in it to meet your requirements.

xvi Issue 2 April 1996
About This Book
Typographical Conventions
Typographical
Conventions
Introduction Before you start installing the Proxy Agent, it is important to
understand the typographical conventions used in this document.
Formatting
conventions The following kinds of formatting in the text identify special information.
Format of text Type of information
constant width ■Words or characters that you type.
Example: Enter 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
document set.
[Bracketed text] Placeholders for information that you
supply.
Example: Enter public!g3mgt!
[client string] means that you
type public!g3mgt! exactly as shown,
but determine the value of the client
string.
End In a table, signifies the end of a
procedure.

Issue 2 April 1996 xvii
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 as they are in this
book.
Combination keys You will frequently hold down one
key while you press another key.
These combination keys are
separated by a hyphen.
Example: Press Ctrl-Y.
Sequential keys You press sequential key
combinations in the order shown.
Example: Press Esc Esc means to
press the Escape key twice.
Sometimes a combination key is
immediately followed by another
key.
Example: Press Ctrl-G Gmeans to
hold down Ctrl while pressing G, then
release both keys and press G
again.
Enter and Return These keys generally perform the
same function. This book uses Enter.
If your keyboard does not have an
Enter key, you can substitute the
Return key.

xviii Issue 2 April 1996
About This Book
Typographical Conventions
Syntax
conventions Some conventions in syntax are:
Window
conventions Procedures for window-style screens use the following conventions.
Syntax Comments
Enter The word "enter" means to type the word
shown in constant width type, then press
the Enter key.
Example: Enter installpkg means type
installpkg and then press the Enter key.
Format Comments
à Shows menu selections.
Example: Select Options
à Print, means to
select Options, then select Print from the
pull-down menu.
Bold Indicates buttons on the window that you
click.
Example: Click on Apply.

Issue 2 April 1996 xix
About This Book
Your Proxy Agent Package
Your Proxy Agent
Package
What’s in
your
package
Your Proxy Agent package includes the following resources:
■This book, OneVision DEFINITY G3 Proxy Agent Installation
and Connectivity
■Proxy Agent software and online documents
■Novell's UnixWareRelease 2.01 operating system software
and documentation
Online
documents In addition to this book, your Proxy Agent package includes the following online documents:
■Command-line help provides a list of commands.
■Field help briefly explains the fields on a Proxy Agent form.
■The Proxy Agent online guide has an overview of Proxy
Agent applications and features, tells you about menus and
forms, and provides information about each application
and how to use it. It also contains a table of contents, an
index, and a glossary.
How to
access online
documents
You can access the online documents anytime you are using the
Proxy Agent.
If you want to access
this type of help … Then press these keys …
Field help Ctrl-Y
Online guide Ctrl-G G

xx Issue 2 April 1996
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.

Issue 2 April 1996 xxi
About This Book
Trademarks
Trademarks
AT&T
trademarks ■DEFINITY is a registered trademark.
■OneVision is a trademark.
Third-party
trademarks All other brand and product names are the trademarks of their respective holders.