Lucent Technologies OneVision DEFINITY G3 Fault Management Quick setup guide

OneVision Definity G3
Fault Management Installation and Inte-
gration for IBM NetView on AIX
585-229-114
Comcode
107705659
Issue 1

Copyright 1996, Lucent Technologies
All Rights Reserved
Printed in U.S.A.
Notice
Every effort was made to ensure that the information in
this book was complete and accurate at the time of print-
ing. However, information is subject to change.
Your Responsibility for Your System’s Security
Toll fraud is the unauthorized use of your telecommuni-
cations system by an unauthorized party, for example,
persons other than your company’s employees, agents,
subcontractors, or persons working on your company’s
behalf. Note that there may be a risk of toll fraud associ-
ated with your telecommunications system and, if toll
fraud occurs, it can result in substantial additional
charges for your telecommunications services.
You and your system manager are responsible for the
security of your system, such as programming and con-
figuring your equipment to prevent unauthorized use.
The system manager is also responsible for reading all
installation, instruction, and system administration doc-
uments provided with this product in order to fully
understand the features that can introduce risk of toll
fraud and the steps that can be taken to reduce that risk.
Lucent Technologies does not warrant that this product
is immune from or will prevent unauthorized use of
common-carrier telecommunication services or facilities
accessed through or connected to it. Lucent Technolo-
gies will not be responsible for any charges that result
from such unauthorized use.
Lucent Technologies Fraud Intervention
If you suspect that you are being victimizedby toll fraud
and you need technical support or assistance, call Tech-
nical Service Center Toll Fraud Intervention Hotline at
1 800 643-2353.
Trademarks
xxx is a trademark of xxx corp.
Ordering Information
Call: Lucent Technologies Publications Center
Voice 1 800 457-1235
International Voice 317 361-5353
Fax [phone]
International Fax [phone]
Write: Lucent Technologies Publications Center
P.O. Box 4100
Crawfordsville, IN 47933
Order: Document No. 585-229-114
Comcode 107705659
Issue 1, August 1996
For additional documents, refer to the section entitled,
“Related Documents” in “About This Book.”
You can be placed on a Standing Order list for this and
other documents you may need. Standing Order will
enable you to automatically receive updated versions of
individual documents or document sets, billed to
account information that you provide. For more infor-
mation on Standing Orders, or to be put on a list to
receive future issues of this document, please contact
the Lucent Technologies Publications Center.
Comments
To comment on this document, return the comment card
at the front of the document.
Acknowledgment
This document was prepared by the Product Documen-
tation Development group, Lucent Technologies, Den-
ver, CO.

Contents
Issue 1 August 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 8
Certification 8
2 Installation 9
■Installation Prerequisites 9
■Installation Procedures 10

Contents
iv Issue 1 August 1996
■Changing the Environment 11
3 Integration 13
■Adding DEFINITY G3 PBX Nodes 14
Node Limitations 14
Adding a PBX as a Managed Node 14
Adding a PBX Icon 14
Configuring a PBX Object 16
■Adding DEFINITY G3 Proxy Agent Nodes 19
Node Limitations 19
Adding a Proxy Agent as a Managed Node 19
Adding a Proxy Agent Icon 19
Configuring a Proxy Agent Icon 21
4 Starting the Applications 25
■Starting Fault Management 25
Starting from the Network Map 25
Starting with the Mouse 26
■Opening the Online User Guide 27
Opening from the Network Map 27
Opening from a Shell Prompt 28
■ Dyna Text Documentation 28

Contents
Issue 1 August 1996 v
5 Alarm States 29
■States of the DEFINITY G3 Icons 30
Icon States 30
Conditions Causing Change of State 31
■States of the Proxy Agent Icons 32
Icon States 32
Conditions Causing Change of State 33
■Verifying Connectivity 34
Icon State 34
Startup Messages 34
Startup Screen 35
Switch View 36
Warning Messages 36
Data Refreshes 37
Refreshing Data Manually 37
The MIB 37
Troubleshooting Disconnects 38
A Advanced Customization 41
■Changing the Polling Interval 42
■Changing Default Values 42
The Setup Screen 43
The Application Resource File 43
Accessing the Resource File 43
Default Values 44
Editing the File 44

Contents
vi Issue 1 August 1996
■Other Options 45
Changing Script Files 45
Changing the Application Directory 45
Changing the MIB 46
B Telnetting to the Proxy Agent 47
■Overview of the Proxy Agent 47
■Why Should You Access the Proxy Agent? 48
■Telnetting to the Proxy Agent 49
IN Index 51

Issue 1 August 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 DEFINITY Generic 3 customers who use DEFINITY
G3 Fault Management (referred to hereafter as Fault Management) to manage
their PBXs on the IBMNetView4.1.
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 August 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 August 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 tar.
Means type tar and then press Enter.
Example: public!g3mgt!<client string> means that
you determine the value of the client string.

Trademarks
xIssue 1 August 1996
Trademarks
The following trademarked products are mentioned in this document:
■DEFINITY is a registered trademark of AT&T
■OneVision is a trademark of AT&T
■ Dyna Text is a trademark of Electronic Book Technologies, Inc.
■IBM, NetView, and AIX are trademarks or registered trademarks of IBM.
Credentials
The development process for DEFINITYG3 Fault Management is ISO 9001
certified.

Your Fault Management Documentation Package
Issue 1 August 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
Dyna Textsoftware. Dyna Text 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 August 1996
Reader Comments
Please fill out the reader comment card. If the comment card has been
removed from this book, please send your comments to the following address:
Lucent Technologies
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: DEFINITYG3 Fault Management Installation
and Integration for OneVision
■Your platform: AIX
■Your network management system (NMS): IBM NetView

Issue 1 August 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 August 1996
Fault Management
Fault Management allows you to manage a DEFINITY G3 PBXas 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 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 the PBX 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 August 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 IBM NetView.
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 August 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.
3
4 4
4
1
25
6

Installation and Setup Task List
Issue 1 August 1996 5
Legend:
1. DEFINITY G3
2. System access ports
3. DEFINITY G3 Proxy Agent
4. TCP/IP
5. Internet/LAN/WAN
6. X-terminal
7. NMS
■Operating system = AIX
■NMS platform
■DEFINITY G3 Fault Management
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
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.

Before You Begin
6Issue 1 August 1996
❏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
❏Prepare for software installation
■Do you have the 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

Installation and Setup Task List
Issue 1 August 1996 7
■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)

Before You Begin
8Issue 1 August 1996
Requirements for Fault
Management Installation
For Fault Management to be installed and to run properly, your NMS must
be set up with the following:
■IBM NetView 4.1
■An IBM AIX workstation which meets all hardware requirements
■The AIX4.1 operating system
■A 1/4-inch tape drive
■20 Mbytes of random access memory
■At least 30 Mbytes of free space on the hard drive
Certification
Fault Management is designed to run on the AIX operating system. Lucent
Technologies does not explicitly certify any hardware, but does support
Fault Management on any hardware that is certified by IBM.