AT&T OneVision DEFINITY G3 Fault Management and... Quick setup guide

585-229-110
Issue 1
April, 1996
OneVision DEFINITY G3
Fault Management
Installation and Integration
for Cabletron SPECTRUM on
a SunOS
Graphics © AT&T 1988
Table of
Contents

Blank Page

Contents
Issue 1 April 1996 iii
About This Book vii
■Audience vii
■Prerequisites vii
■Conventions ix
■Trademarks x
■Credentials x
■Your Fault Management Documentation Package xi
Online Documentation xi
■Reader Comments xii
1 Before You Begin 1
■Overview 1
Fault Management 2
Standard Network Management Components 2
Network Connectivity 4
■Installation and Setup Task List 5
■Requirements for Fault Management Installation 7
Certification 7
2 Installation 9
■Installation Prerequisites 9
■Installation Procedures 10

Contents
iv Issue 1 April 1996
Accessing the Installation Software 10
Configuring the Installation 11
■Changing the Environment 13
3 Integration 15
■Adding DEFINITY G3PBX Nodes 16
Node Limitations 16
Adding aPBXas a Managed Node 16
Adding aPBX Icon 16
■Adding DEFINITY G3 Proxy Agent Nodes 19
Node Limitations 19
Adding aProxy Agent as a Managed Node 19
Adding a Proxy Agent Icon 19
Associating a PBX with aProxy Agent 21
4 Starting the Applications 23
■Starting Fault Management 23
■Opening the Online User Guide 24
Opening from the Network Map 25
Opening from a Shell Prompt 25
■DynaText Documentation 25

Contents
Issue 1 April 1996 v
5 Alarm States 27
■States of the DEFINITY G3 Icons 28
IconStates 28
Conditions Causing Change of State 29
■States of the Proxy Agent Icons 30
IconStates 30
Conditions Causing Change of State 31
■Verifying Connectivity 32
IconState 32
Startup Messages 32
Startup Screen 33
Switch View 34
Warning Messages 34
Data Refreshes 35
Refreshing Data Manually 35
The MIB 35
TroubleShooting Disconnects 36
A Advanced Customization 37
■Changing Default Values 37
The Setup Screen 38
The Application Resource File 38
Accessing the Resource File 38
Default Values 39
Editing the File 39
■Other Options 40

Contents
vi Issue 1 April 1996
Changing the Application Directory 40
B Telnetting to the Proxy Agent 41
■Overview of the Proxy Agent 41
■Why Should You Access theProxy Agent? 42
■Telnetting to theProxy Agent 43
IN Index 45

Issue 1 April 1996 vii
About This Book
This book provides information about DEFINITYG3 Fault Management and
Proxy Agent connectivity and tells you how to install and initially set up your
DEFINITY G3 application.
Audience
This book is intended for AT&T's DEFINITY Generic 3 customers who use
DEFINITY G3 Fault Management (referred to hereafter as Fault Management)
to manage their PBXs on the the Cabletron SPECTRUMRelease 3.0 Rev 2 or
later.
Prerequisites
The level of information provided in this book is based on the assumption that
users have fulfilled the following prerequisites:
■Customers must understand the network management system(NMS)on
which Fault Management resides. It is not within the scope of this or
other Fault Management documentation to describe how to use the
NMS beyond what the Fault Management software requires.
■Customers must understand their DEFINITY G3 PBX configuration and
must be familiar with basic PBX alarm and error functionality.

Prerequisites
viii Issue 1 April 1996
How This Book Is Organized
This book is organized as follows:
This book also contains an Index.
Chapter 1 Lists the hardware and software that is certified to run Fault
Management and provides preparatory steps.
Chapter 2 Gives you the procedures for installing the software.
Chapter 3 Provides information for integrating Fault Management and
Proxy Agent into the NMS.
Chapter 4 Explains how to start Fault Management and the online user
guide.
Chapter 5 Describes the states, alarms, polls, and masks, for
DEFINITY G3 PBXs and for DEFINITY Proxy Agents.
Appendix A Describes how to change polling intervals and default
colors.
Appendix B Explains how to telnet to the Proxy Agent.

Conventions
Issue 1 April 1996 ix
Conventions
This book contains the following typographic conventions:
■Information that is displayed on your screen is shown in typewriter-style
constant-width type.
■Information that you enter from your keyboard or select from a menu is
shown in bold type.
■Keys that you press are indicated by small type.
■The word "Enter" means to type the word shown in bold text, then press
the Enter key.
■Brackets indicate values that you supply.
Example: Installation complete.
Example: Enter attov_doc.
Click OK.
Example: Press Enter.
Example: Enter the command Install.
Means type Install and then press Enter.
Example: public!g3mgt!<client string> means that
you determine the value of the client string.

Trademarks
xIssue 1 April 1996
Trademarks
The following trademarked products are mentioned in this document:
■DEFINITY is a registered trademark of AT&T
■DynaText is a registered trademark of Electronic Book Technologies,
Inc.
■All SPARC trademarks are trademarks or registered trademarks of Sun
Microsystems, Inc.
■UNIX is a registered trademark of Novell in the United States and other
countries, licensed exclusively throughX/Open Company Limited
■OpenWindows and SunOS are trademarks of Sun Microsystems, Inc.
■SPECTRUM, SpectroGRAPH, and SpectroSERVER are a registered
trademarks of Cabletron Systems, Inc.
■X Window System is a trademark of X Consortium, Inc.
Credentials
DEFINITY G3 Fault Management is ISO 9001 certified.

Your Fault Management Documentation Package
Issue 1 April 1996 xi
Your Fault Management
Documentation Package
Your Fault Management documentation package includes two parts:
■The installation guide (this book)
■Online documentation
Online Documentation
Two types of online documentation are available with Fault Management:
■Online help provides information about the Fault Management screen
that is currently active when you request help.
■The Network Management Solutions DEFINITY G3 Fault Management
user guide provides an overview of Fault Management features, tells
you about menus and window elements, and provides detailed
information on how to use the software. You can move easily around the
guide, and can display it on your monitor while Fault Management is
running.
This user guide, which is external to the Fault Management software, is
delivered online by DynaTextsoftware. DynaText is a text browser that
allows you to move easily through a document. The document appears
online in book format.

Reader Comments
xii Issue 1 April 1996
Reader Comments
Please fill out the reader comment card that is behind the title page. If the
comment cardhas been removed, please send your comments to the following
address:
AT&T
Product Documentation Development
Room 22-2C11
11900 North Pecos Street
Denver, Colorado 80234
Fax: [phone]
Please include the following information:
■The name of this document: DEFINITY G3 Fault Management Installation
and Integration for AT&T OneVision
■Your platform: SunOS
■Your network management system (NMS): Cabletron SPECTRUM

Issue 1 April 1996 1
1
Before You Begin
This chapter covers information you need to know before you begin
installing and setting up Fault Management, including:
■Overview of Fault Management
■Requirements for Fault Management installation
■Supported Systems
■Hardware and Software Requirements for Fault Management
■Installation and Setup Task List
Overview
This section is a high-level overview of Fault Management. It also gives
users who are new to network management systems a brief description of
the components of Fault Management's functionality, including how it fits
into the network management picture.

Before You Begin
2Issue 1 April 1996
Fault Management
Fault Management allows you to manage a DEFINITY G3 PBX as a node on
your network similar to other devices on your network. Fault Management
receives PBX data via your network management system (NMS).
The NMS receives the PBX data from the G3 Proxy Agent. The purpose of
the Proxy Agent is to receive PBXdata and to translate that data, which is in
DEFINITY's OSSI (Operating SupportSystem Interface) format, to the
SNMP (Simple NetworkManagementProtocol) format required by the NMS.
In addition, the Proxy Agent receives alarms data from the PBX and
translates that data into SNMP. It also provides administrative access to
the PBX.
With thePBX data available to the NMS, you can see alarm conditions on
any PBX that is a node on your NMSexactly as with other devices. From the
node map you can execute Fault Management to get data on the PBX.
Fault Management provides a graphical interface to that information, so that
you can quickly see where on a PBX fault conditions exist and display
reports about those fault conditions.
Standard Network Management Components
The standard SNMP-based management system consists of the following:
■An object or objects to be managed, in this case one or more DEFINITY
G3 PBXs
■An agent for managing the object(s)
It is the agent that communicates all management command responses
and information between the managed object and the NMS. The agent
can be implemented as part of the managed object, in which case it is
known as a native agent, or it can be implemented on a separate
computer, in which case it is known as a proxy agent. For DEFINITY G3
objects, the agent is a proxy agent because it is not built into the
DEFINITY G3 PBXs. Typically, there is one agent for each managed
object. However, the DEFINITY G3 Proxy Agent can support up to a

Overview
Issue 1 April 1996 3
maximum of fifteen DEFINITY G3 PBXs. The exact number of PBXs the
DEFINITY G3 Proxy Agent can support depends on the customer's
system configuration and networking capability.
■A Management Information Base (MIB) resident on the agent and on the
NMS
The MIB is a virtual data store used to transfer all information and
commands between the NMS and the agent via the SNMP. MIB-II is a
standard industry-wide MIB. The applications use two groups from
MIB-II and a specialized MIB called G3-MIB. Within the DEFINITY G3
environment,
MIB refers to the system and snmp groups from MIB-II
plus the entire G3-MIB.
■One (or more) network management stations, where the management
functions are performed using network management system (NMS)
software
In this case, the NMS is Cabletron SPECTRUM.
Fault Management resides on the NMS and provides functionality beyond
the standard set of components: the ability to manage a PBXas a node on
the network.
SEE ALSO:
For in depth information about Fault Management, refer to the online
Network Management Solutions DEFINITYG3 Fault Management user
guide.

Before You Begin
4Issue 1 April 1996
Network Connectivity
The SNMP runs on a TCP/IP link. Therefore, the connection between the
NMS and the Proxy Agent is a TCP/IP network. The following figure
illustrates the SNMP connections between the NMS, Fault Management,
and the Proxy Agent.
This diagram illustrates the connection between the DEFINITY G3 PBX and
the DEFINITY G3 Proxy Agent via system access ports, the connection
between the Proxy Agent and the NMS via the Internet, a LAN, or a WAN
with TCP/IP, and the connection of an X-terminal network management
station and the NMS via the same network.
Internet/
LAN/WAN
DEFINITY® G3
System
access
ports
DEFINITY
G3 Proxy Agent
TCP/IP
TCP/IP
TCP/IP
X-terminal
NMS:
• Operatingsystem- UNIX
• NMS platform
• DEFINITY G3 Fault Management

Installation and Setup Task List
Issue 1 April 1996 5
Installation and Setup Task List
This section provides a list of tasks, in the recommended order, to perform
while installing and setting up Fault Management. Use this list to check off
your installation activities as you complete them. You may want to make
your own task list based on this one, and include persons or organizations
responsible and dates to be completed.
NOTE:
These procedures assume that installation of Management
Solutions DEFINITY G3 Proxy Agent has occurred or will occur
shortly. You can install Fault Management without the Proxy Agent
being installed, but without the Proxy Agent up and running
properly and until the full connectivity is established, the NMS will
not receive any PBX data. Furthermore, communication between
theProxy Agent and Fault Management requires correlation
between values in specific fields on the Proxy Agent and NMS
administration. Therefore, you should plan some coordination for
installing these two applications.
❏Verify the environment is correct (Chapter 1)
Make sure you have the required operating system and network
connectivity already set up.
❏Verify hardware (Chapter 1)
Make sure you have all the required hardware and that the hardware
meets the certification requirements. Also make sure you have enough
space on the hard drive.
❏Verify existing software (Chapter 1)
Make sure the versions of your operating system and the NMS are
correct

Before You Begin
6Issue 1 April 1996
❏Prepare for software installation
■Do you have the Fault Management DEFINITY G3 Fault
Management Release 1.2 tape?
■Plan for the time needed to install the software (about ½hour)
❏Install the software (Chapter 2)
❏Make changes to the environment, such as updating the PATH variable
(Chapter 2)
❏Restart your NMS
❏Add the DEFINITY PBXs as nodes on the NMS
(Chapter 3)
❏Add the Proxy Agent(s) as a node(s) on the NMS
(Chapter 3)
❏Run Fault Management from the appropriate menu on your NMS
(Chapter 4). Verify that Fault Management
■Executes properly
■Is receiving data from the Proxy Agent
❏Run the Test INADS command on the PBX to test alarm reception (if
applicable)
❏Customize Fault Management
■Change polling intervals
■Change user-interface characteristics
SEE ALSO:
For instructions on customizing Fault Management, refer to the
Network Management Solutions DEFINITYG3 Fault Management user
guide.
❏Run the online guide to verify it is installed and executes correctly
(Chapter 4)

Requirements for Fault Management Installation
Issue 1 April 1996 7
Requirements for Fault
Management Installation
For Fault Management to be installed and to run properly, your NMS must
be set up with the following:
■Cabletron Release 3.1 Rev 0 or later
■A Sun MicroSystem SPARCworkstation which meets all hardware
requirements of CabletronSPECTRUM software
■The SunOS 4.1 operating system
■The shared library libc
■A 1/4-inch tape drive
■20 MB of random access memory
■At least 30 MB of free space on the hard drive
Certification
Fault Management is designed to run on the SunOS operating system.
AT&T does not explicitly certify any hardware, but does support Fault
Management on any Sun hardware that is certified by Cabletron
SPECTRUM.

Before You Begin
8Issue 1 April 1996