AT&T OneVision DEFINITY G3 Fault Management User Manual
AT&T OneVision DEFINITY G3 Fault Management User Manual

AT&T OneVision DEFINITY G3 Fault Management User Manual

Network management solutions
Hide thumbs Also See for OneVision DEFINITY G3 Fault Management:
Table of Contents

Advertisement

Quick Links

Graphics © AT&T 1988
Table of
Contents
OneVision Network
Management Solutions
DEFINITY
Fault Management
User Guide
Issue 2
CMP 45733
April, 1996
®
G3

Advertisement

Table of Contents
loading

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

  • Page 1 Issue 2 CMP 45733 April, 1996 Table of Contents OneVision Network Management Solutions ® DEFINITY Fault Management User Guide Graphics © AT&T 1988...
  • Page 2: Table Of Contents

    Contents About This Book Intended Audience Associated Documents Conventions Trademarks Security Considerations xiii Reader Comments xiii Credentials xiii Introduction Fault Management Features Configuration Map Fault Manager Configuration Manager System Integration DEFINITY G3 Proxy Agent Your Network Management System Supported PBXs Fault Management’s User Interface Color Alarms Display...
  • Page 3 Contents Management Information Base Data Refresh Startup Refresh 1-10 Configuration Data Refresh 1-11 Bulletin Board Refresh 1-11 Alarms and Errors Data Refresh 1-11 Starting/Stopping Fault Management Starting Fault Management The Startup Screen Start-Up Messages Exit Button The Startup Process Retrieving Data Failing to Retrieve Data Requesting Data Stopping Fault Management...
  • Page 4 Contents The Configuration Map Overview of the Configuration Map Faults Displayed as Colors Screens in the Configuration View Switch View How to Open the Switch View Sample Switch View Menu Bar for Switch View Screen Heading for Switch View Alarms for Switch View Switch View Hotspots Switch View Messages Cabinet View...
  • Page 5 Contents Sample External Devices Screen 4-30 Menu Bar for External Devices 4-32 Screen Heading for External Devices 4-32 Alarms for External Devices 4-32 External Device Hotspots 4-33 External Device Messages 4-33 Individual External Devices 4-33 How to Open Individual External Devices 4-34 Sample Individual External Devices Screen 4-34...
  • Page 6 Contents Sample Bulletin Board 5-14 Menu Bar for the Bulletin Board 5-15 Data Area for the Bulletin Board 5-16 How to Refresh this Screen 5-17 The Configuration Manager Overview of Configuration Manager Types of Configuration Data Hardware/Software Information Report Circuit Pack Inventory Report How to Save Inventory Reports Circuit Pack Reports DS1 Circuit Pack Reports...
  • Page 7 Contents Menu Bar for Report Builder Data Area for Report Builder Button Line Overview for Creating Reports How to Name the Report Guidelines for the Report Name Field How to Select the Table to Search Guidelines for the Table to Search Field How to Display All Alarms 7-10 How to Enter Search Criteria...
  • Page 8 Contents How to Print Reports How to Save Reports Troubleshooting xnmevents Crash (HP OpenView) Switch View Messages Messages Specific to HP OpenView Port Messages Messages Specific to HP OpenView Pop-up Messages Startup Messages Integrating With Remedy 10-1 Action Request System Overview 10-1 HP OpenView 10-1...
  • Page 9: About This Book

    About This Book The purpose of this document is to help private branch exchange (PBX) administrators and managers use DEFINITY G3 Fault Management. This user’s guide provides a description of the screens, fields, access methods, reports, and other features that are part of the application. Intended Audience This guide is intended for DEFINITY G3 and network managers who are managing DEFINITY G3 PBXs as nodes on a network management system...
  • Page 10: Conventions

    About This Book BCS Products Security Handbook (555-025-600) The appropriate maintenance manual for each DEFINITY G3 PBX that you are managing on your NMS. Conventions This guide uses the following text conventions: Text format Type of information Bold Command names and parameters, information you type, and file names italic Emphasized key words...
  • Page 11: Security Considerations

    Security Considerations OneVision and DEFINITY are trademarks or registered trademarks of AT&T Remedy and Action Request System are trademarks of Remedy Corporation SPECTRUM and SpectroSERVER are registered trademarks of Cabletron Systems, Inc. SunOS and SPARC are trademarks or registered trademarks of Sun MicroSystems, Inc.
  • Page 12 About This Book AT&T BCS is also an HP OpenView Solution Partner; and Fault Management is listed in the HP OpenView Solutions catalog. Issue 2 April 1996...
  • Page 13: Introduction

    Introduction This chapter provides an overview of the DEFINITY G3 Fault Management software, and includes: Fault Management Features System Integration Supported PBXs Fault Management’s User Interface Data Refresh This chapter lays the groundwork for subsequent chapters which cover the application in greater detail. Fault Management Features DEFINITY G3 Fault Management (referred to as Fault Management throughout this guide) provides a PBX manager with a graphical tool for monitoring the...
  • Page 14: Configuration Map

    Introduction Configuration Map The configuration map provides a graphical user interface (GUI) that displays information about a DEFINITY G3 PBX managed by your NMS. You display this information by clicking on a pictoral representation of the PBX’s hardware. Each time you click, you peel away the layers of the PBX and uncover more specific data.
  • Page 15: Configuration Manager

    System Integration — The severity of the alarm (major, minor, or warning) Configuration Manager The configuration manager provides, in a graphical and report format, information about your PBX, cabinet, and external device configurations. This information consists of a PBX’s hardware and software versions and an inventory of circuit packs and their locations.
  • Page 16: Supported Pbxs

    Introduction Supported PBXs Fault Management supports the following DEFINITY GENERIC 3 PBXs: G3vs V1.1-ABP/PBP V1.1-ABP/PBP V1.1-286 V1.1 V2-ABP/PBP V2-ABP/PBP V2-386 V3-ABP/PBP V3-ABP/PBP V3 (386) V4-ABP/PBP V4-ABP/PBP V4 (386) Fault Management’s User Interface This section describes the following elements included in the Fault Management’s user interface: Accelerator Keys Hotspots...
  • Page 17: Alarms Display

    Fault Management’s User Interface Alarms Display An alarms display, similar to the one shown below, is located on the right side of any configuration screen. Figure 1-1. Alarms Display Menu Bar Fault Management uses a standard menu bar with the following pull-down menus.
  • Page 18 Introduction NOTE: This guide refers to hotspots in Fault Management, not DynaText . The Fault Management screens and windows that display when you double click on the camera icon in this guide do not have functioning hotspots. However, you can try out the hotspots when you return to the Fault Management application.
  • Page 19: Scroll Bars

    Fault Management’s User Interface Figure 1-2. Cabinet View Scroll Bars Fault Management uses standard scroll bars. The scroll bars appear only when there is more information than can appear in the window, such as more cabinets or more report items. If the window does not include scroll bars, all the relevant information or data is visible in the window.
  • Page 20: Exit Button

    Introduction Exit Button The exit button ends your Fault Management session. This button is available on the Startup and Switch View screens. Accelerator Keys Accelerator keys allow you to use the keyboard to execute a menu command (instead of pointing and clicking with a mouse). Each menu command in Fault Management has one letter underlined.
  • Page 21: Check Boxes

    Management Information Base Check Boxes Check boxes allow you to turn an option on or off. You can turn on as many check boxes as you want. Check boxes look like this: In this example, all the check boxes are turned off. Radio Buttons Radio buttons allow you to select one option from a list of options.
  • Page 22: Startup Refresh

    Introduction has completed refreshing data from the PBX, Fault Management updates the alarm and circuit pack mismatch displays that use the data. This data includes: Alarm data Error data Bulletin board data External devices Cabinet data Trunk group Configuration data Vintage data Fault Management uses the following refresh categories: Startup Refresh...
  • Page 23: Configuration Data Refresh

    Data Refresh 1. Access the Switch View. à 2. Select Options Setup. 3. Change the value in Refresh Proxy Agent On Startup to FALSE. 4. Click Apply. à 5. Select Options Save. For more information about the Setup screen, refer to the Chapter 3, Customizing Fault Management.
  • Page 24 Introduction The alarm and errors refresh interval has passed The alarm poll detected a mismatch between the number of alarms on the NMS and the number of alarms on the Proxy Agent. You request a refresh NOTE: Fault Management updates cabinet information only during the startup refresh process.
  • Page 25 Data Refresh Table 1-1. Field Descriptions for Trap Messages Field Description Heading Information The first line of text, including: The date and time that the Proxy Agent received the trap The name of the node on the NMS Location The location of the alarm that is related to the trap.
  • Page 26 Introduction Figure 1-4. Trap Message for External Devices 1-14 Issue 2 April 1996...
  • Page 27 Data Refresh Table 1-2. Field Descriptions for Trap Messages for External Devices Field Description Heading Information The first line of text, including: The date and time that the Proxy Agent received the trap The name of the node on the NMS Location The location of the alarm that is related to the trap.
  • Page 28 Introduction Figure 1-5. Trap Message for Resolved Alarms Table 1-3. Field Descriptions for Trap Messages for Resolved Alarms Field Description Heading Information The first line of text, including: The date and time that the Proxy Agent received the trap The name of the node on the NMS ALL ALARMS Trap message that indicates all alarms have RESOLVED...
  • Page 29 Data Refresh Detecting a Mismatch Fault Management periodically polls the Proxy Agent for the following MIB objects: healthMajor healthMinor healthWarning snmpOutTraps Mismatches in the application view of the values of these objects results in a refresh. For the MIB-II object snmpOutTraps, Fault Management compares the number of traps in the initial startup poll plus the traps received to the number of traps in subsequent polls.
  • Page 30: Starting/Stopping Fault Management

    Starting/Stopping Fault Management This chapter describes: Starting Fault Management The Startup Screen and its messages The Startup Process (an overview) Stopping Fault Management Starting Fault Management Fault Management is an application hosted by your NMS. Because Fault Management is integrated into your NMS, when you add a DEFINITY PBX as a node on your NMS, the system creates DEFINITY G3 Fault Management as an executable application.
  • Page 31: The Startup Screen

    Starting/Stopping Fault Management Table 2-1. Starting from HP OpenView and IBM NetView Use either of the following methods of starting Fault Management: Method A 1. Highlight a PBX icon. 2. Double click on the DEFINITY icon that represents the PBX for which you want to run Fault Management.
  • Page 32: Start-Up Messages

    The Startup Screen Figure 2-1. The Fault Management Startup Screen Start-Up Messages The Startup screen displays one of the following messages to describe the start-up activity: Refresh in progress, estimated delay nnn seconds, n seconds elapsed. This refresh status message indicates that Fault Management has requested a full data refresh.
  • Page 33: Exit Button

    Starting/Stopping Fault Management Initializing... This message indicates that Fault Management is retrieving data stored by the Proxy Agent instead of getting new data from the PBX. This startup method is quicker, but it retrieves cached data. Exit Button During the startup process, you can click on the Exit button on the startup screen to stop Fault Management from refreshing and initializing.
  • Page 34: Failing To Retrieve Data

    Stopping Fault Management 5. Populates any open cabinet-level displays with the circuit pack information from step 4. 6. Indicates any alarm conditions by highlighting the circuit packs with the highest level severity for each. 7. Adds alarm counts to the alarms box for the circuit pack. NOTE: Other methods of refreshing data are discussed in the Data Refresh section in Chapter 1.
  • Page 35: Customizing Fault Management

    Customizing Fault Management This chapter provides the information you need to customize Fault Management, including: Opening the Setup Screen The Setup Screen Changing Colors Changing Time Intervals Changing Other Options Testing Your Changes Saving Changes Reverting to Default Settings Exiting the Setup Screen Opening the Setup Screen Use the following steps to access the Setup screen: 1.
  • Page 36: Sample Setup Screen

    Customizing Fault Management Colors that indicate: — Alarm conditions — Circuit pack mismatches — Configurations you select for viewing Time intervals for how often Fault Management receives data from the Proxy Agent Startup and retry indicators The field delimiter for reports in ASCII format These settings apply to all PBX’s on your NMS.
  • Page 37: Menu Bar

    The Setup Screen Figure 3-1. Fault Management Setup Screen Menu Bar The following table explains the menu bar for the Setup screen: Table 3-1. Commands for the Options Menu Command Description Apply Applies the screen settings only to the current session. Defaults Resets all fields settings to their default values.
  • Page 38: Changing Colors

    Customizing Fault Management Changing Colors The Setup screen allows you to change the color settings for: Alarm conditions Circuit pack information on the configuration map You can: Select any color available to your monitor. Specify a hexadecimal RGB color value. Select a gray-scale instead of colors.
  • Page 39: Changing Time Intervals

    Changing Time Intervals Table 3-4. Procedure for Changing Grey Scale Settings Use the following steps to change the default settings for grey scale: à 1. Select Options Grey Scale. 2. Enter the following in each of the color fields that you want to change: greyxx xx = the percentage of grey.
  • Page 40 Customizing Fault Management Double click on a table icon for more information: Table 3-5. Time Interval Fields on the Setup Screen Field Default Valid Range Description Alarm and 60 minutes 5 to 1500 The time interval between Error Refresh minutes data refreshes for PBX alarms Interval and errors.
  • Page 41: Changing Other Options

    Changing Other Options Changing Other Options The Setup screen allows you to change the options for: Refreshing the Proxy Agent at startup The number of retries on an SNMP time-out The field delimiter for reports that you print in ASCII format Double click on a table icon for more information: Table 3-7.
  • Page 42: Testing Your Changes

    Customizing Fault Management Table 3-8. Procedure for Changing Other Options Use the following steps to change the default settings for the other options on the Setup screen: To do this … Enter this … In this field … Initialize Fault Management FALSE Refresh Proxy using cache data...
  • Page 43: Reverting To Default Settings

    Reverting to Default Settings The Apply button in the lower left corner of the screen The Options menu à 2. Select Options Save. Result: Fault Management saves your changes in a resource file and uses them in future startups (from any terminal and for every node). Reverting to Default Settings Fault Management has default settings for all of the options you can customize.
  • Page 44: The Configuration Map

    The Configuration Map This chapter describes the configuration map and the methods used to represent your DEFINITY G3 PBX. Understanding the topics in this chapter can help you locate the fault information you need. Topics include: Overview of the Configuration Map Switch View Cabinet View Circuit Pack Information...
  • Page 45: Faults Displayed As Colors

    The Configuration Map Faults Displayed as Colors Fault Management shows the severity of alarm conditions with color highlighting or grey-scale settings. (This manual uses the term color to refer to both of these settings.) However, within the context of the configuration manager, the color indicators are specific to the level you are viewing.
  • Page 46: Switch View

    Switch View Switch View The Switch View contains a graphical depiction of all the cabinets and external devices on the PBX. When you click on an icon, information about the hardware’s status and configuration displays. NOTE: The icon for external devices only displays if an external device is administered on the PBX.
  • Page 47: Menu Bar For Switch View

    The Configuration Map Figure 4-2. Switch View Menu Bar for Switch View Double click on an icon for information about the menu commands for the Switch View. Table 4-1. Options Commands Command Description Setup Allows you to modify certain default settings. Report Builder Allows you to create ad-hoc reports.
  • Page 48 Switch View Table 4-2. Fault Commands Command Description All Alarms Displays all active alarms on the PBX. Switch Level Alarms Displays active alarms that are not related to a specific cabinet. All Errors Displays all errors associated with active alarms. Switch Level Errors Displays errors for active alarms that are not related to a specific cabinet.
  • Page 49: Screen Heading For Switch View

    The Configuration Map Screen Heading for Switch View Immediately below the menu bar, the Switch View displays general information about the PBX. Double click on the icon for more information: Table 4-4. Screen Heading Data Description Application DEFINITY G3 Fault Management Name Switch Name The name of the PBX as it appears on the NMS when the...
  • Page 50: Switch View Hotspots

    Switch View Switch View Hotspots The central portion of the Switch View contains hotspots in the form of icons that represent external devices and cabinets. Each cabinet icon represents a particular cabinet on the PBX and depicts the type of cabinet. If you click on this icon …...
  • Page 51: Switch View Messages

    The Configuration Map Switch View Messages The message area at the bottom of the Switch View displays the following types of messages: Message Type Description Warning A warning message only displays when the data that Fault Management displays is based on non-refreshed, cached data.
  • Page 52: Menu Bar For The Cabinet View

    Cabinet View Figure 4-3. Cabinet View Menu Bar for the Cabinet View Double click on an icon for information about the menu commands for the Cabinet View. Table 4-5. Options Commands Command Description Report Builder Allows you to create ad-hoc reports. Clear Highlighting Removes highlighting.
  • Page 53: Graphic Display Area

    The Configuration Map Table 4-6. Fault Commands Command Description All Alarms for Cabinet # Displays all active alarms on the cabinet. Cabinet Level Alarms Displays active alarms on the cabinet that are not for Cabinet # related to a specific circuit pack. All Errors for Cabinet # Displays all errors for the alarms on the cabinet.
  • Page 54: Cabinet Data Area

    Cabinet View Blank slots for slots that do not contain a circuit pack. Cabinet Hotspots Cabinet hotspots are icons of the different circuit packs. When you click on a circuit pack hotspot, Fault Management: Opens the corresponding circuit pack view Highlights the selected circuit pack on the cabinet level display Displays a message in the lower right corner of the screen that identifies the highlighting and color being used...
  • Page 55 The Configuration Map Table 4-8. Screen Heading Field Description Application DEFINITY G3 FM Name Switch Name The name of the PBX as it appears on the NMS when the PBX is administered as a node on the network. This information is passed from the NMS. Cabinet Number The number of the current cabinet.
  • Page 56 Cabinet View Table 4-10. Configuration Data Data Area Field Description CABINET This area of the screen includes details DESCRIPTION about the current cabinet. CABINET The cabinet number. CABINET The type of cabinet layout: LAYOUT five-carrier single-carrier-stack enhanced-single-carrier-stack small very-small CABINET TYPE The type of cabinet: processor expansion-port-network...
  • Page 57: Cabinet Messages

    The Configuration Map Cabinet Messages The message areas on the Cabinet View display the following types of messages: Message Type Location Description Incomplete Above CABINET This warning message displays only if Data Warning DESCRIPTION you clicked on a cabinet hotspot on the information.
  • Page 58: Sample Circuit Pack Information Screens

    Circuit Pack Information Sample Circuit Pack Information Screens Double click on one of the following icons for a sample screen: Figure 4-4. Circuit Pack Information Screen 4-15 Issue 2 April 1996...
  • Page 59 The Configuration Map Figure 4-5. Circuit Pack Information Screen Showing a Conflict 4-16 Issue 2 April 1996...
  • Page 60: Menu Bar For Circuit Pack Information

    Circuit Pack Information Menu Bar for Circuit Pack Information Double click on the icon for a description of the menu bar for the Circuit Pack Information screen: Table 4-11. Menu Commands Menu Command Description Options Close Closes the Circuit Pack Information screen and any open child windows.
  • Page 61 The Configuration Map Double click on the icon for a description of these areas. Table 4-12. Screen Heading Field Description Application DEFINITY G3 FM Name Screen Title Circuit Pack Information Switch Name The name of the PBX as it appears on the NMS when the PBX is administered as a node on the network.
  • Page 62 Circuit Pack Information Table 4-14. Configuration Data Data Area Field Description Circuit Pack LOCATION The circuit pack’s cabinet, carrier, and slot. Data TYPE The type of circuit pack. A few examples are: Analog line BRI line Data line Digital line DS1 interface CODE The product code of the circuit pack.
  • Page 63: Circuit Pack Hotspots

    The Configuration Map Circuit Pack Hotspots Each port number listed under Assigned Ports is a hotspot which opens the port level view for that specific port. See Hotspots in Chapter 1 for an overview of hotspots. Port Information The Port Information screen contains data for a single port. The data that displays varies, depending on the type of equipment in the port.
  • Page 64 Port Information Figure 4-6. Port Information: Pooled Modem 4-21 Issue 2 April 1996...
  • Page 65 The Configuration Map Figure 4-7. Port Information: Station 4-22 Issue 2 April 1996...
  • Page 66 Port Information Figure 4-8. Port Information: Data Module 4-23 Issue 2 April 1996...
  • Page 67: Menu Bar For Port Information

    The Configuration Map Figure 4-9. Port Information: Trunk Menu Bar for Port Information The menu bar for the Port Information screen contains the following commands: Menu Command Description Options Close Closes the Port Information screen and any open child windows. Fault All Alarms Displays all active alarms for the port specified.
  • Page 68: Data Area For Port Information

    Port Information Data Area for Port Information The Port Information screen contains the following data areas: Screen heading Alarms Configuration data — Port data — Equipment type Double click on the icon for a description of these data areas. Table 4-15. Screen Heading Field Description Application Name...
  • Page 69 The Configuration Map Table 4-17. Port Data Field Description PORT LOCATION The port’s cabinet, carrier, slot, and port. Example: 01C2004 01 = Cabinet C = Carrier 20 = Slot 04 = Port CIRCUIT PACK TYPE The type of circuit pack the port is on. EQUIPMENT TYPE The equipment attached to the port.
  • Page 70 Port Information Table 4-18. Equipment Type: Station Display Area Field Description Station Extension The extension number for the station. Information Station Type The type of station. Name The station’s name, as administered on the PBX. Building The building where the station is located, as administered on the PBX.
  • Page 71 The Configuration Map Table 4-18. Equipment Type: Station Display Area Field Description Station Data Data The extension number for the data module. Module Extension Information Data Name The name of the data module, as administered on the PBX. Data Service The current service state of the data State module.
  • Page 72: Port Hotspots

    Port Information Table 4-20. Equipment Type: Trunk Display Area Field Description Trunk Group Group Type The type of trunk group. Information Group Name The group name, as administered on the PBX. Direction The trunk direction. For example, a 2-way direction has incoming and outgoing calls.
  • Page 73: External Devices

    The Configuration Map External Devices An external device can be anything that is connected to a PBX. Examples of an external device are a thermostat and a voice mail system. The External Devices View displays icons for all the administered external devices on a DEFINITY G3 PBX.
  • Page 74 External Devices Figure 4-10. External Devices View 4-31 Issue 2 April 1996...
  • Page 75: Menu Bar For External Devices

    The Configuration Map Menu Bar for External Devices Double click on the following icon for information about the menu commands for the External Devices View: Table 4-21. Menu Commands Menu Command Description Options Report Builder Allows you to create ad-hoc reports. Clear Highlight Clears any highlighting.
  • Page 76: External Device Hotspots

    Individual External Devices External Device Hotspots The central portion of the External Devices View contains hotspots in the form of icons that represent external devices. See Hotspots in Chapter 1 for an overview of hotspots. Colored Borders Each icon is surrounded by a border that is highlighted with the color that represents the highest level of alarm.
  • Page 77: How To Open Individual External Devices

    The Configuration Map Data Area for Individual External Device How to Open Individual External Devices To open the Individual External Devices screen: 1. Display the External Devices screen. 2. Click on an external device icon. Sample Individual External Devices Screen The following figure shows an Individual External Device screen for a voice mail system: Figure 4-11.
  • Page 78: Menu Bar For Individual External Device

    Individual External Devices Menu Bar for Individual External Device Double click on the following icon for information about the menu commands for the Individual External Device screen: Table 4-23. Menu Commands Menu Command Description Options Close Closes this view and any open child windows.
  • Page 79 The Configuration Map Table 4-25. Alarms The color-coded alarms on the right side of the screen display the number of major, minor, and warning alarms for the external device. Table 4-26. Configuration Data Field Description Port Location The name of the port that connects the external device. Administered The type of alarm that the PBX generates for an active Alarm Type...
  • Page 80: The Fault Manager

    The Fault Manager This chapter describes the Fault Manager feature that helps you locate and recognize faults within your DEFINITY G3 PBX. Topics include: Overview of Fault Manager When Fault Manager Receives Data How Fault Manager Displays Faults How to Print Reports How to Close Report Windows How to Get More Report Information Error Description Screen...
  • Page 81: When Fault Manager Receives Data

    The Fault Manager When Fault Manager Receives Data Fault Manager receives PBX data from Fault Management during the following events: At start-up (when Fault Management is first invoked from the NMS) During the normal data refresh (refresh and polling intervals) At a user's request Upon receipt of a trap NOTE:...
  • Page 82: Alarms Reports

    How Fault Manager Displays Faults Alarms Reports Alarms reports display alarm data about faults on the PBX. They are specific to the hardware layer currently displayed on your screen and provide the following information for that layer: What faults exist Which hardware is affected The Fault menu allows you to select a report that displays alarms for: All the alarms for the hardware layer that is currently displayed...
  • Page 83 The Fault Manager Table 5-1. Types of Alarms Reports Screen Fault Menu Command Report Description Port All Alarms for Port # All active alarms for the port Information External All External Device All active alarms for all external Devices Alarms devices that are connected to the View Individual...
  • Page 84 How Fault Manager Displays Faults Table 5-2. Field Descriptions for Alarms Reports Field Description # Alarms Found The number of active alarms Port The alphanumeric ID (location) of the alarmed object. Zeros in this field indicate the alarmed object is not connected to a port (for example, a system printer.) Data for this report is sorted by port ID number.
  • Page 85: Error Reports

    The Fault Manager Table 5-2. Field Descriptions for Alarms Reports Field Description Svc State The current service state of the station and trunk port: RDY = ready for service OUT = out of service IN = in service Blank = there is no service state associated with the port Ack? Indicates whether INADS has acknowledged the...
  • Page 86 How Fault Manager Displays Faults NOTE: These reports show error data that is current at the time you request the report. Fault Management does not update the data while the report window remains open. To ensure that the data is up to date, close and then re-open any open report window.
  • Page 87 The Fault Manager Figure 5-2. Error Report for All Errors for a Cabinet Table 5-4. Field Descriptions for Error Reports Field Description Errors Found The number of errors related to active alarms at that Ievel Port The alphanumeric ID (location) of the alarmed object. Zeros in this field indicate the alarmed object is not connected to a port (for example, a system printer.) Mtce Name...
  • Page 88 How Fault Manager Displays Faults Table 5-4. Field Descriptions for Error Reports Field Description Alt Name Another way to identify the maintenance object. If the object is a station, this field contains the extension number. If the object is a trunk, this field contains xxx/yyy, where: —...
  • Page 89: How To Open Report Windows

    The Fault Manager Table 5-4. Field Descriptions for Error Reports Field Description Rt/Hr Rate per Hour. An approximate rate that this error occurred in the last hour. 255 is the maximum number allowable. If 255 displays in this field the actual error count may be higher. Alarm Status The status of the maintenance object in the error and alarm reports.
  • Page 90: How To Print Reports

    How to Print Reports How to Print Reports To print an alarms or error report, see How to Display Reports. How to Close Report Windows To close the report window, click on Close. How to Get More Report Information Use the following table to get more information about a report entry that is listed in a report window: And click Open this...
  • Page 91: How To Open Error Descriptions

    The Fault Manager The Error Description Screen has the following components: Menu Bar for Error Descriptions Screen Heading for Error Descriptions Error Description Panel Notes Panel How to Open Error Descriptions To open the Error Description screen: 1. Display an error report window. 2.
  • Page 92: Menu Bar For Error Descriptions

    Error Description Screen Menu Bar for Error Descriptions Double click on the following icon for information about the menu commands for the Error Description screen: Table 5-5. Menu Commands Menu Command Description Options Save Saves your entry for the Notes panel. Close Closes the Error Description screen.
  • Page 93: Bulletin Board

    The Fault Manager The Notes panel accepts all characters except the pipe (I). Click on Save to save your note. If you edit your note, be sure to click on Save to save your changes. How to Delete a Note To delete a note: 1.
  • Page 94: Menu Bar For The Bulletin Board

    Bulletin Board Figure 5-4. Bulletin Board Menu Bar for the Bulletin Board Double click on the following icon for information about the menu commands for the bulletin board: Table 5-7. Menu Commands Menu Command Description Options Save Report Opens a window so you can save the data to a file.
  • Page 95: Data Area For The Bulletin Board

    The Fault Manager Data Area for the Bulletin Board The bulletin board has the following data areas: Screen heading Bulletin board message Message area Double click on an icon for more information: Table 5-8. Screen Heading Data Description Application Name DEFINITY G3 Fault Management Report Name Bulletin Board...
  • Page 96: How To Refresh This Screen

    Bulletin Board How to Refresh this Screen Fault Management automatically refreshes bulletin board information upon startup if the Refresh Proxy Agent on Startup field on the Setup screen is set to TRUE. You can also refresh the bulletin board anytime during a Fault Management session as follows.
  • Page 97: The Configuration Manager

    The Configuration Manager This chapter describes the configuration manager for Fault Management. Topics include: Overview of Configuration Manager Hardware/Software Information Report Circuit Pack Inventory Report Circuit Pack Reports DS1 Circuit Pack Reports How to Open Configuration Reports How to Print Configuration Reports How to Close Configuration Reports Cabinet Displays How to Refresh Configuration Data...
  • Page 98: Types Of Configuration Data

    The Configuration Manager Types of Configuration Data The configuration manager provides the following data: Screen Type of Data Switch View Online configuration reports for: Hardware/Software Information Circuit Pack Inventory All Circuit Packs Exception Circuit Packs DS1 Circuit Packs Cabinet View Graphical displays of the circuit packs that match your selection criteria.
  • Page 99 Hardware/Software Information Report Figure 6-1. Hardware/Software Information Report Table 6-1. Menu Commands Menu Command Description Options Save Report Opens a window so you can save the data to a file. Close Closes the report window. Help Displays a Help window. Table 6-2.
  • Page 100: Circuit Pack Inventory Report

    The Configuration Manager Table 6-3. Field Descriptions for the Hardware/Software Information Report Field Description Hardware The PBX’s hardware configuration, taken from Configuration from the Proxy Agent. the Proxy Agent This value and the Hardware Configuration field value should be the same. Hardware The PBX’s hardware configuration, taken from Configuration from...
  • Page 101 Circuit Pack Inventory Report 3. Vintage Double click on an icon for more information. Figure 6-2. Circuit Pack Inventory Report Table 6-4. Menu Commands Menu Command Description Options Save Report Opens a window so you can save the data to a file. Close Closes the report window.
  • Page 102: How To Save Inventory Reports

    The Configuration Manager Table 6-5. Report Heading Data Description # Circuit The total number of circuit packs and the total number of Packs of # types of circuit packs Types Application DEFINITY G3 Fault Management Name Report Title Circuit Pack Inventory Switch Name The name of the PBX as it appears on the NMS when the PBX is administered as a node on the network.
  • Page 103: Circuit Pack Reports

    Circuit Pack Reports Circuit Pack Reports Circuit pack reports display the circuit packs that are administered by the PBX or that are physically present in the PBX. This report … Contains data for … All Circuit Packs All circuit packs on the PBX Exception Circuit Packs Circuit pack mismatches and the no-board condition (circuit packs that are missing)
  • Page 104 The Configuration Manager Table 6-7. Menu Commands Menu Command Description Options Output Options Opens the Output Options screen. Close Closes the report window. Help Displays a Help window. Table 6-8. Screen Heading for Circuit Pack Reports Field Description Application Name DEFINITY G3 Fault Management Report Title The name of the report, depending on your menu...
  • Page 105: Ds1 Circuit Pack Reports

    DS1 Circuit Pack Reports Table 6-9. Field Descriptions for Circuit Pack Reports Field Description Location The circuit pack’s cabinet, carrier, and slot. Click on this field to display more information. Code The product code for the circuit pack. Suffix The suffix of the circuit pack. Vintage One of the following: The vintage of the circuit pack.
  • Page 106 The Configuration Manager Figure 6-4. DS1 Circuit Pack Report Table 6-10. Screen Heading for DS1 Circuit Pack Reports Field Description Application Name DEFINITY G3 Fault Management Report Title DS1 Circuit Packs Switch Name The name of the PBX as it appears on the NMS when the PBX is administered as a node on the network.
  • Page 107: How To Open Configuration Reports

    How to Open Configuration Reports Table 6-11. Field Descriptions for DS1 Circuit Pack Reports Field Description Location The circuit pack’s cabinet, carrier, and slot. Click on this field to display more information. Code The product code for the circuit pack. Suffix The suffix of the circuit pack.
  • Page 108: How To Close Configuration Reports

    The Configuration Manager How to Close Configuration Reports To close a report, click on Close. Cabinet Displays The configuration manager displays a graphic depiction of the circuit packs within the cabinet. When you select a filter from the Configuration menu, Fault Management highlights the circuit packs that meet the filter criteria.
  • Page 109: How To Identify Circuit Pack Configurations

    Cabinet Displays the filter being used. This message is enclosed in a box colored the same as the highlighted circuit packs. Figure 6-5. Highlighting on the Cabinet Display How to Identify Circuit Pack Configurations Use the configuration filter to identify specific types of circuit packs, as follows: 1.
  • Page 110: How To Clear Filter Highlighting

    The Configuration Manager How to Clear Filter Highlighting The system leaves the filter in place until you close the window or until you manually clear the highlighting. à To clear the filter highlighting select Configuration Clear Highlighting. How to Refresh Configuration Data If you specified a refresh time on the Setup screen, the system automatically refreshes the configuration data when the refresh timer expires.
  • Page 111: Report Builder

    Report Builder This chapter describes the Report Builder feature. Topics include: Overview for Report Builder Report Builder Screen Overview for Creating Reports How to Name the Report How to Select the Table to Search How to Enter Search Criteria How to Format the Report How to Sort Report Data How to Save Report Specifications How to Run the Report...
  • Page 112: Types Of Tables

    Report Builder Select up to three sorting keys Sort the report in ascending or descending order for each sorting key Send the report to the hard drive, the screen, or a printer Highlight objects on views Types of Tables You can query the following Fault Management tables: Alarms Circuit Packs DS1 Circuit Packs...
  • Page 113: Report Builder Screen

    Report Builder Screen NOTE: These reports show data that is current at the time you request the report. Fault Management does not update the data while the report window remains open. To ensure that the data is up to date, close and then re-open any open report window.
  • Page 114 Report Builder Figure 7-1. Report Builder Screen Issue 2 April 1996...
  • Page 115: Menu Bar For Report Builder

    Report Builder Screen Menu Bar for Report Builder Double click on the icon for a description of the menu bar for the Report Builder screen: Table 7-1. Menu Commands Menu Command Description Options Run Report Produces the report based on the entries you make in the fields.
  • Page 116 Report Builder Table 7-3. Field Entry Area Field Description Report Name The name of the report. You can enter up to 55 characters, or you can select an existing report from the pull-down list. Table to Search The name of the table that you want to search. You must select one of the following values from the pull-down list: Alarms (default) Circuit Packs...
  • Page 117 Report Builder Screen Table 7-3. Field Entry Area To Value One of the following: If you set the Comparison field to Equal, then you cannot enter data into this field. If you set the Comparison field to Range, then Fault Management retrieves all data that fall in the range created by this entry and the entry in the Value field.
  • Page 118: Button Line

    Report Builder Button Line The button line at the bottom of the screen allows you to complete the following commands. Button Description Run Report Produces the report based on the entries you make in the fields. Save Report Saves the report specifications to your hard Specs drive.
  • Page 119: How To Name The Report

    How to Name the Report How to Name the Report You name the report in the Query Name field on the Report Builder screen. Then the name you enter If you do this … becomes the … Save the report specifications to Key for subsequent file your hard drive retrieval...
  • Page 120: How To Display All Alarms

    Report Builder You select a table from the pull-down list associated with this field. Your selection determines the values in the pull-down list for the Field Name field. If you change the contents of the Table to Search field, Fault Management initializes the Field Name field and its associated fields so you can select new search criteria.
  • Page 121: How To Search For An Exact Match

    How to Enter Search Criteria Your entry in the Table to Search field determines your choices in the Field Name field. How to Search for an Exact Match You can search for an exact match for up to three fields in any table. To search for an exact match: 1.
  • Page 122 Report Builder Table 7-5. An Exact Match with Two Variables Exact match when both variables are true This example shows how to find all digital-line circuit packs that had an alarm on September 27 at 4:30 P.M. Comments: Each instance of Field Name is different (Maintenance Name and Date Alarmed.) Report Builder searches for Maintenance Name = DIG-LINE and Date alarmed = 09/27/16:30.
  • Page 123: How To Search For A Range

    How to Enter Search Criteria How to Search for a Range You can search for a range of values for up to three fields in any table. You search for a range by entering data into the following fields: Field What you enter Table to Search The name of the table in the database...
  • Page 124 Report Builder Table 7-7. Range Without a Lower Limit Range without a lower limit This example shows how to find all ports that reported errors before 6 P.M. on November 10. Table 7-8. A Range Without an Upper Limit Range without an upper limit This example shows how to find all alarms that are more than one day old.
  • Page 125: How To Search For A Partial Match

    How to Format the Report Table 7-9. A Range and Exact Match Combination Range combined with an exact match with two variables This example shows how you can combine the types of matches. Comments: Both instances of Field Name are the same (Maintenance Name.) Report Builder searches for —...
  • Page 126: Guidelines For The Table To Output Field

    Report Builder Errors To see this format … Click here … Alarms Figure 5-1 Circuit Pack Figure 6-3 DS1 Circuit Pack Figure 6-4 Errors Figure 5-2 You select this format in the Table to Output field. Guidelines for the Table to Output Field Use the following guidelines for this field: The Table to Output field is a required field.
  • Page 127: How To Save Report Specifications

    How to Save Report Specifications Each sort field has a pull-down list with valid values for you to select. You can enter up to three sets of sort criterion for each report. For each sort field, you can choose either ascending or descending order. Leave these fields blank If you do not want to sort the data.
  • Page 128: Output Options

    Output Options This chapter describes how to use the Output Options feature. Topics include: Overview for Output Options Output Options Screen How to Display Reports Overview for Output Options Output Options allow you to enter the parameters for the reports that: You created on the Report Builder screen.
  • Page 129: How To Open Output Options

    Output Options Sample Output Options Screen Menu Bar for Output Options Data Area for Output Options Output Options Messages Button Line for Output Options How to Open Output Options You can open the Output Options screen as follows: If this is open … Then to open Output Options …...
  • Page 130: Menu Bar For Output Options

    Output Options Screen Figure 8-1. Output Options Screen Menu Bar for Output Options Double click on the icon for a description of the menu bar for the Output Options screen: Table 8-1. Menu Commands Menu Command Description Options Apply If you opened the Output Option screen from: The Report Builder, Apply saves the current information and closes the screen.
  • Page 131: Data Area For Output Options

    Output Options Data Area for Output Options The Output Options screen contains the following data areas: Screen heading Field entry Double click on an icon for a description of these areas: Table 8-2. Screen Heading Field Description Application DEFINITY G3 Fault Management Name Screen Title Output Options for (the screen that was active when you...
  • Page 132 Output Options Screen Table 8-3. Field Entry Area Field Description Output to Sends the report to the screen. By default, this check box Screen is turned on. Highlight Highlights the following report objects: Objects Cabinet Circuit pack Output to Printer Sends the report to the printer.
  • Page 133: Output Options Messages

    Output Options Table 8-3. Field Entry Area Append Allows you to append the report to an existing file. The default is OFF. Delimiter Specifies the field delimiter for an ASCII file. The default is | (pipe.) This field is required if you selected ASCII as the report format.
  • Page 134: Button Line For Output Options

    How to Display Reports Button Line for Output Options The button line at the bottom of the screen allows you to complete the following commands. Button Description Apply Generates the report based on the entries you make in the fields. Close Closes the Output Option screen without saving your entries.
  • Page 135: How To Save Reports

    Output Options If no, go to step 3. 3. Do you want to change the page length? (The default is 66 lines.) If yes, enter the desired number of lines in the Page Length field. If no, go to step 4. 4.
  • Page 136 How to Save Reports Result: Fault Management does one of the following: Creates a new file with the file name that you specified Overwrites an existing file with the current report data Appends the current report data to an existing file Issue 2 April 1996...
  • Page 137: Troubleshooting

    Troubleshooting This chapter helps you troubleshoot problems you may have with Fault Management. It describes the following items, and then suggests corrective actions. Potential problems for specific platforms Error messages Informational messages Warnings Sometimes, a message or a warning only pertains to a specific platform. These topics are discussed at the end of the appropriate section.
  • Page 138: Switch View Messages

    Troubleshooting Description: This problem only occurs with HP OpenView 3.3 on the Sun SPARC platform. The "xnmevents" process monitors SNMP events and updates the icon status. This process can crash when you have two or more map files with different sets of DEFINITY icons on them. When the map is up and OpenView receives an SNMP trap to update the status of a DEFINITY icon that is not on the current map, OpenView attempts to bring up a warning pop-up window.
  • Page 139 Switch View Messages 3. Set the refresh on startup option to TRUE. This will cause the application to request the Proxy Agent to refresh all of its cached data. 4. Restart the ap plication. ERROR: Circuit Pack Refresh failed. Description: The circuit pack refresh has failed. Action: Try the following procedure.
  • Page 140 Troubleshooting Action: Try the following procedure. 1. Check to see whether the connection between the Proxy Agent and the PBX is up, and that the Proxy Agent is running and communicating with the NMS. 2. Make sure that the PBX is in the Proxy Agent’s clients screen. 3.
  • Page 141: Messages Specific To Hp Openview

    Switch View Messages Check the following common causes for a disconnect: Can the Proxy Agent dial out? — Is the modem working? — Is the phone line connected? Do you get a dial tone? Does the Proxy Agent have a current, correct login and password for the DEFINITY PBX? You can check the login and password on the Proxy Agent Communications form.
  • Page 142: Port Messages

    Troubleshooting Port Messages The following error messages appear in the message area on the Port Information screen. Message: Please Try Later. Description: You requested the port data while another data request (such as an initial data request, a refresh request, or another port request) was already in progress.
  • Page 143: Pop-Up Messages

    Pop-up Messages Pop-up Messages The following messages display in pop-up message boxes. WARNING: The startup refresh failed. The data displayed is based on the data cached on the Proxy Agent. This data may be out of sync with the actual switch data. The most likely cause of this problem is the connection between the Proxy Agent and the DEFINITY G3 PBX being down or turned off.
  • Page 144 Troubleshooting 1. Check to see whether the connection between the Proxy Agent and the PBX is up, and that the Proxy Agent is running and communicating with the NMS. 2. Make sure that the PBX is in the Proxy Agent’s clients screen. 3.
  • Page 145: Startup Messages

    Startup Messages Action: Try the following procedure. 1. Check to see whether the connection between the Proxy Agent and the PBX is up, and that the Proxy Agent is running and communicating with the NMS. 2. Make sure that the PBX is in the Proxy Agent’s clients screen. 3.
  • Page 146 Troubleshooting Action: Do the following: 1. Re-establish the connection to the Proxy Agent. 2. Do one of the following, as required: Restart Fault Management. Refresh the alarms and errors data and the configuration data. Check the following common causes for a disconnect: Can the Proxy Agent dial out? —...
  • Page 147: Integrating With Remedy

    Integrating With Remedy This chapter explains how to integrate DEFINITY G3 trouble tickets into the Remedy Action Request System . Topics include: Action Request System Overview Integrating with HP OpenView Integrating with Cabletron SPECTRUM Action Request System Overview The Action Request System (AR System) uses a database that allows you to collect, and then track your trouble tickets.
  • Page 148: Create A Schema

    Integrating With Remedy To set up the shell script, complete the following procedures in the sequence shown: Create a Schema Create a Macro Test the Macro Test the Script NOTE: See your Remedy documentation if you need help completing these procedures.
  • Page 149: Test The Macro

    Cabletron SPECTRUM Test the Macro Test the macro by entering the following at the command line: aruser -e [macro-name] -p [parm=xxx] -p [parm=yyy] -p [parm=zzz] Hint: The values in brackets are variables that you provide. The string, parm, is the substitution parameter ($parm$) that you defined when you created the macro.
  • Page 150 Integrating With Remedy For information about SPECTRUM ARS Gateway, contact your Cabletron representative. 10-4 Issue 2 April 1996...
  • Page 151: Quick Reference For Screens

    Quick Reference for Screens The configuration map provides you with the means of moving through the graphical displays of a PBX. This chapter summarizes the steps to view these displays. General Comments Some general comments about graphical displays are: The Startup screen is the first screen that displays when you invoke Fault Management from an NMS.
  • Page 152 Quick Reference for Screens And you want to Then click Or Select this If you are here … open this screen … on this … from the menu bar … Cabinet View Circuit Pack A circuit pack Information label à Report Builder Options Report...
  • Page 153 Index Hotspots NMS. See Network management system Keyboard Accelerator keys Alarms active Meta key Cabinet hardware layer Cached data Child window Circuit pack Network management system (NMS) hardware layer Node Commands Configuration menu cabinet 4-10 Options menu Configuration manager overview Port Configuration map hardware layer...

Table of Contents