SPECTRUM Web Operator

Notice Copyright Notice Copyright 2001 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 252.227-7013(c)(1)(ii) and FAR 52.227-19. 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: http://www.aprisma.com/manuals/trademark-list.htm. 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 e-mail 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 52.227-14 (June 1987) Alternate III(g)(3) (June 1987), FAR 52.227-19 (June 1987), or DFARS 52.227-7013(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 03801 USA Phone: 603.334.2100 U.S. toll-free: 877.468.1448 Web site: http://www.aprisma.com Page 2

Contents Notice... 2 Preface... 10 Intended Audience...10 Text Conventions...10 Document Feedback...11 Online Documents...11 Getting Started... 12 About...12 Web Operator Foundation...13 Alarm Manager...13 Alarm Ticker...13 Model Browser...13 Quick Search...13 User Administration...13 Web Operator Suite...14 Alarm and Event Reports...14 Alarm and Event Presentation Editors...14 Model Search...14 Custom Collections...14 Working with Web Operator... 15 Starting...15 Using Web Operator Links...17 Using the Navigational Links Menu...17 Using Hints...18 Using the Filter Tool...18 Filtering Search Results...19 Removing a Filter...19 Sorting Column Data...20 Sorting Search Results...21 Page 3

Customizing Web Operator...21 Closing Web Operator...21 Working with Quick Search... 22 Overview...22 Searching SPECTRUM Models...22 Using the Search Results Table...23 Filtering Search Results...23 Sorting Search Results...23 Creating a Custom Collection...24 Destroying a Model...24 Refreshing the Search Results Table...25 Working with Alarm Manager... 26 Overview...26 Accessing Alarm Manager...27 Understanding Color-Coded Alarms...27 Using the Alarm List...28 Viewing Additional Alarms...28 Sorting Alarms by Column Category...28 Filtering the Alarm List...28 Clearing Alarms...29 Acknowledging Alarms...29 Unacknowledging Alarms...29 Opening the Alarm Details View...29 Opening the Primary and Secondary Alarms View...30 Opening Model Browser...30 Viewing the Alarm Description...30 Using the Alarm Details View...31 Opening Model Browser...32 Viewing the Alarm Description...32 Opening the Alarm List...32 Acknowledging Alarms...32 Unacknowledging Alarms...32 Page 4

Clearing Alarms...32 Editing the Set Status Text...33 Opening the Details View...33 Setting the Model Notes Text...33 Viewing Alarm Event Information...34 Viewing Historical Events...34 Using the Ping Utility...34 Using the Telnet Utility...34 Using the Primary and Secondary Alarms View...35 Using the Contributory Alarms for Rollup Condition View...36 Accessing the Contributory Alarms for Rollup Condition View...36 Working with the Contributory Alarms for Rollup Condition View.37 Working with the Alarm Ticker... 38 Overview...38 Accessing the Alarm Ticker...38 Using the Alarm Ticker...38 Working with Model Browser... 39 Overview...39 Accessing Model Browser...40 Using the Domain Details Area...42 Opening the Choose a Managed Domain List...42 Opening the Choose a View List...42 Navigating in Model Browser...42 Using the Location Area...43 Using the Details Area...44 Opening the Primary and Secondary Alarms View...44 Opening the Contributory Alarms View...45 Adding a Model to a Custom Collection...45 Creating a Container...46 Creating a Device Model...47 Using the Contents Table...48 Filtering the Contents Table...48 Page 5

Sorting the Contents Table...48 Adding a Model to a Custom Collection...49 Creating a Pipe...49 Opening the Model Pipes View...50 Destroying a Pipe...51 Destroying a Model...51 Opening the Primary and Secondary Alarms View for a Specific Model...52 Opening Model Browser for a Specific Model...52 Working with Custom Collections... 53 Overview...53 Accessing Custom Collections...54 Creating a Custom Collection...55 Deleting a Custom Collection...55 Adding a Model to a Custom Collection...56 Deleting a Model from a Custom Collection...56 Working with Model Search... 57 Overview...57 Accessing Model Search...57 Using the Choose a Search List...58 Opening the Description View...58 Filtering the Choose a Search List...58 Sorting the Choose a Search List...58 Performing a Search That Does Not Require User Input...59 Performing a Text-Based Search...59 Performing a Network Address or IP Address Search...60 Performing a MAC Address Search...62 Performing a Time-Based Search...63 Working with Alarm Reports... 64 Overview...64 Accessing the Alarm Reports Range Selection View...65 Page 6

Using the Database Information List...66 Using the Alarm Report Range Selection Calendar...67 Generating a Report Containing All Historical Alarm Data...68 Generating a Range of Dates Report...69 Generating a Single Time Unit Report...69 Using Alarm Reports in the Table View...70 Opening the Model Breakout View...70 Opening the Alarm Description View...71 Opening the Alarm Presentation Editor...71 Opening an Alarm Report for a Specific Time Unit...71 Using Alarm Reports in the Chart View...72 Using the Alarm Presentation Editor...73 Expanding the Alarm Grouping Tree...74 Expanding or Collapse the Alarm Grouping Tree...74 Changing a Hexadecimal Number to an Alarm Type Title...74 Creating a New Alarm Group...74 Moving Groups or Alarm Types...74 Editing Groups or Alarm Types...75 Deleting Groups or Alarm Types...75 Searching for Alarm Types...75 Using the Model Breakout View...76 About Deleted, Unreachable, and Unnamed Models...77 Opening Model Browser for a Specific Model...77 Opening the Archive Data View...77 Opening the Alarm Manager...77 Using the Archive Data View...78 Working With Event Reports... 79 Overview...79 Accessing the Event Report Range Selection View...80 Using the Database Information List...81 Using the Event Report Range Selection Calendar...82 Generating a Report Containing All Historical Event Data...83 Page 7

Generating a Range of Dates Report...84 Generating a Single Time Unit Report...84 Using Event Reports in the Table View...85 Opening the Model Breakout View...85 Opening the Event Presentation Editor...86 Opening an Event Report for a Specific Time Unit...86 Using Event Reports in the Chart View...87 Using the Event Presentation Editor...88 Expanding the Event Grouping Tree...89 Expanding or Collapse the Event Grouping Tree...89 Changing a Hex Number to an Event Type Title...89 Creating a New Event Group...89 Moving Groups or Event Types...89 Editing Groups or Event Types...90 Deleting Groups or Event Types...90 Searching for Event Types...90 Using the Model Breakout View...91 About Deleted, Unreachable, and Unnamed Models...91 Opening Model Browser for a Specific Model...91 Opening the Archive Data View...92 Opening the Alarm Manager...92 Using the Archive Data View...92 Working with User Administration... 93 Overview...93 Accessing User Administration...94 Using Administration Application...95 Expanding the User Tree...96 Expanding or Collapse the Group Tree...96 Creating an Administrator Group...96 Assigning Permissions Globally...96 Assigning Permissions to Individual Users...97 Creating a New User...97 Page 8

Moving Groups or Users...98 Editing Groups or User Names...98 Deleting Groups or Users...98 Searching for Specific Users...98 Table Columns... 99 Alarm Details Table... 103 Model Browser Details Table... 105 Page 9

Preface In this section: Intended Audience [Page 10] Text Conventions [Page 10] Document Feedback [Page 11] Online Documents [Page 11] Intended Audience This guide is intended for users with the appropriate access privileges who want to use to monitor and manage their infrastructure. Text Conventions The following text conventions are used in this document: Element Convention Used Example User-supplied parameter names Courier in angle brackets <>. The user needs to type the password in place of <password>. 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 number) Underlined and hypertextblue Italic See Document Feedback [Page 11]. SPECTRUM Installation Guide (9030675) SPECTRUM Administrator Guide (9035079) Page 10

Document Feedback Please send feedback regarding SPECTRUM documents to the following e-mail address: spectrum-docs@aprisma.com Thank you for helping us improve our documentation. Online Documents SPECTRUM documents are available online at: http://www.aprisma.com/manuals Check this site for the latest updates and additions. Page 11

Getting Started In this section: About [Page 12] Web Operator Foundation [Page 13] Web Operator Suite [Page 14] About combines enterprise-wide management features with a flexible Web browser interface and allows access to the SPECTRUM Knowledge Base from a Web browser at any time, from anywhere. Web Operator also provides a tightly integrated foundation for current and future SPECTRUM applications. Web Operator Foundation consists of the Alarm Manager, Alarm Ticker, Model Browser, Quick Search, and User Administration applications. Web Operator Suite, in addition to the Foundation applications, consists of Model Search, Custom Collections, Alarm and Event Reports, and Alarm and Event Presentation Editors. The entire Suite allows time-saving interactive access to distributed SPECTRUM data through simple, easy-touse Web browser interfaces. Page 12

Web Operator Foundation Web Operator Foundation provides the basic features necessary to perform the day-to-day tasks of monitoring and managing your infrastructure. The specific Foundation applications are outlined below. Alarm Manager Alarm Manager alerts you to all critical, major, and minor alarms occurring on the network and displays new alarms as they occur. From Alarm Manager you can access additional views for specific alarm details and any secondary alarms occurring on a model. From the Details view, you can clear, acknowledge, set status, as well as get alarm information, such as events and history. Alarm Ticker The Alarm Ticker allows you to view alarm information at all times with a minimal footprint on the desktop, while offering quick access to Alarm Manager when additional details are required. Alarm counts are kept for all critical, major, and minor alarms within the Alarm Ticker view using a familiar stock ticker style display of SPECTRUM critical alarms. Model Browser Model Browser allows you to view model information appropriate for network entities, indicating where they exist in the model hierarchy, as well as the child models they contain. You can view models by their hierarchy, organization, or location. Quick Search Quick Search is available from all applications and allows you to quickly search for a network address, Media Access Control (MAC) address, or a specific model name. User Administration The User Administration application allows Web Operator administrators to add, delete, edit, and group Web Operator users. Access to individual applications may be granted or revoked on a per-user or per-group basis. Groups can be used to establish roles and assign the appropriate tools for those roles. Page 13

Web Operator Suite Web Operator Suite bundles together Web Operator Foundation, historical alarm and event reporting, Model Search, and Custom Collections. Alarm and Event Reports The reports provided in Web Operator Suite present statistical records of both the alarms and events that occur within SPECTRUM. Aggregating data from all the SpectroSERVERs, the alarm and event reports group alarms and events into categories and totals. Counts are also shown for each event or alarm for a day, week, or month, or ranges of days, weeks, and months. Alarm and Event Presentation Editors The editors allow you to customize the alarm and event reports to suit specific network configuration needs. You can edit alarm type names and group them in newly created alarm groups, edit group names, and move groups and alarm type names using the editors tools. Model Search Model Search allows you to search for models based on model type, status, and classification (for example, routers, switches or hubs). Your Web Operator administrator can create custom searches using SPECTRUM Search Manager. Custom Collections Custom Collections allows you to create groups of models without being restricted by model type or landscape. Custom Collections are defined and displayed by user or group, based on preferences stored in the SPECTRUM user model. Each user can have any number of collections, and these can be specific to the devices, ports, applications, or any other model within SPECTRUM. Additionally, this application allows you to easily add models to existing collections or create new collections. Page 14

Working with Web Operator In this section: Starting [Page 15] Using Web Operator Links [Page 17] Using the Navigational Links Menu [Page 17] Using Hints [Page 18] Using the Filter Tool [Page 18] Sorting Column Data [Page 20] Customizing Web Operator [Page 21] Closing Web Operator [Page 21] Starting Before you can begin using, your administrator must set up your workstation and provide you with a user name and password. For more information about user administration, see Working with User Administration [Page 93]. Procedure 1. Start your Web browser. 2. Do one of the following: If the port you specified during installation is 80 (the default), point your Web browser to the following URL: http://<hostname>/spectrum/ where <hostname> is the name of the workstation on which you installed. If the port you specified during installation is not 80, point your Web browser to the following URL: http://<hostname>:<portnumber>/spectrum/ where <hostname> is the name of the workstation on which you installed and <portnumber> is the port number specified during the installation. Page 15

3. Enter your user name and password. This opens the Web Operator Home page shown in Figure 1. Figure 1: Web Operator Home Page Application Menu View Indicator Quick Search Update Password Logout Page 16

Using Web Operator Links The home page, shown in Figure 1 [Page 16], is the first view that appears after you log on to Web Operator. The work area at the top of the page appears on every Web Operator view and provides the items listed in the following table: Item Application Menu View Indicator Quick Search Update Password Logout Description Provides links to each Web Operator Application that is available to you. The applications you see depend on whether you are using Web Operator Foundation or Web Operator Suite. Your Web Operator administrator can also limit the applications you see on this menu. Displays the name of the Web Operator application you are current using. Allows you to quickly locate SPECTRUM models. Allows you to change your Web Operator password. Allows you to log out of Web Operator. Using the Navigational Links Menu After you select a Web Operator application, the Navigational Links menu shown in Figure 2 appears. This menu appears in all applications, and depending on the application, displays links to other views. Figure 2: Navigational Links Menu Displays copyright information and provides links to Aprisma s Web site and support Opens on-line hints for current application Opens the Web Operator home page Page 17

Using Hints Hints are the Web Operator online reference book. They contain information on using commands, performing tasks, and some information that is not available in this guide. To open the online hints system, do one of the following: On the Navigational Links menu, select hints. Click the button. Using the Filter Tool The Filter tool, shown in Figure 3, lets you reduce the number of items in the various tables found in Alarm Manager, Model Browser, Custom Collections, Quick Search, and Model Search, by displaying only items that match the string of letters or numbers you type into the Filter. For example, if you leave the Filter's selector button on All and type 10.153 into the Filter, the table will be redrawn with only rows that contain the string 10.153 in one of the data columns. A more restrictive filter is set if you change the Filter selector button from All to one of the named column headings, such as Condition or Name. Figure 3: Filter Tool Total Items Total Items Displayed Page 18

Filtering Search Results 1. In the Filter list, do one of the following: To display items from all data columns, select All. To display items from a specific data column only, select that column heading. 2. In the text box, type a string of letters or numbers. Partial matches are allowed, and are not case sensitive. 3. Click Go. Removing a Filter 1. In the Filter list, select All. 2. In the text box, clear all letters or numbers. 3. Click Go. Page 19

Sorting Column Data You can rearrange column data by using the sort boxes described in Table 1. For example, if you want to sort the table by model name, click the box in the Name column heading and the table will sort by the descending alphabetical order of the Name column. Another click in the same sort box inverts the sorting order to ascending on the Name column. Table 1: Sort Boxes Icon Description No triangle in the box means that column's data is not sorted. This is the primary sort button. The entire table is sorted according to the data in that column. This is the secondary sort button. The secondary sort will only apply if the data in the primary sorted column happens to have multiple identical items, in which case those items will, relative to each other, be sorted according to the data in the secondary sorted column. This is the tertiary sort button. Page 20

Sorting Search Results 1. Click a column s sort box to make that column the primary sort for the search results table. Another click in the same sort box inverts the sorting order. Clicking in this same column reverses the sort order, and the sort button triangle inverts. 2. Click the next column s sort box to make that column the primary sort and the previously selected column the secondary sort. 3. Click the next column s sort box to make that column the primary sort, the previously selected column the secondary sort, and the first column the tertiary sort. Note: When you move the primary sort from one column to another, the previous column becomes the secondary sort, and the original secondary sort becomes the Tertiary. Customizing Web Operator The Administrator Guide (9035079) provides instructions for customizing Web Operator to best suit your needs. By modifying Web Operator preference files, you can add, remove, and rearrange table column headings for each application. You can also change filtering and sorting defaults, as well as select display options. Closing Web Operator 1. Click the logout link. 2. Click Yes, log me out now. Page 21

Working with Quick Search In this section: Overview [Page 22] Searching SPECTRUM Models [Page 22] Using the Search Results Table [Page 23] Overview Web Operator s Quick Search, shown in Figure 4, allows you to quickly locate SPECTRUM models. You can search by model name, network address, or MAC address. Figure 4: Quick Search Input Box Searching SPECTRUM Models 1. In the SEARCH list, select Model Name, Network Address, or MAC Address. 2. In the input box, do one of the following: To search by Model Name, type the name of the model. Partial matches are allowed, and are not case sensitive. To search by Network Address, type the complete address in decimal notation (for example, 100.0.0.0 ). To search by MAC Address, type the complete address in decimal notation (for example, 9A.4F.1C.FF.FF.FF ). 3. Click go. Your search results appear in the search results table shown in Figure 5 [Page 23]. Page 22

Using the Search Results Table The search results table displays the results of your search, provides links to other views, and provides filtering and sorting tools. For a description of each data column in the table, see Table 2 [Page 99]. Figure 5: Quick Search Results Table Filtering Search Results The Filter tool lets you reduce the number of items in the search results table by displaying only items that match the string of letters or numbers you type into the Filter. For more information, see Using the Filter Tool [Page 18]. Sorting Search Results If your search retrieved a large number of models, the search results table may be so big that you will need to sort your work. For more information, see Sorting Column Data [Page 20]. Page 23

Creating a Custom Collection A custom collection lets you create a group of specific models that you can display in a single view. You can open a customized view at any time by selecting Custom Collections from the Applications menu. Procedure 1. In the Select All/Deselect All column, do one of the following: To add all models to a collection, click the Select All link. To add specific models to a collection, select the check box. Note: The maximum number of models that you can add to a custom collection at one time is 115. 2. Click Add to Collection. 3. In the Add to Collection view, do one of the following: To add to an existing collection, select the name of the collection. To create a new collection, type the name you want for the new collection, and then click Create. The Custom Collections view displays the models you just added to the existing or new collection. Destroying a Model Important: When you click Destroy Model (after selecting a model), be aware that you are not given a warning, and the model is destroyed immediately. Procedure 1. In the Select All/Deselect All column, select the check box of the model you want to destroy. 2. Click Destroy Model. Note: When a model is destroyed using the Destroy Model button, its record remains in the Custom Collection until you explicitly remove it from the collection. Page 24

Refreshing the Search Results Table For rapidly changing network conditions, you may want to re-run the search to check the current state of the models in the results table. Procedure 1. Right-click anywhere in the search results table. 2. Select Reload or Refresh (or whatever term your Web browser uses for reloading the frame). Page 25

Working with Alarm Manager In this section: Overview [Page 26] Accessing Alarm Manager [Page 27] Understanding Color-Coded Alarms [Page 27] Using the Alarm List [Page 28] Using the Alarm Details View [Page 31] Using the Primary and Secondary Alarms View [Page 35] Using the Contributory Alarms for Rollup Condition View [Page 36] Overview Alarm Manager alerts you to all critical, major, and minor alarms occurring on the network and displays new alarms as SPECTRUM generates them and as the Alarm List is refreshed. Alarm Manager has one major view, the Alarm List, and two additional views accessed using links within the Alarm List: the Alarm Details view, and the Primary and Secondary Alarms view. You can access another Alarm Manager view, called Contributory Alarms for Rollup Condition, from any Web Operator application that lists a model s rollup condition. Page 26

Accessing Alarm Manager On the Applications menu, select Alarm Manager. The Alarm List shown in Figure 6 appears. Figure 6: Alarm List Understanding Color-Coded Alarms Web Operator uses the following color codes to indicate an alarm s severity: Alarm Icon Description Red (Critical) Orange (Major) Yellow (Minor) A loss of service has occurred, and immediate action might be required. A loss of service has occurred or is impending. Usually requires no action be taken; often only conveys system information (for example, Duplicate IP). Page 27

Using the Alarm List The Alarm List displays alarms from most severe to least severe. Critical alarms appear at the top of the list followed by groups of major and then, minor alarms. In each alarm group, the most recent alarms appear first. For a description of each data column in the Alarm List, see Table 2 [Page 99]. Note: The list order changes as sorting is applied. Viewing Additional Alarms If the Alarm List contains more than 300 alarms, a link to the remaining alarms appears at the top and bottom of the list (for example, Next 86 alarms >>). As new alarms are generated and displayed, the most severe alarms are listed before less severe alarms, and the order of alarms is shifted downward. For example, if one new critical alarm comes in, alarm 300 becomes alarm 301 and, after the list is refreshed, alarm 301 moves to the next page. Sorting Alarms by Column Category Click the sort boxes in the column headers to sort the Alarm List by column category (Severity, Date/Time, etc.). When more than 300 alarms are listed, sorting operates only on the current page you are viewing and does not, for example, move alarms currently on page 3 to page 1. However, when you page up or down after establishing a new sort order, this sort is applied to the page you are viewing. For more information, see Sorting Column Data [Page 20]. Filtering the Alarm List The Filter tool allows you to display only selective alarms based on column category (Severity, Date/Time, etc.) and subcategory (Minor, Wednesday, etc.). When more than 300 alarms are listed, filtering operates only on the current page you are viewing and does not, for example, move alarms currently on page 3 to page 1. However, when you page up or down after setting a new filter criteria, the filter is applied to the page you are viewing. For more information, see Using the Filter Tool [Page 18]. Page 28

Clearing Alarms 1. In the Select All/Deselect All column, do one of the following: To clear all alarms, click the Select All link. To clear a specific alarm, select that model s check box. 2. Click Clear. 3. In the Confirm Clear view, do one of the following: If you want to clear the alarm, click OK. If you decide not to clear the alarm, click Cancel. Acknowledging Alarms 1. In the Select All/Deselect All column, do one of the following: To acknowledge all alarms, click the Select All link. To acknowledge a specific alarm, select that model s check box. 2. Click Acknowledge. 3. In the Acknowledge view, click the Display updated view link. 4. Verify that a check mark appears in the Acknowledged column indicating that the alarm was successfully acknowledged. Unacknowledging Alarms 1. In the Select All/Deselect All column, do one of the following: To unacknowldege all alarms, click the Select All link. To unacknowledge a specific alarm, select that model s check box. 2. Click Unacknowledge. 3. In the Unacknowledge view, click the Display updated view link. 4. Verify that the check mark is cleared from in the Acknowledged column indicating that the alarm was successfully unacknowledged. Opening the Alarm Details View Click the Alarm Details icon Alarm Details View [Page 31].. For more information, see Using the Page 29

Opening the Primary and Secondary Alarms View Click the Secondary Alarms icon. For more information, see Using the Primary and Secondary Alarms View [Page 35]. Note: Alarm Manager may take a while to gather primary and secondary alarms. If no secondary alarms are detected, the message No Secondary Alarms appears at the bottom of the view. Opening Model Browser Click a link in the Name column (for example, 10.253.91.120) to open Model Browser. For more information, see Working with Model Browser [Page 39]. Viewing the Alarm Description Click a link in the Alarm Type column to open a view displaying the symptoms, probable causes, and recommended actions for the alarm. Page 30

Using the Alarm Details View The Alarm Details view, shown in Figure 7, provides alarm-specific information and, if you have permissions, lets you acknowledge, unacknowledge, and clear alarms. You can also write alarm status information, and write notes about alarms using the toolbar links. For a description of each item in the Alarm Details view, see Table 3 [Page 103]. Note: Actions you take on alarms in the Alarm Details view displays immediately in SPECTRUM s Enterprise Alarm Manager. Figure 7: Alarm Details View Alarm Details toolbar Page 31

Opening Model Browser In the Name row, click the model name to open Model Browser and view additional details about the device. Viewing the Alarm Description In the Alarm Type row, click the alarm description to open a view describing the symptoms, probable causes, and recommended actions for the alarm. Opening the Alarm List On the Alarm Details toolbar, click alarm list to open Alarm Manager, where you can view a list of all critical, major, and minor alarms occurring on the network. Acknowledging Alarms 1. On the Alarm Details toolbar, click acknowledge. 2. In the Alarm Acknowledged view, click the Display updated view link. 3. In the Alarm Details view, verify that Yes appears in the Acknowledged row. Unacknowledging Alarms 1. On the Alarm Details toolbar, click unacknowledge. 2. In the Alarm Unacknowledged view, click the Display updated view link. 3. In the Alarm Details view, verify that No appears in the Acknowledged row. Clearing Alarms 1. On the Alarm Details toolbar, select clear. 2. In the Confirm Clear view, click Ok to clear the alarm. Note: If you do not want to clear the alarm, click Cancel to return to the Alarm Details view. 3. In the Alarm Cleared view, click the Display updated view link. 4. Verify that the alarm does not appear in the Alarm List. Page 32

Editing the Set Status Text 1. On the Alarm Details toolbar, select set status. 2. In the Set Alarm Status view, type the status of the alarm. Note: The purpose of status is to provide details for someone else who may look at the alarm later. Alarm status notes are removed from the model when the alarm is cleared. 3. Do one of the following: Click Save Alarm Status to save your text. Click Reset to clear your text and retype the status of the alarm. 4. In the Alarm Details view, verify that your text appears in the Status row. Opening the Details View On the Alarm Details toolbar, select details. This link is useful if you are viewing an alarm s historical event summary or event information and want to return to the Alarm Details view. Setting the Model Notes Text 1. On the Alarm Details toolbar, select set notes. Note: If you do not have permission to set notes, the panel will simply display model notes, if any have been written. 2. In the Set Model Notes view, type your model notes. Note: The purpose of model notes is to provide another operator useful information about the model (for example, this device has a sticky reset button ). Model notes stay with the model until you delete or edit them. 3. Do one of the following: Click Save Model Notes to save your text. Click Reset to clear your text and retype your model notes. 4. In the Alarm Details view, verify that your text appears in the Model Notes row. Note: The model notes also appear in the Details area of Model Browser. Page 33

Viewing Alarm Event Information On the Alarm Details toolbar, select events to view a list of the selected alarm event information. Viewing Historical Events On the Alarm Details toolbar, select history to view a list of five or fewer historical alarm summaries for the selected model. These summaries provide a record of when alarms were generated and cleared. 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 (for example, Alarm 1 ) is the first to appear in the list. Using the Ping Utility On the Alarm Details toolbar, select ping to ping the device on which the alarm is occurring. The results display in a separate view. Note: The ping utility appears on the Alarm Details toolbar only if the model has a network address. Using the Telnet Utility On the Alarm Details toolbar, select telnet to telnet to the device on which the alarm is occurring. This opens a telnet session view. Note: The telnet utility appears on the Alarm Details toolbar only if the model has a network address. Page 34

Using the Primary and Secondary Alarms View Viewing primary and secondary alarms on a model (Figure 8) allows you to see all the alarms on that model rather than just the most severe alarms on the network (as is the case in Alarm Manager s main Alarm List). Primary alarms are indicated by a check mark in the Primary Alarm column at the far right of the list (not shown below). Any other alarms are secondary alarms. The message No Secondary Alarms displays below the Filter field when none are present. To use the Primary and Secondary Alarms view, do the following: To view all alarms, select the all alarms link on the toolbar. To perform all other tasks, refer to Using the Alarm List [Page 28]. Note: The tasks you can perform in the Alarm List are the same as those in the Primary and Secondary Alarms view. Figure 8: Primary and Secondary Alarms View Page 35

Using the Contributory Alarms for Rollup Condition View The Contributory Alarms for Rollup Condition (Figure 9) displays all the alarms, contributing, from whatever level, to the Rollup Condition of a container model. Often a Rollup Condition on a container model is the indirect result of alarms occurring on more than one level of the modeling hierarchy. Some alarms, for example, may be occurring on child models within the container model, while other alarms are occurring on models contained within the child models, and so forth as the hierarchy extends. When a device model or unplaced model type (rather than a container model) is encountered as the application is collecting alarms in recursively lower levels, alarms on that device model (or unplaced model) are displayed, but the recursion stops there, and no alarms on model levels within the device model are displayed. Figure 9: Contributory Alarms For Rollup Condition View Accessing the Contributory Alarms for Rollup Condition View To access the Contributory Alarms for Rollup view, select a critical, major, or minor alarm condition under the Rollup Condition field or column in any Web Operator application. Page 36

Working with the Contributory Alarms for Rollup Condition View To use the Contributory Alarms for Rollup Condition view, do the following: To view all alarms select the all alarms link on the toolbar. To perform all other tasks, refer to Using the Alarm List [Page 28]. Note: The tasks you can perform in the Alarm List are the same as those in the Contributory Alarms for Rollup Condition view. Page 37

Working with the Alarm Ticker In this Section: Overview [Page 38] Accessing the Alarm Ticker [Page 38] Using the Alarm Ticker [Page 38] Overview The Alarm Ticker displays scrolling alarm information in a separate browser view. Alarm counts are kept for all critical, major, and minor alarms within the Alarm Ticker view using a familiar stock ticker style display of SPECTRUM alarms. Accessing the Alarm Ticker On the Applications menu, select Alarm Ticker. The Alarm Ticker view shown in Figure 10 appears. Figure 10: Alarm Ticker View Using the Alarm Ticker To use the Alarm Ticker, do the following: To view alarm details, click Alarm Manager. To change the scrolling speed, place your cursor inside the scroll area, click and hold the left mouse button, and drag the cursor until you achieve the desired speed. Page 38

Working with Model Browser In this section: Overview [Page 39] Accessing Model Browser [Page 40] Using the Domain Details Area [Page 42] Using the Location Area [Page 43] Using the Details Area [Page 44] Using the Contents Table [Page 48] Overview Model Browser details one model at a time displaying information about this model in three areas: Location Details Model Details Contents It describes where a model is located in the SPECTRUM model hierarchy, provides details about the model, and lists all models contained in the target model. Page 39

Accessing Model Browser 1. Do one of the following: On the Applications menu, select Model Browser. From any Web Operator application except the Alarm Ticker, click the name link (for example ). 2. Do one of the following: If the Choose a Managed Domain list shown in Figure 11 appears, select the domain you want to browse. If the Choose a View list appears, proceed to Step 3. Note: The Choose a Managed Domain list appears only if other domains are present on the network. Figure 11: Choose a Managed Domain List Page 40

3. In the Choose a View list, shown in Figure 12, do one of the following: To browse models in the Topology view, click the Universe link. To browse models in the Location view, click the World link. To browse models in the Organization view, click the Top_Org link. Note: You can browse within all three SPECTRUM model hierarchies (Topology, Location, and Organization) only if all three have been modeled in SpectroGRAPH. Figure 12: Choose a View List Page 41

Using the Domain Details Area The Domain Details area, shown in Figure 13, indicates the domain you are browsing. If other domains are present, it provides a Global Domain link that takes you to the Choose a Managed Domain list. The Global Domain link is not active if only one domain is present. This area also provides links to the Location area, Details area, and Contents table. Figure 13: Domain Details Area Opens the Choose a Managed Domain table (if other domains are present) Navigates to the Location area, Details area, or Contents table Opens the Choose a View list Opening the Choose a Managed Domain List If other domains are present, click the Global Domain link to open the Choose a Managed Domain list. The Global Domain link is not active if only one domain is present. Opening the Choose a View List Click the Managed Domain link (for example, mowglis.aprisma.com) to open the Choose a View list. Navigating in Model Browser Click the Location, Details, or Contents link to navigate in Model Browser. Page 42

Using the Location Area The Location area, shown in Figure 14, displays your current location in the model hierarchy. You can use the links in the Topology View column to move up from the model you started with or use the Contents table (see Using the Contents Table [Page 48]) to move down into the child models it contains. Figure 14: Location Area Links to move up the model hierarchy from the current model Page 43

Using the Details Area The Details area, shown in Figure 15, always displays a Model Information panel and may contain an additional panel with details about the model within its particular Model Class (for example, Network Information or Bridge Information). For a description of each item in the Details area, see Table 4 [Page 105]. Figure 15: Details Area Opening the Primary and Secondary Alarms View If the model in the Details area indicates a critical, major, or minor condition, you can click the alarm link (for example ) in the Condition row to open the Primary and Secondary Alarms view. Note: Alarm Manager may take a while to gather primary and secondary alarms. If no secondary alarms are detected, the message No Secondary Alarms appears at the bottom of the view. Page 44

Opening the Contributory Alarms View If the model in the Details area indicates a critical, major, or minor condition, you can click the alarm link (for example ) in the Rollup Condition row to open the Contributory Alarms view. For more information about Contributory Alarms, see Using the Contributory Alarms for Rollup Condition View [Page 36]. Adding a Model to a Custom Collection 1. Click Add to Collection. 2. In the Add to Collection view, do one of the following: If you want the model to be added to an existing collection click the name of the collection. If you want the model to be part of a new collection, type the name you want for the new collection in the Name a New Collection box. 3. Click Create. 4. Do one of the following: If the add to collection operation succeeded, verify that the Custom Collections view appears with the name of the collection you appended or created. If the add to collection operation failed, an error message appears, and you must enter the correct information. Page 45

Creating a Container You can create a container inside the model detailed in the Model Information panel (see Figure 15 [Page 44]). The newly created container appears in the Contents area, and the Child Count number increases by one. 1. In the Details area, click Create Container. This opens the Create Container Model view, shown in Figure 16. Figure 16: Create Container Model View 2. In the Create Container Model view, do the following: In the New Container Name box, enter the name of the new container. In the Container Model Type list, select the type of container (for example, ATM_Cloud or LAN_802.3). If the container is an EventAdmin model, enter an IP address in the New Container IP Address box 3. Click Create Container Model. 4. Do one of the following: If the create container operation succeeds, click the Display updated view link and verify that your new container appears in the Contents area. If the create container operation fails, an error message appears, and you must enter the correct information. Page 46

Creating a Device Model You can create a device model inside the model being browsed. 1. In the Details area, click Create Device. This opens the Create Device Model view, shown in Figure 17. Figure 17: Create Device Model View 2. In the Create Device Model view, do the following: In the New Model IP Address box, type the IP address of the new model. In the Community Name box, type the community name of the new model. 3. Click Create Device Model. 4. Do one of the following: If the create device model operation succeeded, click the Display updated view link and verify that your new device appears in the Contents area. If the create device model operation failed, an error message appears, and you must enter the correct information. Page 47

Using the Contents Table The Contents table is either a model table listing all models that reside within the target model, as shown in Figure 18, or an interface table listing all the interfaces on the device. For example, the Contents table for the Universe model of the Topology view lists each of the child models that populates the selected landscape s SpectroGRAPH Topology Universe view. For a description of each data column in the Contents area, see Table 2 [Page 99]. Note: If the target model has no models or interfaces that reside within it, the Contents table will simply indicate This model does not have any contents. Figure 18: Contents Table Filtering the Contents Table The Filter tool lets you reduce the number of items in the Contents table by displaying only items that match the string of letters or numbers you type into the Filter. For more information, see Using the Filter Tool [Page 18]. Sorting the Contents Table If the Contents table contains a large number of models, you will need to sort your work. For more information, see Sorting Column Data [Page 20]. Page 48

Adding a Model to a Custom Collection 1. In the Select All/Deselect All column, do one of the following: To add all models to a collection, click the Select All link. To add specific models to a collection, select the model s check box. 2. Click Add to Collection. 3. In the Add to Collection view, do one of the following: If you want the model to be added to an existing collection click the name of the collection. If you want the model to be part of a new collection, type a name for the new collection in the Name a New Collection box. 4. Click Create. 5. Do one of the following: If the add to collection operation succeeded, verify that the Custom Collections view appears with the name of the collection you appended or created. If the add to collection operation failed, an error message appears, and you must enter the correct information. Creating a Pipe 1. In the Select All/Deselect All column, select the check boxes of exactly two models you want to connect. 2. Click Create Pipe. 3. Do one of the following: If the create pipe operation succeeded, click the Display updated view link and verify that a link appears in the Model Pipes column of the two models you just connected. If the create pipe operation failed, read the error message and try again. Page 49

Opening the Model Pipes View Network connections are collectively represented as logical links called pipes. The Model Pipes view allows you to see all the models connected to another model. This view is a subset of models listed in the Contents table, and lists only those models connected to a specific model. To open the Model Pipes view: In the Model Pipes column, click the pipes link (for example Model Pipes view, shown in Figure 19 [Page 50], appears. ). The Note: The number in the Model Pipes column indicates how many logical links are connected to the model. Figure 19: Model Pipes View Page 50

Destroying a Pipe Important: When you click Destroy Pipe (after selecting two models), be aware that you are not given a warning, and the two models are immediately disconnected. Procedure 1. In the Model Pipes column, click the link (for example ) 2. In the Model Pipes view, select the check box next to the models you want to disconnect. 3. Click Destroy Pipe. 4. Do one of the following: If the destroy pipe operation succeeded, click the Display updated view link and verify that the model does not appear in the Model Pipes view. If the destroy pipe operation failed, read the error message and try again. Destroying a Model Important: When you click Destroy Model (after selecting a model), be aware that you are not given a warning, and the model is destroyed immediately. Procedure 1. In the Select All/Deselect All column, select the check box of the model you want to destroy. 2. Click Destroy Model. 3. Do one of the following: If the destroy model operation succeeded, click the Display updated view link and verify that the model does not appear in the Model Contents area. If the destroy model operation failed, read the error message and try again. Page 51

Opening the Primary and Secondary Alarms View for a Specific Model If a model in the Contents area indicates a critical, major, or minor condition, click the alarm link (for example ) in the Condition column to open the Primary and Secondary Alarms view for that model. Note: Alarm Manager may take a while to gather primary and secondary alarms. If no secondary alarms are detected, the message No Secondary Alarms appears at the bottom of the view. Opening Model Browser for a Specific Model In the Name column, click the name link (for example the Model Browser for that model. ) to open Page 52

Working with Custom Collections In this section: Overview [Page 53] Accessing Custom Collections [Page 54] Creating a Custom Collection [Page 55] Deleting a Custom Collection [Page 55] Adding a Model to a Custom Collection [Page 56] Deleting a Model from a Custom Collection [Page 56] Overview A Custom Collection lets you check the status of specific models, which may reside on different landscape domains, in a single view. You can open the Custom Collection view and access existing Custom Collections at any time by selecting Custom Collections from the Applications menu. Note: When a model is destroyed using the Destroy Models button, its record remains in the Custom Collection until you explicitly remove it from the collection. Page 53

Accessing Custom Collections For a description of each data column in the Custom Collections table, see Table 2 [Page 99]. Procedure 1. On the Applications menu, select Custom Collections. 2. In the Choose a Collection view, click the collection you want to open. This opens the Custom Collections view shown in Figure 20. Figure 20: Custom Collections View Page 54

Creating a Custom Collection You can create a Custom Collection from the Model Browser view, the Quick Search Results table, and the Model Search Results table. Procedure 1. Open the Model Browser view, Quick Search Results table, or Model Search Results table. 2. In the Select All/Deselect All column, do one of the following: To add all models to a collection, click the Select All link. To add specific models to a collection, select the check box. 3. Click Add to Collection. 4. In the Add to Collection view, type a name for the new collection, and then click Create. The Custom Collections view displays your new collection. Deleting a Custom Collection 1. On the Applications menu, select Custom Collections. 2. In the Choose a Collection list, select the Custom Collection you want to delete. 3. Click Delete this Collection. 4. Do one of the following: If you are sure that you want to destroy the collection, click the View Custom Collections link. If you decide not to destroy the collection, click the Undo link to return to the Choose a Collection list. Page 55

Adding a Model to a Custom Collection You can add models to a Custom Collection from the Model Browser view, the Quick Search Results table, and the Model Search Results table. Procedure 1. Open the Model Browser view, Quick Search Results table, or Model Search Results table. 2. In the Select All/Deselect All column, do one of the following. Select the check box of the models you want to add. Click the Select All link to add all models to a collection. Note: The maximum number of models that you can add to a Custom Collection at one time is 115. 3. Click Add to Collection. 4. Select the Custom Collection you want to add models to. The Custom Collections view appears with your new models. Deleting a Model from a Custom Collection 1. On the Applications menu, select Custom Collections. 2. Select the custom collection you want to change. 3. In the Select All/Deselect All column, do one of the following: To remove specific models from a collection, select that model s check box. To remove all models from a collection, click the Select All link. Note: The maximum number of models that you can delete from a custom collection at one time is 95. 4. Click Remove from Collection. Page 56

Working with Model Search In this section: Overview [Page 57] Accessing Model Search [Page 57] Using the Choose a Search List [Page 58] Overview Model Search allows you to search for models based on model type, status, and classification (for example, router, switch or hub). Your Web Operator administrator can create custom searches using SPECTRUM Search Manager. For more information on custom searches, see the SPECTRUM Web Operator Administrator Guide (9035079). Accessing Model Search On the Applications menu, select Model Search. The Choose a Search list shown in Figure 21 appears. Figure 21: Choose a Search List Page 57

Using the Choose a Search List The Choose a Search list displays the Aprisma-created searches and any custom searches that may have been created by your Web Operator administrator. The following table describes each data column in the Choose a Search list: Column Search Name Author Description Description Lists the Aprisma-created searches and any custom searches that may have been created by your Web Operator administrator. Displays Aprisma for predefined searches or the creator's SPECTRUM name for any searches created after Web Operator was installed. Click the description icon for: - Information about what the search will find. - A list of the specific SPECTRUM criteria which are used in the execution of the search. - Search criteria and recommendations for executing a search. Opening the Description View To read the input requirements for each search type, click the Description icon. Filtering the Choose a Search List The Filter tool at the bottom of the table lets you reduce the number of items in the list by temporarily hiding from view any items that do not contain the string of letters or numbers you type into the Filter. For more information, see Using the Filter Tool [Page 18]. Sorting the Choose a Search List If the Choose a Search list contains many searches, use the sort boxes in the column headings. For more information, see Sorting Column Data [Page 20]. Page 58

Performing a Search That Does Not Require User Input To perform a search that does not require user input, select one of the following search types: Alarm Conditions, Bridges, Brouters, Chassis Models, Critical Conditions, Devices, Devices in Maintenance, End Nodes, End Nodes or Pingable Models, Hubs, Links, Lost and Found, Models With Flash Green Enabled, Models With Unacknowledged Alarms, Networks, Routers, Switches, or Unacknowledged Models Not In Alarm Condition. Note: Searches that do not require input are case insensitive by default. Performing a Text-Based Search 1. In the Search Name column, select one of the following search names: Contact, Devices By Manufacturer Name, Model Name, Model Type, or System Location. 2. In the text-based input view (for example, the Model Name view, shown in Figure 22), type a search string. Note: For input requirements and a description of the search, select search requirements on the Navigational Links menu. Figure 22: Text-Based Input View 3. To search for models matching the case of your search string, select the Case Sensitive box. Page 59

4. To search on part of a search type, select the Partial Match check box. Note: If not checked, the search string must match the search name exactly. 5. Do one of the following: Click Find to start your search. Click Clear to clear your settings and start again. Note: If, after performing the search, you want to return to refine your input, use your Web browser s Back function to return to the input view. Performing a Network Address or IP Address Search In the context of SPECTRUM and this document, the network address is the primary IP address of a device, and the IP Address is the secondary or known IP address. A network address search finds any model with the network address you specify. This search is targeted at the particular network address that SPECTRUM uses to communicate with the SNMP agent of the modeled device. A secondary or known IP address search uses SPECTRUM s Secondary Address Locator Tool (SALT) to find the mib-advertised IP address. When the same model, such as a device or port, is known in different subnets of a network by different IP addresses, each such address is a known IP. SPECTRUM, however, uses only one IP address to manage a model, so in a sense SPECTRUM knows only one of a model s known IP addresses. For this reason, some models found by this search may not show the IP address you specified. Procedure 1. In the Search Name column, select one of the following search names: Device By Known IP Range (SALT), Device By One of Its Known IPs (SALT), Network Address, Network Address Range, Port By Known IP Range (SALT), or Port By One of Its Known IPs (SALT). 2. In the Network Address input view, shown in Figure 23 [Page 61], enter the exact, valid address you want to search for in decimal notation. Page 60

Note: For input requirements and a description of the search, select search description on the Navigational Links menu. Figure 23: Network Address Input View 3. If you want to find only models that represent network hardware entities, select the Show just device models check box. Note: This check box does not appear on all search types. If you remove the check from the Show just device Models box, the search results table displays all models within the range you enter, including containers, applications, and ports. 4. Do one of the following: Click Find to start your search. Click Clear to clear your settings. Note: If, after running the search, you want to return to refine your input, use your Web browser s Back function to return to the input view. Page 61

Performing a MAC Address Search 1. In the Search Name column, select one of the following search names: MAC Address MAC Address Range 2. In the MAC Address input view, shown in Figure 24, type the exact, valid MAC address you want to search for in decimal notation. Note: For input requirements and a description of the search, select search description on the Navigational Links menu. Figure 24: MAC Address-Based Input View 3. Do one of the following: Click Find to start your search. Click Clear to clear your settings. Note: If, after running the search, you want to return to refine your input, use your Web browser s Back function to return to the input view. Page 62

Performing a Time-Based Search 1. In the Search Name column, select one of the following search names: System Up Time Greater Than System Up Time Less Than 2. In the input view, shown in Figure 25, type a day limit in the day box. Note: For input requirements and a description of the search, select search description on the Navigational Links menu. Figure 25: Time-Based Input View 3. Enter a time limit using a 24-hour clock. Note: Limit your input of hours, minutes, and seconds to the normal maximums of 23:59:59. The initial preset input represents 30 minutes: [ 00 + 00:30:00 ]. 4. Do one of the following: Click Find to start your search. Click Clear to clear your settings. Note: If, after running the search, you want to return to refine your input, use your Web browser s Back function to return to the input view. Page 63

Working with Alarm Reports In this section: Overview [Page 26] Accessing the Alarm Reports Range Selection View [Page 65] Using the Database Information List [Page 66] Using the Alarm Report Range Selection Calendar [Page 67] Using Alarm Reports in the Table View [Page 70] Using Alarm Reports in the Chart View [Page 72] Using the Alarm Presentation Editor [Page 73] Using the Model Breakout View [Page 76] Using the Archive Data View [Page 78] Overview The Alarm Reports application allows you to view archived data on past alarms. The various views and levels of detail that these reports offer can help you: Assess the general health of your network. Identify historical trends in network alarms and events. Find recurring or cyclical problems. Locate specific models than have had specific alarms posted against them in the past (though they may currently be in a normal operating state). Page 64

Accessing the Alarm Reports Range Selection View To access the Alarm Reports Range Selection view: On the Applications menu, select Alarm Reports. This opens the Range Selection view shown in Figure 26. Figure 26: Alarm Reports Range Selection View Navigational Links Menu Range Selection Calendar Page 65

Using the Database Information List In the Alarm Reports Range Selection view, select Data Info on the Navigational Links menu to access the SPECTRUM Alarms & Event Reports Data Information list, shown in Figure 27. This view displays which SPECTRUM landscapes are represented in the resulting reports, and gives the precise time range covered for each landscape. Figure 27: SPECTRUM Alarms & Event Reports Data Information List Indicates the exact time the data was most recently gathered. How far back on the calendar the report data can extend is limited only to the size of the SPECTRUM archive database itself. By default, this archive can grow to a maximum of 45 days. If disk space is available, however, a SPECTRUM or Web Operator administrator can set this to a higher limit to extend the scope of your alarm reports. The Web Operator administrator can also set the creation time and frequency of the Report. Page 66

Using the Alarm Report Range Selection Calendar The Alarm Report Range Selection Calendar lets you select the time period of your report. To select a time period, refer to Figure 28. Figure 28: Alarm Report Range Selection Calendar Click to summarize alarms for a specific range. Click to summarize alarms for a year, month, or week, as well as each day within that time unit. Click to select time unit Click to select month Click to select year Click to select day Click to generate report Page 67

Generating a Report Containing All Historical Alarm Data This report generates all the archived alarm data available to you. Procedure 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, find both the earliest and the latest dates listed under Report Data Range (you might want to write down these two dates). For more information, see Using the Database Information List [Page 66]. 3. Click Alarm Reports to go back to the Alarm Report Range Selection view. 4. In the Alarm Report Range view, select Range on the Select by line. The Range option displays two calendars. 5. On the View by line, select Day. 6. Set the left-hand calendar to the earliest date you noted in the Data Info view, and set the right-hand calendar to the latest date. 7. Click Generate Report. A table listing all the historical data appears, as shown in Figure 29. Figure 29: All Historical Data Page 68

Generating a Range of Dates Report 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, verify that the dates you want to report are available in the Alarm and Event Reports. For more information, see Using the Database Information List [Page 66]. 3. Go back to the Alarm Report Range Selection view and select Range on the Select by line. The Range option displays two calendars. 4. On the View by line, select a time unit. 5. Depending on which time unit you selected, set the left-hand calendar to the desired date, and set the right-hand calendar to the desired date. 6. Click Generate Report. A table listing all the data within the selected time range appears. Generating a Single Time Unit Report 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, verify that the date (day, month, week, or year) you want to report is available in the Alarm and Event Reports. For more information, see Using the Database Information List [Page 66]. 3. Go back to the Alarm Report Range Selection view and select Time Unit on the Select by line. 4. On the View by line, select a time unit. 5. Depending on which time unit you selected, set calendar to the desired date. 6. Click Generate Report. A table listing all the data within the selected time unit appears. Page 69

Using Alarm Reports in the Table View The most important column in the Alarm Report's Table view is Alarm Type, as shown in Figure 30. To the left of this column are aggregate categories of Alarm Groupings. These are arbitrary categories designed to give you a high-level summary of problem areas. Note: For more information about alarm grouping, see Using the Alarm Presentation Editor [Page 73]. Immediately to the right of the Alarm Type column is a grand total of alarms for each particular Alarm Type followed (further to the right) by a break-out of that grand total showing subtotals per applicable time period. The sums in the Alarm Grouping, Grand Total, and subtotal per time unit columns provide hyperlinks to the Model Breakout view. Figure 30: Table View Alarm Types Alarm Groupings Total alarms for each alarm type Subtotal of alarms for each time unit Opening the Model Breakout View In the Alarm Grouping, Grand Total, or time unit subtotal column, click the underlined alarm sum to access highly detailed original archival records from which that sum was derived. For more information, see Using the Model Breakout View [Page 76]. Page 70

Opening the Alarm Description View In the Alarm Type row, click the alarm description to open a view describing the symptoms, probable causes, and recommended actions for the alarm. Opening the Alarm Presentation Editor On the Navigational Links menu, select Alarm Presentation Editor to modify Alarm Groupings and Alarm Types to suit your network needs. For more information, see Using the Alarm Presentation Editor [Page 73]. Note: To open the Alarm Presentation Editor, you must be a Web Operator administrator and have access to the Alarm Reports application. Opening an Alarm Report for a Specific Time Unit Do one of the following: Click the column heading of a particular week to get the report on that week. Click a column-head button for a specific day of the week to get a report on that day. Click the navigational links described in Figure 31. Figure 31: Alarm Reports Navigational Links. View the previous day/week/month/year View the next day/week/month/year Toggle to the Chart View View the year in the current view View the month in the current view Page 71

Using Alarm Reports in the Chart View You can toggle from the Table view to Chart view using the chart and table icons. The Chart view, shown in Figure 32, covers exactly the same time frame and data as the Table view, but replaces all the detailed subtotals to the right of the Grand Total column with a colored graph showing the relative percentages of all the items in the Grand Total column. Figure 32: Alarm Reports Chart View Alarm Types Alarm Groupings Total alarms for each alarm type Alarm Graph Page 72

Using the Alarm Presentation Editor To access the Alarm Presentation Editor shown in Figure 33, you must have administrator access, as described in Using Administration Application [Page 95]. You must also have access to the Alarm Reports application. After generating a report, you can open the Alarm Presentation Editor to perform the following tasks: Give meaningful names to the alarm files you create (by means of Event Configuration Editor), which show up in the Alarm Reports as hexadecimal numbers in the Ungrouped category. Rename any or all group names to suit your needs. Consolidate any or all of the alarm type groups into other groups. Note: You can edit the Alarm Presentation Editor by using the right mouse menu or the icon toolbar. For simplicity, this guide explains how to edit the Alarm Presentation Editor using the icon toolbar. Figure 33: Alarm Presentation Editor Page 73

Expanding the Alarm Grouping Tree Click the expand tree icon to see a complete list of alarm types available in your SPECTRUM installation. Expanding or Collapse the Alarm Grouping Tree Click the collapse tree icon to see how these alarm types are organized into the alarm type groups (the folders). Changing a Hexadecimal Number to an Alarm Type Title 1. Click the New Item icon. 2. In the Name field, enter the name you want to assign to the number. 3. Change the ID number from 0000000 to the Alarm ID number that is associated with the event in Alarm Reports (this number is created when the alarm is created). 4. Click Ok. The newly named alarm will be correlated with its Alarm Type ID in Alarm Reports. However, it will still be ungrouped and appear at the top of the Alarm Reports table and chart views until you create a group into which the alarm can be placed. Creating a New Alarm Group 1. Click (highlight) the group under which you want the new group created, or leave all groups un-highlighted to create a top-level group. 2. Click the New Group icon. 3. In the Group Name field, enter the name of the group. 4. Click Ok. Moving Groups or Alarm Types 1. Click (highlight) the group or alarm type. 2. Click cut icon. 3. Click the group to which you want to move the group or alarm type. 4. Click the paste icon. Page 74

Editing Groups or Alarm Types You cannot change the names of alarm types that have been installed as part of Web Operator. Procedure 1. Click (highlight) the group or alarm type. 2. Click the edit icon. 3. In the text box edit the group or alarm type and click Ok. Deleting Groups or Alarm Types Procedure You cannot delete groups or alarm types that have been installed as part of Web Operator. 1. Click (highlight) the group or alarm type. 2. Click the delete icon. 3. In the Verify Deletion message, do one of the following: Click Yes to delete the group or alarm type. Click No if you decide not to delete the group or alarm type. Searching for Alarm Types 1. Click the Search drop-down menu and do one of the following: Select All fields to search on both the type ID and type name. and then type a string in the text box. You can search Select Type ID to search on the alarm type s hexadecimal ID number. Select Type Name to search on the alarm type s name. 2. In the text box, type a string or partial string. This will open any folder(s) containing the alarm type and highlight the first occurrence of the string. Note: Searches are not case sensitive. 3. Click the search icon to find the next occurrence. Page 75

Using the Model Breakout View The Model Breakout view, shown in Figure 34, lists all the models associated with a specific alarm type. This view includes current and historical network data so you can explore the current state of models, which in the past have had alarms of concern to you. Only the alarm sum displayed in this view's Total column represents archived historical data, and provides a link to access further archival data about the model. Other columns, such as Name, Condition, and Type represent current data about the SPECTRUM model. So if you click a link in the Name or Condition column it will take you out of Alarm Reports and into the Model Browser or Alarm Manager applications where you can pursue details about the model s current condition. Figure 34: Model Breakout View Time Range of Alarm Report Alarm Group Page 76

About Deleted, Unreachable, and Unnamed Models When DELETED appears in the Name column, that model no longer exists in the SPECTRUM catalog (although its archived data still exists). A model showing UNREACHABLE still exists but its data cannot at the moment be retrieved, probably because the landscape server where its archived data resides is currently down. If unnamed appears in the Name column, it is simply a SPECTRUM model without a name. Opening Model Browser for a Specific Model In the Model Breakout view s Name column, click the name link to open the Model Browser for that model. For more information, see Working with Model Browser [Page 39]. Opening the Archive Data View In the Model Breakout view s Total column, click the alarm sum to view a model's archive data. For more information, see Using the Archive Data View [Page 78]. Opening the Alarm Manager In the Model Breakout view s Condition column, click the alarm condition in to view a model's alarm information. For more information, see Working with Alarm Manager [Page 26]. Page 77

Using the Archive Data View The Archive Data view, shown in Figure 35, is the final destination of the Alarm Reports. This view displays the actual, raw archived data. You can view only one model s archive data at a time. Figure 35: Archive Data View Model Name Time Range of Alarm Report Alarm Group Page 78

Working With Event Reports In this section: Overview [Page 79] Accessing the Event Report Range Selection View [Page 80] Using the Database Information List [Page 81] Using the Event Report Range Selection Calendar [Page 82] Using Event Reports in the Table View [Page 85] Using Event Reports in the Chart View [Page 87] Using the Event Presentation Editor [Page 88] Using the Model Breakout View [Page 91] Using the Archive Data View [Page 92] Overview The Event Reports application allows you to view archived data on past events and can help you: Assess the general health of your network. Identify historical trends in network alarms and events. Find recurring or cyclical problems. Locate specific models that have had specific alarms posted against them in the past (though they may currently be in a normal operating state). Page 79

Accessing the Event Report Range Selection View To access Event Editor: On the Applications menu, select Event Reports. This opens the Event Report Range Selection view shown in Figure 36. Figure 36: Event Report Range Selection View Navigational Links Menu Range Selection Calendar Page 80

Using the Database Information List On the Navigational Links menu, select Data Info to access the SPECTRUM Alarms & Event Reports Data Information list, shown in Figure 37. This view displays which SPECTRUM landscapes are represented in the resulting reports, and gives the precise time range covered for each landscape. Figure 37: SPECTRUM Alarms & Event Reports Data Information List Indicates the exact time the data was most recently gathered. How far back on the calendar the Report data can extend is limited only to the size of the SPECTRUM archive database itself. By default, this archive can grow to a maximum of 45 days. If disk space is available, however, a SPECTRUM or Web Operator administrator can set this to a higher limit to extend the scope of your alarm reports. The Web Operator administrator can also set the creation time and frequency of the reports. Page 81

Using the Event Report Range Selection Calendar The Event Report Range Selection Calendar lets you select the time period of your report. To select a time period, refer to Figure 38. Figure 38: Event Report Range Selection Calendar Click to summarize events for a specific range. Click to summarize events for a year, month, or week, as well as each day within that time unit. Click to select time unit Click to select month Click to select year Click to select day Click to generate report Page 82

Generating a Report Containing All Historical Event Data This report generates all the archived event data available to you. 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, find both the earliest and the latest dates listed under Report Data Range (you might want to write down these two dates). For more information, see Using the Database Information List [Page 66]. 3. Click Event Reports to go back to the Event Report Range Selection view and select Range on the Select by line. The Range option displays two calendars. 4. On the View by line, select Day. 5. Set the left-hand calendar to the earliest date you noted in the Data Info view, and set the right-hand calendar to the latest date. 6. Click Generate Report. A table listing all the historical data appears, as shown in Figure 39. Figure 39: All Historical Data Page 83

Generating a Range of Dates Report 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, verify that the dates you want to report are available in the Alarm and Event Reports. For more information, see Using the Database Information List [Page 81]. 3. Click Event Reports to go back to the Event Report Range Selection view. 4. In the Event Report Range Selection view, select Range on the Select by line. The Range option displays two calendars. 5. On the View by line, select a time unit. 6. Set the left-hand calendar to the start date, and set the right-hand calendar to the end date. 7. Click Generate Report. A table listing all the data within the selected time range appears. Generating a Single Time Unit Report 1. On the Navigational Links menu, select Data Info. 2. In the Report Data Range table, verify that the date (day, month, week, or year) you want to report is available in the Alarm and Event Reports. For more information, see Using the Database Information List [Page 81]. 3. Click Event Reports to go back to the Event Report Range Selection view and select Range on the Select by line. 4. On the View by line, select a time unit. 5. Depending on which time unit you selected, set calendar to the desired date. 6. Click Generate Report. A table listing all the data within the selected time unit appears. Page 84

Using Event Reports in the Table View The most important column in the Event Report s Table view is Event Type, as shown in Figure 40. To the left of this column are aggregate categories of Event Groupings. These are arbitrary categories designed to give you a high-level summary of problem areas. Note: For more information about event grouping, see Using the Event Presentation Editor [Page 88]. Immediately to the right of the Event Type column is a grand total of events for each particular event type followed (further to the right) by a break-out of that grand total showing subtotals per applicable time period. The sums listed under the Event Grouping, Grand Total, and subtotal per time unit columns provide hyperlinks to the Model Breakout view. Event Groupings Figure 40: Table View Total events for each event type Event Types Subtotal of events for each time unit Opening the Model Breakout View In the Event Grouping, Grand Total, or time unit subtotal column, click the underlined event sum to access highly detailed original archival records from which that sum was derived. For more information, see Using the Model Breakout View [Page 91]. Page 85

Opening the Event Presentation Editor On the Navigational Links menu, select Event Presentation Editor to modify Event Groupings and Event Types to suit your network needs. For more information, see Using the Event Presentation Editor [Page 88]. Note: To open the Event Presentation Editor, you must be a Web Operator administrator and have access to the Event Reports application. Opening an Event Report for a Specific Time Unit Do one of the following: Click the column heading of a particular week to get the report on that week. Click a column-head button for a specific day of the week to get a report on that day. Click the navigational links described in Figure 41. Figure 41: Event Reports Navigational Links. View the previous day/week/month/year View the next day/week/month/year Toggle to the Chart View View the year in the current view View the month in the current view Page 86

Using Event Reports in the Chart View You can toggle from the Table view to Chart view using the chart and table icons. The Chart view, shown in Figure 42, covers exactly the same time frame and data as the Table view, but replaces all the detailed subtotals to the right of the Grand Total column with a colored graph showing the relative percentages of all the items in the Grand Total column. Figure 42: Event Reports Chart View Event Groupings Total events for each event type Event Types Event Graph Page 87

Using the Event Presentation Editor To access the Event Presentation Editor shown in Figure 43, you must have administrator access, as described in Using Administration Application [Page 95]. You must also have access to the Event Reports application. After generating a report, you can open the Event Presentation Editor to perform the following tasks: Give meaningful names to the event files you create (by means of SPECTRUM s Event Configuration Editor), which show up in the Event Reports as hexadecimal numbers in the Ungrouped category. Rename any or all group names to suit your needs. Consolidate any or all of the event type groups into other groups. Note: You can edit the Event Presentation Editor by using the right mouse menu or the icon toolbar. For simplicity, this guide explains how to edit the Event Presentation Editor using the icon toolbar. Figure 43: Event Presentation Editor Page 88

Expanding the Event Grouping Tree Click the expand tree icon to see a complete list of event types available in your SPECTRUM installation. Expanding or Collapse the Event Grouping Tree Click the collapse tree icon to see how these event types are organized into the event type groups (the folders). Changing a Hex Number to an Event Type Title 1. Click the New Item icon. 2. In the Name field, enter the name you want to assign to the number. 3. Change the ID number from 0000000 to the Event ID number that is associated with the event in Event Reports (this number is created when the event is created). 4. Click Ok. The newly named event will be correlated with its Event Type ID in Alarm Reports. However, it will still be ungrouped and appear at the top of the Event Reports table and chart views until you create or select a group into which the event can be placed. Creating a New Event Group 1. Click (highlight) the group under which you want the new group created, or leave all groups un-highlighted to create a top-level group. 2. Click the New Group icon. 3. In the Group Name field, enter the name of the group. 4. Click Ok. Moving Groups or Event Types 1. Click (highlight) the group or event type. 2. Click cut icon. 3. Click the group to which you want to move the group or event type. 4. Click the paste icon. Page 89

Editing Groups or Event Types You cannot change the names of event types that have been installed as part of Web Operator. Procedure 1. Click (highlight) the group or event type. 2. Click the edit icon. 3. In the text box edit the group or event type and click Ok. Deleting Groups or Event Types You cannot delete groups or event types that have been installed as part of Web Operator. Procedure 1. Click (highlight) the group or event type. 2. Click the delete icon. 3. In the Verify Deletion message, do one of the following: Click Yes to delete the group or event type. Click No if you decide not to delete the group or event type. Searching for Event Types 1. Click the Search drop-down menu and do one of the following: Select All fields to search on both the type ID and type name. and then type a string in the text box. You can search Select Type ID to search on the event type s hexadecimal ID number. Select Type Name to search on the event type s name. 2. In the text box, type a string or partial string. This will open any folder(s) containing the event type and highlight the first occurrence of the string. Note: Searches are not case sensitive. 3. Click the search icon to find the next occurrence. Page 90

Using the Model Breakout View The Model Breakout view, shown in Figure 44, lists all the models associated with a specific event type. This view includes current and historical network data so you can explore the current state of models, which in the past have had alarms of concern to you. Only the event sum displayed in this view's Total column represents archived historical data, and provides a link to access further archival data about the model. Other columns, such as Name, Condition, and Type represent current data about the SPECTRUM model. So if you click a link in the Name or Condition column it will take you out of Event Reports and into the Model Browser or Alarm Manager applications where you can pursue details about the model s current condition. Figure 44: Model Breakout View Time Range of Event Report Event Group About Deleted, Unreachable, and Unnamed Models When DELETED appears in the Name column, that model no longer exists in the SPECTRUM catalog (although its archived data still exists). A model showing UNREACHABLE still exists but its data cannot at the moment be retrieved, probably because the landscape server where its archived data resides is currently down. If unnamed appears in the Name column, it is simply a SPECTRUM model without a name. Opening Model Browser for a Specific Model In the Name column, click the name link to open the Model Browser for that model. For more information, see Working with Model Browser [Page 39]. Page 91

Opening the Archive Data View Click the event sum in the Total column to view a model's archive data. For more information, see Using the Archive Data View [Page 92]. Opening the Alarm Manager Click the event condition in the Condition column to view a model's event information. For more information, see Working with Alarm Manager [Page 26]. Using the Archive Data View The Archive Data view, shown in Figure 45, is the final destination of the Event Reports. This view displays the actual, raw archived data. You can view only one model s archive data at a time. Figure 45: Archive Data View Model Name Time Range of Event Report Event Group Page 92

Working with User Administration In this section: Overview Accessing User Administration [Page 94] Using Administration Application Overview User Administration allows Web Operator administrators to add, delete, edit, and group Web Operator users. By default, all SPECTRUM users are automatically added to Web Operator during installation. One user is designated administrator, with full access to Web Operator applications, and the other SPECTRUM users become Operators with limited access to Web Operator applications. However, if at the time of installation users were not added to Web Operator, you will need to manually populate Groups and Users in User Administration. Page 93

Accessing User Administration To access User Administration: On the Applications menu, select User Administration. This opens the User Administration view shown in Figure 46. Figure 46: User Administration Groups and Users panel Icon toolbar Permissions panel Page 94

Using Administration Application User Administration provides a Groups and Users panel and a Permissions panel. When you click a group or user (to select it), the permissions granted to that group or user appear in the Permissions panel. When permissions have not been granted, options are grayed out. You can assign permissions globally or for individual users. All changes to the Groups and Users panel or the Permissions panel, take effect immediately. Note: You can edit the Groups and Users panel by using the right mouse menu or the icon toolbar. For simplicity, this guide explains how to edit the User Administration application using the icon toolbar. The Groups and Users panel contains the Everyone, WebAdmin, and Operator groups, by default. You cannot move or delete these groups. The following table describes each group. Group Everyone WebAdmin Operator Description All groups and users belong to the Everyone group. Permissions you assign this group effect all groups and users. For example, if you remove the check from the Update Password box all groups and users will be denied the update password option. By default, these users have access to all Web Operator applications. They can edit, delete, move, or add Web Operator users and groups. By default, these users do not have access to User Administration, Alarm Presentation Editor, and Event Presentation Editor. WebAdmin users can assign or deny permission to all other applications. Page 95

Expanding the User Tree Click the expand tree icon to see a complete list of users and groups. Expanding or Collapse the Group Tree Click the collapse tree icon to see all groups. Creating an Administrator Group 1. In the Groups and Users panel, click WebAdmin to select it. 2. Click the Create New Group icon. 3. In the Name box, enter the name of the new group. 4. Click Ok. Note: The new administrator group appears as a subgroup of the WebAdmin group. Within each group you can create additional subgroups by completing the steps in this procedure. 5. In the Permissions panel, select which applications you want the group s users to access. Assigning Permissions Globally Global permissions are assigned as follows: If you assign global permissions to the Everyone group, all users and groups are effected. If you assign global permissions to the WebAdmin group all users and groups in the WebAdmin group are effected. If you assign global permissions to the Operator group all users and groups in the Operator group are effected. If you assign a global permission after you assign an individual permission, the global permission will override the individual permission. Procedure 1. In the Groups and Users panel, click a group icon to select it. 2. In the Permissions panel, select the applications you want to assign to that group and all its subgroups. Page 96

Note: To assign permission to the Alarm Presentation Editor and the Event Presentation Editor, you must also assign permission to Alarm Reports and Event Reports. Assigning Permissions to Individual Users 1. In the Groups and Users panel, click a user icon to select it. 2. In the Permissions panel, select the applications you want to assign to that user. Note: To assign permission to the Alarm Presentation Editor and the Event Presentation Editor, you must also assign permission to Alarm Reports and Event Reports. Creating a New User 1. Before adding a user to Web Operator, you must first add that user to SPECTRUM s UserEditor, as described in the Security and User Maintenance guide (9032602). 1. In the Groups and Users panel, click the group under which you want the new user created. 2. Click the Create New User icon. The Edit area, shown in the following example, appears. 3. In the Name field, enter the name of the new user. 4. In the New Password box, enter the user s password. 5. In the Re-enter password box, enter the user s password again. 6. Click Ok. 7. In the Permissions pane, select the applications you want that user to access. Page 97