Lucent Technologies OneVision DEFINITY G3 Fault Management Installation And Integration Manual
Lucent Technologies OneVision DEFINITY G3 Fault Management Installation And Integration Manual

Lucent Technologies OneVision DEFINITY G3 Fault Management Installation And Integration Manual

Integration for ibm netview on aix
Hide thumbs Also See for OneVision DEFINITY G3 Fault Management:
Table of Contents

Advertisement

Quick Links

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

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

Summary of Contents for Lucent Technologies OneVision DEFINITY G3 Fault Management

  • Page 1 OneVision Definity G3 Fault Management Installation and Inte- gration for IBM NetView on AIX 585-229-114 Comcode 107705659 Issue 1...
  • Page 2 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.
  • 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 Changing the Environment Integration Adding DEFINITY G3 PBX Nodes Node Limitations Adding a PBX as a Managed Node Adding a PBX Icon Configuring a PBX Object Adding DEFINITY G3 Proxy Agent Nodes Node Limitations Adding a Proxy Agent as a Managed Node Adding a Proxy Agent Icon Configuring a Proxy Agent Icon Starting the Applications...
  • 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 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 Issue 1 August 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 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.
  • 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 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 DEFINITY G3 Fault Management is ISO 9001 certified.
  • 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. 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...
  • 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: 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. Issue 1 August 1996...
  • Page 17: Installation And Setup Task List

    Installation and Setup Task List 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.
  • Page 18 Before You Begin 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.
  • Page 19 Installation and Setup Task List Change polling intervals Change user-interface characteristics SEE ALSO: For instructions on customizing Fault Management, refer to the Network Management Solutions DEFINITY G3 Fault Management user guide. Run the online guide to verify it is installed and executes correctly (Chapter 4) Issue 1 August 1996...
  • Page 20: Requirements For Fault Management Installation

    Before You Begin 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 AIX 4.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...
  • 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). 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 23: Changing The Environment

    Changing the Environment 7. 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: Add /usr/OV/OneVision/bin to your PATH variable. Issue 1 August 1996...
  • Page 24 Installation Issue 1 August 1996...
  • Page 25: 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 IBM NetView documentation for complete instructions for adding a node. Issue 1 August 1996...
  • Page 26: 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 27 Adding DEFINITY G3 PBX Nodes 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. Click on the OneVision icon. Result: The Add Object Pallet window displays the following icons under the heading Symbol Subclasses for Class OneVision: Generic, G3 PBX, and G3 Proxy.
  • Page 28: Configuring A Pbx Object

    Integration 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 29 Adding DEFINITY G3 PBX Nodes 3. Enter the following information: Field 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 30 Integration 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 August 1996...
  • Page 31: Adding Definity G3 Proxy Agent Nodes

    Adding 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 4. Drag the G3 Proxy icon shown at left, onto the map. Result: The system inserts the icon on the map and opens the Add Object window. 5. Verify that the Symbol Type is OneVision:G3 Proxy. 6. In the Label field, enter the name of the Proxy Agent machine on your network.
  • Page 33: Configuring A Proxy Agent Icon

    Adding DEFINITY G3 Proxy Agent Nodes 10. Click OK, located at the bottom of the window. Result: The Add Object Pallet window redisplays. 11. Repeat steps 3 through 9 for each additional Proxy Agent. 12. On the Add Object Pallet window, click OK. Result: The Add Object Pallet window closes and the network map redisplays with the newly added Proxy Agent icon.
  • Page 34 Integration 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. The Selection Name field in step 9 of the previous procedure, Adding Proxy Agent Icons...
  • Page 35 Adding DEFINITY G3 Proxy Agent Nodes The following table is an example of entries made for a typical Proxy Agent. Field What you enter 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...
  • Page 36 Integration Issue 1 August 1996...
  • Page 37: 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 38: Starting With The Mouse

    Starting the Applications 2. At the menu bar on the same map, select Monitor, then select DEFINITY. 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.
  • Page 39: 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 Dyna Text, an application automatically installed by Fault Management. You can open this user guide from the: Network map Shell prompt...
  • Page 40: 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 Dyna Text. The DynaText Tutorial provides instructions for using the Dyna Text online browser.
  • Page 41: 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 Understanding the Alarms, Traps, and Masks Adjusting Polling Intervals for Network Traffic Verifying Connectivity Issue 1 August 1996...
  • Page 42: 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 43: Conditions Causing Change Of State

    States of the DEFINITY G3 Icons NOTE: You can change the default colors for these icon states on the Fault Management Setup screen. (See your online user guide for more information.) For a list of the current icon colors, select Help, then Legend from the NMS window manager.
  • Page 44: 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 45: Conditions Causing Change Of State

    States of the Proxy Agent Icons CAUTION: A Critical state for the Proxy Agent affects PBX maintenance and Lucent Technologies’ ability to support the PBX. Therefore, when a Proxy Agent is in this state, you must contact the TSC immediately. Conditions Causing Change of State...
  • Page 46: 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 47: 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 48: 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 49: 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 50: Troubleshooting Disconnects

    Alarm States 2. Select Monitor from the menu bar, then select DEFINITY. 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.
  • Page 51 Verifying Connectivity Can your NMS access the Proxy Agent? (Telnet to the Proxy Agent to find out.) Is the Proxy Agent running? (Telnet to the Proxy Agent and run g3stat.) If the Proxy Agent is still disconnected from the PBX after you check all of these items, call the System Management Help Line at the Technical Service Center for assistance.
  • Page 52 Alarm States Issue 1 August 1996...
  • Page 53: 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 54: Changing The Polling Interval

    Changing the Polling Interval Changing the Polling Interval You can change the responsiveness of Fault Management 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 55: 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 56: Default Values

    Changing Default Values Default Values When you first open the application resource file, it contains the following defaults: Object Default BackgroundColor Grey66 ForegroundColor Black MajorAlarmColor MinorAlarmColor Orange WarningAlarmColor Yellow HighlightColor Green SelectColor Cyan MenubarColor #729ff MenubarForegroundColor Black AlarmErrorRefresh CircuitPackRefresh AlarmPolling RefreshOnStart TRUE SNMPRetries...
  • Page 57: 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 58: Changing The Mib

    Other Options Changing the MIB The Management Information Base (MIB) contains definitions of managed objects and associated management information. The MIB contains both standard information on all devices and vendor-specific information. Fault Management does not recognize objects that are not defined in the MIB.
  • Page 59: 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 60: 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‘...
  • Page 61: Telnetting To The Proxy Agent

    Telnetting to the Proxy Agent Telnetting to the Proxy Agent To telnet to the Proxy Agent from your NMS: 1. From the main map, select the Proxy Agent icon. 2. Do one of the following: — Double click the Proxy Agent icon. —...
  • Page 62 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 Applications (G3-MA). For this reason, you enter commands and view screens that operate like the G3-MA interface.
  • Page 63: Index

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

Table of Contents