Enterprise Alarm Manager UserÕs Guide

Transcription

1 Titlepage Enterprise Alarm Manager UserÕs Guide SPECTRUM Enterprise Manager Network Management

2 Notice Aprisma Management Technologies, Inc. (Aprisma) reserves the right to make changes in speciþcations and other information contained in this document without prior notice. The reader should in all cases consult Aprisma to determine whether any such changes have been made. The hardware, Þrmware, 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, KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Copyright June 2000 by Aprisma Management Technologies, Inc. All rights reserved. Printed in the United States of America. Order Number: Aprisma Management Technologies, Inc. 121 Technology Way Durham NH SPECTRUM, the SPECTRUM IMT/VNM logo, DCM, IMT, and VNM are registered trademarks, and SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, and Virtual Network Machine are trademarks of Aprisma or its afþliates. C++ is a trademark of American Telephone and Telegraph, Inc. UNIX is a trademark of UNIX System Laboratories, Inc. OSF/Motif and Motif are trademarks of the Open Software Foundation, Inc. X Window System is a trademark of X Consortium, Inc. Ethernet is a trademark of Xerox Corporation. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the Licensed Software is virusfree. Aprisma has tested its software with current virus checking technologies. However, because no anti-virus system is 100% reliable, we strongly caution you to write protect and then verify that the Licensed Software, prior to installing it, is virus-free with an anti-virus system in which you have conþdence. Enterprise Alarm Manager User s Guide Page 2

3 Restricted Rights Notice (Applicable to licenses to the United States Government only.) 1. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS Aprisma Management Technologies, Inc., 121 Technology Way, Durham, New Hampshire (a) This computer software is submitted with restricted rights. It may not be used, reproduced, or disclosed by the Government except as provided in paragraph (b) of this Notice or as otherwise expressly stated in the contract. (b) This computer software may be: (1) Used or copied for use in or with the computer or computers for which it was acquired, including use at any Government installation to which such computer or computers may be transferred; (2) Used or copied for use in a backup computer if any computer for which it was acquired is inoperative; (3) Reproduced for archival or backup purposes; (4) Modified, adapted, or combined with other computer software, provided that the modified, combined, or adapted portions of the derivative software incorporating restricted computer software are made subject to the same restricted rights; (5) Disclosed to and reproduced for use by support service contractors in accordance with subparagraphs (b) (1) through (4) of this clause, provided the Government makes such disclosure or reproduction subject to these restricted rights; and (6) Used or copied for use in or transferred to a replacement computer. (c) Notwithstanding the foregoing, if this computer software is published copyrighted computer software, it is licensed to the Government, without disclosure prohibitions, with the minimum rights set forth in paragraph (b) of this clause. (d) Any other rights or limitations regarding the use, duplication, or disclosure of this computer software are to be expressly stated in, or incorporated in, the contract. (e) This Notice shall be marked on any reproduction of this computer software, in whole or in part. Enterprise Alarm Manager User s Guide Page 3

4 Contents Contents Contents Alarm Manager and Enterprise Alarm Manager 6 Introduction... 6 Overview... 6 Accessing AM and EAM Within SpectroGRAPH... 7 Accessing alarms for specific models... 8 Managing Alarms With EAM 10 EAM Main Window Alarm Information Panel Alarm List Stale alarms Local Filter/Search Area Filter Log Area Alarm Count Panel Connection Status Information Invocation Context EAM Menus EAM toolbar 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 Assigning Alarms Enterprise Alarm Manager User s Guide Page 4

5 Contents Contents Troubleshooter Notification Unassigning Alarms Unassigning alarms on remote servers Creating Troubleshooters Destroying Troubleshooters Setting Preferences Alarm sounds Customizing the sound files Iconized EAM Custom Scripts and Applications 69 Introduction Access Tags Example Index 76 Enterprise Alarm Manager User s Guide Page 5

6 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. Enterprise Alarm Manager (EAM) provides a list of current network alarms and allows you to manage alarms in a distributed environment. 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 be run in conjunction with a locally installed SpectroSERVER or by using a remote SpectroSERVER. AM can be used with or without SpectroGRAPH; however, if SpectroGRAPH is not used, related SpectroGRAPH views (Performance, Information, etc.) will not be 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. Enterprise Alarm Manager User s Guide Page 6

7 Alarm Manager and Enterprise Alarm Manager Accessing AM and EAM Within SpectroGRAPH AM and EAM allow you to: 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 (e.g., all alarms that occur under a LAN). Establish the criteria by which the list of alarms is displayed through filtering. 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 the 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 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 To access AM or EAM from a SpectroGRAPH menu, select Tools > Alarm Manager. If Enterprise Alarm Manager was installed, this will bring up the EAM, otherwise, the non-distributed Alarm Manager will be displayed. Note: The first time EAM is run, it connects to the default landscape only. To connect to more landscapes choose View > Filter from the EAM main window to open the Filter dialog, and move the desired landscapes from the Hide list to the Show list. (Refer to Setting Preferences on Page 58 for details.) Enterprise Alarm Manager User s Guide Page 7

8 Alarm Manager and Enterprise Alarm Manager Accessing AM and EAM Within SpectroGRAPH Accessing alarms for speciþc models To access AM for a specific model or models that have a color status indicating the presence of an alarm, click on the model icon in the Topology view to highlight it (use the Shift key to select multiple models) and select View > Icon Subviews > Model Alarms. You can also right mouse click on the device icon to access the Icon Subviews menu and select Model Alarms. This will bring up AM against only the selected models, and will display any alarms that are on those models. If any of the selected models are container models (LAN_802_3, Landscape, IPClassB, etc.), all alarms on devices contained within the container model will also be displayed. Note: When you access Alarm Manager against a specific model by using the View > Icon Subviews > Model Alarms method, you will not see alarms associated with devices that are connected to the model against which AM was invoked. If, however, the model against which AM was invoked contains another model that is itself a container, you will see the devices within that container model. When launching the EAM by the View > Icon Subviews > Model Alarms method, you will see the Invocation Context dialog box. This dialog box alerts you that the application was brought up on one or more selected models and, therefore, will have information only on those models and any models contained within (if the selected model is a container). You can prevent the Invocation Context dialog box from automatically being displayed by deselecting the Show this dialog at startup button at the bottom of the dialog box. The dialog box can also be launched by selecting View > Invocation Context or by clicking the Invocation Context dialog box button at the bottom right corner of the EAM main screen. Note that this button only appears when the EAM is launched against one or more specific models. When the EAM is launched against a specific model, the Model detail filter label, which is located beneath the Filtered by: field at the bottom left of Enterprise Alarm Manager User s Guide Page 8

9 Alarm Manager and Enterprise Alarm Manager Accessing AM and EAM Within SpectroGRAPH the Alarm List, shows what model (or models) alarms are being displayed for, and what the specific model is. For example, Shown Models: gizmo (Landscape) means the EAM was launched against the Landscape model gizmo, or Shown Models: (HubCSIEMME), SSR250 (Generic_SSR_FP) means the 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 s Guide Page 9

10 This chapter describes the Enterprise Alarm ManagerÕs main window and details how to use the applicationõs features for managing alarms. EAM Main Window The main EAM window is composed of the following three areas: 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 alarm totals for the alarms currently displayed in the Alarm List. Note: By default, the EAM only displays the most severe alarms occurring on a device, i.e., secondary alarms are suppressed. To display all alarms on a device, bring up the Filter dialog box (View > Filter), click the State page, and, in the Primary/Secondary State field, depress the Primary and Secondary radio button. (Refer to Primary and secondary alarms, on page -37). When an alarm occurs, it is added to the list of alarms in the Alarm List of the EAM (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 1 on Page 11 shows the Alarm Information panel. Figure 2 on Page 17 shows the main Alarm List, and Figure 3 on Page 21 shows the Alarm Count panel. Enterprise Alarm Manager User s Guide Page 10

11 EAM Main Window Tip: The size of columns can be adjusted two different ways: Double-click a column header to resize that column to the width of the longest entry; or, Place the cursor on the edge of a column heading until the cursor changes to a left-right arrow, hold the left mouse button down, and drag the column edge to the desired size. The Alarm List can be scrolled to the right and left using the scrollbar at the bottom of the panel. 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 one clicked. The panel includes a device icon and eight tabbed panels, each of which is described below. Figure 1: 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: Enterprise Alarm Manager User s Guide Page 11

12 EAM Main Window Table 1: Alarm Information Panel Fields Field Device Icon System System Name Network Address IP Address Description 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 placed on 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, refer to the SPECTRUM Views for Operators. Displays several fields of detailed system information. These are described below. 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 value will be empty 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 network entity, i.e., the device SPECTRUM is talking to and managing, including system hardware type, and operating and network software. Enterprise Alarm Manager User s Guide Page 12

13 EAM Main Window Table 1: Alarm Information Panel Fields (Continued) Field Contact Location Probable Cause Events Description 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 generating the alarm, e.g., "Facility B, second floor.". The most likely reason(s) the selected alarm was generated. (See Note on Page -16.) The event(s) that generated the selected alarm. By default, events are displayed ten at a time. The event counter at the bottom right of the page shows the total number of events and the current number being displayed. 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. is displayed. (See Note on Page -16.) You can change various default event settings from the VNM icon by selecting Icon Subviews > Configuration > AlrmMgmt. Enterprise Alarm Manager User s Guide Page 13

14 EAM Main Window Table 1: Alarm Information Panel Fields (Continued) Field History Alarm Status Trouble Ticket ID Description A list of five (the default setting) 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 (e.g.,"alarm 1") is the first to appear in the list. The alarm counter at the bottom right of the page shows the total number of alarms and the current number being displayed. Use the Next, Previous, Top, and Bottom to navigate through the alarm summaries. You can change the default setting (Maximum Alarm History Count) by using the Preferences dialog box (Options > Preferences > Display) if more than the last five historical alarm summaries are needed. Alarm History data can be disabled from the VNM icon in SpectroGRAPH s Universe Topology view by selecting the icon to highlight it and choosing Icon Subviews > Configuration > AlrmMgmt and toggling Generate Alarm Events to No. Current administrative status of the device. These user-created notes can include device and alarm history. User-created identification used to track a trouble ticket (if any) on the alarm. Enterprise Alarm Manager User s Guide Page 14

15 EAM Main Window Table 1: Alarm Information Panel Fields (Continued) Location Field Description Alarm location listed in SpectroGRAPH s hierarchical format. For example, Topological Location: ÔsquashÕ of type ÔLandscapeÕ; ÔUniverseÕ of type ÔUniverseÕ. Device/Model Notes 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 will be grayed out if the views have not been modeled in SPECTRUM. User-created notes for the device in alarm state. The tab will vary depending on what is highlighted in the Alarm List: 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 User or Landscape), the tab will be for Model Notes. Six of the tabbed panels and their associated fields are read-only. The Alarm Status and Device/Model Notes panels are read-write. 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 the EAM is shutdown and restarted. Enterprise Alarm Manager User s Guide Page 15

16 EAM Main Window Note: Some probable cause information is requested from the primary VNM and may be undefined for alarms in remote landscapes. To access probable cause information for alarms in remote landscapes, connect the EAM directly to the landscape (VNM) in which the alarm with the missing information is located. Note: 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 ). To remedy this, restart Archive Manager from the SPECTRUM Control Panel by selecting the Start Archive Manager button (Control > Start Archive Manager). Refer to Administrators > Getting Started > About the SPECTRUM Control Panel for more information about starting Archive Manager. Alarm List The Alarm List displays a scrollable list of all alarms that fit the current filtering criteria. The following are the default column settings shown at startup. Enterprise Alarm Manager User s Guide Page 16

17 EAM Main Window Figure 2: Alarm List Severity Date/TIme Model Name Network Address Vendor Name Model Class Model Type Critical Critical Critical Major Major Major Minor Minor Minor Wed 05 Apr :22:33 Fri 31 Mar :05:37 Fri 31 Mar :00:04 Wed 05 Apr :21:55 Fri 31 Mar :00:00 Thu 30 Mar :27:56 sugar presto root sugar Aministrator lefty Aprisma application VNM Mon 03 Apr :15:34 sugar Sun Microsyst... node GnSNMPDev Mon 03 Apr :15:34 sugar Sun Microsyst... node GnSNMPDev Fri 31 Mar :53:02 sugar Sun Microsyst... node GnSNMPDev Search Shown Prev Next Filtered by: Landscape, Secondary Alarms. Displayed 9 of 9 Table 2: Column Settings at Startup Column Severity Date/Time Model Name Network Address Vendor Name Model Class Model Type DeÞnition 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 manufacturer of the device. The type of device the model represents, e.g., bridge, router, hub, etc. The SPECTRUM model on which the alarm is occurring. Enterprise Alarm Manager User s Guide Page 17

18 EAM Main Window Table 2: Column Settings at Startup (Continued) Column Acknowledged Probable Cause Assignment Clearable Landscape DeÞnition 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. The name of the troubleshooter assigned to the alarm. The clearable status of the alarm. Alarms with a check mark in this column can be cleared, those without a check mark can not be cleared. The landscape on which the alarm occurred. (EAM only.) Hidden from view at startup are the following columns: Table 3: Columns Hidden at Startup Column MAC Address Contact Device Location Occurrences Secondary Status DeÞnition The hard-coded physical address of the device. The person to contact when device problems occur. The physical location of the device in alarm, e.g., "telephone closet, first floor." The number of times the same type of alarm, e.g., Contact Lost, has occurred on the model. A check mark 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. Enterprise Alarm Manager User s Guide Page 18

19 EAM Main Window Column Table 3: Columns Hidden at Startup (Continued) DeÞnition Trouble Ticket ID Alarm ID Probable Cause ID Stale 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 with SpectroSERVER shutdown. The system-generated ID for the alarm's probable cause, e.g. "0x " is the ID for the probable cause "Device has stopped responding to polls." A check mark denotes an alarm that existed prior to SpectroSERVER shutdown, is now "residual," and may need to be cleared. (See Filter dialog box buttons on Page -38.) Stale alarms When the SpectroSERVER goes down and is brought back up, alarms that existed prior to shutdown are re-displayed in the Alarm List. This persistent alarm feature allows SPECTRUM to retain alarm-related information (troubleshooter assignments, status, etc.) when the server goes down. In some cases, the underlying cause of an alarm gets resolved between server shutdown and restart but the alarm is still displayed 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, are always user-clearable. Stale alarms are identified by a check mark 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. Enterprise Alarm Manager User s Guide Page 19

20 EAM Main Window 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 or search functions; default is Search. Shown Specifies which column to filter/search in; 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.) Enterprise Alarm Manager User s Guide Page 20

21 Filter Log Area EAM Main Window 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 will list up to three items. If there are more than three items, the list will be abbreviated with an ellipses, e.g., Model Type (Show Pingable, VNM, User,...). Probable causes are abbreviated after two items, e.g., Probable Cause (Hide DUPLICATE MODEL, OUT OF MEMORY,...). If an Advanced filter is being applied, or when the EAM is launched against a specific model (Icon Subviews > Model Alarms), the Model detail filter label, which is located beneath the Filtered by: field at the bottom left of the Alarm List, shows what model (or models) alarms are being displayed for, and what the specific model is. For example, Shown Models: gizmo (Landscape) means the EAM was launched against the Landscape model gizmo, or Shown Models: (HubCSIEMME), SSR250 (Generic_SSR_FP) means the EAM was launched against an EMME hub and a SmartSwitch router and is displaying alarms as they pertain only to these two devices. Alarm Count Panel Displays the number of each type of alarm 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. Figure 3: Alarm Count panel Critical: 5 Major: 12 Minor: 21 Total: 38 Total number of alarms matching applied filters. Servers Enterprise Alarm Manager User s Guide Page 21

22 EAM Main Window Tip: Initial, Suppressed, and Maintenance alarms are not generated by default and will not be displayed in the Alarm List. If you want to display these alarm severities, go to the SpectroGRAPH Universe Topology view and do the following: 1 Highlight the VNM icon. 2 Choose View > Icon Subviews > Configuration to open the Landscape Configuration view. 3 Select AlarmMgmt from the Configure/Information panel list and click OK to open the Alarm Management Model Information view. 4 In the Alarm Management Options field, toggle the Disable <severity> Alarms button to No. 5 Choose File > Save All Changes to close the Alarm Management Model Information view. 6 Restart the EAM. 7 Choose View > Filter to open the Filter dialog box. 8 Move Initial, Maintenance, and Suppressed severities from the Hide list to the Show list by clicking the left double arrow. From this point on, alarms of <severity> will be generated and displayed in the Alarm List. However, only Initial, Maintenance, and Suppressed severity alarms generated after the setting was changed will show up in the Alarm List. Enterprise Alarm Manager User s Guide Page 22

23 EAM Main Window 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 will not update with the changes relative to the server that is down (and will not until that server is restarted), but the alarm counts total will update with the correct number based on current filter settings. Table 4: Severity Colors Severity/Color Initial (blue) Suppressed (gray) Maintenance (brown) Critical (red) Major (orange) Minor (yellow) Total DeÞnition Contact with this device has not yet been established. Device cannot be reached due to a known error condition that exists on another device. Device has been taken off-line for maintenance purposes. A loss of service has occurred and immediate action is required. A loss of service has occurred or is impending. Action is required within a short period of time. 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. Sum of the alarms for all of the severities not filtered. Enterprise Alarm Manager User s Guide Page 23

24 Connection Status Information Invocation Context Clicking the Servers button 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. Invocation Context If you start the Enterprise Alarm Manager by choosing Icon Subviews > Model Alarms, the Invocation Context dialog box is displayed. This dialog alerts you that the EAM was brought up on one or more selected models and that information will be available only for those models and any models they contain (if any). For example, if you bring up the EAM against a LAN model that contains other models, the LAN and all the models it has within it will be displayed in the Alarm List. See Accessing alarms for specific models (Page 8) for more information on bringing up the EAM against specific models. You can also access the Invocation Context dialog box by choosing View > Invocation Context or by clicking the Invocation Context dialog button at the bottom right corner of the window. You can choose not to automatically display the dialog box at startup by deselecting (raising) the Show this dialog at startup button at the bottom of the dialog itself. Enterprise Alarm Manager User s Guide Page 24

25 EAM Menus Invocation Context The options that are available from the EAM menus are described in the following paragraphs. File This menu allows you to print and exit from the EAM. Table 5: File Menu Print Close Page SetupDisplays the Print Page Setup dialog box where you can set printing style options. Print SelectedDisplays the Print Selected Data dialog box where you can set print range, destination, and number of copies for printing the selected alarms. Print AllDisplays the Print All Data dialog box where you can set print range, destination, and number of copies for printing all displayed alarms. WindowDisplays the Print Window dialog box where you can set print range, destination, and number of copies for printing the EAM main window. Exits the EAM application. View This menu allows you to choose specific viewing preferences and accesses three dialog boxes. Enterprise Alarm Manager User s Guide Page 25

26 Invocation Context Table 6: View Menu Show Toolbar Show Toolbar Labels Show Tool Tips Show Status Help Invocation Context Connection Status Show Filter/Search Panel Show Alarm Information Show Alarm Counts Hide Selected Alarms Show Hidden Alarms Toggles on/off the display of the toolbar at the top of the Information panel. Toggles on/off the display of the toolbar labels beneath each toolbar icon. Toggles on/off the display of the toolbar icon descriptions. Toggles on/off the display of status help in the status bar. This is only available if the EAM was brought up against a specific model via the Icon Subviews menu. (This dialog box can also be accessed by clicking the Invocation Context dialog button in the bottom right corner of the EAM window.) Displays the Connection Status dialog box, which shows 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/off the display of the Filter/Search buttons and their associated text box. Toggles on/off the display of the Alarm Information panel at the top of the EAM window. Toggles on/off the display of 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 any and all alarms that were hidden by the Hide Selected Alarms method. Enterprise Alarm Manager User s Guide Page 26

27 Invocation Context Table 6: View Menu (Continued) Filter Sort Column Order 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 which three columns the Alarm List will be sorted by (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. Model This menu displays the Icon Subviews menu for the device of the selected alarm. It is the same menu accessed by clicking the right mouse button in the EAM window. Table 7: Model Menu Navigate Model Alarms Performance Allows you to Navigate In or Navigate Up to SpectroGRAPH views, e.g., Topology, Device Topology, and Location. Opens the Alarm View for the selected (highlighted) model only. This is the same as bringing the EAM up via Icon Subviews > Model Alarms. The Invocation Context dialog box will be displayed when accessing the Alarm View this way. Displays the SpectroGRAPH Performance view for the model highlighted in the Alarm List. Enterprise Alarm Manager User s Guide Page 27

28 Invocation Context Notes Various SpectroGRAPH menu selections Table 7: Model Menu (Continued) Opens the Notes dialog box where you can write notes about the model/device and send the notes via . Notes are displayed in the Model/Device Notes tabbed page of the Information Panel. Most of these views can only be accessed if SpectroGRAPH is running (Notes and Acknowledge menu picks can be accessed without SpectroGRAPH). These menu choices will vary depending on the selected model. Alarms This menu provides several selections to manage alarms. Table 8: Alarms Menu Select All Acknowledge Unacknowledge Set Status Set Trouble Ticket ID 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 check mark appears in the Acknowledged column. This is useful for flagging alarms as distinct from new alarms that automatically appear in the Alarm List. Unacknowledges an acknowledged alarm. Displays 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. Displays the user-created identification used to track a trouble ticket on the alarm Enterprise Alarm Manager User s Guide Page 28

29 Invocation Context Table 8: Alarms Menu (Continued) Clear Displays the Confirm Clear dialog box. Click OK and the selected alarms are cleared. A check mark 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. Table 9: Troubleshooter Menu Assign Unassign Information Create Destroy Displays the Assign dialog box listing all available troubleshooters. When you select a troubleshooter and click OK, the selected troubleshooter is assigned to the selected alarms. If only one troubleshooter has been created, clicking Assign Troubleshooter will directly assign the troubleshooter and no dialog box will appear. 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 Alarm ID, Model Name, Model Type and Model Handle. 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 allows you to create a troubleshooter and assign an (optional) address. Displays the Destroy dialog box. This allows you to destroy one or more troubleshooters. Enterprise Alarm Manager User s Guide Page 29

30 Invocation Context Options This menu allows you to customize certain aspects of the EAM. Table 10: Options Menu Preferences Clear User 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. Toggles on/off the alarm sound. If on, an audible sound indicates which severity of alarm has entered the system each time a new alarm is generated. Sounds can be configured by accessing the Notification tabbed page of the Preferences dialog box. Toggles on/off the Auto Raise feature. If on, the EAM window is brought to the front each time a new alarm enters the system or, if minimized, EAM is automatically restored and raised to the foreground. Help This menu provides selections on various help options available in or from the main EAM window. Table 11: Help Menu What s This? Hints Help Index 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 is displayed. Selecting this launches a Web browser and opens the main Hints page with its associated links to other Hints pages. Opens the Help Index. Enterprise Alarm Manager User s Guide Page 30

31 Invocation Context Table 11: Help Menu (Continued) Help Topics About Enterprise Alarm Manager Online Manuals Opens the Help Table of Contents. Displays a dialod box with information about this version of EAM. Accesses the SPECTRUM online documentation (SPECTRUM Documentation CD must be installed). EAM toolbar The toolbar below the Menu allows you to access menu choices quickly by clicking on a toolbar icon (button). These button icons are described below. Tip: When the cursor is placed on top of a toolbar icon, pop-up text identifying the tool is displayed. Further descriptive text is provided when the What s This? help option is selected and the toolbar button is clicked Table 12: Toolbar Buttons Filter dialog button Displays the Filter dialog box. Sort dialog button Column Order dialog button Select All alarms button Acknowledge alarms button Displays the Sort dialog box. Displays the Column Order dialog box. 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 check mark in the Acknowledged column. This button is grayed out if the selected alarm is already acknowledged. Enterprise Alarm Manager User s Guide Page 31

32 Filtering Alarms Table 12: Toolbar Buttons (Continued) Unacknowledge alarms button Clear alarms button Assign Troubleshooter button Unassign Troubleshooter button Ping Telnet Mib Tools What s This? button Hints button Unacknowledges the selected alarm and removes the check mark 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 is unclearable, an error message appears. Displays the Assign troubleshooter dialog box. If there are no troubleshooters created for your User, an error message appears. Displays the Confirm Unassign dialog box. This button is grayed out if the selected alarm doesn t have a troubleshooter assigned to it. 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. Filtering Alarms You can establish the criteria by which the list of alarms is displayed by setting filters. These filtering subsets make it possible for you to customize your EAM application to display alarms appropriate to your networking needs. Only those alarms that meet all filtering criteria set by the user are displayed. Enterprise Alarm Manager User s Guide Page 32

33 Filtering Alarms Note: If you change filter settings while a server with displayed alarms is down, the new settings will not apply to the down server. In this case, there may be alarms still displayed in the Alarm List that don t fit your filtering criteria. In addition, if you filter out an alarm severity while a server is down, the alarm count for that severity will be grayed out, but the number of alarms remaining in the view will still be reported, i.e., the alarm count total will include 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 4 shows the EAM Filter Model Type tabbed page and its Show/Hide list. Six of the Filter s 10 tabbed pages use the show/hide format to make filtering selections. Figure 4: EAM Filter Model Type Tab Page Enterprise Alarm Manager: Filter Model Type Model Landscape Date/Time Address Model Class Severity Show ATM_Network AUI AlarmMgmt AppDataEvntTrap AppDataServer AppDataStatTap AplTlkRtrApp Hide Cause Assignment State Filter Next Filter Next Reset Page Reset All Advanced Make Changes Permanent OK Cancel Reset All Clear All WhatÕs This? Enterprise Alarm Manager User s Guide Page 33

34 Filtering Alarms The Filter dialog box displays several tabbed pages for setting various types of alarm filters and a variety of buttons to save and reset filter settings. (See Filter dialog box buttons on Page -38.) The options available with each filter are retrieved from the database that is being used to model your network. The Filter tabbed pages are: Table 13: Filter Tabbed Pages Model Type Model Choose the model type(s) that you do not want to view alarms for and move them into the Hide list. 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, i.e., Icon Subviews > Model Alarms, the Model List will contain only that model and any models contained within that model. If the EAM is brought up via Tools > Alarm Manager, the Model List will be 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 to 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 (e.g., "mod" in generic_model), Prefix (e.g., "gen") or Suffix (e.g., "del"). The number of models that will be added to the Model List is limited to 20 by default (Max Model Filter Request). If more than 20 models are found in a search, a confirmation dialog is displayed. You can change the default number by selecting Options -> Preferences -> Filter. Enterprise Alarm Manager User s Guide Page 34

35 Filtering Alarms Table 13: Filter Tabbed Pages (Continued) Landscape Date/Time Address Model Class Severity Cause Choose the landscapes you want displayed in the Alarm List and move them into the Show list. By default, only the primary landscape appears in the Show list; all other landscapes are in the Hide list. Choose the date and time range that you want to view alarms for. You will need to designate a start time and/or an end time. Possible combinations are: start time to now, start time to end time, all up to end time, and all up to now (default). Choose the devices you want displayed (or not display by toggling Show to Hide) 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. Choose the models you do not want displayed in the Alarm List by Model Class by moving them to the Hide list. Choose the severities that you want to show/hide by moving them to the appropriate list. Shown by default are: Critical, Major, and Minor. Initial, Suppressed, and Maintenance alarms are not generated by default. To display these severities, you must use the Landscape Configuration view (see Note on Page -22). Choose the probable cause messages that you do not want to view alarms for and move them into the Hide list. Enterprise Alarm Manager User s Guide Page 35

36 Filtering Alarms Table 13: Filter Tabbed Pages (Continued) Assignment State Choose the troubleshooters that you do not want to view alarms for and move them into 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: Acknowledged, Clearable, and Primary/Secondary. Selected by default are: Acknowledged and Unacknowledged, Clearable and Not Clearable, and Primary Only. Note: Model Types listed in the Filter dialog box pertain to the primary landscape only, i.e., the VNM connected to at startup. Other landscapes in the primary landscape s map may contain different model types but these additional model types will 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 the SPECTRUM Documentation Roadmaps, Distributed SpectroSERVER, Master Catalog ). Note: The Probable Cause tabbed page contains only causes of alarms that have been displayed in the Alarm List. As new alarms are generated, those with new probable causes, i.e., causes not listed in the filter tabbed page s Show or Hide list, will appear in the Alarm List regardless of how you have filtered by probable cause except under one condition: If the Show list contains entries but has fewer items than the Hide list, alarms with new causes will not be displayed in the Alarm List. Enterprise Alarm Manager User s Guide Page 36

37 Primary and secondary alarms Filtering 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. This can help you when troubleshooting. For example, a model might have a primary alarm of Contact Lost but the reason for the lost contact, e.g., "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 tabbed page. 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: 1 Select View > Column Order to open the Column Order dialog box. 2 In the Hidden list, click Secondary. Enterprise Alarm Manager User s Guide Page 37

38 Filtering Alarms 3 Click the left arrow or double-click the highlighted name to move it from the Hidden list to the Shown Order 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 check mark 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: Reset Page Resets only the selected tabbed page to the settings last saved by Make Changes Permanent, or those at startup. Clear Page Clears only the selected tabbed page. Enterprise Alarm Manager User s Guide Page 38

39 Filtering Alarms Make Changes Permanent When used with the OK button, saves any new filter settings. These settings will retained even if the EAM is shutdown and restarted. OK Applies the new filter settings for the current EAM session only (unless the Make Changes Permanent button is selected) and closes the dialog box. Cancel Closes the dialog box and cancels any changes in the filter settings. Reset All Resets all filter tabbed pages to the settings last saved by Make Changes Permanent, or those at startup, and leaves the dialog box open. Clear All Clears all filter tabbed pages 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. Hints Displays the Hints help page for the selected tabbed page. Enterprise Alarm Manager User s Guide Page 39

40 Filtering Alarms The Make Changes Permanent button is used to save the settings you chose in any of the tabbed pages by clicking the button (to the recessed position) and selecting OK from the Filter dialog buttons. Using the Advanced Þlter 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, i.e., 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) EMM-E6s or yellow (Minor) Pingables. In this case, red (Critical) Pingables will not show up in the Alarm List, nor will yellow (Minor) EMM- E6s. 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 EMM-E6s. The example below shows you the steps to achieve advanced filtering for the above selections. To filter on Critical EMM-E6s OR Minor Pingables only: 1 Click the Model Type tab and hide all model types except EMM-E6 models by doing the following: a b c Move all model types to the Hide table with the double right arrow button. Type EMM-E6" into the Filter/Search text box. Move EMM-E6 into the Show table with the single left arrow button or double-click the entry. Enterprise Alarm Manager User s Guide Page 40

41 Filtering Alarms 2 Click the Severity tab and move Major and Minor alarms to the Hide list. 3 Click the Add button to put your selections in the Advanced Filter panel. The panel will read, "Model Type (Show EMM-E6) 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 5 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. Enterprise Alarm Manager User s Guide Page 41

42 Filtering Alarms Figure 5: Local Filter/Search Area To locally filter the Alarm List do the following: 1 Toggle the menu 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 search the Alarm List do the following: 1 Toggle the 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. Enterprise Alarm Manager User s Guide Page 42

43 Sorting Alarms 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, which are outlined below. To sort using the Sort dialog box: 1 Select View > Sort or click the Sort dialog button. The Sort dialog box, shown in Figure 6, appears. Figure 6: EAM Sort Dialog Box Primary sort Enterprise Alarm Manager: Sort Secondary sort Sort By: Severity Ascending Tertiary sort Then By: Date/Time Descending Then By: Alarm ID Descending OK Cancel Hints 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 Alarm ID Model Type Network Address Enterprise Alarm Manager User s Guide Page 43

44 Sorting Alarms Assignment Clearable Contact Date/Time Device Location Landscape MAC Address Model Class Model Name Occurrences Probable Cause Probable Cause ID Secondary Stale Status Trouble Ticket ID Vendor Name None 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. 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. Enterprise Alarm Manager User s Guide Page 44

45 Sorting Alarms 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 7 shows how the Alarm List looks when sorted this way. Enterprise Alarm Manager User s Guide Page 45

46 Changing Column Order Figure 7: Primary, Secondary and Tertiary Sort Order The secondary sort column organizes the similar model types according to the time alarms were generated, in this case, in descending order. Condition 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 dialog button. This displays the Column Order dialog box, which is comprised of a show/hide 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 the Alarm List by moving them to the appropriate Hide/Show list using the left/right arrows, or by double-clicking a list entry. Enterprise Alarm Manager User s Guide Page 46

47 Changing Column Size To reorder columns within the window 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. 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 check 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. Enterprise Alarm Manager User s Guide Page 47

48 Acknowledging Alarms 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 listing the alarms not cleared will be displayed. Confirmation dialog buttons are: OK Clears the alarms and closes the dialog box. Cancel Cancels all changes and closes the dialog box. Acknowledging Alarms You have the option of acknowledging alarms. This feature is useful, for example, if you assign the responsibility for selected alarms to a troubleshooter and 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. Enterprise Alarm Manager User s Guide Page 48

49 Setting Alarm Status 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 -23.) 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, or click the Set Alarm Status button. The Set Status dialog box is displayed. 3 Enter the appropriate information in the text area of the Set Status dialog box. 4 Click OK to set the new status for the alarm(s). Enterprise Alarm Manager User s Guide Page 49

50 Creating Device/Model Notes Set Status dialog buttons are: OK Sets the status on the selected alarms and closes the dialog box. 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 selected alarm can also be set directly from the Alarm Status tabbed page. 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. Enterprise Alarm Manager User s Guide Page 50

51 Creating Device/Model Notes To create Device or Model Notes: 1 Click on the Notes tab. 2 Click in the panel to activate the editable field. 3 Enter your text. 4 Click OK. Notes dialog buttons are: OK Saves the text. Clear Clears any previously entered text. Cancel Cancels all changes and reverts to the text last entered. Note: You must click OK before selecting a new alarm or switching to a different tabbed page. Note: 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 this way you have the option of ing your notes by clicking the Mail button. Enterprise Alarm Manager User s Guide Page 51

52 Assigning Alarms Assigning Alarms This repair management feature of the EAM allows you to assign any troubleshooter that your User model has created (Troubleshooter > Create) to selected alarms from the Alarm List. Troubleshooter assignments are canceled when the alarm is cleared. 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. 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. 2 Select Troubleshooter > Assign, or click the Assign Troubleshooter button. The Assign dialog box displays a list of all created troubleshooters. 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. Assign dialog buttons are: OK Assigns the troubleshooter to the selected alarm and closes the dialog box. Enterprise Alarm Manager User s Guide Page 52

53 Assigning Alarms Cancel Closes the dialog box without making an assignment. To see which troubleshooter is assigned to an alarm, click the 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. Note: Only troubleshooters created by your User will be listed in the Troubleshooter Information dialog box. Therefore, only alarms assigned to troubleshooters created by you, or troubleshooters created by another user that have the same names as your troubleshooters, will be displayed in this dialog box. Likewise, if a troubleshooter is modified in this dialog box, the changes will only affect troubleshooters assigned to alarms on the host landscape. Troubleshooter NotiÞcation If the assigned troubleshooter has a valid address, he or she will receive mail with detailed information on the assigned alarm, including information when alarm changes occur, i.e., acknowledging, set status, clearing, etc. A sample mail message is shown below. Subject: Assigned Alarm Date: Tue, 16 May :56: Enterprise Alarm Manager User s Guide Page 53

54 Assigning Alarms From: (Super-User) To: The following alarms have been assigned to you: Landscape: gopher Model Name: Model Type: Host_NT Secondary Alarm: False Acknowledged: False Clearable: False Severity: Critical Date/Time: Tue 17 Feb :06:01 EST Alarm Status: Probable Cause: 0x CONTACT LOST 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. Enterprise Alarm Manager User s Guide Page 54

55 Unassigning Alarms 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. 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 Destroy Troubleshooter. 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 buttons are: OK Unassigns the troubleshooter from the selected alarms and closes the dialog box. Enterprise Alarm Manager User s Guide Page 55

56 Creating Troubleshooters Cancel Cancels all changes and closes the dialog box. Unassigning alarms on remote servers To unassign alarms on remote servers (VNMs), you must create troubleshooters with the same name on all servers. In the following example, EAM has access to alarms on VNMs #1 and #2. Example: 1 Connect to VNM #1, create a troubleshooter and make some assignments to alarms on both VNMs. 2 Exit EAM 3 Connect to VNM #2. 4 Select an alarm that has an assignment you just made (on VNM #1) and try to unassign the alarm. The following error message appears: None of the selected alarms can be unassigned. This is either because 1) none of the selected alarms have assignments, 2) the alarms are assigned to another user s troubleshooter which you do not have access to, or 3) the alarms are assigned to a troubleshooter which was created on a remote landscape. 5 Create a troubleshooter with the same name as the one created on VNM #1. 6 Unassign the same alarm as above. In this case, the unassignment works. Creating Troubleshooters The Create Troubleshooter dialog box allows you to create troubleshooters for use by your User model only. Enterprise Alarm Manager User s Guide Page 56

57 Destroying Troubleshooters To create a troubleshooter: 1 Select Troubleshooter > Create, or click the Create Troubleshooter button. 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 -53.) Troubleshooter Name Table 14: The identity of the person who is to be responsible for troubleshooting network alarms. Address The valid address of the person designated above (optional). 3 Click OK to create the troubleshooter. Create Troubleshooter dialog buttons are: OK Creates the troubleshooter and closes the dialog box. Cancel Cancels all changes and closes the dialog box. Destroying Troubleshooters The Destroy Troubleshooter dialog box allows you to destroy one or more troubleshooters. Enterprise Alarm Manager User s Guide Page 57

58 Setting Preferences To destroy a troubleshooter: 1 Select Troubleshooter > Destroy, or click the Destroy Troubleshooter button. The Destroy dialog box is displayed. 2 Select the troubleshooters that you wish to destroy and click OK. 3 Click OK in the confirmation dialog box. The selected troubleshooters are now destroyed and removed from the list of available troubleshooters. Destroy dialog buttons are: OK Destroys the selected troubleshooter and closes the dialog box. Cancel Cancels all changes and closes the dialog box. 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. Figure 8 shows the EAM Preferences dialog box with the Display page selected. Enterprise Alarm Manager User s Guide Page 58

59 Figure 8: EAM Preferences Dialog Box Setting Preferences Enterprise Alarm Manager: Preferences Actions Alarm Update Control Connection Display Filter Notification Enable Sort From Column Headers Event Page Count 10 Filter/Search Delay (milliseconds) History Request Count Iconify At Startup Maximum Alarm History Count 5 Save Column Widths Make Changes Permanent Current User: root OK Cancel Apply Defaults WhatÕs This? Hints To access the Preferences dialog box, select Options > Preferences. The fields for the five tabbed pages are outlined below. Note: Default settings are shown in parentheses in the first column; deselected signifies a raised button, and selected signifies a recessed button. Enterprise Alarm Manager User s Guide Page 59