Enterasys Networks reserves the right to make changes in specifications and other information contained in this
document without prior notice. The reader should in all cases consult Enterasys Networks to determine whether
any such changes have been made.
The hardware, firmware, or software described in this manual is subject to change without notice.
IN NO EVENT SHALL ENERASYS NETWORKS 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 ENERASYS NETWORKS HAS BEEN ADVISED OF, KNOWN, OR
SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES.
IN NO EVENT WILL ENTERASYS NETWORKS BE LIABLE FOR ANY DAMAGES WHATSOEVER,
INCLUDING SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THE WEB LOG VIEW, WHETHER IN AN
ACTION OF CONTRACT OR TORT INCLUDING NEGLIGENCE.
Virus Disclaimer
Enterasys Networks has tested its software with current virus checking technologies. However, because no antivirus system is 100% reliable, we strongly caution you to write protect and then verify that the Licensed
Software, prior to installing it, is virus-free with an anti-virus system in which you have confidence.
Enterasys Networks makes no representations or warranties to the effect that the Licensed Software is virus-free.
Copyright 2000, 2001, 2002 by Enterasys Networks. All rights reserved.
Printed in the United States of America.
Order Number: 9032722-05 August 2002
Enterasys Networks, Inc.
P.O. Box 5005
Rochester, NH 03866-5005
Enterasys, NetSight, XPedition and Matrix E7 are trademarks of Enterasys Networks.
Windows, Windows NT, Windows XP, Microsoft, Microsoft Windows, and Microsoft Windows for
Workgro ups are trademarks or registered trademarks of Microsoft Corporation.
Solaris, Sun, Sun Microsystems, are trademarks or registered trademarks of Sun Microsystems, Inc.
IRM-3, Media Interface Module, MicroMMAC, MIM, MMAC, MMAC-3, MMAC-3FNB, MMAC-5,
MMAC-5FNB, MMAC-8, MMAC-8FNB, MMAC-M8FNB, MMAC-Plus, MRX, MRXI, MRXI-24,
MultiChannel, NB20E, NB25E, NB30, NB35, NBR-220/420/620, RMIM, SecureFast Switch, SecureFast
Packet Switching, SFS, SFPS, SPECTRUM Element Manager, SPECTRUM for Open Systems, SPIM-A,
SPIM-C, SPIM-F1, SPIM-F2, SPIM-T, SPIM-T1, TPMIM, TPMIM-22, TPMIM-T1, TPRMIM,
TPRMIM-36, TPT-T, TRBMIM, TRMM-2, TRMMIM, and TRXI are trademarks of Cabletron Systems,
Inc.
AppleTalk, Apple, Macintosh, and TokenTalk are registered trademarks; and Apple Remote Access and
EtherTalk are trademarks of Apple Computer, Inc.
SmartBoost is a trademark of American Power Conversion
ST is a registered trademark and C++ is a trademark of AT&T
Banyan and VINES are registered trademarks of Banyan Systems, Inc.
cisco, ciscoSystems, and AGS+ are registered trademarks; and cBus, cisco Router, CRM, IGS, and MGS are
trademarks of cisco Systems, Inc.
GatorBox is a registered trademark; and GatorMail, GatorMIM, GatorPrint, GatorShare, GatorStar, GatorStar
GX-M, and XGator are trademarks of Cayman Systems, Inc.
CompuServe is a registered trademark of CompuServe Incorporated
X Window System is a trademark of Consortium, Inc.
CTERM, DECnet, and ULTRIX are registered trademarks; and DEC, DEC C++, DECnet-DOS, DECstation,
VAX DOCUMENT, VMA, and VT are trademarks of Digital Equipment Corporation
Fore Systems, ForeRunner, and ForeRunner ASX-100 are trademarks of Fore Systems, Inc.
PC/TCP is a registered trademark of FTP Software, Inc.
HP OpenView is a registered trademark of Hewlett-Packard, Inc.
AIX, IBM, OS/2, NetView, and PS/2 are registered trademarks; and AT, Micro Channel, PC, PC-DOS, PC/XT,
Personal Computer AT, Operating System/2, Personal System/2, RISC System/6000, and Workplace Shell are
trademarks of International Business Machines Corporation
i960 microprocessor is a registered trademark; and Intel and Multichannel are trademarks of Intel Corporation
Microsoft, MS-DOS, and Windows are registered trademarks of Microsoft Corporation
Chameleon, ChameleonNFS, Chameleon 32, IPX/link, and NEWT are trademarks of
NETMANAGE, Inc.
NetWare and Novell are registered trademarks; and Internetwork Packet Exchange (IPX), IPX, and Network File
System (NFS) are trademarks of Novell, Inc.
Motif and MS are registered trademarks; and Open Software Foundation, OSF, OSF/1, and OSF/Motif are
trademarks of The Open Software Foundation, Inc.
Silicon Graphics and IRIS are registered trademarks; and Indigo and IRIX are trademarks of Silicon Graphics,
Inc.
iv
NFS, PC-NFS, SPARC, Sun Microsystems, and Sun Workstation are registered trademarks; and OpenWindows,
SPARCstation, SPARCstation IPC, SPARCstation IPX, Sun, Sun-2, Sun-3, Sun-4, Sun386i, SunNet, SunOS,
SunSPARC, and SunView are trademarks of Sun Microsystems, Inc.
OPEN LOOK and UNIX are registered trademarks of Unix System Laboratories, Inc.
Ethernet, NS, Xerox Network Systems and XNS are trademarks of Xerox Corporation
ANNEX, ANNEX-II, ANNEX-IIe, ANNEX-3, ANNEX-802.5, MICRO-ANNEX-XL, and MICRO-ANNEXELS are trademarks of Xylogics, Inc.
MAXserver and Xyplex are trademarks of Xyplex, Inc.
Restricted Rights Notice
(Applicable to licenses to the United States Government only.)
1.Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)
(1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.
Enterasys Networks, 35 Industrial Way, Rochester, New Hampshire 03867-0505.
2.(a) This computer software is submitted with restricted rights. It may not be used, reproduced, or disclosed
by the Government except as provided in paragraph (b) of this Notice or as otherwise expressly stated in
the contract.
(b) This computer software may be:
(1)Used or copied for use in or with the computer or computers for which it was acquired, including
use at any Government installation to which such computer or computers may be transferred;
(2)Used or copied for use in a backup computer if any computer for which it was acquired is
inoperative;
(3)Reproduced for safekeeping (archives) or backup purposes;
(4)Modified, adapted, or combined with other computer software, provided that the modified,
combined, or adapted portions of the derivative software incorporating restricted computer
software are made subject to the same restricted rights;
(5)Disclosed to and reproduced for use by support service contractors in accordance with
subparagraphs (b) (1) through (4) of this clause, provided the Government makes such disclosure
or reproduction subject to these restricted rights; and
(6)Used or copied for use in or transferred to a replacement computer.
(c) Notwithstanding the foregoing, if this computer software is published copyrighted computer software, it
is licensed to the Government, without disclosure prohibitions, with the minimum rights set forth in
paragraph (b) of this clause.
v
(d) Any other rights or limitations regarding the use, duplication, or disclosure of this computer software are
to be expressly stated in, or incorporated in, the contract.
(e) This Notice shall be marked on any reproduction of this computer software, in whole or in part.
vi
Chapter 1Introduction
Using This Guide ............................................................................................................. 1-1
Tag/Data Format .............................................................................Appendix A-12
Executing the AddDevType Command .................................................Appendix A-12
Viewing the Log File ....................................................................................Appendix A-13
xi
Contents
xii
Introduction
Using this guide; getting help
Using This Guide
This manual contains general information regarding NetSight Element Manager,
including:
•Chapter 1, Introduction, which introduces the product, provides an outline of this
book’s structure, describes how to access and use the on-line documentation, and tells
you how to get assistance while using the product.
Chapter 1
•Chapter 2, Overview of NetSight Element Manager, provides a more in-depth look at
some of the application’s features and enhancements, and describes some general
functions of the software platform such as configuring options, backing up data files,
customizing the toolbar, and printing.
•Chapter 3, Discovering Nodes, provides details on how to use the Discover application
to discover nodes on your network. It describes how to build scripts that will discover
IP devices by address range or subnetwork range. The IP or Host Locator tool — which
resolves IP addresses to host names, and vice versa — is also described here.
•Chapter 4, List Views, covers the List View workspace and List View windows.
NetSight Element Manager stores all node information in a central database. List
Views provide you with a variety of user configurable views into that database,
including a wide selection of status and descriptive information about each node. This
chapter also provides information on manually adding nodes to the node database,
editing a node’s displayed properties and individual polling intervals, and launching
device management.
1-1
Introduction
•Chapter 5, Tree Views, describes the Tree View workspace and windows. These user-
configurable views let you display your network nodes in a hierarchical tree control
format that provides a variety of information about the features supported by the
device, including information about the interface through which NetSight Element
Manager is communicating with each node.
•Chapter 6, Creating Network Maps, provides detailed instructions on how to use the
Map View workspace, and how to create and link individual map files. You can use
maps to represent your network configuration via symbols and icons. This chapter also
describes the use of Microsoft Object Linking and Embedding (OLE) with map files.
•Chapter 7, Node Management Overview, explains several features of device
management, including an introduction to the Device View windows; creating a source
address definition file; and a brief introduction to the Microsoft PING application.
•Appendix A, Batch Customization via AddTool, AddImage, and AddDevType,
Using the AddTool, AddImage, and AddDevType tools to expand the capabilities of
NetSight Element Manager
Other manuals in your documentation set — including the device-specific User’s Guides,
Tools Guide, Remote Administration Tools User’s Guide, Alarm and Event Handling
Guide, and RMON User’s Guide — contain specific information about the various
applications included in your NetSight Element Manager platform. A set of installation
instructions, a Getting Started guide, and a README.TXT file are also provided.
Getting Help
This section describes two different methods of getting help for questions or concerns you
may have while using NetSight Element Manager.
Using On-line Help
You can use the Help buttons in the NetSight Element Manager windows to obtain
information specific to the currently active window. When you click on a Help button, a
window opens which contains information that will assist you in the use of the windows
and their associated command and menu options. If a Help button is grayed out, on-line
help has not yet been implemented for the associated window. From the Help menu
accessed from the Device View menu bar, you can access on-line Help specific to the
Device View (Help —> Chassis Manager Help or Help —> Help Topics).
1-2Getting Help
Accessing On-line Documentation
All of the online help windows use the standard Microsoft Windows help facility. If you
NOTE
TIP
are unfamiliar with this feature of Windows, you can select Help —>How to Use Help
from the primary NetSight Element Manager window.
The complete suite of documents available for NetSight Element Manager can be
accessed via a menu option from the primary window menu bar: Help —> Online Documents. If you chose to install the documentation when you installed NetSight
Element Manager, selecting this option will launch Adobe’s Acrobat Reader and a menu
file which provides links to all other available documents.
If you have not yet installed the documentation, the Online Documents option will not be
able to access the menu file. In order to activate this option, you must run the setup.exe
again to install the documentation component. See your Installation Guide for details.
Introduction
Documentation Feedback
Send your questions, comments and suggestions regarding NetSight
documentation to NetSight Technical Communications via the following email address:
Netsight_docs@enterasys.com
Getting Technical Support
Online Services on the World Wide Web
To locate product-specific information, refer to the Enterasys Web page at the
following address:
http://www.enterasys.com
Global Technical Assistance Center
If you have additional questions, contact the Global Technical Assistance
Center using one of these methods:
Telephone (24 hours a day, 365 days a year): (603) 332-9400
Fax: (603)337-3075
Electronic Mail: support@enterasys.com
Getting Help1-3
Introduction
Mailing Address:
Enterasys Networks, Inc.
Technical Support
35 Industrial Way
Rochester, NH 03867
FTP:
ftp.cabletron.com
Login: anonymous
Password: your email address
1-4Getting Help
Chapter 2
Overview of
NetSight Element Manager
Key NetSight Element Manager features; customizing the NetSight Element Manager platform;
backing up data files
NetSight Element Managerfor Windows™ provides a powerful and easy-to-use tool for
monitoring and managing Enterasys and Cabletron devices from a Microsoft Windows
workstation. Its open architecture and broad feature set also make it an attractive platform
for third party development of management applications.
in
NetSight Element Manager support on the Solaris platform is limited to the
NOTE
installation of NetSight Chassis Manager, either alone or integrated with
Hewlett Packard’s HP OpenView Network Node Manager, and only for
Solaris 2.7. See your NetSight Element Manager Installation Guide for
more information.
About NetSight Element Manager
NetSight Element Manager -- like its predecessor SPECTRUM Element Manager -- is
comprised of several independent but interrelated applications:
•The Network Status application is responsible for polling nodes in the central
database. It provides you with feedback regarding the status of devices on your
network through the central NetSight Element Manager user interface via the List
Views, Tree Views, and Maps. Node status is propagated right up through these views
and onto your desktop via NetSight Element Manager’s minimized icon. Key features
of this user interface are highlighted in the Management and Monitoring
Workspace, beginning on page 2-5.
•The Event Manager application is responsible for alarm and event management. It
receives traps from network nodes and events from other NetSight Element Manager
processes, maintains the Log Views in which you view received events, and carries out
2-1
Overview of NetSight Element Manager
any actions that you have configured on reception of a particular trap or event. Alarm
and event management is highlighted in Alarm and Event Handling, beginning on
page 2-11.
•The Scheduler tool allows you to schedule unattended data back-ups and network
discovery sessions that will launch automatically at a scheduled time and date. With
the Scheduler, you can also configure and activate groups of “pager calendars” so that
network technicians can be automatically paged in response to network alarms or
events. The Scheduler is highlighted in Scheduler Tool, beginning on page 2-12.
•The Remote Administration Tools suite let you easily perform management tasks
(such as TFTP downloads, trap table configuration, or setting up MIB statistics polling
or MIB downloads) on an individual device or groups of devices. A MAC Address
Locator Tool also allows you to search one or more devices for the port through which
a selected MAC address is communicating. The Remote Administration Tools
section, page 2-12, briefly describes this powerful tool suite.
Among its features are:
•A primary window where you can navigate between the Map View, List View, Tree
View, and Log View workspaces to activate windows to monitor and manage your
network (such as Map windows and alarm Log View windows). A central menu bar
provides access to most management options.
•A graphical interface that lets you sort, rearrange, and resize column displays, select
icons for nodes in Map View, List View, and Tree View displays, and customize the
toolbar.
•Full-featured on-line assistance, including Wizards for common tasks,
context-sensitive help with a glossary and index, and a status bar with hint text. The
on-line documentation set is also launchable from the NetSight Element Manager
primary window.
•A dockable Workspace area which you can use to access and organize your List View,
Map View, Tree View, and Log View windows (as shown in Figure 2-1). You can
create folders within a view hierarchy to further nest the contents of your view
windows.
•Toolbars which can be docked to the primary NetSight Element Manager window, or
undocked as floating tool palettes (as shown in Figure 2-1). Toolbars are automatically
activated when a related view is active; you can also choose which toolbars you want
to display via the View—>Toolbars menu option.
2-2About NetSight Element Manager
Toolbars can be undocked to become floating
tool palettes (either inside or outside the main
window) or be docked to a different place.
The Workspace can
also be undocked,
and placed either
inside or outside the
main window.
Overview of NetSight Element Manager
Views can be minimized,
but must remain in the
main window area.
Hint text displays here
when you move the cursor
over any toolbar button.
Figure 2-1. The Primary NetSight Element Manager Window,
with Docked and Undocked Workspace and Toolbars
•Drag-and-drop functionality for copy or link operations, so that it’s easy to transfer
data from one management window to the next within the same application (e.g., from
a List View to a Map View), or between applications (e.g., from a NetSight Element
Manager List View to a device group in Remote Administration Tools).
Icons representing various services are displayed
here when those services are active: node polling
service, Scheduler (not shown), alarm and event
service, and discover. Text displays also indicate
key positions, which can affect navigation.
About NetSight Element Manager2-3
Overview of NetSight Element Manager
•Right-mouse button functionality for quick access to commonly-used menu
commands (as shown in Figure 2-2).
Clicking the right mouse button in
NetSight Element Manager
windows or workspaces, or on
elements in those windows, will
often bring up a menu with
commonly used management
selections.
Figure 2-2. Sample Right Mouse Functionality
•Print spooling to the Microsoft Windows Print Manager for record keeping purposes.
Printable information includes maps, device lists, alarm statistics, and other statistical
information (including RMON data). The Print Preview option is available to let you
view the material as it would appear on the page before it is actually spooled to the
system printer.
•OLE functionality to embed and link data with management Map files.
The following sections provide an overview of some key NetSight Element Manager
functions.
Network Discovery
The Discover application provides several key features; among these are:
Discover Script Capability
By creating Discover scripts, you can store the parameters of a discovery from one
management session to the next, so that you can repeat a configured discovery session at
any time.
Subnet Discovery
The Discover application is capable of searching based on a subnet address, rather than
requiring that a range of IP addresses be specified (although you can enter a range if
desired). You can also configure multiple subnets or IP address ranges to be discovered
within the same script.
Scheduled Discovery
By linking Discover scripts with the Scheduler application, you can automate the Discover
application so that it will run unattended at periodic intervals.
2-4About NetSight Element Manager
Overview of NetSight Element Manager
IP or Host Locator
An additional tool linked to but run separately from the Discover application allows you to
resolve host names to IP addresses, and vice versa. You can also discover the IP addresses
and host names of all devices located on a subnet, and locate both the IP and hostname for
a device by its MAC address.
Automatic Creation of the Node Database
Your discovered nodes are automatically entered into NetSight Element Manager’s
central node database, and the Discover window remains open so that you can view the list
of discovered devices. The database is also automatically saved after each discovery.
Secondary Discover and Discover Reset
The first time you run a device discover script, all IP addresses in the subnet or address
range you have specified will be queried, and all discovered devices will be listed in the
discover window and automatically added to the central node database. This is called a
NEW Discovery. The second time you run any device discover, however — even a device
script which has not yet been run —NetSight Element Manager will perform a
SECONDARY Discover, querying only those IP addresses which did not respond to the
first discover. This process allows you to use a discover script to periodically survey a
subnet, domain, or range of IP addresses for any nodes that might have been down or
simply not present during the initial discovery, without the time and bandwidth cost of
continually re-polling for nodes which have already been successfully discovered. You
can force a return to NEW Discovery mode by clicking the Reset button in the Discover
Manager window; deleting any node from the central database will also reset the device
script counters to NEW Discovery mode.
Discover Wizard
A Wizard is provided to walk you through each step of configuring and performing a
discovery.
The Discover application is covered in Chapter 3, Discovering Nodes.
Management and Monitoring Workspace
NetSight Element Manager provides four work areas that allow you to choose how to
view information about the devices in your central node database: the List View, Tree
View, Map View, and Log View. Each provides a slightly different (and
user-configurable) look at the central node database, each comes with default views to get
you started, and each provides you with the ability to create one or more views specifically
designed to display the node information you need to successfully manage your network.
The following sections highlight each of these workspaces, and provide sample
illustrations of the workspaces and the windows available from them.
About NetSight Element Manager2-5
Overview of NetSight Element Manager
List Views
The List View workspace allows you to view and create specialized lists of the devices in
your central node database. A default set of views is provided for you; you can also create
your own views, selecting both the nodes and the information about each node you wish to
display. Figure 2-3 illustrates a sample List View workspace and an associated List View
window.
Figure 2-3. Sample List View Workspace and Window
List View features include:
Multiple List Views
You can create multiple List Views to view portions of your node database. The read-only
All Nodes List View displays every viewable node in your database, and a set of
pre-defined List Views displays various subsets of that database; you can customize this
feature by editing a pre-defined view and/or creating an entirely new one to display node
information in the way that works best for you. Each List View also provides an Excluded
Nodes feature, which allows you to remove one or more nodes from a view without
removing them from the database or changing the parameters of the view’s filter.
2-6About NetSight Element Manager
Overview of NetSight Element Manager
The List View Workspace
Individual List Views are represented as icons within the List View workspace; these
icons are arranged in a standard tree hierarchy (using a standard Microsoft Windows tree
view control). Double-clicking on a List View icon within the tree opens its associated
List View window.
The List View workspace also provides organizational structure to your List Views. The
tree starts at the top-level All Nodes List View, and branches into more specifically
defined List Views. You can also nest List View icons within folders to further stratify the
tree hierarchy.
Detailed Node Information
NetSight Element Manager can display the following information for each node: Status,
Model, Name, Label (descriptive alias), Logical (IP or IPX) Address, Physical (MAC)
Address, Time of Last Contact, System Up Time, Status Group (DLM – Distributed LAN
Management – information), Classes (functional class supported by the node, e.g., router,
switch, ATM, etc.), Enterprise (vendor), Topologies supported by the node (e.g., token
ring, FDDI, Ethernet, etc.), and Events (whether a trap or event concerning the node has
been detected). You can create List Views which select nodes to be displayed based on
one or more of these parameters, including subnet, enterprise, class, topology, and status
group.
Tree Views
Customizable Node Properties
Each node icon has its own Properties window, which you can use to provide additional
descriptive notes for reference, assign a label, change the community name and the
interval/retry parameters to be used for polling, and choose icons to represent the node’s
topology, model, and enterprise.
The Tree View workspace provides access to and allows you to configure a different look
at the nodes in your database: the Tree Views. Tree Views display summary information
about nodes and their interfaces within a tree hierarchy (using a standard Microsoft
Windows tree view control). Figure 2-4 illustrates a sample Tree View workspace and an
associated Tree View window.
About NetSight Element Manager2-7
Overview of NetSight Element Manager
Figure 2-4. Sample Tree View Workspace and Associated Tree View Window
Each node icon in a Tree View window is presented at the top layer in the tree hierarchy.
By expanding the display of each node icon, you can view progressively more detailed
information about the node (such as polling status, name, IP address, DLM status
information, model type, and enterprise) and the interface through which NetSight
Element Manager is communicating with the node (such as interface topology, address,
index, and polling information).
You can use a Tree View window to glean basic information about each node and its
polled interface without bringing up its management window; or, by double-clicking on a
node icon, you can open the management window for the selected node.
As with the List View windows, NetSight Element Manager provides a read-only All
Nodes Tree View which displays every node in the database; a set of predefined Tree
Views (based on classes, interfaces, and topologies) is also provided. The pre-defined
views can be edited to suit your needs, or you can create entirely new views as necessary.
Also as with List Views, an Excluded Nodes feature allows you to remove one or more
nodes from a view without removing them from the database or changing the parameters
of the view’s filter.
2-8About NetSight Element Manager
Map Views
Overview of NetSight Element Manager
Map View windows in NetSight Element Manager provide a third — and perhaps the
most flexible — means for viewing information about your network. Using maps, you can
create a visual representation of your network: grouping devices by location rather than
function, and using a variety of graphical tools (including bitmap backgrounds and drawn
objects) to represent connections and other pertinent information about the physical
structure of your network. Maps also support Microsoft’s OLE (Object Linking and
Embedding), which can be used to link or embed data created via other applications into a
map document.
NetSight Element Manager’s map feature allows you to create a three-dimensional
representation of your network by allowing you to show not only relationships between
devices, but relationships between groups of devices. Individual Map Views can be linked
to other Map Views to create a hierarchical structure which is graphically represented in
the Map View workspace, again via the Microsoft standard tree control. The overall status
of each individual map is also displayed in the workspace; for related maps, each map’s
status includes the status of any submaps with which it is associated. These status reports
are propagated up the hierarchy, whether individual maps are closed or open — giving
you a bird’s-eye view of your network status at all times.
As with the other workspaces, you can create folders in which to nest groups of Map
icons; double-clicking on a Map icon will open the associated Map window. Figure 2-5
illustrates a sample Map View workspace and an associated Map window.
Figure 2-5. Sample Map View Workspace and Map Window
About NetSight Element Manager2-9
Overview of NetSight Element Manager
Log Views
NetSight Element Manager provides a Log View workspace, which contains information
about traps and software events. Like the other workspaces, the Log View workspace —
illustrated in Figure 2-6 — allows you to create, access, and organize the Log View
windows which provide the foundation of alarm and event management. Individual Log
View windows appear as icons within the Log View tree hierarchy; you can create folders
in which to nest individual Log View icons, and double-clicking on a Log View icon will
open the associated Log View window. For more on alarm and event management, refer
to Alarm and Event Handling, page 2-11.
Figure 2-6. Sample Log Views Workspace and Associated Log View
Excluding Nodes
In addition to providing almost unlimited means for viewing the contents of the central
node database, NetSight Element Manager also provides a means for temporarily
excluding certain nodes from view — either from a specific view window, or from the
central node database itself.
When you exclude a node from a specific view, the node is placed into that view’s
individual excluded nodes list. It will no longer be visible from that view, but it remains in
the database and will be displayed in any other view as appropriate.
2-10About NetSight Element Manager
When you exclude a node from the central node database, that node is no longer displayed
in any view, and is moved to the Excluded Nodes database. Though these nodes can no
longer be displayed or managed, they are protected from re-discovery, and they can be
re-included in the central node database at any time. Excluded nodes can also be deleted
entirely.
The Excluded Nodes database can be viewed via the View—>Excluded Nodes menu
option available via the primary NetSight Element Manager window; for more
information on this feature, see Chapter 4, List Views.
Alarm and Event Handling
NetSight Element Manager provides powerful alarm and event handling capabilities via
the independent Alarm and Event Service. The Event User Connection Service receives
all incoming messages issued by devices configured to send traps to your workstation, as
well as system events issued by the NetSight Element Manager Network Status process or
another of its component processes (e.g., Discover or Scheduler). Because it is an
independent process, the Event User Connection Service can operate without NetSight
Element Manager running, receiving (and, where appropriate, acting on) traps issued by
your networking devices or events issued by one of NetSight Element Manager’s
component services.
Overview of NetSight Element Manager
You can create multiple Log Views to view a single trap/event database; you can also
define a separate set of View Filters for each Log View window. The Alarm and Event
handler allows you to define two types of event handling actions: foreground actions,
which you can apply interactively to a received trap or event; and background actions,
which provide unattended checking for a specified trap or event’s occurrence, and then
activate the pre-determined event handling response.
Trap and event data can be exported to HTML for report generation capability on an
internal Web server, and used in conjunction with the Pager alarm notification tool (part of
the Scheduler tool described on page 2-12).
For more information about alarm and event handling, see the Alarm and Event Handling User’s Guide; for more information about the Scheduler application, see the Tools Guide.
The NetSight Element Manager Tool Suite
NetSight Element Manager includes a number of powerful utility applications — or tools
— which ease the task of monitoring and managing your network. Among these tools are
Remote Administration Tools, the Scheduler, and MIB Tools.
The NetSight Element Manager Tool Suite2-11
Overview of NetSight Element Manager
Remote Administration Tools
Remote Administration Tools is a utility suite which allows you to conveniently perform
routine management tasks on a single device — or on a group of devices — from your
remote workstation, rather than requiring local terminal access to each device. Among
these tasks are:
•Configuring TFTP and BOOTP sessions with a selected device or device group.
•Adding workstation IP addresses to the trap table(s) of a selected device or device
group.
•Searching a group of devices for the port through which a specified MAC address is
communicating.
•Performing MIB SETs, using a template of MIB objects and values, on one or more
devices.
•Performing MIB GETs, using a template of MIB objects, from one or more devices for
statistics and trend analysis.
•Performing a soft reboot on selected devices.
•Changing access community names on selected devices.
For more information about these tools, see the Remote Administration Tools User’s Guide, included in your documentation set.
Scheduler Tool
The Scheduler tool allows you to schedule certain administrative actions so that they can
be performed while your workstation is unattended. These actions include:
•Performing discovery sessions (using scripts defined using the Discover application).
•Launching selected programs, including TFTP downloads, MIB statistics recordings,
•Backing up files (NetSight Element Manager data files, or any other files you choose).
•Setting up automated paging (by defining individuals or groups of individuals to be
For more information about the Scheduler tool, see the Tools Guide, included in your
documentation set.
and MIB loads via the Remote Administration Tools application.
paged, and specifying their availability to be paged). The paging feature is integrated
with NetSight Element Manager alarm and event handling, so that a scheduled page
can be performed as part of an interactive foreground action, or an unattended
background action.
2-12The NetSight Element Manager Tool Suite
MIB Tools
Overview of NetSight Element Manager
The MIB Tools suite of MIB browsing and editing tools comprises:
•The MIB Browser — a simple graphical interface you can use to contact and query
SNMP nodes on your network and examine their supported MIBs (as long as the MIBs
are imported into the MIB Tools database). MIB Browser also lets you conveniently
perform SETs on contacted devices.
•MIB Details — a display of the descriptive information for management objects that
you query from a node.
•The MIB Editor, which lets you manipulate your database of network vendor’s MIBs.
An extensive MIB database is provided with MIB Tools; you can input new MIBs
(stored in ASCII text format) into this database, or you can delete any unnecessary
MIBs (or MIB portions) so that the database maintains the precise MIB information
that you need to manage your nodes.
•The Device Manager, which allows you to maintain a database of node IP addresses
that you frequently contact, and displays summary information about these nodes.
•A Preferences option, which lets you view and change configuration settings for the
MIB Tools suite.
Customizing NetSight Element Manager
There are a number of ways you can adjust NetSight Element Manager’s settings to
customize its operation in the way that works best in your management environment.
These are detailed in the following sections.
You can also do some batch customization outside of the NetSight Element Manager
TIP
Adjusting Default Settings
platform; see Appendix A, Batch Customization via AddTool, AddImage, and
AddDevType, for more information.
The Options window controls the default settings for NetSight Element Manager and
some of its components. These settings control the operation of many basic features and
functions in NetSight Element Manager, and they are referenced throughout the document
set. You may want to adjust these settings so that they better suit your specific network
management needs.
The Options window — accessed by selecting Tools—>Options from the primary
window menu bar — has seven tabbed pages, each of which controls a set of related
functions in NetSight Element Manager. Each tabbed page and the options it controls is
discussed in the following sections.
Customizing NetSight Element Manager2-13
Overview of NetSight Element Manager
Figure 2-7. The Options Window (with Workspace Options Selected)
Workspace Options
The Workspace options (displayed by default, as illustrated in Figure 2-7) control various
settings for the NetSight Element Manager interface. You select or deselect each option by
clicking the associated checkbox. A checked box indicates that the associated option is
selected; a blank box indicates that option is deselected.
Show Splash window at startup
The Splash window is an identifying screen that will briefly appear when you initialize
NetSight Element Manager. Selecting this option will cause the screen to be displayed;
deselecting it will suppress the screen.
Show Tooltips
Tooltips are small pop-up windows that provide user assistance by identifying controls
such as toolbar buttons. Selecting Show Tooltips will cause these to be displayed when
the mouse cursor is dragged over a toolbar icon; deselecting the option will suppress them.
You may want to leave this option selected until you are comfortable visually identifying
all the toolbar options by their icons.
Autofill IP address fields
When this option is selected, the dotted decimal IP address octets set via the Network
options (or via the Welcome Wizard) will be automatically entered in any field that
requires an IP address.
2-14Customizing NetSight Element Manager
Network Options
Overview of NetSight Element Manager
Autofill Community Name fields
When this option is selected, the community name text set via the Network options (or via
the Welcome Wizard) will be automatically entered in any field that requires a community
name.
Confirm Shutdown
By default, when you shut down NetSight Element Manager (via the File—>Exit menu
option, the Exit toolbar icon, or the Close button in the main application window), a
message window opens asking you to confirm your action with a Ye s (exit) or No (remain
open). Deselecting this option will cause the confirmation window to be suppressed and
the application will immediately shut down; leaving it selected will cause the confirmation
window to be displayed.
The Network options (Figure 2-8) allow you to set the default Community Name, IP
Address prefix, and Address Mask that will be used when you attempt to add entries into
the node database (either manually or through a discovery).
TIP
TIP
When you initialize NetSight Element Manager for the first time, a Welcome Wizard will
guide you through setting up the product. The information entered through the Welcome
Wizard appears (and can be edited) here.
Community Name
The Community Name is a basic security mechanism implemented in SNMP. It acts as
both a local and remote password for IP devices, and provides different levels of access
(i.e., read only, read-write, and super user) to the device’s information. Community names
and their level of access must be configured at each device. Generally, the default
community names for a device are set at “public” for all levels of access.
If you have adequate privileges, there are several ways you can edit a device’s community
name: via Local Management, as described in your local management documentation; via
any MIB utility — like NetSight Element Manager’s MIB Tools suite — that allows you to
perform SNMP GETs and SETs; or via the Community Names component of the Remote
Administration Tools.
Customizing NetSight Element Manager2-15
Overview of NetSight Element Manager
Figure 2-8. The Network Options
NOTE
NetSight Element Manager uses the Community Name to gain access to devices that you
want to manage. You specify the community name you want to use to access a device
when the device is inserted (as documented in Chapter 4, List Views) or discovered (as
documented in Chapter 3, Discovering Nodes). You can also change the community
name NetSight Element Manager uses to communicate with a device via the Device
Properties windows (also documented in Chapter 4, List Views). For full device
management, you should select a community name which provides super user access.
The community name set in the Network Options window serves as the default value
entered in any field which requires a community name; however, you can always enter a
specific community name on a case-by-case basis in any of the windows that require one.
To check whether a device is active on the network — and consequently to turn the device
icon green on Map Views, List Views, and Tree Views — NetSight Element Manager
issues polls for device interface information. This type of poll does not require community
name access to the device, since it is merely a check of network health. If you cannot
access a device’s management windows — even though its icon appears green on the map
— check that the community name you are using to access the device still has valid read,
read/write, or super user access.
To set the default community name:
1. Click in the Community Name text field, and type in a community name
which will be used as NetSight Element Manager’s default value.
See your local management documentation or the Remote Administration Tools User’s
Guide included with your documentation for more information on community names.
2-16Customizing NetSight Element Manager
Overview of NetSight Element Manager
IP Address Autofill
As with community names, an IP address is required to add devices to, or modify existing
devices in, the central node database. (The Insert Device and Device Discover Properties
windows both have an IP address entry field.) The IP Address Autofill option allows you
to specify the network or subnet identifying octets (in dotted decimal IP format) you wish
to be entered by default in any required IP Address field (again, you can change the IP
address on a case-by-case basis).
To set the default IP Address Autofill prefix:
1. Click in the IP Address text field, and type in the network or subnet identifying
octets (in dotted decimal IP format) which you wish to use as a prefix.
Address Mask
An address mask is used to determine whether a given destination IP address (in this case,
that of managed devices) exists on the same network or subnetwork as a given source IP
address (in this case, that of yourNetSight Element Manager workstation). The Address
Mask field lets you set a default value which will be used when NetSight Element
Manager polls for IP devices during a Network Discovery.
The appropriate address mask depends upon your network configuration. If your network
contains subnets, entering the appropriate subnet mask in this field will identify the
network, subnet, and host portions of the IP addresses in the address range. For example,
on a Class B network containing an IP address of 132.177.118.24, a subnet mask of
255.255.255.0 would identify the first two octets (132.177) as the network portion of the
address, the third octet (118) as the subnet portion, and the final octet (24) as the host
portion.
Polling Options
If your network does not contain subnets, entering the appropriate network mask in this
field will identify the network portion of the IP addresses in the address range. For
example, on a Class B network containing an IP address of 132.177.118.24, a network
mask of 255.255.0.0 would identify the first two octets (132.177) as the network portion
of the address.
To set the default Address Mask:
1. Click in the Address Mask text field, and type in the network or subnet
identifying octets which you wish to use as the mask.
The Polling options (Figure 2-9) let you configure how NetSight Element Manager
contacts nodes in your database (and consequently how often their contact status is
refreshed in List View, Tree View, or Map View windows).
Customizing NetSight Element Manager2-17
Overview of NetSight Element Manager
Figure 2-9. The Polling Options
NOTE
Node Polling
Node polling establishes how often the contact status between NetSight Element Manager
and the IP devices in your node database will be refreshed. You configure node polling by
setting the interval for a polling cycle and the number of nodes that will be polled during
that interval. In essence, you use the node polling options to limit the amount of network
traffic that NetSight Element Manager generates as it polls devices for their status.
The above figure shows the defaults for NetSight Element Manager: a 5-second polling
cycle with 10 poll packets issued within that cycle. With a database of 100 managed
nodes, this means that it will take 50 seconds to poll the entire node database and fully
refresh the contact status of nodes in the List Views, Tree Views, and Map Views — since
there will be 10 iterations of the 5-second polling cycle to determine the contact status
with all 100 nodes.
The status of polled nodes is maintained as is between polling cycles. If a node goes down
during a polling cycle, its icon will remain Green/Up until NetSight Element Manager
re-polls it and determines the loss of contact. For an immediate update of a specific
node’s status, highlight the device, then select Manage—>Query Status from the primary
window menu bar, or Query Status from the right mouse menu.
You can configure polling for an individual node so that it is polled less frequently than
the refresh time required to poll the entire node database. For example, if one of your 100
managed IP nodes was at the far end of a T1 link, and you would like that node to be
polled hourly (rather than at the refresh rate established via Node polling), you could set
an individual poll rate for that device to be 3600 seconds (via the Device Properties
2-18Customizing NetSight Element Manager
TIP
Overview of NetSight Element Manager
window, as described in Configuring Node Interface Poll Settings in Chapter 4). This
would override the polling refresh rate of the database (once per 50 seconds), by instead
having NetSight Element Manager issue a once-hourly poll to that individual node.
However, you cannot configure polling so that contact status with an individual node is
refreshed more frequently than the refresh rate established by the Node database polling
settings. Even if you configured one of your 100 managed nodes to be polled every 10
seconds for contact status, it would still be subject to the refresh rate of the entire node
database. In actuality, its contact status would only be updated once during the 50 seconds
it takes to fully poll the node database.
If you have a mission-critical node, you can keep Chassis Manager running to be
constantly appraised of its contact status. Because the Chassis Manager application uses
its own polling mechanism (independent of the node database polling in NetSight Element
Manager), you can determine the status of the node by using the Contact Status symbol in
Chassis Manager’s Logical View window. Refer to your individual device-specific User’s Guides for more information on using Chassis Manager; refer to the Device
Management Options section, following, for more information on setting the Chassis
Manager poll settings. You can also issue an immediate status poll at any time via the
Query Status options described above.
TIP
Use the following fields to establish the refresh rate of polling for all nodes in your node
database:
Interval (sec)
The amount of time that elapses between groups of poll packets. The number of intervals
required to complete a poll cycle will depend on how many devices are in your node
database, and how many are being polled during each interval.
To set the Interval value:
1. Click in the Interval text field, and type in the number of seconds you want
NetSight Element Manager to wait between each set of polling packets. The
range is from 1 to 60 seconds; the default is 5 seconds.
Packets
The number of poll packets that will be sent to devices eligible for polling during each
polling interval.
To set the Packets (number of polled devices) value:
1. Click in the Packets text field, and type in the number of IP devices you want
polled during each poll Interval. The range is from 1 to 25.
To determine the amount of time it will take NetSight Element Manager to complete one
poll of all nodes in your database, divide the number of nodes in your database by the
Packets value and multiply by the Interval (sec) value.
Customizing NetSight Element Manager2-19
Overview of NetSight Element Manager
Node Options
The Node options (shown in Figure 2-10) let you configure the default contact poll
settings that will be established when IP devices are added to the node database.
Default Poll Settings
Unlike the poll settings configured via the Polling Options tabbed page, the Node Options
default poll settings determine the default poll values that will be assigned to each
individual node via its Properties window. In most instances, these default poll settings
will have no bearing on how often the node is actually polled, since the Node Polling
settings determine the amount of time it takes NetSight Element Manager to poll every
device in the database.
Figure 2-10. The Node Options
In general, it is advisable to leave the Default Poll Settings at their initial values; if you
have a few specific devices you’d like to poll less frequently than the configured Polling
Options values would achieve, use the individual nodes’ Properties windows to edit these
default settings.
The Default Poll Settings let you configure the following:
Interval (sec)
The default number of seconds configured for polling an individual IP device. Note that in
general, the polling settings for updating the status of individual IP devices will be
overridden by the Node options configured in the Polling page. The interval set in this
field will only take precedence if it is longer than the duration required to poll the entire
node database (as configured via the Polling Options page).
2-20Customizing NetSight Element Manager
Overview of NetSight Element Manager
To change the interval (if desired):
1. Click in the Interval (sec) text field, and type in the poll interval to be used as
a default when adding new devices. The range is from 5 to 9,999 seconds.
Retries
If individual device polling is in effect, this will determine the default number of times
after a failed poll that NetSight Element Manager will re-poll a device before declaring it
in a Critical (contact unavailable) state. To change the default Retries setting:
1. Click in the Retries text field, and type in the number of polls which will be
issued to an individual device before declaring a contact unavailable status.
The range is from 0 to 100 retries; the default is 3 retries.
Timeout (sec)
This field determines the default duration between retry polls to an individual device. To
change the Timeout value:
1. Click in the Timeout (sec) text field, and type in the duration (in seconds)
between re-polls after the initial poll failure. The range is from 1 to 90
seconds; the default is 4 seconds.
NOTE
Directories Options
This Timeout value can only be configured here, for all nodes; individual Node Properties
windows do not provide the option of setting this value.
The Directories page lists the default locations used by NetSight Element Manager and its
components to store and retrieve files. It also allows you to change the default Map and
Export directories.
Customizing NetSight Element Manager2-21
Overview of NetSight Element Manager
Figure 2-11. The Directories Options
TIP
Map files
This field specifies the default directory that is used when you save a map. You can either
override the default value in the Save Map window as each new map is saved, or you can
set a new default location here. Refer to Chapter 6, Creating Network Maps, for more
information on creating and saving maps. The default directory is \NetSight Element
Manager x.x\Maps.
To specify the default Map directory:
1. In the Map files text field, type in the full directory path for the directory in
which you want to save map files by default. Be sure the directory already
exists, or the change will not be accepted.
or
Click Browse. A standard Microsoft Browse window opens. Use the directory
tree to select the directory (folder) which you would like to use as the default.
If you change the default map location, map files stored there will still be automatically
backed up with the Data File Manager; however, if you also have map files in the original
directory (or in any other directory), those will not be automatically backed up. If you
store map files in more than one directory, be sure to back them up manually.
Data files
This read-only field indicates the directory where NetSight Element Manager stores its
workspace configuration information (including information about the nodes in the List
Views and Tree Views). The default directory is \NetSight Element Manager x.x\Data.
2-22Customizing NetSight Element Manager
TIP
Overview of NetSight Element Manager
Log files
This read-only field indicates the directory used to store log files generated by NetSight
Element Manager’s processes or applications (e.g., the alarm and event handling service).
The default directory is \NetSight Element Manager x.x\Log.
Executable files
This read-only field indicates the directory whereNetSight Element Manager stores its
executable files and dynamic link libraries (DLLs). The default directory is \NetSight
Element Manager x.x\Bin.
Exported files
This field displays the default directory to be used in any export action taken from within
NetSight Element Manager or one of its component applications (like RMON), regardless
of the export file type (*.csv, *.txt, *.htm, etc.). The default directory is \NetSight Element
Manager x.x\Export.
If you change the default export file location, files stored there will still be automatically
backed up with the Data File Manager; however, if you also have exported files in the
original directory (or in any other directory), those will not be automatically backed up. If
you store exported data files in more than one directory, be sure to back them up
manually.
Device Management Options
The Device Management options (Figure 2-12) let you configure the poll settings to be
used by the Chassis Manager and SmartSwitch/Matrix chassis management applications.
Figure 2-12. The Device Management Options Window
Customizing NetSight Element Manager2-23
Overview of NetSight Element Manager
Chassis Manager Settings
The Chassis Manager settings let you establish how the Chassis Manager and
SmartSwitch/Matrix Chassis View applications poll a monitored device. There are two
settings which you can configure:
Poll Rate
The interval, in seconds, at which the Chassis Manager or SmartSwitch/Matrix Chassis
View will poll a device to check whether it is alive on the network (i.e., has a green
contact status).
To change the poll rate:
1. Click in the Poll Rate text field, and type in the interval to be used when
Chassis Manager polls a device for its contact status. The range is from 5 to
9999 seconds; the default is 30 seconds.
Retries
The Retries field determines the number of polls that the Chassis Manager or
SmartSwitch/Matrix Chassis View will issue to a device after the first failed poll before
declaring a lost contact state. To change the Retries setting:
TIP
Event Log Options
1. Click in the Retries text field, and type in the number of polls which must fail
(after the initial poll failure) before Chassis Manager declares that contact is
unavailable. The range is from 0 to 10 retries; the default is 2 retries.
You can also edit the ctron.ini file (located in the /windows directory for Windows 2000,
or in the /winnt directory for Windows NT) to specify the interval between retry polls from
Chassis Manager or the SmartSwitch Chassis View. Alter the
BackgroundTrysInterval=X line, where X is the number of seconds between retry polls.
The default setting is 15 seconds.
The Event Log options (Figure 2-13) allow you to set the size of the alarm and event
service’s event cache (which stores trap and event information). The event cache is a
memory-mapped data file that is activated when NetSight Element Manager’s alarm and
event service initializes. All traps and events that are received are uniquely identified and
stored in this file. The file is a wrap-around buffer which overwrites the earliest entries
with each new incoming trap or event. Refer to your Alarm and Event Handling User’s Guide, included in your documentation set, for more information about the event cache
and other aspects of alarm and event handling.
2-24Customizing NetSight Element Manager
Overview of NetSight Element Manager
Figure 2-13. The Event Log Options Window
You can establish an hourly purge of the event cache file by specifying that traps or events
which meet certain conditions be deleted. These conditions are defined by three Event Log
options you select or de-select by clicking in the associated checkbox. The fourth option
— Set log size — allows you to control the overall size of the cache.
Clear deleted events hourly
Checking this option will activate an hourly purge of all events marked as deleted. If this
option is deselected, events marked as deleted will simply be overwritten as the cache
wraps at their position.
Clear acknowledged and closed events hourly
Checking this option will activate an hourly purge of all events that have been
administratively acknowledged or closed during the previous hour. If this option is
deselected, no such purge will take place, and acknowledged and closed events will
simply be overwritten in the normal course of the event cache wrap.
Clear normal and informational events hourly
Checking this option will activate an hourly purge of all events received during the
previous hour that have a severity level of Normal or Informational. If this option is
deselected, no such purge will take place, and normal and informational events will
simply be overwritten in the normal course of the event cache wrap.
Set log size
This option will allow you to change the size of the event cache from between 1000 and
10000 entries; the default size of the cache is 3000 entries.
Customizing NetSight Element Manager2-25
Overview of NetSight Element Manager
To set the options in the Event Log Options window:
1. To activate the Clear deleted events, Clear acknowledged and closed
events, or Clear normal and informational events options, click to check
the appropriate selection.
2. To set a new event cache size:
a. Click to check the Set log size option. Note that if this option is not
selected, the cache size text field will not be editable.
b. Click in the associated text field and type in the desired cache size. The
range is 1000–10000 entries.
3. Click Apply to set your selection and remain in the Options window, or OK to
set the selection and exit the Options window.
Once you apply any change, the appropriate changes are immediately made to the event
cache (e.g., all normal and informational events will be deleted), and from that point the
cache will be updated hourly as configured. Note that each time you make and set a
change in the Event Log Options window, you will restart the hourly purge cycle based on
the time of configuration.
Customizing the Toolbar
NetSight Element Manager provides access to a number of tool applications via its Tools
menu and accompanying Tools toolbar. You can customize this access by adding items to
or removing items from both the menu and toolbar, or editing their tool tip, hint text,
and/or icon image. This process is described below.
You can also do some batch customization of the Tools menu and toolbar outside of the
TIP
NetSight Element Managerplatform; see Appendix A, Batch Customization via AddTool,
AddImage, and AddDevType, for more information.
To access the customize window:
1. Select Tools—>Customize from the primary window menu bar. The
Customize window, Figure 2-14, opens.
2-26Customizing NetSight Element Manager
Overview of NetSight Element Manager
TIP
Adding a Tool Entry
Figure 2-14. The Customize Window
The top portion of the window allows you to define the menu pick, hint, and tool tip text
that will label your new selection, as well as the graphic image that will be used as its tool
bar icon. The lower portion of the window allows you to assign the appropriate executable
and any necessary arguments; it also allows you to define certain launch parameters. You
can use these same fields to edit any existing entry in the toolbar or menu.
Information about the configuration of the Tools menu and toolbar is stored in the
Tools.dat file (\NetSight Element Manager x.x\data); to preserve your customization, be
sure to back up this file. See Backing Up Data Files, beginning on page 2-30, for more
information.
When you add an entry to the Tools menu, you must also add a corresponding icon to the
Tools toolbar, and vice versa. To do so:
1. Click on the Add button in the upper-right corner of the window. A new menu
item with default text (&New Menu Item) will be added to the Menu Items list
box, with an edit box around it.
Customizing NetSight Element Manager2-27
Overview of NetSight Element Manager
2. In the edit box provided, enter the text you want to appear in the Tools menu
for the new entry. Place an ampersand (&) before the character you’d like to
use for the access key.
If you select an access key that is already in use, a message window will note this when
NOTE
you try to enter your new item name. If you choose to configure an access key, it must be
unique or the new Tools item cannot be added.
3. In the Hint text field, enter the text you want displayed in the status bar at the
bottom left of the primary NetSight Element Manager window when the menu
item is selected or the cursor is positioned over its associated toolbar icon.
This information is optional; you can also leave the field blank.
4. In the Tool Tip text field, enter the text you want displayed in the tooltip
pop-up when the cursor is positioned over the associated toolbar icon. This
field is also optional, and can be left blank.
5. To select an image to use for the toolbar icon, click on Select to launch the
Select Image window, Figure 2-15. Once there:
TIP
If the executable you have selected already has an icon associated with it, that icon will be
displayed by default; you can use the icon image provided, or change this default via the
following steps.
a. Click Browse and in the resulting File Open window, select the bitmap file
you wish to use as a basis for the toolbar icon, then click Open. The
selected bitmap image will be displayed in the Images: display area in the
window. (If the image is too big in either dimension to be fully displayed, a
message window opens, indicating that the image will be cropped to fit.)
b. Click the Small Image radio button, then move the resulting square
selection cursor around on the image to select the portion you wish to
display for the toolbar icon, and click again to make the selection. The
image portion you have selected will be displayed below the Small Image
radio button. Move the cursor and click again to change this selection until
you find the one you want.
c. If you wish, click the Large Image radio button, then move the resulting
square selection cursor around to select the image portion you wish to
display for a large icon, and click again to make the selection. The image
portion you have selected will be displayed below the Large Image radio
button. Move the cursor and click again to change this selection until you
find the one you want. This image isn’t displayed anywhere except in this
window, but you may want to go ahead a select one for consistency. If
you don’t select one, the default image will remain in place.
2-28Customizing NetSight Element Manager
Overview of NetSight Element Manager
Figure 2-15. Select Image Window
d. Click OK to save your image selection(s) and return to the Customize
window.
TIP
6. Use the Browse button to the right of the Command field to locate the
executable you wish to launch with your new Tools menu selection. The
executable path and file name cannot be entered directly into the Command
field; you must select it via the Browse window.
7. Use the Arguments field to add any arguments that can be accepted by your
chosen executable and that you want added by default each time the icon or
menu pick is selected.
Clicking on the Build button will launch a Build window that may help you construct the
appropriate argument string; for more details on how to use this window, see Building an
Argument List in Chapter 4, List Views.
Note that if you select an argument symbol that will extract information from the NetSight
Element Manager database (for example, %i to insert an IP address, or %c to insert a
community name), the menu item and tool bar icon for your application will only become
available when a device is selected in a List, Tree, or Map View — this will guarantee that
the appropriate argument information can be obtained.
If you select a specific value for a build argument, or if you do not specify any build
arguments, your Tools menu item and its accompanying icon will always be available.
8. If you wish, you may also specify a Working Directory for your tool. Use the
Browse button to the right of the Working Directory field to locate the
appropriate directory. The directory name cannot be entered directly into the
field; you must select it via the Browse window.
Customizing NetSight Element Manager2-29
Overview of NetSight Element Manager
9. In the Show field, use the drop-down list to select the default display mode for
your tool application: Normally, Hidden, Minimized, or Maximized.
10. Click to select the Launch at Start-up option if you want this tool launched
automatically with NetSight Element Manager.
11. Click OK to add your new option.
Editing a Tool Entry
You can also edit any of the configured values for a Tool entry (either one you have
added, or one of the default entries provided); to do so:
1. Open the Customize window by selecting Tools—>Customize from the
primary NetSight Element Manager window.
2. In the Menu Items list box, click to select the item you wish to edit. The
remaining window fields will fill with the values set for the selected item.
3. Edit the existing values as desired; see the previous section for details.
4. Click OK to save your changes and exit the Customize window.
Removing a Tool Entry
You can also delete any existing Tool entry, as follows:
1. Open the Customize window by selecting Tools—>Customize from the
primary NetSight Element Manager window.
2. In the Menu Items list box, click to select the item you wish to remove, then
click on Delete. The selected item and its associated parameters will be
removed from the window.
3. Click OK to save your changes and exit the Customize window.
Backing Up Data Files
We strongly recommend that you back up your NetSight Element Manager files on a
regular basis. The Scheduler will do that automatically (see the Scheduler chapter in the
Tools Guide for more information). This section describes how you can also perform this
function manually, with the Data File Manager.
The Data File Manager is preset to backup specified files and file types in five directories
located in the \NetSight Element Manager x.x directory: \Data, \Bin, \Filters (and its
automatically-created subdirectories), \Maps (or your configured Maps directory), and
\Export (or your configured Exported Files directory). An editable configuration file
determines the specific files and file types that will be backed up; you can edit this file to
add additional files or file types, but they must reside in one of the five directories
specified above.
2-30Backing Up Data Files
TIP
Overview of NetSight Element Manager
If you change the default Maps and/or Exported Files directory (via the Directories
Options available in the Tools—>Options window), the Data File Manager will
automatically back up any specified files that reside in the new default directories. Any
files that reside in the original default directories, however, will no longer be backed up.
The following files and file types are included in the Backup Configuration file by default;
they will be backed up and maintained in your backup directory as long as they reside in
one of the defined backup directories.
•rmflt.mdb and rmflt.ldb — These database files maintain RMON packet capture
filter definitions.
•*.csv, *.htm, *.mrf, and *.txt — Files which contain exported data
•*.map — .MAP map files (viewable format)
•*.mmp — SmartSwitch 9000 Chassis Configuration files (from SPECTRUM Element
Manager version 2.0)
•*.dmf — SmartSwitch and Matrix Chassis Configuration files
•*.mrm — .MRM map files (import format)
•*.filter — Files with information for viewing filters for log view events
that must be manually initiated in response to an event
•*.backgroundaction — Files containing definitions for configured background
actions — actions that are executed automatically in response to specific events
•ae_log.mdb — Alarm and Events log database
•Classes.dat — Contains definitions for node classes
•Discovers.dat — Scripts used in network discovers
•EvtCache.dat — The cache which stores the most recent traps and events
•Exnodes.dat — Excluded nodes
•Groups. dat — Information on DLM status groups
•Intrface.dat — Interface information displayed in Tree Views, List Views, and the
Node Properties window
•Nodes.dat — Node information displayed in Tree Views, List Views, and the Node
Properties window
•Port.dat — Reserved for future use
•RemoteAd.mdb — The Remote Administration Tools database
•Sessions.dat — Definitions for Netstat, NetSight Element Manager, and scheduler
connections
Backing Up Data Files2-31
Overview of NetSight Element Manager
•Subnet.dat — Subnet definitions
•Tools.dat — Information on items in the Tools menu
•Wrkspace.dat — Configuration of window placement and other appearance
properties within the primary NetSight Element Manager window.
•CSMIBDS.MDB — MIB database.
•*.def and*.trapdef — Trap definition files.
To access the Data File Manager:
1. Exit any current management sessions. NetSight Element Manager must be
closed for the backup utility to operate.
2. Select the Data File Manager icon in your NetSight Element Manager
program group. The Data File Manager window opens, as illustrated in
Figure 2-16.
Figure 2-16. Accessing the Data File Manager Window
The Data File Manager window provides access to each of the Data File Manager
functions: Edit Configuration File, which allows you to select the files and/or file types
that will be backed up; Backup, which performs the backup action; Restore from saved,
which replaces the current set of files with a previously-backed-up version; and Restore from new, which replaces all listed files with their original default versions.
The following sections detail how to perform each operation.
2-32Backing Up Data Files
Editing the Backup Configuration File
When you perform a backup action, the Data File Manager looks in five directories in the
\NetSight Element Manager x.x directory — \Data, \Bin, \Filters (and its
automatically-created subdirectories), \Maps (or your configured Maps directory), and
\Exports (or your configured Exported Files directory) — for the files and/or file types
specified in the Backup Configuration File. Any files you wish to back up must be either
specifically named (Tools.dat) in the Backup Configuration File or of a type (*.map) listed
in the file; files must also be present in one of the five directories.
If you change the default Maps and/or Exported Files directory (via the Directories
TIP
Options available in the Tools—>Options window), the Data File Manager will
automatically back up any specified files that reside in the new default directories. Any
files that reside in the original default directories, however, will no longer be backed up.
To view or edit the list of data files that will be backed up, click on Edit Configuration
File. A text file display (stored as \NetSight Element Manager x.x\bin\emanfil.db),
showing the current list of files and file types that will be backed up (Figure 2-17).
Overview of NetSight Element Manager
Figure 2-17. Sample NetSight Element Manager Backup Configuration
Backing Up Data Files2-33
Overview of NetSight Element Manager
To edit this list:
1. Create a file backup entry by using the text editor to type a new line that
specifies the file name, or the *.XXX file extension (for all files of a similar
type). Remember, only files in the five pre-set directories will be backed up, so
you needn’t specify a path for any files you add to the list.
2. Save and exit the text file.
We encourage you to add the following files to your Backup Configuration file, if
applicable:
•Any data files in your \Bin directory that have been placed as Linked Objects in a map
(e.g., sound recorder files, Paintbrush files, database files, etc.)
Performing a Backup
1. In the main Data File Manager window, click on Backup. A window opens
(Figure 2-18), prompting you to specify the directory path in which to copy the
backup files.
The current
backup directory
path
For best results, we recommend that you store a copy of your backed-up files in a
NOTE
directory that is not a sub-directory of your NetSight Element Manager installation
directory.
2. Click OK. As the backup proceeds, you will be prompted to authorize the
overwriting of any existing files. If any part of the procedure fails (for example,
if you attempt to backup a specific file that does not reside in one of the five
preset directories), you will be notified of the error.
Click here if you
want your backup
directory to reside
on another network
drive.
Figure 2-18. Select Backup Directory Window
2-34Backing Up Data Files
3. When the backup is complete, a successful backup message will be
displayed. Click OK to exit this window and complete the backup procedure.
If even one file listed in the Backup Configuration file could not be found, a message
NOTE
window opens noting that the backup operation failed. This doesn’t mean the entire
operation failed; it just indicates the failure to back up the missing file.
Restoring Files from a Backup Set
If you have backed up your data files from SPECTRUM Element Manager version 2.x
WARNING
before installing NetSight Element Manager version 3.0, do not restore these data files
directly into version 3.0! The 3.0 installation process performs some necessary
conversion functions on these files to make them compatible with framework changes. If
you attempt to use version 2.x data files that have not undergone this conversion process
will produce unexpected behavior. As soon as you have installed version 3.0 and verified
that your files are working correctly, we recommend that you do another backup of your
3.0 data files.
Overview of NetSight Element Manager
1. In the main Data File Manager window, click on Restore from saved. A
window opens, prompting you to specify the directory path from which to copy
the archived files back into their original locations. This will be the same
directory path you chose in the steps described above.
2. Click OK. Two pop-ups open in quick succession: one to indicate the files are
being backed up, and a second to indicate the procedure was successful. You
will be given the opportunity to cancel the operation if you are overwriting an
existing file or, if the procedure fails, you will be notified of the error.
3. Click OK to exit the final prompt window.
Restoring Default Files
To restore your configuration files to their original condition without re-installing:
1. Click on Restore from new. A message appears, reminding you that this
operation will destroy some or all of your data files, and reset much of your
configuration to default values.
2. Click OK. Two pop-ups open in quick succession: one to indicate that the files
are being restored, and a second to indicate the procedure was successful.
You will be given the opportunity to cancel the operation if you are overwriting
an existing file or, if the procedure fails, you will be notified of the error.
3. Click OK to exit the final prompt window.
Backing Up Data Files2-35
Overview of NetSight Element Manager
2-36Backing Up Data Files
Chapter 3
Discovering Nodes
Accessing the Discover Manager window; creating and modifying Discover scripts; executing Discover
scripts; the Discover process; starting the Discover Wizard; launching the Scheduler application; using
the IP or Host Locator; using the Subnets window
The Discover Manager application allows you to locate devices on a network. You can
perform a Discover process within a specified range of IP (Internet Protocol) addresses, on
an entire subnet, or on a combination of the two. The Discover application automatically
explores the defined network segment, creates a list of discovered devices, and assigns an
icon to each of them. The discovered nodes are then automatically integrated into
NetSight Element Manager’s central node database, and consequently displayed as
appropriate in any List or Tree Views (see Chapter 4, List Views, and Chapter 5, Tree
Views, for more information).
The Discover application operates using scripts, which are created and saved within the
application (allowing them to be run repeatedly if desired). You can create a new Discover
script by using either the Discover Manager window (Figure 3-1) or the Discover Wizard,
which will lead you step by step through the Discover process (see Starting the Discover
Wizard on page 3-19). The following sections describe the use of the Discover Manager
window to create, modify, and execute Discover scripts.
Accessing the Discover Manager Window
To access the Discover Manager window from the NetSight Element Manager primary
window:
1. Select Tools —> Discover Manager from the primary window menu bar.
or
Click the Discover Manager button () on the NetSight Element Manager
Standard toolbar.
The Discover Manager window, Figure 3-1, opens.
3-1
Discovering Nodes
Figure 3-1. The Discover Manager Window
The Discover Manager window lists all Discover scripts you have created, including their
names, descriptions, and execution intervals. The Discover Manager window is the central
interface through which you create new scripts and modify, execute, and delete existing
scripts; from this window, you can also choose to run the Discover Wizard, and launch the
Scheduler application. (For more information about the Scheduler application, see the
Tools Guide.)
Creating and Modifying Discover Scripts
Discover scripts are created and modified using the Discover Properties window
(Figure 3-2). When you are creating a new Discover script, this window will supply three
tabbed pages — General, Device, and Schedule — which allow you to specify all desired
parameters.
Accessing the Discover Properties Window
To create a new Discover script:
1. Click New.
or
Click the right mouse button on an existing script name or in the central area
of the window, and choose New from the resulting menu.
The Discover Properties window, Figure 3-2, opens.
3-2Creating and Modifying Discover Scripts
Discovering Nodes
To modify an existing Discover script:
1. In the Discover Manager window, highlight the script to be modified, and click
Properties.
or
Click the right mouse button on the script to be modified, and select
Properties from the resulting menu.
The Discover Properties window, also illustrated in Figure 3-2, opens.
Figure 3-2. The Discover Properties Window
Creating and Modifying Discover Scripts3-3
Discovering Nodes
Using the Discover Properties window, you can name your script, enter an IP range for an
IP Discovery process, and assign a community name. You can also define and select entire
subnets for a Subnet Discovery, select a Script Filter for a discovery, and define the time
interval at which your discovery will take place.
Setting General Discover Properties
The General page of the Discover Properties window is used to name and describe your
Discover script (as shown in Figure 3-3). The script’s name and description will be listed
in the Discover Manager window.
To name and describe your Discover script:
1. If necessary, click on General tab in the Discover Properties window. The
General page (Figure 3-3) opens.
2. Highlight the contents of the Name: field, and type the name of your Discover
script. By default, each new script is named New Discover X, where X
increments as necessary to create a unique name.
Figure 3-3. The General Page of the Discover Properties Window
3-4Creating and Modifying Discover Scripts
3. In the Description: field, enter a description of the Discover script. This
description opens with the script’s name in the Discover Manager window,
and may help you to select from among the available scripts.
4. Enter any additional information you wish to store about the script in the
Notes: field. Note that this information is not displayed anywhere else.
5. Define your remaining Discover script parameters as explained in the
following sections, or click OK to save your entries and return to the Discover
Manager window.
Setting Device Discovery Parameters
A Device Discover script can discover devices within a single IP address range or a series
of ranges. It can also search one or more subnets, and limit its discoveries to SNMP
devices only or Cabletron devices only. You define Device Discovery parameters using
the Device page of the Discover Properties window (Figure 3-4), accessed by clicking on
the Device tab.
Discovering Nodes
Figure 3-4. The Device Page of the Discover Properties Window
Creating and Modifying Discover Scripts3-5
Discovering Nodes
To define a Device Discovery script, you must specify a range of IP addresses to be
queried and assign at least one community name that will give the Discover application
read access to the devices you wish to discover. IP address ranges can be individually
specified, or entire subnets can be selected; you can also combine subnets and specific
ranges in a single script, as long as the total number of addresses to be queried does not
exceed 2000. If you choose, you can also assign a Script Filter that will limit the discovery
to SNMP devices only or Cabletron devices only.
Defining IP Address Ranges
To set the IP address range (or ranges) for your Device Discovery:
1. To define a new IP address range, click New to the right of the Address
Ranges group box; or click the right mouse button anywhere in the Address
Ranges group box, and select New from the resulting menu.
To modify an existing IP address range, highlight the IP Address range that
you wish to change, and click Properties; or click the right mouse button on
the IP address range that you wish to modify, and select Properties from the
resulting menu.
NOTE
The Address Range Properties window (Figure 3-5) opens.
Figure 3-5. The Address Range Properties Window
When you are defining a new address range, the Starting Address, Ending Address, and
Address Mask fields will contain the autofill values you configured via the Welcome
Wizard or via the Network page in the Tools—>Options window (provided the autofill
function has been enabled via the Workspace page of the Tools—>Options window). See
Network Options in Chapter 2 for more information about configuring these defaults.
2. Place the cursor in the Starting Address field, and enter the address at
which your Discover script should begin.
3. Place the cursor in the Ending Address field (using the Tab key or the
mouse), and enter the address at which the Discovery should end.
3-6Creating and Modifying Discover Scripts
NOTE
Discovering Nodes
Although you can define address ranges beginning with 0 and ending with 255 (for
example, 132.117.18.0 to 132.117.18.255), devices at the .0 and .255 addresses will not
be discovered.
4. If you wish to specify an address mask other than the default value, enter the
desired address mask in the Address Mask field.
The appropriate address mask depends upon your network configuration. If
your network contains subnets, entering the appropriate subnet mask in this
field will identify the network, subnet, and host portions of the IP addresses in
the address range. For example, on a Class B network containing an IP
address of 132.177.118.24, a subnet mask of 255.255.255.0 would identify
the first two octets (132.177) as the network portion of the address, the third
octet (118) as the subnet portion, and the final octet (24) as the host portion.
If your network does not contain subnets, entering the appropriate network mask in this field will identify the network portion of the IP addresses in the
address range. For example, on a Class B network containing an IP address
of 132.177.118.24, a network mask of 255.255.0.0 would identify the first two
octets (132.177) as the network portion of the address.
5. Click OK when your entries are complete. The information you entered
displays in the appropriate fields in the Address Ranges group box.
6. Repeat this process to define additional address ranges for your script.
Each discover script can be configured to query up to 2000 IP addresses; if the number of
NOTE
IP addresses on your network exceeds 2000, you must define and execute multiple
Discover scripts.
7. Define your remaining Discover script parameters as explained in the
following sections, or click OK to save your entries and return to the Discover
Manager window.
Defining and Selecting Subnets
Using the Subnets group box, you can also select entire subnets on which to perform a
Discovery. When a Subnet Discovery is executed, the Discover application will query
every address in the specified subnet, making it unnecessary to define an IP Address range
that encompasses an entire subnet.
Creating and Modifying Discover Scripts3-7
Discovering Nodes
TIP
Subnets will be defined automatically each time a device is added to the node database
(either manually or via a Discover script); they can also be defined manually, either via the
Discover Properties window (as described in this section) or via the View—>Subnets
window available from the NetSight Element Manager primary window menu bar. (See
Using the Subnets Window, page 3-27, for more information about viewing subnets.)
This subnet information is used to determine the map hierarchy created via the automatic
subnet mapping feature; for more information on this feature, see Generating Submaps
Automatically in Chapter 6, Creating Network Maps.
To specify a subnet (or subnets) for your device discover script:
1. To define a new subnet, click New to the right of the Subnets group box; or
click the right mouse button anywhere in the Subnets group box, and select
New from the resulting menu.
To modify an existing subnet, highlight the subnet entry that you wish to
change, and click Properties; or click the right mouse button on the subnet
entry that you wish to modify, and select Properties from the resulting menu.
The Subnet Properties window (Figure 3-6) opens.
Figure 3-6. The Subnet Page of the Subnet Properties Window
2. Place the cursor in the Subnet field and type the network and subnet portions
of the IP Address for the subnet that you wish to discover. For example, to
discover the subnet containing the Class B IP Address 132.177.118.24, type
132.177.118.0 in the Subnet field).
3-8Creating and Modifying Discover Scripts
Discovering Nodes
3. If necessary, place the cursor in the Subnet Mask field and type the subnet
mask for the subnet that you wish to discover. Note that the value set here will
determine the number of IP addresses which are included in the defined
subnet, regardless of whether or not this value correctly reflects the number of
devices each of your subnets contains. For example, a Class B network
typically defines the third byte of the IP address as the subnet identifier, and
the fourth byte as the host identifier. In this kind of network, each subnet (as
defined by each possible value of the third byte) can contain a maximum of
256 nodes on it (the number of possible values for the fourth byte). However,
if you incorrectly identify the subnet mask for such a network as 255.255.0.0,
the discover application interprets this to mean that each subnet has 65,536
IP addresses (256 possible values of the third byte, times 256 possible values
for the fourth byte). Since each discover script is limited to querying a
maximum of 2000 addresses, this kind of incorrect mask setting would
prevent you from completing your script. By default, the Subnet Mask will be
set to 255.255.255.0, limiting the size of the subnet to a maximum of 256
devices. The Nodes field just below the Subnet Mask field indicates the
number of nodes the Discover application understands your defined subnet to
contain; it will update once you have saved your subnet changes, closed the
Subnet Properties window, and re-opened it.
NOTE
The Nodes field in the Subnet Properties window is not the same as the nodes value
displayed in the View—>Subnets window (see Figure 3-20, page 3-28); that value
indicates the actual number of nodes in the central node database that reside on the
defined subnet.
4. On the General page of the Subnet Properties window (Figure 3-7), place the
cursor in the Name text box, and type in a name for your subnet entry. By
default, manually-created subnets are assigned the name New Subnet X,
where X will increment as necessary to create a unique name.
Automatically-created subnets are assigned the subnet address as their
default name.
Creating and Modifying Discover Scripts3-9
Discovering Nodes
Figure 3-7. The General Page of the Subnet Properties Window
TIP
5. In the Description text box, enter a description for your subnet entry. This
description is not displayed in the Discover Properties window, but will be
displayed in the View—>Subnets window accessible from the primary
window menu bar (see Figure 3-20 on page 3-28).
6. Enter any additional information about the subnet in the Notes text box.
7. Click OK to save your subnet discovery parameters and exit the Subnet
Properties window. The address and name of the defined subnet displays in
the Subnets group box on the Device page of the Discover Properties
window.
8. Repeat Steps 2-8 to define additional Subnets for your script.
9. To include a defined subnet in your Discover script, click on the checkbox to
the left of the subnet address in the Subnets group box. A check mark
displays in the checkbox to indicate that the subnet discovery has been
selected for inclusion in the script.
10. Define your remaining Discover script parameters as explained in the
following sections, or click OK to save your entries and return to the Discover
Manager window.
You can combine one or more IP address ranges with one or more subnets in a single
device discover script, as long as the total number of addresses to be queried in a single
script does not exceed 2000.
3-10Creating and Modifying Discover Scripts
Defining a Community Name
Once you have specified the IP addresses that will be queried during the Discover, you
must supply the discover application with one or more community names that will provide
at least Read access to the devices you wish to discover.
When a script with more than one assigned community name is executed, the Discover
application will query each address in the specified address range(s) and/or subnet(s)
using the first community name listed in the Community Names group box. If a node
responds, the other community names are not used to query that node. If there is no
response to the first query, the address is queried again using the second listed community
name. This process is repeated until a response is returned or until all listed community
names have been used to query the address. If no response is elicited from an address after
using all community names assigned to the script, the Discover application gives up on
that address, and moves on to the next one.
To select a community name for use in your Discover script:
1. To define a new community name, click New to the right of the Community
Names group box; or click the right mouse button anywhere in the
Community Names group box, and select New from the resulting menu.
To modify an existing community name, highlight the community name
that you wish to change, and click Properties; or click the right mouse button
on the community name that you wish to modify, and select Properties from
the resulting menu.
Discovering Nodes
NOTE
The Community Name Properties window (Figure 3-8) opens.
Figure 3-8. The Community Name Properties Window
If a default community name has been specified (either via the Welcome Wizard or via the
Network page of the Tools—>Options window) and the autofill function has been
activated (via the Workspace page of the Tools—>Options window), the Community
Name properties window will contain a default community name value.
2. If the Community Name: field contains a default name, it will be highlighted.
If you wish to use a different community name, type the new name into the
field.
3. Click OK to save the community name and close the window. The community
name you have entered will be listed in the Community Names group box.
Creating and Modifying Discover Scripts3-11
Discovering Nodes
4. To add another community name to your script, repeat steps 2-4.
5. Define your remaining Discover script parameters as explained in the
Selecting a Script Filter
If you would like to further refine a device discovery script, you can add one of two Script
Filters: one which restricts the discovery to Cabletron devices, and one which restricts it to
devices which respond to an SNMP query.
1. Click on the Script Filters drop-down menu; the three available filters will be
following sections, or click OK to save your entries and return to the Discover
Manager window.
displayed, as illustrated in Figure 3-9.
Figure 3-9. Script Filter Options
2. Click to select the appropriate filter:
All Devices — the script will discover and add to the central node database
all devices in the specified subnet(s) or IP address range(s) that respond to
either an SNMP or a PING query. This is the default value.
SNMP only devices — the script will discover and add to the central node
database only those devices in the specified subnet(s) or IP address range(s)
that respond to an SNMP query. Selecting this filter eliminates the discovery
of “Ping” devices.
Cabletron only devices — the script will discover and add to the central
node database only those devices in the specified subnet(s) or IP address
range(s) that respond to an SNMP query and are identified as Cabletron
devices. Selecting this filter eliminates the discovery of third-party devices.
3. Define your remaining Discover script parameters as explained in the
previous sections, or click OK to save your selection and return to the
Discover Manager window.
3-12Creating and Modifying Discover Scripts
Setting a Discover Interval
Defining a Discover Interval for your Discover script allows you to automatically start
your script and determine how often (in minutes) your script will be automatically
executed. The Discover Interval is defined using the Schedule page of the Discover
Properties window (Figure 3-10), accessed by clicking on the Schedule tab.
Once you have defined an interval and saved the script, NetSight Element Manager will
automatically execute the script, and continually re-execute it according to the defined
time interval. The script will continue to run at the defined interval until its Discover
Interval is changed to 0 (zero), the script is deleted, or the NetSight Element Manager
application is closed.
If you define a script with a Discover Interval, and then exit NetSight Element Manager,
NOTE
the script will be automatically executed the next time you start NetSight Element
Manager.
To set an interval for your Discover script:
Discovering Nodes
1. In the Discover Interval field, enter the desired number of minutes between
automatic executions of your Discover script. This interval will define the
amount of time between the beginning of one discover session and the
beginning of the next one (so be sure you define an interval that allows
enough time for each session to complete). The default value of 0 (zero)
indicates that manual execution of the script is required.
2. Define any remaining Discover script parameters, or click OK to save your
interval and return to the Discover Manager window.
Note that scheduled discovers behave a little differently than manually-executed
discovers; see The Discover Process, page 3-16, for more information.
Creating and Modifying Discover Scripts3-13
Discovering Nodes
Figure 3-10. The Schedule Page of the Discover Properties Window
Executing Discover Scripts
Once you have established the parameters for your Discover scripts, they are listed in the
Discover Manager window (as shown in Figure 3-11), and can be executed at any time.
1. In the Discover Manager window, click to highlight the name of the Discover
script to be executed, and click Execute.
or
In the Discover Manager window, click the right mouse button on the name of
the desired Discover script to reveal the Discover Manager menu, and select
Execute.
3-14Executing Discover Scripts
You can’t execute a discover script while a
Net Discover window is still open — either
because there is a discover still in progress,
or because the window was not closed
when a previous discover completed.
Figure 3-11. The Discover Manager Window
Discovering Nodes
You cannot execute a new discover session if a previous session is still running or if the
Discover window from a previous session is still open. If either of these conditions exists,
a footer message at the bottom of the Discover Manager window will indicate that a
discover is in progress (as illustrated in Figure 3-11). To clear this condition, close the
Discover Manager window, activate the Network Discover window (which may be
minimized or hidden behind the main NetSight Element Manager window), wait for the
active discover session to complete (or stop it, as described in Stopping a Discover in
Progress, page 3-17), close the Network Discover window, re-launch the Discover
Manager, and execute your new session.
When you have successfully launched a discover session, the Discover Manager window
automatically closes, and the Network Discover window (Figure 3-12, below) opens. For
more detailed information about this window and the discover process, see the following
sections.
Executing Discover Scripts3-15
Discovering Nodes
The Discover Process
Once a Discover script has been manually executed, the Discover Manager window
closes, and the Network Discover window (Figure 3-12) opens.
Figure 3-12. Network Discover Window
A discover proceeds in a single phase: each IP address in the defined address ranges
and/or subnets is queried in turn; as each response is received, information about the
responding device (including status, model, name, and IP address) appears in the Discover
window. A footer message at the bottom of the window indicates the total number of IP
addresses which will be queried during the discover session, and the number of IP
addresses which remain to be contacted.
When the Discover process is complete, all discovered devices which match the
configured criteria are automatically added to NetSight Element Manager’s central node
database. A progress indicator shows the status of this automatic integration; the Discover
window also remains open after the discover is complete, allowing you to view the list of
discovered nodes.
3-16The Discover Process
NEW and SECONDARY Discovers
Discovery sessions are divided into two types: NEW and SECONDARY. The first time
you run a device discover script, all IP addresses in the subnet or address range you have
specified will be queried, and all discovered devices will be listed in the discover window
and automatically added to the central node database. This is called a NEW Discovery.
The second time you run any device discover, however — even a device script which has
not yet been run — NetSight Element Manager will perform a SECONDARY Discover,
querying only those IP addresses which did not respond to the first discover.
When a NEW Discovery is performed, new information which may be discovered about an
TIP
IP address will not overwrite the information about that address which is currently in the
central node database. For example, if an IP address previously assigned to an EMME is
moved to a SmartSwitch 6000, the discover application does not record this change in the
database.
Stopping a Discover in Progress
1. Select File—>Exit from the Network Discover window’s menu bar.
Discovering Nodes
or
Click the close button in the upper-right corner of the Network Discover
window. A message window like the one illustrated in Figure 3-13 opens.
Figure 3-13. Cancel Discover Confirmation Window
2. Click Yes to stop the discover and add any discovered nodes to the database;
click No to stop the discover without adding any partial results to the
database; or click on Cancel to continue the discover.
Restarting a Completed Discover
You can also re-start a completed discover from the Discover window; note that this will
launch the selected script in SECONDARY discover mode, unless the discover counter
has been reset.
1. In the Network Discover window, select File—>Rediscover. The original
discover script will be re-launched, in SECONDARY discover mode.
The Discover Process3-17
Discovering Nodes
Re-starting a completed discover script from the Network Discover window has the same
effect as re-executing the script from the Discover Manager window.
Scheduled Discovers
A scheduled discover script — one which launches automatically at selected intervals —
behaves a little differently than a manually-executed script. Once a scheduled discover is
complete, the Network Discover window will close automatically; you need not close it
manually, as with a normally-executed script. (In fact, the Network Discover window for a
scheduled discover is minimized by default, so it is only visible if you choose to view it.)
If you have left a manually-executed discover window open, a scheduled discover will
close this window for you so that it can execute. And if a manually-executed script is still
in progress when a scheduled discover interval expires, the scheduled discover will wait
the length of the interval before it attempts to launch again.
You can also schedule discover sessions at specific dates and/or times via the Scheduler
TIP
application; see the Too ls G u id e for more information.
Deleting a Discover Script
1. In the Discover Manager window, highlight the name of the Discover script to
be deleted, and click Delete.
or
In the Discover Manager window, right-click on the name of the Discover
script to be deleted, and select Delete from the resulting menu.
A delete confirmation window (Figure 3-14) opens.
Figure 3-14. The Script Deletion Confirmation Window
2. Click Yes to confirm the deletion. The script will be removed from the
Discover Manager window.
3-18Deleting a Discover Script
Starting the Discover Wizard
To use the Discover Wizard to create a new Discover script:
1. In the Discover Manager window, click Wizard.
or
Click the right mouse button anywhere in the Discover Manager window,
select Wizard from the resulting menu.
To use the Discover Wizard to modify an existing Discover script:
1. In the Discover Manager window, highlight the name of the script that you
wish to modify, and click Wizard.
or
Click the right mouse button on the name of the script that you wish to
modify, and choose Wizard from the resulting menu.
Follow the directions in the Wizard to create or modify a discover script.
Discovering Nodes
Launching the Scheduler Application
Once you have created your Discover scripts, you can use the Scheduler application to
automatically execute selected scripts at scheduled times and dates. To launch the
Scheduler application from the Discover Manager window:
1. Click Scheduler.
or
Click the right mouse button anywhere in the Discover Manager window, and
choose Scheduler from the resulting menu.
For more information about using the Scheduler application, consult the Tools Guide,
included with your documentation.
Using the IP or Host Locator Tool
The IP or Host Locator Tool serves as an adjunct to the Discover functionality. Its primary
function is to resolve host names to IP addresses, and vice versa; it can also resolve host
names to IP addresses for an entire subnet, locate the MAC address associated with a
matched host name/IP pair, and locate both the host name and IP address for a given MAC
address.
To launch the IP or Host Locator Tool:
1. Select Tools —>Host/IP Locatorfrom the primary window menu bar.
Starting the Discover Wizard3-19
Discovering Nodes
or
Click the IP or Host Locator button () on the NetSight Element Manager
Standard toolbar.
The IP or Host Locator window, Figure 3-15, opens.
By default, the IP,
Host, and Get MAC
Address fields
display the values
assigned to your
workstation
Figure 3-15. The IP or Host Locator Window
The following sections describe some common uses for this tool. Note that multiple
instances of the IP or Host Locator tool can be run simultaneously, allowing you to
perform more than one lookup task at a time.
Matching a Host Name to an IP Address
To use the Locator Tool to locate the IP address associated with a known host name:
1. Click Clear to clear the default values from the IP and Host fields.
2. In the Host field, enter the host name of the device whose IP address you
wish to locate.
3. If you wish to ping the device once its IP address is located, click to select the
Ping found devices option; in the text field provided, specify a timeout
period, in seconds. If the device does not respond to the ping request within
the specified timeout, the ping will be considered to be unsuccessful.
4. Click on Update, or press Enter on the keyboard. If the host name can be
resolved, its associated IP address will be displayed in the IP address fields; if
you have selected the Ping option, a message window will indicate the
success or failure of the ping attempt. If the host name cannot be resolved, a
message window appears, indicating that the selected host name could not
be found.
3-20Using the IP or Host Locator Tool
Once located, IP addresses can be copied (using the right-mouse edit menu or Ctrl-C on
TIP
the keyboard) and pasted (via Edit—>Paste) into the Insert Device window for addition to
the central node database. For more information about inserting devices individually, see
Chapter 4, List Views.
Matching an IP Address to a Host Name
You can also use a known IP address to locate a device’s host name. To do so:
1. Click Clear to clear the default values from the IP and Host fields.
2. Enter the IP address of the device whose host name you wish to locate in the
IP or Full IP field.
3. If you wish to ping the device once its host name is located, click to select the
Ping found devices option; in the text field provided, specify a timeout
period, in seconds. If the device does not respond to the ping request within
the specified timeout, the ping will be considered to be unsuccessful.
4. Click on Update, or press Enter on the keyboard. If the IP address can be
resolved, its associated host name will be displayed in the Host field; if you
have selected the Ping option, a message window will indicate the success or
failure of the ping attempt. If the IP address cannot be resolved, a message
window appears, indicating that the selected IP could not be found.
Discovering Nodes
Locating the MAC Address for a Host Name/IP Pair
Once you have resolved a host name/IP pair, you can use the Get MAC address button to
locate the device’s MAC address.
1. Enter an IP or host name in the appropriate field, and click Update to resolve
the pair.
2. Click on Get MAC address. The MAC address associated with the IP/Host
pair will be displayed in the text box to the right of the button.
You cannot use an IP or host name alone to retrieve a MAC address; you must first resolve
the pair to activate the Get MAC address button.
If you have a MAC address and wish to find the associated IP and/or host name, use the
TIP
MAC Search feature described in Matching a MAC Address to a Host Name and IP,
beginning on page 3-25.
Using the IP or Host Locator Tool3-21
Discovering Nodes
Subnet Search
You can also use the Locator Tool to locate (and ping, if desired) all IP addresses on a
subnet or a portion of a subnet, resolve host names to the located IP addresses, and resolve
MAC addresses to the located IP/hostname pair. To do so:
1. Click Clear to clear the default values from the IP and Host fields.
2. In the IP field, enter the appropriate bytes of the subnet address:
To search an entire subnet, enter the first three bytes of the subnet address;
To search a portion of a subnet, enter the first three bytes of the subnet
address; in the fourth byte field, enter the IP at which you want the search to
start.
3. If you have chosen to search only a portion of a subnet, click to select the
Start subnet/MAC search using 4th numeric IP value shown above
option. A check mark opens in the selection box.
4. Because searching an entire subnet can be time-consuming, you can
configure the Locator Tool to stop at pre-defined intervals, asking if you want
to continue the search. To activate this option, click to select Prompt every XX devices, and use the text field provided to enter the number of devices
that will be located between prompts. The default value is 10.
TIP
Once the search begins, a Stop Searching button will also appear, allowing you to stop
the search at any time.
5. If you wish to ping each found device once it is located, select the Ping found
devices option; in the text field provided, specify a timeout period, in seconds.
If a device does not respond to the ping request within the specified timeout,
the ping will be considered to be unsuccessful.
6. For the quickest Subnet search, click to select the Do not resolve host names during subnet search option. This kind of search will locate only IP
addresses (and ping them if you have selected that option); no host name or
MAC resolution will take place. Note that selecting this option inactivates the
Identify MAC address option described in the next step.
7. For the most detailed Subnet search, click to select the Identify MAC addresses during search option. Though time-consuming, this subnet
search gives you complete IP, host, and MAC resolution for all devices in the
subnet (or subnet portion) you have specified.
8. Click Subnet to start the search. The Locator window will expand (see
Figure 3-16) to display a list box containing the results of the search. A Stop
Searching button will also appear just above the list box; click this button at
3-22Using the IP or Host Locator Tool
If you have
selected the
Prompt option,
a message
window like
this one opens
at the defined
interval.
Discovering Nodes
any time to stop a search in progress. If you have selected the Prompt option,
a message window opens at the selected interval, asking if you want to
continue the search. Click Yes to continue, or No to stop.
Click here to
stop a search
in progress at
any time.
Search results are
displayed here.
Figure 3-16. A Subnet Search in Progress
If you have selected the Identify MAC address and/or Ping options, these results will
also be displayed in the list box. If no device is found at a specified IP address, question
marks (???) display in place of a host name.
Once the search is complete, five buttons display just above the list box display (see
Figure 3-17): Select All, Copy IPs, Copy Unnamed IPs, Copy Pinged IPs, and Copy
Unpingable IPs.
Using the IP or Host Locator Tool3-23
Discovering Nodes
NOTE
Figure 3-17. Completed Subnet Search
You can use these buttons to copy one, several, or all discovered IP addresses to the
clipboard for pasting into the central node database or any text document:
1. Click Select All to select all discovered IP addresses, or click and drag with
your mouse to select a contiguous portion of the discovered address list.
or
Click Copy Unnamed IPs, Copy Pinged IPs, or Copy Unpingable IPs to
select specific groups of IPs. (Note that these buttons only activate when IPs
of the noted kind are displayed in the list box.)
2. Click Copy IPs to copy the selected IP addresses to the clipboard. Use any
Paste command as usual to copy the contents of the clipboard into a text or
other document, or use Edit—>Paste from the primary window menu bar to
sequentially paste the copied IP addresses into a series of Insert Device
windows for addition to the central node database.
Only the located IP address is copied during the Copy IPs process; no additional
information, though highlighted in the list box display, is copied to the clipboard.
3-24Using the IP or Host Locator Tool
Matching a MAC Address to a Host Name and IP
You can also use a known MAC address and subnet location to locate the associated IP
address and host name. To do so:
1. Click Clear to clear the default values from the IP and Host fields.
2. In the IP field, enter the appropriate bytes of the subnet address:
To search an entire subnet, enter the first three bytes of the subnet address;
To search a portion of a subnet, enter the first three bytes of the subnet
address; in the fourth byte field, enter the IP at which you want the search to
start.
3. If you have chosen to search only a portion of a subnet, click to select the
Start subnet/MAC search using 4th numeric IP value shown above
option. A check mark displays in the selection box.
4. Because searching an entire subnet can be time-consuming, you can
configure the Locator Tool to stop at pre-defined intervals, asking if you want
to continue the search. To activate this option, click to select Prompt every XX devices, and use the text field provided to enter the number of devices
that will be located between prompts. The default value is 10.
Discovering Nodes
TIP
Once the search begins, a Stop Searching button will also appear, allowing you to stop
the search at any time.
5. Click MAC search, and enter the MAC address whose IP and host name you
wish to find in the window which appears (see Figure 3-18).
Figure 3-18. MAC Search Window
6. Click OK to start the search. The Locator window will expand (see
Figure 3-19) and a Stop Searching button displays just above the list box;
click this button at any time to stop a search in progress. If you have selected
the Prompt option, a message window opens at the selected interval, asking
if you want to continue the search. Click Yes to continue, or No to stop.
Using the IP or Host Locator Tool3-25
Discovering Nodes
TIP
When the MAC
address is found, a
message window
displays its associated
IP address and host
name; the information
will also appear in the
list box.
When the selected MAC address is located, a message window will display, indicating the
host name and IP address associated with the found MAC; this information will also be
displayed in the list box. If the address is not located, a message window opens when the
search is complete, indicating that the selected address could not be found.
You can use the Copy IP buttons to paste any located IP addresses to any text document;
you can also paste found IPs directly into the central node database via the Edit—>Paste
command. See page 3-24 for more information.
If the MAC address could
not be found, a message
window like this one will
be displayed when the
search is complete.
Figure 3-19. Find MAC Address Search
3-26Using the IP or Host Locator Tool
Using the Subnets Window
With the Subnets window, you can define and view subnet entries which can be used in
Discover scripts. The Subnets window is accessed by selecting View—>Subnets from the
NetSight Element Manager primary window menu bar. Any subnet entries that appear in
the Subnets window will also appear in the Subnets group box on the Device page of the
Discover Properties window, and vice versa (see Defining and Selecting Subnets,
page 3-7).
The Subnets window will list subnet entries for any subnet on which an IP or Subnet
Discovery has been previously performed. For example, if you have previously performed
an IP Discovery using the IP Address range of 132.177.118.0 —> 132.177.118.100, the
Subnets window will contain an entry for the 132.177.118.0 subnet (assuming that this is a
Class B network, with a subnet mask of 255.255.255.0).
If you have manually added a device to a view or a map, a subnet entry will be listed for
that device’s subnet as well. For example, if you manually add a device with an IP address
of 132.177.118.24 to any of your views or maps, the Subnets window will contain an entry
for the 132.177.118.0 subnet (assuming that this is a Class B network, with a subnet mask
of 255.255.255.0).
Discovering Nodes
TIP
This subnet information is used to determine the map hierarchy created via the automatic
subnet mapping feature; for more information on this feature, see Generating Submaps
Automatically in Chapter 6, Creating Network Maps
When defining subnet entries using the Subnets window, you use the same Subnet
Properties window that is used in the Discover application when defining subnets for use
in a Discover script.
To launch the Subnets window from the NetSight Element Manager primary window:
1. Select View—>Subnets from the primary window menu bar. The Subnets
window, Figure 3-20, opens.
Using the Subnets Window3-27
Discovering Nodes
Figure 3-20. The Subnets Window
The Subnets window displays entries for all manually-defined (via this window or the
Discover application) subnets; if you have manually added a node to the central node
database, a subnet entry will be listed for that node’s subnet as well.
Each subnet entry will be listed with its name, description, the network and subnet
portions of its IP Address, its subnet mask, and count of the nodes in the central node
database that reside on that subnet. A subnet’s name, description, and address are all
defined using the Subnet Properties window. Automatically-created subnet entries are
named with their IP address by default; no default description is provided.
Note that the Nodes value displayed here does not have the same meaning as the Nodes
TIP
value displayed in the Subnet Properties window (Figure 3-6, page 3-8); that value
indicates the maximum number of nodes that could be included in a subnet defined by the
given subnet mask, and does not indicate how many nodes on a specific subnet have been
added to the central node database.
Creating and Modifying a Subnet Entry
To create a new subnet entry or modify an existing one:
1. To define a new subnet, click New; or click the right mouse button
anywhere in the Subnets window, and select New from the resulting menu.
To modify an existing subnet, highlight the subnet entry that you wish to
change, and click Properties; or click the right mouse button on the subnet
entry that you wish to modify, and select Properties from the resulting menu.
The Subnet Properties window (Figure 3-7, page 3-10) opens.
3-28Using the Subnets Window
2. Follow the steps outlined in Defining and Selecting Subnets, beginning on
page 3-7. The procedure for defining and modifying subnet entries is the
same from this window or when configuring a discover script.
3. Click OK to save your subnet discovery parameters and exit the Subnet
Properties window. The name, description, address, and subnet mask of the
defined subnet opens in the Subnets window.
Deleting a Subnet Entry
Deleting a subnet entry will not delete that subnet’s nodes from NetSight Element
NOTE
Manager’s central node database.
1. In the Subnets window, highlight the name of the subnet(s) to be deleted, and
click Delete.
Discovering Nodes
TIP
or
In the Subnets window, click the right mouse button on the subnet to be
deleted, and select Delete from the resulting menu.
The selected subnet entry will be deleted from the Subnets window, as well as from the
Subnets group box on the Device page of the Discover Properties window (see Defining
and Selecting Subnets, page 3-7, for more information).
If you delete a subnet entry from either the Subnets window or from the Subnets group box
on the Device page of the Discover Properties window, that subnet will not be included in
any automatic subnet mapping that takes place. See Generating Submaps Automatically
in Chapter 6, Creating Network Maps, for more information on subnet mapping.
Using the Subnets Window3-29
Discovering Nodes
3-30Using the Subnets Window
Chapter 4
List Views
Using list views to view node information; using the List View workspace; creating and editing list
views; changing the appearance of your list views; excluding nodes; adding network elements to the
node database; editing node properties
NetSight Element Manager stores information about all discovered or manually-inserted
devices in one place: its central node database. This information can be viewed in a wide
variety of customizable ways via List Views, Tree Views, and Maps.
About List Views
One of the ways NetSight Element Manager allows you to see, organize, and work with
the nodes in your database is through List Views. List Views, as their name implies,
display the contents of your central node database in a collection of lists. These lists can be
configured in a variety of ways: you can choose the information about each node that you
wish to display, the order in which that information will be displayed, and the font used to
display it; you can also choose which nodes you wish to display in a list by configuring a
filter which selects or omits nodes based on the characteristics you choose. Specific nodes
can also be excluded from individual List Views, while remaining present in the central
node database. List Views provide enormous flexibility in the display of your central node
database without altering its contents.
NetSight Element Manager provides you with several default list views, including a
read-only view called the All Nodes List View, which always displays the entire contents
of your central node database. Each List View can be accessed and (where appropriate)
edited via the List View Workspace; the workspace also allows you to create new list
views, and organize your views via folders.
The List View Workspace
Using the List View workspace you can access and edit existing views, create new ones,
and organize your views by arranging them in a hierarchy of folders.
4-1
List Views
Click on this tab to bring the
List View Workspace into
view.
Indicates the folder
contains one or more list
views. Click on the folder
to expand and view the
contents of the folder.
Indicates the folder is
expanded and all the
contents are displayed.
Figure 4-1. Getting Around the List View Workspace
The default views provided with NetSight Element Manager are arranged in a series of
folders which group them by type. All of these default views — except the read-only All
Nodes List View — can be edited or deleted; you can also add additional views to each of
the default folders, or empty the folders and remove them entirely.
Adding a Folder to the Workspace
As a means of organizing a collection of List Views, you can add folders to the List View
page of the workspace; each folder you create will be contained within the base List
Views folder, and each can contain one or more list views, as well as additional folders.
Note that folders are a workspace display convention only, and they can only be created
from within the workspace itself.
These menus are
available by
right-clicking on the
appropriate folder
(above) or view (below).
To create a folder:
1. Display the List View page of the workspace by clicking on the tab in
the Workspace View.
2. Click the right mouse button on the folder to which you want to add a new
folder; that folder will be highlighted (as illustrated in Figure 4-2), and a menu
opens.
To add a folder at the top level of the List View hierarchy, click to select the main List
TIP
Views folder.
4-2About List Views
Click the right mouse
button on the appropriate
folder to add a new folder
beneath that selection in
the hierarchy.
Figure 4-2. Adding a New Folder to the List View Workspace
3. In the resulting menu, click to select New Folder. A new folder will
automatically be added in the branch you have selected.
Renaming a Folder
List Views
By default, all new folders are named with the designation New Folder X, where X
represents a sequential index; you can rename your folders, as follows:
1. Click once to highlight the folder whose name you wish to change, then after a
brief pause click again. The folder name will be enclosed in an editable text
box (as illustrated in Figure 4-3), and the existing name will be highlighted.
2. Click again to place the cursor anywhere in the name, and edit as desired; or,
simply begin typing to replace the highlighted text entirely.
3. Press Enter to set your change.
The All Nodes List View
Figure 4-3. Changing a Folder Name
The All Nodes List View provides the most comprehensive look at the contents of your
central node database. This special default view will always appear at the root of your List
View hierarchy (as displayed in the List View workspace), and cannot be edited or
deleted; by design, it displays information about every node in the central node database.
About List Views4-3
List Views
Figure 4-4. The All Nodes List View
The All Nodes List View display includes 11 of the 13 possible descriptive columns
available, including Status, Model, Name, Logical Address, Physical Address, Time of
Last Contact, System Up Time, Enterprise, Classes, Topologies, and Status Group; Label
and Event information is omitted (but can be selected for other views). As with the other
List Views, the contents of the All Nodes List View can be sorted by any one or more of
the available columns, and its display format can be changed; the nodes which are
displayed (and the information which is displayed about them), however, cannot.
In addition to changing the arrangement of information in the All Nodes List View, the
TIP
one other feature you can edit is the font used to display list view information. For more
information about changing fonts on this and other list views, see Selecting a Display
Font, page 4-14.
Other Default List Views
In addition to the All Nodes List View, a variety of other default views — organized in
folders by type — is also provided; these views can be used as is, edited to better suit your
needs, or deleted entirely. Each of these views includes a pre-set filter which excludes all
nodes not of the type specified by the view’s name.
Default views provided are:
Class Views
The default class views filter devices based on their functional class, displaying only those
devices which provide the noted functionality: ATM (the ATM View), bridging (the
Bridges View), FDDI (the FDDI View), repeating (the Repeaters View), routing (the
Routers View), or switching (the Switches View). Devices which belong to more than one
of these functional classes will be displayed in all appropriate views.
4-4About List Views
Device Views
A single default Device View — the All Devices View — displays all IP devices.
Enterprise Views
A single default Enterprise View allows you to display only your Cabletron and Enterasys
devices.
Topology Views
Two default topology views filter out all devices that do not provide Ethernet (Ethernet
View) or Token Ring (Token Ring View) topology support.
List View Display Options
In addition to selecting both the nodes and the information about those nodes that will be
displayed, you can also select the arrangement of this information in a selected list view
window. These display format options apply to all views, including the All Nodes List
Vie w.
List Views
Using the List View Toolbar
The appearance of the list views you create can be changed according to which
information needs to have priority in the view, and how you want it displayed. The List
View toolbar — and the associated options available via the primary window View menu
— will enable you to change the size and amount of information displayed in your list
view by choosing one of four display options:
Large Icon Format(View—>Large Icon) The nodes are represented by
Small Icon Format(View—>Small Icon) The nodes are represented by
Figure 4-5. The List View Toolbar
large model icons with labels below them, labeled and
sorted by assigned Name (sysName by default). Icons
are arranged in rows and sorted left to right and top to
bottom.
small model icons with their labels to the right,
labeled and sorted by assigned Name (sysName by
default). Icons are arranged in rows and sorted left to
right and top to bottom.
About List Views4-5
List Views
Small Icon Detail Format(View—>Small Icon Detail) Each node appears as a
line in a multicolumn format. The columns consist of
the information you have chosen to display from the
List View Properties window (or the default columns,
in the case of the All Nodes List View), in the order
you have specified there. For each displayed
information type which includes an icon, the small
(16x16 pixel) graphic will be displayed. This is the
default view format; it will be applied each time
NetSight Element Manager is launched.
Large Icon Detail Format(View—>Large Icon Detail) Each node appears as a
line in a multicolumn format. The columns consist of
the information you have chosen to display from the
List View Properties window (or the default columns,
in the case of the All Nodes List View), in the order
you have specified there. For each displayed
information type which includes an icon, the large
(32x32 pixel) graphic will be displayed.
Any change made to the display format is applied to the currently selected view for the
duration of the current NetSight Element Manager session or until another View selection
is made; once NetSight Element Manager is closed and re-opened, however, all views will
revert back to the default Small Icon Detail format.
Sorting Nodes
TIP
The List View toolbar also contains the Find icon:
FindThis feature allows you to search for a specific node
in a List View by any of its associated information;
see Searching a List View, page 4-7, for more
information on this feature.
By default, List Views displayed in the Small Icon Detail and Large Icon Detail formats
described above are sorted in Logical (IP) Address order. However, these views can also
be re-sorted by the information in one or more columns. Text fields are sorted
alphabetically, numeric fields are sorted numerically, and mixed fields are sorted
alpha-numerically; Enterprise, Classes, and Topology values are sorted numerically by
assigned identifiers rather than alphabetically by group name.
If Status is selected as a sort column, the sort will update automatically as necessary.
Sorting is accomplished by clicking on the column heading button for the information you
wish to sort by. Clicking on the same column heading more than once alternately sorts the
selected information in ascending and descending order; clicking on more than one
column heading creates a multi-level sort. The current sort order is indicated by a number
4-6About List Views
List Views
and a greater-than or less-than sign displayed in the selected column settings: a
greater-than sign (>) indicates that the information in the associated column is sorted in
ascending order; a less-than sign (<) indicates that the information is sorted in
descending order. You can choose as many levels as you want for your sort, and you can
mix ascending and descending sorts in different columns. To return the view to the default
sort order, select the Reset Sort Order option available on the right-mouse menu.
Figure 4-6, below, illustrates the default (Logical Address) sort order, and the same view
with a multi-level sort applied. Note that the multi-level sort mixes ascending and
descending orders in the different columns.
By default, List Views are sorted in
Logical (IP) Address order; if you
wish, you can also apply a
multi-level sort, selecting the
columns whose information you
wish to sort by, and toggling each
column’s sort between ascending
and descending order.
Figure 4-6. Sorting Nodes
Searching a List View
Using the Find feature, you can search a List View for any value displayed in its columns.
The Find window will search the contents of the active List View for a text string (with
options for searching a partial string and for case sensitivity), or for a specific value
displayed in a selected column type. You can also search upwards or downwards from
your current position, and choose to continue the search when the top or bottom of the
displayed view is reached.
About List Views4-7
List Views
To access the Find window:
1. Open or activate the List View that you wish to search.
2. Select Edit—>Find from the primary window menu bar.
or
Click on the List View toolbar.
The List View Find window, Figure 4-7, opens.
Use this text box to enter a string you wish
to match in any available List View column.
You can specify a case-sensitive search, or
allow for a
partial match
of the string.
If you select a specific column to search, use this
drop-down list to select which of the available
strings to search for.
The status bar displays the type
of search currently in effect.
Figure 4-7. List View Find Window
You can perform two different kind of searches with this window: you can enter any text
string you wish to match fully or partially in any column (using the top text box); or you
can search for any one of the available values in a selected column (using the lower text
box).
To search for a value in ANY column:
1. In the Column to search list box, make sure the All columns option is
selected.
4-8About List Views
List Views
2. In the Text to find (in ANY column) text box at the top of the window, enter
the string you wish to match. Note that this field will not be available unless
the All columns option is selected in the Column to search list box. For your
convenience, the ten most recent search strings will be listed in a drop-down
menu.
3. To make your search case-sensitive, click to deselect the Any case option in
the lower right corner of the window. To match any case, leave the option
selected.
4. If you want your search string to be matched as a whole word, click to
deselect the Partial option. If you want to allow a partial match, leave the
option selected.
5. Use the Direction options to specify whether to search Up or Down from the
entry currently selected in the active List View. Whichever direction you
choose, you will be given the opportunity to start over when the top or bottom
of the list is reached.
6. Click on Find Next to begin the search. Each match will be highlighted as it is
found; to find additional matches, click on Find Next again.
or
Click on Select All to immediately highlight all matches.
If the selected value is not found, a message window will notify you of the failure.
To search for a value in a SELECTED column:
1. In the Column to search list box, click to select the column whose values you
wish to search. You can restrict your search to any one of the following
columns, as long as it is displayed in the active List View: Logical Address,
Model, Name, Physical Address, Status Group, System UpTime, and
Time of Last Contact.
2. Click on the arrow to the right of the Available values (in SELECTED
column) field to select the value you wish to search for. All values which
appear in the selected column will be available for your search; these are the
only values that can be used for this kind of search. Note that this field will not
be available if the All columns option is selected in the Column to search
list box.
3. Use the Direction options to specify whether to search Up or Down from the
entry currently selected in the active List View. Whichever direction you
choose, you will be given the opportunity to start over when the top or bottom
of the list is reached.
4. Click on Find Next to begin the search. Each match will be highlighted as it is
found; to find additional matches, click on Find Next again.
or
Click on Select All to immediately highlight all matches.
About List Views4-9
List Views
Creating and Editing List Views
You can create a variety of list views customized to meet your network management
needs, either by editing any of the default views provided (except the All Nodes List
View) or by creating entirely new views. User-defined filter criteria allow you to select
which nodes will be displayed; List View display properties allow you to select which
information about those nodes will be displayed.
To create a new list view:
1. Select Window —> New List View from the primary window menu bar.
or
Click on the toolbar.
or
In the List View Workspace, click the right mouse button on any folder or in
any blank area, and select New View from the menu that appears.
The New List View window, Figure 4-8, opens.
The Columns
check list allows you
to choose which
attributes are
displayed in the list
view; you can also
change the order in
which this
information will be
displayed. For more
information, see
Selecting Node
Information to
Display, page 4-11.
Figure 4-8. The New List View Window
4-10Creating and Editing List Views
NOTE
List Views
When you add a new list view by any of the means described above, it will be added to the
folder which is currently selected in the List View workspace; if you add a list view by
right-clicking in a blank area of the workspace, the new view will be added to the root
folder. Once a List View has been added, it cannot be moved from folder to folder. All
folders and views are listed in the workspace in alphabetical order.
To edit an existing list view:
1. With the appropriate list view open and selected in the NetSight Element
Manager primary window, select View —> Properties from the primary
window menu bar.
or
In the List View Workspace area, click the right mouse button on the name or
icon associated with the view you wish to edit, and select Properties from the
resulting menu.
or
Click with the right mouse button anywhere in the view you wish to edit, and
select List View Properties from the resulting menu.
The List View Properties window will be displayed.
The procedures for creating a new List View and editing an existing one are virtually
identical; they are described in the following sections.
If you open the List View Properties window for the All Nodes List View, note that all
NOTE
fields are grayed out; remember, the only thing you can change about this view is the font
in which its information is displayed. See Selecting a Display Font, page 4-14, for more
information.
Selecting Node Information to Display
The main List View Properties window allows you to assign or change the name of your
list view, select the information that will be displayed for each node, and select the order
in which it will be displayed.
To set up or modify a list view:
1. By default, a new list view will be named New List View X, where X will
increment sequentially as necessary to provide a unique name. To change
this default (or the original name assigned to any view), highlight the text in
the Name field and delete, then enter a new name.
Creating and Editing List Views4-11
List Views
TIP
2. In the Columns list box, click to select the information you’d like displayed
about each node in the view; click again to deselect any option you do not
wish to view. Each selection in this list will add a column of information to your
list view. Each of the available options is described below; you must select at
least one column to create or save your view.
You can also use the Select All and Unselect All buttons to select or deselect all available
column options.
3. The column options you have selected display in the list view in the same
order they are listed in the Columns field; to change this order, click to select
the option you want to move, and use the Move Up and Move Down buttons
to change its position as necessary. Repeat to order all selected options as
desired.
A list view configured in this way will display the information you have selected for all
nodes in the central node database, using the default display font. To change the node
types that will be included in your view, use the Filters option (described in Selecting the
Nodes to Display: Using Filters, page 4-15); to change the display font, use the Font
option (described in Selecting a Display Font, page 4-14).
For more information about the view-specific Excluded Nodes list displayed at the bottom
TIP
of the List View Properties window, see Excluding Nodes from an Individual View,
page 4-18.
Node Information Options
List views can include up to 13 columns of information about the nodes they display.
Information available for display includes:
Status
Indicates the status of NetSight Element Manager’s contact with the node. The possible
states are:
•Critical (Red) - The node is in critical condition; it is no longer in contact with
NetSight Element Manager.
•War ning (Yellow) - The status icon turns yellow to indicate that NetSight Element
Manager has received a trap from the represented node; the icon will remain yellow
until the trap is acknowledged.
If any node in your central node database is in a Critical or Warning state, this status
TIP
condition will be propagated right up to your desktop via the minimized NetSight Element
Manager icon — the Task Bar icon representing NetSight Element Manager will change
from the inactive window title bar color to the active window title bar color.
4-12Creating and Editing List Views
List Views
•Unknown (Blue) - A blue status icon indicates that NetSight Element Manager has not
yet been able to contact the represented node, and has not yet determined whether or
not that contact will be successful. A node icon is blue only temporarily, while
NetSight Element Manager determines whether or not contact can be made: if contact
is successfully made, the icon will turn green; if not, it will turn red. Performing an
individual node status query (using the Manage—>Query Status option from the
primary window menu bar, or the Query Status option available from the right-mouse
menu) will temporarily turn a node status icon blue, while the status query is being
made.
•Normal (Green) - NetSight Element Manager is successfully communicating with the
represented node, and the node is operating properly on the network. Green is also the
default color for a map icon which is not currently associated with an IP address.
•Undefined (Gray) - A gray status icon for a node indicates that polling has been
disabled, and the node’s current status is not known.
Name
This column displays the user-defined name of the node. You can assign a name for the
node in the General properties page in the Device Properties window. By default, devices
will display any configured MIB II sysName value.
NOTE
Note that changing a node’s name via its Properties window changes only the
information in NetSight Element Manager’s central node database; no name changes are
set at the device. If you wish to leave the MIB II sysName displayed, and assign an
additional label, use the Label field described below. For more information on
configuring node properties — including setting both Name and Label values — see
Editing Device Properties, page 4-29.
Label
Displays a user-set alias for a node; no default label is provided.
Logical Address
Displays the IP (Internet Protocol) address for devices.
Physical Address
Displays the MAC address for devices.
Time of Last Contact
Lists the date and time of NetSight Element Manager’s last successful contact with the
node.
System Up Time
The length of time the device has been operating since its last boot up, displayed in a days,
HH:MM:SS format.
Creating and Editing List Views4-13
List Views
Status Group
If the device is part of a Distributed LAN Management status group, it will be indicated
here. Both the name assigned to the DLM group and the node’s position in that group
(“DLM Agent” or “DLM Client of (IP Address)” ) will be displayed. For more
information on configuring and using Distributed LAN Management functions, see the
DLM Status Groups chapter in the NetSight Element Manager Tools Guide, included
with your document set.
Model
Indicates the model name of the device, along with the icon which represents that model
type.
Classes
Displays the functional classes supported by the selected node (Router, Bridge, Switch,
ATM, etc.), represented by the appropriate class icon(s).
Enterprise
Displays the enterprise, or vendor — Cabletron, Enterasys, etc. — which manufactured
the selected node.
Topologies
Displays the topology (or topologies) supported by the node.
Events
Indicates whether or not the Alarm and Event log has received traps and/or events related
to the node.
Selecting a Display Font
The Font Window allows you to select the font style and size for any displayed text. You
can change the font setting for any list view, including the otherwise-uneditable All Nodes
List View.
1. Click on Font from the appropriate New List View or List View Properties
window. The Font window, Figure 4-9, opens.
4-14Creating and Editing List Views
Figure 4-9. Font Window
List Views
Change your font settings as desired using the Fonts, Font Style, and Size fields, then
click on OK to set your changes.
Selecting the Nodes to Display: Using Filters
Using the View Filter window, you can set up filters that determine which of the nodes
stored in the central node database will be displayed in your list view. You can filter nodes
based on specific Subnet, Status Group, Enterprise, Class, and/or Topology attributes.
With the exception of the All Nodes List View, the default views provided by NetSight
NOTE
Element Manager were created with the use of filters. For example, the Cabletron
Devices View filters out all devices except Cabletron and Enterasys devices.
Remember, you can edit any of the default views except the All Nodes List view; the
default views can also serve as models to help you create your own custom views.
To open the View Filter window:
1. Click on Filter from the New List View or List View Properties window. The
View Filter window, Figure 4-10, opens.
Creating and Editing List Views4-15
List Views
The check boxes above
the filter categories allow
you to either select or
de-select all of the specific
attributes listed. You must
leave at least one attribute
selected in each category.
Figure 4-10. View Filter Window
Filter Categories
TIP
Available filter categories are:
Subnets
NetSight Element Manager automatically creates a subnet entry each time a node is added
to the database; subnet entries can also be defined via the Discover application and/or via
the View—>Subnets option in the primary window menu bar. All subnets which have
been created will be displayed in this list box; use this list to select the subnets whose
nodes you wish to display in your list view.
See Chapter 3, Discovering Nodes, for more information on creating and using subnet
entries.
Status Groups
Any DLM Status Groups you have created will be displayed in this list box. You can
choose to display only those nodes which are part of one or more selected status groups, or
those which are part of any defined status group.
Enterprises
The Enterprise category allows you to filter nodes by hardware or software manufacturer.
The vendor codes available for filtering are Cabletron, 3Com, Cisco Systems, Novell,
Silicon Graphics, IBM, Sun Microsystems, Hewlett-Packard, Microsoft, Xyplex, Cayman,
Digital, Compaq, and Enterasys. You can also choose to filter on nodes whose vendor
code is unknown.
4-16Creating and Editing List Views
List Views
Classes
Lists the functional classes that NetSight Element Manager can detect. Classes available
for filtering include:
• Repeater• Router• Generic Bridge
• Router/Gateway• Ethernet/Token Ring Bridge• Switch
• Ethernet/FDDI Bridge• Ethernet/WAN Bridge• PBX
• Multi-Topology Bridge• FDDI Concentrator• Terminal Server
• Server• ATM
Nodes which support more than one functional class will be displayed in any view for
which one of its classes is selected. You can also choose to filter on nodes whose
functional class is unknown.
Topologies
Lists the topologies that NetSight Element Manager will recognize. Topologies listed
include:
• Proprietary PPP Serial• SMDS Intercarrier Interface• Other
Creating and Editing List Views4-17
List Views
Creating the Filter
TIP
As with classes, nodes which support more than one topology will be displayed in any
view for which one of its topologies is selected. You can also choose to filter on nodes
whose topology is unknown.
When you create a filter, you select the specific attributes in each category that define the
nodes you want to display, and de-select the attributes that define nodes you do not want
to display. Filter categories are linked by logical ANDs, and attributes within categories
are linked by logical ORs; this means that, in order to be displayed in a filtered view, a
node must match at least one selected attribute in each category. You must leave at least
one attribute selected in each category.
To specify a view filter:
1. In each filter category list box, click on the check box next to the specific
attribute to include or exclude associated nodes from the list view.
You can also use the select and deselect check boxes located above each filter category
list box to either select or deselect all of its specific attributes; remember, however, that
you must leave at least one attribute selected in each category in order to create your
filter.
2. Click on OK to set the filter parameters.
Once you have finished configuring all of the parameters for your list view, click OK in
the New List View window or List View Properties window to create the new list view or
modify an existing view.
Excluded Nodes
NetSight Element Manager’s architecture — which stores all node information in a central
database, and lets you choose how to view it — provides you with great flexibility in the
management and storage of node information. One of the ways you can manage your
collected node information is through the use of Excluded Nodes. There are two levels of
node exclusion: exclusion from an individual view, and exclusion from all views.
Excluding Nodes from an Individual View
Excluding a node from an individual List, Tree, or Map View removes that node from the
selected view only — the node’s information is still stored in the central node database,
and it will be displayed as appropriate in other views. For a map view, excluding a node
from the current (or active) view simply removes the icon from the map; no record of that
node’s former place on the map is maintained. For a List View or Tree View, however,
excluding a node from the active view places it on a special excluded nodes list associated
with the selected view. This list is displayed in the view’s Properties window, as
4-18Excluded Nodes
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.