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:

On SunNet Manager select Tools>CWB-ADMIN from the menu bar.
On HP-OV and NetView for AIX select CWBlue>ADMIN from the menu bar.

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:

From the K shell (ksh):

setenv DISPLAY


export DISPLAY=IP_address:0.0

From the C shell (csh) or TC shell (tcsh):

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. RSRB/SRB discovers RSRB devices and SRB rings. DLSw discovers DLSw devices. Remember to check RSRB/SRB if you also want to discover SRB rings. 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:

Select RSRB/SRB to discover devices that are running the RSRB protocol and to discover SRB rings.
Select DLSw to discover devices that are running the DLSw protocol.
Select Tn3270 to discover devices that are running the TN3270 protocol. To use this function, you must have a valid license for the SNA View application.
Select APPN to discover devices that are running the APPN protocol.

Note

cwbsnamapsd

Step 2 Then select a method of discovery:

Click By Seed File to discover the devices using a seed file. You are prompted for the seed file name.
Click By NMS to discover devices using the Network Management System database. (This option is not available when no network management system was selected during installation.)

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.

Adding Devices to the Database

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

You might want to add a device that is newly connected to the network.
You might want to add a device if a set of devices on a map is not current, perhaps because automatic update is disabled or is set to an infrequent interval and you have not chosen to list target devices in a seed file.

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-2) is displayed.

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

Figure 7-2: 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:

The devices might be in the database because you entered incorrect names in a seed file.
The devices are no longer running any of the managed protocols (DLSw, RSRB, APPN, or TN3270).
You now discover devices from the network management system and have several devices that will never run a managed protocol.
You have a device that is running a managed protocols but you do not want to manage (poll) that device.
You want to speed up the discovery process by deleting devices that are not running any of the managed protocols (the discovery process always tries to rediscover devices that are in the database but which are not running the selected protocol).

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-3) 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-3: 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-4) is displayed.

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

Figure 7-4: 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-5) 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-5: 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-6) window is displayed.

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

Figure 7-6: 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 the "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 the "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.

Table of Contents

Using the Administration Application

Fields

Buttons

Fields

Buttons

Fields

Buttons

Fields

Buttons

Fields

Buttons

Fields

Buttons