[Top] [Prev] [Next] [Bottom]


4 - Using the Configuration Tool

The Cooperative Consoles Configuration Tool allows you to configure the CC Sender and Receiver on the local Site/SunNet/Domain Manager Console host. The Configuration Tool allows you to define the following: You invoke the Configuration Tool from the Site/SunNet/Domain Manager Console's Tools Menu, as shown in Figure 4-1 .

Figure  4-1 Selecting Configuration Tool from the Console Tools Menu
Invoking the Configuration Tool displays the main menu as shown in Figure 4-2 .

Figure  4-2 CC Configuration Tool Main Menu
To configure the action of the local Sender daemon, click SELECT on the Sender button. To configure the Receiver application on the local host, click SELECT on the Receiver button.


4.1 Configuring the Cooperative Consoles Receiver

If you select the Receiver button from the CC Configuration main menu, the Receiver Configuration window appears, as shown in Figure 4-3 .

Figure  4-3 Receiver Configuration Window
The Receiver Configuration window allows you to build the registration list that determines the remote management stations that the local Receiver process will attempt to register with when it is launched. You can also specify the manner of automatic synchronization of the receiving station with remote sending stations.

4.1.1 Adding a New Entry to the Registration List

To add a new entry to the Registration List, you need to enter the appropriate information in the three fields at the bottom of the list window:

After you have added this information, click SELECT on the Add button to add the new entry to the Registration List. A sample Registration List is shown in Figure 4-4 .

Figure  4-4 Sample Registration List

4.1.2 Modifying an Entry in the Registration List

If you want to change one of the existing entries in the Registration list, do the following:

1. Click SELECT on the entry that you want to change. The entry should now be highlighted.


2. The values for the three fields in the selected entry should now be displayed in the Sender Hostname, Database Name, and Filter File fields at the bottom of the screen. Edit these fields to make your desired changes.


3. Click SELECT on the Change button for your changes to take effect.

4.1.3 Deleting an Entry from the Registration List

To delete one of the entries from the Registration List, click SELECT on the entry to highlight it, then click SELECT on the Delete button.

4.1.4 Saving the Registration List

After you have finished adding or modifying entries in the Registration List, be sure to click SELECT on the Apply button to save your changes.

4.1.5 Abandoning Changes to the Registration List

If you want to abandon the changes you have made to the Registration List and revert to the previously saved version of the Registration List, click SELECT on the Reset button.


4.2 Configuring the Sender Daemon

If you select the Sender button from the CC Configuration main menu, the Sender Configuration window appears, as shown in Figure 4-5 .

Figure  4-5 Sender Configuration Window
If you press the MENU button over the Category button, as shown in Figure 4-6 , a menu appears with the following options:

Figure  4-6 Sender Configuration Category Options

4.2.1 Setting Up the Authorization List


NOTE - Refer to
Section 4.2.3, "Specifying Topology Information for Forwarding " for information on how to set up the Database Template and Section 4.2.4, "Setting Up the Trap Selection Template " for Trap Selection Template discussions.
As shown in Figure 4-7 , the local Sender's authorization table contains two columns: Remote Receiver Host and Local Database Name.

Figure  4-7 Authorization List Properties Sheet
Two fields at the bottom of the window enable you to create and modify rows in the Authorization List.

4.2.1.1 Adding a Remote Host to the Authorization List

If you want to enter a new row in this list, type in the host name of the receiving station in the Remote Receiver Host field. Also type a database name in the Local Database Name field. For example, if you want to authorize a remote host to access a database named db.localnet , you enter localnet in the Local Database Name field.

When you have entered the information that you want to specify for the receiving station, click SELECT on the Add button to add the specified host to the authorization list.

You can make multiple entries in the authorization list for the same remote host if that host is authorized to access more than one database, as shown in Figure 4-8 .

Figure  4-8 Sample Authorization List
For the example above, the machine netmgr1.Japan.Sun.Com has access to all three regions, db.john, db.central , and db.west.

4.2.1.2 Changing an Entry in the Authorization List

If you want to modify one of the entries (rows) in the authorization table, click SELECT on that row to highlight it. The information for that host is now displayed in the Remote Receiver Host and Local Database Name fields at the bottom of the window. After you have changed these values, click SELECT on the Change button to enter the changes into the table.

4.2.1.3 Removing a Remote Host from the Authorization List

If you want to delete one of the entries (rows) in the authorization list, click SELECT on that row to highlight it, then click SELECT on the Delete button.

4.2.1.4 Saving the Authorization List

After you have added new entries or made other changes in the Authorization List, click SELECT on the Apply button to save your changes.

4.2.1.5 Abandoning Changes to the Authorization List

If you want to abandon the changes you have made to the Authorization List and revert to the previously saved version, click SELECT on the Reset button.

4.2.2 Setting Up the Filter Table

The selection criteria used by the local Sender in forwarding SNMP traps, Glyph traps, SNM events, and topology information to registered receiving stations is contained in one or more filter files. The entries in each filter file constitute a single Filter Table. When you first select Filter Table from the Sender Configuration Category menu, the Filter Table properties sheet are blank, as shown in Figure 4-9 .


NOTE - Filtering is the most powerful and complex part of Cooperative Consoles. Please read and understand
Section 3.4.2.2, "Filtering Events and Traps for Forwarding " before you attempt to configure the Filter Table.

Figure  4-9 Sender Filter Table Window

4.2.2.1 Loading a Filter

You can either load an existing filter file or define a new filter table. To load an existing filter file, click SELECT on the Load button. You see a load window, as shown in Figure 4-10 .

Figure  4-10 File Load Window
The CC product provides several sample filter files as listed in the File List scroll menu. For example, to load the Infrastructure.ccf filter file, select Infrastructure.ccf from the file list, then click SELECT on the Open button.

These sample filter files are located in the following directory:

A sample Filter Table is shown in Figure 4-11 .

Figure  4-11 Sample Filter Table
Each row in the table is a filter that defines selection criteria and action to be taken if the events or traps match the selection criteria. Events and traps are checked against the filters in the table. See Section 4.2.2.2, "Adding a New Filter " for explanations of the different filter types.

4.2.2.2 Adding a New Filter

To add a new filter to a Filter Table, select the filter type. The filter types are listed if you press MENU on the Filter Type button, as shown in Figure 4-12 .

Figure  4-12 Filter Type Menu

Figure  4-13 Component Type Menu

Figure  4-14 View Type Menu

Figure  4-15 Events/Traps Menu
The following values are possible: All, Events Only, Traps Only, Glyphs Only, Events & Traps, Events & Glyphs, and Traps & Glyphs.
All SNMP Traps or SNM Events with a priority less than the priority selected in the Priority field are not selected. For example, if Medium is selected, then all traps and events with a lower priority than Medium are not selected.
After you have made all your selections for a single filter, click SELECT on the Add button if you want your selections to define a new filter (row) in the table.

Refer to Chapter 5, "Cooperative Consoles Examples " for the different filter entries examples.

4.2.2.3 Changing a Filter

To change the values of an existing filter in the filter table, do the following:


1. Click SELECT on the filter you want to change in the table.


2. Enter or select the values in the Filter Type, Name, Events/Traps,
Trap Template, Priority, New Priority, Action, and DB Template fields.


3. Click SELECT on the Change button to modify the values of the selected filter.

4.2.2.4 Deleting a Filter

To delete a filter in the Filter Table, click SELECT on the filter to be deleted and click SELECT on the Delete button.

4.2.2.5 Saving the Filter File

After you are finished adding new filters, deleting or modifying existing filters in the Filter Table, click SELECT on the Save button to save your changes to this filter file. For changes to existing filter files, select the filter file name from the file list scroll menu (for example, infrastructure.ccf) and click SELECT on the Save button, as shown in Figure 4-16 .

Figure  4-16 File Save Window

4.2.2.6 Abandoning Changes to the Filter File

If you want to abandon the changes you have made to the Filter Table and revert to the previously saved version of this filter file, click SELECT on the Reset button, as shown in Figure 4-11 .

4.2.3 Specifying Topology Information for Forwarding

The Site/SunNet/Domain Manager Console generates database traps in response to changes in the runtime database. When an SNM database trap is generated, the Sender daemon uses a filter table specified by a remote Receiver process to determine whether the trap should be forwarded to that Receiver process. Within the filter table, a Database Template file is specified to determine the topology information to be forwarded or dropped.

The Database Template files used for selecting topology information to be forwarded/dropped depend on the filter file requested by the Receiver at the time it registered with the local Sender daemon.

Each filter entry in the filter file can specify a DB Template file to be used for elements that match the selection criteria of that filter. The element is selected by the criteria as mentioned under Section 3.4.2.2, "Filtering Events and Traps for Forwarding ."

Database Template files are only accessed in response to SNM database traps.

4.2.3.1 Setting Up the Database Template

To configure a Database Template file, select Database Template from the Sender Configuration Category menu. When initially selected, the Database Template window is blank, as shown in Figure 4-17 .

Figure  4-17 Database Template Window

4.2.3.2 Loading a Database Template File

You can either load an existing Database Template file or create a new Database Template. To load an existing Database Template file, click SELECT on the Load button. A Database Template Load window appears, as shown in Figure 4-18 .

Figure  4-18 Database Template Load Window
The CC product provides several sample database template files as listed in the File List scroll menu. For example, to load the passall.cct database template file, select passall.cct from the file list, then click SELECT on the Open button.

These sample database template files are located in the following directories:

The passall.cct sample Database Template is shown in Figure 4-19 .

Figure  4-19 Sample Database Template

4.2.3.3 Adding a Database Trap Type Entry

To add an entry for one of the SNM database trap types, press MENU over the Trap Type button, as shown in Figure 4-20 , and select one of the available trap types.

Figure  4-20 Trap Type Menu
A Database Template can contain six entries (rows). Each entry corresponds to one of the following types of SNM database trap:

NOTE - Due to the design limitation, Background is not supported at this release.

NOTE - Due to the design limitation, the Delete trap cannot be dropped.
To specify the type of action to be taken for one of these SNM database trap types, an entry for that type must be in the template. If no entry is specified for a database trap type in the template, then that particular trap type is dropped.

The following table outlines the types of topology information that can be passed for each database trap type:

Table  4-1 Database Template Format
Trap Type
Keywords (one or more can be specified)

Add  

membership, color, agents, attributes, connections, drop  

Background  

drop  

Change  

membership, color, agents, attributes, connections, drop  

Create  

membership, color, agents, attributes, connections, drop  

Delete  

drop  

Load  

membership, color, agents, attributes, connections, drop  


The keywords used determine the forwarded content for each of the available trap types. The keywords have the following interpretation:

Each of these buttons is a toggle -- click SELECT on the button to turn it off or on. The button is on when it is highlighted.

After you have selected the desired combination of values for these six toggles, click SELECT on the Add button to add an entry for this trap type to the template.

If no information (for example, Color) is selected for a trap type in the database template, then the information (in this case, color) is not passed.


NOTE - Agents, Attributes, Color, and Connections buttons have no effect for database traps of types Background or Delete.

4.2.3.4 Changing the Forwarding Specified for a Trap Type

If you want to modify the topology information specified for a trap type in the Database Template, do the following:


1. Click SELECT on the trap type entry you want to change.
The six buttons along the bottom of the window should be highlighted to indicate the selected values for that trap type.


2. Make the desired changes in the forwarding action for this trap type.
Click SELECT on the Agents, Attributes, Color, Connections, Drop, or Membership buttons.


3. Click SELECT on the Change button to apply your selections to the Database Template entry.

4.2.3.5 Deleting a Database Trap Type Entry

You can delete the existing entry in the Database Template for a particular trap type if you click SELECT on that entry, then click SELECT on the Delete button.

4.2.3.6 Saving the Database Template

After you have added new trap type entries, or deleted or modified existing trap type entries in the Database Template, click SELECT on the Save button to save your changes to this Database Template file. For changes to existing database template files, select the database template file name from the file list scroll menu (for example, views-only.cct ) and click SELECT on the Save button, as shown in Figure 4-21 .

Figure  4-21 Database Template Save Window

4.2.3.7 Abandoning Changes to the Database Template

If you want to abandon the changes you have made to the Database Template and revert to the previously saved version of this Database Template file, click SELECT on the Reset button.

4.2.4 Setting Up the Trap Selection Template

To configure a Trap Selection Template file, select Trap Selection Template from the Sender Configuration Category menu. This template allows the user to filter only SNMP traps based on the trap type (Standard/Enterprise) and trap numbers. When initially selected, the Trap Selection Template window displays the available Enterprise traps names, as shown in Figure 4-22 .

Figure  4-22 Trap Selection Template Window

4.2.4.1 Loading a Trap Selection Template File

You can either load an existing Trap Template file or create a new Trap Template. If you want to load an existing Trap Template file, click SELECT on the Load button. A Trap Template Load window appears, as shown in Figure 4-23 .

Figure  4-23 Trap Selection Template Load Window
You are prompted to enter the trap selection template file name. If you want to load an existing trap selection template file, select this file name from the File List scroll menu, then click SELECT on the Open button.

As shown in Figure 4-22 , the Sender's Trap Selection Template contains these columns:

To create and modify rows in the Trap Selection Template, use the Enterprise Name table and the Trap number list field at the bottom of the window.

4.2.4.2 Adding a Trap Type Entry

If you want to enter a new row in this list, follow these steps:


1. Click SELECT on the enterprise names provided in the Enterprise Name field.
These names are sorted alphabetically (except for the first two items).


2. Enter a list of trap numbers by typing the numbers or ranges separated by commas in the Trap No. List field.
If this field is left blank, then all traps for the selected enterprise are specified.
After you have entered the information, click SELECT on the Add button to add the specified Enterprise names and trap numbers to the trap template file.

4.2.4.3 Changing a Trap Type Entry

If you want to modify one of the entries (rows) in the trap selection template, click SELECT on that row to highlight it. The information for that trap is now highlighted in the Enterprise Name table. From this table, scroll up or down to select a new enterprise name. Also, enter the desired trap numbers in the Trap No. List field then click SELECT on the Change button to enter the changes into the template.

4.2.4.4 Deleting a Trap Type Entry

To delete a trap type in the Trap Selection Template, click SELECT on the trap to be deleted, then click SELECT on the Delete button.

4.2.4.5 Saving the Trap Type File

After you have finished adding new trap type entries, or deleting or modifying existing trap type entries in the Trap Selection Template, click SELECT on the Save button to save your changes to this Trap Selection Template file. You are prompted to enter the name of the Trap Selection Template file. If you are saving changes to an existing trap selection template file, select it from the file list scroll menu, then click SELECT on the Save button, as shown in Figure 4-24 .

Figure  4-24 Trap Selection Template Save Window

4.2.4.6 Abandoning Changes to the Trap Selection Template

If you want to abandon the changes you have made to the Trap Selection Template and revert to the previously saved version of this template file, click SELECT on the Reset button.


4.3 Configuring Cooperative Consoles for
Internationalization

The default locale for cc_sender is C (C locale). However, whatever locale a particular SNM database is created in, that same locale should be used for the cc_sender. The cc_sender can be instructed to use the locale for particular databases with the following file:

/var/opt/SUNWconn/snm/cc_files/cc_sender.lang

The format of this file is as follows:

<database_name1> <locale_name1>
<database_name2> <locale_name2>
<database_name3> <locale_name3>

For example, to set the database mydb in Japanese (ja) locale and the database yourdb in C locale, you would configure the cc_sender.lang file as follows:

mydb ja
yourdb C



[Top] [Prev] [Next] [Bottom]

Copyright 1996 Sun Microsystems, Inc., 2550 Garcia Ave., Mtn. View, CA 94043-1100 USA. All Rights Reserved