cc/td/doc/product/rtrmgmt/bluelist/cwblue21
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Using the Administration Application

Using the Administration Application

Use the CiscoWorks Blue Administration application to add, delete, modify, and discover devices in your CiscoWorks Blue database, and to select DLSw key devices. (DLSw key devices are described in the "Using Key Devices" section.

The following topics describe how to use the administration application:

Starting the CiscoWorks Blue Administration Application

This topic describes how to start the CiscoWorks Blue Administration application. You can start the application either from the workstation system prompt or from a network management system, such as NetView for AIX, as described in the following topics:

Starting the CiscoWorks Blue Administration Application From a Network Management System

You can start the CiscoWorks Blue Administration application from a network management system such as NetView for AIX. To start the application from a network management system:

Starting the CiscoWorks Blue Administration Application From a System Prompt

The CiscoWorks Blue Administration application is accessible from /opt/CSCOcb/bin/. To start the application from a system prompt, enter the following commands:

cd /opt/CSCOcb/bin ./cwb start admin

Starting the CiscoWorks Blue Administration Application From a Remote Workstation

You can log in to a remote UNIX host from your own local UNIX workstation, export the remote host display to your local workstation, and then run the application from the remote host. To start the remote host's CiscoWorks Blue Administration application from your local workstation, use the following procedure:

Step 1 At your local UNIX workstation, enter the following command:

    xhost +

Step 2 Log in to the remote UNIX host as root (or with a username of your own choosing).

Step 3 Set your DISPLAY environment variable to export the display from the remote host to your local workstation. Depending on which shell you are using, use one of the following commands:

    setenv DISPLAY export DISPLAY=IP_address:0.0
    setenv DISPLAY IP_address:0.0

Step 4 To start the CiscoWorks Blue Administration application, enter the following commands:

    cd /opt/CSCOcb/bin ./cwb start admin

Using the Main Administration Window

When you start the CiscoWorks Blue Administration application, the CiscoWorks Blue Administration window (Figure 7-1) is displayed. See the topic "Administration Window" for information about the CiscoWorks Blue Administration window.


Figure 7-1: CiscoWorks Blue Administration Window

Use the main window to perform the following tasks:

Administration Window

Use the CiscoWorks Blue Administration window to add, delete, modify, and discover devices in your CiscoWorks Blue database, and to select DLSw key devices.

Fields

The Administration window has the following fields:

Field Description

Edit Devices

Manipulates the devices in the database:

  • Add adds one or more devices, separated by spaces, to the database.

  • Delete deletes one or more devices from the database.

  • Modify changes the read community string for one or more devices.

  • Rediscover rediscovers one or more devices in the database.

  • DLSw Key designates or remove one or more devices as a DLSw key devices.

Discover

Discovers DLSw, RSRB, APPN, or TN3270 devices using either a seed file or a network management system database, and adds the discovered devices to the CiscoWorks Blue database. Discovery first does a common discovery process that includes any SRB rings. Then discovery queries routers for the protocols you select:

  • RSRB discovers RSRB devices.

  • DLSw discovers DLSw devices.

  • TN3270 discovers TN3270 devices. (To use this function, you must have a valid license for the SNA View application.)

  • APPN discovers APPN devices.

  • By Seed File starts discovery using a seed file. You are prompted for the seed file name.

  • By NMS starts discovery using a network management system database. (This option is not available when no network management system was selected during installation.)

Launch

Starts CiscoWorks Blue client applications:

  • Process Manager starts the Process manager client application.

  • Message Log starts the Message Log viewer client application.

  • Verification starts a web browser and displays the Verification web page.

Buttons

The Administration window has the following buttons.

Button Description

Exit

Exits the CiscoWorks Blue Administration application.

Help

Displays online help in a web browser window.

Discovering Devices for the Database

Use the CiscoWorks Blue Administration application to discover devices for the database. Use the following procedure to discover devices in the database:

Step 1 In the Discover field of the CiscoWorks Blue Administration window, select one or more of the following protocol types:

Step 2 Then select a method of discovery:

The appropriate discover processes are started to discover enabled devices and add them to the CiscoWorks Blue database. You will see a "Work in Progress" dialog while discovery is in progress. (The "Work in Progress" window is shown in Figure 7-2.)


Figure 7-2: Discovery Work In Progress Window

Seed File Discover Window

Use the Seed File Discover window to select a seed file for discovery.

Fields

The Seed File Discover window has the following fields:

Field Description

Filter

In this field you construct a filter rule that controls the paths and files that are displayed in the Directories and Files fields.

Directories

Displays the directories that meet the requirements of the filter.

Files

Displays the files that meet the requirements of the filter.

Selected Seed File

Displays the seed file you selected.

Default Read Community

Displays the default read community string for this seed file. You can change this value.

Buttons

The Seed File Discover window has the following buttons:

Button Description

Discover

Starts the discover process from the selected seed file.

Filter

Applies the path and file name rule from the Filter field to the Directory and Files fields.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Key Device Selection window.

Adding Devices to the Database

You can add one or more devices to the database manually.

If a Cisco device does not appear on a map or web page, but you know that the device exists in the network, you can add the device using the Add button.

When you add a device, the application prompts you for the device's host name or IP address and read community string. The application then places the new device in the database. Use the following procedure to add a device:

Step 1 From the CiscoWorks Blue Administration window select Add. The Add Devices window (Figure 7-3) is displayed.

See the topic "Add Device Window" for information about the Add Device window.


Figure 7-3: Add Devices Window

Step 2 In the Device name field, enter the host names or IP addresses, separated by spaces, of the devices that you want to add.

Step 3 In the Read Community field enter the read community string of the device that you want to add.

Step 4 Click OK.

The new device is added to the database. After you add new devices, the DLSw poller and cwbsnamapsd are automatically restarted to update the database with circuit information used in SNA correlation and to update the cwbsnamapsd cache with current TN3270 and APPN information.

Add Device Window

Use the Add Device window to add a new device to the CiscoWorks Blue database.

Fields

The Add Device window has the following fields:

Field Description

Device Name

Name of the device to add.

Read Community

Read community string of the device to add.

Buttons

The Add Device window has the following buttons:

Button Description

OK

Adds the specified device.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Add Device window.

Deleting a Device From the Database

Use the Delete button to remove devices from the database. You might not want the devices for the following reasons:

Use the following procedure to delete unwanted devices from the database:

Step 1 From the CiscoWorks Blue Administration window, select Delete. The Delete Devices window (Figure 7-4) is displayed. The Devices field of the Delete Devices window lists all the devices (routers) in the database.

See the topic "Delete Device Window" for information about the Delete Device window.


Figure 7-4: Delete Devices Window

Step 2 In the Devices field, select all the devices that you want to delete.

Step 3 Click the >> button to move the selected devices into the Selected field.

Step 4 If you inadvertently move devices to the Selected field but do not want to delete them, select all the devices that you do not want to delete and click the << button to move them back to the Devices field.

Step 5 Click OK.

The selected devices are deleted from the database.

Delete Device Window

Use the Delete Device window to delete a device from the CiscoWorks Blue database.

Fields

The Delete Device window has the following fields:

Field Description

Devices

Displays the devices currently in the database.

Selected

Displays the devices to be deleted. Use the >> and << buttons to move devices between the Devices field and the Selected field.

Buttons

The Delete Device window has the following buttons:

Button Description

<< and >>

Moves devices between the Devices field and the Selected field.

OK

Deletes the specified devices.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Delete Device window.

Modifying a Device in the Database

Change the read community string for one or more devices using the following procedure:

Step 1 From the CiscoWorks Blue Administration window, select Modify. The Modify Devices window (Figure 7-5) is displayed.

See the topic "Modify Devices Window" for information about the Modify Devices window.


Figure 7-5: Modify Devices Window

Step 2 In the Devices field, select all the devices that you want to modify.

Step 3 Click the >> button to move the selected devices into the Selected field.

Step 4 If you inadvertently move devices to the Selected field but do not want to modify them, select all the devices that you do not want to modify and click the << button to move them back to the Devices field.

Step 5 In the Read Community field, enter a new read community string to be applied to all the selected devices.

Step 6 Click OK.

The read community string is changed in the CiscoWorks Blue database (not in the router itself) for the selected devices.

Modify Devices Window

Use the Modify Devices window to change the read community string for a device in the CiscoWorks Blue database.

Fields

The Modify Devices window has the following fields:

Field Description

Devices

Displays the devices currently in the database.

Selected

Displays the devices to be modified. Use the >> and << buttons to move devices between the Devices field and the Selected field.

Read Community

Specifies the new read community string for the selected devices.

Buttons

The Modify Device window has the following buttons:

Button Description

<< and >>

Moves devices between the Devices field and the Selected field.

OK

Changes read community string for the specified devices.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Modify Device window.

Rediscovering a Device

You may want the discovery process to rediscover a device if that device is now running different protocols or when you just want to update the database information about that device but you do not want to wait until the next polling interval. Use the following procedure to rediscover a device:

Step 1 From the CiscoWorks Blue Administration window, select Rediscover. The Rediscover Devices window (Figure 7-6) is displayed.

Step 2 In the Devices field, select all the devices that you want to rediscover.

If you select more than one device to rediscover, by pressing the Ctrl or Shift key while you select devices, they must all have the same read community string.

Step 3 Click the >> button to move the selected devices into the Selected field.

Step 4 If you inadvertently move devices to the Selected field but do not want to rediscover them, select all the devices that you do not want to rediscover and click the << button to move them back to the Devices field.

Step 5 Click OK.

The devices are rediscovered. After you rediscover devices, the DLSw poller and cwbsnamapsd are automatically restarted to update the database with circuit information used in SNA correlation and to update the cwbsnamapsd cache with current TN3270 and APPN information.


Figure 7-6: Rediscover Devices Window

Rediscover Devices Window

Use the Rediscover Devices window to rediscover a device in the CiscoWorks Blue database.

Fields

The Rediscover Devices window has the following fields:

Field Description

Devices

Displays the devices currently in the database.

Selected

Displays the devices to be rediscovered.

Read Community

Specifies the read community string for the selected devices.

Buttons

The Rediscover Devices window has the following buttons:

Button Description

<< and >>

Moves devices between the Devices field and the Selected field.

OK

Rediscovers the specified devices.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Rediscover Device window.

Specifying DLSw Key Devices

You can specify one or more devices as DLSw key devices using the following procedure:

Step 1 From the CiscoWorks Blue Administration window, select DLSw Key. The DLSw Key Device Selection (Figure 7-7) window is displayed.

See the topic "Key Device Selection Device Window" for information about the Key Device Selection window.


Figure 7-7: DLSw Key Device Selection Window

Step 2 In the Devices field, select all the devices that you want to make key devices.

Step 3 Click the >> button to move the selected devices into the Selected field.

Step 4 If you inadvertently move devices to the Selected field but do not want to designate them as key devices, select all the devices that you do not want to designate and click the << button to move them back to the Devices field.

Step 5 Click OK.

The devices in the Selected field become DLSw key devices. After you add key devices, the DLSw poller is automatically restarted to update the database with circuit information used in SNA correlation.

Key Device Selection Device Window

Use the Key Device Selection window to designate DLSw key devices from the CiscoWorks Blue database, or to deselect current key devices.

Fields

The Key Device Selection window has the following fields:

Field Description

Devices

Displays the DLSw devices that are not key devices.

Selected

Displays the DLSw devices that are designated as key devices.

When you click OK, the devices in the Selected field become key devices while the devices in the Devices field are not key devices.

Buttons

The Key Device Selection window has the following buttons:

Button Description

<< and >>

Moves devices between the Devices field and the Selected field.

OK

Designates the devices in the Selected field as DLSw key devices. Designates the devices in the Devices field as not key devices.

Cancel

Cancels the operation and returns to the previous window.

Help

Displays online help for the Key Device Selection window.

Launching the Process Manager Client

You can launch the Process Manager client from the Administration window. From the CiscoWorks Blue Administration window, click Process Manager. The Process Manager client application starts and the Process Manager window is displayed.

See "Using Process Manager" for information about using Process Manager.

Launching the Message Log Client

You can launch the Message Log client from the Administration window. From the CiscoWorks Blue Administration window, click Message Log. The Message Log client window is displayed.

See "Using the Message Logger" for information about using the Message Log viewer.

Launching the Installation Verification Web Page

You can launch the Installation Verification web page from the Administration window. From the CiscoWorks Blue Administration window, click Verification. The web browser is started, which displays the Verification web page. The Verification web page verifies the protocols that you configured during installation, checks the cwbinit configuration file, and checks the CiscoWorks Blue database.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu Sep 9 08:58:44 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.