AT&T OneVision DEFINITY G3 Fault Management and integration, User Manual

Page 1: ...Issue 2 CMP 45733 April 1996 OneVision Network Management Solutions DEFINITY G3 Fault Management User Guide Graphics AT T 1988 Table of Contents ...

Page 2: ...1 1 Configuration Map 1 2 Fault Manager 1 2 Configuration Manager 1 3 System Integration 1 3 DEFINITY G3 Proxy Agent 1 3 Your Network Management System 1 3 Supported PBXs 1 4 Fault Management s User Interface 1 4 Color 1 4 Alarms Display 1 5 Menu Bar 1 5 Hotspots 1 5 Scroll Bars 1 7 Close Button 1 7 Exit Button 1 8 Accelerator Keys 1 8 How to Enter Data 1 8 Data Typed into Fields 1 8 Pull down Lis...

Page 3: ...up Screen 2 2 Start Up Messages 2 3 Exit Button 2 4 The Startup Process 2 4 Retrieving Data 2 4 Failing to Retrieve Data 2 5 Requesting Data 2 5 Stopping Fault Management 2 5 3 Customizing Fault Management 3 1 Opening the Setup Screen 3 1 The Setup Screen 3 1 Sample Setup Screen 3 2 Menu Bar 3 3 Changing Colors 3 4 Changing Time Intervals 3 5 Changing Other Options 3 7 Testing Your Changes 3 8 Sav...

Page 4: ...w 4 8 Sample Cabinet View 4 8 Menu Bar for the Cabinet View 4 9 Graphic Display Area 4 10 Cabinet Data Area 4 11 Cabinet Messages 4 14 Circuit Pack Information 4 14 How to Open Circuit Pack Information 4 14 Sample Circuit Pack Information Screens 4 15 Menu Bar for Circuit Pack Information 4 17 Data Area for Circuit Pack Information 4 17 Circuit Pack Hotspots 4 20 Port Information 4 20 How to Open ...

Page 5: ...ternal Device 4 35 5 The Fault Manager 5 1 Overview of Fault Manager 5 1 When Fault Manager Receives Data 5 2 How Fault Manager Displays Faults 5 2 Color Highlighting 5 2 Alarms 5 2 Alarms Reports 5 3 Error Reports 5 6 How to open Report Windows 5 10 How to Print Reports 5 11 How to Close Report Windows 5 11 How to Get More Report Information 5 11 Error Description Screen 5 11 How to Open Error De...

Page 6: ...6 6 Circuit Pack Reports 6 7 DS1 Circuit Pack Reports 6 9 How to Open Configuration Reports 6 11 How to Print Configuration Reports 6 11 How to Close Configuration Reports 6 12 Cabinet Displays 6 12 Circuit Pack Filters 6 12 How to Identify Circuit Pack Configurations 6 13 How to Clear Filter Highlighting 6 14 How to Refresh Configuration Data 6 14 Scheduled Refresh 6 14 7 Report Builder 7 1 Overv...

Page 7: ... 7 11 How to Search for a Range 7 13 How to Search for a Partial Match 7 15 How to Format the Report 7 15 Guidelines for the Table to Output Field 7 16 How to Sort Report Data 7 16 Guidelines for the Sort Fields 7 16 How to Save Report Specifications 7 17 How to Run the Report 7 17 How to Change the Report 7 17 8 Output Options 8 1 Overview for Output Options 8 1 Output Options Screen 8 1 How to O...

Page 8: ...fic to HP OpenView 9 5 Port Messages 9 6 Messages Specific to HP OpenView 9 6 Pop up Messages 9 7 Startup Messages 9 9 10 Integrating With Remedy 10 1 Action Request System Overview 10 1 HP OpenView 10 1 Create a Schema 10 2 Create a Macro 10 2 Test the Macro 10 3 Test the Script 10 3 Cabletron SPECTRUM 10 3 11 Quick Reference for Screens 5 General Comments 5 IN Index IN 1 ...

Page 9: ...d with the health of a PBX That person may be responsible for the PBX the NMS or both Associated Documents Documents associated with this online guide are OneVision DEFINITY G3 Fault Management Installation and Integration This guide explains how to install and set up Fault Management software how to set up PBXs and Proxy Agents as nodes on the NMS how to change Fault Management s polling interval...

Page 10: ...ubcontractors or persons working on your company s behalf Additional security information is included in Security Considerations later in this preface Trademarks The following AT T trademarks or registered trademarks are used in this document DynaText is a registered trademark of Electronic Book Technologies Inc HP HP UX and OpenView are trademarks of Hewlett Packard Company Text format Type of in...

Page 11: ...hat network Fault Management neither adds to nor detracts from the level of security your NMSprovides Fault Management is a display only application you can view the data from your PBX but not change it Reader Comments If you have any comments or suggestions about this document please send them to AT T at the following address AT T Product Documentation Development Department Room 22 2C11 11900 No...

Page 12: ...About This Book xiv Issue 2 April 1996 AT T BCS is also an HP OpenView Solution Partner and Fault Management is listed in the HP OpenView Solutions catalog ...

Page 13: ...ation 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 status of a DEFINITY G3 PBX Fault Management displays DEFINITY G3 PBX fault and configuration data in a graphical format It resides on an industry standard network management system NMS Fault Management ...

Page 14: ... alarm conditions that exist within a PBX The information is in a color coded graphical format so that you can find faults quickly and easily Fault manager alerts you to fault conditions by Highlighting the graphic depiction of the PBX hardware that has an alarm The color of the highlight corresponds to the highest severity alarm This highlighting allows you to see the following items at a glance ...

Page 15: ...ed on two separate computers The purpose of the Proxy Agent is to receive status information from the PBX and then translate that information into a format that your NMS can understand That format is SNMP Simple Network Management System Your Network Management System Fault Management is an add on to your network management system NMS Fault Management integrates with your NMS in such a way that Fa...

Page 16: ...he color of the highest severity fault For example if a cabinet has four warnings and one minor alarm the cabinet is highlighted with the color of the minor alarm NOTE You can change these color settings on the Setup menu See Table 3 6 for instructions G3vs G3s G3i G3r V1 1 ABP PBP V1 1 ABP PBP V1 1 286 V1 1 V2 ABP PBP V2 ABP PBP V2 386 V2 V3 ABP PBP V3 ABP PBP V3 386 V3 V4 ABP PBP V4 ABP PBP V4 3...

Page 17: ...spots When you click the mouse on an area of the screen designated as a hotspot the system performs a predetermined function Menu Description Option Allows you to perform application wide commands For example opening Fault Management features saving data and closing screens Fault Allows you to see lists or reports of current errors and alarms These lists display in new windows Configuration Allows...

Page 18: ...xample The port and individual external device layers do not have hotspots because they are the last layers Each window that a hotspot opens is specific to the hotspot itself For example if you click on the Cabinet 1 icon in the Switch View the system opens a window containing only Cabinet 1 data as shown in the following figure If you are at this layer And you click on this hotspot Then this laye...

Page 19: ...ts or more report items If the window does not include scroll bars all the relevant information or data is visible in the window Close Button When you click on the close button the system closes the current window and all open child windows A child window is a window associated with a lower level or with a report for the current or lower level For example the circuit pack display is the child wind...

Page 20: ...multaneously press the meta key on your keyboard and the underlined letter of the menu option For a submenu press the underlined letter of the menu item How to Enter Data You can enter data into Fault Management screens in the following ways Data typed into fields Pull down lists Check boxes Radio buttons Data Typed into Fields You type data into some fields You can also copy the data from one scr...

Page 21: ... options Radio buttons look like this In this example the Ascending radio button is turned on Management Information Base The management information base MIB is a database of network management information The MIB is located in the following directory usr OV OneVision DG3FM g3mib asn1 You can print the MIB by using your system s print command Data Refresh Data refresh is the process Fault Manageme...

Page 22: ...t Management Startup screen displays the following message indicating the status of the startup refresh Refresh in progress estimated delay 250 seconds 50 seconds elapsed Startup refresh updates the following information If the Proxy Agent is unable to connect to the PBX and refresh the data the startup refresh fails In this case the following message appears when you invoke Fault Management from ...

Page 23: ...hours The timer is reset before the refresh process begins When the refresh timer expires Fault Management starts the data refresh For more information about changing the timer for the circuit pack refresh interval see Changing Time Intervals NOTE For a configuration refresh Fault Management closes any open Cabinet View and External Devices screen and their child windows A user requests a refresh ...

Page 24: ...must close Fault Management and re invoke it from your NMS Receiving a Trap When Fault Management receives a trap from the Proxy Agent it refreshes the alarms and errors data A trap can indicate that The PBX has generated a new major minor or warning alarm All PBX alarms have been cleared Receiving a trap from the Proxy Agent is the primary method Fault Management uses to refresh alarm and error d...

Page 25: ...eceived the trap The name of the node on the NMS Location The location of the alarm that is related to the trap Severity One of the following alarm states Major Minor Warning Description The MO maintenance object name for the alarmed object On Board Indicates whether the fault is on the associated circuit pack or on an off board element connected to the circuit pack Valid values are y yes n no ...

Page 26: ...Introduction 1 14 Issue 2 April 1996 Figure 1 4 Trap Message for External Devices ...

Page 27: ...Warning Description The MO maintenance object name for the alarmed object On Board Indicates whether the fault is on the associated circuit pack or on an off board element connected to the circuit pack Valid values are y yes n no External Device Information A heading that identifies the fields for external devices Alternate Name The name of the external device Description The description of the ex...

Page 28: ...resh The cycle begins again when Fault Management completes the refresh Fault Management allows you to Set this time interval for anytime from 5 and 1500 minutes Turn off polling for alarm and error data For more information about changing the interval for the alarm and error refresh see Changing Time Intervals Table 1 3 Field Descriptions for Trap Messages for Resolved Alarms Field Description He...

Page 29: ... number of traps in subsequent polls Any difference between the two indicates the need for a refresh Fault Management allows you to Set this time interval for anytime from 1 and 60 minutes When the interval has passed Fault Management starts polling the MIB objects from the Proxy Agent Turn off polling for MIB objects For more information about changing the interval for alarm polling on the Proxy ...

Page 30: ...ment 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 You use the node icons on the NMS map to start Fault Management Double click on the following icon for the procedure for starting Fault Management 2 Starting Stopping Fault Manag...

Page 31: ...een double click on the following icon 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 Method B 1 Highlight a PBX icon 2 At the menu select Monitor à DEFINITY à G3 Fault Management ...

Page 32: ...nd forwards it to Fault Management The message includes the Estimated amount of time necessary to refresh data nnn Elapsed time n Fault Management requests a full refresh if the value in the Refresh on Start up field on the Setup screen is TRUE This value is the default setting Refer to Chapter 3 Customizing Fault Management for instructions on changing the start up settings Refresh on startup fai...

Page 33: ...ail to retrieve data because your cache is empty Stop requesting data after a predetermined number of attempts Retrieving Data Fault Management retrieves data when you first start it up Fault Management 1 Uses the sysObjectID object from the MIB II to get the switch type from the Proxy Agent 2 Compares the switch type of the sysObjectID object to the switch type of the vintage object in the G3 MIB...

Page 34: ...arm or error information Requesting Data Fault Management requests data from the Proxy Agent a predetermined number of times If Fault Management cannot retrieve data after the final attempt it Displays a message in the message area of the Switch View window Stops trying to get data NOTE You use the Setup screen to specify the number of times Fault Management requests data before timing out See Tab...

Page 35: ...ervals 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 Open the Switch View screen 2 Select Setup from the Options menu Result The Setup screen displays The Setup Screen The Setup screen allows you to change the 3 Customizing Fault Management ...

Page 36: ...figurations 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 Sample Setup Screen The following figure shows the Fault Management Setup screen ...

Page 37: ...n 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 Grey Scale Resets each color field to the default settings for grey scale Save Saves the current settings permanently Close Closes this screen and any open child screens ...

Page 38: ...Screen Field Default Color Default Grey Scale Major Alarm Color Red 0 Grey Minor Alarm Color Orange 55 Grey Warning Alarm Color Yellow 80 Grey Circuit Pack Mismatch Color Blue 0 Grey Highlight Color Green 0 Grey Circuit Pack Select Color Cyan 0 Grey Table 3 3 Procedure for Changing Colors Use the following steps to change the default color settings 1 Enter either the color name or the hexadecimal ...

Page 39: ...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 The higher this percentage the lighter the grey 3 Click Apply to test your changes 4 Select Options à Save to save your changes for future s...

Page 40: ...0 minutes 0 turns the polling off The time interval between polls for an alarm change If Fault Management polls the Proxy Agent and detects an alarm change it refreshes the data If it does not detect an alarm change it does not refresh the data You must balance how often you want Fault Management to check for changed alarm status and then update the data versus how much the refresh process affects...

Page 41: ...rom the PBX when you start Fault Management TRUE Fault Management initializes with new PBX data from the Proxy Agent FALSE Fault Management initializes using cached stored data from the Proxy Agent Number Retries on SNMP Timeout 4 retries The number of retries does not include the original attempt Indicates how many times Fault Management retries to get data from the Proxy Agent Enter a number fro...

Page 42: ...ou exit Fault Management Saving Changes If you are satisfied with the changes you have made use the following procedure to save them for this and future sessions 1 Select Apply at either of the following locations 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 1 To do this Enter this In this field Init...

Page 43: ...ptions you can customize If you make changes to the Setup screen and then decide you want to return to the default settings you may do so easily by selecting Options à Defaults Exiting the Setup Screen Use one of the following methods to exit the setup screen Click on the Close button at the lower right corner of the screen Select Options à Close NOTE If you close the screen without saving or appl...

Page 44: ...tion External Devices Individual External Devices Overview of the Configuration Map The configuration map is the graphical interface to the application It allows you to navigate through Fault Management and quickly access PBX data The benefit of this feature is that you can see configuration and fault information quickly and easily This feature consists of graphical depictions of the PBX configura...

Page 45: ...arms display The color coded alarm boxes show the cumulative total of active alarms Typically alarms display on the right hand side of the window Figure 4 1 Alarms Screens in the Configuration View The configuration map displays PBX data in layers or views Each view is a graphical display for one of the following hardware layers Switch View Cabinet View Circuit Pack Information Port Information Ex...

Page 46: ...es only displays if an external device is administered on the PBX The Switch View has the following components Menu Bar for Switch View Screen Heading for Switch View Alarms for Switch View Switch View Hotspots Switch View Messages How to Open the Switch View The Switch View opens automatically when you start Fault Management It is the first screen to display after the Fault Management Startup scr...

Page 47: ...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 Clear Highlighting Clears the highlighting that you selected Exit Closes Fault Management and returns you to the NMS ...

Page 48: ...ion Display Hardware Software Information Displays the current vintage or release information about the PBX and Fault Management software Circuit Pack Inventory Displays a summary report for the circuit packs currently installed on the PBX All Circuit Packs Displays a detailed report for all the circuit packs that are administered on the PBX or that are physically present on the PBX Exception Circ...

Page 49: ...Type The type of PBX the object ID from the Proxy Agent MIB as it is administered on the Proxy Agent Number of Cabinets Found The number of cabinets that Fault Management recognizes Valid values are A number from 1 44 Blank if Fault Management cannot find any cabinets for the PBX Circuit Pack Mismatches The number of circuit packs with a mismatch between the type that is inserted into the cabinet ...

Page 50: ...pot area Icon labels have the following components If you click on this icon Then this screen displays External Device External Devices Cabinet The appropriate Cabinet View Component Description Example Name Identifies the external device or cabinet Background color Identifies cabinets with a circuit pack mismatch If the cabinet does not contain any circuit packs mismatches the background color do...

Page 51: ...binet Messages How to Open the Cabinet View To open the Cabinet View 1 Display the Switch View 2 Click on a cabinet icon Sample Cabinet View The following figure shows the Cabinet View Message Type Description Warning A warning message only displays when the data that Fault Management displays is based on non refreshed cached data The following situations can result in this warning Fault Managemen...

Page 52: ... 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 Close Closes the Cabinet View and any open child windows ...

Page 53: ... cabinet Cabinet Level Alarms for Cabinet Displays active alarms on the cabinet that are not related to a specific circuit pack All Errors for Cabinet Displays all errors for the alarms on the cabinet Cabinet Level Errors for Cabinet Displays errors for alarms on the cabinet that are not related to a specific circuit pack Table 4 7 Configuration Commands Menu Option Command Description Highlight C...

Page 54: ...ng used NOTE You can open up to 23 circuit pack views While these views are open Fault Management highlights the corresponding circuit pack on the cabinet view with the circuit pack select color When you open several circuit pack views at the same time you can bring a particular one to the front by clicking on the corresponding circuit pack in the cabinet view See Hotspots in Chapter 1 for an over...

Page 55: ...the cabinet slot and the type that is administered for that slot A mismatch is the highest level of severity and supersedes alarms You can set the background color in the Circuit Pack Mismatch Color field on the Setup screen Fault Management displays this field only when mismatches exist Table 4 9 Alarms The color coded alarms on the right side of the screen display the number of major minor and w...

Page 56: ... The type of cabinet processor expansion port network ROOM The room where the cabinet is located taken from PBX administration FLOOR The floor where the cabinet is located taken from PBX administration BUILDING The building where the cabinet is located taken from PBX administration CARRIER DESCRIPTION This area of the screen includes details about the carrier Carrier The carrier label Carrier Type...

Page 57: ...rning message displays only if you clicked on a cabinet hotspot on the Switch View before Fault Management retrieved all the information about circuit packs The message disappears once Fault Management completes data retrieval Highlight Message Below CARRIER DESCRIPTION information An informational message that describes the last highlighting selection you made from the Configuration menu Circuit ...

Page 58: ...Circuit Pack Information Issue 2 April 1996 4 15 Sample Circuit Pack Information Screens Double click on one of the following icons for a sample screen Figure 4 4 Circuit Pack Information Screen ...

Page 59: ...The Configuration Map 4 16 Issue 2 April 1996 Figure 4 5 Circuit Pack Information Screen Showing a Conflict ...

Page 60: ...ommands Menu Command Description Options Close Closes the Circuit Pack Information screen and any open child windows Fault All Alarms for Circuit Pack Displays active alarms on the circuit pack All Circuit Pack Level Alarms for Circuit Pack Displays active alarms on the circuit pack that are not related to a specific port All Errors for Circuit Pack Displays errors related to active alarms on the ...

Page 61: ...h 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 Table 4 13 Alarms The color coded alarms on the right side of the screen displays the number of major minor and warning alarms as follows Circuit pack alarms that are on the circuit pack but are not associated with a port Pack alarms that are specificall...

Page 62: ...if there is a mismatch between the circuit pack s administration and type SIGNALING The type of signaling Displays only for DS1 circuit packs NAME The DS1 name Displays only for DS1 circuit packs CSU MODULE The ID for the integrated CSU module Displays only for DS1 circuit packs BIT RATE The speed of the channels either 2 048 or 1 544 Mbps Displays only for DS1 circuit packs The Default is 2 048 A...

Page 63: ...nformation screen contains data for a single port The data that displays varies depending on the type of equipment in the port Equipment types are Stations Data modules Trunks How to Open Port Information To open the Port Information screen 1 Display the Circuit Pack Information screen 2 Click on a port in the ASSIGNED PORTS data area Sample Port Information Screens Double click on an icon for sam...

Page 64: ...Port Information Issue 2 April 1996 4 21 Figure 4 6 Port Information Pooled Modem ...

Page 65: ...The Configuration Map 4 22 Issue 2 April 1996 Figure 4 7 Port Information Station ...

Page 66: ...Port Information Issue 2 April 1996 4 23 Figure 4 8 Port Information Data Module ...

Page 67: ... 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 for Port Displays all active alarms for the port specified All Errors for Port Displays all errors for the port specified Help Displays a Help window ...

Page 68: ... a description of these data areas Table 4 15 Screen Heading Field Description Application Name DEFINITY G3 FM Screen Title Port 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 This information is passed from the NMS Table 4 16 Alarms The color coded alarms on the right side of the screen display the number of major minor a...

Page 69: ...he type of circuit pack the port is on EQUIPMENT TYPE The equipment attached to the port For example Station Data Module Integrated Announcement IDENTIFICATION The alternate name of the port For example A station extension The trunk group member number Trk Gp Mbr No EQUIPMENT TYPE For BRI Multipoint the equipment attached to the second port IDENTIFICATION For BRI Multipoint the alternate name of t...

Page 70: ...e room where the station is located as administered on the PBX Cable The identifier of the cable as administered on the PBX Jack The location of the jack as administered on the PBX Service State The current service state of the station Maintenance Busy Indicates if the station is busy for maintenance purposes Connected Ports Lists any ports that are currently connected to the station SAC Activated...

Page 71: ...Destination Ext Call Forwarding destination for data The extension to which the PBX forwards calls Table 4 19 Equipment Type Data Module Field Description Extension The extension number for the station Type The type of data module Name The data module s name as administered on the PBX Service State The current service state of the data module Maintenance Busy Indicates if the station is busy for m...

Page 72: ...irection The trunk direction For example a 2 way direction has incoming and outgoing calls Comm Type or Service Type Either the communications type or the service type Trunk Type The type of trunk Some examples are Voice Data Tie Member Name The member name of the trunk as administered on the PBX Trunk Member Status Information Service State The current service state of the trunk Maintenance Busy ...

Page 73: ...e s hardware status and configuration NOTE The icon for external devices only displays on the Switch View if an external device is administered on the PBX The External Devices View has the following components Menu Bar for External Devices Screen Heading for External Devices Alarms for External Devices External Device Hotspots External Device Messages How to Open External Devices To open the Exter...

Page 74: ...External Devices Issue 2 April 1996 4 31 Figure 4 10 External Devices View ...

Page 75: ...rnal devices Table 4 21 Menu Commands Menu Command Description Options Report Builder Allows you to create ad hoc reports Clear Highlight Clears any highlighting Close Closes this view and any open child windows Fault All External Device Alarms Displays all active alarms for the device All External Device Errors Displays all active errors for the device Help Displays a Help window Table 4 22 Scree...

Page 76: ...t includes in the report External Device Messages The message area at the bottom of the screen displays the following types of messages Individual External Devices The Individual External Devices screen displays the hardware configuration and the fault status for a specific external device The Individual External Devices screen has the following components Menu Bar for Individual External Device M...

Page 77: ...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 Individual External Device Screen ...

Page 78: ...on for more information Table 4 23 Menu Commands Menu Command Description Options Close Closes this view and any open child windows Fault Display Alarms For External Device name Displays all active alarms for the device Display Errors For External Device name Displays all active errors for the device Help Displays a Help window Table 4 24 Screen Heading Data Description Application Name DEFINITY G...

Page 79: ... of the port that connects the external device Administered Alarm Type The type of alarm that the PBX generates for an active alarm Valid values are Major Minor Warning Alternate Name The abbreviated name for the external device Description A brief description of the external device Product Identifier The 10 digit product number for the external device Building The building where the device is loc...

Page 80: ...eport Information Error Description Screen Bulletin Board Overview of Fault Manager Fault manager uses a graphical format to indicate alarm conditions including Where an active non resolved alarm is located on a PBX The type of alarm major minor or warning The severity level of these alarm types are indicated by color for easy identification The number of alarms in each alarm type For each alarm t...

Page 81: ...Faults Faults are active alarms and errors within a PBX Fault manager uses the following methods of displaying these faults Color Highlighting Alarms Alarms Reports Error Reports Color Highlighting Fault manager highlights the affected hardware with the color of the highest severity fault For example if a cabinet has four warnings and one minor alarm the cabinet is highlighted with the color of th...

Page 82: ... 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 Double click on an icon for more information Table 5 1 Types of Alarms Reports Screen Fault Menu Command Report Description Switch View All Alarms All active alarms in the PBX Switch Level Alarms All active alarms that are in the PBX but are not associated w...

Page 83: ...tive alarms for the port External Devices View All External Device Alarms All active alarms for all external devices that are connected to the PBX Individual External Device Display Alarms For External Device name All active alarms for the external device specified Table 5 1 Types of Alarms Reports Screen Fault Menu Command Report Description ...

Page 84: ...armed object On Board The location of the detected fault y The fault is on the associated circuit pack n The fault is not associated with this circuit pack but with on an off board element that is connected to the circuit pack 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 ...

Page 85: ... exist Which ports are affected The Fault menu allows you to select a report that displays errors for All the errors for the hardware layer that is currently displayed Only the errors that are not specific to the hardware you are displaying 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 associ...

Page 86: ...mation Table 5 3 Types of Error Reports Screen Fault Menu Command Report Description Switch View All Errors All errors in the PBX Switch Level Errors All errors that are in the PBX but are not associated with any cabinet Cabinet View All Errors for Cabinet All errors in the cabinet Cabinet Level Errors for Cabinet All active alarms that are in the cabinet but are not associated with any circuit pa...

Page 87: ...or 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 Maintenance Name The logical name of the maintenance object ...

Page 88: ...the maintenance object type However unlike the error type only the most recent value of the auxiliary data is retained for each error type in the log First occur First occurred The month day hour and minute that the error was first recorded Last occur Last occurred The month day hour and minute that the most recent error was recorded If the system cannot retrieve the time of day the error occurred...

Page 89: ...port choices see the Types of Alarms Reports and the Types of Error Reports tables earlier in this chapter You can also create ad hoc reports from the Report Builder screen 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...

Page 90: ...sted in an error report Open this report And click on this field To display these screens Comment Alarms or Errors Port Cabinet View Circuit Pack Information Port Information Only the screens with information related to the port display For example if the port field is 0000000 then the object is not connected to a port and the Switch View displays 01 then the Cabinet View displays 01c19 then the C...

Page 91: ...n 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 Click on the value in any field except Port Sample Error Description Screen The following figure shows the Error Description screen Figure 5 3 Error Description Screen ...

Page 92: ...tabase Notes Panel The Notes panel provides a place for you to enter your comments about the error How to Enter a Note Use the following guidelines to enter a new note or edit an existing note You can enter up to 5 lines of text and 255 characters Table 5 5 Menu Commands Menu Command Description Options Save Saves your entry for the Notes panel Close Closes the Error Description screen Help Displa...

Page 93: ...k on Save Bulletin Board The PBX bulletin board allows users to post messages for other users Technicians often use it to update network managers about their progress when fixing problems on the PBX Fault Management provides a screen that allows you to view the contents of the bulletin board How to Open the Bulletin Board To open the bulletin board 1 Display the Switch View 2 Select Fault à Displa...

Page 94: ...etin 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 Close Closes the bulletin board Help Displays a Help window ...

Page 95: ...twork This information is passed from the NMS Table 5 9 Field Descriptions for Bulletin Board Messages Field Description Date The date of the message Indicates a high priority message Message The message Table 5 10 Message Area The message area at the bottom of the screen can display the following message Message Description Cached Data Warning A warning message only displays when the data that Fa...

Page 96: ...cally 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 1 Display the Switch View 2 Select Fault à Refresh Bulletin Board ...

Page 97: ... to Refresh Configuration Data Overview of Configuration Manager The configuration manager provides configuration data for the PBX and the cabinet hardware layers This data is available in the following formats Online reports that you can save to an ASCII file A graphical display of circuit pack information You select these formats from the Configuration menu on either the Switch View or the Cabin...

Page 98: ...state The version of the current Fault Management software Double click on an icon for more information about the Hardware Software Information report 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 se...

Page 99: ...s 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 Report Heading Data Description Application Name DEFINITY G3 Fault Management Report Title Hardware Software 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 100: ...NOTE An error message displays if the switch type in this field does not match the one in the previous field This message indicates that the PBX is administered as a different configuration than the hardware really is Fault Management s configuration validation is concerned with any difference in the r i s or vs as in G3rV3 or G3vsV3 Active SPE The name of the switch processor element SPE that is ...

Page 101: ... 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 Help Displays a Help window ...

Page 102: ...g Data Description Circuit Packs of Types The total number of circuit packs and the total number of types of circuit packs Application Name DEFINITY G3 Fault Management 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 Table 6 6 Fields on the Circuit Pack Inventory Report Field Description Count How ma...

Page 103: ...nt in the PBX You can also create custom reports on the Report Builder screen Double click on the following icons for more information about circuit pack reports Figure 6 3 Circuit Pack Report 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: ...ow 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 selection All Circuit Packs Exception 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 Circuit Packs Found The number of circuit packs that match th...

Page 105: ... 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 The highlighted word CONFLICT if there is a mismatch between the circuit pack s administration and type Type of Circuit Pack The external name of the circuit pack PORTS ...

Page 106: ...or 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 DS1 Circuit Packs Found The number of DS1 circuit packs that match the criteria ...

Page 107: ...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 The highlighted word CONFLICT if there is a mismatch between the circuit pack s administration and type Signaling The type of signaling administered Name The name assigned to the...

Page 108: ...veral predefined configuration filters When you select the filter type the system Highlights those circuit packs that meet the filter criteria Displays a circuit pack report This feature is available only at the cabinet level where you can see the graphic depiction of the circuit packs within the cabinet The predefined circuit pack filters are Unassigned Ports No Assigned Ports No Available Ports ...

Page 109: ...Display How to Identify Circuit Pack Configurations Use the configuration filter to identify specific types of circuit packs as follows 1 Open the Cabinet View 2 Select Configuration à Highlight Circuit Packs With Result A submenu opens 3 Select the type of circuit pack you want to highlight Result The configuration menu highlights the circuit packs that meet the criteria you selected ...

Page 110: ...atic refresh Have disabled the automatic refresh To refresh the configuration data 1 Open the Switch View 2 Select Configuration à Refresh Configuration Data Result The configuration data refreshes Scheduled Refresh Before a scheduled refresh of circuit pack data Fault Management prompts you for permission to start the refresh Fault Management responds to your response as follows If you click OK o...

Page 111: ...e Report Specifications How to Run the Report Overview for Report Builder Fault Management provides a variety of standard reports through the menu bar on many screens Opening these reports is quick and convenient However if you need data that is specific to a particular business issue you can use Report Builder to create ad hoc reports You can use Report Builder to Specify up to three search crite...

Page 112: ... entering search criteria into the Report Builder screen A few examples of these search criteria are All alarms that are more than one day old Only the on board alarms All ports that had any errors on a particular day The location of all DS1 boards on the PBX Report Format Reports that you create on the Report Builder screen have the same format as the standard reports To see this information Clic...

Page 113: ... screen allows you to create ad hoc reports This section provides the following topics about the Report Builder screen How to Open Report Builder Sample Report Builder Screen Menu Bar for Report Builder Data Area for Report Builder Button Line How to Open Report Builder To open the Report Builder screen 1 Display any of the following screens a Switch View b Cabinet View c External Devices View 2 S...

Page 114: ...Report Builder 7 4 Issue 2 April 1996 Figure 7 1 Report Builder Screen ...

Page 115: ...t based on the entries you make in the fields Save Report Specs Saves the report specifications to your hard drive Delete Deletes the report specifications for the report that is displayed in the Report Name field Output Options Opens the Output Options screen so you can select your output parameters Close Closes the Report Builder screen and any open child windows Help Displays a Help window Tabl...

Page 116: ...r selection in the Table to Search field You can select up to three Field Names for each report Comparison Indicates the type of comparison between the value s in the Field Name field and the corresponding value field s Valid values that you can select from the pull down list are Equal default Range Value One of the following If you set the Comparison field to Equal then Fault Management retrieves...

Page 117: ...al to or less than the value in this field Partial Match Allows Fault Management to retrieve values that only partially match the contents of the Value and To Value fields Hint If you need an exact match make sure this check box is off Table to Output The name of the table to use for output This field determines the table s format You can select one of the following values from the pull down list ...

Page 118: ...er 1 Name the report 2 Select the source table 3 Enter search criteria 4 Format the report 5 Sort the report 6 Run the report 7 Save the report specifications The following sections explain how to use the fields described in Table 7 3 Button Description Run Report Produces the report based on the entries you make in the fields Save Report Specs Saves the report specifications to your hard drive Ou...

Page 119: ...t Management fills the other fields on the screen with data from the report specifications file on your hard drive You can edit your selection from the pull down list to create a new report name How to Select the Table to Search Report Builder can retrieve PBX information from one of the following tables in the Fault Management database Alarms Circuit Packs DS1 Circuit Packs Errors Guidelines for ...

Page 120: ... screen as follows 1 Open the Report Builder screen 2 Enter a name in the Report Name field and press Enter 3 Click on Run Report How to Enter Search Criteria After you choose a table you can enter the search criteria for the data that you want Report Builder to retrieve Double click on the following icon to view the fields that allow you to select the search criteria Figure 7 2 Search Fields Guid...

Page 121: ...e sure the Partial Match field is turned off 3 Click Run Report Click on an icon for examples of how to search for an exact match Field What you enter Table to Search The name of the table in the database Field Name The name of the field in the table Comparison Equal Value The data that you want to match Table 7 4 An Exact Match with One Variable Exact match with one variable This example shows ho...

Page 122: ... Alarmed Report Builder searches for Maintenance Name DIG LINE and Date alarmed 09 27 16 30 The Partial Match field for both instances of Field Name is off Exact match when either variable is true This example shows how to find all the alarms for the digital line and data module circuit packs Comments Both instances of Field Name are the same Maintenance Name Report Builder searches for Maintenanc...

Page 123: ...n the database Field Name The name of the field in the table Comparison Range Value The lower end of the range If you leave this field blank Report Builder searches for all data equal to or less than the entry in the To Value field To Value The upper end of the range If you leave this field blank Report Builder searches for all data equal to or greater than the entry in the Value field Table 7 6 A...

Page 124: ...ithout 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 Comments Value yesterday s date ...

Page 125: ...ck on the partial match check box 3 Repeat steps 1 and 2 for each partial match 4 Click on Run Report How to Format the Report Report Builder generates reports in one of the following table formats Alarms Circuit Packs DS1 Circuit Packs 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 Com...

Page 126: ...ault Management initializes the sort fields so you can select new sorting criteria How to Sort Report Data After you choose the report s format you can select the order that you want Report Builder to display the data that you selected in the Field Name and associated fields Double click on the following icon to view the fields that allow you to sort the data Figure 7 3 Sort Fields Guidelines for ...

Page 127: ...rt Builder screen 2 Click on Run Report Result The report displays on your screen Hint If you want to highlight objects or send the output to a printer or to a file see Chapter 8 Output Options How to Change the Report You can change the report specifications after Fault Management displays the report But before you do review the report to determine whether it contains information that may be usef...

Page 128: ...eters for the reports that You created on the Report Builder screen Display when you open a report window You can Display the report on your screen Highlight the report objects on the screen display Print the report Save the report as an ASCII file You enter these parameters on the Output Options screen Output Options Screen This section provides the following topics about the Output Options scree...

Page 129: ...t Options screen as follows Sample Output Options Screen The following figure shows the Output Options screen If this is open Then to open Output Options A report window for Alarms Circuit packs DS1 circuit packs Errors From the menu bar select Options à Output Options Report Builder screen Use either of the following methods From the menu bar select Options à Output Options Click on Output Option...

Page 130: ...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 A report window Apply sends the report to the output destination and closes the screen Close Closes the Output Options screen Help Displays a Help window ...

Page 131: ...try Double click on an icon for a description of these areas Table 8 2 Screen Heading Field Description Application Name DEFINITY G3 Fault Management Screen Title Output Options for the screen that was active when you selected Output Options 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 132: ...racters This field is required if you select Output to Printer Page Length The number of lines in a printed page Default 66 lines Minimum 15 lines Maximum 999 Output to File Sends the report to a file If you select this field then select one of the following report formats ASCII default Creates an ASCII file that you can export to another application Formatted Prints the report with the same chara...

Page 133: ...access this field You can reset the default delimiter on the Setup screen Page Length The number of lines in a page This field is required if you selected Formatted as the report format If you selected ASCII you cannot access this field Default 66 lines Minimum 15 lines Maximum 999 Message Description Prompts Messages that remind you to enter data into required fields These types of messages displ...

Page 134: ...Builder screen 1 Click on Apply 2 Click on Run Report Result the report displays on your screen How to Highlight Objects To highlight Fault Management objects 1 Click on Highlight Objects 2 Click on Apply 3 Did you open the Output Options screen from the Report Builder If yes click on Run Report If no you have completed this procedure How to Print Reports To print a report 1 Click on Output to Pri...

Page 135: ...e following file formats ASCII to save the file for export to another application Formatted to use the format that you see when you display the report 3 Enter the file s name in the File Name field You can enter up to 150 characters 4 Do you want to append the report to the file in the File Name field If yes click on Append If no go to step 5 5 Did you click on Formatted in step 2 If yes you can c...

Page 136: ...April 1996 8 9 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 ...

Page 137: ...ing only pertains to a specific platform These topics are discussed at the end of the appropriate section Click on a topic for more information xnmevents Crash HP OpenView Switch View Messages Messages Specific to HP OpenView Port Messages Messages Specific to HP OpenView Pop up Messages Startup Messages xnmevents Crash HP OpenView The following problem can occur with the current version of the Fa...

Page 138: ... up window that causes the crash To use this resource add the following line in the Xdefaults of the login running OpenView xnmevents warnOnUnknownTrapSource False Upgrade to OpenView 3 3 1 Then get patch DFIX1312 from Hewlett Packard This fixes the problem Switch View Messages The following error messages appear in the message area of the Switch View ERROR Alarms and Errors Refresh failed Descrip...

Page 139: ... specified data from the PBX This can occur when you request data for an unassigned port or if the connection between the PBX and the Proxy Agent is down 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 ...

Page 140: ...roxy Agent Description The Fault Management application received a bad response from the Proxy Agent while requesting data 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 Retry the operation Warning T...

Page 141: ... to the Proxy Agent to find out Is the Proxy Agent running Telnet to the Proxy Agent and run g3 ma and display the status on the Proxy Agent If the Proxy Agent is still disconnected from the PBX after you check all of these items call the Technical Service Center for assistance Messages Specific to HP OpenView The following messages are specific to the HP OpenView platform ERROR No response from a...

Page 142: ...ween the PBX and the Proxy Agent is down Action Check the connection between the Proxy Agent and the PBX The words Not Available display in the fields on the Port Information screen Description Fault Management is not getting a response from the Proxy Agent Action Try the following Make sure the connection is up Increase the value in the Number Retries on SNMP Timeout field on the Setup screen Mes...

Page 143: ...letron Spectrum usr OneVision DG3FM DG3FMdefaults For all other platforms usr OV OneVision DG3FM DG3FMdefaults 3 Check the permissions on the file The Fault Management application must be able to write to the file 4 Restart the application There is already an Alarms and Errors refresh in progress If you still want to request another refresh please wait until the current one is complete Action Wait...

Page 144: ...refresh in progress Please don t press any cabinet buttons until it is done Action Wait for the circuit pack refresh to get to the point where it is receiving the circuit pack data before clicking on a cabinet icon WARNING The Circuit Pack refresh has 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 ca...

Page 145: ...e is missing 1 Open the Setup screen and set the Refresh Proxy Agent on Startup field to TRUE 2 Restart Fault Management Startup Messages The following messages display during the startup process Usage dg3fm host_name community_name switch_name Description The Fault Management application was started up with the wrong parameters OpenView only Action The DEFINITY icon selection name and the name in...

Page 146: ...e your permissions set correctly on the PBX You can check the login and password on the Proxy Agent Communications form For more information see the OneVision DEFINITY G3 Proxy Agent Installation and Connectivity guide Is a PBX management port available Does it give a modem tone Call the modem from a voice station to check Can you log into the PBX management port from another terminal and modem Ca...

Page 147: ...e that allows you to collect and then track your trouble tickets Cabletron SPECTRUM HP OpenView To integrate Fault Management and Remedy you must set up a shell script on the HP OpenView platform A shell script runs each time a DEFINITY G3 map icon changes states You can use this script to enter trouble tickets into the AR System database This script passes the following information Variable Descr...

Page 148: ...e fields for the following information A map object ID The current object state The previous object state The following fields are defaults you do not have to add them Submitter Description fields Create a Macro Use the following guidelines to create a macro that submits the schema to the AR System database Use the AR System User Tool Hint The following command opens this tool usr ar bin aruser Fi...

Page 149: ...ng to the Remedy documentation NSLPATH ARHOME ARPATH The command line should look like aruser e macro name p object 1 p desc 2 p new state 3 p old state 4 2 In OpenView cause an alarm to force a DEFINITY map object to change states 3 When the map object changes states open the Remedy aruser tool and verify that the information was recorded Hint See your Remedy documentation if you need help 4 Modi...

Page 150: ...Integrating With Remedy 10 4 Issue 2 April 1996 For information about SPECTRUM ARS Gateway contact your Cabletron representative ...

Page 151: ...you invoke Fault Management from an NMS The Switch View opens automatically after the Startup screen disapears from view The Fault menu opens reports about alarms and errors The Configuration menu opens reports about PBX hardware If you are here And you want to open this screen Then click on this Or Select this from the menu bar Switch View Cabinet View A cabinet icon External Device View The exte...

Page 152: ...al External Devices An external device icon Report Builder Options à Report Builder Report Builder Output Options The Output Options button Options à Output Options Any report window Switch View Cabinet View Circuit Pack Information Port Information External Devices The location field Any error report Error Description Any field except Port If you are here And you want to open this screen Then cli...

Page 153: ...iguration map overview 1 2 D Data refresh 1 9 startup 1 10 Default settings Setup command 4 4 F fault 1 2 G Graphical user interface GUI 1 2 H Hotspots 1 5 K Keyboard 1 8 M Meta key 1 8 N Network management system NMS 1 3 Node 1 3 P Port hardware layer 1 2 Proxy Agent 1 3 R Refreshing data 1 10 S Scroll bars 1 7 Setup command 4 4 Simple Network Management System SNMP 1 3 SNMP See Simple Network Ma...