Device Management

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 From the Device Management Window, select the name of the device to which you want to add or modify information.

Step 2 Select Edit>Add Interface or Edit>Edit Interface as your needs determine. (See Figure 1-4.) You see the Details Interfaces window.

Figure 1-4 : Edit Menu of Device Management

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

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

Figure 1-5 : Details Interfaces Window

Step 4 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 From the Device Management window, select the Device name that contains the interface data you want to delete

Step 2 Select the interface name.

Step 3 Select Edit>Delete.

You see a confirmation dialog box.

Step 4 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 who are 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 From the Device Management window, select the device name to which you want to add contact names.

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

The Contacts List box displays. (See Figure 1-6.)

Figure 1-6 : Contacts List

Step 3 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 4 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 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 1-7.)

Figure 1-7 : Details People

Step 2 Enter the new information into the corresponding fields.

For Location and TACACS Login, click the pick-menu 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 3 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 a contact name from the Device Management window.

Step 2 Select Edit>Delete Contact. The name is permanently removed from the database without first displaying a dialog box requesting you to confirm your action.

Error Messages

For information on Device Management window error messages, refer to Appendix B, "Troubleshooting CiscoWorks Errors."

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 Initialize from the Options menu, 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 displays in the corresponding fields. (See Table 1-6.) The Sybase tables initialized include the following tables: devices, interfaces, if_addresses, domains, and controllers.

Table 1-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.	None.
RO Comm (Read community string)	Shows the Read Community String for a particular device.	None.
Has Flash	Indicates whether the device has Flash memory.	flashStatus
Has Env	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

¹ 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 Chapter 4. For details on how to modify or add MIB objects in the MIB file, refer to Appendix A, "MIB Files and Objects."

Timesaver 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>Device Mgmt.

On HP OpenView or NetView for AIX, select Administer>Cisco Devices>Device Mgmt.

The Device Management window displays on your screen. (See Figure 1-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 1-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. You must enter data directly in the Location, Vendors, and Administrations windows first. Then return to the Devices window and fill in the Location, Vendor Name, and Admin Name fields. Finally, 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 the following table (Table 1-7) for the supported wildcards and their meanings:

Table 1-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 close bracket by itself. use the dash as the first character inside a set of square brackets. Refer to Table 1-8 for the translation of wildcards into literal characters.

Table 1-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
"[ [ ]"	[
"]"	]

Timesaver 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 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 2 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 3 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 1-8.)

Figure 1-8 : Networks ---> Net Numbers window

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

Table 1-9 : Network---> Net Numbers Window Components

Component	Subcomponent	Description
File	Print Close	Prints a snapshot of the current window. Closes the current window.
Edit	Add Net Number Edit Net Number Delete Net Number	Writes a new network number to the database. Changes the selected network 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.
Net 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 1-9.)

Figure 1-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 pick menu.

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

Adding a Network Number

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

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

Step 2 Select Edit>Add Net Number.

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

Figure 1-10 : Details Net Number Window

Step 3 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 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 4 To exit, select File>Exit.