|
|
This chapter briefly describes some CiscoWorks applications and provides instructions on how to use them. It also contains an overview of how CiscoWorks functions with your network management platforms. The chapter includes the following sections:
For detailed CiscoWorks application information, refer to the CiscoWorks online help system.
CiscoWorks now includes a new form of online help based upon help systems supplied with Windows-based platforms. It replaces the CiscoWorks User Guide, which is no longer supplied with CiscoWorks.
Once you start the CiscoWorks online help system, you can jump to any topic within the system. For information on how to use the Help viewer, select Help>How to Use Help when the first help window appears.
Online help is available from several parts of CiscoWorks and its network management platforms:
CiscoWorks online help includes a Find button that allows you to do full-text searches within the help system. For information on how to do a search, select Help>How to Use Help when the first Help window appears.
The online system includes help descriptions for all CiscoWorks menus and windows, including windows that do not have Help menus. You can view your online help system in the following ways:
CiscoWorks applications appear on your network management platform menus. To use CiscoWorks features and your NMS software to the fullest, you must understand how to start the applications and complete some basic tasks. This section describes the location of the CiscoWorks applications on the NMS menus and provides an overview of the post-installation tasks to complete before you begin to use CiscoWorks.
Table 6-1 lists the CiscoWorks applications and their menu locations, and explains the tasks they perform. The CiscoWorks applications are listed in alphabetical order.
In SunNet Manager, start the CiscoWorks applications via the Tools and Glyphs menus. In HP OpenView, start the CiscoWorks applications through any of the standard menu options (Administer, Monitor, Diagnose, or Misc).
Table 6-1 : Accessing CiscoWorks Applications from Your NMS Platform
| SunNet Manager Menu Location | HP OpenView Menu Location | Tasks |
|---|---|---|
| Tools>CW - Application Help | Help>CW - Application Help | CiscoWorks online help system that allows you to investigate different levels of details within the online help system by selecting highlighted text to open additional windows. The online help system provides overview, related information, procedures, and glossary data on the CiscoWorks applications and features. It allows both keyword and full-text searches to enable users to search for specific text. |
| Tools>CW - AutoInstall Manager | Administer>Cisco Devices>CW - AutoInstall Manager | Remotely deploy a new router using a neighbor router. Perform AutoInstall tasks remotely by running CiscoWorks instead of a Telnet session. |
| Tools>CW - CiscoConnect | Administer>CW - CiscoConnect | Creates detailed customer network profiles, allows for automatic submission of Cisco cases to the Technical Assistance Center (TAC), and allows you to check the status of existing cases and add information to them. CiscoConnect uses a Mosaic HTML-1.0 compliant browser and HTTPD server, sending and receiving e-mail over the Internet to Cisco. |
| Tools>CW - CiscoView | Monitor>CiscoView | Allows you to view the front and rear panels of Cisco devices. You can display configuration and performance information for the device, its cards, and its ports. You can use this information to monitor network performance, quickly access vital device information, and troubleshoot minor network problems. |
| Tools>CW - Configuration Management | Administer>Cisco Devices>CW - Configuration Management | Access configuration files of local and remote Cisco Systems devices to analyze or edit as necessary. Compare the contents of two configuration files in the database, or compare the configuration currently running on a device with the configuration that represents the last Database to Device command you performed. |
| Tools>CW - Configuration Snap-In Manager | Administer>Cisco Devices>CW - Configuration Snap-In Manager | Create and execute selected or custom UNIX commands on a device or group of devices at any time with Global Command Scheduler. |
| Glyph Tools>CW - Contacts | Monitor>Description>CW - Contacts | Obtain information about the contact for a specific device, including the complete name, phone number, e-mail address, title, location, and address of the person responsible for the operation of the device. |
| Tools>CW - Device Management | Administer>Cisco Devices>CW - Device Management | Create and maintain a database that holds a complete inventory of your network---hardware, software, release levels of operation components, individuals responsible for maintaining the devices, and associated locations. Enter or change data in the database tables for network devices, networks, interfaces, contacts, vendors, and so on. |
| Tools>CW - Device Monitor | SunNet Manager only | Monitor your network devices for information about environmental and interface statistics. Specify how often CiscoWorks should check this information. |
| Tools>CW - Device Polling | Monitor>CW - Device Polling | Probe and extract information about the condition of your networks using a polling feature. Information acquired is stored in the database for further evaluation and analysis. Compare the relative performance and status of devices and interfaces on the network. |
| Glyph Tools>CW - Device Software Manager | Administer>CiscoWorks Software Images>CW - Device Software Manager | Automate the upgrade of a system software or microcode image on a Cisco device. |
| Tools>CW - Domain Manager | Administer>CiscoWorks Security>CW - Domain Manager | Create groups of devices (called domains) that CiscoWorks applications can use to accomplish network management tasks such as security, configuration, and device polling. |
| Glyph Tools>CW - Environmental Monitor | Monitor>CW - Environmental Monitor | View the environmental status of Cisco AGS+ and Cisco 7000 routers including temperature and voltage statistics. This function is available on AGS+ routers running System Software Release 9.0 or later with an environmental monitor card running ENVM Microcode Version 2.0 or later. |
| Tools>CW - Global Command Manager | Administer>CiscoWorks System>CW - Global Command Manager | Create, store, and execute system commands on a device or group of devices at any time with Global Command Scheduler. |
| Tools>CW - Global Command Scheduler | Administer>CiscoWorks System>CW - Global Command Scheduler | Schedule commands or other jobs at regularly scheduled times using the crontab utility. |
| Glyph Tools>CW - Health Monitor | Monitor>CW - Health Monitor | View information about the status of a device, including buffers, CPU load, memory available, and protocols and interfaces being used. Enables you to display the Show Commands and Real-Time Graphs windows from the Health Monitor window. |
| Tools>CW - Login | Misc>CW - Login | Perform a generic login for all CiscoWorks applications that require user authentication so that you do not have to log into each application separately. |
| Tools>CW - Logout | Misc>CW - Logout | Log out of secured CiscoWorks applications to ensure security for those applications with authority checking turned on. |
| Tools>CW - Path Tool OR Glyph Tools>CW - Path Tool |
Diagnose>Network Connectivity>CW - Path Tool | View and analyze the path between two devices. Perform analysis on the path to collect utilization and error data. Displays the devices encountered between the source and the destination device, the link speeds connecting these SNMP devices, and the interface names. |
| Tools>CW - Polling Summary | Monitor>CW - Polling Summary | Summarize the polling setup completed within Device Polling. Browse data, and stop and start polling. |
| Tools>CW - Process Manager | Administer>CiscoWorks System>CW - Process Manager | Start, stop, and view status of CiscoWorks-related processes including Polling (nmpolld), CiscoConnect (httpd), System Log (syslogd), Sybase Server (dataserver), and TACACS (xtacacsd) daemons. |
| Glyph Tools>CW - Real-Time Graphs | Monitor>CW - Real-Time Graphs | View device information such as the router health (buffer space, CPU load, environment, free memory, and security); interface health (bits per second, bytes, errors, packets per second, packets, and queues); and protocol traffic (IP, ICMP, SNMP, TCP, UDP, AppleTalk, DECnet IV, Novell, VINES, and XNS) using a grapher utility. |
| Tools>CW - SA Password | Administer>CW - Security>CW - SA Password | Log in to the Sybase database account so you can perform system administrator tasks. |
| Tools>CW - Security Manager | Administer>Security>CW - Security Manager | Create authority checking procedures to protect selected CiscoWorks applications and network devices from unauthorized individuals by requiring a login to use protected applications. This protection ensures that only users with a valid account and password can perform tasks such as configuring a router, deleting database device information, or defining polling procedures. |
| Glyph Tools>CW - Show Commands | Diagnose>CW - Show Commands | View device data about any SNMP device, including Cisco routers and communication servers. This data includes the software version, buffers, selected device interfaces, traffic mix, IP accounting checkpoint, ARP, and IP route. Emulates the EXEC show commands for Cisco routers. |
| Tools>CW - Software Inventory Manager | Administer>CiscoWorks Software Images>CW - Software Inventory Manager | Update the Sybase database to include current device software and hardware status. Sort device information according to platform and software image, and invoke Device Software Manager to update specific devices. |
| Tools>CW - Software Library Manager | Administer>CiscoWorks Software Images>CW - Software Library Manager | Maintains a master storage area that contains a list of all available Cisco system software. These Cisco IOS software images are retrieved by the user with a variety of methods. |
| Tools>CW - Sync w/Sybase or Glyph Tools>CW - Sync w/Sybase |
Misc>CW - Sync w/Sybase | Synchronize the NMS and Sybase databases. CiscoWorks maintains data in the Sybase database, whereas each NMS maintains its own database. Sync w/Sybase ensures that device data from the NMS database is in the Sybase database (Sync w/Platform) and vice versa. Generally, synchronize the databases whenever new devices are added to your network. Use Sync Selected to add individual devices. |
| Tools>Sybase ESQR | Misc>Sybase ESQR | Use Sybase ESQR utilities to run and print reports on any table created with the Device Polling application. |
| Tools>CW - TACACS Manager | Administer>Security>CW - TACACS Manager | Maintain the TACACS password file on UNIX hosts that act as TACACS servers. Create and update TACACS accounts and computer-generated passwords. |
| Tools>CW - Toolbox | Misc>CW - Toolbox | Allows you to start CiscoWorks applications directly, without using the menus on your network management platform. Click on an application's icon in the Toolbox window to start the application. You can also display help for each application from Toolbox. |
| Glyph Tools> Workgroup Director | Monitor>Workgroup Director | Monitors the status of any Cisco concentrator, switch, or network adapter card. |
Perform the following tasks before using the CiscoWorks application on SunNet Manager (SNM):
Before performing any of these tasks, you must become familiar with the SNM Console window and learn how to access its menu items.
Perform the following tasks before using any CiscoWorks application on HP OpenView:
Before performing any of these tasks, you must become familiar with the HP OpenView Console window and learn how to access its menu items.
CiscoWorks is integrated with the SunNet Manager (SNM) or HP OpenView network management platform.
During installation and configuration, CiscoWorks adds customized schema files with Cisco-specific device types (such as the Cisco AGS+) to the platform's schema files directory. CiscoWorks also adds its applications to the NMS menus.
It is important to understand the NMS environment and how to use your platform software in conjunction with CiscoWorks. To answer your NMS network management questions, refer to the NMS platform documentation.
The following sections provide detailed information on SNM post-installation tasks and contain an overview of how CiscoWorks functions on the SNM network management platform.
The following topics are discussed:
This section briefly explains two ways start the SNM Console to run CiscoWorks. For a more detailed description and options, refer to the SunNet Manager 2.2 User's Guide.
You can use several different commands to start the SNM Console. However, you must be running Open Windows.
Perform the following tasks to start CiscoWorks when there is no database present:
Select one of the following methods to start CiscoWorks when the database is present:
For more information on starting the SNM Console or troubleshooting startup problems, refer to the SunNet Manager 2.2 User's Guide.
On the SunNet Manager (SNM) platform, you run CiscoWorks applications either from the Tools menu or the Glyphs menu. Figure 6-1 shows CiscoWorks applications available on the Tools menu.
Figure 6-1 : CiscoWorks Applications on the SunNet Manager Tools Menu SNM also has a menu that becomes available when you click on an icon. To display the menu, select an icon, place the pointer anywhere in the window pane, and press the MENU mouse button. On SNM, icons are called glyphs, and the menu that becomes available is called the Glyph menu (Figure 6-2).
Figure 6-2 : CiscoWorks Applications on the Glyph Menu
CiscoWorks uses two SNM utilities: the Results Browser and the Grapher. Following is a brief description of each and how it is used by CiscoWorks.
For more detailed information on the Results Browser and Grapher, refer to your SNM documentation.
Some SNM processes affect how CiscoWorks runs, depending on their configuration in SNM. As you continue to work with SNM processes and CiscoWorks, consider the following conditions in which the two environments coexist:
Most CiscoWorks applications require a database of network devices. They also require a network map that contains these network devices.
Discover enables you to find the devices in the primary network to which your system is attached. Use Discover to create a view (map) of your network and a run-time database for SNM. If you did not install the SNM software in the /usr/snm directory, you must set the environment variable for $SNMHOME as described in the SunNet Manager 2.2 User's Guide.
To run Discover, perform the following steps:
To add a Cisco 7000 to your SNM network map, perform the following steps:
Network devices located by the Discover command exist as generic devices. You must identify them as Cisco devices to take advantage of CiscoWorks functionality.
To change device status from generic to that of a Cisco device, perform the following steps:
The following sections provide detailed information on HP OpenView post-installation tasks and contain an overview of how CiscoWorks functions on the HP OpenView network management platform.
The following topics are discussed:
This section briefly explains two ways to start the HP OpenView Console to run CiscoWorks. You can use several different commands to start the HP OpenView Console. However, you must be running an X window manager, such as Motif.
Perform the following tasks to start CiscoWorks when there is no database present:
To start CiscoWorks when the database is present, select one of the following methods:
For more information on starting the HP OpenView Console or troubleshooting startup problems, refer to the HP OpenView 3.3 User's Guide.
CiscoWorks is fully integrated with HP OpenView, so you can access CiscoWorks applications directly from the main window of the HP OpenView platform. (See Figure 6-4.)
Figure 6-4 : HP OpenView Main Window CiscoWorks applications are available from HP OpenView main menus. For example, to open the Process Manager application, select Administer>CW - System>CW - Process Mgr.
HP OpenView does not use glyphs or a Glyph menu. To access device-dependent applications, perform the following steps:
This section briefly outlines the steps you must complete on your NMS before continuing with CiscoWorks tasks. For instructions on using specific CiscoWorks applications, refer to the appropriate sections in this section or to the CiscoWorks online help system.
Follow these steps to learn about CiscoWorks applications that use the Sybase database:
Table 6-2 : CiscoWorks Versus HP OpenView Task Descriptions
CiscoWorks uses one HP OpenView application, xnmgraph, which presents real-time or logged network data in graphical format. The xnmgraph application is used in the Health Monitor and Real-Time Graphs applications to display data in graphical format. You can change the graph properties either with the popup menu on the graph window or by editing the X resources in the /usr/OV/appdefaults/xnm file.
For more detailed information on xnmgraph, refer to your HP OpenView documentation.
Some HP OpenView processes affect how CiscoWorks runs, depending on their configuration in OpenView. As you continue to work with OpenView processes and CiscoWorks, consider the following conditions in which the two environments coexist:
CiscoWorks applications require a database of network devices and a network map that contains these devices. HP OpenView automatically displays a default map, called IP Map, which shows all the IP devices connected to the local HP OpenView system. The Manage Objects command enables you to find the devices in the primary network to which your system is attached. Use Manage Objects to view your network and a run-time database for HP OpenView.
To run Manage Objects, perform the following steps:
To add a Cisco device to your new network map, perform the following steps:
Network devices that are discovered by Manage Objects may exist as generic devices. You must identify them as Cisco devices to take advantage of CiscoWorks functionality.
To use Change Symbol Type to change device status from generic to that of a Cisco device, perform the following steps:
Figure 6-5 : Symbol Popup Menu Figure 6-6 : Change Symbol Type
CiscoWorks uses two separate databases:
The NMS run-time database is a third database that interacts with the CiscoWorks databases. This platform database stores information about the network. By synchronizing the Sybase database with the NMS database of the network platform, you build a complete resource of information.
Your NMS platform maintains a run-time database of devices that you create using NMS utilities. In order to use CiscoWorks applications, you must list devices in the Sybase database. Sync w/Sybase performs the following functions to enable you to use CiscoWorks applications:
Use Sync w/Sybase to synchronize database information. The Sync w/Sybase application appears in the CiscoWorks menu and device popup menus. Run Sync w/Sybase if you just initialized your NMS and want to fully synchronize both databases. Run Sync w/Sybase from the device menu if you want to synchronize one or more specific devices. In both cases, the Sync w/Sybase window, from which you can select other options, displays. (See Figure 6-7.)
Depending on the number of database records and the information contained in each, database synchronization can be timely.
To adjust for synchronization time and to meet special needs, select one of the following commands from the Options menu of the Sync w/Sybase window:
Figure 6-8 illustrates the relationship between the HP OpenView and CiscoWorks databases. Although you can directly add device names to either database, you must run Sync w/Sybase to confirm that the information about a particular device is correct in both places.
Figure 6-8 : Database Creation for your NMS platform and CiscoWorks For more detailed information about the database and the Sync w/Sybase and Sync with NMS applications, refer to the CiscoWorks online help on "Sync w/Sybase." For more information about the AutoInstall Manager application, refer to the CiscoWorks online help on "AutoInstall Manager."
After you finish creating a run-time database with network devices, follow these steps to run the Sync w/Sybase application:
Figure 6-9 : Sync w/Sybase Window
To use your NMS and CiscoWorks, you must make sure that the environment variables explained in Table 5-1, "Environment Variables and Directory Paths," are set correctly. Refer to "Verifying Changes to the .cshrc File" in the "Validating CiscoWorks Installation" chapter.
Normally, these environment variables are set during the CiscoWorks installation process.
This section provides a general idea of how to use a CiscoWorks application. It uses the Path Tool application as an example. For a detailed explanation of all CiscoWorks applications, refer to the CiscoWorks online help.
To use the Path Tool application, you must have at least two network devices in the Sybase database. Use Sync w/Sybase to add network devices to the Sybase database.
The Path Tool application enables you to display the routing path between a source device and a destination device.
To graphically display the path between two devices, perform the following steps:
Figure 6-10 : Path Tool Window Figure 6-11 : Device Selection Window Figure 6-12 : Path Tool Window with Text After the connection is established, another Path Tool window appears (similar to the window shown in Figure 6-13), graphically displaying the path between the source and destination devices you specified.
Figure 6-13 : Path Tool Window with a Graphic Display For more information on how to use the Path Tool, refer to the online help for Path Tool.
If you use the Security Manager application to protect specific applications, all users must enter a valid username and password to access applications. For a detailed description of which CiscoWorks applications you can protect, refer to the CiscoWorks online help section on setting up domains and securing applications.
Each CiscoWorks application has varying levels of access privileges. Users are granted inherent privileges to certain applications (such as the ability to display devices) based solely on their group-domain associations. The CiscoWorks administrator governing Security Manager can grant further levels of "application-specific" privileges (such as add or change database information) to selected groups.
When security is enabled, if you previously used Login to log into CiscoWorks, no user identification window appears. If you do not use Login, each time you run a secured application, CiscoWorks prompts you for a username and password. This login controls access to the application.
If you use Security Manager to secure your CiscoWorks applications, you can use Login and Logout. For more information on logging in and out, refer to the CiscoWorks online help section on Login and Logout.
Copyright 1988-1996 © Cisco Systems Inc.
% snm
If problems occur, your $PATH environment variable might not include a path to SNM executables. You can enter a fully qualified path. In the following example, /usr/snm/bin is the path to the executables:
% /usr/snm/bin/snm
If you don't want to start SNM with a network map, or want to load a specific map with the start up command, skip to the section, "Starting CiscoWorks with the Database."
Starting CiscoWorks with the Database
% snm -i
%
snm map_name
Opening CiscoWorks Applications from SNM
CiscoWorks Use of SNM Utilities
SNM Processes that Affect CiscoWorks
Running the SNM Discover Command
% /usr/snm/bin/snm
The SNM Console window appears.
Adding Cisco Devices to your SNM Network Map
Identifying Cisco Devices for CiscoWorks on Your SNM Map
Getting Started with CiscoWorks on HP OpenView
Starting CiscoWorks on HP OpenView
Starting CiscoWorks without the Database
% ovw
If problems occur, your PATH environment variable might not include a path to HP OpenView executables. You can enter a fully qualified path. In the following example, /usr/OV/bin is the path to the executables:
% /usr/OV/bin/ovw
If you don't want to start HP OpenView with a network map, or want to load a specific map with the startup command, skip to the section, "Starting CiscoWorks with the Database."
Starting CiscoWorks with the Database
% ovw -i
% ovw - map map_name
Opening CiscoWorks Applications from HP OpenView
Running Device-Dependent CiscoWorks Applications on HP OpenView
Learning about Other CiscoWorks Applications on Your NMS
Task
NMS Software
CiscoWorks Software
Start NMS software
X
Use Create or Manage Objects
X
Traverse your network map (NMS database)
X
Create or find devices or device properties
X
AutoInstall Manager, Device Mgmt, and Sync w/Sybase
Modify or change device or device properties
X
Device Mgmt, Sync w/Sybase
Move or connect devices
X
Copy or delete devices
X
Device Mgmt, Domain Manager
Save your network map (run-time database)
X
Modify a graph display
X
Print graphs, windows, or text files
X
Change the symbol type
X
Check the cause of an event
X
Change how symbol type changes propagate
X
View or change the status of requests
X
View error and traps
X
Manage SNMP devices
X
All CiscoWorks applications
CiscoWorks Use of HP OpenView Tools
HP OpenView Processes that Affect CiscoWorks
Running the Manage Objects Command on HP OpenView
% ovw
The HP OpenView Console window appears.
Adding Cisco Devices to Your HP OpenView Network Map
Identifying Cisco Devices for CiscoWorks on HP OpenView
Synchronizing the NMS Database with Sybase
Setting Environment Variables
Quick Tutorial on Using a CiscoWorks Application
Displaying the Path between Two Devices
Security Options
CiscoWorks Login and Logout Functions
![]()
![]()
![]()
![]()
![]()
![]()
![]()