tivoli netcool performance manager: omnibus/webtop ... · pdf filetivoli netcool performance...

Tivoli Netcool Performance Manager: OMNIbus/Webtop Integration Guide - Wireless component

Netcool Performance Manager

Version 1.2.1

Note

Before using this information and the product it supports, read the information in Notices on page 35.

This edition applies to version 1, release 2, modification 1 of Tivoli Netcool Performance Manager and to all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright IBM Corp. 2007, 2009

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

1 About This Documentation . . . . . . . . . . . . 1Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Blank pages . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Document Structure . . . . . . . . . . . . . . . . . . . . . . . 3

2 Pre-integration, questions and pre-requisites 5Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Questions to Ask Before Going On-Site . . . . . . . 5Software Requirements and Dependencies . . . . . 5TRAPD Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . 6ObjectServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Tivoli Netcool OMNIbus/Webtop Menu . . . . . . 6

3 Integrating with Tivoli Netcool OMNIbus/Webtop 7Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Integration Strategy . . . . . . . . . . . . . . . . . . . . . . . 7OMNIBus Server Configuration for Wireless Trap Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Adding support to the ObjectServer Database Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Updating TRAPD Rules . . . . . . . . . . . . . . . . 10

Installation Integration Module . . . . . . . . . . . . . 12Tool Definition . . . . . . . . . . . . . . . . . . . . . . . 12JavaScript Details . . . . . . . . . . . . . . . . . . . . . 13Creating a New Tool and Menu Option in Webtop for OMNIbus 7.2 . . . . . . . . . . . . . . . 14Creating a New Tool and Menu Option in Webtop for OMNIbus 7.3 . . . . . . . . . . . . . . . 22

Report Generation . . . . . . . . . . . . . . . . . . . . . . . 31Opening the report . . . . . . . . . . . . . . . . . . . . 31Tivoli Netcool Performance Manager User Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Tivoli Netcool Performance Manager Session Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Java Plugin Support . . . . . . . . . . . . . . . . . . . 32Using Existing ObjectServer Alert Data Table Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Configuring Alarm exporter Tivoli Netcool Performance Manager . . . . . . . . . . . . . . . . . . 34

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

© Copyright IBM Corp. 2007, 2009 i

ii IBM Tivoli Netcool Performance Manager: OMNIbus/Webtop Integration Guide - Wireless component

1 About This Documentation

The purpose of this guide is to help integrate IBM® Tivoli® Netcool® Performance Manager with Tivoli Netcool OMNIbus/Webtop.

This guide also explains upgrading an integration, if you are upgrading an integration you need only follow the instructions in Upgrading support to the ObjectServer Database Schema.

1.1 AudienceThis guide is intended for network administrators or operations specialists responsible for installing the Tivoli Netcool Performance Manager product on an enterprise network.

1.2 Required Skills and KnowledgeTo integrate Tivoli Netcool Performance Manager successfully, you should be familiar with the following subjects:

• Basic principles of network management• SNMP concepts• Administration of your operating system• Administration of the database management system

1.3 Document ConventionsThis document uses the typographical conventions shown in the following table:

Table 1: General Document Conventions

Format Examples Description

ALL UPPERCASE

• GPS• NULL• MYWEBSERVER

Acronyms, device names, logical opera-tors, registry keys, and some data struc-tures.

Underscore See Document Conventions For links within a document or to the Inter-net. Note that TOC and index links are not underscored. Color of text is determined by browser settings.

© Copyright IBM Corp. 2007, 2009 1

1.3.1 Blank pages

Blank pages are used at the end of chapters to ensure the following chapter begins on an odd numbered page. These pages are intentionally blank. If the guide is printed double-sided and bound, each chapter will begin on a right-hand page.

Bold • Note: The busy hour determiner is... Heading text for Notes, and Warnings.

SMALL CAPS • The STORED SQL dialog box...• ...click VIEW...• In the main GUI window, select the

FILE menu, point to NEW, and then select TRAFFIC TEMPLATE.

Any text that appears on the GUI.

Italic • A busy hour is...• A web server must be installed...• See the User Guide

New terms, emphasis, and book titles.

Monospace • ./wminstall• $ cd /cdrom/cdrom0• /xml/dict• http://abc.com/products/• addmsc.sh• Type OK to continue.

Code text, command line text, paths, scripts, and file names. Text written in the body of a paragraph that the user is expected to enter.

Monospace Bold

[root] # pkginfo | grep -i perlsystem Perl5 On-Line Manual Pages

system Perl 5.005_03 (POD Docu-mentation)

system Perl 5.005_03

For contrast in a code example to show lines the user is expected to enter.

<Mono-space italics>

• # cd <oracle_setup> Used in code examples: command-line variables that you replace with a real name or value. These are always marked with arrow brackets.

[square bracket]

log-archiver.sh [-i][-w][-t] Used in code examples: indicates options.

Table 1: General Document Conventions (Continued)

Format Examples Description

2 IBM Tivoli Netcool Performance Manager: OMNIbus/Webtop Integration Guide - Wireless component

1.4 Document StructureThis document is organized in to the following chapters and appendices:

1.5 User PublicationsTivoli Netcool Performance Manager software provides the following user publications in HTML or Adobe® Portable Document Format (PDF) formats.

Table 2: Document Structure

Chapter Description

Pre-integration, questions and pre-requi-sites

Lists questions you should ask before performing the integration tasks. The chapter also provides information about rules, the ObjectServer, and the Tools menu.

Integrating with Tivoli Netcool OMNI-bus/Webtop

Explains the tasks associated with integrating Tivoli Netcool Performance Manager with the Tivoli Net-cool OMNIbus/Webtop.

Table 3: Tivoli Netcool Performance Manager User Documentation

Document Description

Administration Guide Provides instructions and general information on how to maintain and support Tivoli Netcool Performance Manager.

IBM Tivoli Monitoring Integration Guide

Provides instructions for integrating IBM Tivoli Monitoring with Tivoli Netcool Performance Manager.

Installation Guide Provides instructions for installing and configuring the Tivoli Netcool Performance Manager software.

ModelMaker Installation Guide

Provides instructions for installing the ModelMaker application.

ModelMaker User Guide Provides information and procedures for creating and modifying Busi-ness Objects universes to be used with Tivoli Netcool Performance Manager databases.

Netcool OMNIbus/Webtop Integration Guide

Provides instructions for integrating Netcool OMNIbus/Webtop with Tivoli Netcool Performance Manager.

Online Help Provides information and procedures for using Tivoli Netcool Perfor-mance Manager software for performance, trending analysis and per-formance alarms.

Upgrade Guide Instructions for upgrading Tivoli Netcool Performance Manager soft-ware.

User Guide Provides conceptual information and procedures for using Tivoli Net-cool Performance Manager software for performance, trending analy-sis and performance alarms.

About This Documentation 3

1.5.1 Viewing the Online Help

You can view Online Help for the Tivoli Netcool Performance Manager Web client. Using the Tivoli Netcool Performance Manager user interface, you can select HELP tabs or the HELP links for context-sensitive Help.


2 Pre-integration, questions and pre-requisites

2.1 IntroductionThis chapter discusses questions and pre-requisites the installer must ensure are resolved prior to performing the tasks required to integrate Tivoli Netcool Performance Manager with Tivoli Netcool/OMNIbus. The chapter also discusses information about rules, the ObjectServer, and the Tools menu.

Note: If you are upgrading an integration you need only follow the instructions in Upgrading support to the ObjectServer Database Schema.

2.2 Questions to Ask Before Going On-SiteObtain the following information before going on-site to install:

• Ιf the Netcool/Webtop Tools menu is to be customized by IBM personnel, ensure the administrative user and Webtop’s associated password are available.

• SNMP protocol (TRAPs) has to be permitted (see the customer’s firewall policy) between the Tivoli Netcool Performance Manager hosts and the SNMP TRAPD probe.

2.3 Groups and usersAll of the required users and groups must be set up on the system before integration.

A user must exist or be created, who has access to all event management tasks including Menu creation and tool creation. Ensure that the user is assigned to a group, For example: group1.

2.4 Software Requirements and Dependencies• Netcool/OMNIbus v7.x, including SNMP probe (mttrapd probe).• Netcool Knowledge Library (NcKL) v1.3 or later

Note: NcKL v1.4 (or later) contains TRAPD rules files for Tivoli Netcool Performance Manager. If v1.4 or later is installed, it is not necessary to update the system with these files.


2.5 TRAPD RulesThe following list identifies TRAPD rules:

• Tivoli Netcool Performance Manager provides an event feed only through Multi-Threaded SNMP Trapd probe.

• Tivoli Netcool Performance Manager provides rule files for Enterprise TRAPs issued by Tivoli Netcool Performance Manager.

2.6 ObjectServerThe following list identifies issues related to the ObjectServer:

• Tivoli Netcool Performance Manager’s preferred deployment needs expansion of NETCOOL’s AlertStatus Table in the ObjectServer. This document will provide a list and descriptions of the Tivoli Netcool Performance Manager specific fields that need to be added to the NETCOOL’s AlertStatus Table in the ObjectServer. It is the installer’s responsibility to modify the ObjectServer’s schema accordingly.

• If the customer does not want to expand NETCOOL’s AlertStatus Table in the ObjectServer, the customer must provide a list of compatible (type, size), existing unused ObjectServer fields that can be utilized. In this case, it is the installer’s responsibility to make the following modifications:

1. Modify the *.rule file in order to reflect the ObjectServer’s fields effectively used.

2. Using the nco_sql command or the nco_config GUI, ensure that the types of selected existing fields match exactly those required for the three Tivoli Netcool Performance Manager for Wireless trap fields required to be saved in the AlertStatus Table.

3. Modify the JavaScriptTM file tnpmforwireless.html to map the meaning of the columns used to well known URL parameter names that Tivoli Netcool Performance Manager for Wireless uses.

2.7 Tivoli Netcool OMNIbus/Webtop MenuTivoli Netcool Performance Manager’s default installation configures the Tivoli Netcool Performance Manager Report menu option to be at the top level of the ALERT menu, which is displayed when an event in the ACTIVE EVENT LIST is right-clicked. If the customer wants a different location for Tivoli Netcool Performance Manager tools, it is the customer’s responsibility to modify the tool’s configuration to move them to a different location. However, the menu option must be part of the ALERTS drop-down menu.


3 Integrating with Tivoli Netcool OMNIbus/Webtop

3.1 IntroductionThis chapter explains the tasks associated with integrating Tivoli Netcool Performance Manager with the Tivoli Netcool OMNIbus/Webtop application. The Tivoli Netcool OMNIbus/Webtop lets you view Netcool events in real time using your Web browser. It works in conjunction with the Netcool/OMNIbus application to retrieve realtime event data that lets you remotely monitor and manage your Netcool implementation. The Tivoli Netcool OMNIbus/Webtop customizable dashboards display realtime performance information and event data.

Important: If you are upgrading your integration, you need only follow the instructions in Upgrading support to the ObjectServer Database Schema.

Integrating Tivoli Netcool Performance Manager with Tivoli Netcool OMNIbus/Webtop combines Tivoli Netcool Performance Manager’s ability to generate SNMP traps when threshold violations are detected, with the Webtop application functionality.

The SNMP traps contain the Tivoli Netcool Performance Manager alarm ID, hostname and port information. When an event is selected, some of the data for the trap event is sent to Tivoli Netcool Performance Manager and used to determine the best report to present. Tivoli Netcool Performance Manager then builds a block of HTML content that re-directs the browser to a Tivoli Netcool Performance Manager display.

You can right-click an event in the Webtop Active Event List (AEL) to display the ALERTS pull down menu. You select an option from this menu to display a detailed Tivoli Netcool Performance Manager daily report for the time period of the threshold violation.

3.2 Integration StrategyThe following diagram illustrates the Tivoli Netcool Performance Manager, Tivoli Netcool OMNIbus/Webtop integration strategy.


The integration strategy involves the following steps.• Updating the ObjectServer Database schema to support Tivoli Netcool Performance Manager

specific alarm fields.• Updating NCKL rules files to place appropriate Tivoli Netcool Performance Manager specific

trap data in the ObjectServer Alert Table.• Defining a JavaScript tool to be executed when a Tivoli Netcool Performance Manager Report

option is selected on the Active Event List.• Creating a menu item that when selected, executes the JavaScript.• Registering the JavaScript tool with Webtop.• Adding Tivoli Netcool Performance Manager specific alarm fields into the Entity View.


3.3 OMNIBus Server Configuration for Wireless Trap SupportYou need to change the database schema to store Tivoli Netcool Performance Manager specific trap fields in the ObjectServer database, in order to integrate Tivoli Netcool Performance Manager with Tivoli Netcool OMNIbus/Webtop. You also need to define new rules to map trap fields to fields in the ObjectServer database.

3.3.1 Adding support to the ObjectServer Database Schema

Support must be added to the ObjectServer database to store Tivoli Netcool Performance Manager specific SNMP trap fields, using either the nco_sql command or the nco_config GUI. The ObjectServer schema needs to be changed to overlay Tivoli Netcool Performance Manager data into existing columns in the database or to add new ones to hold these trap fields.

The following block of code must be added to the AlertStatus Table. It is used to create new columns in the ObjectServer database:

TNPMWHost varchar(64),

TNPMWPort int,

TNPMWAlarmId int,

TNPMWLIFEventTime varchar(64)

To add the code using the nco_sql command, you enter commands similar to the following:alter table alerts.status add column TNPMWHost varchar(64);

alter table alerts.status add column TNPMWPort int;

alter table alerts.status add column TNPMWAlarmId int;

alter table alerts.status add column TNPMWLIFEventTime varchar(64);

If existing ObjectServer database columns are being used, then the field names will reflect those fields actually being used to store Tivoli Netcool Performance Manager data.

Note: The data types for each Tivoli Netcool Performance Manager specific column must match those listed above.

After you define the columns that will contain Tivoli Netcool Performance Manager data in the schema, you must change the mttrapd probe rules file in order to place the appropriate trap fields in the corresponding ObjectServer database fields.

3.3.2 Upgrading support to the ObjectServer Database Schema

Note: This section only applies to upgrading an integration. If you are upgrading an integration you need only follow the instructions in this section.

Support must be updated on the ObjectServer database to update Tivoli Netcool Performance Manager specific SNMP trap fields, using the nco_sql command.

Integrating with Tivoli Netcool OMNIbus/Webtop 9

To change the code using the nco_sql command, enter the following commands:update alerts.status set TNPMWAlarmId = NetworkAssureAlarmId;

update alerts.status set TNPMWHost = NetworkAssureHost;

update alerts.status set TNPMWPort = NetworkAssurePort;

update alerts.status set TNPMWLIFEventTime = NetworkAssureLIFEventTime;

alter table drop column NetworkAssureAlarmId;

alter table drop column NetworkAssureHost;

alter table drop column NetworkAssurePort;

3.3.3 Updating TRAPD Rules

The installation of Netcool Knowledge Library (NcKL) will have created a NC_RULES_HOME directory containing SNMP rules files. See Software Requirements and Dependencies.

This section details how to update these rules to enable integration with Tivoli Netcool Performance Manager.

Important: This section applies only to Tivoli Netcool OMNIbus/Webtop systems installed with Netcool Knowledge Library (NcKL) v1.3 or earlier. NcKL v1.4 (or later) contains TRAPD rules files for Tivoli Netcool Performance Manager. If v1.4 or later is installed do not update the system with these files, omit the instructions in this section and continue to Installation Integra-tion Module.

A zip file on the Tivoli Netcool Performance Manager server contains all the rules files required for the integration. Unzip this file and install the files as detailed below. The file’s location is:

/appl/virtuo/conf/netcool_rulesfiles/Netcool_feature.zip

Tivoli Netcool Performance Manager fields have to be placed in the ObjectServer database. You need to modify Netcool’s mttrapd probe’s rules file and incorporate a Tivoli Netcool Performance Manager supplied rules file for Tivoli Netcool Performance Manager events/traps, in order to properly populate both the generic ObjectServer fields (Summary, Identifier, Severity etc) and additional Tivoli Netcool Performance Manager specific fields already described.

The rules file can be found in the following location:‘${NC_RULES_HOME}/include-snmptrap

The main Tivoli Netcool Performance Manager supplied rules file is named “ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules”.

Integration of the Tivoli Netcool Performance Manager specific rules file will differ depending on a customer’s deployment of Netcool probe rules files. Essentially, the rules files need to be incorporated within the rest of the customer’s Netcool framework. This incorporation requires updates to the following files:

${NC_RULES_HOME}/snmptrap.rules

${NC_RULES_HOME}/include-snmptrap/PreClass.snmptrap.lookup


It also requires installation of the following files into ${NC_RULES_HOME}/include-snmptrapibm-METRICAALARMTRAP-MIB.include.snmptrap.rules

ibm-METRICAALARMTRAP-MIB.adv.include.snmptrap.rules

ibm-METRICAALARMTRAP-MIB.sev.snmptrap

ibm-METRICAALARMTRAP-MIB.include.snmptrap.lookup

ibm-METRICAALARMTRAP-MIB.user.include.snmptrap.rules

Add the necessary include statements in $NC_RULES_HOME/snmptrap.rules

In the Lookup table include section:###################################################################### Enter lookup table Includes below with the following syntax:## include "$NC_RULES_HOME/include-snmptrap/<lookuptable>.include.snmptrap.#####################################################################

include "$NC_RULES_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.include.snmptrap.lookup"

In the Rules files include section:#################################################################### Enter rules file Includes below with the following syntax:## include "$NC_RULES_HOME/include-snmptrap/<rulesfile>.include.snmptrap.rules"###################################################################

include "$NC_RULES_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules"

In the Severity lookup table include section:############################################################################## Enter "Severity" lookup tables below with the following syntax:## include "$NC_RULES_HOME/include-snmptrap/<lookuptable>.sev.snmptrap.lookup”#############################################################################

table ibm-METRICAALARMTRAP-MIB_sev = "$NC_RULES_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.sev.snmptrap.lookup"default = {"Unknown","Unknown","Unknown"}

Add the following to ${NC_RULES_HOME}/include-snmptrap/PreClass.snmptrap.lookup

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_cleared 4

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_indeterminate 0

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_critical 0

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_major 0

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_minor 0

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_warning 0

SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_unknown 0


The exact deployment/integration logistics differ from customer to customer. It is recommended that any changes to the Netcool framework be done by a knowledgeable person aware of the particular customer Netcool deployment specifics.

You might need to change the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules file depending upon customer preferences. Do not change the values of the Type field from what it is currently set to for each Tivoli Netcool Performance Manager trap type. The Type is used by the ObjectServer to automatically clear events from the list when a ‘reset’ event is received that corresponds to a ‘set’ event already in the list. ‘Set’ events always have a Type = 1 value and ‘reset’ events always have a Type = 2 value.

When a ‘reset’ event arrives in the ObjectServer, the corresponding ‘set’ event AND the reset event will be placed in the clear group (green), which will automatically be cleared after a configurable amount of time. Hence, traps that are not green are the ones that are still outstanding and may need to be addressed by a network administrator.

If a customer wishes to use existing ObjectServer alert.status fields, instead of adding new ones as described in this document, then the following lines of the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules file will need to be changed to reflect the fields being used:

@TNPMWHost = $hostname

@TNPMWPort = $port

@TNPMWAlarmId = $alarmID

3.4 Installation Integration ModuleThis section explains how to place Tivoli Netcool Performance Manager specific files into the Webtop environment, set up a tool in Webtop, and associate the new tool with a pull down menu option on the ALERTS menu of the Webtop Active Event List (AEL).

Once this is done, a user will be able to select an event on the AEL, right click, select a TNPMFORWIRELESS menu option, and be presented with a Tivoli Netcool Performance Manager report that is relevant to the threshold violation information contained in the trap that generated the selected event.

This installation procedure assumes the proper installation of Tivoli Webtop and OMNIBus Server. Webtop must have been previously configured to receive and process trap events from the ObjectServer.

3.4.1 Tool Definition

This section explains the definition of a tool that is executed upon selection of a Tivoli Netcool Performance Manager report menu option on the Webtop AEL. The information includes the placement of Tivoli Netcool Performance Manager specific files in appropriate file directories, as well as the definition and configuration of a new tools and menus item from within the Webtop Administrative function.


3.4.2 JavaScript Details

A Tivoli Netcool Performance Manager defined JavaScript file, is executed by Webtop when an event in the AEL is right-clicked. It builds HTML content that redirects the browser to a Tivoli Netcool Performance Manager URL that is specific for the information in the selected event.

The following is an example URL:http://<server>:8080//tnpmw/OpenReport.do?openRepDefId=995&Node=Cell$SS013G3&TNPMWLIFEventTime=06$16$2009

Where the parameters passed are:

• openRepDefId - is the alarm ID (not the report id)• Node - is the entity and instance to report for• TNPMWLIFEventTime is the day to report for

A zip file on the Tivoli Netcool Performance Manager server contains the JavaScript file required for the integration. The location of this file is:

/appl/virtuo/conf/netcool_rulesfiles/Netcool_feature.zip

This file must be copied to the correct location. The file and location differ depending on the version of OMNIbus being used.

OMNIbus 7.1 and 7.2tnpmforwireless.html

This file must be copied to the following directory of the Webtop installation:TIP_HOME/profiles/TIPProfile/etc/webtop/cgi-bin/tnpmforwireless

Where TIP_HOME is the home directory of the OMNIbus 7.1/2 GUI. Contact your System Administrator for the location of this directory.

OMNIbus 7.3tnpmforwireless.cgi

This file must be copied to the following directory of the Webtop installation:TIP_HOME/profiles/TIPProfile/etc/webtop/cgi-bin

Where TIP_HOME is the home directory of the OMNIbus 7.3 GUI. Contact your System Administrator for the location of this directory.

The file must be given more permissions to be executable on the Tivoli Webtop and OMNIBus server. To make the file executable, run the following command:

chmod 755 tnpmforwireless.cgi


3.4.3 Creating a New Tool and Menu Option in Webtop for OMNIbus 7.2

Creating a new tool

To create a new tool:1. Login to Webtop as an administrative user.

2. Click on the selection box on the top right of the window and select WEBTOP ADMIN.

3. Select the TOOLS option on the left to display the TOOLS BROWSER shown below.

4. Select CREATE TOOL in the TOOLS BROWSER.

5. Enter the Tool Name as TNPMFORWIRELESS and ensure the EXECUTE CGI/URL option is selected.

6. Click OK.

7. Select the GROUPS button.


The ASSIGN GROUPS form is displayed.

8. Select the * option and click OK.

You are returned to the TOOL EDITOR form.

9. Enter TNPMFORWIRELESS/TNPMFORWIRELESS.HTML at the end of URL path as shown above.

10. Ensure the EXECUTE FOR EACH SELECTED ROW check box is unchecked.

11. Select the SPECIFIC WINDOW option in the OPEN IN drop-down menu.

12. Ensure the WINDOW FOR EACH SELECTED ROW checkbox is unchecked.

13. Select the FIELDS button.


The Select Fields form is displayed.

14. Select the following fields: TNPMWHOST, TNPMWPORT, TNPMWALARMID, TNPMWLIFEVENTTIME AND ALERTKEY.

15. Click OK to close the form.

16. Click OK in the CREATE NEW TOOLS form.

The following message is displayed.

17. Click OK to clear the message.


Creating a new menu

To create a Tivoli Netcool Performance Manager Menu Option for the new tool:1. Click on MENUS on the left of the window in Webtop Admin.

2. Select the ALERTS menu item in the window, and then select the MODIFY MENU button on the right.

The MENUS EDITOR is displayed.

3. Select the TNPMFORWIRELESS tool on the right, followed by <-ADD button. The selection will be moved to the left.


4. Select the RENAME button.

5. In the LABEL text box, enter the name you wish the new button to have. For example, TNPMforWireless Report. Enter a value in the MNEMONIC text box, if required.

6. Select the OK button.


7. Use the button selections on the left to move the menu option up or down. Separators may also be added by selecting <SEPARATOR> in the ADD ITEM portion of the window. The separator may be moved up and down as well. The following display shows the final configuration of the new menu item.

8. Select the OK button and the following confirmation dialog will appear.

9. Select OK to close the message.

Adding SNMP trap fields

To add Tivoli Netcool Performance Manager trap fields to the Entity View:


1. Select the ENTITY VIEWS menu option on the Webtop Admin page to display the ENTITY VIEW EDITOR.

2. Select BASIC, and then select the ENTITY VIEW EDITOR button to display the ENTITY VIEW EDITOR.

You will see Tivoli Netcool Performance Manager specific entries in the list window on the left.


3. Select each Tivoli Netcool Performance Manager entry and move each entry to the EVENT LIST VIEW using the ADD >> button.

4. Once the fields have been moved click APPLY.

The new tool and menu definition process in Webtop is complete.

5. Logout of the Webtop Administration page and exit the browser.

6. Log back in as a regular Webtop user having access to the ACTIVE EVENT LIST and test out whether the new option works.

You have to exit the browser in order for the event list to see the entity additions in the final step.


3.4.4 Creating a New Tool and Menu Option in Webtop for OMNIbus 7.3

Login to Webtop

1. Login to Webtop as an administrative user.

2. Select TIVOLI NETCOOL/OMNIBUS WEB GUI from the VIEW drop-down list box.

Register the tnpmwforwireless script

The tnpmwforwireless script in OMNIBUS 7.3 must be registered.

To register the script:

1. Select ADMINISTRATION >> EVENT MANAGEMENT TOOLS >> CGI REGISTRY from the left hand pane.


2. Click REGISTER.

3. Enter tnpmwforwireless.cgi in the NAME field.

4. Enter tnpmwforwireless.cgi in the FILE NAME field.

5. Click GROUPS.

6. Select the group to which the user belongs to access the tool for this script.

For example, group 1.


7. Click OK.

You are returned to the CGI REGISTRY pane.

8. Click SAVE.

Create a new tool

To create a new tool:

1. Select ADMINISTRATION >> EVENT MANAGEMENT TOOLS >> TOOL CREATION from the left hand pane.

The TOOL CREATION pane is displayed.


2. Enter tnpmwforwireless in the NAME field.

3. Select CGI/URL from the TYPE drop-down list box.

4. Select the NCOMS Data Source.

To select a datasource click the DATA SOURCE field to display datasources.

5. Complete the URL.

To complete the URL enter tnpmwforwireless.cgi at the end of the path displayed in the URL field. The full path will be: $(SERVER)/cgi-bin/tnpmwforwireless.cgi


6. Select FIELDS, click the SHOW button to display available fields.

Select the following fields: ALERTKEY, TNPMWALARMID, TNPMWHOST, TNPMWPORT and TNPMWLIFEVENTTIME.

To select a field click the field in the AVAILABLE box and click the > ADD button. Selected fields appear in the SELECTED box. You can select multiple fields using CTRL+CLICK.

7. Click HIDE to hide the fields.

8. Select a METHOD to call the script.

Use the GET option.

9. Select an OPEN In window option.

Use the NEW WINDOW option.

10. Ensure the EXECUTE FOR EACH SELECTED ROW check box is unchecked.

11. Ensure the WINDOW FOR EACH SELECTED ROW checkbox is unchecked.

12. Select Groups that require access to the tool.

To select a group click the group in the AVAILABLE box and click the > ADD button. Selected groups appear in the SELECTED box. You can select multiple groups using CTRL+CLICK.

13. Click SAVE.


A confirmation message is displayed.

Configure the alerts menu

To create a menu:

1. Select ADMINISTRATION >> EVENT MANAGEMENT TOOLS >> MENU CONFIGURATION from the left hand pane.

2. Select ALERTS from the AVAILABLE MENUS box.

3. Click MODIFY.


The MENUS EDITOR is displayed.

4. Select the TNPMFORWIRELESS tool in the AVAILABLE ITEMS list, click the > ADD button to add the tool to the CURRENT ITEMS list.

5. Select the menu position for the tool.

Use the TOP, UP, DOWN and BOTTOM buttons to alter a tool’s menu position.

To introduce a separator in to the menu, select <SEPARATOR> from the AVAILABLE ITEMS drop-down list box and click the > ADD button.

6. Click SAVE.

A confirmation message is displayed.

Top

Up

Down

Bottom


Add SNMP trap fields

To add trap fields to the Entity View.

1. Select ADMINISTRATION >> EVENT MANAGEMENT TOOLS >> VIEWS from the left hand pane.

2. Click the NEW VIEW button.

3. Check the appropriate checkboxes to select the groups of users to access the view.

4. Click OK.

5. Enter a name for the view in the NAME field.


6. Add the following fields to the EVENT LIST VIEWS box: ALERTKEY, TNPMWALARMID, TNPMWHOST, TNPMWPORT and TNPMWLIFEVENTTIME.

To add a field select the field in the AVAILABLE FIELDS box and click the > ADD button.

7. Remove any unwanted fields from the EVENT LIST VIEWS box, only the following fields should appear: SERIAL [LOCKED], ALERTKEY, TNPMWALARMID, TNPMWHOST, TNPMWPORT and TNPMWLIFEVENTTIME.

8. Click SAVE.

The new view should now be accessible in the ACTIVE EVENT LIST.


3.5 Report GenerationTo generate Tivoli Netcool Performance Manager reports, select an event on the AEL and right click. A pull down menu appears that contains the new menu option: TNPMFORWIRELESS REPORT, created using the installation procedure. Select the TNPMFORWIRELESS REPORT option to display a new browser window. If the user has not logged into Tivoli Netcool Performance Manager, the login screen appears instead. After the user ID and password are entered, the report associated with the selected event appears.

Subsequent event selections followed by selection of the TNPMFORWIRELESS REPORT menu option will display the TNPMforWireless Report associated with the event in the same browser window. The same browser window will always be used if one is still displayed.

3.5.1 Opening the report

The following sequence of graphics illustrate how Tivoli Netcool Performance Manager report access is achieved from the AEL. It is assumed that the reader is familiar with the use of Webtop AEL.

The following view shows a Webtop window open with an Active Event List containing Tivoli Netcool Performance Manager generated trap events for Webtop 7.2 and 7.3.

Right-clicking on one of the Tivoli Netcool Performance Manager events produces a pull down menu containing a TNPMFORWIRELESS REPORT menu item.


Once the user ID and password are entered, the report associated with the selected event is presented in Tivoli Netcool Performance Manager as shown below.

3.5.2 Tivoli Netcool Performance Manager User Login

Any Webtop user who needs access to Tivoli Netcool Performance Manager reports must be set up with a user ID and password by the Tivoli Netcool Performance Manager administrator.

3.5.3 Tivoli Netcool Performance Manager Session Timeout

The Webtop user will not be asked to login again until the session either times out, or the user logs out explicitly from the Tivoli Netcool Performance Manager portal, or the user exits the browser window containing Tivoli Netcool Performance Manager report data.

3.5.4 Java Plugin Support

The Webtop AEL is a JavaTM applet that runs within a browser on a remote client host. A Webtop user who has access to Tivoli Netcool Performance Manager also has access to Tivoli Netcool Performance Manager functions. Some of these functions are also displayed using an applet that runs within a browser. It is possible that two different applet applications could be running on the same desktop host simultaneously when a Netcool user is accessing Netcool Performance Manager for Wireless reports using this integration package. The user needs to download and install the Java plugin required by each application.

Symptoms Of Installing the Wrong Plugin

Some symptoms of having the wrong plugin installed include the following for both AEL and Tivoli Netcool Performance Manager real-time Reports.

• Missing AEL selection icons on the main Webtop page.• Applet loading errors for the AEL• Missing plugin messages on Tivoli Netcool Performance Manager real-time reports.


3.6 Additional Information

3.6.1 Using Existing ObjectServer Alert Data Table Columns

The following example shows how to map Tivoli Netcool Performance Manager trap fields into the fol-lowing Alert Status Table database fields:

Grade int,

Location varchar (64),

OwnerUID int,

Map the meaning of each of the above elements to the Tivoli Netcool Performance Manager trap fields required for the Webtop Integration. The types of the mapped elements must match those required by the Tivoli Netcool Performance Manager trap fields as follows.

OwnerUID int, TNPMWAlarmId

Location varchar (64), TNPMWHost

Grade int, TNPMWPort

Modify the rules file:$NC_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules

To load the overlaid fields with the appropriate Tivoli Netcool Performance Manager trap data fields:

• Replace all instances of TNPMWAlarmId with OwnerUID.• Replace all instances of TNPMWHost with Location.• Replace all instances of TNPMWPort with Grade.

Modify the Java Script file:tnpmforwireless.html

By mapping with existing fields as follows• TNPMWAlarmId -> OwnerUID• TNPMWHost -> Location• TNPMWPort -> Grade

After modification of the files, the nco_p_mttrapd probe, nco_objserv (ObjectServer) processes must be recycled.

Based on customer’s preferences, they can map any of the unused fields in alerts.status table with the TNPMWAlarmId, TNPMWHost, TNPMWPort as mentioned above. Mapping should be done with same data types.


3.6.2 Configuring Alarm exporter Tivoli Netcool Performance Manager

While creating a target in the Alarm Exporter UI in Tivoli Netcool Performance Manager, in the target Editor Window, the drop down field should be SNMPv1 for SNMP Version. This is done in order to ensure the trap is sent correctly to the Netcool server.


Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785,U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan, Ltd.3-2-12, Roppongi, Minato-ku, Tokyo 106-8711Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.


Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and


products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

If you are viewing this information in softcopy format, the photographs and color illustrations may not appear.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

37

tivoli netcool performance manager: omnibus/webtop ... · pdf filetivoli netcool performance...

Documents