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

585-229-109
Issue 1
October, 1995
OneVision™ DEFINITY® G3
Fault Management
Installation and Integration
for AT&T OneVision™
Graphics © AT&T 1988
Table of
Contents

Contents
Issue 1 October 1995 iii
About This Book vii
■Intended Audiences vii
■Prerequisites vii
■How This Book Is Organized viii
■Conventions Used in This Book ix
■Trademarks and Service Marks x
■How to Use This Book xi
■Your Fault Management Documentation Package xii
Online Documentation xii
■How to Make Comments About This Book xiii
1 Before You Begin 1-1
■Overview 1-1
OneVision Management Solutions DEFINITY
G3 Fault Management 1-2
Standard Network Management Components 1-2
Network Connectivity 1-4
■Installation and Setup Task List 1-5
■Requirements for Fault Management Installation 1-7
Certified Hardware 1-7

Contents
iv Issue 1 October 1995
2 Installing Fault Management 2-1
■Installation Prerequisites 2-1
■Installation Procedures 2-2
■Changing the Environment 2-3
3 Integrating OneVision Fault Management 3-1
■Adding DEFINITY G3 PBX Nodes 3-2
Node Limitations 3-2
Adding a PBX as a Managed Node 3-2
Adding PBXIcons 3-3
Configuring PBX Objects 3-4
■Adding DEFINITY G3Proxy Agent Nodes 3-7
Node Limitations 3-7
Adding a Proxy Agent as a Managed Node 3-7
Adding Proxy Agent Icons 3-7
Configuring Proxy Agent Objects 3-9
4 Starting the Applications 4-1
■Starting Fault Management 4-1
Starting from the Network Map 4-1
Starting with the Mouse 4-2
■Opening the Online User Guide 4-3
Opening from the Network Map 4-3

Contents
Issue 1 October 1995 v
Opening from a Shell Prompt 4-4
■DynaText Documentation 4-4
5 Alarm States 5-1
■States of the DEFINITY G3 Icons 5-2
IconStates 5-2
Conditions Causing Change of State 5-3
■States of the Proxy Agent Icons 5-4
IconStates 5-5
Conditions Causing Change of State 5-5
■Verifying Connectivity 5-7
IconState 5-7
Startup Messages 5-7
Startup Screen 5-8
Switch View 5-9
Warning Messages 5-9
Data Refreshes 5-10
Refreshing Data Manually 5-10
The MIB 5-10
TroubleShooting Disconnects 5-11
A Advanced Customization A-1
■Changing the Polling Interval A-2
■Changing Default Values A-2

Contents
vi Issue 1 October 1995
The Setup Screen A-3
The Application Resource File A-3
Accessing the Resource File A-3
Default Values A-4
Editing the File A-4
■Other Options A-5
Changing Script Files A-5
Changing the Application Directory A-6
Changing the MIB A-6
B Telnetting to the Proxy Agent B-1
■Overview of the Proxy Agent B-1
■Why Should You Access theProxy Agent? B-2
■Telnetting to theProxy Agent B-3
IN Index IN-1

Issue 1 October 1995 vii
About This Book
This book provides information about OneVision DEFINITY G3 Fault
Management and Proxy Agent connectivity and tells you how to install and
initially set up your OneVision DEFINITY G3 application.
Intended Audiences
This book is intended for AT&T's DEFINITY Generic 3 customers who use
OneVision DEFINITY G3 Fault Management (referred to hereafter as Fault
Management) to manage their switches on the AT&T OneVision and Network
Node Manager 3.3 network management system (NMS) .
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.

How This Book Is Organized
viii Issue 1 October 1995
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 OneVision states, alarms, polls, and masks,
for DEFINITY G3 PBXs and for DEFINITY Proxy Agents.
Appendix A Helps you troubleshoot Fault Management in the event a
problem occurs. Thisappendix also has guidelines for NMS
configuration and system administration for use with Fault
Management.
Appendix B Explains how to telnet to the Proxy Agent.

Conventions Used in This Book
Issue 1 October 1995 ix
Conventions Used in This Book
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: Please remove the installation
diskette and continue when ready.
Example: Enter attov_doc.
Click OK.
Example: Press Enter.
Example: Enter the command ovinstall.
Means type ovinstall and then press Enter.
Example: public!g3mgt!<client string> means that
you determine the value of the client string.

Trademarks and Service Marks
xIssue 1 October 1995
Trademarks and Service Marks
The following trademarked products are mentioned in this document:
■DEFINITY®is a registered trademark of AT&T
■OneVisionTM is a trademark of AT&T
■DynaText®is a registered trademark of Electronic Book Technologies,
Inc.
■UNIX®is a registered trademark of Novell in the United States and other
countries, licensed exclusively through X/Open Company Limited

How to Use This Book
Issue 1 October 1995 xi
How to Use This Book
This book is designed to help you quickly get the information you need to
install and set up Fault Management. You likely will not need to use the entire
book, but will need particular information in it to meet your requirements.
We recommend you read all of Chapter 1 first because it provides important
basic information. Then use the following table to determine which chapters
you need:
To do this: Use:
Prepare your computer environment Chapter 1
Perform prerequisite UNIX system administration Chapter 2
Install Fault Management software Chapter 2
Set up switches as nodes on the NMS Chapter 3
Set up the Proxy Agent node on the NMS Chapter 3
Troubleshoot problems encountered while
installing or running Fault Management Appendix A
Launch Fault Management Chapter 4
Read the online user guide Chapter 4
Understand the DEFINITY G3 alarm states Chapter 5
Telnet to the Proxy Agent Appendix B

Your Fault Management Documentation Package
xii Issue 1 October 1995
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 OneVision 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.

How to Make Comments About This Book
Issue 1 October 1995 xiii
How to Make Comments About
This Book
A reader comment card is behind the title page. While we have tried to make
this book fit your needs, we are interested in your suggestions for
improvements and urge you to fill out a card.
If the comment card has 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: OneVision DEFINITY G3 Fault Management
Installation and Integration for AT&T OneVision
■Your platform: SVR4

Issue 1 October 1995 1-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
1-2 Issue 1 October 1995
OneVision Management Solutions DEFINITY
G3 Fault Management
OneVision Management Solutions DEFINITY G3 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 OneVision G3 Proxy Agent. The
purpose of the Proxy Agent is to receive PBX data and to translate that
data, which is in DEFINITY's OSSI (Operating Support System Interface)
format, to the SNMP (Simple Network Management Protocol) 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 NMS exactly 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

Overview
Issue 1 October 1995 1-3
DEFINITY G3 PBXs. Typically, there is one agent for each managed
object. However, the OneVision DEFINITY G3 Proxy Agent can support
up to a 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 OneVision applications use two
groups from MIB-II and a specialized MIB called G3-MIB. Within the
OneVision 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 AT&T OneVision.
The OneVision DEFINITY G3 Fault Management product resides on the
NMS and provides functionality beyond the standard set of components:
the ability to manage aPBXas a node on the network.
SEE ALSO:
For indepth information about Fault Management, refer to the online
OneVision Network Management Solutions DEFINITY G3 Fault
Management
user guide.

Before You Begin
1-4 Issue 1 October 1995
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:
• Operating system - UNIX
• NMS platform
• DEFINITY G3 Fault Management

Installation and Setup Task List
Issue 1 October 1995 1-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 OneVision
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 the Proxy 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
1-6 Issue 1 October 1995
❏Prepare for software installation
■Do you have the OneVision DEFINITY G3 Fault Management
Release 1.0.1 tape?
■Plan for the time needed to install the software (about ½hour)
■Perform prerequisite operating-system administration
❏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 theProxy Agent
❏Run the Test INADS command on the PBX to test alarm reception.
❏Customize Fault Management
■Change polling intervals
■Change user-interface characteristics
SEE ALSO:
For instructions on customizing Fault Management, refer to the
OneVision Network Management Solutions DEFINITY G3 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 October 1995 1-7
Requirements for Fault
Management Installation
In order for Fault Management to be installed and to run properly, your
NMS must be set up with the following:
■AT&T OneVision Network Node Manager Release 3.3
■AT&T GIS workstation that meets all hardware requirements of the AT&T
OneVision Network Node Manager Release 3.3 software
■The SVR4 version 3 operating system
■The shared library libc
■A 1/4-inch tape drive
■20 MB of random access memory
■At least 28 MB of free space on the hard drive
The approximate amount of disk space required by Fault Management is 24
MB.
Certified Hardware
Fault Management is designed to run on any computer hardware and
operating system that is certified to run your AT&TOneVision Network Node
Manager Release 3.3.

Issue 1 October 1995 2-1
2
Installing Fault Management
This chapter provides the procedures to install your Fault Management
software. The instructions in this chapter are designed for the system
administrator. Procedures for setting up Fault Management within your
NMS are in subsequent chapters.
This chapter covers:
■Installation Prerequisites
■The steps to install Fault Management
■Changing your Operating Environment
Installation Prerequisites
Before you install Fault Management, be sure you have read Chapter 1, and
be sure that your computer environment meets all the stated hardware and
software requirements.