IBM Tivoli Netcool Performance Manager 1.

4
Wireless Component
Document Revision R2E1

Tivoli Netcool/OMNIbus Web GUI

Integration - Wireless Component


 Note
Before using this information and the product it supports, read the information in “Notices” on page 27.

© Copyright IBM Corporation 2006, 2014.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
About this information . . . . . . . . v Installation integration module . . . . . . . 9
Intended audience . . . . . . . . . . . . v Script file details. . . . . . . . . . . . 10
What this information contains . . . . . . . . v Creating tool and menu options in Web GUI . . . 12
The Tivoli Netcool Performance Manager - Wireless Logging in to Jazz for Service Management
component user publications . . . . . . . . . v application server . . . . . . . . . . . 12
Service Management Connect . . . . . . . . vi Registering the tnpmwforwireless script . . . . 12
Tivoli Netcool Performance Manager technical Creating new tool . . . . . . . . . . . 12
training . . . . . . . . . . . . . . . . vi Creating new menu . . . . . . . . . . 13
Support information . . . . . . . . . . . vi Adding SNMP trap fields. . . . . . . . . 14
Conventions used in this publication . . . . . . vii Configuring launch-in-context Active Event List on
Typeface conventions . . . . . . . . . . vii Jazz for Service Management application server . . 14
Configuring launch-in-context Active Event List on
Chapter 1. Prerequisites . . . . . . . . 1 Resource Metric Viewer . . . . . . . . . . 15
Logging in to the reporting interface . . . . . 16
Prerequisite information . . . . . . . . . . 1
Generating the reports . . . . . . . . . . . 18
Supported configurations . . . . . . . . . . 2
Additional information . . . . . . . . . . 19
Groups and users. . . . . . . . . . . . . 2
Software requirements and dependencies . . . . . 2
Trapd rules . . . . . . . . . . . . . . . 3 Appendix A. Updating Trapd rules for
ObjectServer . . . . . . . . . . . . . . 3 NcKL v4.2 . . . . . . . . . . . . . 21
Using existing fields . . . . . . . . . . . 3 $NC_RULES_HOME/snmptrap.rules . . . . . . . 22
Tivoli Netcool/OMNIbus Web GUI menu . . . . 4 ${NC_RULES_HOME}/include-snmptrap/
PreClass.snmptrap.lookup . . . . . . . . . 22
Chapter 2. Integration with Tivoli Additional changes to Trapd rules . . . . . . . 23
Netcool/OMNIbus Web GUI . . . . . . 5
Integration strategy . . . . . . . . . . . . 5 Appendix B. AelLaunchScript file
Tivoli Netcool/OMNIbus server configuration for contents . . . . . . . . . . . . . . 25
wireless trap support . . . . . . . . . . 6
Update Trapd rules for NcKL v4.2 . . . . . . 7 Notices . . . . . . . . . . . . . . 27
Starting the ObjectServer and probes . . . . . 8
Configuring alarms for Tivoli Netcool/OMNIbus 8

© Copyright IBM Corp. 2006, 2014 iii

iv IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
About this information
The IBM Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component describes
how to integrate IBM® Tivoli® Netcool®/OMNIbus Web GUI, Version 8.1 with the
Wireless component of Tivoli Netcool Performance Manager, Version 1.4.

Intended audience
This publication is intended for the network administrator or operations specialist
responsible for integrating Tivoli Netcool Performance Manager with Tivoli
Netcool/OMNIbus Web GUI on an enterprise network.

Readers need to be familiar with the following topics:

v Basic principles of network management.
v SNMP concepts.
v Operating system administration.
v Oracle database administration.
v Tivoli Netcool Performance Manager
v Tivoli Netcool/OMNIbus Web GUI

What this information contains

This publication contains these sections.
v Chapter 1, “Prerequisites,” on page 1
An overview of the integration solution and pre-integration considerations
v Chapter 2, “Integration with Tivoli Netcool/OMNIbus Web GUI,” on page 5
Explains how to integrate IBM Tivoli Netcool/OMNIbus Web GUI with the
wireless component of Tivoli Netcool Performance Manager 1.4.
v Appendix A, “Updating Trapd rules for NcKL v4.2,” on page 21
Applies only to Tivoli Netcool/OMNIbus Web GUI systems that are installed
with Netcool Knowledge Library (NcKL) v1.3.
v Appendix B, “AelLaunchScript file contents,” on page 25
A configuration script that is required to start the Resource Metric Viewer UI
from the Active Event List.

The Tivoli Netcool Performance Manager - Wireless component user

publications
Tivoli Netcool Performance Manager - Wireless component consists of the
following publications:
Table 1. Tivoli Netcool Performance Manager - Wireless component user documentation
Document Description
Administering Tivoli Netcool Performance Manager - Instructions and general information about how to
Wireless Component maintain and support Tivoli Netcool Performance
Manager.
Installing Tivoli Netcool Performance Manager - Instructions for installing and configuring the
Wireless Component Tivoli Netcool Performance Manager software.

© Copyright IBM Corp. 2006, 2014 v

 Table 1. Tivoli Netcool Performance Manager - Wireless component user
documentation (continued)
Document Description
Installing and Using Model Maker - Wireless Provides instructions for installation and usage of
Component the Model Maker application.
Release Summary for Tivoli Netcool Performance Additional release-specific information not in the
Manager guides.
Upgrading Tivoli Netcool Performance Manager - Instructions for upgrading Tivoli Netcool
Wireless Component Performance Manager software.
Using Tivoli Netcool Performance Manager - Wireless Conceptual information and procedures for using
Component Tivoli Netcool Performance Manager software for
performance, trending analysis and performance
alarms.
Tivoli Monitoring Integration - Wireless Component Provides instructions for integrating IBM Tivoli
Monitoring with Tivoli Netcool Performance
Manager.

Note: The graphical user interface for wireless will be released after 1.4. Therefore,
the IBM Tivoli Netcool/OMNIbus Web GUI Integration Guide will be published later.

The documentation is available on the knowledge center at http://www-

01.ibm.com/support/knowledgecenter/SSBNJ7/welcome.

Service Management Connect

Connect, learn, and share with Service Management professionals: product support
technical experts who provide their perspectives and expertise.

Access Network and Service Assurance community at https://www.ibm.com/

developerworks/servicemanagement/nsa/index.html. Use Service Management
Connect in the following ways:
v Become involved with transparent development, an ongoing, open engagement
between other users and IBM developers of Tivoli products. You can access early
designs, sprint demonstrations, product roadmaps, and prerelease code.
v Connect one-on-one with the experts to collaborate and network about Tivoli
and the Network and Service Assurance community.
v Read blogs to benefit from the expertise and experience of others.
v Use wikis and forums to collaborate with the broader user community.
Related information:

Tivoli Netcool Performance Manager 1.4 community on developerWorks

Tivoli Netcool Performance Manager technical training

For Tivoli Netcool Performance Manager technical training information, see the
following Tivoli Netcool Performance Manager Training website at:
https://tnpmsupport.persistentsys.com/training.

Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM
provides the following ways for you to obtain the support you need:

vi IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 Online
Access the IBM Software Support site at http://www.ibm.com/software/
support/probsub.html .
IBM Support Assistant
The IBM Support Assistant is a free local software serviceability workbench
that helps you resolve questions and problems with IBM software
products. The Support Assistant provides quick access to support-related
information and serviceability tools for problem determination. To install
the Support Assistant software, go to http://www.ibm.com/software/
support/isa.
Troubleshooting Guide
For more information about resolving problems, see the problem
determination information for this product.

Conventions used in this publication

Several conventions are used in this publication for special terms, actions,
commands, and paths that are dependent on your operating system.

Typeface conventions
This publication uses the following typeface conventions:
Bold
v Lowercase commands and mixed case commands that are otherwise
difficult to distinguish from surrounding text
v Interface controls (check boxes, push buttons, radio buttons, spin
buttons, fields, folders, icons, list boxes, items inside list boxes,
multicolumn lists, containers, menu choices, menu names, tabs, property
sheets), labels (such as Tip:, and Operating system considerations:)
v Keywords and parameters in text
Italic
v Citations (examples: titles of publications, diskettes, and CDs)
v Words defined in text (example: a nonswitched line is called a
point-to-point line)
v Emphasis of words and letters (words as words example: "Use the word
that to introduce a restrictive clause."; letters as letters example: "The
LUN address must start with the letter L.")
v New terms in text (except in a definition list): a view is a frame in a
workspace that contains data.
v Variables and values you must provide: ... where myname represents....
Monospace
v Examples and code examples
v File names, programming keywords, and other elements that are difficult
to distinguish from surrounding text
v Message text and prompts addressed to the user
v Text that the user must type
v Values for arguments or command options
Bold monospace
v Command names, and names of macros and utilities that you can type
as commands

About this information vii

 v Environment variable names in text
v Keywords
v Parameter names in text: API structure parameters, command
parameters and arguments, and configuration parameters
v Process names
v Registry variable names in text
v Script names

viii IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Chapter 1. Prerequisites
Ensure that you fulfill the prerequisites for integrating Tivoli Netcool Performance
Manager Wireless component with Tivoli Netcool/OMNIbus Web GUI.

Note: If you are upgrading an integration, you need only follow instructions to
upgrade support to the ObjectServer database schema.
Related information:

Installing and updating Tivoli Netcool/OMNIbus

Installing and updating the Web GUI component

Prerequisite information
Ensure that you obtain this information before you start the integration.

Ensure that you have:

v Administrator credentials for Tivoli Netcool/OMNIbus Web GUI
v Administrator credentials on the Dashboard Application Services Hub on Jazz
for Service Management
v Checked that the firewall policy allows SNMP protocol (TRAPs) between the
hosts and the SNMP TRAPD probe

Tivoli Netcool Performance Manager user login

Any Tivoli Netcool/OMNIbus Web GUI 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.

Tivoli Netcool Performance Manager session timeout

A Tivoli Netcool/OMNIbus Web GUI user is not asked to log in 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 that has Tivoli
Netcool Performance Manager report data.

Java plug-in support

The Tivoli Netcool/OMNIbus Web GUI Active Events List is a Java applet that
runs within a browser on a remote client host. A Web GUI 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 by using an applet
that runs within a browser. It is possible that two different applet applications
might be running on the same desktop host simultaneously, when a user is
accessing reports by using this integration package. The user needs to download
and install the Java plug-in that is required by each application.

Some symptoms of having the wrong plug-in that is installed include the following
for both the Active Events List and Tivoli Netcool Performance Manager real-time
reports:

© Copyright IBM Corp. 2006, 2014 1

 v Missing Active Events List selection icons on the main Tivoli Netcool/OMNIbus
Web GUI page.
v Applet loading errors for the Active Events List
v Missing plug-in messages on Tivoli Netcool Performance Manager real-time
reports.

Supported configurations
The following configurations are supported in this solution. A stand-alone
configuration where Tivoli Netcool Performance Manager, Tivoli
Netcool/OMNIbus server, Tivoli Netcool/OMNIbus Web GUI, and the SNMP
Multi-Thread trapd probe are installed on the same server is also supported.

Tivoli Netcool/OMNIbus Server and the SNMP Multi-Thread trapd probe are
recommended to be installed on a separate server than Tivoli Netcool Performance
Manager and Tivoli Netcool/OMNIbus Web GUI. The following configuration is
preferred:
Server 1
Tivoli Netcool/OMNIbus and the SNMP Multi-Thread trapd probe
Server 2
v Tivoli Netcool/OMNIbus Web GUI
v Tivoli Netcool Performance Manager with Jazz for Service Management

Groups and users

All the required users and groups must be set up on the system before integration.

A user who has access to all event management tasks that includes menu creation
and tool creation must exist. If such a user does not exist, then create an
appropriate user. Ensure that the user is assigned to a group
Netcool_OMNIbus_Admin or Netcool_OMNIbus_User and user role as ncw_admin or
ncw_user.

Software requirements and dependencies

Ensure that you have all of the required software before you start the integration.

Ensure that the following software is available:

v Tivoli Netcool Performance Manager 1.4 Wireless Component
v IBM Tivoli Netcool/OMNIbus, Version 8.1
v IBM Tivoli Netcool/OMNIbus Web GUI, Version 8.1
v SNMP Multi-Thread trapd probe (mttrapd)
v Netcool Knowledge Library (NcKL), Version 4.2 or later
v Dashboard Application Services Hub on Jazz for Service Management Version
1.1.0.3
Tivoli Netcool/OMNIbus Web GUI uses a client/server architecture and it is
hosted inside Dashboard Application Services Hub, which is part of Jazz for
Service Management. Clients connect to Dashboard Application Services Hub to
access the Web GUI.
v Supported browsers:
– Internet Explorer 8.0 and 9.0

2 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 – Mozilla Firefox ESR 17 and 24
Related information:

Introduction to Tivoli Netcool/OMNIbus 8.1.0

Trapd rules
Tivoli Netcool Performance Manager provides an event feed only through
Multi-Threaded SNMP Trapd probes. Tivoli Netcool Performance Manager
provides rules files for Enterprise TRAPs issued by Tivoli Netcool Performance
Manager.

The rules file defines how the probe processes event data to create meaningful
Tivoli Netcool/OMNIbus alerts. The rules file also creates an identifier for each
alert to uniquely identify the problem source, so that repeated events can be
deduplicated.
Related information:

Probe rules files

ObjectServer
The preferred deployment of Tivoli Netcool Performance Manager requires the
expansion of the Netcool alert.status table in the ObjectServer. A list and
descriptions of the fields specific to Tivoli Netcool Performance Manager, each of
which must be added to the alert.status table in the ObjectServer can be found
here.

You must modify the ObjectServer schema.

Each Tivoli Netcool/OMNIbus installation must have at least one ObjectServer to

store and manage alert information. You can also set up multiple ObjectServers on
one or more host computers.
Related information:

Creating and running ObjectServers

Using existing fields

If you do not want to expand the alert.status table in the ObjectServer, you must
provide a list of compatible, existing, unused ObjectServer fields that can be used.
If you want to use existing ObjectServer fields, you must make the following
modifications.

Procedure
1. Modify the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules file to reflect
the ObjectServer fields to be used.
2. Using the nco_sql command or the nco_config GUI, ensure that the types of
selected existing fields match exactly the fields that are required for the three
Tivoli Netcool Performance Manager trap fields to be saved in the
alert.status table.
You can use the SQL interactive interface (called nco_sql on UNIX and isql on
Windows) to connect to a firewall bridge server, and use SQL commands to
interact with the Firewall Bridge server and retrieve configuration information.

Chapter 1. Prerequisites 3
 3. Modify the script file tnpmforwireless.cgi to map the meaning of the columns
that are used to known URL parameter names used by Tivoli Netcool
Performance Manager.
Related information:

SQL interactive interface

Tivoli Netcool/OMNIbus Web GUI menu

The default Tivoli Netcool Performance Manager installation configures the Tivoli
Netcool Performance Manager Report menu option to be at the top level of the
Web GUI Alert menu, which is displayed when an event in the Active Event List
is right-clicked.

If you want a different location for Tivoli Netcool Performance Manager tools, you
must modify the configuration of the tool to move them to a different location.
However, the menu option must be part of the alerts menu.

4 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI
Explains the tasks that are associated with integrating Tivoli Netcool Performance
Manager with the Tivoli Netcool/OMNIbus Web GUI application. You can view
Netcool events in real time by using your Web browser. It works with the Tivoli
Netcool/OMNIbus application to retrieve real-time event data. The Tivoli
Netcool/OMNIbus Web GUI customizable dashboards display real-time
performance information and event data.

Note: If you are upgrading your integration, you must follow the instructions in
“Upgrading support to the ObjectServer database schema” on page 6.

Integrating Tivoli Netcool Performance Manager with Tivoli Netcool/OMNIbus

Web GUI combines the ability of Tivoli Netcool Performance Manager to generate
SNMP traps when threshold violations are detected, with the application function
of Web GUI.

The SNMP traps contain the Tivoli Netcool Performance Manager alarm ID, host
name, 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 redirects the browser to a Tivoli Netcool Performance
Manager display.

Right-click an event in Active Event List of Web GUI to display the tools that are
added from the alerts menu. You select an option from this menu to display a
detailed Tivoli Netcool Performance Manager report for the time period of the
threshold violation or a Resource Metric Viewer AEL report.

Integration strategy
Overview of the integration.

Integration includes the following steps.

v Create a database in Tivoli Netcool/OMNIbus.
v Update the hostname.
v Start the Jazz for Service Management application server that has Tivoli
Netcool/OMNIbus Web GUI installed.
See “Stopping Jazz for Service Management application servers” on page 10.
See “Starting Jazz for Service Management application servers” on page 11.
v Updating the ObjectServer database schema to support Tivoli Netcool
Performance Manager specific alarm fields.
v Updating NCKL rules files to place appropriate Tivoli Netcool Performance
Manager specific trap data in the ObjectServer alert.status table.
v Defining a Web GUI tool that runs the script when a Tivoli Netcool Performance
Manager Report option is selected from the Active Event List.
v Creating a menu item that when selected, runs the CGI script.
v Registering the CGI with Tivoli Netcool/OMNIbus Web GUI.
v Adding Tivoli Netcool Performance Manager specific alarm fields in to the
Entity View in Tivoli Netcool/OMNIbus Web GUI.

© Copyright IBM Corp. 2006, 2014 5

 Tivoli Netcool/OMNIbus server configuration for wireless trap
support
You must change the database schema to store Tivoli Netcool Performance
Manager specific trap fields in the ObjectServer database to integrate Tivoli Netcool
Performance Manager with Tivoli Netcool/OMNIbus Web GUI. You also must
define new rules to map trap fields to fields in the ObjectServer database.

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, by using either the nco_sql
command or the nco_config GUI. The ObjectServer schema must 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.

About this task

The following block of code must be added to the alert.status table. This code is
used to create new columns in the ObjectServer database.
TNPMWHost varchar(64),
TNPMWPort int,
TNPMWAlarmId int,
TNPMWLIFEventTime varchar(64)

Procedure

To add the code by using the nco_sql command, enter the following commands:
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 the existing ObjectServer database columns are 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 to place
the appropriate trap fields in the corresponding ObjectServer database fields.

Upgrading support to the ObjectServer database schema

Applicable if you are upgrading an integration. If you are upgrading an
integration, you must follow these instructions.

About this task

Note: This section applies to upgrading an integration only.

If you are upgrading an installation, support must be updated on the ObjectServer

database to update Tivoli Netcool Performance Manager specific SNMP trap fields.

6 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 Procedure

To change the code by 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;

Update Trapd rules for NcKL v4.2

The installation of Netcool Knowledge Library (NcKL) creates an NC_RULES_HOME
directory that contains SNMP rules files. NcKL v1.4 or later contains Trapd rules
files for Tivoli Netcool Performance Manager.

For updating the Trapd rules on NcKL v4.2, see Appendix A, “Updating Trapd
rules for NcKL v4.2,” on page 21.

Note: If you are using AIX, use GNU TAR utility while you extract the files from
NcKL rules.tar file. Using the AIX TAR utilities can strip off some long file names,
and create issues while you start the OMNIbus SNMP probe.

To enable these rules files, update the ${NC_RULES_HOME}/snmptrap.rules file and

uncomment the following lines:
#include "$NC_RULES_HOME/include-snmptrap/ibm/ibm.master.include.lookup"
#include "$NC_RULES_HOME/include-snmptrap/ibm/ibm.master.include.rules"
#include "$NC_RULES_HOME/include-snmptrap/ibm/ibm-preclass.include.snmptrap.rules"

Additional steps required for NcKL v3.3 or later

Some changes that are needed to make to the ibm-METRICAALARMTRAP-
MIB.include.snmptrap.rules file provided with NcKL v3.3 to support the NcKL
v3.3 directory structure.

Procedure
1. Extract the $WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip archive on
the Tivoli Netcool Performance Manager server to access the Tivoli Netcool
Performance Manager rules files.
2. Copy the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules file from the
$WMCROOT/conf/netcool_rulesfiles/Netcool_feature/Probe directory to the
$NC_RULES_HOME/include-snmptrap/ibm/ directory.
3. Ensure that the two relevant lines in the ibm-METRICAALARMTRAP-
MIB.include.snmptrap.rules include file contain the correct path by adding
/ibm/ to each line as follows:
include "$NC_RULES_HOME/include-snmptrap/ibm/ibm-METRICAALARMTRAP-MIB.
adv.include.snmptrap.rules"
include "$NC_RULES_HOME/include-snmptrap/ibm/ibm-METRICAALARMTRAP-MIB.
user.include.snmptrap.rules"

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 7

 Starting the ObjectServer and probes
Start the ObjectServer and probes, specifying the port number that is specified in
the Tivoli Netcool Performance Manager.

Procedure

Enter the following commands:

NCHOME=/opt/IBM/tivoli/netcool;export NCHOME

OMNIHOME=$NCHOME/omnibus;export OMNIHOME

NC_RULES_HOME=$NCHOME/rules;export NC_RULES_HOME

PATH=$PATH:$NCHOME/omnibus/bin;export PATH

PATH=$PATH:$NCHOME/omnibus/probes;export PATH

LD_LIBRARY_PATH=/opt/IBM/tivoli/netcool/platform/solaris2/lib

export LD_LIBRARY_PATH

# start core

$NCHOME/omnibus/bin/nco_objserv &

# start probe

$NCHOME/omnibus/probes/solaris2/nco_p_mttrapd -port 10162 -messagelog $NCHOME/log/probe.log

-messagelevel DEBUG -udp -rulesfile $NCHOME/rules/snmptrap.rules &

Where 10162 is the port number that is specified in the Tivoli Netcool Performance
Manager Wireless Component.
The default NCHOME is /opt/IBM/tivoli/netcool.
The default OMNIHOME is $NCHOME/omnibus
The default NC_RULES_HOME is $OMNIHOME/probes/linux2x86/rules.

Configuring alarms for Tivoli Netcool/OMNIbus

In Tivoli Netcool Performance Manager, you must create an alarms target, a target
group, and an export rule with the destination of the Tivoli Netcool/OMNIbus
server.

For more information about how to do this, see the Alarm Exporter in the Using
Tivoli Netcool Performance Manager - Wireless Component.

When you create the target, the Manager field specifies the hostname/IP address
of the Tivoli Netcool/OMNIbus server, and the Manager Port field specifies the
port (10162) to which the alarms generated by the Tivoli Netcool Performance
Manager are sent.

8 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 The port that is given in that alarm rule section must match the port that is used
to start the mttrapd process in Tivoli Netcool/OMNIbus.

Installation integration module

Explains how to place Tivoli Netcool Performance Manager specific files in to the
Web GUI environment, set up a tool in Tivoli Netcool/OMNIbus Web GUI, and
associate the new tool with a list option on the Alerts menu of the Active Events
List.

Right-click an event on the Active Events List, select TNPMforWireless menu

option. A Tivoli Netcool Performance Manager report is displayed that is relevant
to the threshold violation information contained in the trap that generated the
selected event.

This installation procedure assumes the successful installation of Tivoli

Netcool/OMNIbus Web GUI and Tivoli Netcool/OMNIbus server. Tivoli
Netcool/OMNIbus Web GUI must be previously configured to receive and process
trap events from the ObjectServer.

Tool definition

Explains how to define a tool that is run upon the selection of a Tivoli Netcool
Performance Manager report on the Active Events List. This includes the
placement of Tivoli Netcool Performance Manager specific files in appropriate file
directories, and the definition and configuration of a new tool and menu item from
within the Dashboard Application Services Hub administrative function.

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 9

 Script file details
When you right-click an event in the Active Events List, a Tivoli Netcool
Performance Manager defined script file is run in the Tivoli Netcool/OMNIbus
Web GUI. Tivoli Netcool/OMNIbus Web GUI 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 as follows:

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

Tivoli Netcool/OMNIbus 8.1

The Netcool_feature.zip file on the Tivoli Netcool Performance Manager server

contains the JavaScript file that is required for the integration. The location of
compressed file is as follows:
$WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip

Note: The file and the location differ depending on the version of Tivoli
Netcool/OMNIbus that is used.

The tnpmwforwireless.cgi is the Common Gateway Interface script that is required

for the integration. This file is located in the following path:
$WMCROOT/conf/netcool_rulesfiles/Netcool_feature/javascript/
tnpmwforwireless.cgi

Copy the tnpmwforwireless.cgi file to the following folder of the Web GUI
installation:
<NCHOME>/omnibus_webgui/etc/cgi-bin

Where NCHOME is the home directory of the OMNIbus 7.4 Web GUI. Contact your
system administrator for the location of this directory.

The file must be given extra permissions to be executable on Web GUI and the
OMNIbus server. To make the file executable, run the following command:

chmod 755 tnpmwforwireless.cgi

Stopping Jazz for Service Management application servers

You can stop any Jazz for Service Management application server by using the IBM
WebSphere stopServer command. You might need to restart the application server
after completing a configuration task for an integration service, or stop the
application server for maintenance. To start the server again, use the startServer
command.

Procedure
1. On the relevant Jazz for Service Management server, open a command window.

10 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 2. Change to the JazzSM_WAS_Profile/bin directory. The default location for
<JazzSM_WAS_Profile> is /opt/IBM/JazzSM/profile.
3. Run the following command:

./stopServer.sh <server_name> -username <WAS_admin_user_name> -password <WAS_admin_password>

Where
server_name
Enter the name of the application server that was specified when the
application server profile was created. For example, server1.
WAS_admin_user_name
The default user name is smadmin.
WAS_admin_password
This is the password that is specified at the time of installation.

Example

stopServer.sh server1 -username smadmin -password jazzsmpwd

Starting Jazz for Service Management application servers

You can start any Jazz for Service Management virtualization and reporting servers
by using the IBM WebSphere startServer command. You might need to restart the
application server after you complete a configuration task for an integration
service, or after you take the application server down for maintenance.

About this task

The same procedure applies to any Jazz for Service Management application
server.

Procedure
1. On the relevantJazz for Service Management server, open a command window.
2. Change to the JazzSM_WAS_Profile/bin directory. The default location for
<JazzSM_WAS_Profile> is /opt/IBM/JazzSM/profile.
3. Run the following command:

./startServer.sh server_name

Where
server_name
Enter the name of the application server that was specified when the
application server profile was created. For example, server1.

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 11

Creating tool and menu options in Web GUI
You must create new tool and menu options that are created in Web GUI. The
following instructions apply to OMNIbus Web GUI 8.1

Creating tool and menu options in Web GUI involves the following tasks:
v Log in to Web GUI
v Register the tnpmwforwireless script
v Create new tool
v Create new menu
v Configure the Alerts menu
v Add SNMP trap fields

Logging in to Jazz for Service Management application server

Procedure
1. Log in to Jazz for Service Management application server as an administrator
user.
For more information, see Logging in.
2. Select Tivoli Netcool/OMNIbus Web GUI from the View list.

Registering the tnpmwforwireless script

Procedure
1. Select Administration > Event Management Tools > CGI Registry from the
left pane.
2. Click the Register button.
3. Enter tnpmwforwireless in the Name field.
4. Enter tnpmwforwireless.cgi in the File name field.
5. Click the Groups button.
The Assign Groups dialog is displayed.
6. To access the tool for this script, select the group that the user belongs to,
7. Click OK.
You return to the CGI Registry pane.
8. Click Save.
Related information:

Creating and registering CGI scripts

Creating new tool

Procedure
1. Select Administration > Event Management Tools > Tool Configuration from
the left pane.
2. Select theCreate Tool button to create new tool.
3. Enter tnpmwforwireless in the Name field.
4. Select CGI/URL from the Type list.
5. Select the NCOMS data source.
To select a data source, click Data Source to display data sources.
6. Complete the URL.

12 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 To complete the URL enter tnpmwforwireless.cgi at the end of the path that
is displayed in the URL field. The full path is as follows:
$(SERVER)/cgi-bin/tnpmwforwireless.cgi
7. Click the Show button to display available fields.
8. Select the following fields:
v AlertKey
v TNPMWAlarmId
v TNPMWHost
v TNPMWPort
v TNPMWLIFEventTime
To select a field, click the field in the Available box and click Add selected
fields. Selected fields appear in the Selected box. You can select multiple
fields by using Ctrl+Click.
9. Click Hide to hide the fields.
10. Select a Method to call the script.
Select the GET option.
11. Select an Open In window option.
Select the New Window option.
12. Ensure the Execute for each selected row check box is cleared.
13. Ensure the Window for each selected row check box is cleared.
14. Select groups that require access to the tool.
Groups are selected from Access Criteria. 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 by using Ctrl+Click.
15. Click Save.
A confirmation message is displayed. Click OK to close the message.

Creating new menu

A Tivoli Netcool Performance Manager menu option must be created for the new
tool.

Procedure
1. Select Administration > Event Management Tools > Menu Configuration
from the left pane.
2. Select the alerts menu item in the window, and then click the Modify button.
The Menus Editor is displayed.
3. Select the tnpmforwireless tool on the right, click Add selected item.
The selection is moved to the left.
4. Click Rename.
5. In the Label text box, enter the name for the new button.
For example, TNPMforWireless Report. Enter a value in the Mnemonic text box,
if required.
6. Click Save.
7. Use the button selections on the left to move the menu option up or down.
Separators might also be added by selecting <Separator> in the Available
Items area of the window. The separator might be moved up and down.
8. Click Save.

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 13

 The following message is displayed:
Menu has been successfully modified.
9. Click Ok to close the message.

Adding SNMP trap fields

Add SNMP trap fields to the Entity View.

Procedure
1. Select Administration > Event Management Tools > Views from the left pane.
2. Click New View.
3. Select the Public groups and individual 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:
v AlertKey
v TNPMWAlarmId
v TNPMWHost
v TNPMWPort
v TNPMWLIFEventTime
To add a field, select the field in the Available Fields box and click Add
selected field.
7. Remove any unwanted fields from the Edit View: New View box.
Only the following fields must appear:
v Serial [Locked]
v AlertKey
v TNPMWAlarmId
v TNPMWHost
v TNPMWPort
v TNPMWLIFEventTime
8. Click Save.
9. Click Save and Close.
The new view is now accessible in the Active Event List.

Configuring launch-in-context Active Event List on Jazz for Service

Management application server
This procedure applies only to Tivoli Netcool/OMNIbus Web GUI systems that are
installed with Netcool Knowledge Library (NcKL) v4.2. When you install the
Netcool Knowledge Library (NcKL), a NC_RULES_HOME directory that contains the
SNMP rules files is created. These rules files must be updated to enable integration
with Tivoli Netcool Performance Manager.

About this task

When you right-click an event in the Active Events List, a script file is run by
Tivoli Netcool/OMNIbus Web GUI. 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.

14 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 Procedure
1. A compressed file archive on the Tivoli Netcool Performance Manager server
contains all the rules files for the integration. Extract this archive and install the
files. The location of the file is as follows:
$WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip
The default $WMCROOT directory is /appl/virtuo.
2. Copy the tnpmwforwireless.cgi file to the following directories of the Web GUI
installation by using these commands:
v NCHOME/omnibus_webgui/etc/cgi-bin
cd $WMCROOT/conf/netcool_rulesfiles/Netcool_feature/javascript
cp tnpmwforwireless.cgi /opt/IBM/tivoli/netcool/omnibus_webgui/etc/cgi-bin
v NCHOME/omnibus_webgui/etc/default/cgi-bin
cd $WMCROOT/conf/netcool_rulesfiles/Netcool_feature/javascript
cp tnpmwforwireless.cgi /opt/IBM/tivoli/netcool/omnibus_webgui/etc/default/cgi-bin
3. Give the file permissions by using these commands:
cd /opt/IBM/tivoli/netcool/omnibus_webgui/etc/cgi-bin
chmod 755 tnpmwforwireless.cgi

You can proceed to create new tool and menu options in Tivoli
Netcool/OMNIbus Web GUI from Jazz for Service Management application
server.
Related tasks:
Creating new tool
Creating new menu
A Tivoli Netcool Performance Manager menu option must be created for the new
tool.

Configuring launch-in-context Active Event List on Resource Metric

Viewer
Adding a menu script to start the Resource Metric Viewer UI from the Active
Event List (AEL).

About this task

You must create a configuration script before you follow the steps in this
procedure. The script content can be found in Appendix B, “AelLaunchScript file
contents,” on page 25. Copy the contents in a text file and save the file as
AelLaunchScript.script.

Procedure
1. Log in to Jazz for Service Management. For more information, see “Logging in
to the reporting interface” on page 16
2. Click Administration > Event management Tools > Tool Configuration.
3. Click the Create Tool button.
4. Enter the name of the script in the Name field.
For example, RMV.
5. Select Script in the Type list.
6. Copy the contents of the configuration script into the Script Commands
section.

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 15

 For more information about the script contents, see Appendix B,
“AelLaunchScript file contents,” on page 25.
7. In the Access Criteria pane, move Netcool_OMNIbus_Admin and
Netcool_OMNIbus_User options to the Selected area.
8. Click Save.
9. Click Administration > Event management Tools > Menu Configuration.
10. From the Available menus list, select alerts and click Modify.
The Menus Editor window is displayed.
11. Move the script that you created from Available items to Current items and
position it in your preferred location.
If the Active Event List is already open, close and reopen it to see the new
menu option.
12. Click Save.
The menu is now updated in the AEL, and is added as an entry in the
Available items menus list.

Note: If the Active Event List is already open, you must close and reopen it to
see the new menu option.

Results

When you right-click on an entry on the Active Event List, you see the RMV
script as a selectable option in the menu. Select RMV to see a Resource Metric
Viewer AEL report.
Related tasks:
Generating the reports
To generate a Tivoli Netcool Performance Manager report, an event is selected
from Active Events List.

Logging in to the reporting interface

Depending upon your organization’s deployment of Tivoli Common Reporting,
you can access the reporting interface directly or through Dashboard Application
Services Hub.

About this task

With the Common Reporting interface, you can perform simple lightweight tasks
as well as more advanced scalable reporting that is provided by IBM Cognos
Business Intelligence Reporting.
v Create on-demand reports.
v Use the Web-based report authoring.
v Email reports

Access the reporting interface:

Dashboard Application Services Hub
Log in to the reporting interface from the Dashboard Application Services
Hub login page. Both Dashboard Application Services Hub and Tivoli
Common Reporting are installed in the same application serving
environment, and the reporting interface is integrated with Dashboard
Application Services Hub.

16 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
 Access is determined by user roles associated with user IDs. The role that
you need to access Tivoli Common Reporting is tcrPortalOperator. See
Authentication and authorization in Tivoli Common Reporting.

Procedure
v Access the reporting interface from Dashboard Application Services Hub as
follows:
1. Open a web browser and enter the following URL for the Jazz™ for Service
Management UI and reporting server:
https://host.domain:port/DASH_context_root
For example: https://myJazzSMserver.ibm.com:16311/ibm/console
Where:
– host.domain is the fully qualified host name or IP address of the Jazz for
Service Management UI and reporting server.
When single sign-on (SSO) is enabled, ensure that you use the fully
qualified host name in the URL of the Jazz for Service Management
reporting and UI server. SSO requires that the browser pass LTPA cookies
to the Jazz for Service Management application server, and these cookies
contain the fully qualified host name.
– port is the secure HTTP port number that was specified during
installation. The default value is 16311.
– /DASH_context_root is the context root for the console that was specified
during installation. The default value is /ibm/console.
2. On the Dashboard Application Services Hub login page, enter the user ID
and password. Ensure that user ID has access to Tivoli Common Reporting.
Click Log in. The Dashboard Application Services Hub Welcome page opens.
3. In the navigation bar, click Reporting > Common Reporting.
The Common Reporting portal is displayed within a Dashboard Application
Services Hub portlet page.
v Access the reporting interface directly as follows:
1. Open a web browser and enter the following URL for the reporting interface:
http://host.domain:port/tarf/servlet/dispatch
For example: http://myJazzSMserver.ibm.com:16310/tarf/servlet/dispatch
Where:
– host.domain is the fully qualified host name or IP address of the Jazz for
Service Management reporting server.

Note: When single sign-on (SSO) is enabled, ensure that you use the fully
qualified host name in the URL of the Jazz for Service Management
reporting server. SSO requires that the browser pass LTPA cookies to the
Jazz for Service Management application server, and these cookies contain
the fully qualified host name.
– port is the non secure HTTP port number that was specified during
installation. The default value is 16310.
Check with your organization’s Jazz for Service Management administrator if
you are unsure of the URL.
2. On the Log on to IBM Cognos Software page, enter the user name and
password. Click OK.
The Common Reporting portal opens.

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 17

Generating the reports
To generate a Tivoli Netcool Performance Manager report, an event is selected
from Active Events List.

Procedure

1. In the Dashboard Application Services Hub navigation, select Incident ( )

> Events > Active Event List (AEL).
2. Right-click an event from the Tivoli Netcool/OMNIbus Web GUIActive Events
List. A list menu appears that contains the new menu options
TNPMforWireless Report and RMV.
3. Select the TNPMforWireless Report option to display a new browser window.
Log in to Tivoli Netcool Performance Manager.
If you are not logged in to Tivoli Netcool Performance Manager server, the
login screen appears.
4. Enter your user ID and password.
The report that is associated with the selected event is displayed. Subsequent
event selections followed by selection of the TNPMforWireless Report menu
option display the report that is associated with the event in the same browser
window. The same browser window is always used, if one is still displayed.
The report appears as follows:

5. Select RMV to see a Resource Metric Viewer AEL report that appears as
follows:

18 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Additional information
This section explains how to:
v Use existing ObjectServer alert.status table columns
v Configure Alarm exporter in Tivoli Netcool Performance Manager

Using existing ObjectServer alert.status table columns

The following example shows how to map Tivoli Netcool Performance Manager
trap fields into the following 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 Tivoli Netcool/OMNIbus Web GUI integration.
The types of 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:
v Replace all instances of TNPMWAlarmId with OwnerUID

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI 19

 v Replace all instances of TNPMWHost with Location
v Replace all instances of TNPMWPort with Grade

Modify the script file:

tnpmforwireless.cgi

By mapping with existing fields as follows:

v TNPMWAlarmId -> OwnerUID
v TNPMWHost -> Location
v TNPMWPort -> Grade

After modification of the files, the nco_p_mttrapd probe and nco_objserv

ObjectServer processes must be stopped and started.

Based on your preferences, you can map any of the unused fields in the
alerts.status table with the TNPMWAlarmId, TNPMWHost, TNPMWPort. Mapping must
be done with same data types.

Configuring Alarm exporter in Tivoli Netcool Performance

Manager

When you create a target in the Alarm Exporter in Tivoli Netcool Performance
Manager, in the Target Editor dialog SNMPv1 must be selected as the SNMP
version.
Related information:

Alarm Exporter

20 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Appendix A. Updating Trapd rules for NcKL v4.2
This procedure applies only to Tivoli Netcool/OMNIbus Web GUI systems that are
installed with Netcool Knowledge Library (NcKL) v4.2. When you install the
Netcool Knowledge Library (NcKL), a NC_RULES_HOME directory that contains the
SNMP rules files is created. These rules files must be updated to enable integration
with Tivoli Netcool Performance Manager.

Important: A compressed file archive on the Tivoli Netcool Performance Manager

server contains all the rules files that are required for the integration. Extract this
archive and install the files as below. The location of the file is as follows

$WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip

The default $WMCROOT directory is /appl/virtuo.

Tivoli Netcool Performance Manager fields must be placed in the ObjectServer

database. You must modify Netcool mttrapd probe's rules file and incorporate a
Tivoli Netcool Performance Manager supplied rules file for Tivoli Netcool
Performance Manager events/traps to properly populate both the generic
ObjectServer fields (Summary, Identifier, Severity and so on) and extra Tivoli
Netcool Performance Manager specific fields already described.

Note: If you are using Solaris or AIX, use GNU TAR while you extract the files
from NcKL rules.tar file. Using the Solaris or AIX TAR utilities might strip off
some long file names, and create issues while starting the Omnibus SNMP probe.

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 differs

depending on deployment of Netcool probe rules files. Essentially, the rules files
must be incorporated within the rest of the Netcool framework. This incorporation
requires updates to the following files:

Note: It also requires installation of the following files into ${NC_RULES_HOME}/

include-snmptrap:
ibm-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

© Copyright IBM Corp. 2006, 2014 21

$NC_RULES_HOME/snmptrap.rules
You must add include statements to the $NC_RULES_HOME/snmptrap.rules file.

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

Enter the following include statement:

include "$NC_RULES_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.include.snmptrap.lookup"
2. 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"
#####################################################################

Enter the following include statement:

include "$NC_RULES_HOME/include-snmptrap/ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules"
3. 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"
#####################################################################

Enter the following include statement:

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

${NC_RULES_HOME}/include-snmptrap/PreClass.snmptrap.lookup
You must add entries to the ${NC_RULES_HOME}/include-snmptrap/
PreClass.snmptrap.lookup file.

Procedure

Add the following lines to the ${NC_RULES_HOME}/include-snmptrap/

PreClass.snmptrap.lookup file:
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

22 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Additional changes to Trapd rules
Any changes to the Netcool framework must be done by someone familiar with
your Netcool deployment. Some additional changes to Trapd rules might be
needed.

ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules

You might must change the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules

file as per upon your preferences. Do not change the values of the Type field for
any of the Tivoli Netcool Performance Manager trap types. 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 configured amount of time. Therefore, traps that are not green are
still outstanding and might be addressed.

ObjectServer alert.status fields

If you want to use existing ObjectServer alert.status fields, change the

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

Change the following lines of the ibm-METRICAALARMTRAP-

MIB.include.snmptrap.rules file to reflect the fields that are used:
v @TNPMWHost = $hostname
v @TNPMWPort = $port
v @TNPMWAlarmId = $alarmID

Appendix A. Updating Trapd rules for NcKL v4.2 23

24 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
Appendix B. AelLaunchScript file contents
A Tivoli Netcool/OMNIbus Web GUI menu script. A configuration script that is
required to start the Resource Metric Viewer UI from the Active Event List.

Copy the contents of the script in a notepad and save the file as
AelLaunchScript.script.txt.
dojo.require("dojo.date.stamp");
var server = ’https://’+window.location.hostname+ ’:’ + window.location.port + ’/’;

var namespace = ’p’ + ’{$param.portletNamespace}’.replace(’0x002d’, ’m’) + ’pns_’;

var alarmId = ’{@TNPMWAlarmId}’;
var nodeName = ’{@TNPMWHost}’;
var nodeIp = ’{@NodeAlias}’;

var rmvOk = alarmId > 0;

if(!rmvOk)
{
alert("Sorry, this alarm can’t be opened in RMV report");
}

if(dojo.isIE > 6) {
var aelWindow = window.parent;
if(!XMLHttpRequest) {
aelWindow.XMLHttpRequest = true;
}
}
try
{
EventBroker.sendEvent(namespace, {
name: "http://ibm.com/isclite#launchPage",
NavigationNode: "rmv.ael.nav",
pageInstanceRef: "AELReport",
switchPage: false,
message: {alarmId : alarmId, nodeName:nodeName, nodeIp:nodeIp}
});
}
catch(e) { console.info(e);
}

© Copyright IBM Corp. 2006, 2014 25

26 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
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 give you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.

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

Intellectual Property Licensing

Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

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 might 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.

© Copyright IBM Corp. 2006, 2014 27

 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 Corporation
2Z4A/101
11400 Burnet Road
Austin, 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 measurement 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.

All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to
change before the products described become available.

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.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which

illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to

28 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component
IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights
reserved.

If you are viewing this information in softcopy form, the photographs and color
illustrations might not be displayed.

Trademarks

IBM, 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, Acrobat, PostScript and all Adobe-based trademarks are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
other countries, or both.

IT Infrastructure Library is a registered trademark of the Central Computer and

Telecommunications Agency which is now part of the Office of Government
Commerce.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other

countries, or both

Microsoft and Windows are trademarks of Microsoft Corporation in the United

States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of The

Minister for the Cabinet Office, and is registered in the U.S. Patent and Trademark
Office.

UNIX is a registered trademark of The Open Group in the United States and other
countries.

Notices 29
 Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the

United States, other countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are
trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.

30 IBM Tivoli Netcool Performance Manager: Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component



Printed in USA