cc/td/doc/product/rtrmgmt/cwparent/cw40
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Device Management

Device Management

This chapter describes the Device Management and Sync w/Sybase applications and how to use them to build the CiscoWorks database. CiscoWorks uses the database information in several application functions. This chapter includes the following sections:

Device Management Overview



The Device Management application, also named nmdevman, stores the device information you enter into the Sybase relational database.

Use the Sync w/Sybase or the device management application during initial setup of your network map to add or update devices into the CiscoWorks database from your platform's database. Note that using the Device Management application is more laborious than using the Sync with Sybase application. If you add devices directly to Sybase, you can synchronize them with the devices in your network map by using the Sybase>Platform command. Sybase>Platform is part of the Sync w/Sybase application. For more information on how to run this application, refer to the section "Using Sync w/Sybase" later in this chapter.

The Device Management application provides electronic forms to record or browse the relevant data on each network device. As an option, you can use the Sync w/Sybase application to create equivalent database entries automatically.

If you plan to use CiscoWorks applications that use Sybase, be sure you complete the necessary database forms. If you do not have the necessary information in the database, error messages will be displayed, or the application will not be able to access the most current devices.

The following CiscoWorks applications use the database data initialized by Sync w/Sybase or Device Management applications:

Caution Some CiscoWorks applications require a Read/Write (RW) community string to perform their tasks. The RW community string comes from the device table. The Sync All command in Sync w/Sybase does not automatically place the RW community string into the device table. Ensure that your device contains the correct RW community string to avoid CiscoWorks application device errors.

For more information on database table structure, refer to the section "CiscoWorks Database Tables" in the CiscoWorks Reference Guide.

Using Sync w/Sybase



Sync w/Sybase polls the NMS database files, then adds and updates devices in the CiscoWorks database. This process is similar to manually adding the devices to your database using the Device Management application, then initializing them.

Sync w/Sybase performs the following functions:

Use Sync w/Sybase to synchronize database information. Sync w/Sybase 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, appears.

The following information is added to your CiscoWorks database for each new or updated device:

If device information is already listed in your CiscoWorks database, Sync w/Sybase updates any changed information about this device. If device information does not exist in the CiscoWorks database, Sync w/Sybase adds it. If a device is unreachable or has a name that cannot be resolved, it will not be added to the CiscoWorks database.

If device information is added directly to the CiscoWorks database, you can use the Sybase>Platform command, an option within Sync w/Sbase, to add the device to the database used by your platform.

First-time CiscoWorks users should use the Devices (Network->Sybase) option from the Sync w/Sybase window to synchronize all device information. If you are a first-time user and want the quickest method of synchronizing, use Quick Sync (Platform->Sybase) from the Sync w/Sybase window, which synchronizes all the devices and displays a warning that device information will not be complete. If you use Quick Sync (Platform->Sybase), you might want to return to Sync w/Sybase when you have more time to use the Devices (Network->Sybase) option to fill in the incomplete device information.

To adjust for synchronization time and to meet special needs, select one of the commands from the Options menu of the Sync w/Sybase window.

Although you can directly add device names to either the NMS or CiscoWorks database, you must run Sync w/Sybase to confirm that the information about a particular device is correct in both places.

Accessing Sync w/Sybase from Site/SunNet/Domain Manager

If Site/SunNet/Domain manager is your network management platform, you can add device information using the SNM Create command as an alternative to using the Sybase->Platform command. Other commands are available within Sync w/Sybase to help you keep device information current.

Access Sync w/Sybase through either the Tools or Glyph menus. The degree of Sync w/Sybase functionality depends on which menu you use to activate the application:

Adds all devices not yet in the CiscoWorks database from the Site/SunNet/Domain manager run-time database. Depending on the number of devices in your network, this process may take a while.
Synchronizes one device at a time from the Site/SunNet/Domain manager run-time database to the CiscoWorks database.

Accessing Sync w/Sybase

With HP OpenView and NetView, you can run Sync w/Sybase with or without a network map displayed on your monitor.

To open Sync w/Sybase, select Misc>CW - Sync w/Sybase.

Sync w/Sybase Window

Figure 2-1 illustrates the Sync w/Sybase window and Table 2-1 describes its components.


Figure 2-1: Sync w/Sybase Window




Table 2-1: Sync w/Sybase Window Components
Component Subcomponent Description
File Print

Save As

Exit

Opens your system's screen capture facility.

Displays a dialog box in which you can specify a directory where you can save a copy of the current configuration.

Exits the current window.

Options Devices (Network>Sybase) Copies all database records from your platform database to Sybase.
Domains (Network>Sybase) Updates device records for the selected domain in the Sybase database.
Quick Sync (Platform>Sybase) Creates entries in the Sybase table only for devices listed in the Sybase database.
Sybase>Platform Copies only the device records from the Sybase table not yet in the platform database into the platform database.
Timeout Interval Displays a dialog box in which you can specify how much time can elapse before synchronization terminates and declares the device unreachable. You can also specify the default timeout using X Resource timeout Interval in your.Xdefaults file. The resource name is synchTimeout.
Help On Version

On Sync w/Sybase

Displays CiscoWorks version information for this application.

Provides help for the current window.

Search String field Locates characters within a browser sequence.
Search Forward Searches forward for a character string in the text.
Search Reverse Searches backward for a character string in the text.

Depending on the number of database records and the information contained in each, database synchronization can be time consuming. 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:

This is the recommended option. It copies the complete number and contents of database records from your network management platform to the Sybase table. These records might include information about the hardware platforms, community strings, and so forth. The option allows you to choose the device records to add to the Sybase table. With the device name selected, click Sync. To select contiguous items, hold down the Shift key and click additional device names, or drag your mouse through a range of device names. To select noncontiguous items, hold down the Control key and select individual device names.
Updates device records for the selected domain in the Sybase database. With the domain name selected, click Sync.
Creates entries in the Sybase table for devices listed in your network management platform but excludes specific information, such as interface details or hardware platforms. Use this command if you need the databases to quickly recognize the devices contained in each. Later, if you decide you want complete device information from your network management platform database, you can use another command from the Options menu of Sync w/Sybase or the CiscoWorks Device Management application.
Because this process can be time-consuming, when you select this option confirmation dialog box appears. If you click OK, this process updates the device records from the Sybase table into your network management platform database; if the device does not exist in the platform database, it is created in the Sync w/Sybase view (expressed as a cloud) in the network map. This process is the inverse of Devices (Network>Sybase). When you use Device Management or the CiscoWorks AutoInstall feature to add a device directly to Sybase, the device is not recognized by your platform database until you use the Sybase>Platform command. Nor is the device name recognized if you add it directly to the Sybase table, but have not yet added the graphical symbol to your network management platform. For example, the device name will not be recognized if you added it directly to Sybase, but not yet added the glyph to Site/SunNet/Domain manager or the symbol type to HP OpenView/NetView. If you delete a device from Site/SunNet/Domain manager, however, it remains as a record in Sybase until you manually delete it from Sybase. A network view, or cloud, appears in your network map that lists the device records that were added from this process.

Adding Devices on Solstice Site/SunNet/Domain manager

You can use either Sync Selected or Sync w/Sybase to add and update devices from your platform database to your CiscoWorks database. To use Sync Selected, right click on the Site/SunNet/Domain manager glyph menu. To use Sync w/Sybase, perform the following steps:

Step 1 Display your network map.

Step 2 Select Edit>Create.

A "Create Object" window appears.


Step 3 Select the correct component, then click the "Create" button.

Step 4 In the New Component window that appears, enter the MIB type and other required information.

Step 5 Click Apply.

Step 6 From either the Tools or the Glyph menu, select Sync w/Sybase.

The Sync w/Sybase window appears. (See Figure 2-1.)


Step 7 Click OK to synchronize the Site/SunNet/Domain Manager database and the Sybase database devices table.

A Sync w/Sybase window appears. Synchronization can take from 3 minutes to over an hour, depending on how large your network is and how many devices you are synchronizing. When synchronization is complete, a date stamp appears in the Sync w/Sybase window. This confirms that devices from the Site/SunNet/Domain manager database have been added to the Sybase database.



Note You can stop synchronization at any time by selecting Exit from the File menu. The devices copied from the platform database before you quit will be saved in the Sybase database.

Step 8 Select File>Exit to exit this window.

Device management is used primarily to maintain long-term records pertaining to the networks and to collect and store performance data for later evaluation.

The database provides the means for system operators to rapidly access online information and for network managers to respond to the long-term needs and system growth.

Adding Devices on HP OpenView/Netview

To add or update devices from your platform database to your CiscoWorks database, perform the following steps:

Step 1 Display your Network Map.

Step 2 Select Edit>Add Object.

The Add Object Palette appears.


Step 3 Click on the Cisco Router icon to display the Symbol Subclasses for Cisco Routers.

Step 4 Using the left mouse button or its equivalent, click on a Cisco device symbol; then move your mouse to the network map and click the left mouse button again.

Step 5 The Cisco device symbol is copied into the map and the Add Object window appears.

Step 6 Complete the Add Object window, then click OK.

Step 7 Select Misc>CW - Sync w/Sybase.

The Sync w/Sybase window appears. (See Figure 2-1.)


Step 8 Click OK to synchronize the HP OpenView/NetView database and the Sybase database Devices table.

A Sync w/Sybase window appears. Synchronization can take from 3 minutes to over an hour, depending on how large your network is and how many devices you are sychronizing. When synchronization is complete, a date stamp appears in the Sync w/Sybase window. This confirms that devices from the HP OpenView/NetView database have been added to the Sybase database.


Using Device Management

The Device Management application allows you to add, delete, or modify information in the CiscoWorks database or synchronize the device lists of the CiscoWorks database and the platform database.

Devices can be any SNMP or IP equipment in your network. Examples include gateways, routers, switches, servers, and workstations.

With access to device information, you can isolate traffic-routing problems, redefine router characteristics using remote configuration, locate your network inventory, keep track of revisions or releases, and allocate resources on the network.

You should define the domain, interfaces, characteristics, vendor, serial number, revision level, and contacts for each device. If you choose not to use the Device Management windows, you can use the Sync w/Sybase application, which adds devices from the platform database to the CiscoWorks database.

Caution If you use Sync w/Sybase, only those fields used by the platform database, such as device name, domain, and community string, will be automatically entered. You need to manually enter contacts, vendors, and other database information.

Device Management Security

If you have set up authentication checking for Device Management, each time you or another user tries to access Device Management, a username and password are requested. If you previously used the Tools menu Login application to log in to CiscoWorks, the user identification window will not be displayed. If you did not use the Login application, then each time you access Device Management, CiscoWorks prompts you for a user login and password. This login controls access to data stored in the database. If your user login does not have Sybase account permission, you will not have access to Device Management.

Adding, Modifying, or Deleting a New Device

The section discusses how to enter a new device through the Device Management windows. The data includes information about the devices and the people who maintain them.


Note 

This is a suggested database build sequence. It is not mandatory to enter data in this sequence.

Adding a New Device

To add a device to the database, perform the following steps:

Step 1 Select Device Mgmt.

On Site/SunNet/Domain manager, select Tools>CW - Device Mgmt.


On HP OpenView, select Administer>CW - Devices>CW - Device Mgmt.


On NetView, select Administer>CW - Devices>CW - Device Mgmt.


The Device Management window appears. (See Figure 2-2.) The window components are described in Table 2-2.



Figure 2-2: Device Management Window




Table 2-2: Device Management Components
Component Subcomponent Meaning or Action
File Print

Exit

Prints a snapshot of the current window.

Closes the current window.

Security Change Domain

Change User

Privileges

Enables user to display another domain.

Allows user to log in with another username.

Displays the user's current access privileges to the Device Management application.

Edit Add Interface Displays the Details Interfaces window.
Edit Interface Displays the Details Interfaces window of the selected interface.
Delete Interface Permanently removes the selected Details Interface record from the database.
Add Contacts Displays the Contact List window.
Edit Contact Displays the Details People window of the selected contact.
Delete Contact Permanently removes the Details People Record of the selected contact from the database.
Search Find



Show All

Displays the Set Search String box to help you determine which device names display in the Device Management window.

Displays all known device names in the current CiscoWorks domain.

Forms Admin

People

Lines

Networks

Vendors

Locations

Displays the Admin>Device window.

Displays the People>Phones window.

Displays the Lines>Contacts window.

Displays the Networks>Net Numbers window.

Displays the Vendors>Locations window.

Displays the Locations window.

Option Initialize


Admin Details

Writes all saved information on devices to the database.

Displays the Device Information window to include Administrative Details pane.

Help On Version


On Device Manager

Displays the CiscoWorks application version information.

Provides help for the current window.

New Opens a new Device Information window.
Modify Opens the Device Information window on the selected device. Unless Admin Details is checked from the Options menu, only the Device Details and Inventory Details panes are displayed.
Delete Displays a warning that you are about to delete a device-information record from the database. If you click OK, the record is permanently removed.

Step 2 Click New at the bottom of the window to display the Device Information window. (See Figure 2-3.)


Figure 2-3: Device Information Window

Step 3 Complete the Device Details portion of the window by entering data about your device into each field. Click Apply to save the changes without closing the Device Information window. If you decide not to work with the Devices window any longer, click Cancel to close the window without saving any changes. Click Undo to revert to the last saved changes.

To determine what information to enter in each field, see Table 2-3 through Table 2-5.



Table  2-3: Device Details Fields
Field Meaning or Action
Device Name The host name. Do not include the domain name.
DNS Domain The Internet domain name as distinguished from the domains of your own organization. Do not include the host name.
Description A blank comments field to specify any details about the device.
RO Comm(unity) A password or privilege level that identifies the Read Community string. For example, Public.
RW Comm(unity) A password or privilege level that identifies the Read-Write Community string. For example, Private.
Line Password A password that identifies the line password for the router.
Enable Password A password that identifies the enable password for the router.

Complete the inventory details portion of the window by entering the appropriate data into each field.


Table 2-4: Inventory Details Fields
Field Meaning or Action
Serial # The serial number of the device. (optional)
S/w Details The specific software running on the device. (optional)
S/w Version The software version running on the device. (optional)
H/w Details A blank comments field to specify details about the hardware device. (optional)
H/w Version A blank comments field to specify details about the hardware version. (optional)

Step 5 Complete the administrative details portion of the window by entering the appropriate data into each field.


Table  2-5: Administrative Details Components
Component Meaning or Action

Admin

Click the chooser list to display the Chooser List for admins, then select the name of the person responsible for supporting the specified device.

Vendor Click the chooser list to display the Chooser List for vendors, then select the vendor, or manufacturer, of that device.
Location Click the chooser list to display the Chooser List for locations, then select the location of that device.
Device Type (Optional) Click the chooser list to display a list of device types, than select the type (such as router or bridge) that corresponds to your device. If you do not see your device type, select the device type that may include your device. For example, the Cisco 3500 should be device type route.
Platform The kind of device that is selected, such as Cisco 7000.
Initialization The last time the device was initialized, or updated, by the CiscoWorks database.

Modifying a Device

To modify data on an existing device, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Management window, select the name of the device whose database record you want to modify.

Step 3 Click Modify to display the existing Devices window for the selected device.

Time Saver To open a specified Devices window, double click on the device name from the Device Management window.

Step 4 Edit the existing Devices window as required.

Step 5 When you are finished modifying data in the Devices window, click OK. The information is saved and you return to the Device Management window.

Deleting a Device

To delete the data on an existing device, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Management window, click on the name of the device whose database record you want to delete.

Step 3 Click Delete.

A confirmation box is displayed.


Step 4 Click on OK to permanently remove the interface data from the database. Or click on Cancel to put away the confirmation box without deleting the selected interface.

You return to the Device Management window.



Note You can have more than one Device window open at any time

Adding, Editing, or Deleting an Interface

The Interfaces portion of the Device Management window lists the network interfaces supported by the selected device. When you add, change, or delete an interface, the information is displayed in that portion.

Adding or Editing an Interface

To add or edit the interface, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Management Window, select the name of the device to which you want to add or modify information.

Step 3 Select Edit>Add Interface or Edit>Edit Interface as required (see Figure Figure 2-4). The Details Interfaces window appears (Figure 2-5).


Figure 2-4: Edit Menu of Device Management



Step 4 Enter a new interface name or edit an existing one. (See Figure 2-5.)

The information in the Details Interfaces window is defined by your particular router configuration.



Figure 2-5: Details Interfaces Window



Step 5 When you finish working with the Details interfaces window, click OK to save the information and close the Details Interfaces window.

You can also act on the information in the Details Interfaces window by clicking one of the other command buttons. Click Apply to save the details information and keep the Details Interfaces window open. Click Undo to revert to the last saved or applied information. Click Cancel to close the window without saving your changes.

Deleting an Interface

To delete a database record on an existing interface, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Management window, select the Device name that contains the interface data you want to delete.

Step 3 Select the interface name.

Step 4 Select Edit>Delete Interface.

A confirmation dialog box is displayed.


Step 5 Click OK to permanently remove the interface name from the database, or click Cancel to close the confirmation box without deleting the interface data.

Adding, Modifying, or Deleting Contact-Name Information

The Contacts portion of the Device Management window lists the names of the people designated to support the selected device. You can add multiple contacts from an existing database or list, but you can edit or delete only one contact at a time.

If you want to create database records of contacts, select the People form from the Forms menu in the Device Management window. (See the section "Adding People Data" later in this chapter.)

Adding Contacts

To add contact names from an established pool of contacts (already in the database), perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Management window, select the device name to which you want to add contact names.

Step 3 To add one or more contacts, select Edit>Add Contacts.

The Contacts List box appears. (See Figure 2-6.)



Figure 2-6: Contacts List




Step 4 Select the names of the contacts you want to add as designated support persons for the specified device. The names you select here will appear in the Device Management window as contacts for the chosen device.

Step 5 Click OK to confirm your action, or click Cancel to dismiss the window without saving any changes.

Modifying Contacts

To edit an existing contact from an established pool of contacts, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 To change information about a selected contact person, select Edit>Edit Contact.

The Details People window appears. (See Figure 2-7.)



Figure 2-7: Details People Window




Step 3 Enter the new information into the corresponding fields.

For Location and TACACS Login, click the chooser list button. A chooser list appears from which you can select the appropriate item; then click OK to accept the information and return to the Details People window.


Step 4 Click OK to save all details on the contact person to the CiscoWorks database and to close the Details People window.

You can also act on the information in the Details People window by clicking on one of the other command buttons. Click Apply to save the details information and keep the Details People window open. Click Undo to revert to the last saved or applied details. Click Cancel to put away the window without keeping your changes.

Deleting Contacts

To delete a contact from an existing pool of contacts, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select a contact name from the Device Management window.

Step 3 Select Edit>Delete Contact. The name is permanently removed from the database. A dialog box requesting you to confirm your action is displayed.

Step 4 To exit, select File>Close.

Initialize Process

The initialize process automatically collects information about network devices, minimizing the amount of data you must enter manually into the database table.

When you select Options>Initialize, the initialize process starts. This process polls the network and obtains the details information (such as the MIB object) from the selected device. The collected data appears in the corresponding fields. (See Table 2-6.) The initialized Sybase tables include the following tables: devices, interfaces, if_addresses, domains, and controllers.


Table 2-6: Data Fields Filled in by the Initialization Process  (Continued) 
Data Fields Data Gathered MIB Object
Device Type Class of communications device such as router or bridge. sysServices
DNS Domain The internet domain name, as distinguished from the domains of your own organization. domainName
Platform Type Identifies the hardware platform, such as Cisco 7000. sysObjectID, sysDescr, flashStatus
Software Details System Description. sysDescr
S/w Version The software version running on the communications device. sysDescr
RW Comm (Read-Write community string) The Read-Write Community string for a particular device. Note that this is retrieved from your network management platform, so if it is wrong there, it will be wrong in CiscoWorks. None
RO Comm (Read community string) The Read Community String for a particular device. Note that this is retrieved from your network management platform, so if it is wrong there, it will be wrong in CiscoWorks. None
Has Flash Memory Indicates whether the device has Flash memory. flashStatus
Has Env Memory Indicates whether the device contains an environmental Monitor Card. (Note: To run nmenv, you need firmware version 2.0 or later on the environmental monitor card.) None
Initialization time The time at which the device was last initialized. None
Interfaces field of the Devices window IP address of each interface table field. ipAdEntAddr
Data appears in the Interface window in the Subnet Mask field IP subnet mask number for the interface. ipAdEntNetMask
Interface Type field of the Details Interfaces window Type of interface associated with the device. Data is placed in the Interface Type field of the Interfaces table.1 ifType
Description field Interface description. Data is placed in the Interface Desc(ription) field of the Interfaces table, which is part of the Devices table. ifDescr
Hardware Address field of the devices Details Interfaces window Interface hardware address. Data is placed in threadworm Addr field of the Interfaces table. ifPhysAddress
Interface Speed field of the Details Interfaces window The speed of the interface. ifSpeed
Interface Description field Description of the user configurable interface. locIfDescr

1 Refer to RFC 1213 for detailed information on interface types.

For information on how to select additional MIB objects for polling the network, refer to the section "Creating Polling Tables Using Device Polling" in the "Fault Management" chapter. For details on how to modify or add MIB objects in the MIB file, refer to the chapter "MIB Files and Objects" in the CiscoWorks Reference Guide.

Time Saver If you do not want to enter device management information, you can use the Sync w/Sybase application. This application compares the platform database with the CiscoWorks database. If a device does not exist in CiscoWorks but does exist in the platform database, the Sync w/Sybase application adds it to the CiscoWorks relational database. For more information, refer to the section "Using Sync w/Sybase", earlier in this chapter. Ensure that the Read/Write Community string is correct on the device, or some CiscoWorks applications may not work properly.

Adding a Device Using the Initialize Command

To run the Initialize process, perform the following steps:

Step 1 Select Device Mgmt.

On Site/SunNet/Domain manager, select Tools>CW - Device Mgmt.


On HP OpenView, select Administer>Cisco Devices>CW - Device Mgmt.


On NetView, select Administer>Cisco Devices>CW - Device Mgmt.


The Device Management window appears on your screen. (See Figure 2-2.)


Step 2 Select the name of the device that you want to initialize.

Step 3 Select Options>Initialize.

During initialization, the SNMP MIB object information is collected and placed in the Device Type and Software Desc fields of the Devices window. Data is also placed in several fields of the secondary Interfaces window. (Refer to Table 2-6.)


Adding a Device Without the Initialize Command

If you try to add a device manually (without the initialize command), you might receive the error message, "The column xxxx in table devices may not be null." This means that you did not enter data into mandatory data fields. To correct the problem

Step 1 Enter data directly in the Location, Vendors, and Administrations windows.

Step 2 Return to the Devices window and fill in the Location, Vendor Name, and Admin Name fields.

Step 3 Click on Apply under the text fields to add the device to the database.

You also can add devices that exist in the platform database, but do not yet exist in the CiscoWorks database, by using the Sync w/Sybase application. For instructions on this application, refer to the section "Using Sync w/Sybase."

Searching for Device Information

If you are uncertain about the name or spelling of any database record that is part of Device Information, you can use the CiscoWorks Search menu to find the needed information or to narrow your choices. The Search menu is available in all Device Information windows. Because device locations are sometimes difficult to find, an illustrated example of how to use the Search command is found in the section "Locations Window" later in this chapter. However, you can still perform the following steps to search for device information:

Step 1 Select Search>Find to display the Set Search String Window.

Step 2 Enter the device information you want to find.

Step 3 If you are not sure of the exact spelling, you can enter the first few characters of the device record to narrow your choices.

For example, if the information you want begins with the letter A, but you don't recall the exact name or how to spell it, just enter A in the Set Search String Window then click OK.


Search logic, in the form of Sybase Wildcards, is supported if you prefer to narrow your choices in special ways.


Refer to Table 2-7 for the supported wildcards and their meanings:


Table  2-7: Sybase Wildcards
Wildcard Meaning

%

Any string of 0 or more characters

_ Any single character
[ ] Any single character within the specified range ([a-f]) or set ([abcdef])
[^] Any single character not within the specified range ([^a-f]) or set ([^abcdef])

To use %,_,-, [ ] or [^] as literal characters, use square brackets as escape characters for the percent sign, the underscore, and the open bracket. Use the closed bracket by itself. Use the dash as the first character inside a set of square brackets. Refer to Table 2-8 for the translation of wildcards into literal characters.



Table  2-8: Expressing Wildcards as Literal Characters
Search string Finds

"5%"

5 followed by any string of 0 or more characters

"5[%]" 5%
"_n" an, in, on, and so forth
"[_]n" _n
"[a-cdf]" a, b, c, d, or f
"[-acdf]" -, a, c, d, or f
"[ [ ]" [
"]" ]

Networks>Net Numbers Window



The Networks>Net Numbers window is available from the Forms menu of the Device Management window. Use this form to enter information that is critical to the needs of the network manager. This information allows you to identify and isolate sources of difficulties and the administrative support for the networks.

The Networks>Net Numbers window provides options for entering data about a particular network and saving the information to the Sybase database. From the Networks>Net Numbers window, you can access additional subwindows to enter the network administrator's name, search for text strings, as well as add, edit, or delete network numbers.

To display the Networks>Net Numbers Window from the Forms menu, select Networks > Net Numbers. You see the Networks>Net Numbers window. (See Figure 2-8.)


Figure 2-8: Networks >Net Numbers Window



Add, modify, or delete information on your network as required. Refer to Table 2-9 for descriptions of each of the components. The following subsections provide detailed instructions on adding, modifying, and deleting network information.


Table 2-9: Networks>Net Numbers Window Components  (Continued)
Component Subcomponent Description
File Print

Close

Opens the screen capture facility of your system.

Closes the current window.

Edit

Add Net Number Writes a new network number to the database.
Edit Net Number Changes the selected network number.
Delete Net Number Permanently erases the selected network number.
Search Find


Show All

Locates the specified network number, if it exists in the database.

Empties the text in the Find box and redisplays all available networks and net numbers.

Help On Version


On Form

Displays the CiscoWorks version information for this application.

Provides help text on the current window.

Networks column Displays network data records.
Network Numbers column Displays network type, name, and mask data.
New Opens the Details Networks window.
Modify Changes data fields of a record.
Delete Removes a record from the database.

Adding a Network Name

To add a network name to the CiscoWorks database, perform the following steps:

Step 1 Click New from the Networks>Net Numbers window. The Details Networks window appears. (See Figure 2-9.)


Figure 2-9: Details Networks window



Step 2 Enter the data appropriate for your network into the Network Name field.

Step 3 To supply the Admin Name, click on the chooser list.

This opens the Administrations lookup window.


Step 4 Select a name from the lookup window, then click OK.

Step 5 To save the data to the database and close the Details Networks window, click on OK. You return to the Networks>Net Numbers window, where the network name you just defined appears in the Networks column.

Besides clicking OK, you can use other buttons to adjust your actions to the details information. If you click Apply, the data is saved to the database, but the Details Networks window remains open. Click Undo to revert to the set of changes since you clicked OK or Apply. Click Cancel to close the Details Networks window without saving any changes.

Deleting a Network Name

To delete a network name:

Step 1 Select CW-Device Mgmt.

Step 2 When the Device Management window appears, select a network name from the network list.

Step 3 Select Forms-Networks

The Networks-Net Numbers window appears. (See Figure 2-8.)


Step 4 Select a Network Name, then click Delete.

A confirmation box appears asking if you would like to continue with this action.


Step 5 Click OK to permanently remove the network name form the database. Click Cancel to put away the confirmation box without deleting the selected network name.

The name is permanently removed from the database.

Adding a Network Number

To add a network number, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Networks>Network Numbers.

Step 3 From the Networks>Network Numbers window, click on the network name you established in the previous section.

Step 4 Select Edit>Add Net Number.

You see the Details Net Number window. (See Figure 2-10.)



Figure 2-10: Details Net Number Window



Step 5 Enter the data in the Net(work) Type, Net(work) Number, and Net(work) Mask fields, then click OK.

You return to the Networks>Net Numbers window, where the network number you just defined appears in the net numbers column and is linked to the selected network name.


Besides clicking OK, you can use other buttons to adjust your actions to the details information. If you click on Apply , the data is saved to the database, but the Details Net Number window remains open. Click Undo to revert to the set of changes made since you clicked on OK or Apply. Click Cancel to close the Details Net Number window without saving any changes.


Step 6 To exit, select File>Close.


Note To change an existing network number, just select it from the Networks>Net Numbers window, then select Edit>Edit Net Number.

Deleting a Network Number

To delete a network number:

Step 1 Select CW - Device Mgmt.

Step 2 When the Device Management window appears, select Forms>Networks.

Step 3 When the Networks>Network Numbers window appears, select the network number you want to delete.

Step 4 Select Edit>Delete Net Number.

The number is deleted and the Networks>Net Numbers window display is updated.


Step 5 To exit, select File>Close.

Administrations Window

The Administrations window allows you to access database records of pertinent information including contacts for lines, devices, and networks.

Adding Admins

To add administration information to the database, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Admin.

The Admin>Device window appears, where you can record information pertinent to the administration of the selected device. (See Figure 2-11.)



Figure 2-11: Admin>Device Window



Add, modify, or delete information about your device administration as required. Refer to Table 2-10 for descriptions of each of the components.Admin>Device Window Components


Table 2-10: Admin>Device Window Components  (Continued)
Component Subcomponent Description or Action
File Print

Close

Opens the screen capture facility of your system.

Closes the current window.

Edit Add Admin Contact Opens the Contacts List lookup window. Select the name of an established contact, then click OK.
Edit Admin Contact Opens the Contacts window with the selected individual's name; edit the text field as required.
Delete Admin Contact Removes the selected name from the database.
Search Find Opens a Set Search String box. Enter the name of the admin you want to locate, then click OK.
Show All Empties the Set Search String box and redisplays all available Admins and Admin Contacts.
Help On Version

On Form

Provides help text on the current window.

Displays the CiscoWorks version information for the Admin>Device form.

Admins column Displays administrative group names.
Admin Contacts column Displays contact data on individuals.
New Opens the Details Admins window; allows the creation of a new administrative group record.
Modify Opens the Details Admins window; allows changes to the selected administrative group name.
Delete Permanently removes the selected item from the database.

Modifying Admins

To modify information on an admin, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Admin. The Admin>Device window appears. (See Figure 2-11.)

Step 3 From the Admin>Device window, select the name of the admin whose detailed information you want to modify.

Step 4 To display the Details Admins window, click Modify. (See Figure 2-12.)


Figure 2-12: Details Admins Window

Step 5 Enter the new information for the Admin Name or Admin Desc(ription), then click OK to save the information and close the window.

You return to the Admin>Device window, where the Admin you just modified appears in the Admins column.


Besides clicking OK , you can use other buttons to adjust your actions to the details information. If you click Apply, the data is saved to the database, but the Details Admins window remains open. Click Undo to revert to the set of changes made since you clicked on OK or Apply. Click Cancel to close the Details Admins window without saving any changes.


Deleting Admins

To delete an admin, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Admin.

You see the Admin>Device window.


Step 3 Select the name of the admin you want to delete.

Step 4 Click Delete.

You see a confirmation box asking if you would like to continue with this action.


Step 5 Click OK to permanently remove the admin from the database or click on Cancel to put away the confirmation box without deleting the selected Admin.

Vendors Window



The Vendors Window enables you to update and view information on the vendor, or supplier, of a particular device.

The kind of information you enter in this window can help you with normal servicing, updating of equipment, transmission links, and other related needs.

The vendors table lists the names and locations of any entity you want to classify as a vendor. This can range from a company supplying physical equipment, such as Cisco Systems, to network consultants and service-only firms.

Adding Vendors Data

To add new vendor information, follow these steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Vendors.

The Vendors>Locations Window appears. (See Figure 2-13.) The components of the Vendors>Locations window are described in Table 2-11.



Figure 2-13: Vendors>Locations Window




To display the Details Vendors window, click New. (See Figure 2-14.)


Table 2-11: Vendors>Locations Window Components
Component Subcomponent Description
File Print

Close

Opens the screen capture facility of the system.

Closes the current window.

Edit Add Vendor Contact

Edit Vendor Contact

Delete Vendor Contact

Opens the Contacts list lookup window. Select the name of an established contact, then click OK.

Opens the Contacts window with the selected individual's name. Edit the text field as required.

Removes selected names from the database.

Search Find

Show All

Opens the Set Search String box. Enter the name of the Vendor you want to locate, then click OK.

Empties the Search String box and redisplays all available vendors and vendor contacts.

Help On Version

On Form

Displays the CiscoWorks version information for this application.

Provides help text on the current window.

Vendors scroll window Displays vendors data.


Figure 2-14: Details Vendors Window

Step 4 Enter data in each of the fields, then click OK to save the information and close the window.

You return to the Vendors>Locations window. The name of the vendor you entered in the Details Vendors window appears in the Vendors column.


Besides clicking OK , you can use other buttons to adjust your actions to the details information. If you click Apply, the data is saved to the database, but the Details Admins window remains open. Click Undo to revert to the set of changes made since you clicked on OK or Apply. Click Cancel to close the Details Admins window without saving any changes.


Time Saver In the Vendor Contacts window, if names and locations already exist in the database, use a lookup window to access and select existing names and locations instead of retyping the data.

Step 5 To exit this window, select File>Close.

Updating Vendors Data

You can change or add information any time using the procedure described in the "Adding Vendors Data" section, or you can use the following procedure:

Step 1 Select CW - Device Mgmt.

Step 2 From the Vendors>Locations window, select the vendor name.

Step 3 Click on Modify.

You see the Details Vendors window with the current data on a particular vendor.


Step 4 Enter new data into the fields that pertain to your needs, then click on OK.

The modified vendor and address are saved to the database, and you return to the Vendors>Locations window.



Note A vendor address is not the same as a contacts location (address). These two addresses are treated separately.

Step 5 Select File>Close to close the Vendors>Locations window.

Deleting Vendors Data

To delete vendor data

Step 1 Select CW - Device Mgmt.

Step 2 When the Device Management window appears, select Forms>Vendors.

Step 3 When the Vendors>Locations window appears, select the vendor name.

Step 4 Click Delete.

The selected data is deleted.


Step 5 Select File>Close.

People>Phones Window



The People>Phones window (see Figure 2-15) contains the name, title, phone number, and other relevant information about individuals responsible for the administration and support of the network and network equipment. The individuals might include network administrators, equipment vendors, Cisco contacts, and others.

The CiscoWorks database links the names, telephone numbers, and other people-specific data to their addresses. This linkage allows you to quickly find essential contacts, such as names and addresses of troubleshooters, vendors, device administrators, or simply an e-mail address or telephone number.

Adding People Data

To add information regarding a contact person to the database, follow these steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>People.

The People>Phones window appears. (See Figure 2-15.)


Refer to Table 2-12 for descriptions of each of the components.


Figure 2-15: People>Phones Window





Table  2-12: People>Phones Window Components
Component Subcomponent Description
File Print

Close

Opens the screen capture facility of your system.

Exits the current window.

Edit Add Phone Displays the Details Phones window in which you can enter an additional telephone number and description, such as a FAX number or pager number. The number and its description are displayed in the Phone Numbers column of the People>Phones window.
Edit Phone Displays the Details Phones window of the selected phone number and allows you to modify the contents.
Delete Phone Permanently removes the phone number from the database.
Search Find

Show All

Opens a Set Search String box. Enter the name of the person you want to locate, then click OK.

Empties the Set Search String box and redisplays all available people and phone numbers.

Help On Version Displays the CiscoWorks version information for this application.
On Form Provides help text on the current window.
New Details People window Displays a blank Details People window where you can enter information about a new contact person.
Modify Details People window Displays people data that you can change and save.
Delete Permanently removes information about this contact person from the database.

From the People>Phones window, you can click one of the command buttons to add or modify information about a particular support person. To add or modify information about the individual's telephone number, select one of the corresponding commands from the Edit menu.


Step 3 Click New to add the name of a new contact person.

The Details People window appears. (See Figure 2-16.)



Figure 2-16: Details People Window




Step 4 Enter the appropriate data in each of the fields.

Step 5 Click OK to save the information and close the window.

You return to the People>Phones window, where the name of the contact person is displayed.


Besides clicking OK, you can use other buttons to adjust your actions to the details information. If you click Apply, the data is saved to the database, but the Details People window remains open. Click Undo to revert to the last set of changes made since you clicked OK or Apply. Click on Cancel to close the Details People window without saving any changes.


Step 6 With an individual's name selected, select Edit>Add Phone to add additional contact numbers for this person, such as a pager or fax number.

The Details Phones window appears. (See Figure 2-17.)



Figure 2-17: Details Phones Window



Step 7 Enter the phone number and phone details into the corresponding fields. Phone Details is a blank description field in which you can enter any information (up to 16 characters) about the phone number.


Note The phone number you enter here is a secondary number and appears in the Phone Number column of the People>Phones window. The primary voice telephone number is available only from the Details People window.

Step 8 To save the information and close the Details Phones window, click OK.

Modifying People Data

You can modify information regarding contact people any time using the method described in "Adding People Data", or you can use the following method:

Step 1 Select CW - Device Mgmt.

Step 2 Select Search>Find command to display the Set Search String window.

Step 3 Enter the last name of the contact whose information you want to modify, then click on OK. If you are uncertain about the exact spelling of the person's last name, enter the first few characters, and CiscoWorks will display the names that fit the search pattern. For example, if you know the name of the person is McBranagan, CiscoWorks shows you only the McBranagan contact in the People column of the People>Phones window. Or enter the first few characters such as McBr, to view all the contact people whose last names begin with those characters.

Step 4 From the Edit menu, click Modify.

Step 5 To save the information select Edit>Modify and close the Details Phones window, click OK.

Deleting People Data

To delete data about a contact person, perform the following steps:

Step 1 Select the name of the individual whose data you want to delete from the People>Phones window.

Step 2 Click Delete.

A confirmation box appears asking if you would like to continue with this action.


Step 3 Click OK to permanently remove the name from the database, or click Cancel to put away the confirmation box without deleting the name.

Locations Window



The Locations Window represents a reservoir for network addresses of people, the location of network devices, and any other network-associated matter. The information you enter in the Locations window goes into a central repository called Chooser List . With the Chooser List, you can add or update location data whenever you work with the Details People window or the Device Location window.

Adding Locations Data

To add a location to the database, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Locations. (See Figure 2-18.)

The Locations window, where you can add, modify, or delete location information about the contacts people, appears. You can also search for location data.


Figure 2-18: Locations Window



Step 3 Click New to display the Details Locations window. (See Figure 2-19.)


Figure 2-19: Details Locations Window




Step 4 Enter data in each of the fields, then click OK to save the information and close the window.

You return to the Locations window, where you see the name of the location you entered in the Details Locations window. This information is now part of the Chooser List for locations, available from the Details People window and the Device Location window.


Besides clicking OK, you can use other buttons to change your actions to the details information. If you click Apply , the data is saved to the database, but the Details Locations window remains open. Click Undo to revert to the last set of changes since you clicked OK or Apply. Click Cancel to close the Details Locations window without saving any changes.


Searching for and Modifying Data

At times you may need to look up a specific location and perhaps then identify the corresponding contact person. Once you identify the location data, you can modify it if necessary.

Step 1 Select CW - Device Mgmt.

Step 2 Select Search>Find to display the Set Search String window. (See Figure 2-20.)


Figure 2-20: Set Search String Window



Step 3 Enter the exact name of the location you want to modify. If you are not sure of the correct spelling, you can enter the first few characters of the location name to narrow your choices.

For example, if the location you want begins with the letter A, but you do not recall the exact name or how to spell it, just enter A in the Set Search String window and click OK. This action narrows the list to only those locations that begin with "A." (See Figure 2-21 for possible results of this kind of single-character search.)



Figure 2-21: Locations Window, Following a Single-Character Search




Step 4 Select the Location that contains the information you want to change.

Step 5 Click Modify to display the Details Locations window.

Step 6 Modify the information on the location as required.

Step 7 Click OK to save the information and close the window.

Step 8 Select File>Close to exit.

Deleting Locations Data

You can look up a specific location, identify the corresponding contact person, and delete the location. To search for and delete location data, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 When the Device Management window appears, select Forms>Locations.

Step 3 Select Search>Find.

The Set Search String window appears.


Step 4 Enter the exact name of the location you want to delete. If you are not sure of the correct spelling, enter the first few characters of the location name to narrow your choices.

For example, if the location you want begins with the letter A, but you do not recall the exact spelling, enter A in the Set Search String window. This action narrows the list to only those locations that begin with "A".


Step 5 Click OK.

Step 6 Select the location that contains the information to be deleted.

Step 7 Click Delete in the Details Locations window.

Step 8 Click OK in the confirmation notice to delete the information from the database and close the Details Locations window.

Step 9 Select File>Close to exit the Locations window.

Table 2-13 describes the components of the Locations Window.


Table 2-13: Locations Window Components  (Continued)
Component Subcomponent Description
File Print

Close

Opens the screen capture facility of your system.

Exits the current window.

Search Find


Show All

Displays the Set Search String dialog box to find the name of a specific location or find a set of locations.

Empties the Set Search String box and redisplays all available locations.

Help On Version


On Form

Displays the CiscoWorks version information for this application.

Provides help text on the current window.

New Displays a blank Details Locations window in which you can enter information about a new location.
Modify Displays the Details Locations window in which you can modify information about the selected location.
Delete Permanently removes the Details locations data of the selected location.

Lines>Contacts Window



The Lines>Contacts window contains line identities used in the network. A link must exist between lines and contacts for troubleshooting. A line can have several contacts linked to it.

Figure 2-22 shows the Lines>Contacts Window. Table 2-14 describes its components.


Figure 2-22: Lines>Contacts Window


Table 2-14: Lines Window Components (Continued)
Component Subcomponent Description
File Print

Close

Opens the screen capture facility of your system.

Exits the current window.

Edit Add Line Contact


Edit Line Contact

Delete Line Contact

Opens the Contacts List lookup window. Select the name of an established contact, then click OK.

Opens the Details People window of the selected individual, or line contact. Edit the text fields as required.

Permanently removes the selected Lines Contact from the database.

Search Find

Show All

Displays the Set Search String dialog box to find the name of a specific lines or to find a set of line contacts.

Empties the Set Search String dialog box and redisplays all available Lines and Line Contacts.

Help On Version


On Form

Displays the CiscoWorks version information for this application.

Provides help text on the current window.

New Displays a blank Details Lines window in which you can enter new information about a line.
Modify Displays the Details Lines window where you can modify the information on the selected line.
Delete Permanently removes the Details Lines information of the selected line from the database.

Details Lines Window

The Details Lines window consists of three fields, each of which is described is described in Table 2-15. Complete the Details Lines window as required. (See Figure 2-23.)


Figure 2-23: Details Lines Window


Table  2-15: Lines Window Table Groups
Fields Description
Line Desc(ription)

Line Type

A blank text field where you can enter comments about the line.

The line medium. It can be any numeric designation. Currently, there is no established standard or Cisco Systems-defined assignments. Examples of typical line type assignments are listed under Group ID. If you do not want to use line types, use a default of 0 in this field.

Group IDs

0 indicates no designation (default setting).

1 indicates Ethernet thin wire.

2 indicates Ethernet thick wire.

3 indicates Ethernet twisted pair.

4 indicates a serial line.

Line description

Adding Lines Data

Assemble all of the line name designations and associated type identifiers and identify the contacts you want to list for activities such as troubleshooting and administration. Make a list or assemble a group to speed the entry process.

To add lines data, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Lines command.

The Lines>Contacts window appears. (See Figure 2-22.)


This window enables you to establish and associate contacts to a given line. Line Contacts are individuals who typically have a known expertise in troubleshooting or administration of a given line. A line indicates the transmission cabling in place, such as coaxial cable, fiber-optic cable, or twisted-pair wire.


Step 3 Click New.

The Details Lines window appears. (See Figure 2-23.)


Step 4 Enter the appropriate information in the Line Description and Line Type fields.

If a needed line description or type is available in the database, you can double-click on either field to open the Lines lookup window and select from existing data.


Step 5 Enter the Group ID, or number, that identifies the specific line type to the network. Refer to Table 2-15 if you are not sure what Group ID to enter for the specific transmission media, or line, used in your network.

Step 6 Click OK to save the information and return to the Lines>Contacts window. The description of the line you just entered is displayed in the Lines column.

Step 7 Select Edit>Add Line Contact to display a list of individuals who are designated resources for networking solutions. (See Figure 2-24.)


Figure 2-24: Contacts List



Step 8 Click on the name of the individual who you want to serve as a contact for the selected line type.

Step 9 Click OK.

The individual is now listed in the Lines Contacts window and is linked to the selected line. The Lines Contacts window closes.



hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.