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

585-229-104
Issue 2
April 1996
OneVision
DEFINITY G3
Fault Management
Installation and Integration
for HP OpenView on an
HP9000
Graphics ©
Table of Contents

Contents
Issue 2 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 2 April 1996
■Changing the Environment 11
3 Integration 13
■Adding DEFINITY G3 PBX Nodes 14
Node Limitations 14
Adding aPBX as a Managed Node 14
Adding a PBX Icon 15
Configuring a PBX Object 16
■Adding DEFINITY G3Proxy Agent Nodes 19
Node Limitations 19
Adding aProxy Agent as a Managed Node 19
Adding a Proxy Agent Icon 19
Configuring aProxy 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
■DynaText Documentation 28

Contents
Issue 2 April 1996 v
5 Alarm States 29
■States of the DEFINITY G3 Icons 30
IconStates 30
Conditions Causing Change of State 31
■States of the Proxy Agent Icons 32
IconStates 32
Conditions Causing Change of State 33
■Verifying Connectivity 34
IconState 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 2 April 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 theProxy Agent? 48
■Telnetting to the Proxy Agent 49
IN Index 51

Issue 2 April 1996 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.
Audience
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 PBXs on the Hewlett Packard OpenView
Windows 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.

Prerequisites
viii Issue 2 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 OneVision 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 2 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 ovinstall.
Means type ovinstall and then press Enter.
Example: public!g3mgt!<client string> means that
you determine the value of the client string.

Trademarks
xIssue 2 April 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
■DynaText is a trademark of Electronic Book Technologies, Inc.
■HP OpenView is a registered trademark of Hewlett-Packard Company
■UNIX is a registered trademark of Novell in the United States and other
countries, licensed exclusively throughX/Open Company Limited
Credentials
DEFINITY G3 Fault Management is ISO 9001 certified.
AT&T GBCS is also an HP OpenView Solution Partner; and Fault Management
is listed in the HP OpenView Solutions catalog.

Your Fault Management Documentation Package
Issue 2 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 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.

Reader Comments
xii Issue 2 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 thefollowing
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: HP-UX
■Your network management system (NMS): HP OpenView

Issue 2 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 2 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 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 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 OneVision DEFINITY G3 Proxy Agent can support

Overview
Issue 2 April 1996 3
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 HP OpenView and Network Node Manager.
Fault Management resides on the NMS and provides functionality beyond
the standard set of components: the ability to manage a PBX as a node on
the network.
SEE ALSO:
For in depth information about Fault Management, refer to the online
OneVision Network Management Solutions DEFINITY G3 Fault
Management
user guide.

Before You Begin
4Issue 2 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 2 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 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
❏Prepare for software installation
■Do you have the OneVision DEFINITY G3 Fault Management
Release 1.2 tape?

Before You Begin
6Issue 2 April 1996
■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 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
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 2 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:
■Hewlett Packard OpenView and Network Node Manager Release 3.3
■A Hewlett Packard 9000-series workstation which meets all hardware
requirements of the Hewlett Packard OpenView Windows and Network
Node Manager Release 3.3 software
■The HP-UX 9.x operating system
■The DFIX1211 patch
■2 Gbyte DAT tape drive
■The shared library libc
■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 HP-UX 9.x operating system.
AT&T does not explicitly certify any hardware, but does support Fault
Management on any HP 9000 hardware that is certified by HP OpenView.

Issue 2 April 1996 9
2
Installation
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 Chapter1, and
be sure that your computer environment meets all the stated hardware and
software requirements.

Installation
10 Issue 2 April 1996
Installation Procedures
The Fault Management installation is fully automated (however, after the
installation is complete, you will need to make some basic changes to your
operating environment). Once you execute thecommand to install the Fault
Management application and all related software, the system completes
the installation without any need for intervention on your part.
Use the following steps to install Fault Management on an HP OpenView
platform:
1. Insert the tape into the tape drive.
2. Log into the operating system as root.
3. Change directory to /usr/OV/bin
4. Enter the following command:
./ovinstall -pDG3FM -- -d /dev/nrstl
The installation procedure completes the following:
■Registers the application name with the NMS
■Creates the necessary directory structure and copies all the
necessary files, include the bitmap, MIB, default database,
script, and application files
■Installs the Fault Management application
■Incorporates the new fields
■Compiles the new bitmaps
■Incorporates the DEFINITY G3 MIB into the existing MIB
■Installs the DynaText online documentation
5. Restart your NMS before accessing the OneVision application.