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 cabletron spectrum on a sunos
Hide thumbs Also See for OneVision DEFINITY G3 Fault Management:
Table of Contents

Advertisement

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

Advertisement

Table of Contents
loading

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

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

    Contents About This Book Audience Prerequisites Conventions Trademarks Credentials Your Fault Management Documentation Package Online Documentation Reader Comments Before You Begin Overview Fault Management Standard Network Management Components Network Connectivity Installation and Setup Task List Requirements for Fault Management Installation Certification Installation Installation Prerequisites...
  • Page 4 Contents Ac cessing the Installation Software Configuring the Installation Changing the Environment Integration Ad ding DEFINITY G3 PBX Nodes Node Limitations Adding a PBX as a Managed Node Adding a PBX Icon Ad ding DEFINITY G3 Proxy Agent Nodes Node Limitations Adding a Proxy Agent as a Managed Node Adding a Proxy Agent Icon Associating a PBX with a Proxy Agent...
  • Page 5 Contents 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 Warning Messages Data Refreshes Refreshing Data Manually The MIB...
  • Page 6 Contents Changing the Application Directory Telnetting to the Proxy Agent Overview of the Proxy Agent Why Should You Access the Proxy Agent? Telnetting to the Proxy Agent Index Issue 1 April 1996...
  • Page 7: About This Book

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

    Prerequisites 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 9: Conventions

    Conventions Conventions This book contains the following typographic conventions: Information that is displayed on your screen is shown in typewriter-style constant-width type. Example: Installation complete. Information that you enter from your keyboard or select from a menu is shown in bold type. Example: Enter attov_doc.
  • Page 10: Trademarks

    Trademarks 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 through X/Open Company Limited OpenWindows and SunOS are trademarks of Sun Microsystems, Inc.
  • 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: Reader Comments

    Reader Comments Reader Comments Please fill out the reader comment card that is behind the title page. 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: (303) 538-1741 Please include the following information:...
  • Page 13: Issue

    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: Fault Management

    Before You Begin 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 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.
  • Page 15 Overview 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 The MIB is a virtual data store used to transfer all information and commands between the NMS and the agent via the SNMP.
  • 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 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...
  • Page 19: Requirements For Fault Management Installation

    Requirements for Fault Management Installation 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 Cabletron SPECTRUM software The SunOS 4.1 operating system The shared library lib c...
  • Page 20 Before You Begin Issue 1 April 1996...
  • Page 21: Installation

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

    Installation 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). To install Fault Management on the Cabletron SPECTRUM platform, you need to: Access the SPECTRUM installation software Configure the installation Accessing the Installation Software...
  • Page 23: Configuring The Installation

    Installation Procedures Configuring the Installation The steps for configuring the Fault Management installation are described below. Start on the Copyright screen that displays after you complete the previous procedure. SEE ALSO: You use SPECTRUM to configure this installation. If you need help using this software, see the appropriate SPECTRUM installation guide.
  • Page 24 Installation Incorporates the DEFINITY G3 MIB into the existing MIB and updates the database Installs the DynaText online documentation NOTE: The installation takes a few minutes. While you are waiting, you can use the following steps to check on its progress. These steps are optional.
  • Page 25: Changing The Environment

    Changing the Environment 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: 1. Open your .profile file. 2. Add the following to your PATH variable: :/usr/OneVision/bin 3.
  • Page 26 Installation Issue 1 April 1996...
  • Page 27: Integration

    Integration 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 Cabletron SPECTRUM documentation for complete instructions to add a node. Issue 1 April 1996...
  • Page 28: Adding Definity G3 Pbx Nodes

    Integration 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 DEFINITY PBX or accurately identify the Proxy Agents.
  • Page 29 Ad ding DEFINITY G3 PBX Nodes 3. Select Edit, then New Model from the menu bar. Result: The Select New Model window displays. 4. Select DEFINITY_G3. 5. Click OK. Result: The Creating DEFINITY_G3 window displays. 6. Enter the following information: Field What you enter Model Name...
  • Page 30 Integration 7. Click OK. Result: The system polls the PBX and adds the following icon to the network map. 8. Use one of the following methods of saving your work: Select File, then Save & Close from the menu bar. Press the right mouse button.
  • Page 31: 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 32 Integration 5. Click OK. Result: The Creating G3ProxyAgent window displays. 6. Enter the following information: Field What you enter Model Name The name of the Proxy Agent Network Ad dress The IP address of the Proxy Agent Community Name public The client string identifies the PBX as a node on the network map.
  • Page 33: Associating A Pbx With A Proxy Agent

    Ad ding DEFINITY G3 Proxy Agent Nodes Associating a PBX with a Proxy Agent Fault Management cannot receive any trap data from the PBX until you associate the PBX with the Proxy Agent. You do this by making PBXs clients of the Proxy Agent. Use the following procedure to make this association: 1.
  • Page 34 Integration Issue 1 April 1996...
  • Page 35: 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 36: Opening The Online User Guide

    Starting the Applications Result: The system starts up the Fault Management application, beginning with the startup screen shown below. SEE ALSO: For information about the complete Fault Management start-up process, including the start-up screen and messages, refer to the online Management Solutions DEFINITY G3 Fault Management User Guide .
  • Page 37: Opening From The Network Map

    DynaText Documentation Opening from the Network Map Follow these steps to open the user guide from the network map: 1. Access the appropriate network map. 2. Use the middle mouse button to select a DEFINITY G3 icon. 3. Select DEFINITY_Doc from the pull-down menu. The system opens a DynaText window that contains a list of collections at the left.
  • Page 38 Starting the Applications For instructions about using DynaText: 1. Select the collection DynaText Documentation. 2. Select either DynaText Tutorial or DynaText Reader Guide. Issue 1 April 1996...
  • Page 39: 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 Verifying Connectivity Issue 1 April 1996...
  • Page 40: 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 41: 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 42: States Of The Proxy Agent Icons

    Alarm States The NMS polls the Proxy Agent for the g3connectState object. If the value is not “up,” then the icon’s state is set to Unknown. The default polling interval is one minute. States of the Proxy Agent Icons Each state of the Proxy Agent icon represents one of the possible conditions that can exist between the Proxy Agent and the PBX.
  • Page 43: Conditions Causing Change Of State

    States of the Proxy Agent Icons Conditions Causing Change of State G3 Proxy Agent 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.
  • Page 44: Verifying Connectivity

    Alarm States 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

    Verifying Connectivity 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

    Alarm States 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

    Verifying Connectivity 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

    Alarm States 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? — Is the modem working? — Is the phone line connected and do you get a dial tone? Does the Proxy Agent have a current, correct login and password for the DEFINITY PBX? Are the permissions correct? You can reset the login and password on the Proxy Agent...
  • 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: Default Colors It also explains some customization options that are not recommended for Fault Management.
  • Page 50: 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 51: Default Values

    Changing Default Values Default Values When you first open the application resource file, it contains the following defaults: Object Default BackgroundColor Grey ForegroundColor Black MajorAlarmColor MinorAlarmColor Orange WarningAlarmColor Yellow HighlightColor Green SelectColor Cyan MenubarColor Blue MenubarForegroundColor Yellow AlarmErrorRefresh CircuitPackRefresh AlarmPolling RefreshOnStart TRUE SNMPRetries...
  • Page 52: 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 original default setting for the invalid value. 3.
  • Page 53: 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 54: 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 55: Telnetting To The Proxy Agent

    Telnetting to the Proxy Agent Telnetting to the Proxy Agent To telnet to the Proxy Agent from the SPECTRUM NMS: 1. From the main map, use the middle mouse button to select a Proxy Agent icon. 2. Do one of the following: —...
  • Page 56 Telnetting to the Proxy Agent 6. Once you have logged in, execute the Proxy Agent application by entering the command g3-ma. The system opens the G3-MA main screen. NOTE: The Proxy Agent is based on existing AT&T PBX management software called Generic 3 Management Ap plications (G3-MA). For this reason, you enter commands and view screens that operate like the G3-MA interface.
  • Page 57: Index

    Index DynaText online browser Fault Management Agent definition See also Proxy Agent installing Alarms starting changing color data states DEFINITY Proxy Agent g3conectState Application directory g3connectAlarmForward AutoDiscovery g3healthMajor Autodiscovery g3healthMinor g3healthWarning G3-MIB Certification Client string Community name Hardware format Connectivity network verifying Conventions of book...
  • Page 58 Index Integration g3conectState adding g3connectAlarmForward PBX nodes g3healthMajor Proxy Agent nodes g3healthMinor g3healthWarning smuxProxyName sysDescr OneVision applications Libraries environment Online documentation installing starting using DynaText Operating Support System Interface Management Information Base (MIB) (0SSI) definition Operating system verifying connectivity OSSI. See Operating Support System Interface See Management Information Base MIB-II...
  • Page 59 Index TCP/IP Telnetting to the Proxy Agent benefits Random access memory (RAM) procedure Refresh color Traps Refreshing data Requirements installation Resource file Setup screen Setup task list Simple Network Management Protocol (SNMP) colors for retry values network connectivity standard management system smuxProxyName SNMP.
  • Page 60 Index Issue 2 April 1996...

Table of Contents