Configuration Manager

This chapter includes the following sections:

• conversions that take place internally on fields (conversions)

• default visual layout for fields in the Event List (visuals)

• menus and icons associated with particular classes of object (objects)

• menus displayed (menus)

• predominate resolutions for particular classes of problems (resolutions)

You can configure these options from the Configuration Manager.

You can also edit the Cisco Info Server properties; however, this is available only to super users.

host% $OMNIHOME/bin/nco_config &

Select the File menu's Exit option to exit the Configuration Manager tool.

The following sections describe each of the configuration options.

At the top is a list of all the currently known conversions, displayed as column name, value, and string.

Below the list are fields used to specify and edit new conversions. These fields are Column, which displays the name of the column in the Cisco Info Server, Value, which displays the integer value for the conversion, and Conversion, which displays the string the value is converted to.

Below these fields are the list editing buttons, New, Update, Delete, and Cancel.

When you click on the arrow buttons next to the Value field, the Value field increments or decrements by one. When the required changes have been made, click on the Update button to update the entry in the displayed list. When you do not click on the Update button, the changes are discarded. When you wish to discard the changes made, click on the Cancel button.

For each field in an alert, you can set the title text, title justification, data justification, and the default and maximum widths for the field.

At the top of the window is a list of all columns which have visual settings defined. Below this is a set of fields which are used for the entry and editing of the visuals.

The Column field displays the name of the column with which the attributes are associated. To the right is an option button which controls the justification of data displayed for that field, which can be Left, Right, or Center.

Below this is the Title field, which contains the title to be displayed for that column. To the right of this field is an option button for controlling the justification of the title text.

Below this are two sliders. The Default Width slider controls the default character width of the field when displayed. The Maximum Width slider controls the maximum width for the field in the View Builder.

At the top of the window, a list is displayed showing all of the known classes in the system.

Below this are fields used for displaying, specifying, and editing the class information. The Identifier field is used to display the numeric value of the class. Note, an identifier value of 0 is used as the default class and is used when no class has been set in an alert.

The Name field is used to specify the text string to be displayed when you refer to the class.

The Menu field is used to specify the name of a menu associated with the class.

Below this is an Image Selector pane for selecting the icon associated with the class. Move the slider or click on the left and right arrow buttons to move through the library of available images.

When the required changes are made, click on the Update button to update the entry displayed in the list. When you do not click on the Update button, the changes are not applied. When you wish to discard the changes, click on the Cancel button.

Note, deleting a menu deletes the menu and all of its associated options.

1. Select the menu entry.

2. Select the menu option to be changed.

3. Edit the Title, Command, Redirect Output, and Redirect Errors fields.

4. Click on the Update button. To discard the changes, click on the Cancel button.

1. Move the cursor in the Command field to where the information is to be inserted.

2. Click on the Elements button.

1. Select the type of variable you wish to insert from the Type option button.

2. When you have selected a type, scroll down the list and select the variable to insert into the scrolled list. Click on the Apply button. The Elements window remains open, however, the appropriate string is inserted into the command string.

3. Click on the Close button to close the Elements window.

These parameters are gathered before a tool starts running and the information entered is substituted into the command.

1. Move the cursor in the Command field to where you wish the substitution to take place.

2. Click on the Parameters button.

For any one parameter, the system must be provided a name for the prompt, the text to use in the prompt, the type of entry (for example, String or Integer), and when required, a default setting for the field.

1. Specify the name of the parameter in the Name field.

2. Specify a prompt in the Prompt field.

3. Select a parameter prompt type: String, Integer, Float, Choice, Lookup, or Password:
When you select either String, Integer, or Float parameters, the only active field is the Default field, which should contain the string which initially appears in the field. The only difference between these three types of parameters is the characters each field accepts. A String parameter accepts any character, Integer accepts the characters 0-9, and Float accepts 0-9 and decimal point (.).

When you select the Choice parameter type, this allows you to create an option button with a fixed set of options. When you select Choice, this enables the scrolling list below the Default entry. Below the list are the list editing buttons, which operate in the same manner as the other list editors in nco_config. There is one additional button, Clear which deletes all the entries in the list.

When you select the Lookup parameter type, this works the same as Choice, except that instead of entering the choices into the scrolled list, the parameter refers to a file on disk. Each line of this file is used as a choice. To select the file, either specify the file name in the Filename field or click on the Browse button, which displays a file selection dialog to select the file. Note, this file must be available on the machine running the Cisco Info Admin Desktop tools.

When you select the Password parameter type, this operates the same as the String type, except that when the command prompt appears, any text entered is obscured.

4. Click on the Apply button.

Table 4-4: Menu Options

Menu	Menu Options
ConductorMenu	Create Event List
DefaultMenu
MainEventListMenu	Desktop Information Create Event List Ovw (HP OpenView)
SubEventListMenu	StrataView Desktop
ObjViewMenu
ObjViewMapMenu
Class1005-menu	Administration GUI Get Configuration Equipment Manager
Class1006-menu	Administration GUI Get Configuration CiscoView
Class1010-Menu	Administration GUI Decode BitMap Equipment Manager
Class1011-Menu	Administration GUI Get Configuration Decode BitMap CiscoView
Class1015-Menu	Administration GUI Get Configuration Equipment Manager
Class1016-Menu	Administration GUI Get Configuration CiscoView
Class1020-BPX-Menu	Administration GUI Get Configuration Real Time Counters Test Delay Add Loopback Delete Loopback
Class1020-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback
Class1021-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback CiscoView
Class1025-Menu	Administration GUI Get Configuration Real Time Counters Decode BitMap Equipment Manager
Class1026-Menu	Administration GUI Get Configuration Real Time Counters Decode BitMap CiscoView
Class1030-Menu	Administration GUI Get Configuration Real Time Counters Decode BitMap Equipment Manager
Class1031-Menu	Administration GUI Get Configuration Real Time Counters Decode BitMap CiscoView
Class1035-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback Decode BitMap Equipment Manager
Class1036-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback Decode BitMap CiscoView
Class1040-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback Equipment Manager
Class1041-Menu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback CiscoView
Class1045-Menu	Administration GUI Get Configuration Real Time Counters
Class1046-Menu	Administration GUI Get Configuration Real Time Counters CiscoView
Class1050-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback
Class1051-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback CiscoView
Class1055-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback
Class1056-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback CiscoView
Class1060-Menu	Administration GUI Get Configuration
Class1061-Menu	Administration GUI Get Configuration CiscoView
Class1065-Menu	Administration GUI Get Configuration
Class1066-Menu	Administration GUI Get Configuration CiscoView
Class1070-Menu	Administration GUI
Class1071-Menu	Administration GUI CiscoView
Class1075-Menu	Administration GUI Get Configuration Decode BitMap
Class1076-Menu	Administration GUI Get Configuration Decode BitMap CiscoView
Class1080-Menu	Administration GUI Get Configuration Real Time Counters Equipment Manager
Class1081-Menu	Administration GUI Get Configuration Real Time Counters CiscoView
Class1085-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback Equipment Manager
Class1086-Menu	Administration GUI Get Configuration Real Time Counters Add Loopback Delete Loopback CiscoView
Class1090-Menu	Administration GUI Decode BitMap Equipment Manager
Class1091-Menu	Administration GUI Decode BitMap CiscoView
Class1095-Menu	Administration GUI Get Configuration Decode BitMap Equipment Manager
Class1096-Menu	Administration GUI Get Configuration Decode BitMap CiscoView
Class1123-Menu	Administration GUI Get Configuration Real Time Counters CiscoView
Class1125-Menu	Administration GUI Get Configuration CiscoView
Class1127-Menu	Reserved
Class1305-Menu	Administration GUI Get Configuration Equipment Manager
Class1306-Menu	Administration GUI Get Configuration CiscoView
Class1307-Menu	Administration GUI Real Time Counters Equipment Manager
Class1308-Menu	Administration GUI Real Time Counters CiscoView
BPXEndpointMenu	Administration GUI Get Configuration Real Time Counters Test Delay Add Loopback Delete Loopback
FREndpointMenu	Administration GUI Get Configuration Real Time Counters Test Connections Test Delay Add Loopback Delete Loopback
FTCPort	Administration GUI Get Configuration Add Loopback Delete Loopback

• $DISPLAY

• @NEAddress

• $DISPLAY

• @NEAddress

• $DISPLAY

• @NEAddress

• $DISPLAY

• @ObjectType

• @NEType

• @NEName

• @Slot

• @PSAP

• @LSAP

• @DSAP

The Real Time Counters tool launches a GUI that allows you to pick a list of the counters you would like to monitor. The list is dynamically created based on the value in the ServiceType field. This selection tool provides you with the option to pick an interval for launching the polls to the network element and the display mechanism, grapher or textual.

• $DISPLAY

• @NEName

• @Slot

• @NEType

• @ServiceType

• @ObjectType

• @PSAP

• @LSAP

• @DSAP

• @NEAddress

• $DISPLAY

• $Proxy - ConProxy Agent

• @NEType

• @Node

• @NEName

• @Slot

• @PSAP

• @LSAP

• @DSAP

• @ObjectType

• @ServiceType

• Delay (Conn|Delay)

• $DISPLAY

• $Proxy - ConProxy Agent

• @NEType

• @Node

• @NEName

• @Slot

• @PSAP

• @LSAP

• @DSAP

• @ObjectType

• @ServiceType

• Delay (Conn|Delay)

The tool performs the loopback addition by logging into the Cisco SV+ machine using the user name and password provided above, and then logging into the network element from the Cisco SV+ machine and sending the appropriate Add Loopback Command. An Xterm window is displayed on the Cisco Info Admin Desktop machine from where the tool is launched, indicating the progress of this tool.

The tool performs the loopback deletion by logging into the Cisco SV+ machine using the user name and password provided above, and then logging into the network element from the Cisco SV+ machine and sending the appropriate Delete Loopback command. An Xterm window is displayed on the Cisco Info Admin Desktop machine from where the tool is launched, indicating the progress of this tool.

The tool converts the value stored in the BitMap by using the contents of the Convert field which stores a pointer to an external lookup file. Upon conversion, this tool displays the converted values with the set bit positions on the Cisco Info Admin Desktop screen.

• $DISPLAY

• @BitMapField

• @Convert

For example, to create a filtered Event List with monitor boxes for all ObjectTypes present in the Cisco Info Server alerts table, specify the field name ObjectType when prompted with:

Pick Database Field

This tools runs on the Cisco Info Admin Desktop and provides the following information:

• Info Center User - user name logged into the Cisco Info Server

• Cisco Info Server - name of Cisco Info Server connected to

• License Servers - indicates where the Cisco Info Admin Desktop is getting the license

• UNIX User - UNIX user that started the Conductor

• Internal X Display - X display set by the Conductor

• External X Display - X display as set in shell that executed the Conductor

• Calculated Display - X display where the tools send the display

• UNIX Host Info - architecture, operating system, and name of the UNIX host

• Info Center version and patch information.

Mandatory requirements for launching processes using Automation are:

1. The DISPLAY variable must always be passed.

2. Process Control must always be configured and running on the application server.

3. Process Control record must be configured on the Cisco Info Server host when the application servers are different than the Cisco Info Server host.

OMNIHOME=/opt/Omnibus

The absolute path of the executable:

EXEC=$OMNIHOME/utils/AdminGUI/admingui

The following lines set up the DISPLAY variable to be passed as a parameter:

if [ "x\Qecho %display|cut -d: -f1\Q" = "x" ]; then

DISPLAY=\Qhostname\Q:0.0

else

DISPLAY=%display

fi

export DISPLAY

xhost $NODE

Argument line to be passed to the external actions in automation:

ARGLINE="$DISPLAY @NEAddress"

The following lines set up the unique ID for the automation:

ID=${NODE}agui%display\Qdate|sed 's/[ :]//g'\Q

IDENT=\Qecho $ID|sed 's/[ :/.]//g'\Q

The following lines add the automations to the auto.triggers and auto.actions tables using nco_sql:

$OMNIHOME/bin/nco_sql -server %server -user %username -password %password <<EOF

insert into auto.triggers values ('$IDENT','select * from auto.actions;','','','','$IDENT','',0,1,1,1,0,0,0,'','','','');
insert into auto.actions values ('$IDENT',1,'delete from auto.actions where Name = \'$IDENT\';delete from auto.triggers where Name = \'$IDENT\';','','','',1,'$EXEC','$ARGLINE','$NODE',0,0,'','','','','','','','' );

go
quit
EOF

auto.triggers:
select * from auto.actions

auto.actions:
Internal Effect: delete from auto.actions where Name = $IDENT;

External Effect: Executable - $EXEC

Arguments: $ARGLINE
Host - $NODE
User - 0

When you select the Alerts menu's Resolve option with an alert selected, the menu displays all the resolutions defined for the class value of that alert. When you select a resolution, the text defined for the resolution is appended to the alerts journal, along with user name and timestamp, and the alert is set to clear.

1. Select the class you want to associate with the resolution in the upper list of classes.

2. Click on the New button.

3. Specify the title for the resolution in the Title field; this text becomes the displayed menu option.

4. Click in the Resolution Text field and specify the text for the resolution; this text becomes the entry in the Journal when the resolution is used.

5. Click on the Update button, which is highlighted in red, to add the resolution.

1. Select the class that has the resolution associated with it in the upper list of classes. The Resolutions List is modified to show the currently installed resolutions.

2. Select the resolution you wish to change. You can now edit the Resolution Text but not the Title.

To create a new title, create a new resolution and delete the old resolution. Once the Resolution Text has been changed, the Update button turns red. Click on the Update button to make the changes.