Modeling Your IT Infrastructure

Transcription

1 Modeling Your IT Infrastructure Administrator Guide Document 5167

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

3 Contents Notice ii Preface What is in this book SPECTRUM OneClick Documentation Set Document Feedback Contacting Concord Communications Chapter 1: Welcome to Modeling Your IT Infrastructure What is network modeling in OneClick? Commonly-used SPECTRUM OneClick terms What s ahead Chapter 2: Getting Started Commonly-used modeling terms Understanding SPECTRUM OneClick topologies About the Universe topology Top view - Universe topology Drill-down view - Universe topology Component detail view Methods for defining models in the Universe topology About the Global Collections topology Ways in which you can use Global Collections Methods for populating a collection with modeled elements Ability to view or modify modeled device information About the World topology About the TopOrg topology Icon representation in topology views Icon themes Icon shape, symbol, and theme Icon color and condition Granting or denying access to modeled elements Methods for modeling network entities Recommended modeling tips How to get started Chapter 3: Using Discovery to Discover and Model What is Discovery? Ways to use Discovery Modeling Your IT Infrastructure Administrator Guide iii

4 Commonly-used Discovery terms Understanding Discovery configurations Why use different types of configurations? Accessing and using the Discovery dialog box Accessing the Discovery dialog box About the Discovery tabbed dialog box The Discovery Configuration tab - Discovery dialog box The Discovery tab - Discovery dialog box The Modeling tab - Discovery dialog box Defining and activating configurations Defining a Discovery configuration Defining a Modeling configuration Activating a Discovery session Activating a Modeling session Viewing, filtering, or exporting the results lists Exporting a results list Using the Advanced Filter to filter results Chapter 4: Manual Modeling When to model manually in OneClick Commonly-used modeling terminology Modeling manually in the Universe topology Adding containers to Universe topology views Adding network devices to Universe topology views Removing modeled elements from the Universe topology view Exporting a Universe topology view Creating connections (pipes) between modeled devices Creating an unresolved connection between modeled elements Creating a resolved connection (both device ports known) Creating a partially-resolved connection (one device port known) Locking and Unlocking resolved connections Enable or disable a live link (applies to full or partial resolved connections) Modeling manually in Global Collections topology Recommended process for defining collections Performing Global Collections modeling tasks Defining a new collection Editing an existing collection Creating a Global Collection Hierarchy for reporting Manually modeling in the World topology Recommended process for modeling locations Manually modeling the TopOrg topology iv Modeling Your IT Infrastructure Administrator Guide

5 Modeling services within the TopOrg topology Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Commonly-used terms Enhancing topology views using Edit mode Accessing the Edit mode feature Editing tools available from the Edit mode toolbar Performing editing tasks to enhance a view Adding shapes, lines, or text to a view Changing shapes, lines, and text characteristics Enhancing a topology background characteristics Grouping and ungrouping items in a view Bringing items to front or sending items to back Editing device attributes using the Attribute Editor Accessing the Attribute Editor Working in the Attribute Editor dialog box Editing attribute values in the right panel About the Attribute Editor Results dialog Defining user-defined attributes Changing attributes in conjunction with Search Example of defining a Search to create a user defined attribute for edit Chapter 6: Placing Devices in Maintenance or Hibernation Mode About Maintenance and Hibernation mode The difference between Maintenance and Hibernation mode Which mode takes precedence Placing devices in Maintenance mode Placing devices in Hibernation mode Placing interface models in maintenance or hibernation mode Recognizing model devices in maintenance or hibernation mode Showing brown alarms for interfaces and applications Suppressing events and alarms for devices in maintenance or hibernation Hide or show secondary alarms for devices in maintenance mode Modeling Your IT Infrastructure Administrator Guide v

6 vi Modeling Your IT Infrastructure Administrator Guide

7 Preface The purpose of this guide is to introduce SPECTRUM OneClick modeling concepts and functionality. This document is intended for users responsible for modeling their IT infrastructure within the OneClick environment. This guide assumes that you are familiar with the SPECTRUM OneClick web-based client-server architecture and are thoroughly familiar with how to launch the OneClick client using a web browser. What is in this book This guide contains the following chapters: Chapter 1: Welcome to Modeling Your IT Infrastructure This chapter introduces OneClick s prominent modeling features. Chapter 2: Getting Started This chapter defines OneClick s network topologies, icons for modeling, model-based security, and methods for defining new models. It also includes references on how to get started. Chapter 3: Using Discovery to discover and model This chapter steps you through the tasks associated with defining and maintaining discovery configurations. It provides concepts and detailed procedures for defining configurations, activating configurations, modeling, filtering, and exporting discovery results. Chapter 4: Manual Modeling This chapter describes how to perform manual modeling tasks within each of the OneClick core topology views: Universe, Global Collections, World, and TopOrg. Chapter 5: Enhancing Views and Editing Device Attributes This chapter instructs you how to enhance a topology view using the Edit mode feature. It also discusses how you can edit attributes at the device level using the Attribute Editor feature. SPECTRUM OneClick Documentation Set The SPECTRUM OneClick documentation set is available online at: 1

8 Preface Use this site to download the latest documentation updates and additions. To log onto the OneClick Documentation site, you must supply your contract number and license number. The following tables outline the books you can expect to find in the SPECTRUM OneClick core documentation set: SPECTRUM OneClick core documentation Title OneClick Installation Guide (5142) OneClick Administration Guide (5166) OneClick Console User Guide Modeling Your IT Infrastructure Software Release Notice Description This guide walks you through the steps for installing and setting up SPECTRUM SpectroSERVERs. This guide includes information about Security, User administration, Security string concepts and how to configure SPECTRUM to work with Web Proxy Servers and firewell environments. This guide introduces you to the basic features provided in the SPECTRUM OneClick working environment. This guide describes ways in which you can define and maintain models of your infrastructure in the OneClick environment. It covers Discovery, manual modeling, and modeling tools used to enhance models. The SRN contains late-breaking information not included in the SPECTRUM manuals. We recommend reviewing this file before working with SPECTRUM. Typically, the SRN offers information about the latest changes, fixes, Known Issues and Work-Arounds. You can access the SRN from the SPECTRUM product CD or from the SPECTRUM documentation web site. Document Feedback Please send feedback regarding SPECTRUM documents to the following address: Thank you for helping us improve our documentation. Contacting Concord Communications Contact information for Concord SPECTRUM Business Unit is available at: 2 Modeling Your IT Infrastructure Administrator Guide

9 Chapter 1: Welcome to Modeling Your IT Infrastructure The SPECTRUM OneClick product suite is an entirely new framework that houses and integrates all network management features (core and add-on management). Prominent among these network management features are the core modeling features that OneClick provides: Two methods for modeling. You can model your IT infrastructure manually or you can have SPECTRUM OneClick automate the process for you by using its Discovery feature. Specific information about these modeling methods are discussed in Chapter 3 and 4. Multiple topologies for representing network models. You can create models of your IT infrastructure and represent them within four different topologies. For example, you can use the Universe topology to represent an enterprise network view of your infrastructure; you can use the World topology to represent a geographic view of your infrastructure; you can use the TopOrg topology to represent an organizational view of your infrastructure; or, you can use the Global Collections topology to represent an entity-based (free-form) view of network objects, services, or organizations. Detailed information about these topologies and their use are described in Chapter 2. Automated discovery and modeling process. You can use the Discovery feature to automate the process of identifying assets within your IT infrastructure. After identifying network assets, you can use Discovery s modeling functionality to automate the modeling process. Complete details about using Discovery to help you automate the modeling process are provided in Chapter 3. Automatic assignment of intuitively designed icons. SPECTRUM OneClick uses a wide range of intuitively designed icons to represent the network entities in your infrastructure. These icons are automatically assigned to each entity as you add them to your models. Details about the different types of icons that OneClick uses to represent entities in your network models are described in Chapter 2 on page 17. Editing tools for enhancing the read-ability of a topology view. You can easily enhance the read-ability of any topology by adding annotations, changing background color, or arranging the modeled icons in a tree or radial display. Details about these editing tools are described in Chapter 5. 3

10 Chapter 1: Welcome to Modeling Your IT Infrastructure What is network modeling in OneClick? Network modeling in SPECTRUM OneClick is the act of graphically representing network entities and their connections. Icons created, placed, and connected within the OneClick topology views represent various aspects of a modeled network. Using the modeling features offered in the OneClick client you can easily create and maintain accurate software models of your network. These intelligent network models are what enables SPECTRUM to determine actual points of failure and suppress superfluous alarms. Commonly-used SPECTRUM OneClick terms The following table identifies commonly-used SPECTRUM OneClick terms that you should be familiar with prior to reading the chapters in this guide. Table 1-1: Commonly-used SPECTRUM OneClick terms Landscape SpectroSERVER Distributed SpectroSERVER (DSS) Environment Topologies Manual modeling Discovery The Landscape is the network domain managed by a single SpectroSERVER. The SpectroSERVER is the server process responsible for providing network management services such as polling, trap management, notification, data collection, fault management, etc. Also referred to as the Virtual Network Machine (VNM). A Distributed SpectroSERVER (DSS) environment consists of more than one SpectroSERVER. This environment enables management of a large-scale infrastructure. The SpectroSERVERs in this environment may be located within a single physical location or multiple physical locations. For additional information about a Distributed SpectroSERVER Environment, see the SPECTRUM Concepts Guide. Topologies are iconic views in OneClick that represent various aspects of a modeled network. Manual modeling is the act of manually representing individual devices and their connections within a SPECTRUM OneClick topology view. Discovery is a feature within the OneClick environment you can use to automate the process of discovering and modeling entities in your IT infrastructure. 4 Modeling Your IT Infrastructure Administrator Guide

11 What s ahead What s ahead The intent of this guide is to familiarize you with SPECTRUM OneClick s modeling concepts and functionality so you can quickly get started producing topologies that describe your IT infrastructure. Next Learn more about OneClick s topology views, icon representation of models, model security, methods for defining new models, and tips for modeling in Getting Started on page 7. Later After you re familiar with the OneClick s modeling features and concepts presented in Chapter 2, you can continue to learn how to define and enhance models of your IT infrastructure by reading the following chapters: Using Discovery to Discover and Model on page 27. This chapter discusses ways you can use the Discovery feature to auto discover and model entities in your IT infrastructure. Manual Modeling on page 55. This chapter walks you through the manual modeling tasks associated with the Universe, Global Collections, TopOrg, and Word topologies. Enhancing Topology Views and Editing Model Device Attributes on page 83. this chapter describes how to enhance topology views using Edit mode and how to reconfigure attribute settings at the device level. Modeling Your IT Infrastructure Administrator Guide 5

12 Chapter 1: Welcome to Modeling Your IT Infrastructure 6 Modeling Your IT Infrastructure Administrator Guide

13 Chapter 2: Getting Started This chapter gives you important information about SPECTRUM OneClick s modeling features and concepts. Specifically, it explores the four modeling topologies offered, icon representation of models, model security, and methods for defining new models. Finally, it provides modeling suggestions and tips, and references for getting started. Before you begin Review the following information to ensure you meet the prerequisites of this chapter. Prerequisites You must have adequate privileges to use the modeling functions provided in OneClick. For more information, see OneClick User Administration in the OneClick Administration Guide. You should be logged into the OneClick environment. If you are unsure how to access the OneClick environment, see the OneClick Console User Guide for more information. You should be familiar with the OneClick working environment (window, menu, navigation, etc.) If you unfamiliar with these features, see the OneClick Console User Guide for more information. Modeling fundamentals and tasks After reading this chapter, you will understand the types of topologies you can use to model your network, the icons SPECTRUM OneClick assigns to represent entities in your network, ways to grant or deny access to models, and methods for defining new models. For more information, see: Understanding SPECTRUM OneClick topologies on page 8 Icon representation in topology views on page 17 Granting or denying access to modeled elements on page 23 Methods for modeling network entities on page 24 Recommended modeling tips on page 24 How to get started on page 25 7

14 Chapter 2: Getting Started Commonly-used modeling terms The following table defines some of the modeling terms later discussed in this chapter. Table 2-1: Commonly-used modeling terms Landscape Methods of modeling Network entity Modeling entity Security strings The Landscape is the local or remote SpectroSERVER Methods of modeling refers to the two ways you can approach defining a new model. You can choose to automate the process using Discovery, or you can choose to manually model the individual entities using the Editing tools. This concept is further explored in this chapter page 24 and page 24. Network entity most often refers to a device, an interface, a container, or a physical connection that makes up your IT infrastructure. A Modeling entity most often refers to an icon representing an individual modeled device, container, or physical connection. Security strings establish permission to various elements in OneClick models such as modeled devices. As an administrator you can secure access to models using a security string. This concept is explored later in this chapter page 23. Understanding SPECTRUM OneClick topologies In SPECTRUM OneClick there are four core topologies that you can choose from to model your IT infrastructure. These topologies are known as: Global Collections, Universe, World, and TopOrg. All four of these topologies are available from the OneClick navigation panel, as shown in Figure 2-1. Figure 2-1: OneClick topologies navigation View controls (back, forward, and up) Global Collections World Universe TopOrg Aggregate icon of an ATM 8 Modeling Your IT Infrastructure Administrator Guide

15 Understanding SPECTRUM OneClick topologies In SPECTRUM OneClick, we recommend that you begin modeling with the Universe topology. After you have established one or more modeled elements in the Universe topology, you can reuse these modeled elements to define other topologies (Global Collections, World, or TopOrg). To navigate through the model views of any topology, you can click the view control icons in the tool bar area, or in some cases, you can click an aggregate icon container to view its content. Aggregate icons are later discussed in this chapter on page 17. A brief summary of these topologies and their use follow: About the Universe topology on page 10 About the Global Collections topology on page 13 About the World topology on page 15 About the TopOrg topology on page 16 Modeling Your IT Infrastructure Administrator Guide 9

16 Chapter 2: Getting Started About the Universe topology The Universe topology helps you organize an enterprise network view of your infrastructure. Most often it provides a top level topology view of OSI Layer 3 devices and their connections, a drilldown topology view of OSI Layer 2 devices and their connections, and a component detail view of attributes associated with a modeled entity. Each of these views are further described in the following sections: Top view - Universe topology The top view in the Universe topology most often includes the SPECTRUM Virtual Network Machine (VNM), network groupings, network segments, and OSI Layer 3 devices and their connections. Figure 2-2: Top view - Universe topology An icon container representing a network OSI Layer 3 devices, such as a router and its connections An icon segment representing a WAN Segment SPECTRUM Virtual Network Machine Drill-down view - Universe topology A drill-down view in the Universe topology most often includes all OSI Layer 2 devices and their connections, and off page references to devices modeled in other views. The following example illustrates the drill-down contents of a selected LAN container that was previously shown in Figure Modeling Your IT Infrastructure Administrator Guide

17 Understanding SPECTRUM OneClick topologies Figure 2-3: Drill-down view - Universe topology OSI Layer 2 devices such as a switch. Off page reference to an OSI Layer 3 device Component detail view The component detail view within the Universe topology appears in the Component Detail panel (Figure 2-4 ). This view identifies the attributes associated with a modeled network entity such as its interfaces, alarms and events, and other pertinent device information. You can view the device attributes and possibly change their settings by clicking the Component Detail panel tabs. For instance, you can: view and modify general device settings in the Information tab; such as granting or denying access to a modeled device by providing (or possibly removing) a security string. view root cause analysis data in the Root Cause tab. view CPU and memory utilization information in the Performance tab. view device interface information in the Interfaces tab. view neighboring routers in the Neighbors tab. view current alarms in the Alarm tab. view historical events in the Events tab. The following example shows a Component Detail panel listing device interface information about a modeled Cisco Switch. Modeling Your IT Infrastructure Administrator Guide 11

18 Chapter 2: Getting Started Figure 2-4: Component detail view - Universe topology Methods for defining models in the Universe topology You can easily define models in the Universe topology by using OneClick s Discovery feature that automates the modeling process for you. You can also manually define new models or edit existing models in the Universe topology by using the modeling tools provided with OneClick. Finally, since the Universe topology view represents a true connectivity view of your infrastructure, we strongly recommend that you reuse modeled elements from this view when creating other views. Therefore, as a best practice, you should copy model elements from the Universe topology view to create Global Collections, World, or TopOrg views. This modeling approach helps to ensure accurate fault isolation of your network within the SPECTRUM OneClick environment. 12 Modeling Your IT Infrastructure Administrator Guide

19 About the Global Collections topology About the Global Collections topology Global Collections help organize entity-based views of your network that may span one or more landscapes (network segments managed by one or more SpectroSERVERs). These collections enable operators to monitor any or all aspects of your IT infrastructure from any needed perspective. Ways in which you can use Global Collections As an administrator you can use Global Collections to create and track various collections of network entities, organizations, or services that make up your infrastructure. For example, you could create and maintain collections that identify and track: Response teams within an organization responsible for maintaining equipment. Devices supporting various services in your organization. Customers receiving services from your organization. The following example illustrates a collection of routers supporting a fictitious regional office. Figure 2-5: Regional router collection Methods for populating a collection with modeled elements The most common method to create and populate a Global Collections view is to (1) create and name a new collection; and (2) specify search criteria to locate modeled elements (previously modeled within the Universe topology) to populate the new collection. Modeling Your IT Infrastructure Administrator Guide 13

20 Chapter 2: Getting Started Figure 2-6: Create collection with search criteria (1) Create and name the new collection. (2) Specify the search criteria to locate the modeled devices to populate the new collection. Alternatively, you can populate a new or an existing Global Collections view by right-clicking the modeled elements you want to copy from the Universe topology and selecting Add To - >Collections. For further information about using these methods to create and populate a Global Collection view, see Chapter 4, Manual Modeling, on page 55. Ability to view or modify modeled device information Using the Component Detail Panel within the Global Collections topology, you can easily view or change attributes or settings associated with a modeled device. For instance, by clicking the tabs in this panel you can access general information about a device, its interfaces, alarms, events, and other pertinent information. Figure 2-7: Component Detail Panel - Global Collections Tabs for viewing device attributes or possibly changing device settings. The information tab provides general information about the selected modeled device. 14 Modeling Your IT Infrastructure Administrator Guide

21 About the World topology About the World topology The World topology helps organize geographic area views of your network. In this topology, you can represent device models of network locations from a national or regional level all the way down to a wiring closet. The following example illustrates a drill-down view of an equipment room located at a fictitious North Dallas location. Figure 2-8: World topology -drill-down view Building location Equipment room Contents of equipment container. In the World topology, you can create several layers of views that represent locations of your networked devices (i.e., Texas regional offices, Dallas office, North Dallas equipment room, etc.). Additionally, you can use the Component Detail panel to view and possibly change the attributes associated with a modeled device in any World topology view. For instance, by clicking the Component Detail tabs (associated with a modeled device) you can view device information, interfaces, alarms, events, and other pertinent device information. Finally, when populating the World topology views with modeled devices, we highly recommend that you copy and paste modeled elements from Universe topology views. This recommendation stems from the fact that Universe topology views represent the true connectivity views of your infrastructure, thereby, ensuring accurate fault isolation of your network within the SPECTRUM OneClick environment. For further information about creating views within the World topology, see Chapter 4, Manual Modeling, on page 55. Modeling Your IT Infrastructure Administrator Guide 15

22 Chapter 2: Getting Started About the TopOrg topology The TopOrg topology helps depict organizational views of your network. In this topology, you can group subnets and device models by services, responsibilities, departments, or other organizational considerations. The following example shown in Figure 2-9 illustrates an organizational view that identifies individuals and groups that comprise a fictitious Finance Department. This type of view is useful when identifying how a network failure or a reconfiguration impacts an organizational unit. Note. If you purchased the Service Manager module, you can use this module in conjunction with the TopOrg topology to model business services and applications. Further, the Service Manager module also tracks the performance of the service against a contract or Service Level Agreement (SLA). For additional information about using the Service Manager module, see the Service Manager User Guide (5155). Figure 2-9: TopOrg Topology - Finance department view Finance Department comprised of individuals and work groups. In the TopOrg topology, you can create several layers of views that represent various levels of your networked devices (i.e., Enterprise ownership, Department ownership, supporting devices, supporting services, etc.). Additionally, you can use the Component Detail panel to view and possibly change the attributes associated with a modeled device in any TopOrg topology view. For instance, by clicking the Component Detail tabs (associated with a modeled device) you can view device information, interfaces, alarms, events, and other pertinent device information. Finally, when populating the TopOrg topology views with modeled devices, we highly recommend that you copy and paste modeled elements from Universe topology views. This recommendation stems from the fact that Universe topology views represent the true connectivity views of your infrastructure, thereby, ensuring accurate fault isolation of your network within the SPECTRUM OneClick environment. For further information about creating views within the TopOrg topology, see Chapter 4, Manual Modeling, on page Modeling Your IT Infrastructure Administrator Guide

23 Icon representation in topology views Icon representation in topology views Icons appearing in Spectrum OneClick topology views are graphical representations of network entities such as individual devices, groups of devices, geographic locations, physical connections, and others. When creating or editing a model, an icon is merely an image with which you interact to manipulate and configure a modeled element. When monitoring the condition of a network through the SPECTRUM OneClick topology views, an icon represents the current status of a device, network group, device location, or a physical link in your infrastructure. SPECTRUM OneClick offers both aggregate and individual icons for representing entities in your infrastructure. The following table describes the differences between these icons: Table 2-2: Individual and aggregate icons Aggregate icons Aggregate icons are not managed by an IP or physical address. However, you can configure these icons to display the device IP address that container represents (or the subnet address of the devices that the container represents). These type of icons primarily act as containers, or placeholders in a topology view. An aggregate icon often represents a network group icon. Some examples of network groups are LAN, LAN_802.x, FDDI, ATM_Network, WA_Link and Dialup_Link. Individual icons Individual icons are typically associated with an IP address or a physical address. SPECTRUM can communicate directly with the devices the individual icons represent, so long as the entities they represent are SNMP and ICMP entities. Individual icons often represent network devices. Some examples of individual icons are those that represent a router, switch, or host. SPECTRUM OneClick offers many types of individual and aggregate icons. The appearance of each icon is always based on the entity it represents in your network. The following sections further describe icons by themes, shape, symbol, and color. Modeling Your IT Infrastructure Administrator Guide 17

24 Chapter 2: Getting Started Icon themes Icon themes represent a unified look and feel for all the icons that make up your models. You can apply one of the following three icon themes to your models from the OneClick View menu: Classic The classic icon theme has been especially designed for former SpectroGRAPH users. This theme offers a similar appearance to the icons presented in SpectroGRAPH. VNM icon example OneClick The OneClick icon theme offers a modern looking appearance for modeled icons. VNM icon example Utility The Utility icon theme presents a simplified two-dimensional display of the modeled icons. VNM icon example Icon shape, symbol, and theme As you model devices in your network (through Discovery or manual modeling) SPECTRUM automatically determines the functionality of each device and selects the appropriate icon shape and symbol for that device. Icons come in various shapes and sizes. Icon symbols vary by the model class represented and by the topology in which the icon is located. The most frequently-used icons in OneClick topology views are further described in the following table (Table [page 19]) and figures (Figure 2-10 on page 20, Figure 2-11 on page 21, Figure 2-12 on page 21). 18 Modeling Your IT Infrastructure Administrator Guide

25 Icon representation in topology views Table 2-3: Icon types by theme. Icon type Icon appearance by theme VNM icons The Virtual Network Machine (VNM) icon normally appears in the top level view above the network group icons. The background color of the VNM icon changes to indicate the current condition of the SpectroSERVER. For example, the VNM icon turns red when the SpectroSERVER disk space reaches 90% capacity. Network group icons The network group icons represent network groupings such as cable groups, LANs, IP Class A, B, C networks, etc. Device icons A device icon represents an individual device. The device icon color changes to indicate the current condition of the modeled device. For example, the device icon changes red whenever SPECTRUM detects a serious condition requiring attention. Off-Page Reference icons The off-page reference icon is a special-purpose topology icon. It represents a device that is directly connected to a device in the current view but is modeled in another layer. Segment icons Segment icons represent conceptual elements of a network. Examples of segment icons can include (but not limited to): coax segment, wa_segment, fanout, unplaced icon, and pingable icons. Live pipes (or links) Live pipes represent the connection status between network devices. The links change color to indicate the current condition. A gold pipe represents a resolved connection. A silver pipe represents an unresolved connection. Note that live pipes are not enabled by default. To monitor the connection status between devices, you must enable a live pipe. Modeling Your IT Infrastructure Administrator Guide 19

26 Chapter 2: Getting Started Figure 2-10: OneClick theme icons and symbols Host Switch Ping SNMP Hub Bridge Fanout Offpage Reference Dialback WAN Router VPN Event Event Admin VNM Network LAN Chassis ATM Network MCAST OneClick Org Own Org Service VPN Cable Modem Power Test Universal Transport Device Wireless Access Point Printer IP Phone Firewall Flag 20 Modeling Your IT Infrastructure Administrator Guide

27 Icon representation in topology views Landscape Hub Figure 2-11: Classic theme icons and symbols Event LAN Cable Admin Network VNM Router Switch Chassis VPN Landscape Hub LAN Event Model VNM Router Switch Chassis Network VPN SNMP Pingable Bridge Event Admin Dial Backup WAN Workstation Figure 2-12: Utility theme icons and symbols Host Host Workstation Workstation Switch Ping SNMP Hub Bridge Fanout Dialback WAN Router VPN Event EventAdmin Off Page Reference VNM Network LAN Chassis Landscape ATM Network Org Services Org Owns VPN MCAST Printer Wireless Access Point IP Phone Universal Transport Cable Power Firewall Device Modem Modeling Your IT Infrastructure Administrator Guide 21

28 Chapter 2: Getting Started Icon color and condition All icons change color to indicate the condition of the device(s) they represent. For instance, a device icon will change color when an alarm condition for that device occurs. A roll-up triangle on a device icon or container icon will change color when an alarm condition occurs on one or more of its components (devices or interfaces). Figure 2-13: Roll-up and color conditions Roll-up conditions: The roll-up triangle associated with the Network container icon represents that one or more components of the container has a critical alarm. In this example, a device within the Network container has a critical alarm. The roll-up triangle associated with the device icon represents that a component of that device has an alarm condition. In this example, an interface on a Cisco router has a minor alarm. Icon condition colors: Normal Minor Major Critical Initial Maintenance Unknown Green Yellow Orange Red Blue Brown Silver Logical links (or pipes) change color to indicate the condition of the connection, for instance: disabled conditions display brown, good conditions display green, initial conditions display blue, unknown conditions display gray, and poor conditions display red. 22 Modeling Your IT Infrastructure Administrator Guide

29 Granting or denying access to modeled elements Granting or denying access to modeled elements As an administrator you can secure access to SPECTRUM OneClick models by applying a security string. A security string establishes permission to various modeled elements in a OneClick topology view such as a modeled device. After a security string is applied to a modeled device all subcomponent models (or views) of that device inherit the security string. The security string field for implementing modeled security appears in the Component Details panel. Figure 2-14: Security string setting on component detail panel Information tab on Component Details panel Boston In this example, the security string Boston prevents any user that does not have an Access Group of Boston from accessing this modeled element. Note that a Super User or any user with an Access Group of Admin overrides model security (meaning these users can access all model elements regardless of the security string implemented). For further information about creating or renaming Access Groups associated with individual users or user groups, see the User Administration and Model Security chapter in the OneClick Administration Guide. Modeling Your IT Infrastructure Administrator Guide 23

30 Chapter 2: Getting Started Methods for modeling network entities As an administrator you can define models representing entities in your IT infrastructure by manually modeling them or having the SPECTRUM OneClick Discovery feature create them for you: SPECTRUM OneClick Discovery feature Manual modeling By using OneClick s Discovery feature, you can easily model your network infrastructure in less time and effort than the manual process. When using Discovery to automate the modeling process you are required to know: Device IP address ranges Device SNMP community names Note that all discovery results are modeled to the Universe topology. To learn more about automated modeling using Discovery, see Using Discovery to Discover and Model. When you manually model your network you are required to have knowledge of all the network devices you plan to model, including their: IP addresses Device SNMP Community names All four core topologies (Universe, Global Collections, World, and TopOrg) in OneClick support manual modeling operations. However, we recommend that you always model new devices in the Universe topology and then reuse these modeled devices to create other topologies views. To learn more about manual modeling, see Manual Modeling. Recommended modeling tips When creating models in OneClick, consider following these recommended steps and tips outlined in the following table: Table 2-4: Recommend modeling steps and tips Recommended steps: Tips 1. Plan Create a plan about the network entities you want to model by gathering all required network device information. For instance: Typical information needed for Discovery operations include: Range of IP addresses of all addressable devices. SNMP Community names for devices Router address (optional). Typical information needed for manual modeling operations include: Type of network (switched, routed, flat) Network masks Network technology (FDDI, Ethernet, WAN, etc.) List of all devices IP addresses for all addressable devices SNMP Community names for all devices Physical and logical network diagrams 24 Modeling Your IT Infrastructure Administrator Guide

31 How to get started Table 2-4: Recommend modeling steps and tips Recommended steps: 2. Use OneClick s Discovery feature to model. 3. As needed, use OneClick s manual modeling features to define or edit models. Tips In the Universe topology, create one or multiple discovery configurations to locate and identify the devices you want to model. Use the filter mechanism to exclude any devices from the result list you don t want to model. After you are satisfied with the device list (or results list), use Discovery s modeling option to model these devices in the Universe topology. For more information about Discovery, see Using Discovery to Discover and Model on page 27. There are a number of ways you can manually create or edit models in OneClick: In the Global Collections topology, you can create and name collections of devices previously modeled in the Universe topology. In the Universe topology, you could add devices and annotations to existing models, change device configuration information, or improve the readability of models by possibly keeping the layers within the Universe topology simple. You may want to consider placing routers near the top and grouping devices logically by IP domains. For more information about OneClick s manual modeling features, see Chapter 4 and 5. How to get started If you are not sure which modeling feature to use to accomplish your task, here are some references to help you get started: Table 2-5: Using Discovery to Discover and Model, Chapter 3 To: see: Learn what Discovery provides and how you can use it page 28 Launch the Discovery dialog box page 30 Get acquainted with Discovery commonly-used terms page 29 Learn about the two configurations you create in Discovery page 30 Learn about the Discovery dialog box tabs and settings page 32 Define a configuration using the Discovery Configuration tab page 42 Define a configuration using the Modeling Configuration dialog box page 45 Activate a Discovery session per the Discovery Configuration settings page 49 Activate a Modeling session per the Discovery tab results list page 51 Learn what the discovery results list provides and how you can use it page 52 Learn what the modeling results list provides and how you can use it page 52 Use the Advanced Filter to filter results page 53 Modeling Your IT Infrastructure Administrator Guide 25

32 Chapter 2: Getting Started Table 2-5: Using Discovery to Discover and Model, Chapter 3 To: see: Use Export to export the results list to a supported file format page 52 Table 2-6: Manually modeling, Chapter 4 To: see: When to model manually in OneClick page 56 Get acquainted with manual modeling terminology page 56 Learn about the manual modeling features available in the Universe topology page 56 Learn how to create containers in the Universe topology page 57 Learn how to add network devices to a Universe topology page 59 Learn how to depict connections (pipes) between modeled devices page 64 Learn about the manual modeling features available in the Global Collections topology page 68 Learn how to perform global collection modeling tasks page 70 Learn how to create a Global Collection Hierarchy for reporting page 76 Learn about the manual modeling features available in the World topology. page 77 Learn about the manual modeling features available in the TopOrg topology. page 79 Table 2-7: Enhancing topology views and edging model device attributes, Chapter 5 To: see: Learn how to enhance topology views using the Edit mode page 85 Learn how to perform editing tasks to enhance a topology view page 88 Learn about changing attributes at the device level page 93 Learn about changing attributes at the device level using search page 97 Table 2-8: Placing devices in maintenance or hibernation mode, Chapter 6 To: see: Learn how to place devices in maintenance mode page 103 Learn how to place devices in hibernation mode page Modeling Your IT Infrastructure Administrator Guide

33 Chapter 3: Using Discovery to Discover and Model This chapter steps you through the tasks associated with defining and maintaining SPECTRUM OneClick Discovery configurations. Specifically, this chapter defines Discovery s capabilities, its user-interface, and ways in which you can use Discovery to discover and model devices. Additionally, this chapter defines the user privilege level required to operate the Discovery functions. Finally, it provides detailed procedures for defining and activating Discovery configurations, modeling Discovery results, and filtering and exporting the Discovery results. Before you begin Review the following information to ensure you meet the prerequisites of this chapter and to familiarize yourself with the Discovery information described in this chapter. Prerequisites: You should be logged into the OneClick environment. If you are unsure how to access the OneClick environment, see the OneClick Console User Guide for more information. You should be familiar with the OneClick working environment (window, menu, navigation, etc.) If you are unfamiliar with these features, see the OneClick Console User Guide for more information. You must have the appropriate user level privilege to use the discovery or modeling options described in this chapter. For more information about setting user privileges, see OneClick User Administration in the OneClick Administration Guide. Discovery fundamentals and tasks After reading this chapter, you will understand Discovery capabilities and how to use the Discovery dialog box to define, maintain, and activate discovery and modeling configurations. The information in this chapter is presented in the following sections: What is Discovery? on page 28 Understanding Discovery configurations on page 30 Accessing and using the Discovery dialog box on page 30 Defining and activating configurations on page 42 27

34 Chapter 3: Using Discovery to Discover and Model Viewing, filtering, or exporting the results lists on page 52 What is Discovery? Discovery finds devices in your network and automates the process of modeling them within the Universe topology. It uses a set of configuration parameters to determine which network entities to discover and model. You specify these configuration parameters using the Discovery dialog box accessed from the OneClick window. You can reuse any set of previously saved configuration parameters. You can also rename, duplicate, or delete configurations. The Discovery dialog box groups the discovery parameters and the modeling parameters in tabs. Depending on how the OneClick administrator has configured your user privileges, you may see all three tabs or you may only see the discovery related tabs. Figure 3-1: Discovery tabs Ways to use Discovery Depending on the user privileges assigned, you can use the automated discovery and modeling features in conjunction with one another or you can use them separately. For example, here are some ways in which you can use Discovery: To perform network inventories. If you have read/write privileges to the discovery parameters, you can use Discovery to identify assets within your network and, as needed, export the results describing those assets to a desired file format for further review and distribution. To model network entities you want to manage. If you have read/write privileges to both discovery and modeling parameters, you can use Discovery to (1) determine which elements in your network you want to model and (2) identify how you would like SPECTRUM to automatically model these elements for you. By specifying modeling parameters in conjunction with the discovery parameters, you can easily create accurate software models of your infrastructure in less time and effort than if you had to manually model them yourself. After using Discovery to create models in the Universe topology, you can at any time enhance your models further by using the manual modeling features later described in Chapter Modeling Your IT Infrastructure Administrator Guide

35 What is Discovery? Commonly-used Discovery terms The following table identifies commonly-used terms for performing the Discovery tasks described in this chapter. Table 3-1: Commonly-used Discovery terms Discovery dialog box Discovery Configuration Modeling Configuration Discovery session Modeling session Results (list) The Discovery dialog box provides all the functionality for creating, editing, and activating discovery and modeling configurations; as well as, filtering and exporting the results of discovery or modeling session. A Discovery configuration contains the parameters you specify to determine which network entities in your infrastructure you want Discovery to locate and identify for review, export, or modeling. A Modeling configuration identifies the modeling options you want Discovery to use when modeling and mapping the results of a discovery session. A discovery session occurs upon instructing Discovery to discover network entities per the parameters specified in the Discovery Configuration. It uses SNMP and other network technologies to discover and identify network entities specified in the Discovery Configuration. A modeling session occurs upon instructing Discovery to model the results of a discovery session. It uses the Modeling configuration options specified to model the network entities discovered in that Discovery configuration. Results provide a detailed list of: (1) the network entities discovered from a discovery session, or (2) network entities modeled from a modeling session. Modeling Your IT Infrastructure Administrator Guide 29

36 Chapter 3: Using Discovery to Discover and Model Understanding Discovery configurations There are two basic types of configurations you can define using the Discovery dialog box: Discovery configuration. The discovery configuration determines the focus and scope of a discovery session. You define the discovery configuration using the Discovery Configuration tab on the Discovery dialog box. When you define a discovery configuration you can activate the discovery session at that time by pressing Discover or you can save the configuration and activate the discovery session at a later time. The results of a discovery session always appear in the results list on the Discovery tab. Modeling configuration. The modeling configuration specifies how SPECTRUM models discovered devices appearing in the results list of the Discovery tab. On the Modeling Configuration dialog box, you can choose to accept the default modeling options or change them to meet your needs. You can activate a modeling session by clicking Model on the Discovery tab. The results of a modeling session always appear in the results list of the Modeling tab. Why use different types of configurations? Separate configurations offer more flexibility for customizing the discovery and modeling process. By providing separate configurations, you can easily: Discover limited portions of your network by performing several smaller discovery operations instead of performing one large discovery operation. Model the results of a discovery operation using different modeling options. Filter and export the results of a discovery session in different ways. Filter and export the results of a modeling session in different ways. Accessing and using the Discovery dialog box The following sections identify how to access and use the features provided on the Discovery dialog box. For more information see: Accessing the Discovery dialog box on page 31 About the Discovery tabbed dialog box on page 32 The Discovery Configuration tab - Discovery dialog box on page 32 The Discovery tab - Discovery dialog box on page 36 The Modeling tab - Discovery dialog box on page Modeling Your IT Infrastructure Administrator Guide

37 Accessing and using the Discovery dialog box Accessing the Discovery dialog box You can access the Discovery feature in OneClick by choosing it from the Tools menu or from the context of a selected element appearing in OneClick s Navigation panel or Topology- Contents panel, for example: Tools menu. As shown in Figure 3-2, you can access Discovery from the Tools menu by selecting a new Discovery configuration or opening an existing Discovery configuration. Figure 3-2: Tools menu - Discovery options Context of a selected element. Using the right-mouse menu you can access Discovery by right-clicking an element in the Universe navigation node or right-clicking in the background area of the Topology tab in the Contents panel, as shown in Figure 3-3. Figure 3-3: Right mouse menu - Discovery option When you access Discovery from the context of a modeled router, the Discovery dialog box automatically launches and populates the router s IP address within the Seed Router parameter list box. Modeling Your IT Infrastructure Administrator Guide 31

38 Chapter 3: Using Discovery to Discover and Model About the Discovery tabbed dialog box The Discovery dialog box groups the parameters you use to define discovery and modeling configurations into three tabs: Discovery Configuration tab; Discovery tab; and, Modeling tab. Each of these tabs are further described in the following sections. The Discovery Configuration tab - Discovery dialog box The Discovery Configuration tab lists all the required and optional parameters you can set to create a discovery configuration. This tab is available to all users with privileges to discovery operations. Figure 3-4 shows a depiction of the Discovery Configuration tab with callouts for the components later described in this section. Figure 3-4: Discovery configuration tab Configuration Name text box. Seed router parameters IP Boundary List Modeling options Advanced discovery options Save as default option. Command buttons 32 Modeling Your IT Infrastructure Administrator Guide

39 Accessing and using the Discovery dialog box Defining a Discovery configuration In the Discovery Configuration tab, you can create a discovery by specifying one IP address, a range of IP addresses, or by building a list of IP addresses. You can also identify one or more seed routers for large range discovery operations. Alternatively, you can choose to define the discovery configuration by clicking the Import button to import a text file containing the IP addresses and ranges you want to discover. For more information about defining a discovery configuration, see Defining a Discovery configuration on page 42. Specifying the Modeling options If you have read/write privileges to Discovery s modeling operations, you can specify if you want to perform a discover only operation or a combined discover and model operation. By clicking the Modeling Options button you can review and accept the modeling defaults provided or edit them as needed. Specifying optional Advanced Discovery Options The Advanced Options button on the Discovery Configuration tab launches the Advanced Options dialog box. In Advanced Options dialog box you can review, accept, or redefine the following options: Modeling Your IT Infrastructure Administrator Guide 33

40 Chapter 3: Using Discovery to Discover and Model SNMP ports Discovery, by default, uses port 161, however, you can specify additional ports. This feature is most often used for managed node environments that use port numbers other than the default port number of 161. Discovery options Discovery, by default, provides settings for time-outs, retries, and discovery of pingable devices. You can choose to use the default settings provided or you can change them to meet your needs. About the Discovery Configuration command buttons The Discovery Configuration tab provides the following command buttons that you can choose to activate: Discover. The Discover button instructs SPECTRUM OneClick to generate a discovery session based on the discovery configuration specified. Close. The Close button closes the Discovery dialog box. 34 Modeling Your IT Infrastructure Administrator Guide

41 Accessing and using the Discovery dialog box Ways of saving the Discovery Configuration The Discovery Configuration tab provides the following options for saving the discovery configuration: Naming the discovery configuration. When you name a Discovery configuration, SPECTRUM OneClick automatically saves the configuration settings and the device addresses specified in that Discovery configuration. Save options as default. The Save options as default checkbox, when checked, saves all specified Discovery configuration settings and applies them to future Discovery configurations (regardless of whether or not the Discovery configuration is named). For example, the "Discover only" option is by default enabled on the Discovery Configuration dialog box. If you preferred to have the option for "Discover and automatically model to SPECTRUM" enabled as the default setting, you would: a. Enable (check) the "Discover and automatically model to SPECTRUM" checkbox. b. Enable (check) the "Save options as default" checkbox and click Close. The option for "Discovery and automatically model to SPECTRUM" is by default enabled on Discovery dialog box (until it is changed using the steps previously described). Modeling Your IT Infrastructure Administrator Guide 35

42 Chapter 3: Using Discovery to Discover and Model The Discovery tab - Discovery dialog box The Discovery tab shows the results of the last discovery session. In particular, it identifies the devices it discovered as well as the status and error messages generated during the last discovery session. This tab is available to all users with discovery privileges. The Discovery Tab initially appears disabled for new discovery configurations and only becomes enabled after an initial discovery session is generated from the Discovery Configuration tab. Figure 3-5 shows a depiction of the Discovery tab with callouts for the components later described in this section. Figure 3-5: Discovery tab Export button Filter text box Advanced Filter button Results list generated from last discovery session. Status and error messages generated from the most current discovery session. Command buttons If you have privileges for both discovery and modeling operations, you can use the Discovery tab to review discovery results, export discovery results, set up a modeling configuration, or activate a discovery or modeling session. If you have privileges to discovery operations only, you can use the Discovery tab to review discovery results, export discovery results, and activate a discovery session. 36 Modeling Your IT Infrastructure Administrator Guide

43 Accessing and using the Discovery dialog box Ways to filter, sort, and export the Discovery results list The Discovery tab provides the following options to help you review, filter, and export the discovery results: Filter text box. The filter text box enables you to quickly filter the devices appearing in the list. For example: if you wanted to develop, model, and export a list of Cisco devices from your results list, you would: a. Type Cisco in the Filtering text box to filter the results list display by Cisco devices. b. Click Model to model only the Cisco devices. c. Click Export (folder image button) to export the Cisco device result list. Advanced Filter button. By clicking the Advanced Filter button on the Discovery tab, you can establish additional filter criteria by creating one or more expressions. These expressions enable you to set additional filters on the discovery results list. For more information about using the Advanced Filter mechanism, see Using the Advanced Filter to filter results on page 53. Right-mouse menu command - Exclude. You can exclude one or multiple entries in the discovery result list by right-clicking the entries (rows) that you want to exclude and selecting Exclude. Sort controls. You can sort the discovery results list entries in ascending or descending order by clicking the sorting arrowhead controls appearing in the column headings. Sorting arrowhead controls Additionally, you can adjust the column sorting parameters, change the fonts in the results list, or hide or show columns by right-clicking within a column heading and launching the Table Modeling Your IT Infrastructure Administrator Guide 37

44 Chapter 3: Using Discovery to Discover and Model Preference dialog box. Additionally within the results list, you can select and move the columns, as well as, adjust the width of the column margins (borders). Export button. Clicking the Export button launches the Export table data to file dialog box. In this dialog box, you can specify a file format and location to export the discovery results. For more information, see Exporting a results list on page 52. Using the Discovery tab command buttons The Discovery tab provides the following Discover and Model command buttons that you can choose to activate: Discover button. The Discover button instructs SPECTRUM OneClick to restart the discovery session based on the parameters specified on the Discovery configuration tab. The device list and status messages appearing on the Discovery tab are updated based on the results of the latest discovery session. Model button. The Model button launches the Modeling Configuration dialog box. In this dialog box, you can review or modify the default modeling options provided. When you click OK, SPECTRUM OneClick models only the devices appearing in the discovery results list. Note that this button is only enabled for users with privileges to modeling operations. For more information, see Defining a Modeling configuration on page 45. Close button. The Close button closes the Discovery dialog box. 38 Modeling Your IT Infrastructure Administrator Guide

45 Accessing and using the Discovery dialog box The Modeling tab - Discovery dialog box The Modeling tab displays the results of the last modeling session. In particular, it identifies the devices it models, the connections it made, and the status and error messages generated during the last modeling session. Figure 3-6 shows a depiction of the Modeling tab with callouts for the components later described in this section. Filter text box Figure 3-6: Modeling Tab Export button Results set generated from the most current modeling session. Status and error messages generated from the last modeling session. Status bar Command buttons The Modeling tab is available to all users with modeling privileges. This tab initially appears disabled for new discovery configurations and only becomes enabled after an initial modeling session is generated from the Discovery tab. Modeling Your IT Infrastructure Administrator Guide 39

46 Chapter 3: Using Discovery to Discover and Model Ways to filter, sort, and export the modeled results list The Modeling tab provides the following options to help you review, filter, and export the modeling results: Filter text box. The filter text box enables you to quickly filter the devices appearing in the model result list. For example, if you wanted to develop and export a list of Cisco modeled devices from the results list, you would: a. Type Cisco in the Filtering text box to filter the results list display by Cisco devices. b. Click Export (folder image button) to export the Cisco device result list. Sort controls. You can sort the modeling results list entries in ascending or descending order by clicking the sorting arrowhead controls appearing in the column headings. Figure 3-7: Modeling tab results list Sorting arrowhead controls Additionally, you can adjust the column sorting parameters, change the fonts in the results list, or hide or show columns by right-clicking within a column heading and launching the Table Preference dialog box. Additionally within the results list, you can select and move the columns, as well as, adjust the width of the column margins (borders). Export button. Clicking the Export button launches the Export table data to file dialog box. In Export table dialog box, you can specify a file format and location to export the modeling results. Using the Modeling tab command buttons The Modeling tab provides the following command buttons that you can choose to activate: Discover button. The Discover button instructs SPECTRUM OneClick to regenerate the discovery session based on the parameters specified on the Discovery configuration tab. Close button. The Close button closes the Discovery dialog box. 40 Modeling Your IT Infrastructure Administrator Guide

47 Accessing and using the Discovery dialog box Interpreting the Modeling status bar The Modeling status bar activates immediately after clicking the Model button on the Discovery tab. This status bar divides the modeling process into four operation phases: Model Creation -Phase 1. The label for this phase turns green while SpectroSERVER processes the data to model. Activation/Layer 3 - Phase 2. The label for this phase turns green while SpectroSERVER maps Layer 3 devices. Layer 2 Mapping - Phase 3. The label for this phase turns green while SpectroSERVER wait for model activation and maps Layer 2 devices. Autoplacement - Phase 4. The label for this phase turns green while SpectroSERVER places the models appearing in the modeling result list. The status and error messages related to each of the four phases appear in the Status box. Figure 3-8: Modeling status messages Modeling Your IT Infrastructure Administrator Guide 41

48 Chapter 3: Using Discovery to Discover and Model Defining and activating configurations You create and modify both discovery and modeling configurations using the Discovery tabbed dialog box. The following sections provide step-by-step procedures for defining and activating these configurations. For more information, see: Defining a Discovery configuration on page 42. Defining a Modeling configuration on page 45 Activating a Discovery session on page 49 Activating a Modeling session on page 51 Defining a Discovery configuration In order for SPECTRUM OneClick to determine which of the devices in your network to discover, you must define a discovery configuration. Procedure Follow these steps to define a discovery configuration: 1. In the OneClick window, select Tools >Utilities >New Discovery. The Discovery dialog box appears. 2. In the Discovery Configuration tab of the Discovery dialog box, specify the discovery configuration fields outlined in the following table. Note that there are two mandatory fields (IP Range and Community Strings) that you must specify to successfully create a discovery configuration: Field Configuration Name (optional) Seed Routers (optional, but recommended for large discovery operations.) Description In the Configuration Name box, specify a name for the discovery configuration. This field is required if you plan to save and reuse this configuration. Seed routers are a core list of routers that serves as a starting point for Discovery to determine the routed subnets. All routers discovered within the IP boundary list will be treated as seed routers. To populate the seed router list, do the following: 1. Build a list of one or more seed router addresses, by entering the address(es) in the Seed Router IP address box and clicking Add. 2. In the Discovery Type box, select one of the following: Routers and only local LANs in IP Boundary List. Discovers only the routed subnets within the IP range. Routers only. Discovers only the routing devices within the IP range. Routers and all local LANs. Discovers all subnets routed by the routers discovered in the IP range. 3. In the Max. subnet size box, select the max subnet size you want to discover. 42 Modeling Your IT Infrastructure Administrator Guide

49 Defining and activating configurations Field IP Boundary List (mandatory) Community strings (mandatory) Modeling Options (optional) (Admin modeling level privileges required.) Description In the IP list box, specify the IP address(es) you want Discovery to attempt to contact. To specify one address or a range of IP addresses you want to contact, do the following: 1. In the first IP address box, enter a single address or enter the lowest address in the IP range you want discovered then press the TAB key. Tips: You can use a wildcard character to input individual IP addresses. For example, entering *.1 could discover: ; ; ; etc. Alternatively, you can click the Import button to import a text file containing IP addresses and/or IP ranges. The text file must list each IP address (or range) on a single line. IP ranges should be separated by a dash ( - ). For example: In the second IP address box, specify the same single address or specify the highest address in the IP range you want discovered and click Add. Repeat steps 1 through 2 for each IP address or IP range of addresses that you want Discovery to contact. In the Community Strings group box, specify the SNMP community strings (passwords) for the devices you want discovered. Discovery, by default, uses public if no other community strings are specified. Tip. Alternatively, you can click the Import button to import a text file containing a list of community strings. The community string text file must list each community string on a separate line. Within the Modeling Options section, you can choose at this time to perform a Discover only operation or a combined discovery and modeling operation. When you choose to discover and model, you can click the Modeling Options button to review or modify the modeling configuration. For more information about parameters that define the modeling configuration, see Defining a Modeling configuration on page 45. Modeling Your IT Infrastructure Administrator Guide 43

50 Chapter 3: Using Discovery to Discover and Model Field Advanced Options Description Click the Advanced Options button if you want to: Define other SNMP Ports in addition to the default port (161) that Discovery uses. This feature is most often used for managed node environments in which proprietary SNMP protocols use ports other than the default port of 161. and/or Modify the default settings that Discovery provides for ICMP, route tables, throttle, time-out, and retries. A quick description of these options follows: ICMP. This option is enabled by default. When this option is enabled Discovery will use ICMP when discovering devices. If ICMP is enabled, Discovery pings the devices in the ranges/subnets first. The devices that responded to ICMP will then be queried using SNMP. This can greatly reduce the number of SNMP requests, especially when multiple community strings are being used. Route Table. This option is enabled by default. You should use this option only if seed routers are specified in the discovery configuration. When this option is enabled, Discovery finds neighbor routers and routed subnets from the IP route tables. Throttle. This option is set to None by default. Most often this option applies to networks with routing tables containing more than 1,000 entries. If you have networks with routing tables containing over a 1,000 entries, you can specify a throttle value (low, medium, or high) to stagger the processing workload by having SPECTRUM pause for one second after reading every 50 entries (high), 100 entries (Medium), or 250 entries (Low). Time-outs. This option is set to 3 by default. Use this option to specify the number of seconds Discovery spends per attempt at contacting an address. Retries. This option is set to 3 by default. Use this option to specify the number of additional attempts Discovery makes after the first attempt times out before establishing contact. 3. In the Discovery dialog box, do one of the following: Click Discover to activate a discovery session for the discovery configuration specified. Note that the results of the discovery session appear on the Discovery tab of the Discovery dialog box. Click Close to close the Discovery dialog box. If you named the Discovery Configuration, Discovery automatically saves the configuration; otherwise, the configuration parameters specified are not saved. Note: The Save options as default checkbox, when checked, enables you to apply the most recent changes made to any named Discovery configuration. 44 Modeling Your IT Infrastructure Administrator Guide

51 Defining and activating configurations Defining a Modeling configuration The modeling configuration dictates how Discovery models the devices it previously discovered. SPECTRUM OneClick, by default, provides modeling configuration parameters that you can choose to use or modify. At any time, you can review or change the modeling configuration by clicking the Modeling Options button on the Discovery Configuration tab or by clicking the Model button on the Discovery tab. The following procedure provides step-by-step instructions for defining a modeling configuration. Prerequisites Prior to using the following procedure to define a modeling configuration, you must create a discovery configuration, see Defining a Discovery configuration on page 42 for more information. You must have privileges to modeling operations. Procedure: Follow these steps to define a modeling configuration. 1. In the OneClick window, click Tools >Utilities >Open Discovery. The Open Discovery Configuration dialog box appears. 2. In the Open Discovery Configuration dialog box, double-click the name of the discovery configuration for which you want to define a modeling configuration. The Discovery Configuration tab of the Discovery dialog box appears. 3. In the Discovery dialog box, access the Modeling Configuration dialog box to define a modeling configuration in one of the following ways: To define a combined discovery and modeling session. Do the following: Or a. Click the Discovery Configuration tab. b. In the Discovery Configuration tab, click Discover and automatically model to SPECTRUM to instruct SPECTRUM to activate a modeling session immediately after the next discovery session. c. Click the Modeling Options button to review and/or modify the modeling configuration. The Modeling Configuration dialog box appears. d. Proceed to Step 4. To define a Modeling session after activating a discovery session. a. In the Discovery dialog box, click the Discovery tab then click Model. The Modeling Configuration dialog box appears. b. Proceed to Step 4. Modeling Your IT Infrastructure Administrator Guide 45

52 Chapter 3: Using Discovery to Discover and Model 4. In the Modeling Configuration dialog box, review or modify any of the following fields described in Table 3-2: Modeling configuration fields on page 46. Table 3-2: Modeling configuration fields Field Destination Container Modeling Layout Description The Destination Container is the container that Discovery uses to place new icons in the topology view. Discovery, by default, uses the Universe container as its destination container. If you want to select another container such as a LAN container, do the following: 1. Click the Select Container button. A list of containers appears. 2. View the container list by using the scroll bar or using the Filter text box. For instance, if you wanted to locate a LAN container, you could type LAN in the Filter text box. 3. Select the destination container that you want to use and click OK. In the Modeling Layout section you can dictate how Discovery places and arranges a model in the Universe topology view. Discovery, by default, uses a hierarchical placement and a radial arrangement. To modify the modeling layout that Discovery uses, do the following: 1. In the Placement box, select Flat or Hierarchical. If you choose Hierarchical, all Layer 3 devices, LAN containers, and Wide Area Links are placed in the Destination Container. Layer 1 and Layer 2 devices are placed in the proper LAN container (based on IP) under the Destination Container. Note that if Discovery is unable to find the appropriate LAN container for a Layer 1 or 2 devices, these devices are placed in the Destination Container. If you choose Flat, Discovery places all devices, including Layer 1 and Layer 2 in the Destination Container (no LAN containers are created). 2. In the Arrangement box, select Grid, Tree, or Radial. 46 Modeling Your IT Infrastructure Administrator Guide

53 Defining and activating configurations Table 3-2: Modeling configuration fields Field Modeling Options Description In the Modeling Options section, you can choose to enable or disable options that dictate how Discovery models discovered devices. A brief description follows about each of these modeling options: Create Wide Area Link Models. This option is by default enabled. When this option is enabled, Discovery creates a WA_Link model between the wide area linked interfaces of two routers. When this option is disabled, Discovery directly connects the linked interfaces. Create LANs (IP Subnets). This option is by default enabled. When this option is enabled, Discovery uses a LAN container to represent an IP Subnet. Discovery creates the LAN container during the Layer 3 mapping process for any router interface that routes to a local LAN. Remove Empty LANs. This option is by default disabled. When this option is enabled, Discovery destroys any empty LAN containers that were created by the Create LANs (IP Subnets) option. Create (Fanout). This option is by default disabled. When this option is enabled, and when SPECTRUM is unable to make an accurate connection among 3 or more interfaces, Discovery models an Fanout segment to represent the ambiguous connections among these interfaces. However, if the Traffic Resolution protocol option is enabled, SPECTRUM uses network traffic data (IfInOctet and ifoutoctect statistics) to determine connections between interfaces and, in many cases, eliminates the need to model a Fanout. Create Physical Address. This option is by default disabled. When this option is enabled, a physical address model is created for any MAC address that is not associated with any modeled device but was heard by a switch. This option is not recommended. Activation Time. This option, by default, is set to 5 minutes. You can adjust the activation time as desired using the up/down arrows. The activation time value determines the number of minutes Discovery waits for new models to activate before mapping connectivity. When the wait time expires without any new devices activating, connectivity is established insofar as possible, regardless of whether all connections to discovered devices have activated. The minimum activation time is 5 minutes and the maximum time is 15 minutes. Modeling Your IT Infrastructure Administrator Guide 47

54 Chapter 3: Using Discovery to Discover and Model Table 3-2: Modeling configuration fields Field Protocol Options Filter Options Description The Protocol options enable you to configure options for mapping connectivity between models. Discovery, by default, enables several of these protocol options based on best practices. To disable the default settings or enable additional protocol settings, click the Protocol Options button. A brief description follows about each of the protocol options: IP Address Table. This option is enabled by default. When this option is disabled, Discovery disables Layer 3 mapping and maps only the Layer 2 connections. In addition, when this option is disabled, Discovery automatically disables the IP Route Tables Protocol option, the Create Wide Area Link Model option, the Create LANs(IPSubnets) option, and the Remove Empty LANs options. IP Route Tables. This option is disabled by default since these tables can be very large and very time-consuming for Discovery to read. When this option is disabled, Discovery uses the IP Address table to map routers, but is not able to map unnumbered IP interfaces ( ). If you want to have these interfaces mapped, you should enable the IP Route Tables Protocol option. Source Address Tables. This option is enabled by default. When enabled, Discovery uses the device Source Address table to map layer 2 connectivity. Proprietary Discovery Tables. This option is enabled by default. When this option is enabled, Discovery uses the device Discovery tables when mapping layer 2 connectivity information about the device. Currently this option supports Cisco Discovery Protocol, Cabletron Switch Discovery Protocol, and Extreme Discovery Protocol. ARP Tables for pingables. This option is enabled by default. When enabled, Discovery uses the ARP table to determine pingable MAC addresses for the connectivity mapping. Spanning Tree. This option is enabled by default. When enabled, Discovery uses the device Spanning Tree Address table (SAT) when mapping layer 2 connectivity information about the device. Traffic Resolution. This option is enabled by default. When enabled, Discovery uses network traffic data to determine connections between interfaces. In many cases, by having Discovery use the traffic data eliminates the need to model Fanout segments. ATM Protocols. This option is disabled by default. When enabled, the ATM discovery runs against all ATM switches in the SpectroSERVER database. See the ATM Circuit Manger User s Guide (3578) for more information. Click the Filter Options button to access the Advanced Filter dialog box. You can use the Advanced Filter dialog box any time you have a need to exclude certain discovered devices from being modeled. For instance, if you wanted to exclude Discovery from modeling all discovered devices with IP addresses greater than you would: 1. In the Attribute box, select IP address. 2. In the Comparison Type box, select GREATER THAN. 3. In the Attribute Value box, specify the Click Ok. You can also click the Show Advanced button to create a complex filter criteria that includes a combination of AND/OR clauses. To learn more about how to use these clauses, click the Hints link on the Advanced Filter dialog box or see Using the Advanced Filter to filter results on page 53. Reset Defaults Click the Reset Defaults button anytime you want Discovery to use the default modeling settings provided with SPECTRUM OneClick. 48 Modeling Your IT Infrastructure Administrator Guide

55 Defining and activating configurations 5. How you accessed the Modeling Configuration dialog box in Step 3, determines whether you can instruct Discovery to: (1) save the modeling parameters you ve specified and activate a modeling session immediately; or, (2) save the modeling parameters specified and dismiss the dialog box without activating a modeling session. See the following information for clarification: If you clicked Modeling Options on the Discovery Configuration tab to access the Modeling Configuration dialog box, you can do one of the following: Click OK. To save all changes made and dismiss the Modeling Configuration dialog box. Discovery will use the last saved modeling parameters upon activating the next modeling session. Click Cancel. To dismiss the Modeling Configuration dialog box without saving any recent modeling changes made. Alternatively, if you prefer not to save the changes made, you can clear the Save options as default checkbox. If you clicked Model on the Modeling tab to access the Modeling Configuration dialog box. You can do one of the following: Click OK. To dismiss the Modeling Configuration dialog box, save the modeling configuration parameters currently specified, and activate a modeling session. Click Cancel. To dismiss the Modeling Configuration dialog box without saving any recent modeling changes made. Activating a Discovery session All users with privileges to discovery operations can activate a discovery session by clicking Discover on either the Discovery Configuration tab or Discover tab. In addition, if you have privileges to modeling operations, you can activate a discovery session from the Modeling tab by clicking Discover. The following procedure provides step-by-step instructions about how to activate a discovery session for an existing discovery configuration using the Discovery dialog box. Prerequisites If you do not have at least one existing discovery configuration created and ready to activate, see Defining a Discovery configuration on page 42 prior to using the procedure for activating a discovery session. You should review and make any necessary changes to the discovery configuration prior to using this procedure to activate a discovery session. For more information about reviewing or modifying the discovery configuration, see Defining a Discovery configuration on page 42. You must have read/write privileges to discovery operations to activate a discovery session. Procedure Follow these steps to activate a discovery session for an existing discovery configuration: 1. In the SPECTRUM OneClick window, click Tools >Utilities >Open Discovery. The Open Discovery Configuration dialog box appears. Modeling Your IT Infrastructure Administrator Guide 49

56 Chapter 3: Using Discovery to Discover and Model 2. In the Open Discovery Configuration dialog box, double-click the name of the discovery configuration for which you want to activate a discovery session. The Discovery dialog box appears. 3. In the Discovery dialog box, do one of the following: To activate a discovery session and/or combined discovery and modeling session, do the following: Or Click the Discovery Configuration tab then click Discover. Discovery activates a discovery session or a combined discovery and modeling session based on the parameters specified on Discovery Configuration tab. The results of the discovery session appear in the Discover tab. The results of the modeling session appear in the Modeling tab. To rediscover an existing discovered configuration, do the following: Or Click the Discovery tab then click Discover to activate a discovery session. All newly discovered results appear in the result list on the Discovery tab. Note that results from this new Discovery session overwrite the results of the previous Discovery session. To rediscover an existing modeled configuration, do the following: Click the Modeling tab then click Discover. All newly discovered results appear on the Discovery tab. Note that results from this new Discovery session overwrite the results of the previous Discovery session. 50 Modeling Your IT Infrastructure Administrator Guide

57 Defining and activating configurations Activating a Modeling session If you have privileges to modeling operations, you can activate a modeling session any time after you activate a discovery session by: (1) clicking Model on the Discovery tab; or, (2) clicking Discover and automatically model to SPECTRUM on the Discover Configuration tab. The following procedure provides step-by-step instructions about how to activate a modeling session. Prerequisites You must have activated at least one discovery session of an existing discovery configuration prior to activating a modeling session. For more information about activating a discovery session, see Activating a Discovery session on page 49. You should review and make any necessary changes to the modeling configuration prior to using this procedure to activate a modeling session. For more information about reviewing or modifying the modeling configuration, see Defining a Modeling configuration on page 45. If you want to exclude certain devices from being modeled, you should exclude these devices prior to using this procedure to activate a modeling session. For more information, see Exporting a results list on page 52. You must have privileges to modeling operations. Procedure Follow these steps to activate a modeling session for an existing discovery configuration: 1. In the SPECTRUM OneClick window, click Tools >Utilities >Open Discovery. The Open Discovery Configuration dialog box appears. 2. In the Open Discovery Configuration dialog box, double-click the name of the discovery configuration for which you want to activate a modeling session. The Discovery dialog box appears. 3. In the Discovery dialog box, do one of the following: In the Discovery Configuration tab click the option for Discover and automatically model to Spectrum then click the Discover button. Discovery activates a discovery session then automatically models the discovered devices appearing in the results tab of the Discovery tab. OR In the Discovery tab click the Model button to activate a modeling session and model the last set of discovered devices appearing in the results list of the Discovery tab. Modeling Your IT Infrastructure Administrator Guide 51

58 Chapter 3: Using Discovery to Discover and Model Viewing, filtering, or exporting the results lists Each time you activate a discovery session or modeling session, Discovery automatically places the results of those sessions in either the Discovery tab results box or the Modeling tab results box. You can use the results list in these tabs to filter the entities you want to model or export. For more information see these sections: Ways to filter, sort, and export the Discovery results list on page 37 Ways to filter, sort, and export the modeled results list on page 40 Exporting a results list on page 52 Using the Advanced Filter to filter results on page 53 Activating a Modeling session on page 51 Exporting a results list You can easily export a results list by clicking the Export button appearing on the Discovery or Modeling tab. The Export feature accesses the Export table data to file dialog box where you can identify the: Location to save the exported data file. Name for the exported data file. Type of file to use to export the data. Type of file format to save the file. Figure 3-9: Export table data to file File type Name of exported file File format 52 Modeling Your IT Infrastructure Administrator Guide

59 Viewing, filtering, or exporting the results lists Procedure: Exporting results set To export the results sets appearing on the Discovery or Modeling tab, follow these steps: 1. In Discovery dialog box, click the Discovery or Modeling tab. 2. Click the Export button. The Export table data to file dialog box appears. 3. In the Export table data to file dialog box, specify the following: a. In the Save in box, specify the location to save the exported data file. b. In the File name box, specify the name for the exported data file. c. In the Files of type box, specify the type of file format to export data. d. In the Save as type options, specify the file type you want to use when saving the exported data. 4. Click Save to export the data to specified location, file name, and file format. Using the Advanced Filter to filter results Using the Advanced Filter dialog box, you can create filters with compound clauses to exclude certain entries appearing in the discovery or modeling results list. If you have privileges to both discovery and modeling operations, you can access the Advanced Filter dialog prior to activating a combined discovery and modeling session. If you have privileges to discovery operations only, you can access the Advanced Filter dialog box after initiating a discovery session. Note: Discovery uses the results list on the Discovery tab to determine which devices to model or export. Prerequisite To filter certain devices from being modeled prior to a discovery session, you must have modeling privileges. To filter devices from being modeled after a discovery session, you must have at least one discovery results list available from an existing Discovery Configuration. Procedure: Advance Filter - excluding devices from modeling Follow these steps to use the Advanced Filter dialog box to exclude certain devices from modeling (or exporting): 1. To access the Advanced Filter dialog box, do one of the following to exclude devices from being modeled: Prior to discovery, do the following: a. In the Discovery dialog box, click the Discovery Configuration tab. b. In the Discovery Configuration tab, click the option for Automatically model to SPECTRUM then click the Modeling Options button. The Modeling Configuration dialog box appears. c. In the Modeling Configuration dialog box, click the Filter Options button. The Advanced Filter dialog box appears. Modeling Your IT Infrastructure Administrator Guide 53

60 Chapter 3: Using Discovery to Discover and Model d. Proceed to Step 2 of this procedure. After a discovery session, do the following: a. In the Discovery dialog box, click the Discovery tab. b. In the Discovery tab click the Advanced Filter icon button. The Advanced Filter dialog box appears. c. Proceed to Step 2 of this procedure. 2. In the Advanced Filter dialog box, specify the following fields to create a single expression filter. Field Attribute Case sensitive box Comparison Type Attribute value Description In the Attribute box, select an attribute of a device to filter. Note. If you choose an alphabetic attribute value, you can choose to either clear (ignore) or check (include) the case sensitivity option. In the Comparison Type box, select the type of comparison to be made against the value specified in the Attribute box. In the Attribute Value box, type or select the desired attribute value to filter. 3. Depending on whether you want to make a compound clause or single expression do one of the following: To filter a single expression, click OK. The Advanced Filter option excludes entities in the results list based on the filter parameters specified in Step 2. To build a compound clause, do the following: a. Click Show Advanced. The compound expression box and logical operator buttons appear. b. Click Add to move the single expression (created in Step 2) to the compound expression box. c. Click one of the following logical operator buttons to build a compound expression: New And; New Or; or And/Or. Notes: The compound expression is represented in a tree structure grouped by logical operators (AND/OR). Each logical operator in the tree can include any number of attribute criteria nodes and logical operator nodes. For additional information, click the Hints link. Alternatively, you can create advanced search expressions using polish notation. d. Repeat Steps 2 through 3 for each compound expression you want to build. e. Click OK after building the expressions. The Advanced Filter mechanism excludes the entities in the results list based on the compound filter expressions applied. 54 Modeling Your IT Infrastructure Administrator Guide

61 Chapter 4: Manual Modeling This chapter walks you through the process of modeling your IT infrastructure manually in the OneClick core topologies: Universe, Global Collections, TopOrg, and World. It includes conceptual information as well as procedural information for performing manual modeling tasks within each topology. Before you begin Review the following information to ensure you meet the prerequisites of this chapter and to familiarize yourself with the manual modeling information described in this chapter. Prerequisites: You must have adequate user level privileges to use the manual modeling options described in this chapter. For more information about setting user privileges, see the OneClick User Administration in the OneClick Administration Guide. You should be logged into the OneClick environment. If you are unsure how to access the OneClick environment, see the OneClick Console User Guide for more information. You should be familiar with the OneClick working environment (window, menu, navigation, etc.). If you are unfamiliar with these features, see the OneClick Console User Guide for more information. Manual modeling fundamentals and tasks After reading this chapter, you will fully understand how you can perform various manual modeling tasks within each topology. This chapter discusses the manual modeling process and tasks in the following sections: When to model manually in OneClick on page 56 Modeling manually in the Universe topology on page 56 Modeling manually in Global Collections topology on page 68 Manually modeling in the World topology on page 77 Manually modeling the TopOrg topology on page 79 55

62 Chapter 4: Manual Modeling When to model manually in OneClick In the SPECTRUM OneClick environment, you will most often perform manual modeling tasks when you want to represent one or more previously modeled Universe topology devices in other OneClick topologies such as Global Collections, World, or TopOrg. Other times you may want to manually model a network device in OneClick is after using the Discovery feature in the Universe topology. For instance, the Discovery feature is unable to discover new devices in your network that are temporarily offline or blocking management communication. To resolve this situation, you could choose to rediscover these new devices at a later time using Discovery, or you could manually add them to the Universe topology as described later in this chapter (see page 59). Additionally, you might decide to manually model one or more network connections between modeled devices appearing in a Universe or Global Collection view. Finally, you will want to manually model all container icons within a World or TopOrg topology view. Commonly-used modeling terminology The following table identifies commonly-used modeling terms: Table 4-1: Commonly-used modeling terms Container Connection Model by IP Address A container is a graphical icon that you can use to depict a group of modeled devices by network technology such as LAN, Network, ATM, or to represent some other containment concept such as a Department. A connection is a link between two modeled elements in a view. Model by IP Address is a modeling feature that you can use in the Universe, World, or TopOrg topology. This feature enables you to manually model a new device by specifying the device IP address. Model by Model Type Model by Model Type is a modeling feature you can use in the Universe, Work, or TopOrg topology. This feature enables you to manually model container icons or devices by a model type. Network Address A network address is the IP address of a device. Modeling manually in the Universe topology When modeling manually in the Universe topology view, we recommend that you consider following this process: Step 1: Create or use an existing container (LAN, Network, FDDI, etc.) to represent the group of devices you want to model. You can create containers at any topology level to reduce the complexity of your topology views. Containers can effectively help you monitor and manage the health of the devices they represent. 56 Modeling Your IT Infrastructure Administrator Guide

63 Modeling manually in the Universe topology Step 2: Add one or more devices to a container using the Create model by IP address or Create model by model type functions located in the toolbar area of the Universe topology view. Model by model type Model by IP Step 3: Depict the physical connections (pipes) between the modeled devices by using the Start and End Connection options on the right-mouse menu. Step 4: Place the topology view in Edit mode and enhance the topology view by using the tools provided in the Edit mode toolbar. Using these tools you can create lines, shapes, annotations, as well as, change the color of topology view s background. If at any point during the modeling process you determine that you want to remove a modeled element from a view, you can do so by selecting the element and clicking Delete (X). You can also at any time export an image of any Universe topology view to a PNG file for further review and distribution. For additional information about how to perform these manual modeling tasks in the Universe topology, see: Adding containers to Universe topology views on page 57 Adding network devices to Universe topology views on page 59 Creating connections (pipes) between modeled devices on page 64 Removing modeled elements from the Universe topology view on page 63 Exporting a Universe topology view on page 63 Adding containers to Universe topology views The following procedure describes how to manually add a container (LAN, FDDI, Fanout, etc.) to a Universe topology view by using the Select Model Type dialog box. Procedure Edit mode toolbar Follow these steps to model a container (LAN, ATM, etc.) in a Universe topology view: 1. In the Explorer tab of the OneClick navigation panel, select the Universe topology view where you want to add a container. The selected topology view appears in the Topology tab of the Contents panel. 2. In the Topology tab of the Contents panel, click the Create a new by Type icon in the Topology tab toolbar. The Select Model Type dialog box appears. 3. In the Select Model Type dialog box, do the following: Modeling Your IT Infrastructure Administrator Guide 57

64 Chapter 4: Manual Modeling a. Click the Container tab. b. In the Container tab, select the type of container you want to add then click OK. The Create Model of Type dialog box appears. Tip: In the Container tab, you can use the Filter text box to filter the container list. For example, type LAN in the Filter text box to filter the container list by all LAN container types. 4. In the Create Model of Type dialog box, specify any of the fields in the following table: Table 4-2: Create container fields Field Name (optional) Security String (optional) Network Address Note: This optional field appears only for Network and LAN containers Description Specify a name for the new container you are adding. After the container is created, this name appears in the label area under the container icon. If you want to prevent certain users from viewing the contents of this container, you can do so by specifying a security string expression in the Security String text box. For more information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the security chapter in the OneClick Administrator guide. If you want to specify one or more of the device IP address(es) that this container represents, you can do so by typing the address(es) in the Network Address text box. Subnet Address Note: This optional field appears only for Network and LAN containers If you want to identify the device subnet address that this container represents, you can do so by typing the subnet address in the Subnet Address text box. Note. When specified, the subnet address label appears whenever a user points to a container icon (using the mouse) in a topology view. 5. Click OK (in the Create Model of Type dialog box) to create the container and dismiss the Create Model of Type dialog box. Or, click Cancel to dismiss the dialog box and cancel the create container operation. When you click OK, SPECTRUM OneClick places the newly created network container in the selected Universe topology view. Tips: To move or enhance the appearance of the recently modeled container, click the Edit mode button in the Topology tab toolbar area. For instructions for editing, annotating, or enhancing a modeled element, see Chapter 5, Enhancing Topology Views and Editing Model Device Attributes, on page 83. Edit mode button 58 Modeling Your IT Infrastructure Administrator Guide

65 Modeling manually in the Universe topology To add modeled network devices to the container, you can double-click the container icon and copy and paste modeled devices from other Universe topology views into this container. Or, you can model new devices in this container by using these topology toolbar functions Create model by model type or Create model by IP address. For more information, see Adding network devices to Universe topology views on page 59. Adding network devices to Universe topology views The following procedures describe how to manually add network devices to a Universe topology view using the Topology toolbar functions Create model by IP address and Create model by model type. The best practice for manually adding a device to the OneClick environment is to use the Create model by IP address function. The Create model by model type function is considered an advanced function that requires you to have an understanding of how network devices are categorized in the SpectroSERVER modeling catalog. Procedure: Add device using Create model by IP address 1. In the Explorer tab of the OneClick navigational panel, navigate to the Universe topology view where you want the new device to appear. The selected Universe topology view appears in the Topology tab of the Contents panel. Tip: If you want to place the new device inside a network group container, double-click the container icon to display the topology view for that container. 2. In the Topology tab toolbar area, click the Create model by IP address button. The Create Model by IP Address dialog box appears. 3. In the Create Model by IP address dialog box, specify the device network address and any other optional fields described in the following table: Table 4-3: _Create model by IP Address Network Address (mandatory) Community Name (optional) DCM Time-out (optional) DCM Retry Count (optional) Agent port (optional) In the Network Address text box, specify the network address (IP address) for the device you are modeling. If you want SPECTRUM OneClick to communicate with the device you are adding, you must provide the SNMP community string for the device (in the Community Name text box). The DCM (Device Communication Manager) time-out value, by default, is 3000 milliseconds (3 seconds). This option determines how long the SpectroSERVER will wait for a response from the device. The DCM (Device Communication Manager) count value, by default, is 2. This option determines how often the SPECTRUM Server tries to communicate with the device after the DCM time-out value expires. The agent port is the SNMP agent port. The SNMP agent port, by default, is 161. Modeling Your IT Infrastructure Administrator Guide 59

66 Chapter 4: Manual Modeling SNMP V2C Enabled (optional) Note. This SNMP option only appears when the SNMP V3 option is installed. SNMP V3 Enabled (optional) Note. This SNMP option only appears when the SNMP V3 option is installed. Table 4-3: _Create model by IP Address The SNMP V2C Enabled option lets you specify if the device you are modeling supports SNMPv2c protocols. When this option is enabled (checked), SPECTRUM uses SNMPv2c protocols to discover and map the specified device. The SNMP V3 Enabled option enables you to specify if the device you are modeling supports SNMPv3c protocols. When this option is enabled (checked), SPECTRUM uses SNMP V3 protocols to discover and model the specified device. For more information about configuring SNMP V3 devices, see the SPECTRUM SNMP V3 User Guide (5124). Discover connections (optional) If you want SPECTRUM OneClick to discover the linked connections (pipes) between the device (you are adding) and other devices, enable the Discover Connection checkbox with a check mark. 4. Click OK (in the Create Model by IP Address dialog box) to dismiss the dialog box and create a device icon for the specified network device. Or, click Cancel to dismiss the dialog box and cancel the model by IP operation. When you click OK, SPECTRUM OneClick places the newly created device icon in the selected Universe topology view. Tips: To move or enhance the appearance of the recently modeled device icon, click the Edit mode button in the Topology tab toolbar. For instructions for editing, annotating, or enhancing a modeled element, see Chapter 5, Enhancing Topology Views and Editing Model Device Attributes, on page 83. Edit mode button To cut and paste the modeled device icon to another Universe topology view, use the cut and paste functions in the Topology tab toolbar area. To copy or paste the modeled device icon to another topology view other than the Universe topology, use the copy and past functions in the Topology tab toolbar area. To change configuration parameters of a modeled device (for example, community name, polling interval, logging interval, security string, etc.) select the modeled device and change the appropriate setting(s) in the Component Detail panel. Procedure: Add device using Create model by model type Follow these steps to depict network devices in a view by model type: 1. In the Explorer tab of the OneClick navigational panel, navigate to the Universe topology view where you want the new device to appear. The selected Universe topology view appears in the Topology tab of the Contents panel. 60 Modeling Your IT Infrastructure Administrator Guide

67 Modeling manually in the Universe topology Tip: If you want to place the new device inside a container, double-click the container icon to display the topology view for that container. 2. In the Topology tab toolbar area, click the Create a new model by type button. The Select Model Type dialog box appears. 3. In the Select Model Type dialog box, do the following: a. Click the All Model Types tab. b. In the All Model Types tab, select the SpectroSERVER model type of the device you are adding and click OK. The Create Model of Type dialog appears 4. In the Create Model of Type dialog box, specify the following fields that describe the device model type you are modeling. Note that the following table list descriptions for all fields of all model types. Table 4-4: Create Model by model type Landscape ID Name Network Address Community Name Security string Serial Number Each Landscape in a network is unique and must be identified by a Unique Landscape Handle (ID). This landscape ID is used to communicate between VNMs. Specify a unique name for the device you are modeling. If you want SPECTRUM OneClick to communicate with the device you are adding, you must provide the IP address for that device. If you want SPECTRUM OneClick to communicate with the device you are adding, you must provide the SNMP community string for the device you are modeling. If you want to prevent some users from viewing this device, you can do so by specifying a security string in Security String text box. For further information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the User Administration and Model Security chapter in the OneClick Administration guide. If you want to identify the serial number for the device you are modeling, you can do so in the Serial Number text box. Poll interval By default, SPECTRUM OneClick polls modeled devices for status updates every 60 seconds (or for some model types every 3000 seconds). You can increase or decrease the polling interval by changing the value in the Port Interval text box. Tips: If you increase the time between polling intervals, you will use less bandwidth for management traffic, but you will receive device status updates less frequently. If you decrease the time between polling intervals, you will have more frequent updates of device status, but you will use more bandwidth. One way to achieve both goals is to use the default polling interval (60 seconds) for the router and edit the polling interval for all other devices to 600 seconds. Log ratio (optional) Creation Author Manufacturer The log ratio defines how many times SPECTRUM polls devices for updates before logging the results. By default the log ratio is 10 (SPECTRUM logs the polling results after it polls the device every 10th time). In the Creation Author text box, you can specify the name of the author that is modeling this managed device. In the Manufacturer text box, you can specify the manufacturer name of the managed device you are modeling. Modeling Your IT Infrastructure Administrator Guide 61

68 Chapter 4: Manual Modeling Table 4-4: Create Model by model type Southbound Gateway specific Note: For more information about Soouthbound Gateway settings, see the Southbound Gateway Toolkit Guide (2246). Unique ID Manager Name Event Model Prefix The Unique Identifier is a composite of up to 6 variable data items (1-6). The final unique identified string is composed as follows: <1>_<2>_<3>_<4>_<5>_<6> If one of the unique identifier components is not provided, it is not included within the composite unique identifier. If the name of the third-party application does not apply in the list, choose Default. When this attribute is set on the EventAdmin, all EventModels contained with this EventAdmin will inherit this attribute. This field is prepended to the EventModel Name for all of the Event Models contained by this EventAdmin. It provides a way to ensure consistent naming prefixes for all EventModels associated with a particular EventAdmin. This is useful when sorting or filtering various SPECTRUM applications. Dialup_Link specific Note: For more information about Dialup Link settings, see the Non-Persistent Connections Manager User Guide (2246). Dialup Link type Dialup protocol type Activation Grace period Deactivation Grace Period Active time until yellow Active time until orange Active time until red The functional type of the Dialup Link. Possible types are Backup (DBL), Primary (PODL), and Bandwidth (BODL). The protocol type that will be used on the Dialup Link. Possible protocol types are Analog, Switch, ISDN, and FrameRelay. This field enables you to specify the time allowed, in minutes, for the secondary link to become active after a primary link failure. If this grace period expires before the secondary link is active, then a red alarm is generated. This field is only used by DBL-type link models. The default setting is 3 minutes. This field enables you to specify the time allowed, in minutes, for an active secondary link to deactivate after the failed primary link reactivates. If the secondary link is still active after this grace period expires, then a yellow alarm is generated. This field is only used by DBL-type Link models. The default setting is 3 minutes. This field enables you to specify the number of hours a backup link can be active before a yellow alarm is generated. This field enables you to specify the number of hours a backup link can be active before an orange alarm is generated. This field enables you to specify the number of hours a backup link can be active before an red alarm is generated. 5. Click OK (in the Create Model by Type dialog box) to dismiss the dialog box and to create a modeled device icon for the specified device. Or, click Cancel to dismiss the dialog box and cancel the model by type operation. When you click OK, SPECTRUM OneClick places the newly created device icon in the selected Universe topology view. Tips: To move or enhance the appearance of the recently modeled device icon, click the Edit mode button in the Topology tab toolbar. For instructions for editing, annotating, or 62 Modeling Your IT Infrastructure Administrator Guide

69 Modeling manually in the Universe topology enhancing a modeled element, see Chapter 5, Enhancing Topology Views and Editing Model Device Attributes, on page 83. Edit mode button To cut and paste the modeled device icon to another Universe topology view, use the cut and paste functions in the Topology tab toolbar area. (or use the copy and paste functions to copy and paste modeled icon to another topology - World, TopOrg, or Global Collection). Removing modeled elements from the Universe topology view When you cut a modeled element from a topology view, SPECTRUM OneClick removes the model from the view and places it into the Lost and Found view. You can at any time, completely remove the modeled element from the Lost and Found view by deleting it from the List Tab of the Lost and Found Contents panel. Procedure: Cut modeled element from view Follow these steps to delete a modeled element from a Universe topology view. 1. In the Universe topology view, do one of the following: Right-click a modeled element, and select Cut. The deleted modeled element appears in the Lost and Found view. Select a modeled element and click Cut in the Topology tab toolbar area. The cut modeled element and appears in the Lost and Found view. Procedure: Delete modeled element from Lost and Found Follow these steps to delete a modeled element from the Lost and Found view. 1. In the Explorer tab of the navigation panel, click Lost and Found. 2. In the Lost and Found Contents panel, click the List tab. 3. In the List tab, select the elements you want to remove then click Delete in the List tab toolbar area. Exporting a Universe topology view You can export any Universe topology view to a PNG file format. For more information, see the following procedure. Procedure: Create a PNG file 1. In the Explorer tab of the navigation panel, navigate to the Universe topology view that you want to export. The selected topology view appears in the Topology tab of the Contents panel. 2. In the Topology tab, click the Export icon button in the Topology toolbar area. The Save As PNG dialog box appears. 3. In the Save As PNG dialog box, specify the name and location you want to export the view then click OK. Modeling Your IT Infrastructure Administrator Guide 63

70 Chapter 4: Manual Modeling Creating connections (pipes) between modeled devices In SPECTRUM OneClick, you can manually create the following three types of connections between modeled devices: Resolved connection (a.k.a., fully-resolved connection). A resolved connection is when two devices are connected at the port level. For example, Port-A of device-one is connected to Port- B of device-two. To learn how to create a port-to-port connection, see Creating a resolved connection (both device ports known) on page 66. Partially-resolved connection. A partially-resolved connection is when only one port is known between two devices. You typically create this type of connection when you know only the port of one modeled device. For example, Device-one is connected to Port-A of Device-two. Note that when you manually model a partially-resolved connection, SPECTRUM attempts to resolve the port connection of the other device. If SPECTRUM succeeds, it will represent the connection as fully resolved connection. You can later determine if the connection is fullyresolved by clicking the link within that view and viewing the Link Information tab on the Component Detail panel. To learn how to create a partially-resolved connection, see Creating a partially-resolved connection (one device port known) on page 66. Unresolved connection. An unresolved connection is when two modeled devices (or containers) are not connected in any way at the port level. For example, Container-A is connected to Container-B. Static connection color representation after modeling Initially after modeling a connection the color of the connection appears silver or gold. Note that gold appears only for resolved or partially-resolved connections. Silver appears for all unresolved connections. Dynamic link status - partial or fully-resolved connections After you create a partial or fully-resolved connection between two modeled elements, you can monitor the status of that connection by enabling the connection (pipe) as a Live Pipe. The color of live pipes in the Universe topology views indicate status information about the connection. For example, good connection conditions display green; bad connection conditions display red, or disabled live-pipe connections display gold. A live pipe shows a combined status condition for fully-resolved connections (two ports). The connection having the most severe condition (lost, etc.) determines the pipe s color. A live pipe can generate an alarm when one or both the links it represents goes down. For more information about enabling a live pipe connection, see Enable or disable a live link (applies to full or partial resolved connections) on page 67. Removing connections from a Universe topology view You can at any time delete a connection between two modeled elements in the Universe topology view by right-clicking the pipe and selecting Delete. When a pipe is deleted, SPECTRUM OneClick removes all of its associations. If the pipe represents more than one port connection, SPECTRUM OneClick prompts you to confirm the deletion. 64 Modeling Your IT Infrastructure Administrator Guide

71 Modeling manually in the Universe topology Automatic recreation of pipes Pipes are automatically recreated anytime you copy and paste a set of previously connected modeled icons to another Universe topology view. If you delete one of the connected modeled icons from the view, the pipe is erased. If you later copy that device from the Lost and Found view to the original topology view, SPECTRUM OneClick automatically recreates the connection between the two modeled devices. Locking manually resolved connections You can preserve any manually configured resolved connection between two modeled devices by locking that connection. Note that OneClick Discovery process will not remove any resolved connection that is locked. You can lock or unlock a resolved connection by right-clicking the connection and selecting Lock Connection. For more information, Locking and Unlocking resolved connections on page 67. For step-by-step instructions for manually creating connections between modeled elements in a Universe topology view, see the following the sections: Creating an unresolved connection between modeled elements on page 65 Creating a resolved connection (both device ports known) on page 66 Creating a partially-resolved connection (one device port known) on page 66 Locking and Unlocking resolved connections on page 67 Enable or disable a live link (applies to full or partial resolved connections) on page 67 Creating an unresolved connection between modeled elements When you do not know the port connections between two modeled elements that you want to connect, you can create an unresolved connection. When you create an unresolved connection between two modeled elements in the Universe topology view, the pipe representing the connection appears silver and you are prevented from enabling that connection as a Live Pipe. However, after you create an unresolved connection between two modeled elements in a Universe topology view, SPECTRUM automatically attempts to resolve the connection between the two modeled elements. If SPECTRUM succeeds in resolving the connection, the pipe representing the connection appears gold and behaves as a resolved connection. You can then proactively monitor the status of that resolved connection by right-clicking the pipe and selecting Live Pipe. Note: If SPECTRUM is unable to detect at least one port level connection between two devices, the pipe in the topology view remains as an unresolved connection (silver). You cannot enable Live Pipe on an unresolved connection. Procedure: Creating an unresolved connection Follow these steps to create an unresolved connection: 1. Designate the starting point of a connection by following this step: a. In a Universe topology view, right-click any modeled element (device or container) select Start Connection. 2. Designate the endpoint of the connection by following this step: Modeling Your IT Infrastructure Administrator Guide 65

72 Chapter 4: Manual Modeling a. In a Universe topology view, right-click the modeled element (device or element) and select Connect with <starting point address>. SPECTRUM OneClick models an unresolved silver colored pipe between the two modeled devices. Note that if the connection (between the modeled elements) spans across two separate views, an off-page reference icon appears in the view. Creating a resolved connection (both device ports known) When you know the ports of both modeled devices, you can create a port-to-port (resolved) connection. Procedure: Create a resolved connection between two interfaces 1. Designate the starting point of a connection by following these steps: a. In a Universe topology view, select a modeled device (such as a switch or router) that contains port interfaces. b. In the Components Detail panel, click the Interfaces tab. The Interface tab provides a tree view of all ports discovered on that device. c. In the Interfaces tab, right-click a port row and select Start Connection. 2. Designate the endpoint of the connection by following these steps: a. In a Universe topology view, select a modeled device (such as a switch or router) that contains port interfaces. b. In the Components Detail panel, click the Interfaces tab. The Interfaces tab provides a tree view of all ports discovered on that device. c. In the Interfaces tab, right-click a port description and select Connect with <starting point port address>. SPECTRUM OneClick creates a resolved (gold-colored) pipe between the two modeled icons. Note that if the modeled devices are in separate views, an off-page reference icon appears in the view. Tip: To monitor the link status of this connection, right-click the connection and select Enable/Disable Live Links. For more information, see Dynamic link status - partial or fully-resolved connections on page 64 or Enable or disable a live link (applies to full or partial resolved connections) on page 67. Creating a partially-resolved connection (one device port known) When you know only the device port of one of the two modeled devices that you want to connect, you can create a partially-resolved connection. For more information, see the following procedure: Procedure: Create partially-resolved connection 1. Designate the starting point of a connection by following these steps: a. In a Universe topology view, select a modeled device (such as a switch or router) that contains port interfaces. b. In the Component Details panel, click the Interfaces tab. The Interface tab provides a tree view of all ports discovered on that device. 66 Modeling Your IT Infrastructure Administrator Guide

73 Modeling manually in the Universe topology c. In the Interfaces tab, right-click a port row and select Start Connection. 2. Designate the endpoint of the connection by following these steps: Tips: a. In a Universe topology view, right-click any modeled element (device or container) with unknown port address and select Connect with <starting point modeled port address>. SPECTRUM OneClick models a partially-resolved (gold colored) pipe between these two modeled devices. Note that if the connection between the modeled devices spans across two separate views, an off-page reference icon appears in the view. SPECTRUM OneClick will automatically attempt to locate the unknown device port. You can verify if SPECTRUM succeeds at locating this device port by clicking the link and viewing the Link Information tab in the Component Details panel. To monitor the link status of this connection, right-click the connection and select Enable/ Disable Live Links. For more information, see Dynamic link status - partial or fullyresolved connections on page 64 or Enable or disable a live link (applies to full or partial resolved connections) on page 67. Locking and Unlocking resolved connections In SPECTRUM OneClick, you can preserve a resolved connection between two modeled devices by locking that connection. When you lock a connection, Discovery will not delete the connection. Procedure 1. In a Universe topology view, right-click the connection you want to lock and select Lock Connection. A Lock Connection dialog box appears. 2. In the Lock Connection dialog box, check the connections you want to Lock and click OK. Tip: To unlock a locked connection, right-click the locked connection, select Lock Connection, and clear the locked connection check box. Enable or disable a live link (applies to full or partial resolved connections) You can monitor the link status of any resolved connection depicted in the Universe topology views by enabling Live Links. When you enable a live link on a partial or fully-resolved connection, you are able to monitor the port connections at either end of the modeled devices. The status condition of a live link displays through colors (red for critical, green for good, etc.). Additionally, if a port-connection within a live link goes down, you can view alarm information about that connection in the Alarm tab of the Contents panel. The following procedures describe how to enable and disable a live link for a partial or fullyresolved connection. For more information about creating a partial or fully-resolved link, see Creating a resolved connection (both device ports known) on page 66 and Creating a partiallyresolved connection (one device port known) on page 66. Procedure: Enable a live link connection Follow these steps to enable or disable a live link on a partial or fully-resolved connection: 1. Right-click the connection you want to enable as a live link and select Live Link. The Enable/ Disable Live Link dialog box appears. Modeling Your IT Infrastructure Administrator Guide 67

74 Chapter 4: Manual Modeling 2. In the Enable/Disable Live Link dialog box, check the connections you want to make live then click OK. SPECTRUM indicates the link is live by changing the gold color pipe to green (good condition) or red (bad condition). Procedure: Disable a live link connection Follow these steps to enable or disable a live pipe: 1. Right-click the live link connection you want to disable. The Enable/Disable Live Link dialog box appears. 2. In the Enable/Disable Live Link dialog box, clear the checkboxes for the connections you want to disable then click OK. SPECTRUM indicates the live link is disabled by changing the color of the connection to gold. Modeling manually in Global Collections topology In the Global Collection topology, you can create a collection of any modeled elements previously modeled in one or more Universe topology views. When you create a collection within the Global Collections topology, you must provide a name for that collection and define its members. You can choose to define the members of a collection by either specifying a search criteria or using the copy/paste or add functionality offered in the topology view menus and toolbars. Dynamic membership - using search criteria When you use a search criteria to define the members of a collection, the members of that collection are considered dynamic. They remain in the collection only as long as they meet the specified search criteria. When a modeled element no longer meets the original search criteria specified, SPECTRUM automatically removes that modeled element from the collection. At any time, you can choose to redefine the members in a dynamic collection by editing the specified search criteria. Static membership - using copy/cut/paste When you use copy/paste or add functions to define members of a collection, the members of that collection are considered static. Static members always remain in a collection until you decide to manually remove them. Managing connections between modeled elements (members) The connections between modeled elements in a Global Collection topology view exhibit the same behavior and functionality as the connections between modeled elements in a Universe topology view. In the Global Collections view, you can choose to create partial and fully-resolved connections, or unresolved connections (a.k.a.,links, pipes). You can monitor the status of any resolved connection using Live Links. For more information about creating connections in the Universe or Global Collections views, see Creating connections (pipes) between modeled devices on page Modeling Your IT Infrastructure Administrator Guide

75 Modeling manually in Global Collections topology Updates to modeled elements in collections SPECTRUM OneClick updates all modeled elements in a Global Collection view as often as the Search Interval specifies. For instance, the search interval, by default, updates the dynamic members within a collection every twenty-four hours. Generating reports on collections You can generate reports on one or more global collections using the Report Manager module. For example, when you choose to use the Report Manager module with OneClick, you can generate reports about: Individual collections. By using the Report Manager module with the OneClick Global Collections topology, you can at any time generate a single report about any one collection. For more information about running individual collection reports, see the Report Manager User Guide. Multiple collections. By setting-up a Global Collection Hierarchy within the Explorer tab of the navigation panel you can later use the Report Manager module with OneClick to generate single reports about multiple collections. Global Collection Hierarchy view Within the Global Collections Hierarchy navigation, you can create one or multiple folders to represent previously defined global collections. For example, if you wanted to generate a report about a North East Sales region and its offices, you could create a top-level folder for the North East Sales Region, and sub-level folders for the regional offices. You could then populate these folders with any collections previously defined in the Global Collections topology. After you have set-up a Global Collection Hierarchy, you can use the Report Manager module to generate a report about any folder representing multiple collections. For more information about how to set-up a Global Collection Hierarchy with previously defined collections in folders, see Procedure: Create a Collection Hierarchy on page 77. For more information about using Report Manager to generate a report about multiple global collections, see the Report Manager Guide. Note. The Report Manager module is not included in the SPECTRUM core product line. This module must be purchased separately. Modeling Your IT Infrastructure Administrator Guide 69

76 Chapter 4: Manual Modeling Recommended process for defining collections When defining a collection of modeled elements in the Global Collection topology, consider following these steps: Step 1. Create a new collection. A new collection remains empty until you define its members. Step 2. Define dynamic members or, when necessary, define static members. Step 3. Edit members in a collection as needed. For dynamic members in a collection, you can redefine the search criteria. For static members, you can delete, copy/paste, or add members in a collection. Step 4: Setup a Global Collection Hierarchy if you intend to use the Report Manager module to report on multiple collections. Step 5: Delete collections as needed. Note that since the modeled elements within a global collection represent copies of modeled elements from the Universe topology, the Delete operation removes only the specified global collection and the copies of the modeled elements that collection represents. Performing Global Collections modeling tasks The following sections define how to perform various modeling tasks when defining collections in the Global Collection topology. Additionally, the last section defines how you can setup a Global Collections Hierarchy. Defining a new collection on page 70 Procedure: Create an empty collection on page 72. Procedure: Create a new dynamic collection (Explorer tab) on page 73 Procedure: Create a new static collection on page 74 Editing an existing collection on page 75 Procedure: Add static members to an existing collection on page 75 Procedure: Edit dynamic members in existing collection on page 76 Procedure: Remove static members from existing collection on page 76 Creating a Global Collection Hierarchy for reporting on page 76 For more information about why you want to create global collections, see About the Global Collections topology on page 13 in Chapter 2. Defining a new collection To create a new collection within the Global Collections topology, you will use the Create Global Collections dialog box (Figure 4-1). If you are unsure of the type of collection you want to create, you can create an empty collection by providing only the name of the collection. After you create the collection, you can add static members, dynamic members, or both to the collection. 70 Modeling Your IT Infrastructure Administrator Guide

77 Modeling manually in Global Collections topology Figure 4-1: Create Collection dialog box You must provide a name for the collection you want to create. A description and a security string are optional. The Advanced button (optional) enables you to immediately define dynamic members through a search criteria. If you know ahead of time you are creating a new collection of dynamic members, you can click the Advanced button in the Create Collections dialog box to immediately define the dynamic members using a search criteria. The Advanced button launches the Advanced Collection Options dialog box as shown in Figure 4-2. Figure 4-2: Advanced Collections Options Alternatively you can create a dynamic collection by using the Search options offered in the Locator tab of the OneClick navigation panel (as shown in Figure 4-3). Figure 4-3: Locator tab - Search- Create Collection Create a collection from the Locater tab. If you want to create a collection of static members on the fly you can do so by right-clicking any modeled element in the Universe topology and selecting Add To -> Collection. This feature launches the Select Collection dialog where you can specify which collection to add the modeled Modeling Your IT Infrastructure Administrator Guide 71

78 Chapter 4: Manual Modeling devices or create a new collection of the devices by clicking the Create Collection button as shown in figure Figure 4-3. Figure 4-4: Select Collections dialog box - Create Collection The Create button enables you to create a new collection based on the modeled elements selected. The following procedures describe how to create an empty collection (page 72), a new dynamic collection (page 73), and a new static collection (page 74). For more information about adding static or dynamic members to an existing collection, or about removing and redefining existing members in a collection, see Editing an existing collection on page 75. Procedure: Create an empty collection 1. In the Explorer tab of the OneClick navigation panel, right-click Global Collections and select Create Collection. The Create Collection dialog box appears. 2. In the Create Collection dialog box, define the following fields: Table 4-5: _Create new collection Name (mandatory) Description (optional) Security string (optional) In the Name text box, you must enter a unique name for the collection you are creating. In the Description text box, you can specify a description of the collection you are creating. If you want to prevent certain users from viewing the contents of this collection, you can do so by specifying a security string expression in Security String text box. For more information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the security chapter in the OneClick Administrator guide. 3. Click OK (in the Create Collection dialog box) to dismiss the dialog box and create the Global Collection. Or, click Cancel to dismiss the dialog box and cancel the creation of the collection. When you click OK the newly named collection appears in the navigation panel under the Global Collection node. Tip: You can edit an existing collection s description, security parameter, or search criteria by right-clicking the collection in the navigation panel and selecting Edit Collection. 72 Modeling Your IT Infrastructure Administrator Guide

79 Modeling manually in Global Collections topology Procedure: Create a new dynamic collection (Explorer tab) 1. In the Explorer tab of OneClick navigation panel, right-click Global Collections and select Create Collection. The Create Collection dialog box appears. 2. In the Create Collection dialog box, define the following fields: Table 4-6: _Create new collection Name (mandatory) Description (optional) Security string (optional) In the Name text box, you must enter a unique name for the collection you are creating. In the Description text box, you can specify a description of the collection you are creating. If you want to prevent certain users from viewing the contents of this collection, you can do so by specifying a security string expression in Security String text box. For more information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the security chapter in the OneClick Administrator guide. 3. Click the Advanced button (in the Create Collections dialog box) to launch the Advanced Collections Options dialog box. 4. In the Advanced Collections Options dialog box, specify any of the following fields to create a single search expression: Table 4-7: _Advanced Collections Options Attribute... Do the following: Click the Attribute drop-down list box to select the specific attribute you want to find from a predefined list of commonly-used attributes. Alternatively, if you cannot find the attribute you want to specify from the predefined list of attributes, you can: Click the Attribute button to specify the Model type (device, port, or other) and its associated attribute that you want to find. Comparison Attribute Value In the Comparison Type box, select the type of comparison to be made against the value specified in the Attribute box. In the Attribute Value box, type the desired attribute value to search. 5. Depending on whether you want to conduct a compound search clause or a single search clause do one of the following: To conduct a search based on a single expression, click OK and proceed to Step 6. To conduct a search based on a compound clause, do the following to build a compound search clause: a. Click Show Advanced. The compound expression box and logical operator buttons appear. b. Click Add to move the single expression (created in Step 4) to the compound expression box. Modeling Your IT Infrastructure Administrator Guide 73

80 Chapter 4: Manual Modeling c. Click one of the following logical operator buttons to build a compound expression: New And; New Or; or And/Or. Note: The compound expression is represented in a tree structure grouped by logical operators (AND/OR). Each logical operator in the tree can include any number of attribute criteria nodes and logical operator nodes. For additional information, click the Hints link in the Advanced Collections dialog box. d. Repeat Steps 4 through 5 for each compound search expression you want to build. 6. In the Update search field, specify how often you want SPECTRUM OneClick to conduct a search to update the members defined in the collection. 7. Click the Landscapes button to identify which Landscapes you want Search to include when searching models to populate a collection. 8. Click OK after building the search expression(s). The Advanced Search mechanism locates and places a copy of all matching modeled elements (previously defined in the Universe topology) in the collection. Procedure: Create a new static collection To create a new collection of static members on the fly from the Universe topology, follow these steps: 1. In the Universe topology, do one of the following to designate the modeled elements you want to define in a collection: Single modeled element selection. In the Universe navigation panel, right-click a modeled element and select Add To --> Collections. The Select Collections dialog box appears. or Tip: Alternatively, you can right-click any single modeled element in any Universe topology view and select Add To --> Collections. The Select Collections dialog box appears. Multiple modeled element selection. To multi-select modeled elements in a Universe topology view, do the following: a. Hold-down the SHIFT key and individually select the modeled elements. b. While holding-down the SHIFT key, right-click the last selected modeled element and select Add To --> Collections. The Select Collections dialog box appears. Tip: Alternatively, you can select one or more modeled elements in the List tab and add them to a new collection. 2. In the Select Collections dialog box, click Create. The Create Collections dialog box appears. 3. In the Create Collection dialog box, specify a name for the collection and any other optional fields defined in Figure 4-8:. Table 4-8: _Create new collection Name (mandatory) In the Name text box, you must enter a unique name for the collection you are creating. 74 Modeling Your IT Infrastructure Administrator Guide

81 Modeling manually in Global Collections topology Table 4-8: _Create new collection Description (optional) Security string (optional) Advanced button (optional) In the Description text box, you can specify a description of the collection you are creating. If you want to prevent certain users from viewing the contents of this collection, you can do so by specifying a security string expression in Security String text box. For more information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the security chapter in the OneClick Administrator guide. Click the Advanced button only if you want to change the default Landscape setting where this collection will be created. 4. Click OK (in the Create Collection dialog box) to dismiss the dialog box and create the collection. Or, click Cancel to dismiss the dialog box and cancel the creation of the collection. Note. When you click OK the newly named collection appears in the navigation panel under Global Collections. Tip: You can edit an existing collection s description, security parameter or search criteria by right-clicking the collection in the navigation panel and selecting Edit Collection. Editing an existing collection You can edit any existing collection in the Global Collections topology by adding static members, editing a search criteria to redefine dynamic members, or removing one or more static members. The following procedures provide instructions for adding static members, redefining dynamic members, and removing static members Procedure: Add static members to an existing collection Follow these steps to add static members to an existing collection: 1. In the Universe topology, do one of the following to designate the modeled elements you want to add to a collection: Single modeled element selection. In the Universe navigation panel, right-click a modeled element and select Add To --> Collections. The Select Collections dialog box appears. or Tip. Alternatively, you can right-click any single modeled element in any Universe topology view and select Add To --> Collections. The Select Collections dialog box appears. Multiple modeled element selection. To multi-select modeled elements in a Universe topology view, do the following: a. Hold-down the SHIFT key and individually select the modeled elements. b. While holding-down the SHIFT key, right-click the last selected modeled element and select Add To --> Collections. The Select Collections dialog box appears. Tip. Alternatively, you can multi-select one or more modeled elements in the List tab and add them to an existing collection. 2. In the Select Collections dialog box, select the name of the collection where you want to add the modeled elements then click OK. Modeling Your IT Infrastructure Administrator Guide 75

82 Chapter 4: Manual Modeling Procedure: Edit dynamic members in existing collection Follow these steps to edit dynamic members in an existing collection: 1. In the Explorer tab of the OneClick navigation panel, navigate to the Global Collections node. 2. Right-click the collection you want to edit and select Edit Collection. The Edit Collection dialog box appears. 3. In the Edit Collection dialog box, edit any of the following fields:. Table 4-9: _Edit collection Description Security string Advanced button In the Description text box, you can specify a description of the collection you are creating. If you want to prevent certain users from viewing the contents of this collection, specify a security string expression in Security String text box. For more information, see Granting or denying access to modeled elements in Chapter 2 of this guide; or, see the User Administration and Model Security chapter in the OneClick Administrator Guide. Click the Advanced button to edit the: search criteria specified for this collection. For instructions for creating a search criteria, see Table 4-7 in this chapter update option that determines how often SPECTRUM conducts a search to update the collection 4. Click OK (in the Edit collection dialog box) to dismiss the dialog box and save the changes made to this collection. Or, click Cancel, to dismiss the dialog box without saving the changes made. Procedure: Remove static members from existing collection Follow these steps to remove static members in an existing collection: 1. In the Global Collections navigation tree, right-click a static member (modeled element) within a collection folder and select Cut. SPECTRUM OneClick displays a dialog box confirming that you want to proceed with the deletion. Click Yes to continue or click No to cancel the operation. When you click Yes, the cut operation will remove the element from the collection but it will not destroy the modeled element. If the modeled element exists in other topologies it will continue to exist in those topologies. If the modeled element does not exist in any other topology it will be placed in the Lost and Found and later destroyed. Note: If you attempt to remove a dynamic member from a collection, an error message appears informing you that the selected member was added via a search criteria. To remove the dynamic member you must redefine the search criteria. Creating a Global Collection Hierarchy for reporting If you intend to use the Report Manager module to generate single reports about multiple global collections, you must set-up the OneClick navigation panel with a Global Collection Hierarchy. In this Global Collection Hierarchy, you can create multiple levels of folders to represent previously defined global collections. To learn how to set-up a Global Collection Hierarchy, see the following procedure. 76 Modeling Your IT Infrastructure Administrator Guide

83 Manually modeling in the World topology To learn how to generate reports on multiple collections, see the Report Manager User Guide. For examples and additional information on generating reports about collections, see Generating reports on collections on page 69 Procedure: Create a Collection Hierarchy 1. In the Explorer tab of the OneClick navigation panel, right-click Global Collections Hierarchy node and select New Folder. The New Folder dialog box appears. 2. In the New Folder dialog box, enter a descriptive folder name. The folder appears in the Global Collection Hierarchy tree. 3. In the Global Collection hierarchy tree, perform any of the following tasks: Build additional top-level folders. Repeat Steps 1 and 2. Build one or more sub-folders. To create a sub-folder, right-click a top-level folder and select New Folder. Populate folder at any level. To populate a folder with one or more collections, follow these steps: a. Right-click the folder and select Add Collection. The Add Collections dialog box appears. b. In the Add Collection dialog box, select the name of the collection you want to add and click OK. Note: The Add Collection dialog box represents the list of collections previously created in the Global Collection topology. For more information about creating collections, see Defining a new collection on page 70. Manually modeling in the World topology Anytime you want to represent your network geographically you can do so by creating a World topology view. In a World topology view, you can model several layers of container views depicting your network locations. For example, you may want to create container views of your network infrastructure from a national or regional level all the way down to an individual room containing network equipment. Recommended process for modeling locations When modeling multiple containers representing locations within your network infrastructure, consider following this process: Step 1: Create top-level location views. From the World topology node, you can begin depicting the top-level view of any network location by modeling one of the following top-level containers: Building Country Site Region Modeling Your IT Infrastructure Administrator Guide 77

84 Chapter 4: Manual Modeling Step2: Create one or more sub-level location views. Depending on the top-level container modeled, you can then depict one or more sub-level containers. For example, see Table Table 4-10: Top level and sub-level containers If the top-level container is a: Building Site Region Country You can model one any of these subcontainers: Floors, *Rooms Sections Building Building or site Region, building, or site. Step 3: Populate a room container view with modeled devices. After you have created a room container view, you can populate that view with modeled devices. The following procedures define how to create a top-level and sub-level location view, as well as, how to populate a room container view with modeled devices. Procedure: Defining top-level or sub-level location view Follow these steps to create a top-level location view: 1. In the Explorer tab of the OneClick navigation panel, do one of the following: To define a top-level location view. Click the World topology node to display the World topology view in the Topology tab of the Contents panel. To define a sub-level location view. Click one of the top-level view folders appearing under the World topology node. The World topology view for that folder appears in the Topology tab of the Contents panel. 2. In the Topology tab toolbar area, click the Create a new Model by Type. The Select Model Type dialog appears. 3. In the Container tab of the Select Model Type dialog box, select a container type that best describes the network location you are depicting then click OK. The Create Model of Type dialog box appears. 4. In the Create Model of Type dialog box, do the following: a. In the Name text box, specify a name that best describes the network location. b. If you want to secure this view from certain users, specify a security string in the Security String text box. For more information about securing views, see Granting or denying access to modeled elements on page 23. c. Click OK. The following occurs: The named icon container appears in the top-level (or sub-level) view of the World topology. The named folder representing the container appears in the navigation panel under the World topology node. 78 Modeling Your IT Infrastructure Administrator Guide

85 Manually modeling the TopOrg topology Tip: To move the container icon or annotate this view further, click the Edit mode button in the toolbar area of the World topology view. For more information about using the Editor features, see Chapter 5, Enhancing Topology Views and Editing Model Device Attributes, on page 83. Procedure: Populate a room container view with modeled devices Follow these steps to populate a room container view with modeled devices: 1. In a Universe topology view, copy the modeled devices that you want to appear in a World topology view. 2. In the World topology view, navigate to a room container type view. 3. In the room container-type view, paste the modeled devices. Tips: The best practice is to always model devices in the Universe topology view; then, copy and paste these devices to the World topology view. Alternatively, you can use the Create Model by IP or Create Model by Type option to manually model devices in a World topology view. Importantly, however, we do not recommend this alternative approach since the Universe topology views represent the connectivity views of your network. If you determine you want to model new devices directly in the World topology, you can choose to use either the Create Model by IP option or Create Model by Type option. For instructions on using these options, see Procedure: Add device using Create model by model type on page 60 and Procedure: Add device using Create model by IP address on page 59. To move the container icon or annotate the view, click the Edit mode button in the toolbar area of the World topology view. For more information about editing a topology view, see Chapter 5. Manually modeling the TopOrg topology You can manually model your network in the TopOrg topology anytime you want to organize infrastructure models by organizational units or by services. For example, you can create a TopOrg topology view depicting devices that are essential for supporting a network service such as service. You could also depict services by department or individual responsibility. The best practice for populating a TopOrg topology view is to always copy the modeled elements from a Universe topology view and paste them in a TopOrg topology view. Alternatively, you can use the Create Model by IP or Create Model by Type option to manually model devices in a TopOrg topology view. Importantly, however, we do not recommend this alternative approach since the Universe topology views represent the connectivity views of your network. Modeling services within the TopOrg topology Within the TopOrg topology it is possible to create multiple levels of containers representing organizations or individuals responsible for tracking the performance of mission critical services in your IT infrastructure. Modeling Your IT Infrastructure Administrator Guide 79

86 Chapter 4: Manual Modeling When modeling multiple organizational containers in the TopOrg topology, consider following this process: Step 1: Create one or more layers of ownership/responsibility. Using the Model by Type dialog box, depict one or more containers representing a department, individual, customer, or enterprise that is supported by a network service or that is responsible for tracking the performance of a network service. Step 2: Populate service_owns container with supporting devices. Populate the service_owns type containers with the modeled devices supporting the network service. You can populate these containers by copying/pasting modeled devices from the Universe topology to the TopOrg topology, or by defining new devices using the Create Model by IP Address dialog box. The following procedures describe how to create organizational and service owns containers as well as how to populate a service_owns type container with modeled devices. Procedure: Defining organizational and service_owns containers Follow these steps to define service related organizational views in the TopOrg topology: 1. In the Explorer tab of the OneClick navigation panel, click the TopOrg topology node to display the TopOrg topology view in the Topology tab of the Contents panel. 2. In the Topology tab toolbar area, click the Create Model by Type. The Select Model Type dialog box appears. 3. Within the Containers tab of the Select Model Type dialog box, select a container type that best describes the organization you are depicting then click OK. The Create Model of Type dialog box appears. 4. In the Create Model of Type dialog box, do the following: a. In the Name text box, specify a name that best describes the organization that is responsible for tracking the performance of the network services or is supported by these services. b. If you want to secure this view from certain users, you can specify a security string in the Security String text box. For more information about securing views, see Granting or denying access to modeled elements on page 23. c. Click OK. The following occurs: - The named container icon appears in the top-level view of the TopOrg topology. - The named folder representing the container appears in the navigation panel under the TopOrg topology node. Tip: To move the container icon or annotate this view further, click the Edit mode button in the toolbar area of the World topology view. For more information about using the editing features, see Chapter Repeat Steps 2 through 4 for each organizational or service_own container you want to depict in the TopOrg topology. Procedure: Populating service-own type containers Follow these steps to populate service_owns type containers with modeled devices in the TopOrg topology: 80 Modeling Your IT Infrastructure Administrator Guide

87 1. In a Universe topology view, copy the modeled devices that you want to appear in a TopOrg topology view. 2. In the TopOrg topology view, navigate to a service_owns container type view. 3. In the service_owns container type view, paste the modeled devices. Tips: The best practice is to always model devices in the Universe topology view; then, copy and paste these devices to the TopOrg topology view. Alternatively, you can use the Create Model by IP or Create Model by Type option to manually model devices in a TopOrg topology view. Importantly, however, we do not recommend this alternative approach since the Universe topology views represent the connectivity views of your network. If you determine you want to model new devices in the TopOrg topology, you can choose to use either the Create Model by IP option or Create Model by Type option. For instructions on using these options, see Procedure: Add device using Create model by model type on page 60 and Procedure: Add device using Create model by IP address on page 59. To move the container icon or annotate the view, click the Edit mode button in the toolbar area of the World topology view. For more information about editing a topology view, see Chapter 5. Modeling Your IT Infrastructure Administrator Guide 81

88 Chapter 4: Manual Modeling 82 Modeling Your IT Infrastructure Administrator Guide

89 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes This chapter describes how you can enhance OneClick topology views by using the tools provided in the Edit mode toolbar. It also describes how you can edit model device attributes using OneClick s Attribute Editor and Search features. Before you begin Review the following information to ensure you meet the prerequisites of this chapter and to familiarize yourself with the editing options described in this chapter. Prerequisites: You must have the appropriate user level privilege to use the editing features described in this chapter. For more information about setting user privileges, see the OneClick User Administration in the OneClick Administration Guide. You should be logged into the OneClick environment. If you are unsure how to access the OneClick environment, see the OneClick Console User Guide for more information. You should be familiar with the OneClick working environment (window, menu, navigation, etc.). If you are unfamiliar with these features, see the OneClick Console User Guide for more information. Enhancing and editing fundamentals and tasks After reading this chapter, you will fully understand how you can enhance OneClick topology views using the Edit mode features as well as how to modify device attributes using the Attribute Editor features. This chapter defines the Edit mode and Attribute Editor features in the following sections: Enhancing topology views using Edit mode on page 85 Editing device attributes using the Attribute Editor on page 93 83

90 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Commonly-used terms The following table identifies commonly-used terms for performing the editing tasks described in this chapter. Table 5-1: Commonly-used editing terms Edit mode Drawing tools Search Attribute Editor Device attributes Edit mode refers to the condition you place a view in when you want to edit its appearance. When you place a view into edit mode, you automatically prevent other users from editing that view. Drawing tools refer to the Edit mode options you can use to draw lines, rectangles, ellipses, or text boxes. After you create these items in a view, you can later apply styles or colors to them. Search refers to the search features available in the Locator tab of the OneClick navigation panel. Attribute Editor enables you to change attributes configured at the device level. Device attributes refer to the configuration settings written to a device or interface. 84 Modeling Your IT Infrastructure Administrator Guide

91 Enhancing topology views using Edit mode Enhancing topology views using Edit mode Through the Edit mode feature in the OneClick environment, you can enhance any topology view by changing the background characteristics of a view; adding lines, rectangles, or ellipses to a view; editing the placement of modeled elements in a view; or simply changing the font characteristics in a view. Figure 5-1 illustrates the appearance of an enhanced topology view. Figure 5-1: Enhanced topology view Background image Shape Annotations Text Annotation Multi-user considerations Note that all enhancements to OneClick topology views are shared across all users. Also, when you edit a view using the Edit mode button in a Topology tab toolbar area, SPECTRUM automatically prevents all other users from editing that view. The following sections describe how you can access and use the Edit mode features within the OneClick environment: Accessing the Edit mode feature on page 86 Editing tools available from the Edit mode toolbar on page 87 Performing editing tasks to enhance a view on page 88 Modeling Your IT Infrastructure Administrator Guide 85

92 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Accessing the Edit mode feature You can access the Edit mode toolbar by clicking the Edit mode option button in the Topology tab toolbar. Topology tab toolbar Edit mode option - locks current topology view for edit. When you click the OneClick Edit mode option the following occurs: The current topology view automatically locks for edit, thereby preventing all other users from editing this view. The Edit mode toolbar appears providing you access to all the editing tools necessary to enhance the appearance of a topology view. The Save option unlocks all views for edit. Edit mode toolbar Additionally, after you have placed a view into Edit mode, the Edit mode option within the Topology toolbar is replaced with a Save option. The Save option enables you to exit Edit mode (unlock views for edit) and to save all editing changes made to the current view. Note: Any user that does not have user privileges to edit a topology view will not have access the Edit mode toolbar options. 86 Modeling Your IT Infrastructure Administrator Guide

93 Enhancing topology views using Edit mode Editing tools available from the Edit mode toolbar The following table describes the editing tools that you can access and use from the Edit mode toolbar. Table 5-2: OneClick s Annotation Toolbar Editing tool Name Description Front properties Opens the Select Font dialog box for the selected text annotation. Choose a font family, style, and size from the respective columns in the Select Font dialog box. You can also choose the text foreground and background color and whether or not to show the text background (this is disabled by default). Shape color Opens the Select Shape Color dialog box for the selected annotation. Select a shape color in the Select Color dialog box. Line weight Sets the line weight for lines, ellipses, and rectangles. Line style Sets the style for lines, ellipses, and rectangles. Group and Ungroup Selection Groups and ungroups selected modeled elements in a view. Rectangle tool, Ellipse tool, and Line tool Text Box Draws rectangles, ellipses, and Lines, respectively. Tip. Click and hold the rectangle or ellipse toolbar button for additional tools for each shape. Creates a text box where you can enter text. Topology Background Changes topology background characteristics (color, image, and size). Modeling Your IT Infrastructure Administrator Guide 87

94 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Performing editing tasks to enhance a view The following sections describe how to perform various editing tasks in OneClick topology views: Adding shapes, lines, or text to a view on page 88 Changing shapes, lines, and text characteristics on page 89 Enhancing a topology background characteristics on page 90 Grouping and ungrouping items in a view on page 92 Bringing items to front or sending items to back on page 92 Prerequisite: Note that the following procedures assume the topology view has been placed in Edit mode. Adding shapes, lines, or text to a view Use the following procedures to add a rectangle, ellipse, line, or text to a topology view. Procedure: Adding a rectangle or ellipse Follow these steps to add a rectangle or an ellipse to a topology view. 1. In the Edit mode toolbar, click and hold the Rectangle or Ellipse button until a menu appears, then select the desired style for the shape. See Figure 5-2. Figure 5-2: Rectangle/Ellipse Style Menus The respective toolbar icon displays the selected style. The pointer changes from an arrow to a crosshair when hovering over the background area of the topology view. See Figure Modeling Your IT Infrastructure Administrator Guide

95 Enhancing topology views using Edit mode Figure 5-3: Drawing a Rectangle Annotation 2. In the topology view, click and drag the pointer from where you want the upper left corner of the shape to begin to where you want the lower right-hand corner of the shape to end (Figure 5-3). 3. Release the mouse button and the shape appears in the view, behind any models or pipes. Procedure: Adding a line to a view 1. In the Edit mode toolbar, click on the Line button. The pointer changes from an arrow to a crosshair in the background area of the topology view (but on top of any other shapes or text that already exists). 2. In the topology view, click and drag the pointer from where you want the line to begin until where you would like the line to end. 3. Release the mouse button and the line appears in the view, behind any models or pipes. Procedure: Adding a text (text box) to a view 1. In the Edit mode toolbar, click the Text button. The pointer changes from an arrow to a crosshair pointer. 2. In the topology view, click where you want the text box to begin. A text box appears. 3. In the text box, type the desired text. 4. To exit the text box, click outside the text box. The text boundaries of the text box disappear and the text is placed in the background of the topology view. Changing shapes, lines, and text characteristics The following procedures describe how you can apply different font properties to text, colors to shapes, or line weights to lines. Tip: The best practice for setting properties for shapes, lines or text, is to do so before adding (or drawing) these elements in a view. Procedure: Changing text font properties Follow these steps to change the font properties of user-specified text. 1. In the topology view, click the text you want to change then click the Font Properties button in the Edit mode toolbar. The Select Font dialog box appears. Modeling Your IT Infrastructure Administrator Guide 89

96 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes 2. In the Select Font dialog box, select the desired font family, style, size, foreground color, and background color. Tip: The preview pane at the bottom of the dialog box changes to reflect the font properties selected. 3. Click OK (in the Select Font dialog box) to set the font properties for the text you selected in Step 1. Procedure: Applying color to shapes or lines Follow these steps to change the color of a selected shape or line. 1. In the topology view, click the shape or line that you want to edit then click the Shape Color button in the Edit mode toolbar. The Select Color dialog box appears. 2. In the Select Color dialog box, click the Swatches tab. Select a desired color from the color palette then click OK to apply the color to the shape selected in Step 1. Tips: In the Swatches tab, you can preview the colors chosen from the color palette in the Preview pane. If you selected and previewed multiple colors, the colors you have chosen appear in the Recent color grid for easy re-selection. Click the RGB tab to customize a standard color chosen on the Swatches tab. On the RGB tab you can customize a standard color by adding more or less red, green, blue colors. Click the HSB tab to customize the Hue, Saturation, and Brightness settings associated with standard color chosen on the Swatches tab. On the HSB tab, you can use the slider control to increase or decrease the settings associated with Red, Green, and Blue colors. Or, you can individually change the color settings associated with the Hue, Saturation, and Brightness. Note that when you change the color settings in the HSB tab, the color settings in the RGB tab are updated respectively. Procedure: Applying line weights to lines Follow these steps to change the line style of a selected line. 1. In the topology view, click the line that you want to edit then click the Line Weight button in the Edit mode toolbar. A line weight menu appears. 2. In the line weight menu, click the line weight desired. The selected line weight is applied to the line. Enhancing a topology background characteristics You can change a topology s background color, add a background image, or change the size of the background by using the Topology Background option on the Edit mode toolbar. Procedure: Changing a view s background characteristics Use these steps to change the background characteristics of a topology view: 1. In the Edit mode toolbar, click the Topology Background button. The Background Editor dialog box appears. 90 Modeling Your IT Infrastructure Administrator Guide

97 Enhancing topology views using Edit mode Figure 5-4: Background Editor Topology Background option in Edit mode SPECTRUM OneClick supports multiple type of images you can display in the background (buildings, equipment racks, countries, etc.) All images available in the Background Editor dialog box support a PNG image format. 2. In the Background Editor dialog box, perform any of the tasks described in following table: Task Change the background type (color or image) Change background size Instructions 1. In the Background Type box specify whether you want to change the color or image. 2. Click the Browse button to preview the color or images. The Select Color dialog box appears for color background type edit. The Select Topology Background dialog box appears for Image background edit. 3. Select the desired image or color and click OK. A preview of the selected item appears within the background editor dialog box. The selected image or color appears at the lower left edge of the preview pane. You can change the background size of the topology view to create additional room for modeling network entities. To do this, in the Background Size text box, specify a pixel value for the Width and Height of the topology panel. 3. Click OK (in the Background Editor dialog box) to apply the changes to the background or click Cancel to cancel the background edit operation. When you click OK, the background view immediately updates with the new characteristics defined. Modeling Your IT Infrastructure Administrator Guide 91

98 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Grouping and ungrouping items in a view You can group or ungroup items in any OneClick topology view. Grouping items within a view enables you to edit, move, copy/paste, or delete items as one group. Ungrouping a set of groupeditems within a view enables you to edit and move the items individually. One of the most common group-type operation you may perform within a topology view is to group text (annotations) with modeled devices. The following procedures provide step-by-step instructions for grouping and ungrouping items in a view. Procedure: Grouping items in a view Follow these steps to group one or more selected items in a view: 1. In a topology view, hold down the shift key and select the items you want to represent as a group. 2. In the Edit mode toolbar, click the Group button to represent the selected items in the view as a single group. Procedure: Ungrouping grouped-items in a view Follow these steps to ungroup a set of grouped-items in a view: 1. In the topology view, click any one of the grouped-items to select the entire group. 2. In the Edit mode toolbar, click the Ungroup button to ungroup the items in the group. Bringing items to front or sending items to back You can send items to the back of a view or bring items to the front of a view relative to other items within that view. Procedure: Bring item to front or send item to back Follow these steps to bring an item to the front of a view or to send an item to the back of a view: 1. In the topology view, right-click the item and select one of the following: Bring to Front. This option moves the item to the front of the view relative to other items in the view. Send to Back. This option moves the item to the back of the view relative to other items in the view. 92 Modeling Your IT Infrastructure Administrator Guide

99 Editing device attributes using the Attribute Editor Editing device attributes using the Attribute Editor The Attribute Editor is an advanced tool within SPECTRUM OneClick. Primary use of the Attribute Editor is to configure management policies that govern how SPECTRUM manages network devices and their interfaces. When using the Attribute Editor feature, you can change attribute value(s) for one or more selected modeled devices (or interfaces) in a view. The Attribute Editor dialog box groups device attributes into ten (10) categories. You can choose to edit the default settings provided within nine of these categories or define additional device attributes to edit within the tenth (10th) category known as the User-Defined attributes. Figure 5-5: Attribute Editor dialog box 10 categories of device attributes you can edit. The following sections describes how to access the Attribute Editor, work in the Attribute Editor dialog box, and how to use Attribute Editor with the Search feature that is offered in the Locator tab of OneClick navigation panel. Modeling Your IT Infrastructure Administrator Guide 93

100 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Accessing the Attribute Editor You can access the Attribute Editor feature in the OneClick environment by right-clicking a modeled device and selecting Utilities -> Attribute Editor. Figure 5-6: Attribute Editor from right-mouse menu Alternatively, you can access the Attribute Editor from any of the following areas in the OneClick environment: List tab in Contents panel, Explorer tab navigation panel, Interface tab in Components Details panel, or from the Tools menu. Note that the Attribute Editor opens to edit device attributes for the currently selected modeled device(s) or interface(s). Working in the Attribute Editor dialog box The Attribute Editor (Figure 5-7) includes a right and left panel. The left panel groups the attribute in a tree display. The right panel provides an editing area where you can edit the settings of one or more attributes previously selected from the left panel. Figure 5-7: Attribute Editor The left panel displays a list of attributes you can choose to edit. The right panel provides an editing area to edit previously selected attributes from the right panel. The Filter text box in the Attribute Editor dialog box enables you to filter the Attribute list (in the left panel) by excluding certain items in the list. For example, if you wanted to show only Cisco related device attributes in the list, you would type Cisco in the Filter text box. 94 Modeling Your IT Infrastructure Administrator Guide

101 Editing device attributes using the Attribute Editor Editing attribute values in the right panel When you edit attribute value(s) in the right panel of the Attribute Editor dialog box, you will most often see the following two options: No Change and Set as Default. No Change Set as Default About the No Change checkbox in editing panel The No Change checkbox (or radio button for toggle fields) displays to the left of most attribute input fields. If the No Change checkbox or radio button is checked, the input value, if any, is not written when you click Apply or OK. You must clear No Change checkbox for the new value to be written. About the Set as Default checkbox in editing panel The Set as Default checkbox displays to the right of most attribute input fields in the Editor panel. If you check the Set as Default checkbox when entering a value, that value is written to not only the selected model(s) but also at the model type(s) (SPECTRUM modeling catalog) when you click Apply or OK (in the Attribute Editor dialog box). About the Attribute Editor Results dialog When you click the Apply or OK button in the Attribute Editor dialog, OneClick attempts to write the values specified and then displays the results of that operation in the Attribute Edit Results dialog (Figure 5-8). Modeling Your IT Infrastructure Administrator Guide 95

102 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Figure 5-8: Attribute Edit Results dialog box Warning. Altering the default model-type value of an attribute will change the SPECTRUM modeling catalog. Any existing models that use that current default value and any models created in the future will use the new default value regardless of the type of device the model is representing. This means changing the default value could affect models that are not explicitly selected. Changes to models not explicitly selected may not take effect until after the SpectroSERVER restarts. Within the Attribute Edit Results dialog box you can review the Attribute Editor results and undo changes, if desired. The dialog box displays the results in a table format. Each item in the table represents the result of a single attribute written to a modeled device or interface. The Result column indicates whether the write operation succeeded or failed. The Old Value and New Value columns show the original value and the last written value. If the write operation failed or the previous value could not be obtained, the corresponding field will display N/A. If the write operation failed (for example, if the device did not respond), you can select the item in the table and click the Retry button after the condition has been corrected. If you want to revert back to the original value, select the item and click the Undo button. Defining user-defined attributes In the Attribute Editor dialog box, you can create a list of device attributes in the User-Defined category. After you create this list, you can regularly edit these user-defined attributes as desired. You can at any time individually remove the user-defined attributes from the User-Defined category. The following procedures describe how to create a user-defined attribute in the User- Defined category using the Attribute Selector dialog box. Procedure: Create user-defined attribute in User-Defined category Follow these steps to create a user-defined group of device attributes in the Attribute Editor dialog box. 1. In the left panel of the Attribute Editor dialog box, click the add link next to the User-Defined folder. The Attribute Selector dialog box appears. 96 Modeling Your IT Infrastructure Administrator Guide

103 Changing attributes in conjunction with Search 2. In the Attribute Selector dialog box, select a model type in the left panel then in the right panel select the device attribute (that you want to later appear within the User-Defined category) and click OK. Tips: Use the Filter text box to quickly locate an attribute or model type in the list. Remove user-defined attributes within the User-Defined category by clicking the remove link next to the attribute you want to remove. Each OneClick user can create their own unique set of user-defined attributes. Changing attributes in conjunction with Search You can use the Attribute Editor feature in conjunction with the Search feature in the Locater tab (Locator Search). By using the Locator Search feature with the Attribute Editor feature you can locate all modeled devices/interfaces meeting certain criteria and then attempt to change the attribute values on those matching modeled devices/interfaces. The following example combines creating and running a new search with changing device attributes through the Attribute Editor. This example walks you through adding user defined attributes and writing changes to the component(s) (i.e., SpectroSERVER, device(s), interface(s)) meeting the search criteria. Note. For additional information about using the Search feature in the Locator tab of the OneClick window, see the OneClick Console User Guide (5130). Example of defining a Search to create a user defined attribute for edit This example creates and runs a search to locate the GlobalConfig model type on the SpectroSERVER. It then uses the Attribute Editor to add the HibernationCommSuccessTries attribute to the User Defined category where you can readily update the value as often as you need. Note.The value for HibernationCommSuccessTries determines the number of successful attempts the SpectroSERVER must make to devices in hibernation mode before the device(s) can resume normal management communication. By default, the value of this attribute is 3. For more information about Hibernation mode, see Placing devices in Hibernation mode on page 104. Modeling Your IT Infrastructure Administrator Guide 97

104 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes Procedure: Define a Search to create a User Defined attribute for edit 1. In OneClick window, do the following to create a new search: a. In the OneClick Locater tab, click the Create a new search button to open the Create Search dialog box. b. In the Create Search dialog box, do the following: Set the Attribute drop down menu to Modeltype Name (0x10000) Set Comparison Type to Equal To In the Attribute Value field, type GlobalConfig Click Save As and name the search (for example, hibernationattempts ) and click OK. In the Create Search dialog box, click OK. 2. Run the search you created in step 1 to locate the GlobalConfig model type on the SpectroSERVER by performing these steps: a. In the Locator tab, select the Search named hibernation attempts (created in step 1 of this example) then click Launch this Search. The Select Landscape to Search dialog appears. b. In the Search Landscape to Search dialog click OK. Alternatively, in the Exists in box, you can specify which SpectroSERVER(s) you want to search. You must have at least one SpectroSERVER listed. The results of the search appears in the Results tab. GlobalConfig search result 3. Follow these steps to select the hibernationcommsuccesstries attribute for the GlobalConfig model type and add that attribute to the User-Defined Category in Attribute Editor dialog. a. In the Results tab, right-click the GlobalConfig entry and select Utilities -> Attribute Editor. The Attribute Editor dialog box appears. b. In the left panel of the Attribute Editor dialog box, click the add link next to the User- Defined folder. The Attribute Selector dialog box appears. c. In the left panel of the Attribute Selector dialog box, click the folder named Other to open. 98 Modeling Your IT Infrastructure Administrator Guide

105 Changing attributes in conjunction with Search d. In the Filter text box (below the left panel) type GlobalConfig and then select GlobalConfig entry appearing under the Other folder. e. In the Filter box under the right panel of the Attribute Selector dialog box, type HibernationCommSuccessTries. The HibernationCommSuccessTries attribute appears in the Attribute for GlobalConfig list (in right panel). f. Double-click the HibernationCommSuccessTries entry in the list to add it to the User- Defined category (appearing within the Attribute Editor dialog box): 4. In the Attribute Editor dialog box, you can edit the value associated with the user defined attribute by selecting it in the left panel and clicking the Right Arrow button to move its associated attribute fields to the right panel for editing. 2. Click the Right Arrow. 3. Edit attribute fields as desired in right panel. 1. Select the attribute in left panel. 5. In the right panel, edit the attribute value(s) as desired then click Apply to write the changes to the component. For example, if you cleared the HibernationCommSuccessTries NoChange Modeling Your IT Infrastructure Administrator Guide 99

106 Chapter 5: Enhancing Topology Views and Editing Model Device Attributes checkbox and typed 5 in the box. The Attribute Edit Results dialog appears listing the results for the change(s) made. In this example, the default value of 3 was changed to 5. Tips: You can undo the last attribute change by clicking Undo in the Attribute Edit Results dialog. If you received failed results, verify that the attribute you are trying to write is writing to the proper component (SpectroSERVER, device or interface). For instance, the attributes for the GlobalConfig model type can only be written to one or more selected SpectroSERVERs and not to individual devices or interfaces. 100 Modeling Your IT Infrastructure Administrator Guide

107 Chapter 6: Placing Devices in Maintenance or Hibernation Mode This chapter defines the SPECTRUM OneClick maintenance and hibernation mode features. Specifically it describes how you can place device models in maintenance or hibernation mode. It also discusses the effects maintenance and hibernation mode has on events and alarms. This chapter includes the following topics: About Maintenance and Hibernation mode on page 102 The difference between Maintenance and Hibernation mode on page 102 Placing devices in Maintenance mode on page 103 Placing devices in Hibernation mode on page 104 Placing interface models in maintenance or hibernation mode on page 105 Recognizing model devices in maintenance or hibernation mode on page 106 Showing brown alarms for interfaces and applications on page 106 Suppressing events and alarms for devices in maintenance or hibernation on page 107 Hide or show secondary alarms for devices in maintenance mode on page 107 Before you begin Review the following information to ensure you meet the prerequisites of this chapter and to familiarize yourself with the editing options described in this chapter. Prerequisites: You should be logged into the OneClick environment. If you are unsure how to access the OneClick environment, see the OneClick Console User Guide for more information. You should be familiar with the OneClick working environment (window, menu, navigation, etc.). If you are unfamiliar with these features, see the OneClick Console User Guide for more information. 101

108 Chapter 6: Placing Devices in Maintenance or Hibernation Mode About Maintenance and Hibernation mode The Maintenance and Hibernation mode features in OneClick enable you to suspend management traffic to a modeled device and its components. After placing a modeled device into maintenance or hibernation mode, the SpectroSERVER continues to receive and process all SNMP traps for the that device, however, it will not generate any events or alarms for the device or its components while the device is in maintenance or hibernation mode. The difference between Maintenance and Hibernation mode The only difference between maintenance and hibernation mode is that maintenance mode requires you to disable the maintenance mode option on the modeled device before the device can resume normal management traffic. Hibernation mode automatically resumes normal management traffic as soon as the SpectroSERVER determines it can successfully communicate with the device after a set of successful polls are met. Which mode takes precedence Hibernation mode takes precedence over maintenance mode on a device model, however if the device model has interface models in maintenance mode they remain in maintenance mode after the hibernation device model resumes normal management communication. Where to go for more information To learn more about how to place a device in maintenance mode, see Placing devices in Maintenance mode on page 103. To learn more about how to place a modeled device in hibernation mode, as well as, how to configure the predefined number of successful attempts that must be met prior to the device resuming normal management traffic, see Placing devices in Hibernation mode on page 104. To learn more about how SPECTRUM suppresses events for a device and its components in hibernation or maintenance mode, see Suppressing events and alarms for devices in maintenance or hibernation on page Modeling Your IT Infrastructure Administrator Guide

109 Placing devices in Maintenance mode Placing devices in Maintenance mode In the Component Detail panel of a modeled device, setting the In Maintenance option to YES places a device model into maintenance mode, suspending management traffic to the device and its components and preventing the generation of any events or alarms on their behalf. Note that when you place a device into maintenance mode, its icon displays a device condition color of brown. You can schedule maintenance mode for a particular device model by clicking Schedule. Maintenance Mode setting Schedule button Modeling Your IT Infrastructure Administrator Guide 103

110 Chapter 6: Placing Devices in Maintenance or Hibernation Mode Placing devices in Hibernation mode In the Component Detail panel for a modeled device (Figure 6-1), setting the In Hibernation option to YES places the device model into hibernation mode, suspending management traffic to the device and its components until a predefined number of successful communication attempts with the device succeeds. After the predefined number of communication attempts to the device succeeds the device model automatically resumes normal management communication. To change the number of communication attempts The default number of successful communication attempts is 3 with the polling interval time (default 60 seconds) between each attempt. Optionally, you can change the default number of successful communication attempts that the SpectroSERVER makes to devices in hibernation mode by using the SPECTRUM Command Line Interface (CLI) or Attribute Editor in OneClick: To change the number of communication attempts, update the GlobalConfig mtype 0x ; attribute HibernationCommSuccessTries 0x12acb that is initially set to the default value of 3. For more information about using the SPECTRUM CLI to change model attributes, see the section entitled Modifying a Model Attribute in the Command Line Interface Guide (0664). For more information about changing the default number of successful communication attempts using the Attribute Editor in OneClick, see Changing attributes in conjunction with Search on page 97.M Figure 6-1: Hibernation mode setting Hibernation Mode setting 104 Modeling Your IT Infrastructure Administrator Guide

111 Placing interface models in maintenance or hibernation mode Placing interface models in maintenance or hibernation mode In the Component Detail panel of a device interface, setting the In Maintenance (or In Hibernation) to YES places the interface model into maintenance mode (or hibernation mode), suspending management of the interface, while still performing regular management on the rest of the device. When in maintenance or hibernation mode the following conditions are true for the interface model: Brown alarms are shown for interfaces in hibernation mode. Alarms will not be created for the port. Events are logged for the port. No polling, logging, or other device communication will be done on behalf of the port model until the interface resumes normal management. Link down traps sent are ignored and no alarms are generated. If the option Live Pipes is enabled for a connection and one of its end points is in hibernation mode, the color of the pipe in the topology view turns brown. Status polling for that port is discontinued. If a connection is modeled with a WA_Link model connection to two ports, and one of those ports is in Hibernation mode (or Maintenance mode), an alarm is created on the WA_Link and WA_Segment models. The WA_Link icon in the OneClick topology views turns brown. If Live Pipes are enabled on this link, the pipe remains green as long one port is up. If the second port goes down or becomes unreachable, the pipe condition color turns gray. If SPECTRUM loses contact with a device model connected to the port in hibernation mode (or maintenance mode), the Device Has Stopped Responding to Polls alarm will be suppressed for that device as well as all adjacent devices. If device contact lost alarms are suppressed because of their position relative to a port in hibernation (or maintenance) mode, the hibernation (or maintenance) mode alarm reflects these lost devices in its Impact and Severity attributes. These lost devices will be viewable in the Impact tab of the Alarm Detail panel for that maintenance alarm. Modeling Your IT Infrastructure Administrator Guide 105

112 Chapter 6: Placing Devices in Maintenance or Hibernation Mode Recognizing model devices in maintenance or hibernation mode Placing a device model into maintenance or hibernation mode will, by default, also place its interface models and application models into maintenance or hibernation mode. After placing a modeled device in maintenance or hibernation mode, its icon in the OneClick topology views display a device condition color of brown. Brown alarms are shown for all device models in maintenance or hibernation mode but they are not shown on the application and interface models that have inherited the maintenance or hibernation mode from device model. Showing brown alarms for interfaces and applications You can, optionally, display brown alarms for interfaces and applications that have inherited maintenance or hibernation mode from the device model by using the SPECTRUM Command Line Interface (CLI): 1. To generate brown alarms on interface models that have inherited maintenance mode, set the device model attribute 0x00012a7a (rolldownalarmtoif) to TRUE. 2. To generate brown alarms on application models that have inherited maintenance mode, set the device model attribute 0x00012a7b (rolldownalarmtoapp) to TRUE. For more information about using CLI, see the Command Line Interface (0664) Guide. 106 Modeling Your IT Infrastructure Administrator Guide

113 Suppressing events and alarms for devices in maintenance or hibernation Suppressing events and alarms for devices in maintenance or hibernation When a model is in maintenance or hibernation mode, no events are processed for that model. That includes events that would normally clear an alarm on the model, as well as events that would create an alarm. For example: If a link_down event generated an alarm on a device model prior to the model being placed in maintenance mode and a link_up event occurred while the device model is in maintenance mode, the SpectroSERVER will not clear the alarm since the link_up event would not be processed. In this example, the SpectroSERVER would not resume normal management traffic to the maintenance modeled device until you manually disable the maintenance mode option for this device in the OneClick Component Detail panel. For more information about placing devices in maintenance mode, see Placing devices in Maintenance mode on page 103. If in this example, the modeled device was placed in hibernation mode (instead of maintenance mode), the SpectroSERVER would have to make a set of successful communication attempts (default is 3) to the device before it could resume normal management traffic with the device. For more information about placing devices in hibernation mode, see Placing devices in Hibernation mode on page 104. Hide or show secondary alarms for devices in maintenance mode You can configure SPECTRUM to hide or show secondary alarms when a device is in Maintenance mode. This is done using the parameter Show Secondary Alarms When Device is in Maintenance available in the Set Preferences dialog box (Figure 6-2). If this parameter is enabled, secondary alarms are shown when a device is in maintenance mode. If the show secondary alarm option is disabled (the default), secondary alarms are hidden when a device is in maintenance mode and are shown later when the device is taken out of maintenance mode. Note that the Show secondary when in maintenance setting only applies when the primary and secondary alarms are enabled in the Alarm Filter settings in the Set Preference dialog (Figure 6-2). For more information about setting user preferences in OneClick, see the OneClick Console Guide. Important. You cannot hide or show secondary alarms for devices in hibernation mode. Modeling Your IT Infrastructure Administrator Guide 107

114 Chapter 6: Placing Devices in Maintenance or Hibernation Mode Figure 6-2: Alarm settings in Set Preference dialog Setting to show secondary alarms Clicking the Set Alarm Filter button enables you to set primary and secondary alarm states. 108 Modeling Your IT Infrastructure Administrator Guide