AT&T OneVision DEFINITY G3 Fault Management Installation And Integration Manual
AT&T OneVision DEFINITY G3 Fault Management Installation And Integration Manual

AT&T OneVision DEFINITY G3 Fault Management Installation And Integration Manual

Integration for at&t onevision
Hide thumbs Also See for OneVision DEFINITY G3 Fault Management:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the OneVision DEFINITY G3 Fault Management and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for AT&T OneVision DEFINITY G3 Fault Management

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

    Contents About This Book Intended Audiences Prerequisites How This Book Is Organized viii Conventions Used in This Book Trademarks and Service Marks How to Use This Book Your Fault Management Documentation Package Online Documentation How to Make Comments About This Book xiii Before You Begin Overview...
  • Page 3 Contents Installing Fault Management Installation Prerequisites Installation Procedures Changing the Environment Integrating OneVision Fault Management Ad ding DEFINITY G3 PBX Nodes Node Limitations Adding a PBX as a Managed Node Adding PBX Icons Configuring PBX Objects Ad ding DEFINITY G3 Proxy Agent Nodes Node Limitations Adding a Proxy Agent as a Managed Node Adding Proxy Agent Icons...
  • Page 4 Contents Opening from a Shell Prompt DynaText Documentation Alarm States States of the DEFINITY G3 Icons Icon States Conditions Causing Change of State States of the Proxy Agent Icons Icon States Conditions Causing Change of State Verifying Connectivity Icon State Startup Messages Startup Screen Switch View...
  • Page 5 Contents The Setup Screen The Application Resource File Accessing the Resource File Default Values Editing the File Other Options Changing Script Files Changing the Application Directory Changing the MIB Telnetting to the Proxy Agent Overview of the Proxy Agent Why Should You Access the Proxy Agent? Telnetting to the Proxy Agent Index IN-1...
  • Page 6: About This Book

    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) .
  • Page 7: How This Book Is Organized

    How This Book Is Organized How This Book Is Organized This book is organized as follows: 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.
  • Page 8: Conventions Used In This Book

    Conventions Used in This Book 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. Example: Please remove the installation diskette and continue when ready. Information that you enter from your keyboard or select from a menu is shown in bold type.
  • Page 9: Trademarks And Service Marks

    Trademarks and Service Marks Trademarks and Service Marks 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 registered trademark of Electronic Book Technologies, Inc.
  • Page 10: How To Use This Book

    How to Use This Book 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.
  • Page 11: Your Fault Management Documentation Package

    Your Fault Management Documentation Package 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.
  • Page 12: How To Make Comments About This Book

    How to Make Comments About This Book 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.
  • Page 13: Before You Begin

    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.
  • Page 14: Onevision Management Solutions Definity G3 Fault Management

    Before You Begin 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).
  • Page 15 Overview 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.
  • Page 16: Network Connectivity

    Before You Begin 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. System access TCP/IP...
  • Page 17: Installation And Setup Task List

    Installation and Setup Task List 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.
  • Page 18 Before You Begin 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 up dating the PATH variable (Chapter 2) Restart your NMS...
  • Page 19: Requirements For Fault Management Installation

    Requirements for Fault Management Installation 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 lib c...
  • Page 20: Installing Fault Management

    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...
  • Page 21: Installation Procedures

    Installing Fault Management 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 the command to install the Fault Management application and all related software, the system completes the installation without any need for intervention on your part.
  • Page 22: Changing The Environment

    Changing the Environment 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. Changing the Environment After the installation is complete, you need to change your operating environment so you can run the online documentation from a shell prompt: Ad d /usr/OV/OneVision/bin to your PATH variable.
  • Page 23: Integrating Onevision Fault Management

    Integrating OneVision Fault Management This chapter provides information about integrating Fault Management with your NMS. This chapter covers: Adding DEFINITY G3 PBX Nodes Adding DEFINITY G3 Proxy Agent Nodes SEE ALSO: Refer to the AT&T OneVision user manual for complete instructions to add a node.
  • Page 24: Adding Definity G3 Pbx Nodes

    Integrating OneVision Fault Management Adding DEFINITY G3 PBX Nodes This section includes the procedures for adding a DEFINITY G3 PBX to the node map. These procedures are meant to enhance, not replace, your NMS’s normal instructions for adding a node. NOTE: Autodiscovery, which normally identifies elements of the network and places them correctly on the network map, does not locate a...
  • Page 25: Adding Pbx Icons

    Ad ding DEFINITY G3 PBX Nodes Adding PBX Icons Use the following steps to add an icon to the network map: 1. Display the appropriate network map. 2. From the menu bar, select Edit, then select Add Object. Result: The Add Object Pallet window opens. 3.
  • Page 26: Configuring Pbx Objects

    Integrating OneVision Fault Management 9. This step is optional. You can change the contents of the Selection Name field (populated when you completed step 6.) CAUTION: The Selection Name is a key field that must match the SNMP configuration name. If you choose to change this field, follow these guidelines: a.
  • Page 27 Ad ding DEFINITY G3 PBX Nodes 3. Enter the following information: Field What you enter . . . Proxy The name or IP address of the Proxy Agent with which the PBX will be communicating Target The object's name. The name you enter in this field must match the name in the Selection Name field in step 9 of the previous procedure, Adding PBX Icons.
  • Page 28 Integrating OneVision Fault Management 5. Click Add. 6. Click OK. The following table is an example of the parameters completed for a DEFINITY G3 PBX. Field Parameter Proxy agent_6 Target Community public!g3mgt!mc3 Set Community public!g3mgt!mc3 Timeout Retry Count Remote Port Status Polling Issue 1 October 1995...
  • Page 29: Adding Definity G3 Proxy Agent Nodes

    Ad ding DEFINITY G3 Proxy Agent Nodes Adding DEFINITY G3 Proxy Agent Nodes This section includes the procedure for adding a Proxy Agent as a managed node. Node Limitations The number of Proxy Agent nodes that you can have on your NMS is limited only by the total number of nodes allowed by your NMS.
  • Page 30 Integrating OneVision Fault Management Result: The Add Object Palette window displays the following icons under the heading Symbol Subclasses for Class OneVision: Generic, G3 PBX, and G3 Proxy. 4. Drag the G3 Proxy icon shown at left, onto the map. Result: The system inserts the icon on the map and opens the Ad d Object window.
  • Page 31: Configuring Proxy Agent Objects

    Ad ding DEFINITY G3 Proxy Agent Nodes 9. This step is optional. You can change the contents of the Selection Name field (populated when you completed step 6.) CAUTION: The Selection Name is a key field that must match the SNMP configuration name.
  • Page 32 Integrating OneVision Fault Management 3. Enter the following information: Field What you enter . . . Target The Proxy Agent’s name The name you enter in the Target field must match the name you entered in the following fields. These names must be spelled and capitalized exactly the same.
  • Page 33 Ad ding DEFINITY G3 Proxy Agent Nodes The following table is an example of entries made for a typical Proxy Agent. Field Parameter Comments Proxy Not used Target The Proxy If your network has a name Agent name or server, use the Proxy Agent IP address name that you entered in the Label field.
  • Page 34: Starting The Applications

    Starting the Applications This chapter provides information for Starting Fault Management Starting Fault Management's online user guide This chapter assumes you have already installed the Fault Management application and added DEFINITY G3 nodes to your map, as described in Chapter 2 and Chapter 3. If not, complete the procedures in those chapters before you continue.
  • Page 35: Starting With The Mouse

    Starting the Applications 3. Select G3 Fault Management from the submenu. Result: The system begins the Fault Management startup process. Starting with the Mouse Follow these steps to start Fault Management with the mouse. 1. At the appropriate map, select the icon for which you want to run Fault Management.
  • Page 36: Opening The Online User Guide

    Opening the Online User Guide Opening the Online User Guide The online user guide, OneVision Management Solutions DEFINITY G3 Fault Management, describes how to use the Fault Management application. This guide is available in DynaText, an ap plication automatically installed by Fault Management. You can open this user guide from the: Network map Shell prompt...
  • Page 37: Opening From A Shell Prompt

    Starting the Applications Opening from a Shell Prompt To access the online guide from a shell prompt, enter the command attov_doc. DynaText Documentation Along with the Fault Management online user guide, the online package includes the following information about DynaText. The DynaText Tutorial provides instructions for using the DynaText online browser.
  • Page 38: Alarm States

    Alarm States This chapter provides information about the alarm states for the DEFINITY PBXs and the Proxy Agent. This chapter covers: Understanding DEFINITY G3 PBX Icon States Understanding Proxy Agent Icon States Adjusting Polling Intervals for Network Traffic Verifying Connectivity Issue 1 October 1995...
  • Page 39: States Of The Definity G3 Icons

    Alarm States States of the DEFINITY G3 Icons Each state of the DEFINITY G3 PBX icon represents one of the possible conditions that can exist on the PBX. An icon's state depends on whether the Proxy Agent is communicating with the PBX and if the SNMP connection between the Proxy Agent and the NMS is established.
  • Page 40: Conditions Causing Change Of State

    States of the DEFINITY G3 Icons Conditions Causing Change of State Icons are in a certain state based on one of several events, either the NMS polling the Proxy Agent or the Proxy Agent sending traps to the NMS. The following events can change a PBX icon’s state: The NMS polls the Proxy Agent for the g3healthMajor object.
  • Page 41: States Of The Proxy Agent Icons

    Alarm States The NMS polls the Proxy Agent for the sysDescr object to determine if the Proxy Agent is running. If the NMS receives a response that the object does not exist or if the Proxy Agent does not respond, the icon's state is set to Unknown.
  • Page 42: Icon States

    States of the Proxy Agent Icons Icon States The states or conditions for Proxy Agent icons are as follows: State Definition Normal The Proxy Agent is communicating with the NMS and that the G3 Peer process is registered with the SMUX agent process. Warning The Proxy Agent is communicating with the NMS and that the NMS has received an authentication...
  • Page 43 Alarm States a single object containing the value g3mgt , the state of the icon returns to Normal. The default polling interval for the smuxProxyName object is every five minutes. The NMS polls the Proxy Agent for the sysDescr object (object ID 1.3.6.1.2.1.1.1) to determine if the Proxy Agent is responding.
  • Page 44: Verifying Connectivity

    Verifying Connectivity Verifying Connectivity You can use the following features to verify that the Proxy Agent is connected to a PBX: Icon states Fault Management startup messages Warning messages Data refreshes The Management Information Base (MIB) Icon State The DEFINITY G3 Proxy Agent maintains continuous contact with the DEFINITY PBXs that it serves.
  • Page 45: Startup Screen

    Alarm States Startup Screen Verify that the Proxy Agent is connected to the PBX when you start Fault Management as follows: 1. Follow your normal startup procedure. 2. When the Fault Management Startup screen displays, examine the startup message. Then the If the message is .
  • Page 46: Switch View

    Verifying Connectivity Switch View If the Proxy Agent has not established a connection to the PBX during startup, the following items display: The Startup Refresh pop-up window displays in the center of the Switch View. The message in this window informs you that the refresh failed. NOTE: This window displays only if the Refresh Proxy Agent On Startup field on the Setup screen is set to TRUE.
  • Page 47: Data Refreshes

    Alarm States Data Refreshes You can verify that the Proxy Agent is connected to the PBX while Fault Management is running by refreshing the PBX data. Fault Management can refresh PBX data only if the Proxy Agent is connected to the PBX. Therefore, if a refresh fails, the Proxy Agent may have lost contact with the PBX.
  • Page 48: Troubleshooting Disconnects

    Verifying Connectivity 3. Select PBX MIB Values from the DEFINITY pull-down menu. 4. Select Connect Group... If the value in the Switch Connect State field is up, the PBX you selected is connected to the Proxy Agent. TroubleShooting Disconnects If the Proxy Agent is not in contact with a DEFINITY PBX, check the following common causes for a disconnect: Can the Proxy Agent dial out? —...
  • Page 49: Advanced Customization

    Advanced Customization Your online user guide explains how to use the Setup screen to customize Fault Management. This appendix describes the advanced customization options for changing the following: Polling Intervals Default Colors It also explains some customization options that are not recommended for Fault Management.
  • Page 50: Changing The Polling Interval

    Changing the Polling Interval Changing the Polling Interval You can change the responsiveness of network traffic by changing the polling intervals. If you: Increase the polling interval, network traffic may decrease Decrease the polling intervals, network traffic may increase You need to find a balance between responsiveness and network traffic. The polling interval determines the amount of time that Fault Management’s polling program is in the sleep mode.
  • Page 51: The Setup Screen

    Changing Default Values The Setup Screen The Setup screen allows you to change Fault Management defaults for: Alarms Highlighting Selecting objects Refresh and polling intervals Refresh on startup values SNMP retry values When you save the changes that you make on this screen, Fault Management overwrites the information in the application resource file.
  • Page 52: Default Values

    Changing Default Values Default Values When you first open the application resource file, it contains the following defaults: Object Default Color BackgroundColor Grey66 ForegroundColor Black MajorAlarmColor MinorAlarmColor Orange WarningAlarmColor Yellow HighlightColor Green SelectColor Cyan MenubarColor #729ff MenubarForegroundColor Black AlarmErrorRefresh CircuitPackRefresh AlarmPolling RefreshOnStart TRUE...
  • Page 53: Other Options

    Other Options 2. Edit the file by entering a valid value. For colors, you can enter either a color name or a RGB value at the appropriate line. NOTE: If you enter an invalid color setting, Fault Management substitutes the invalid value with the original default setting. 3.
  • Page 54: Changing The Application Directory

    Other Options Changing the Application Directory The application directory contains all executable and default parameter files. It is located at /usr/OV/OneVision. We recommend that you do not change its location. Changing the MIB The Management Information Base (MIB) contains definitions of managed objects and associated management information.
  • Page 55: Telnetting To The Proxy Agent

    Telnetting to the Proxy Agent This appendix provides the following information about how to telnet to the Proxy Agent: Overview of the Proxy Agent Why you need access to the Proxy Agent Instructions on how to telnet CAUTION: Telnet is not a secure protocol; logins and passwords are not encrypted before they are transmitted.
  • Page 56: Why Should You Access The Proxy Agent

    Why Should You Access the Proxy Agent? SNMP (Simple Network Management Protocol). SNMP is the protocol format that the NMS requires in order to read network management data. The Proxy Agent also provides access to the PBX. SEE ALSO: For more information about the Proxy Agent and its functions and features, see OneVision DEFINITY G3 Proxy Agent Installation and Connectivity and OneVision DEFINITY G3 Proxy Agent Online Help Guide , which is available from the Proxy Agent's Main Menu.
  • Page 57: Telnetting To The Proxy Agent

    Telnetting to the Proxy Agent Telnetting to the Proxy Agent To telnet to the Proxy Agent from the AT&T OneVision NMS: 1. From the main map, select the Proxy Agent icon. 2. Do one of the following: — Double click the Proxy Agent icon. —...
  • Page 58 Telnetting to the Proxy Agent this reason, you enter commands and view screens that operate like the G3-MA interface. If you already have G3-MA, then you will be familiar with how to use the Proxy Agent. 6. Press to continue. The system then opens the Main Menu. If you Return do not press , the system opens the Main Menu on its own after a...
  • Page 59: Default Values A

    Index DG3FMdefaults Disk space DynaText online browser Agent See also Proxy Agent Alarms Fault Management changing color definition data – installing – states – starting DEFINITY Proxy Agent Application directory Autodiscovery g3conectState g3connectAlarmForward g3healthMajor g3healthMinor Client string g3healthWarning Community name G3-MIB format Community string...
  • Page 60: Index

    Index Installation Node, number supported – procedure requirements – task list – Integration 3-11 adding Objects – PBX nodes changing color – Proxy Agent nodes 3-11 – – configuring 3-11 IP address g3conectState g3connectAlarmForward g3healthMajor g3healthMinor g3healthWarning Libraries smuxProxyName sysDescr OneVision applications environment...
  • Page 61 Index – as a node online documentation – adding to networks 3-11 Strings – – configuring 3-10 client definition community 3-10 icon states name IP address Proxy Agent number supported Switch. See PBX telnetting sysDescr benefits – procedure Proxy Agent string Tape drive TCP/IP Telnetting to the Proxy Agent...

Table of Contents