Enterprise Alarm Manager

Transcription

1 Enterprise Alarm Manager User Guide Document 2065

2 Notice Copyright Notice Copyright 2002-present by Aprisma Management Technologies, Inc. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS (c)(1)(ii) and FAR Liability Disclaimer Aprisma Management Technologies, Inc. ( Aprisma ) reserves the right to make changes in specifications and other information contained in this document without prior notice. In all cases, the reader should contact Aprisma to inquire if any changes have been made. The hardware, firmware, or software described in this manual is subject to change without notice. IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, HAS KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Trademark, Service Mark, and Logo Information SPECTRUM, IMT, and the SPECTRUM IMT/VNM logo are registered trademarks of Aprisma Management Technologies, Inc., or its affiliates. APRISMA, APRISMA MANAGEMENT TECHNOLOGIES, the APRISMA MANAGEMENT TECHNOLOGIES logo, MANAGE WHAT MATTERS, DCM, VNM, SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, SPECTRUM Security Manager, and Virtual Network Machine are unregistered trademarks of Aprisma Management Technologies, Inc., or its affiliates. For a complete list of Aprisma trademarks, service marks, and trade names, go to: All referenced trademarks, service marks, and trade names identified in this document, whether registered or unregistered, are the intellectual property of their respective owners. No rights are granted by Aprisma Management Technologies, Inc., to use such marks, whether by implication, estoppel, or otherwise. If you have comments or concerns about trademark or copyright references, please send an to spectrum-docs@aprisma.com; we will do our best to help. Restricted Rights Notice (Applicable to licenses to the United States government only.) This software and/or user documentation is/are provided with RESTRICTED AND LIMITED RIGHTS. Use, duplication, or disclosure by the government is subject to restrictions as set forth in FAR (June 1987) Alternate III(g)(3) (June 1987), FAR (June 1987), or DFARS (c)(1)(ii) (June 1988), and/or in similar or successor clauses in the FAR or DFARS, or in the DOD or NASA FAR Supplement, as applicable. Contractor/manufacturer is Aprisma Management Technologies, Inc. In the event the government seeks to obtain the software pursuant to standard commercial practice, this software agreement, instead of the noted regulatory clauses, shall control the terms of the government's license. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the licensed software is virus-free. Aprisma has tested its software with current virus-checking technologies. However, because no antivirus system is 100- percent effective, we strongly recommend that you write protect the licensed software and verify (with an antivirus system with which you have confidence) that the licensed software, prior to installation, is virus-free. Contact Information Aprisma Management Technologies, Inc., 273 Corporate Drive, Portsmouth, NH USA Phone: U.S. toll-free: Web site:

3 Contents Preface Chapter 1: Alarm Manager and Enterprise Alarm Manager Introduction Overview Accessing AM and EAM within SpectroGRAPH Accessing alarms for specific models Chapter 2: Managing Alarms With EAM EAM Main window EAM menus Keyboard accelerators EAM Toolbar Shrinking the main window Alarm information panel Alarm List Stale alarms Local Filter/Search area Filter log area Alarm count panel Connection Status information Application Scope Impact Scope view Device Criticality Filtering alarms Primary and secondary alarms Filter dialog box buttons Using the Advanced Filter Local Filter/Search area Sorting alarms How sorting arranges the Alarm List Changing column order Changing column size Clearing alarms Acknowledging alarms Setting alarm status Creating device/model notes Mailing alarm information

4 Contents Assigning alarms to troubleshooters Troubleshooter notification Unassigning alarms Creating troubleshooters Deleting troubleshooters Setting preferences Alarm sounds Customizing the sound files Iconified EAM Chapter 3: Custom Scripts and Applications Introduction Access tags Truncated and untruncated tags Index Enterprise Alarm Manager User Guide

5 Preface This guide is intended for network operations personnel who will use SPECTRUM Enterprise Alarm Manager to manage alarms. What is in this book This guide contains the following chapters: Chapter 1: Alarm Manager and Enterprise Alarm Manager - This chapter details how to use Alarm Manager and Enterprise Alarm Manager in conjunction with SpectroGRAPH. Chapter 2: Managing Alarms with EAM - This chapter describes EAM s Main window and details how to use the application s features for managing alarms. Chapter 3: Custom Scripts and Applications - This chapter provides information on how to run scripts to customize certain aspects of EAM. Text conventions The following text conventions are used in this document: Element Convention Used Example Variables (The user supplies a value for the variable.) The directory where you installed SPECTRUM (The user supplies a value for the variable.) Courier and Italic in angle brackets (<>) <$SPECROOT> Type the following: DISPLAY=<workstation name>:0.0 export display Navigate to: <$SPECROOT>/app-defaults Solaris and Windows directory paths Unless otherwise noted, directory paths are common to both operating systems, with the exception that slashes (/) should be used in Solaris paths, and backslashes (\) should be used in Windows paths. <$SPECROOT>/app-defaults on Solaris is equivalent to <$SPECROOT>\app-defaults on Windows. 5

6 Element Convention Used Example On-screen text Courier The following line displays: path= /audit User-typed text Courier Type the following path name: C:\ABC\lib\db Cross-references References to SPECTRUM documents (title and document number) Functionality enabled by SPECTRUM Alarm Notification Manager (SANM) Underlined and hypertextblue Italic SANM in brackets []. See Document feedback on page 6. SPECTRUM Installation Guide (0675) [SANM] AGE_FIELD_ID Document feedback Please send feedback regarding SPECTRUM documents to the following address: Thank you for helping us improve our documentation. Online documents SPECTRUM documents are available online at: Check this site for the latest updates and additions. 6

7 Chapter 1: Alarm Manager and Enterprise Alarm Manager This chapter details how to use Alarm Manager and Enterprise Alarm Manager in conjunction with SpectroGRAPH. Introduction Two programs for managing alarms are available in SPECTRUM: Alarm Manager (AM) provides a list of current network alarms and allows you to manage alarms in a non-distributed environment (composed of a single landscape managed by a single SpectroSERVER.) Enterprise Alarm Manager (EAM) provides a list of current network alarms and allows you to manage alarms in a distributed environment (composed of multiple unique landscapes each with its own SpectroSERVER, and having the capability to access information from more than one SpectroSERVER at a time.) In a distributed environment, the Enterprise Alarm Manager works the same as the Alarm Manager, but shows alarms for all landscapes. This guide focuses on the EAM since AM operates similarly to EAM. Be aware, however, that because AM does not include the distributed functionality that EAM does, all references to landscapes and distributed environments do not apply to discussions of AM. Both AM and EAM can run with a locally installed SpectroSERVER or a remote SpectroSERVER. AM can be used with or without SpectroGRAPH; however, if SpectroGRAPH is not used, related SpectroGRAPH views (Performance, Information, etc.) are not available. Overview AM and EAM provide the user with a dynamic view of SpectroSERVER alarms. If your network is modeled using a distributed SpectroSERVER, you may have several landscape icons in SpectroGRAPH, each representing its own SpectroSERVER. You can opt to view all or some of these landscapes in EAM. AM and EAM allow you to: 7

8 Chapter 1: Alarm Manager and Enterprise Alarm Manager Mail alarm information present in the information panel to specified recipient(s). View and select multiple alarms, which allows for a quicker resolution of alarms. Take an action on an alarm or a set of alarms. Possible actions are: Assign and Unassign a troubleshooter Clear alarms Acknowledge and Unacknowledge alarms Set Status of alarms Set Trouble Ticket ID on alarms View alarms in a hierarchical manner (for example, all alarms that occur under a LAN). Establish the criteria by which the list of alarms is filtered and displayed. You can filter alarms according to: Model Type, Model, Landscape (EAM only), Date/Time, Address, Model Class, Severity, Cause, Assignment, and State. Establish the criteria by which alarms are ordered. You can sort alarms by any of the column headings (Severity, Date/Time, Model Type, etc.) and by two different methods (from the Sort dialog box or by clicking directly on the Alarm List column headings). Operate in a distributed environment with simultaneous viewing of alarms across multiple landscapes (EAM only). Accessing AM and EAM within SpectroGRAPH The different methods that you can use to launch AM or EAM are described below. Depending on the method that you use, all of the alarms in your environment will be shown or alarms for specific models will be shown. Method 1: From the SpectroGRAPH menu, select Tools > Alarm Manager. This method will launch AM/EAM showing all alarms in your environment. If you are using EAM, all alarms will be shown for all the landscapes that you have configured EAM to connect to. Note: The first time EAM is run, it only connects to the default landscape. To connect to more landscapes choose View > Filter from the EAM Main window to open the Filter dialog box, then click on the Landscape tab and move the desired landscapes from the Hide list to the Show list. See Setting preferences on page 48. Method 2: From the SpectroGRAPH toolbar, select the Model Alarms button. Method 3: From the SpectroGRAPH menu, select View > Icon Subviews > Model Alarms. Method 4: Right click in the Topology view and choose Model Alarms from the resulting menu. If you use method 2, 3, or 4 with one or more models selected (use the Shift key to select multiple models), only the alarms applicable to those selected models will be shown. Any saved landscape and/or model filter preferences will not be used. Instead, the alarms shown will be filtered by the current landscape and selected models. 8 Enterprise Alarm Manager User Guide

9 Accessing alarms for specific models If you use method 2, 3, or 4 with no models selected, the alarms applicable to the Universe model will be displayed. As above, any saved landscape and/or model filter preferences will not be used. Instead, the current landscape and Universe model will be used for the filter. See Accessing alarms for specific models on page 9 for more information. Accessing alarms for specific models When you bring up AM/EAM against one or more models, only alarms that have been generated against those models will be displayed. If any of the selected models are container models (LAN_802_3, Landscape, IPClassB, etc.), all alarms that have been generated against devices contained within the container model will also be displayed. Note: When you access AM/EAM against a specific model, you will not see alarms associated with devices that are connected to the selected model (as opposed to contained within the model). If the selected model contains another model that is itself a container, you will see the devices within that container model as well. When you launch AM/EAM against one or more models, SPECTRUM displays the Application Scope dialog box. This dialog box indicates that the application was brought up on one or more selected models, and therefore only displays information on those selected models. You can prevent the Application Scope dialog box from being automatically displayed by deselecting the Show this dialog at startup button at the bottom of the dialog box. The dialog box can be redisplayed by selecting View > Application Scope from the AM/EAM Main window or by clicking the Application Scope dialog box icon at the bottom right corner of the AM/EAM Main window. The menu option and dialog box icon only appear when AM/EAM is launched against one or more specific models. When AM/EAM is launched against one or more specific models, the Shown Models filter label (located beneath the Filtered by: field at the bottom left of the Alarm List) shows which model the alarms are being displayed for. For example: Shown Models: east-coast (Landscape) indicates EAM was launched against the Landscape model east-coast. Shown Models: (HubCSIEMME), SSR250 (Generic_SSR_FP) indicates EAM was launched against an EMME hub and a SmartSwitch router and is displaying alarms as they pertain only to these two devices. Enterprise Alarm Manager User Guide 9

10 Chapter 1: Alarm Manager and Enterprise Alarm Manager 10 Enterprise Alarm Manager User Guide

11 Chapter 2: Managing Alarms With EAM This chapter describes EAM s Main window and details how to use the application s features for managing alarms. EAM Main window The EAM Main window contains the following areas: Menu and Toolbars drop down menus and icons to perform actions Alarm Information panel displays detailed information on the selected alarm. Alarm List displays a list of current, non-filtered alarms. Alarm Count panel displays the totals for the alarms currently displayed in the Alarm List. Note: By default, EAM only displays the most severe alarms occurring on a device; secondary alarms are suppressed. To display all alarms on a device, select View > Filter and then click the State tab. In the Primary/Secondary State box, select the Primary and Secondary button to turn it off; see Primary and secondary alarms on page 34. Figure 2-1 on page 12 shows an example of an EAM Main window. 11

12 Chapter 2: Managing Alarms With EAM Figure 2-1: EAM Main Window A When an alarm occurs, it is added to the EAM Alarm List if it meets the filtering criteria. The related alarm information is recorded in the Event Log. An alarm is removed from the list when the condition causing it is cleared. Click an alarm in any column of the Alarm List to display detailed information for that alarm in the Alarm Information panel. Figure 2-2 on page 21 shows the Alarm Information panel; Figure 2-3 on page 25 shows the main Alarm List; Figure 2-4 on page 28 shows the Alarm Count panel. See Changing column size on page 41 to adjust column size. The Alarm List can be scrolled to the right and left using the scroll bar at the bottom of the panel. EAM menus Options available from EAM menus are described in the following paragraphs. File This menu lets you mail selected items, print and exit from EAM; see Table 2-1. Table 2-1: File Menu Mail Selected Items... Opens the Mail Selected Items dialog box, which enables you to send the alarm information contained in the Alarm Information Panel to the specified recipient(s). 12 Enterprise Alarm Manager User Guide

13 EAM Main window Table 2-1: File Menu Print Close Page Setup Displays the Print Page Setup dialog box where you can set printing options. Window Displays the Print Window dialog box where you can set print range, destination, and number of copies for printing the EAM main window. Print Selected Displays the Print Selected Data dialog box where you can set print range, destination, and number of copies for printing the selected alarms. Print All Displays the Print All Data dialog box where you can set print range, destination, and number of copies for printing all displayed alarms. Print to Text File Displays the Print to Text File dialog box. To print to a text file: Select the data you wish to print. Choose to save the selected data in either Tabular or Non Tabular format (choose tabular format to create a file to import into a spreadsheet). Enter the path and filename for the text file and click OK to save. Exits the EAM application. View This menu lets you choose specific viewing preferences and provides access to three dialog boxes; see Table 2-2. Table 2-2: View Menu Show Toolbar Show Toolbar Labels Show Tool Tips Show Status Help Application Scope Connection Status Show Filter/Search Panel Show Alarm Information Toggles on and off the toolbar at the top of the Information panel Toggles on and off the toolbar labels beneath each toolbar icon Toggles on and off the toolbar icon descriptions Toggles on and off status help in the status bar This is only available if EAM was brought up against a specific model through the Icon Subviews menu. (This dialog box can also be accessed by clicking the Application Scope icon in the bottom right corner of the EAM window.) Displays the Connection Status dialog box, which shows the connection status and type of service of all servers accessible by Alarm Manager. (This dialog box can also be accessed by clicking the Servers icon in the bottom right corner of the EAM window.) Toggles on and off the Filter/Search buttons and their associated text boxes Toggles on and off the Alarm Information panel at the top of the EAM window Enterprise Alarm Manager User Guide 13

14 Chapter 2: Managing Alarms With EAM Table 2-2: View Menu (Continued) Show Alarm Counts Hide Selected Alarms Show Hidden Alarms Filter Sort Column Order Impact Scope Toggles on and off the Alarm Counts Panel at the bottom of the EAM window Hides (temporarily filters out) the selected alarms in the Alarm List. This can be done for multiple alarms. Redisplays all alarms hidden by the Hide Selected Alarms method. Displays the Filter dialog box where you can choose which alarms to display or hide using filter configuration panels: Model Type, Model, Landscape, Date/Time, Address, Model Class, Severity, Cause, Assignment, and State. Displays the Sort dialog box where you can choose to sort the Alarm List by one, two, or three columns (the primary, secondary, and tertiary sort order) and, for each of those columns, whether the sort order is ascending or descending. Displays the Column Order dialog box where you can rearrange column order and choose which columns to hide or show. Displays the Impact Scope view where you can determine which devices are affected by a critical alarm. Additionally, the display contains the user defined device criticality. See Impact Scope view on page 29 for more information. Model This menu is applies to the last selected or currently displayed device. It is the same as the Icon Subviews menu. The Icon Subviews menu may also be accessed by clicking the right mouse button in the EAM window or on the model icon; see Table 2-3. Table 2-3: Model Menu Navigate Model Alarms Performance Notes Lets you Navigate In or Navigate Up to SpectroGRAPH views, (for example, Topology, Device Topology, and Location). Opens the Alarm View for the selected (highlighted) model only. This is the same as starting EAM through Icon Subviews > Model Alarms. The Application Scope dialog box displays when accessing the Alarm View this way. Displays the SpectroGRAPH Performance view for the model highlighted in the Alarm List. Opens the Notes dialog box where you can write notes about the model/device and send the notes through . Notes are displayed in the Model/Device Notes tab of the Information Panel. 14 Enterprise Alarm Manager User Guide

15 EAM Main window Table 2-3: Model Menu (Continued) Various SpectroGRAPH menu selections These menu choices vary depending on the selected model. Most of these views can only be accessed if SpectroGRAPH is running (Notes and Acknowledge menu picks can be accessed without SpectroGRAPH). Note that this same menu (the Icon Subviews menu) can be accessed by a right-click from anywhere within EAM window and differs from the Model menu only by having a Close Window selection which, if selected, closes EAM. Alarms This menu applies to all the currently selected alarms and provides several selections to manage these alarms; see Table 2-4. Table 2-4: Alarms Menu Select All Acknowledge Unacknowledge Set Status Set Trouble Ticket ID Clear Selects all alarms in the Alarm List for performing actions: Assign troubleshooter, Unassign troubleshooter, Clear alarms, Acknowledge alarms, and Set Status of alarms. Acknowledges an alarm. When acknowledged, a checkmark appears in the Acknowledged column. This is useful for distinguishing specific alarms as distinct from new alarms that automatically appear in the Alarm List. Unacknowledges an acknowledged alarm. Displays the Set Status dialog box for the selected alarm. If more than one alarm is selected, the dialog box will not contain any text. Enter status information, including device and alarm history, for the selected alarm. If more than one alarm is selected, you can choose to append the information entered in the dialog box to the Alarm Status for each alarm selected. This text appears in the Information Panel s Alarm Status tab. Displays the Set Trouble Ticket ID dialog box for the selected alarm. If more than one alarm is selected, the dialog box will not contain any text. Enter the desired information for the selected alarm. If more than one alarm is selected, you can choose to append the information entered in the dialog box to the Trouble Ticket ID for each alarm selected. This text appears in the Information Panel s Trouble Ticket ID tab. Displays the Confirm Clear dialog box. Click OK to clear the selected alarms. A checkmark in the Clearable column designates an alarm that can be cleared. If an alarm cannot be cleared, an error dialog box appears. Troubleshooter This menu provides selections for managing troubleshooters and getting detailed information on troubleshooter assignments; see Table 2-5 on page 16. Enterprise Alarm Manager User Guide 15

16 Chapter 2: Managing Alarms With EAM Table 2-5: Troubleshooter Menu Assign Unassign Information Create Delete When only one troubleshooter is created, clicking Assign Troubleshooter directly assigns the troubleshooter and no dialog box appears. If more than one troubleshooter is created, clicking Assign Troubleshooter displays the Assign dialog box listing all available troubleshooter names and addresses for the landscape on which the alarm was generated. When you select a troubleshooter and click OK, the selected troubleshooter is assigned to the selected alarms. Displays the Confirm Unassign dialog box. Click OK to unassign the troubleshooter from the selected alarms. Displays the Information dialog box, which identifies each troubleshooter assignment, including Model Name, Model Type, and Alarm ID. The dialog box also shows the address and total number of assignments per troubleshooter, and allows the name and address fields to be modified. Displays the Create dialog box. This lets you create a troubleshooter and enter an (optional) address. Only users with write privileges can create troubleshooters. The troubleshooter is created for the default landscape. In a distributed environment the troubleshooter is created for the landscape selected by the user. Displays the Delete dialog box listing all available troubleshooter names and addresses for the landscape currently selected. This lets you delete one or more troubleshooters. Options This menu lets you customize certain aspects of the EAM; see Table 2-6. Table 2-6: Options Menu Preferences Clear User Preferences Clear Group Preferences Sound Auto Raise Displays the Preferences dialog box where you can set/ save preferences for customizing EAM to best suit your needs. This clears all user changes, including filter, sort, column order, and preference changes. This clears all group preferences, including filter, sort, column order, and preference changes. This option only appears if the user currently logged in is part of a group and has ADMIN privileges for that group. See Security and User Maintenance (2602) for more information. Toggles the alarm sound on and off. If on, an audible sound indicates the alarm severity each time a new alarm is generated. Sounds can be selected through the Notification tab in the Preferences dialog box. Toggles the Auto Raise feature on and off. If on, the EAM window is brought to the front each time a new alarm is generated. Also, if the EAM window is minimized, it is automatically maximized and brought to the foreground. 16 Enterprise Alarm Manager User Guide

17 EAM Main window Table 2-6: Options Menu Set User-Defined Columns... Displays a dialog box where you can create up to three custom columns. Use the Attribute browser to select the desired model type attribute. List attributes (those attributes containing a list of attributes) and Security attributes may not be displayed in the table. Attributes are displayed on a per-model type basis and many attributes are not common to all model types. See SPECTRUM Views (2517) and Model Type Editor User s Guide (0659) for more information. The Attribute Name is automatically entered as the name for the new column. Select the text in the Column Name field and enter another name, if desired. If the attribute type value is an octet string, the Display octet value as text string option can be selected by clicking the button to its down position. Note that you must shutdown and then restart EAM to display the new column(s). Once EAM is restarted, to view the new column(s), the column names must be moved from the hidden list to the shown list; then order the column names as desired. Help Note: The attribute selected for the user-defined column must be different from existing columns in the Alarm List. If a duplicate column is created, an error message appears and the Set User-Defined Columns dialog box reappears when you click OK to acknowledge the error message. Likewise, the column label must be unique; if a duplicate label is entered, an error message appears. User-defined columns are best suited for static/unchanging values, because the additional attribute information is only read once when the alarm is created. For example, sysuptime (as a column) would quickly indicate inaccurate information since the up-time is continually changing and the displayed value is not. Also, user-defined attribute values are simply converted to a string and not reformatted. For example, sysuptime would be displayed as a large number and not formatted into days/hours/ minutes/seconds. This menu provides selections on various help options available in or from the main EAM window; see Table 2-7. Table 2-7: Help Menu What s This? Hints Help Index Help Topics Displays the What s This? help text boxes. When selected, the cursor changes to a question mark. When you click an area of the EAM window, a short description of that area displays. Launches a Web browser and opens the main Hints page with its associated links to other Hints pages. Opens the Help index. Opens the Help table of contents. Enterprise Alarm Manager User Guide 17

18 Chapter 2: Managing Alarms With EAM Table 2-7: Help Menu (Continued) About Enterprise Alarm Manager Online Manuals Displays a dialog box with information about this version of EAM. Accesses the SPECTRUM online documentation (SPECTRUM Documentation CD must be installed). Keyboard accelerators You can also use the keyboard to open certain dialog boxes and perform certain alarm actions; see Table 2-8. Table 2-8: Keyboard Accelerators Accelerator Menu selection Function Ctrl+J File > Mail Selected Items... Opens the Mail Selected Items dialog box, which enables you to send the alarm information contained in the Alarm Information Panel to the specified recipient(s). Alt+F4 File > Close Closes the EAM window. Ctrl+F View > Filter... Opens the Filter dialog box, which enables you to filter alarms. Ctrl+S View > Sort... Opens the Sort dialog box, which enables you to sort alarms. Ctrl+O View > Column Order... Opens the Column Order dialog box, which enables you to show/hide and order the columns in the Alarm List. Ctrl+A Alarms > Select All Selects (highlights) all alarms in the Alarm List. This is used to perform an action on all alarms in the Alarm List (for example, clear all alarms, acknowledge all alarms, etc.) Ctrl+K Alarms > Acknowledge Acknowledges the selected alarm(s) and puts a checkmark in the Acknowledged column. Ctrl+R Alarms > Unacknowledge Unacknowledges the selected alarm(s) and removes the checkmark from the Acknowledged column. 18 Enterprise Alarm Manager User Guide

19 EAM Main window Table 2-8: Keyboard Accelerators Accelerator Menu selection Function Ctrl+T Alarms > Set Status Opens the Set Status dialog box where you can enter status information (including device and alarm history) for the selected alarm. This text appears in the Information Panel s Alarm Status tab where you can enter unique text to describe the alarm. If more than one alarm is selected, the dialog box will not contain any information. You can select to append the information to the existing status information for each of the selected alarms. Ctrl+B Alarms > Set Trouble Ticket ID Opens the Set Trouble Ticket ID dialog box. Displays the user-created identification used to track a trouble ticket on an alarm. If more than one alarm is selected, the dialog box will not contain any information. You can select to append the information to the existing trouble ticket ID information for each of the selected alarms. Ctrl+L Alarms > Clear Displays the Confirm Clear dialog box. If any of the selected alarm(s), are unclearable, an error message appears. Ctrl+G Troubleshooter > Assign Opens the Assign Troubleshooter dialog box, which enables you to assign a troubleshooter to a selected alarm. If only one troubleshooter is created, it directly assigns that troubleshooter to the selected alarm(s). Ctrl+U Troubleshooter > Unassign Displays the Confirm Unassign dialog box. Ctrl+N Troubleshooter > Information... Opens the Information dialog box, which shows the assignment(s) for each troubleshooter. The dialog box also lets you modify the name and address for each available troubleshooter. Ctrl+P Troubleshooter > Create... Opens the Create dialog box where you can create a troubleshooter and assign an optional address. Only users with write privilege can create troubleshooters. Enterprise Alarm Manager User Guide 19

20 Chapter 2: Managing Alarms With EAM Table 2-8: Keyboard Accelerators Accelerator Menu selection Function Ctrl+D Troubleshooter > Delete Opens the Delete dialog box, which enables you to select one or more troubleshooters to delete. If only one troubleshooter exists, it opens a Confirm Delete dialog box. Ctrl+Y Options > Preferences Opens the Preferences dialog box. EAM Toolbar The toolbar below the menu allows you to access menu choices quickly by clicking a toolbar button; see Table 2-9. Note: When the cursor is positioned over a toolbar button, pop-up text identifying the tool displays. Further descriptive text is provided when you click the What s This? button, and then click a toolbar button. Table 2-9: Toolbar Buttons Button Mail Filter Sort Order Select All Ack Unack Clear Assign Function Opens the Mail Selected Items dialog box, which enables you to mail alarm information to the specified recipient(s). Opens the Filter dialog box, which enables you to filter alarms. Opens the Sort dialog box, which enables you to sort alarms. Opens the Column Order dialog box, which enables you to show/hide and order the columns in the Alarm List. Selects all alarms in the Alarm List. This is used to perform an action on all alarms in the Alarm List (for example, clear all alarms, acknowledge all alarms, etc.). Acknowledges the selected alarm and puts a checkmark in the Acknowledged column. This button is grayed out if the selected alarm is already acknowledged. Unacknowledges the selected alarm and removes the checkmark from the Acknowledged column. This button is grayed out if the selected alarm is not acknowledged. Displays the Confirm Clear dialog box. If any of the selected alarms are unclearable, an error message appears. Displays the Assign troubleshooter dialog box. If there are no troubleshooters created, the Assign action will be disabled. This button is enabled or disabled based on the availability of troubleshooters. 20 Enterprise Alarm Manager User Guide

21 EAM Main window Table 2-9: Toolbar Buttons Unassign Ping Telnet MIB Tools What s This? Hints Displays the Confirm Unassign dialog box. This button is grayed out if the selected alarm does not have a troubleshooter assigned to it. This button is enabled or disabled based on the availability of troubleshooters. Pings the device on which the alarm is occurring. Telnets to the device on which the alarm is occurring. Opens the MIB Tools application. Changes the cursor to a question mark which, when clicked on any area of the Alarm Manager window, displays a short description of the selected area. Launches a Web browser and displays the main Hints page with its associated links to other Hints pages. Shrinking the main window When the main window is shrunk or compressed, menu items still appear. However, toolbar icons become accessible through a new icon that appears with double right-pointing arrows. Click the >> icon to view the additional toolbar icons. Alarm information panel Displays detailed information about the last alarm selected in the Alarm List. If multiple alarms are selected, the information pertains to the last alarm selected. The panel includes a device icon and eight tabbed panels, which are described in Table 2-10 on page 22. Figure 2-2: Alarm Information panel sugar Sun DV System* Probable Cause* Events* History* Alarm Status* Trouble Ticket ID* Location* Device Notes* AUTHORIZATION FAILURE TRAP RECEIVED SYMPTOMS: An authorization Failure trap was received from the device PROBABLE CAUSES: Note: Some probable cause information is requested from the primary landscape (VNM - Virtual Network Machine) and may be undefined for alarms in remote landscapes. To access probable cause information for alarms in remote landscapes, connect EAM directly to the landscape in which the alarm with the missing information is located. If Archive Manager is disconnected through the Control Panel (or is otherwise not operating), alarm events data is unavailable. In this case, the following message appears in the Events tab: An error occurred while retrieving the event information for this alarm. Error: Connection lost (0x ). Enterprise Alarm Manager User Guide 21

22 Chapter 2: Managing Alarms With EAM To correct this, restart Archive Manager from the Control Panel by selecting Control > Start Archive Manager. Table 2-10: Alarm Information Panel Fields Field Device Icon System Tab -System Name -Network Address -IP Address -Description -Contact -Location Probable Cause Tab Description The icon for the device associated with the alarm. Specific areas of the icon are double-click zones that access more detailed views. These zones are identified by the pop-up text boxes that appear when the cursor is positioned over them. The right mouse button activates the Icon Subviews menu from anywhere in the Alarm Information panel. Most of these views can only be accessed if SpectroGRAPH is running (Notes and Acknowledge menu picks can be accessed without SpectroGRAPH). For more information on how to use these views, which include Performance, Configuration, Model Information, Application and others, see SPECTRUM Views (2517). Displays several fields of detailed system information, to include: System Name, Network Address, IP Address, Description, Contact, and Location. The full domain name of the managed node. For example, in "generic" is the name of the managed node (the network device on which the SNMP agent is running), and "company.com" is the domain name. This field is blank if the device is unreachable. The address SPECTRUM is using to talk to the device's SNMP agent. The port address of the interface. This information is only available on interface ports. A written description of the device SPECTRUM is talking to and managing, including system hardware type, and operating and network software. The person to contact when device problems occur. This is specified when the device is created and can be modified in certain SpectroGRAPH views. The physical location of the device that generated the alarm (for example, Facility B, second floor.) The most likely reason(s) the selected alarm was generated. 22 Enterprise Alarm Manager User Guide

23 EAM Main window Table 2-10: Alarm Information Panel Fields Field Events Tab History Tab Alarm Status Tab Trouble Ticket ID Tab Description The event(s) that generated the selected alarm. By default, events are displayed in groups of ten. The event counter at the bottom right of the tab shows the total number of events and the current number displayed. Events are displayed from newest to oldest. Use the Next, Previous, Top, and Bottom buttons to navigate through the events. You can change the default setting by using the Preferences dialog box (Options > Preferences > Display). If no event(s) caused the alarm, the message There is no event information associated with this alarm. displays. (See page 21.) You can change various default event settings from the VNM icon by selecting Icon Subviews > Configuration > AlarmMgmt. A list of five (default) or fewer historical alarm summaries for the selected model. These summaries provide a record of when alarms were generated and cleared, as well as actions taken on the alarms (status set, troubleshooter assigned, etc.). Use these summaries to compare the currently selected alarm to previous alarms on the same model and with the same probable cause. The most recent alarm appears first in the list. The alarm counter at the bottom right of the tab shows the total number of alarms and the current number displayed. Use the Next, Previous, Top, and Bottom buttons to navigate through the alarm summaries. If more than the last five historical alarm summaries are needed, change the default setting (Maximum Alarm History Count) in the Preferences dialog box (Options > Preferences > Display). To disable Alarm History data, right-click the VNM icon in SpectroGRAPH s Universe Topology view to access the Icon Subview Menu; then choose Configuration > AlarmMgmt and toggle Generate Alarm Events to No. Current administrative status of the device. These usercreated notes can include device and alarm history. This tab is read/write. See Set Status on page 15 for more information. User-created identification used to track trouble tickets on an alarm. This tab is read/write. See Set Trouble Ticket ID on page 15 for more information. Enterprise Alarm Manager User Guide 23

24 Chapter 2: Managing Alarms With EAM Table 2-10: Alarm Information Panel Fields Field Location Tab Device/Model Notes Tab Description Alarm location listed in SpectroGRAPH s hierarchical format. For example, Topological Location: squash of type Landscape ; Universe of type Universe. Buttons for Topological Location, Physical Location, and Organizational Location provide direct access to the associated SpectroGRAPH view (if a SpectroGRAPH connection is established) where the device of the selected alarm is located. These buttons are grayed out if the views are not modeled in SPECTRUM. When you click the Topological Location button in the Location tab, the view (in which the model resides) displays the alarming model highlighted and centered in that view. User-created notes for the device in alarm state. This tab is read/write. The tab varies depending on what is highlighted in the Alarm List. If the selected alarm is on a device with a network address, the tab is for Device Notes; if the selected alarm is on a model with no associated network address (that is, it is a conceptual model such as a User or Landscape), the tab is for Model Notes. The System, Probable Cause, Events, History, and Location tabbed panels and their associated fields are read-only. The Alarm Status, Trouble Ticket ID and Device/Model Notes panels are readwrite. For all panels, an asterisk (*) to the right of the tab name indicates the panel currently contains information. The last tab selected is saved and restored as the front panel when EAM is shutdown and restarted. Alarm List The Alarm List displays all alarms that fit the current filtering criteria. Table 2-11 on page 25 describes the default column settings shown at startup. Table 2-12 on page 26 describes the columns that are hidden at startup. 24 Enterprise Alarm Manager User Guide

25 EAM Main window Figure 2-3: Alarm List Severity Date/Time Model Name Network Addr Impact Sever Manufactur Model Class Model Type Maint... Critical Critical Critical Critical Critical Mon 1 Oct :17:06 Mon 1 Oct :47:23 Mon 1 Oct :46:14 Mon 1 Oct :45:30 Mon 1 Oct :45:27 Mon 1 Oct :45: Fault Isolation Enterasys Netw Enterasys Netw Enterasys Netw Enterasys Netw Enterasys Netw HUB NODE BRIDGE APPLICATION BRIDGE NODE Hub CSI_IRM HSI_W6 HubCSIEMME FaultIsolation 6H202_24 Xyl_CSMIMII Critical Critical Minor Sun 30 Sep :36: Sun 30 Sep :36: Sun 30 Sep :36: Enterasys Netw LINK LINK CHASSIS WA_Link WA_Link HubSyn5xxx Search Shown Prev Next Filtered by Landscape Displayed 9 of 9 Maintenance 1 Critical: 7 Major 0 Minor 1 Total 9 Servers Table 2-11: Column Settings at Startup Column Severity Date/Time Model Name Network Address Impact Severity Manufacturer Model Class Device Type Model Type Acknowledged Probable Cause Title Definition The color-coded severity of the alarm, both graphically (colored bells or blocks of color) and with text. The exact moment the alarm was generated. The model name of the device on which the alarm is occurring. The address of the device on which the alarm is occurring. The relative importance of this device to the network. (Device Criticality of the alarm plus Device Criticality of all its downstream neighbors.) The Impact Severity value is limited to the MAX_ULONG value set on the SpectroSERVER. The Impact Severity value of an alarm is calculated when the alarm is generated. This value is not updated when the device criticality of a specific impacted object is updated. The manufacturer of the device. The type of device the model represents (for example, bridge, router, hub, etc.) The value of the DeviceType attribute, which is used to identify the type of device based on the device s System Object ID. The Device Type can be set using the Device Type Identification Application. See the Modeling with the GnSNMPDev Toolkit (1316) guide for instructions. The SPECTRUM model on which the alarm is occurring. The acknowledged state of the alarm. An acknowledged alarm is indicated with a check mark in this column. The first line of the probable cause text. Enterprise Alarm Manager User Guide 25

26 Chapter 2: Managing Alarms With EAM Table 2-11: Column Settings at Startup (Continued) Column Assignment Clearable Landscape Definition The name of the troubleshooter assigned to the alarm. See Assigning alarms to troubleshooters on page 44. The clearable status of the alarm. Alarms with an X in this column can be cleared, those without an X cannot be cleared. The landscape on which the alarm occurred (EAM only.) Table 2-12: Columns Hidden at Startup Column MAC Address Contact Device Location Occurrences Secondary Status Trouble Ticket ID Alarm ID Probable Cause ID Stale Definition The hard-coded physical address of the device. The person to contact when device problems occur. The physical location of the device, (for example, telephone closet, first floor.) The number of times that the event that generated the alarm has occurred since the alarm was asserted. When an alarm is generated, the occurrences count is set to 1. Each time the event that created the alarm is generated while the alarm is still active, the occurrences will be incremented. If the alarm is cleared, and then the event is generated again so that a new alarm is generated, the occurrences will be set to 1. An X denotes that this alarm is secondary to more severe primary alarms on this model. The user-defined status (if any has been entered) of the alarm. The user-created identification used to track a trouble ticket if any exists on the alarm. The alarm's unique number identification, which is maintained even if the SpectroSERVER is shut down. The system-generated ID for the alarm's probable cause (for example, 0x is the ID for the probable cause "Device has stopped responding to polls. ) A checkmark denotes an alarm that existed before the SpectroSERVER shutdown is now "residual," and may need to be cleared; see Filter dialog box buttons on page 35. Stale alarms When the SpectroSERVER shuts down and is then brought back up, alarms that existed prior to shutdown are re-displayed in the Alarm List. This persistent alarm feature enables SPECTRUM to retain alarm-related information (troubleshooter assignments, status, etc.) when the server goes down. 26 Enterprise Alarm Manager User Guide

27 EAM Main window In some cases, the underlying cause of an alarm gets resolved between server shutdown and restart, but the alarm still displays in the Alarm List. These alarms are considered to be stale and can be cleared. Stale alarms, also referred to as residual alarms within SPECTRUM, can always be cleared by the user. Stale alarms are identified by a checkmark in the Alarm List Stale column, which is hidden by default. To display the Stale column: 1. Select View > Column Order to open the Column Order dialog box. 2. In the Hidden list, click Stale to highlight it. 3. Click the left arrow or double-click the highlighted name to move it to the Show list. 4. Click OK to apply your changes, or Cancel to close the dialog box with no changes. Local Filter/Search area Below the Alarm List s scroll bar is the local Filter/Search area. This area displays four buttons and a text field that are used for local filtering and searching of alarms in the alarm list. Search Toggles between filter and search functions; the default is Search. Shown Specifies which column to filter/search in; the default is Shown. Prev Finds the previous entry matching the search criteria. (Enabled only when the search option is selected.) Next Finds the next entry matching the search criteria. (Enabled only when the search option is selected.) Filter log area Below the Search and Shown buttons is the Filter log area where the current filter settings are displayed. For Show/Hide list type filters, the Filtered by: field lists up to three items. If there are more than three items, the list is abbreviated with an ellipsis, for example, Model Type (Show Pingable, VNM, User,...). Probable causes are abbreviated after two items, for example, Probable Cause (Hide DUPLICATE MODEL, OUT OF MEMORY,...). Alarm count panel Displays the number of each alarm type displayed in the Alarm List and gives a total for all alarms. For consistency, the alarm severities are displayed in the color code used throughout SPECTRUM. Enterprise Alarm Manager User Guide 27

28 Chapter 2: Managing Alarms With EAM Figure 2-4: Alarm Count panel Note: In some cases, the alarm count total will not match the number of items displayed in the Alarm List. This occurs when a server that has alarms displayed in the list is shut down and filter settings are changed to filter out certain alarms. The Alarm List does not update with the changes relative to the down server until that server is restarted, but the alarm counts total displays the correct number based on current filter settings. Initial and Suppressed alarms are Disabled by default and are not displayed in the Alarm List. Maintenance, Major, Critical, and Minor alarms are enabled by default and appear in the Alarm List. Any severity that is enabled through the VNM, but is hidden in the filter dialog, is shown grayed out in the Alarm Count Panel. Displaying alarm severities 1. Open the SpectroGRAPH Universe Topology view and highlight the VNM icon. 2. Select View > Icon Subviews > Configuration to open the Landscape Configuration view. 3. Select AlarmMgmt from the Configure/Information panel list; then click OK to open the Alarm Management Model Information view. 4. In the Alarm Management Options field, toggle the Disable <severity> Alarms button to Yes. For example, to disable Maintenance alarms, set the Disable Maintenance Alarms toggle to Yes. 5. Select File > Save All Changes to close the Alarm Management Model Information view. If you have Enabled Initial and Suppressed alarms in the Alarm Management Model Information view, you can make them appear in the Alarm List by doing the following: 1. From the Alarm Manager Main window, select View > Filter to open the Filter dialog box. 2. Click the Severity tab and move Initial and Suppressed severities from the Hide list to the Show list by clicking the left-pointing double arrow. This displays Initial and Suppressed severity alarms in the Alarm List. However, only the Initial and Suppressed severity alarms generated after the setting change appear in the Alarm List. Severity Color Definition Table 2-13: Severity Colors Initial Blue Contact with device is not established. Suppressed Gray Device cannot be reached due to a known error condition that exists on another device. Maintenance Brown Device is off line for maintenance purposes. Critical Red A loss of service has occurred; immediate action is required. 28 Enterprise Alarm Manager User Guide

29 Impact Scope view Severity Color Definition Table 2-13: Severity Colors (Continued) Major Orange A loss of service has occurred (or is impending); action is required within a short period of time. Minor Yellow A situation has occurred, but no immediate action is required. This severity is also used for alarms created only to convey information, such as Duplicate IP. Normal Green Contact has been made with the device. Device is operating normally. There are no alarms associated with this device. Total Sum of the alarms for all of the severities not filtered. Connection Status information Clicking the Servers icon at the bottom right corner of the EAM window displays the Connection Status dialog box, which shows the connection status and type of service of all servers accessible by the application. Possible types of service include Events, Alarms, Landscape, and View. The color of the status icon indicates the condition of the connection. Color-coded conditions include green (complete service), yellow (degraded service), and red (total loss of service). The Connection Log gives date/time information and status messages for the selected service in the dialog box. Possible messages include Connection lost, and Connection re-established. Application Scope If you start EAM by right-clicking on a specific model (Icon Subviews > Model Alarms), the Application Scope dialog box displays. This dialog alerts you that EAM was brought up on one or more selected models and that information is available only for those models and any models they might contain. For example, if you bring up EAM against a LAN model that contains other models, the alarms for that LAN and all the models it has within it display in the Alarm List. See Accessing alarms for specific models on page 9 for more information on bringing up EAM against specific models, accessing the Application Scope dialog box, and disabling the display of the Application Scope dialog box. Impact Scope view The Impact Scope view lets you view which hidden network-critical devices have gone into a gray, suppressed condition. These devices are the downstream devices directly affected by the selected alarm in the Alarm List. Access the Impact Scope view from the View menu. The level of criticality is arbitrarily set on an individual device basis from the Fault Management view on that device. See How to Manage Your Network in SPECTRUM (1909) for a discussion on the Fault Management view. See Table 2-14 on page 30 for definitions of the icons and columns in the Impact Scope view. Enterprise Alarm Manager User Guide 29

30 Chapter 2: Managing Alarms With EAM Table 2-14: Impact Scope View Window Element Source Destination Impact Type column Application column Source column Destination column Criticality column Description The icon for the source SpectroSERVER that controls this device. The icon for the device with the gray, suppressed condition. The type of condition, such as Contact Lost. The source that generated the gray alarm, such as SpectroSERVER. The source s IP address. The impacted device s IP address. A device s criticality determined by the Device Criticality setting on the Fault Management view (default setting is 1 ). Device Criticality The Criticality value shown on the Impact Scope view (see Figure 2-5 on page 31) is determined by summing the device s value plus the values of all other downstream neighbors associated with that device. The higher the number, the more critical or important the device is to your network. Since this is an arbitrary number, you can assign a high number to the device to signify its relative importance to your network. The Impact Severity column value (shown on the Alarm Manager view) of an alarm signifies the total impact the device has on the network, taking into account its criticality plus the criticality of its downstream neighbors (Impact Severity = Device Criticality of the alarm plus the importance of all its downstream neighbors). The Impact Severity value is limited to the MAX_ULONG value set on the SpectroSERVER. Note: The Impact Severity value of an alarm is calculated when the alarm is generated. This value is not updated when the device criticality of a specific impacted object is updated. 30 Enterprise Alarm Manager User Guide

31 Filtering alarms Figure 2-5: Impact Scope View Impact Scope Impact Scope for of type 6H2002_24 Source Destination Corporate HubCSIEMME VNM Impact Type Application Source Destination Criticality Contact Lost SpectroSERVER Contact Lost SpectroSERVER Contact Lost SpectroSERVER Search Shown Prev Next Displayed 3 of 3 Close Help Filtering alarms You can define which alarms will be displayed by establishing filtering criteria. These filtering subsets make it possible for you to customize EAM to display alarms appropriate to your networking needs. Only those alarms that meet all filtering criteria are displayed. Note: If you change filter settings while a server with displayed alarms is down, the new settings are not applied to the down server. In this case, there may be alarms still displayed in the Alarm List that do not fit your filtering criteria. In addition, if you filter out an alarm severity while a server is down, the alarm count for that severity is grayed out, but the number of alarms remaining in the view is still reported, (that is, the alarm count total includes those alarms on the down server that would otherwise be filtered out). The filter s new settings are applied once the down server re-establishes its connection. Figure 2-6 on page 32 shows the EAM Filter dialog box and its Show/Hide list. Some of the Filter s tabs use the Show/Hide format to choose filtering selections. Enterprise Alarm Manager User Guide 31

32 Chapter 2: Managing Alarms With EAM Figure 2-6: EAM Filter Dialog Box The Filter dialog box displays tabs for setting various types of alarm filters and a variety of buttons to save and reset filter settings; see Table 2-15 and Filter dialog box buttons on page 35. The options available with each filter are retrieved from the database that is being used to model your network. Table 2-15: Filter Tabs Landscape Model Class Device Type Model Type Choose the landscapes you want displayed in the Alarm List and move them to the Show list. By default, only the primary landscape appears in the Show list; all other landscapes are in the Hide list. Choose the model classes you do not want displayed in the Alarm List and move them to the Hide list. Choose the device types you want to display in the Alarm List by typing a string into the Device Type text box and clicking the Add button. You can also click on the Device Type button to choose from a list of currently available Device Types. The default setting is Show Device Types. You can toggle this button to Hide Device Types and exclude your selected Device Types (s) from the Alarm List. Move the model type(s) that you do not want to view alarms for to the Hide list. 32 Enterprise Alarm Manager User Guide

33 Filtering alarms Table 2-15: Filter Tabs (Continued) Model Address Date/Time Severity Cause Assignment State Choose the models you want to display (or not display by toggling Show to Hide) in the Alarm List by typing a string into the Model Name text box. If the EAM is brought up against a specific model, (that is, Icon Subviews > Model Alarms), the Model List contains only that model and any models contained within that model. When more than 20 models are found in a search, a confirmation dialog box displays. If EAM is brought up with Tools > Alarm Manager, the Model List is empty (unless changes were made to the Model filter and saved using the Make Changes Permanent button in a previous EAM session). The default setting is Show Models. You can toggle this button to Hide Models and exclude your selected model(s) from the Alarm List. The default setting is to find an exact match for your selected model name string. Toggle this button to search on a Substring, Prefix, or Suffix, (for example, "mod", "gen", or "del" will locate generic_model ). The number of models that are added to the Model List is limited to 1000 by default (Max Model Filter Request). You can change the default number by selecting Options -> Preferences -> Filter. Choose the devices you want to display in the Alarm List by designating either a list of network address ranges or a list of specific network addresses. To specify a range, enter an address in the From text box, and a different, higher address in the To text box. To specify a specific address, enter an address in either the From or To text box. If you do not want to display the network address in the Alarm List, toggle Show Network Address to Hide Network Address. Choose the date and time range that you want to view alarms for. You need to designate the Start Time and End Time. Choose the alarm severities that you want to show or hide by moving them to the appropriate list. Critical, Major, and Minor alarms are shown by default. The Maintenance alarm severity is in the Hide column. Initial and Suppressed alarms are not generated (enabled) by default; see Displaying alarm severities on page 28. Choose the probable cause messages that you do not want to view alarms for; then move them to the Hide list. The first time the filter dialog box opens, all available probable causes are loaded, which can take some time. A list of all available troubleshooters from all the landscapes currently attached to is displayed. Click on the troubleshooters that you do not want to view alarms for; then move them to the Hide list. By default, Unassigned appears in the Show list. If you want to filter out all unassigned alarms from the Alarm List, move the Unassigned entry into the Hide list. Choose the states you want displayed in the alarm list by selecting or deselecting them. States are grouped by Acknowledge State (Acknowledge and Not Acknowledged), Clearable State (Clearable and Not Clearable, and Primary/Secondary State (Primary/Secondary and Primary Only). Enterprise Alarm Manager User Guide 33

34 Chapter 2: Managing Alarms With EAM Table 2-15: Filter Tabs (Continued) Attribute Choose the attribute ID that you want to filter on by clicking the Attribute ID button and selecting the appropriate attribute. The ID number will automatically be written to the text field next to the button. Next, choose the Comparison Type. This allows you to select how to compare the value of the attribute ID with the value in the Attribute Value field. Only the comparison types appropriate to the attribute s data type will be displayed for selection. Choose the Ignore Case selection if you do not want the comparison to be case sensitive. This selection is only enabled when it is appropriate for the attribute s data type. Fill in the Attribute Value field with the value you want to use in the comparison. Note: Model types listed in the Filter dialog box pertain to the primary landscape only, (for example, the VNM connected to at startup). Other landscapes in the primary landscape s map may contain different model types, but these additional model types do not appear in the Model Type list. To access model types on remote servers, designate one modeling catalog as the master containing all needed models, (this is generally the primary landscape or VNM) and copy the master catalog to all remote landscapes; see Distributed SpectroSERVER (2770) for a discussion of the master catalog. Primary and secondary alarms By default, the Alarm List displays only primary, or the most severe, alarms occurring on a device, and secondary alarms are suppressed. Viewing both primary and secondary alarms on a model allows you to see all the alarms on that model rather than just the most severe which may be of help when troubleshooting. For example, a model might have a primary alarm of Contact Lost but the reason for the lost contact, (for example, Device Too Hot, might now be a secondary alarm because lost contact is the more severe condition compared to the device being too hot). Being able to see the underlying secondary alarm would help focus your attention on the device's environmental control systems. To display secondary alarms: 1. Select View > Filter to open the Filter dialog box. 2. Click the State tab. 3. In the Primary/Secondary State field, select the Primary and Secondary button. 4. Click the Make Changes Permanent button if you want your changes to be the new default settings. 5. Click OK to apply your changes. Secondary alarms will now appear in the Alarm List. Note: Only one button at a time can be selected in the Primary/Secondary State field. To view the Secondary Alarms Column: 34 Enterprise Alarm Manager User Guide

35 Filtering alarms 1. Select View > Column Order to open the Column Order dialog box. 2. In the Hidden list, click Secondary. 3. Click the left arrow or double-click the highlighted name to move it from the Hidden list to the Shown list. 4. Click the up arrow to move the column up (to the left in the Alarm List) or to move it down (to the right in the Alarm List). 5. Click OK to apply your changes. For all secondary alarms, a checkmark will appear in the Secondary column. The example below provides a second illustration of the relation between primary and secondary alarms on a device. In this case, one of the alarms has nothing to do with the device itself, but is the result of the creation, within SPECTRUM, of a duplicate model for the device. Occasionally a device for which a SPECTRUM model has already been created, will have a second model created for it. SPECTRUM designates such a second model as a "duplicate" model, and automatically assigns it a Minor (yellow) Duplicate Model alarm, meaning that it will appear in the Alarm Manager's main Alarm List. If the device itself subsequently generates a more severe alarm, for example, a Critical (red) Contact Lost alarm, this alarm will become the primary alarm and the Duplicate Model alarm will become secondary because the most severe alarm is always designated the primary alarm. Filter dialog box buttons The Filter dialog buttons are: Resets only the selected tab to the settings last saved by Make Changes Permanent, or those at startup. Clears only the selected tab. Make Changes Permanent When used with the OK button, saves any new filter settings. These settings will be retained even if the EAM is shutdown and restarted. If the current user is part of a group, the settings can be saved for the user only or for the group. The options To user and To user group become accessible when the Make Changes Permanent button is clicked.. Reset Page Clear Page Note: For more information on user and group options, refer to Security and User Maintenance (2602). OK Applies the new settings for the current EAM session only (unless the Make Changes Permanent button is selected) and closes the dialog box. Cancel Enterprise Alarm Manager User Guide 35

36 Chapter 2: Managing Alarms With EAM Closes the dialog box and cancels any changes in the settings. Reset All Resets all tabs to the settings last saved by Make Changes Permanent, or those at startup, and leaves the dialog box open. Clear All Clears all tabs and leaves the dialog box open. If you click OK, all alarms are displayed in the Alarm List because no filters are set. What s This? Displays help text for a specific area of the screen. The Make Changes Permanent button is used to save the settings you chose in any of the tabs by clicking the button (to the recessed position) and selecting OK from the dialog buttons. These settings will be retained even if the EAM is shutdown and restarted. If the current user is part of a group, the settings can be saved for the user only or for the group. The options To user and To user group become accessible when the Make Changes Permanent button is clicked. Note: For more information on user and group options, refer to Security and User Maintenance (2602). Using the Advanced Filter The Advanced Filter gives you more flexibility (compared to simple filtering) because it lets you make multiple selections of the types of filters you want to apply. Simple filtering, on the other hand, simply groups all filter selections and applies them in a linear fashion, (for example, Filter by Landscape and Secondary Alarms and Model Type). In simple filtering, all criteria must be met; in advanced filtering, any of the criteria, i.e., entry 1 or entry 2, can be met. Note: You must have at least two entries in the Advanced Filter panel for an advanced filter to be applied and filter the Alarm List in an "either/or" fashion. For example, with advanced filtering, you can choose to display red (Critical) HubCat5000 or yellow (Minor) Pingables. In this case, red (Critical) Pingables will not show up in the Alarm List, nor will yellow (Minor) HubCat5000. With simple filtering, you are not able to make this fine a distinction and you would see all Minor and Critical Pingables and all Minor and Critical HubCat5000. The example below shows you the steps to achieve advanced filtering for the above selections. To filter on Critical HubCat5000 OR Minor Pingables only: 1. In the Filter dialog box, click the Model Type tab and hide all model types except HubCat5000 models by doing the following: a. Move all model types to the Hide table with the double right arrow button. b. Type HubCat5000" into the Filter/Search text box. 36 Enterprise Alarm Manager User Guide

37 Filtering alarms c. Move HubCat5000 into the Show table with the single left arrow button or double-click the entry. 2. Click the Severity tab and move Major and Minor alarms to the Hide list. 3. Click the Advanced button and then the Add button to put your selections in the Advanced Filter panel. The panel will read, "Model Type (Show HubCat5000) AND Severity (Show Critical)". 4. Click the Model Type tab and hide all model types except Pingable. 5. Click the Severity tab and move Major and Critical alarms to the Hide list. 6. Click the Add button to put your selections in the Advanced Filter panel. The panel should read, "OR Model Type (Show Pingable) AND Severity (Show Minor)". 7. Click OK. Local Filter/Search area The local Filter/Search area below the Alarm List allows you to locally filter (i.e., without using the Filter dialog box) and search alarm data using two buttons. The first button allows you to toggle between Filter or Search (the default is Search). The second button allows you to specify which column to filter/search in (Severity, Date/Time, Model Type, etc.); the default setting is Shown, which filters/searches all shown columns for a match (All filters/searches all columns, including those hidden from the list). Figure 2-7 shows the Local Filter/Search Area with the Search button selected. When the Alarm List is filtered using the local filter the changes are temporary and the display will revert to its original state when the text box string is deleted or the EAM is shutdown and restarted. Figure 2-7: Local Filter/Search Area To locally filter the Alarm List using a specified string do the following: 1. Toggle the Filter/Search button to Filter. 2. Enter a string or partial string in the text box at the right of the menu buttons. The list will update to display only those entries that match the string in the specified column (or any shown column if Shown is chosen). To locally filter the Alarm List using a selection list do the following: 1. Toggle the Filter/Search button to Filter. 2. Toggle the Shown button to Acknowledged, Clearable, Secondary, Severity, or Stale. Enterprise Alarm Manager User Guide 37

38 Chapter 2: Managing Alarms With EAM A new selection list button will appear as shown in Figure 2-8. When you click the button, a list of all the available options is displayed. Figure 2-8: Local Filter Selection List 3. Click the selection list button <NONE>, and select the desired severity that you want to filter and show. To search the Alarm List do the following: 1. Toggle the Filter/Search button to Search. 2. Enter a string or partial string in the text box. The first entry matching the string in the specified column (or any shown column if Shown is selected) is highlighted in the Alarm List. The Prev and Next buttons can be used to find the previous or next entries matching the string. Note: The Prev and Next buttons are disabled (grayed out) when the filtering option is selected. The label under the Filter/Search area on the right-hand side displays how many entries are displayed out of the total. Sorting alarms You can modify the EAM to best suit your needs by selecting a column category (Severity, Date/ Time, etc.) by which to sort alarms. You can sort on up to three columns at a time and order alarms in ascending or descending order (i.e., most severe to least severe, newest to oldest, etc.) Sorting alarms can be done by two different methods, using the Sort dialog box or using the column headings in the Alarm Manager Main window. To sort using the Sort dialog box: 1. Select View > Sort or click the Sort button. The Sort dialog box, shown in Figure 2-9 on page 39, appears. 38 Enterprise Alarm Manager User Guide

39 Sorting alarms Figure 2-9: EAM Sort Dialog Box Primary Sort Enterprise Alarm Manager: Sort Secondary Sort Sort By: Severity Descending Tertiary Sort Then By: Date/Time Descending Then By: Alarm ID Descending OK Cancel Reset Clear The Sort By selection sets the primary sort by which the entire list is sorted. The two Then By selections set the secondary and tertiary sort order for the Alarm List. Possible sorting options are: Acknowledged Landscape Probable Cause ID Alarm ID MAC Address Secondary Assignment Manufacturer Severity Clearable Model Class Stale Contact Model Name Status Date/Time Model Type Trouble Ticket ID Device Location Network Address None Firmware_Version_Number Occurrences Impact Severity Probable Cause User-Defined columns Sorting can also be accomplished directly within the Alarm List by doing the following: 1. Click in a column header. This automatically makes the selected column the primary sort as indicated by the small triangle next to the right column separator. Clicking this same column will reverse the sort order and the triangle will invert its position. Ascending and descending order are indicated by a triangle pointing up or down, respectively. 2. Click in another column header. This now becomes the primary sort and shifts the previously selected primary sort to secondary, as indicated by the two triangles next to the column separator. 3. Click in a third column. This becomes the primary sort, the previous primary becomes the secondary, and the previous secondary becomes the tertiary as indicated by three triangles. Enterprise Alarm Manager User Guide 39

40 Chapter 2: Managing Alarms With EAM Each subsequent column header sort will make the current selection the primary sort, the previous primary sort the secondary sort, and the previous secondary sort the tertiary sort. Note: Only three columns can be sorted on at a time. How sorting arranges the Alarm List After you select a column to be the Primary sort order, the Secondary sort is applied when two or more alarms have the same value for the Primary sort field. For example, if the Primary sort is Model Type and the Secondary sort is Date/Time, list entries in the Model Type column are grouped together according to type (e.g., all GnSNMPDev models will be together) and, within this grouping, entries are arranged according to the Date/Time the alarms were generated. If you select a column as the Tertiary sort (e.g., Severity), the models grouped together according to type and date/time generated are further defined and grouped by severity. For example, any GnSNMPDev models generated at the same time and having a severity of Critical are grouped together in their adjacent list columns. Figure 2-10 on page 40 shows how the Alarm List looks when sorted this way. Figure 2-10: Sorted Alarm List Order The secondary sort column organizes the similar model types according to the time alarms were generated, in this case, in descending order. Severity Date/Time Model Type The tertiary sort column further organizes the model types with alarms generated at the same time together. Here, the tertiary sort is by condition, descending order. Minor Tues 27 Jan 12:09:12 GnSNMPDev Critical Tues 27 Jan 12:09:18 GnSNMPDev Minor Tues 27 Jan 12:09:24 GnSNMPDev Critical Fri 30 Jan 13:54:34 GnSNMPDev Minor Mon 02 Feb 10:36:10 GnSNMPDev Critical Mon 02 Feb 10:36:10 GnSNMPDev Critical Mon 02 Feb 10:36:10 GnSNMPDev The primary sort column groups all similar model types. Changing column order You can rearrange, hide or show columns to suit your particular needs. This can be done by using the Column Order dialog box, or directly within the EAM window by dragging and dropping column headers. To reorder columns using the dialog box: 1. Select View > Column Order or click the Column Order icon. This displays the Column Order dialog box, which is comprised of a Shown Order/Hidden list. 2. Select the desired order of columns by highlighting a list entry and clicking the up/down arrows at the bottom of the Show list. (The topmost entry in the Column Order dialog box corresponds to the leftmost column in the Alarm List.) Select any columns you want to show or hide from 40 Enterprise Alarm Manager User Guide

41 Changing column size the Alarm List by moving them to the appropriate Hide/Show list using the left/right arrows, or by double-clicking a list entry. To reorder columns using the mouse cursor (drag and drop): 1. Click the mouse button on a column header and keep it pressed down. 2. Drag the column to a new location using the cursor, which becomes an arrow pointing to a piece of paper. You can scroll past the edge of the window and the Alarm List window will scroll automatically to the left or right. 3. Release the mouse button. Changing column size Column size can be changed by two different methods: Double-click a column header. This will resize the column to the width of the longest text entry, including the header title, or Place the mouse over the column header separators to change the cursor to a left-right arrow, click the mouse button, drag the column header separator to the desired position, and release the mouse button. Clearing alarms You have the option of clearing alarms. Clearable alarms are denoted by a x? mark in the Clearable column of the Alarm List. If an alarm has no check mark, it cannot be cleared and will remain in the Alarm List until the problem that generated the alarm is resolved. A confirmation dialog box is displayed to verify whether or not you want to clear the alarms. Note: If you do not want to be prompted with the confirmation dialog box, you can turn this function off in the Preferences dialog box (Options > Preferences) by clicking the Actions tab and selecting (clicking to the recessed position) the Expert Clear button. To clear alarms: 1. Click an alarm to select it from the Alarm List. Use the Control key to select multiple alarms or choose Alarms > Select All to select all alarms in the Alarm List. When selected, an alarm is highlighted. 2. Select Alarms > Clear, or click the Clear alarms toolbar button. 3. Click OK in the confirmation dialog box. The selected alarms are cleared and removed from the Alarm List, if they were clearable. Note: If any alarms could not be cleared, an error dialog box listing the alarms not cleared will be displayed. Users with view-only access to a model can clear an alarm in the Alarm Manager if the Alarm Clear By Read Only field is toggled to YES. This attribute is found by right-clicking the VNM icon and selecting Configuration. Then double-click AlarmMgmt to display the Alarm Management Model Information View. Enterprise Alarm Manager User Guide 41

42 Chapter 2: Managing Alarms With EAM Acknowledging alarms You have the option of acknowledging alarms. This feature is useful when you assign the responsibility for selected alarms to a troubleshooter and then mark those alarms as acknowledged. When an alarm is acknowledged, a check mark appears in the Acknowledged column of the Alarm List and, if it is the only alarm on the device, the device icon in the Alarm Information panel stops flashing. To acknowledge alarms: 1. Click an alarm to select it from the Alarm List. Use the Control key to select multiple alarms or choose Alarms > Select All to select all alarms in the Alarm List. When selected, an alarm is highlighted. 2. Select Alarms > Acknowledge, or click the Acknowledge alarms button. The alarm is acknowledged as denoted by a check mark in the Acknowledged column. Note: Blue, gray, and brown alarms are acknowledged automatically by SPECTRUM. Also, these alarms never need to be assigned to a troubleshooter because they represent the state of a particular model and not an actual alarm. That is, an Initial (blue) alarm simply indicates that contact with the device has not yet been established. If contact is made, the alarm will go away. (see Severity Colors on page 28) Setting alarm status EAM includes an option for setting the administrative status for any alarm or set of alarms. This repair management feature of the EAM can be an aid in alarm management and report generation. When setting the status of selected alarms, you are prompted for new status text. To set the status of selected alarms: 1. Click an alarm to select it from the Alarm List. Use the Control key to select multiple alarms or choose Alarms > Select All to select all alarms in the Alarm List. When selected, an alarm is highlighted. 2. Select Alarms > Set Status. The Set Status dialog box is displayed. 3. Enter the appropriate information in the text area of the Set Status dialog box. 4. If more than one alarm was selected, select Overwrite Existing Data to replace the current Status information for all alarms with the information entered in the dialog box. Deselect Overwrite Existing Data to append the information entered in the dialog box to the existing information for the selected alarms. Important: The Overwrite Existing Data option is deselected by default. 5. Click OK to set the new status for the alarm(s). Set Status dialog box buttons are: OK Sets the status on the selected alarms and closes the dialog box. 42 Enterprise Alarm Manager User Guide

43 Creating device/model notes Clear Clears any previously entered text in the dialog box, and leaves the dialog box open. Cancel Cancels all changes and closes the dialog box. To see the newly entered status information, click the alarm in the Alarm List. The details of that alarm appear in the Alarm Information panel. Click the Alarm Status tab to view the status for the selected alarm. Note: The status for a single alarm can also be set directly from the Alarm Status tab by entering the desired information and clicking OK. To set the same Alarm Status or Trouble Ticket ID for all alarms, click the Select All icon, then click Alarms > Set Status (or Set Trouble Ticket ID) and enter the desired status. Click OK to set the status (or ID) to all alarms. Important: When using the Alarms > Set Status or Set Trouble Ticket ID options, information contained in the Alarm Status or Trouble Ticket ID for any of the selected alarms is appended with new Alarm Status or Trouble Ticket ID information unless the Overwrite Existing Data button is selected. Creating device/model notes Device notes can include any information, including device and alarm history, pertinent to the device. These user-created notes are written to the device, not the alarm. As a result, if a device has more than one alarm on it, the notes will apply to all alarms on that device. The tab will vary depending on the model on which a highlighted alarm is occurring: if the selected alarm is on a device with a network address, the tab will be for Device Notes; if the selected alarm is on a model with no associated network address, i.e., it is a conceptual model such as a Landscape or LAN, the tab will be for Model Notes. Note: If different devices are selected, the device notes or model notes will only be written to the last device selected. To write notes to multiple devices use the Global Attribute Editor (GAE). See the Search Manager User Guide (2383) for details. To create Device or Model Notes: 1. Click the Notes tab. 2. Click in the panel to activate the editable field. 3. Enter your text. 4. Click OK. Enterprise Alarm Manager User Guide 43

44 Chapter 2: Managing Alarms With EAM Notes dialog box buttons are: OK Saves the text. Clear Clears any previously entered text. Cancel Cancels all changes and reverts to the text last entered. Notes: You must click OK before selecting a new alarm or switching to a different tab. You may also enter device notes by selecting the Model menu and clicking on Notes or by right-mouse clicking from anywhere in the EAM window to access the Icon Subviews menu and selecting Notes, which will open the Notes dialog. When you open the Notes dialog box this way you also have the option of ing your notes by clicking the Mail button. Mailing alarm information Alarm information may be ed to user specified recipients. Highlight the desired alarms and select the File > Mail Selected Items... option or click the Mail icon on the toolbar. A mail message dialog box opens. Enter the mail recipients addresses in the To: and Cc: fields. The Subject line may be changed from Enterprise Alarm Manager to any desired text. The body of the will contain the alarm information for each of the selected alarms. Click in the body of the message and type any additional notes or information. Click the Send button when done. Assigning alarms to troubleshooters The repair management feature of the EAM allows you to assign any troubleshooter (Troubleshooter > Create) to selected alarms from the Alarm List. Troubleshooter assignments are canceled when the alarm is cleared. Troubleshooters, when created, are shared from a common pool of troubleshooters based on the landscape to which the user is initially connected. Only landscapes which are currently filtered in will be listed in the Assignment dialog box. If a user selects to a different landscape, the troubleshooters associated with that landscape are listed. All activities related to repair management are recorded in the Event Log. Warning: No troubleshooting capabilities will be available if you connect a 5.0 EAM to a version of SpectroSERVER or if you don t have the security privileges to access the VNM. Note: Users with read-only privileges may assign and unassign a troubleshooter if the Alarm Update by Read Only flag is set to Yes. This flag is set in the Alarm Management Model Information View which is accessed by right-clicking the VNM icon and selecting Configuration. 44 Enterprise Alarm Manager User Guide

45 Assigning alarms to troubleshooters In the Landscape Configuration View, double click AlarmMgmt and set the flag in the Alarm Management Model Information View. When troubleshooters are assigned to alarms, the alarm can be acknowledged at the same time by selecting the Acknowledge When Assign option in the Options > Preferences > Action tab. To assign a troubleshooter to an alarm: 1. Click an alarm to select it in the Alarm List. Use the Control key to select multiple alarms or choose Alarms > Select All to select all alarms in the Alarm List. When selected, an alarm is highlighted. Note: Troubleshooters are created on a per-landscape basis. Assignments must be made to alarms on the same landscape the troubleshooter was created on. If alarms from multiple landscapes are selected, the Assign menu pick/toolbar icon will be disabled. 2. Select Troubleshooter > Assign, or click the Assign Troubleshooter button. The Assign dialog box displays a list of all created troubleshooters for the landscape of the selected alarm. 3. Select a troubleshooter from the list and click OK. The selected troubleshooter is now assigned to the selected alarm(s). Note: If only one troubleshooter has been created, clicking Assign Troubleshooter will directly assign the troubleshooter and no dialog box will appear. If more than one landscape is filtered in, toggle the Landscape field to the desired landscape. Troubleshooters available for that landscape will be listed. Select the desired troubleshooter and click OK. Assign Dialog Box Buttons are: OK Assigns the troubleshooter to the selected alarm and closes the dialog box. Cancel Closes the dialog box without making an assignment. To see which troubleshooter is assigned to an alarm, look in the Assignment column of that alarm in the Alarm List. The troubleshooter name for that alarm appears in the Assignment column of the Alarm List. To see all assignments for a particular troubleshooter, select Troubleshooter > Information to access the Information dialog box, and click the troubleshooter of interest to see its assignments. Note: Troubleshooter assignments made by your user can be overwritten by another user. Only troubleshooters for the current landscape will be listed in the Troubleshooter Information and the Troubleshooter Delete dialog boxes. Troubleshooter notification When a troubleshooter is created with a valid address an notification is sent informing the troubleshooter of the creation. notification is also sent when the Enterprise Alarm Manager User Guide 45

46 Chapter 2: Managing Alarms With EAM troubleshooter information is changed or the troubleshooter is deleted from the landscape. If the troubleshooter had previously been assigned to alarms, the notification will also state that the troubleshooter has been unassigned from the alarm(s). When assigned to an alarm, the troubleshooter will receive with detailed information on the assigned alarm. The default information included in the messages includes: Trouble Ticket ID, Alarm Status, Acknowledged, Troubleshooter, Severity, Date/Time, Probable Cause, and the PCause text. Event information can be included by selecting the Events to Troubleshooter option and setting the desired number (1-50) for the Event Count, in the Options > Preferences > Notification tab. All other fields in the message are reflective of the columns currently displayed in the alarm table. Additional containing this information is also sent when alarm changes occur, i.e., acknowledging, set status, clearing, etc. A sample mail message is shown below. The following alarms are being assigned to you, <troubleshooter name>: Trouble Ticket ID: Alarm Status: Severity: Critical Date/Time: Mon 25 Mar :01:42 EST Model Name: guido Network Address: <IP address> Manufacturer: Model Class: 9 Model Type: Host_Device Acknowledged: False Troubleshooter: Clearable: False Landscape: sulu (0x2fe00000) Probable Cause: 0x DEVICE HAS STOPPED RESPONDING TO POLLS SYMPTOMS: Device has stopped responding to polls. PROBABLE CAUSES: 1) Device Hardware Failure. 2) Cable between this and upstream device broken. 3) Power Failure. 4) Incorrect Network Address. 5) Device Firmware Failure. RECOMMENDED ACTIONS: 1) Check power to device. 2) Verify status lights on device. 3) Verify reception of packets. 4) Verify network address in device and SPECTRUM. 5) Cycle power on device and recheck. 6) If above fails, call repair. Events: Mon 25 Mar, :01:42 - Device guido of type Host_Device has stopped responding to polls and/or external requests. An alarm will be generated. [0x00010d03]) <end of sample mail message> (event Note: Troubleshooters with a valid address will also be notified of other alarm changes: Unassignment, Set Status, Set Trouble Ticket ID, Acknowledgement, Unacknowledgement, Clear, and Delete Troubleshooter. 46 Enterprise Alarm Manager User Guide

47 Unassigning alarms The system s mail utility needs to be configured properly in order for to be sent to troubleshooters. Unassigning alarms This repair management feature of the EAM allows you to unassign a troubleshooter from selected alarms in the Alarm List. Troubleshooter assignments are canceled when the alarm is cleared. A confirmation dialog box is displayed before unassigning a troubleshooter. To unassign a troubleshooter from one or more alarms: 1. Click an alarm to select it in the Alarm List. Use the Control key to select multiple alarms or choose Alarms > Select All to select all alarms in the Alarm List. When selected, an alarm is highlighted. 2. Select Troubleshooter > Unassign, or click the Unassign Troubleshooter button. 3. Click OK in the confirmation dialog box. The troubleshooter is now unassigned from the selected alarm. Confirm Unassign Dialog Box Buttons are: OK Unassigns the troubleshooter from the selected alarms and closes the dialog box. Cancel Cancels all changes and closes the dialog box. Creating troubleshooters The Create Troubleshooter dialog box allows you to create troubleshooters for use on the current landscape. To create a troubleshooter: 1. Select the Troubleshooter > Create menu item. The Create dialog box is displayed. 2. Fill in the fields appropriately. The troubleshooter that you designate should have a valid address or will not be received when an assignment is made (see Troubleshooter notification on page 45). 3. In a distributed environment, click the Landscape button and select the landscape that the Troubleshooter will be created on. Table 2-16: Troubleshooter Information Troubleshooter Name Address The identity of the person who is to be responsible for troubleshooting network alarms. The valid address of the person designated above (optional). Enterprise Alarm Manager User Guide 47

48 Chapter 2: Managing Alarms With EAM Table 2-16: Troubleshooter Information Landscape The landscape that the troubleshooter will be created on. 4. Click OK to create the troubleshooter. Create Troubleshooter Dialog Box Buttons are: OK Creates the troubleshooter and closes the dialog box. Cancel Cancels all changes and closes the dialog box. Deleting troubleshooters The Delete Troubleshooter dialog box allows you to delete one or more troubleshooters. To delete a troubleshooter: 1. Select the Troubleshooter > Delete menu item. The Delete dialog box is displayed. 2. Select the troubleshooters that you want to delete and click OK on the Delete dialog box. 3. Then click OK in the confirmation dialog box. The selected troubleshooters are now deleted and removed from the list of available troubleshooters. Delete Dialog Box Buttons are: OK Deletes the selected troubleshooter and closes the dialog box. Cancel Cancels all changes and closes the dialog box. Hint: If only one troubleshooter is created, the Delete dialog box will not appear. Instead, a Confirm Delete dialog box will appear asking if you want the single troubleshooter deleted. If so, click OK. Setting preferences You can change the startup defaults of the EAM to best suit your needs by using the Preferences dialog box. The dialog box allows you to customize and save preference settings, which provides persistence from one run of EAM to another (when you save the changes by using the Make Changes Permanent button). You access the dialog box from the Options menu; see Figure 2-11 (EAM Preferences dialog box with the Display tab selected). 48 Enterprise Alarm Manager User Guide

49 Setting preferences Note: A user with ADMIN privileges may select between User and Group for saving the Preferences using the Make Changes Permanent option. See Security and User Maintenance (2602) for more information. If the user does not have ADMIN privileges, then the selected preferences are saved for that user model only. Figure 2-11: EAM Preferences Dialog Box To access the Preferences dialog box, select Options > Preferences. The fields for the six tabs are outlined in Table 2-17 on page 49 through Table 2-22 on page 52. Note: Default settings are shown in parentheses in the first column; deselected signifies a raised button, and selected signifies a recessed button. To clear all Preference changes and return to the default settings, you can click either the Defaults button or select Options > Clear User Preferences. To clear all Preference changes for a Group and return to the default settings, select Options > Clear Group Preferences. This option is only available if the user is part of the group and has ADMIN privileges for that group. Warning: Clicking the Clear User Preferences or Clear Group Preferences button will clear all your changes, including filter, column order, etc., and will require that you restart the EAM for the changes to take effect. The Preferences Actions tab fields are: Table 2-17: Actions Tab Acknowledge When Assign (deselected) If selected, the alarm is acknowledged when a troubleshooter is assigned to the alarm. Enterprise Alarm Manager User Guide 49