cc/td/doc/product/rtrmgmt/cwparent/cw32
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 referred to as nmdevman, stores the device information you enter into the Sybase relational database.

Use the Sync w/Sybase application during initial setup of your network map to add or update devices into the CiscoWorks database from the database of your particular platform. Then use the Sync w/Sybase or the Device Management application to add devices. 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 display, 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 ReadWrite (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 your device contains the correct RW community string in order to avoid CiscoWorks application device errors. The correct passwords must be defined for that device.

For more information on database table structure, refer to the section "CiscoWorks Database Tables" in the CiscoWorks Reference Guide. Using the Sync w/Sybase application is easier than gathering device data, so Sync w/ Sybase is discussed first. Later, you can use the Device Management application to add custom data that you must access for troubleshooting, such as contact, administration, or vendor information.

Using Sync w/Sybase



Sync w/Sybase polls the 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 and initializing the devices.

Sync w/Sybase performs the following functions, allowing you to use CiscoWorks applications:

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 currently 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 particular platform.

Depending on the number of database records and the information contained in each, database synchronization can be time-consuming.

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 may 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 the SunNet Manager Platform

If SunNet 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 SNM 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 SNM run-time database to the CiscoWorks database.

Accessing Sync w/Sybase from HP OpenView

With HP OpenView, 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 5-1 illustrates the Sync w/Sybase window and Table 5-1 describes its components.


Figure 5-1: Sync w/Sybase Window




Table  5-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 that allows you to specify a directory where you can save a copy of the current configuration.

Exits the current window.

Option 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 only entries in the Sybase table for devices listed in the Sybase database.
Sybase>Platform Copies only the device records from Sybase that did not yet exist 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 the CiscoWorks version information for this application.

Provides help text on 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 four 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 Sybase. These records might include information about the hardware platforms, community strings, and so forth. Allows you to choose the device records of your particular platform that you want to add to Sybase. With the device name selected, click on 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 on Sync.
This is not the preferred option. It creates only entries in the Sybase table for devices listed in your network management platform--but excludes any 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 that you want the complete device information available from the database of your network management platform, you can copy it using another command from the Options menu of Sync w/Sybase, or the CiscoWorks Device Management application.
Because this process can be time-consuming, upon selecting this option, you are first presented with a confirmation dialog box. If you click OK, this process updates the device records from Sybase into the database of your network management platform; 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 is the inverse process of Devices (Network>Sybase). When you use Device Management or the CiscoWorks AutoInstall feature to add a device directly to Sybase, it will not be recognized by your platform database until you use the Sybase>Platform command. Nor will the device name be recognized if you added it directly to Sybase, but 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 SNM or the symbol type to HP OpenView. If you delete a device from SNM, 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 SunNet 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 SNM glyph menu. To use Sync w/Sybase, perform the following steps:

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

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


Step 2 Click on OK to continue with the synchronization of SNM's database and the Sybase database Devices table.

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



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

Step 3 Select File>Exit to exit this window.

The device management operation of CiscoWorks software is primarily used to maintain long-term records pertaining to the networks and to collect and store performance data for later evaluation.

The database helps organize this information by providing the means for system operators to rapidly access online information and for network managers to respond to the long-term needs and growth of the system.


Note CiscoWorks database software is licensed from Sybase, Inc. for use with CiscoWorks only. The configuration delivered by Cisco Systems under the terms of this license cannot be used for any other purpose; to do so is a violation of the licensing agreement. If you want to use Sybase software for other applications, contact Sybase, Inc. for a full-use license.

Adding Devices on HP OpenView

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

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

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


Step 2 Click on OK to continue with the synchronization of the HP OpenView database and the Sybase database Devices table.

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


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.

Through 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 into CiscoWorks, the user identification window will not display. If you have not used the Login application, 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 SNM, select Tools>CW - Device Mgmt.


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


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



Figure 5-2: Device Management Window





Table  5-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 text on 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 display.
Delete Displays a warning box that you are about to delete a device-information record from the database. If you click on the OK button, the record is permanently removed.

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


Figure 5-3: Device Information Window

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

If you need help defining what kind of information to enter, see Tables 5-3 through 5-5.



Table  5-3:
Device Details Components
Component 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.
Enable Password Enables the password.

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


Table  5-4: Inventory Details Components
Component Meaning or Action
Serial # (Optional) The serial number of the device, if you know it.
S/w Details (Optional) The specific software running on the device.
S/w Version (Optional) The software version running on the device.
H/w Details (Optional) A blank comments field to specify any needed details about the hardware device.
H/w Version (Optional) A blank comments field to specify any needed details about the hardware version.

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


Table  5-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 as part of a series. For example, the Cisco 3500 should be device type 3000.
Initialization Shows the last time the device was initialized, or updated, by the CiscoWorks database.
Platform Shows the kind of device that is selected, such as Cisco 7000.

Modifying a Device

To modify the 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 on 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 on OK to save the new information to the database.

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 on Delete.

You see a confirmation box.


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 Once you have one Device window open, you can open any other Device windows without having to close the first.

Adding, Editing, or Deleting a New Interface

The Interfaces portion of the Device Management window lists the network interfaces that are supported by the selected device.

Adding or Editing a New Interface

To add or edit the interface from the CiscoWorks database, 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 5-4). The Details Interfaces window appears (Figure 5-5).


Figure 5-4: Edit Menu of Device Management



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

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



Figure 5-5: Details Interfaces Window



Step 5 When you finish working with the Details interfaces window, click on OK to save the new or modified information to the CiscoWorks database and to close the Details Interfaces window.

Besides clicking on the OK button, you can act on the information in the Details Interfaces window by clicking one of the other command buttons. Click on Apply to save the details information to the CiscoWorks database and to keep the Details interfaces window open. Click on Undo to revert to the last saved or applied details. Click on Cancel to close the window without keeping any changes you made since the last time you clicked on the Apply.

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.

You see a confirmation dialog box.


Step 5 Click on OK in the confirmation box to permanently remove the interface name from the CiscoWorks database. Or click on 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 information on the individuals designated to support the selected device. You can add multiple contacts from an already existing database, or list, of contacts but can only edit or delete one contact at a time.

If you want to create database records of contacts, use the People form under 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 5-6.)



Figure 5-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 a contact for the chosen device.

Step 5 Click on OK to confirm your action. Or click on 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.

You see the Details People window containing data fields relating to the selected contact person. (See Figure 5-7.)



Figure 5-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 on OK to accept the information and to return to the Details People window.


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

Besides clicking on the OK button, you can act on the information in the Details People window by clicking on one of the other command buttons. Click on Apply to save the details information to the CiscoWorks database and to keep the Details People window open. Click on Undo to revert to the last saved or applied details. Click on Cancel to put away the window without keeping any changes you made since the last time you clicked on the Apply.

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 without first displaying a dialog box requesting you to confirm your action.

Step 4 Select File>Close.

Initialize Process

The initialize process automatically collects information about network devices, thereby 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 5-6.) The Sybase tables initialized include the following tables: devices, interfaces, if_addresses, domains, and controllers.


Table  5-6: Data Fields Filled in by the Initialization Process
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 Identifies the software version running on the communications device. sysDescr
RW Comm (Read-Write community string) Shows 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) Shows 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 Internet Protocol 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 the ReadWrite 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 SNM, select Tools>CW - Device Mgmt.


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


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


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

Step 3 Select Options>Initialize.

During the initialization process, 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 5-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 at least narrow your choices. The Search menu is available in all Device Information windows. Because device locations, in particular, are sometimes difficult to find, an illustrated example of how to use the Search command is found in the section "Locations Window." However, you can still perform the following straightforward 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 and click on OK.


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


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


Table  5-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 5-8 for the translation of wildcards into literal characters.



Table  5-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
"[ [ ]" [
"]" ]
Time Saver  If you know the exact name of a device-information entry, you can locate it quickly by performing the following quick-search method:

Step 1 Select CW - Device Mgmt.

Step 2 From the Device Information Window, click on the list (device, interfaces, or contacts) that contains the entry you want to locate. For example, if you want to locate a device, click on the Devices list.

Step 3 Type the name of the device, interface, or contact that you want to find. The name must be visible somewhere in the list.

For example, if you are searching for a device named Barrow, click in the Devices column; then press b to scroll the list to the first device name that begins with b.


As you continue entering the device name, the list scrolls to continually narrow your choices until the specified name becomes selected.


Step 4 To edit the search pattern, use the Backspace key. Press the Escape key to clear the search pattern.

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 to quickly identify the administrative support for the networks.

The Network>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.

Perform the following steps to enter information into the Networks>Net Numbers Window from the Forms menu, select Network -> Net Numbers. You see the Networks>Net Numbers window. (See Figure 5-8.)


Figure 5-8: Networks >Net Numbers Window



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


Table  5-9: Network>Net Numbers Window Components
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 on New from the Networks>Net Numbers window. You see the Details Networks window. (See Figure 5-9.)


Figure 5-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 and click on 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 on the OK button, you can use other buttons to adjust your actions to the details information. If you click on the Apply button, 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 on 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 Edit>Delete Contact.

The name is permanently removed from the database.

Adding a Network Number

To add a new Network Number, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Networks>Networks 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 5-10.)



Figure 5-10: Details Net Number Window



Step 5 Enter the data in the Net(work) Type, Net(work) Number, and Net(work) Mask fields as it applies to your particular network; then click on 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 on the OK button, you can use other buttons to adjust your actions to the details information. If you click on the Apply button, the data is saved to the database, but the Details Net Number window remains open. Click on Undo to revert to the set of changes made since you clicked on the OK or Apply. Click on Cancel to close the Details Net Number window without saving any changes.


Step 6 To exit, select File>Exit.


Note To change an existing network number, just select it from the Networks>Net Numbers window, and select Edit>Edit Net Number. Similarly, you can change a network name by selecting it in the Networks>Net Numbers window, and then selecting Edit Net Number from the Administrations Window

Deleting a Network Number

To delete a Network Number:

Step 1 Select CW - Device Mgmt.

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

Step 3 When the Networks>Network Numbers window appears, select a network number you have previously added.

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 complete a new Administrations window and add the corresponding 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 pertinent information on the administration of the selected device. (See Figure 5-11.)


Figure 5-11 illustrates the Admin>Device window.


Figure 5-11: Admin>Device Window



Step 3 Add, modify, or delete information regarding your device administration as required. Refer to Table 5-10 for descriptions of each of the components. The following subsections provide detailed instructions on adding, modifying, and deleting administrative information.


Table  5-10: Admin>Device Window Components
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 on 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 and then click on 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 the information on an admin, perform the following steps:

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>Admin. You see the Admin>Device window. (See Figure 5-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 on Modify. (See Figure 5-12.)


Figure 5-12: Details Admins Window

Step 5 Enter the new information for the Admin Name or Admin Desc(ription); then click on OK to record the modified Admin information to the database.

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


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


Deleting Admins

To delete information on 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 on Delete.

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


Step 5 Click on 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.

You see the Vendors>Locations Window, as shown in Figure 5-13. The components of the Vendors>Locations window are described in Table 5-11.



Figure 5-13: Vendors>Locations Window




Step 3 To display the Details Vendors window, click on New. (See Figure 5-14.)


Figure 5-14: Details Vendors Window

Step 4 Enter data in each of the fields; then click on OK to save the vendor information to the database and to 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 on the OK button, you can use other buttons to adjust your actions to the details information. If you click on the Apply button, the data is saved to the database but the Details Vendors window remains open. Click on Undo to revert to the last set of changes made since you clicked on the OK or Apply button. Click on Cancel to close the Details Vendors window without saving any changes.



Table  5-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 Opens the Contacts List lookup window; select the name of an established contact, and then click the OK.
Edit Vendor Contact Opens the Contacts window with the selected individual's name; edit the text field as required.
Delete Vendor Contact Removes the selected name from the database.
Search Find Opens the Set Search String box; enter the name of the Vendor you want to locate then click on OK.
Show All Empties the Set Search String box and redisplays all available Vendors and Vendor Contacts.
Help On Version Displays the CiscoWorks version information for this application.
On Form Provides help text on the current window.
Vendors scroll window Displays Vendor data.
Vendor Contacts scroll window Displays Vendor Contacts data.
New Adds a new data record.
Modify Changes data fields of a record.
Delete Permanently removes a record from the database.
Time Saver In the Vendor Contacts window, if names and locations already exist in the database, use a lookup window to access and select the names rather than retyping the data.

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

Updating Vendors Data

You can make changes and additions any time using the method described in the previous section "Adding Vendors Data," or you can follow the alternative methods described here.

For instance, you may want to add a vendor address signifying a branch office for an existing vendor.

To update or modify vendor data, perform the following steps:

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 on Delete.

The selected data is deleted.


Step 5 Select File>Close.

People>Phones Window



The People>Phones window (see Figure 5-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.


Figure 5-15: People>Phones Window



Adding People Data

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

Step 1 Select CW - Device Mgmt.

Step 2 Select Forms>People.

You see the People>Phones window, or form. (See Figure 5-15.)


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



Table  5-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 display 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 the 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 on 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 on New to establish, or add, the name of a new contact person.

You see the Details People window where you can enter information that identifies a new contact person and how to reach that person. (See Figure 5-16.)



Figure 5-16: Details People Window




Step 4 Enter data in each of the fields.

Step 5 Click on OK to save the Details People information to the database and to close the window.

You return to the People>Phones window, where you see the name of the contact person. This information is also accessible from the Edit menu of the Device Management window.


Besides clicking on the OK button, you can use other buttons to adjust your actions to the details information. If you click on the Apply button, the data is saved to the database, but the Details People window remains open. Click on Undo to revert to the last set of changes made since you clicked on the OK or Apply button. 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.

You see the Details Phones window. (See Figure 5-17.)



Figure 5-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 to the database and to close the Details Phones window, click on OK.

Modifying People Data

You can modify information regarding contact people any time using the method described in previous section "Adding People Data," or you can follow the alternative method described here.

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. Or, if you are uncertain about the exact spelling of the person's last name, enter the first few characters, and CiscoWorks will display only the contact 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 McBr.

Step 4 From the Edit menu, click on Modify to modify the contact person information as required.

Step 5 To save the information to the database and to close the Details Phones window, click on OK.

Deleting People Data

To delete data regarding 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 on Delete.

The information on the selected contact person is permanently removed from the database.


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 for locations. With the Chooser List, you can add or update locations 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 5-18.)

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


Figure 5-18: Locations Window



Step 3 Click on New to display the Details Locations window in which you can enter address-specific information about a location. (See Figure 5-19.)


Figure 5-19: Details Locations Window




Step 4 Enter data in each of the fields, then click on OK to save the Details Locations information to the database and to 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 on the OK button, you can use other buttons to change your actions to the details information. If you click on the Apply button, the data is saved to the database, but the Details Locations window remains open. Click on Undo to revert to the last set of changes since you clicked on the OK or Apply button. Click on 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 want, 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 5-20.)


Figure 5-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 on OK. This action narrows the list to only those locations that begin with "A." (See Figure 5-21 for possible results of this kind of single-character search.)



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




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

Step 5 Click on Modify to display the Details Locations window.

Step 6 Modify the information on the location as required.

Step 7 Click on OK to save the information to the database and to close the Details Locations window.

Step 8 Select File>Close to exit the window.

Deleting Locations Data

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

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 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 on OK.

Step 6 Select the location that contains the information to be deleted, if you searched for more than one.

Step 7 Click on Delete in the Details Locations window.

Step 8 Click on 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  5-13: Locations Window Components
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 5-22 shows the Lines>Contacts Window. Table 5-14 describes its components.


Figure 5-22: Lines>Contacts Window




Table  5-14: Lines Window Components
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 on 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 location or find a set of locations.

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 secondary, Details Lines window, shown in Figure 5-23, consists of three fields, each of which is described is described in Table 5-15. Complete the Details Lines window as required.


Figure 5-23: Details Lines window


Table  5-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 predefined assignments. Examples of typical line type assignments are listed below 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. Along with this data, 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.

You see the Lines>Contacts Window. (See Figure 5-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 on New.

You see the Details Lines window. (See Figure 5-23.)


Step 4 Enter helpful comments 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 5-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 on OK to save the Details Lines information to the database and to return to the Lines>Contacts window, where you see the description of the line you just entered in the Lines column.

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


Figure 5-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 on 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.