Tivoli Netcool/OMNIbusWeb GUI Integration -Wireless Component · About this information The IBM Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component describes how to integrate

IBM Tivoli Netcool Performance Manager 1.4Wireless ComponentDocument Revision R2E1

Tivoli Netcool/OMNIbus Web GUIIntegration - Wireless Component

��

NoteBefore 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 Contractwith IBM Corp.

Contents

About this information . . . . . . . . vIntended audience . . . . . . . . . . . . vWhat this information contains . . . . . . . . vThe Tivoli Netcool Performance Manager - Wirelesscomponent user publications . . . . . . . . . vService Management Connect . . . . . . . . viTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . . viSupport information . . . . . . . . . . . viConventions used in this publication . . . . . . vii

Typeface conventions . . . . . . . . . . vii

Chapter 1. Prerequisites . . . . . . . . 1Prerequisite information . . . . . . . . . . 1Supported configurations . . . . . . . . . . 2Groups and users. . . . . . . . . . . . . 2Software requirements and dependencies . . . . . 2Trapd rules . . . . . . . . . . . . . . . 3ObjectServer . . . . . . . . . . . . . . 3

Using existing fields . . . . . . . . . . . 3Tivoli Netcool/OMNIbus Web GUI menu . . . . 4

Chapter 2. Integration with TivoliNetcool/OMNIbus Web GUI . . . . . . 5Integration strategy . . . . . . . . . . . . 5

Tivoli Netcool/OMNIbus server configuration forwireless trap support . . . . . . . . . . 6Update Trapd rules for NcKL v4.2 . . . . . . 7Starting the ObjectServer and probes . . . . . 8Configuring alarms for Tivoli Netcool/OMNIbus 8

Installation integration module . . . . . . . 9Script file details. . . . . . . . . . . . 10

Creating tool and menu options in Web GUI . . . 12Logging in to Jazz for Service Managementapplication server . . . . . . . . . . . 12Registering the tnpmwforwireless script . . . . 12Creating new tool . . . . . . . . . . . 12Creating new menu . . . . . . . . . . 13Adding SNMP trap fields. . . . . . . . . 14

Configuring launch-in-context Active Event List onJazz for Service Management application server . . 14Configuring launch-in-context Active Event List onResource Metric Viewer . . . . . . . . . . 15

Logging in to the reporting interface . . . . . 16Generating the reports . . . . . . . . . . . 18Additional information . . . . . . . . . . 19

Appendix A. Updating Trapd rules forNcKL v4.2 . . . . . . . . . . . . . 21$NC_RULES_HOME/snmptrap.rules . . . . . . . 22${NC_RULES_HOME}/include-snmptrap/PreClass.snmptrap.lookup . . . . . . . . . 22Additional changes to Trapd rules . . . . . . . 23

Appendix B. AelLaunchScript filecontents . . . . . . . . . . . . . . 25

Notices . . . . . . . . . . . . . . 27

© 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 describeshow to integrate IBM® Tivoli® Netcool®/OMNIbus Web GUI, Version 8.1 with theWireless component of Tivoli Netcool Performance Manager, Version 1.4.

Intended audienceThis publication is intended for the network administrator or operations specialistresponsible for integrating Tivoli Netcool Performance Manager with TivoliNetcool/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 Managerv Tivoli Netcool/OMNIbus Web GUI

What this information containsThis publication contains these sections.v Chapter 1, “Prerequisites,” on page 1

An overview of the integration solution and pre-integration considerationsv Chapter 2, “Integration with Tivoli Netcool/OMNIbus Web GUI,” on page 5

Explains how to integrate IBM Tivoli Netcool/OMNIbus Web GUI with thewireless component of Tivoli Netcool Performance Manager 1.4.

v Appendix A, “Updating Trapd rules for NcKL v4.2,” on page 21Applies only to Tivoli Netcool/OMNIbus Web GUI systems that are installedwith Netcool Knowledge Library (NcKL) v1.3.

v Appendix B, “AelLaunchScript file contents,” on page 25A configuration script that is required to start the Resource Metric Viewer UIfrom the Active Event List.

The Tivoli Netcool Performance Manager - Wireless component userpublications

Tivoli Netcool Performance Manager - Wireless component consists of thefollowing publications:

Table 1. Tivoli Netcool Performance Manager - Wireless component user documentation

Document Description

Administering Tivoli Netcool Performance Manager -Wireless Component

Instructions and general information about how tomaintain and support Tivoli Netcool PerformanceManager.

Installing Tivoli Netcool Performance Manager -Wireless Component

Instructions for installing and configuring theTivoli Netcool Performance Manager software.

© Copyright IBM Corp. 2006, 2014 v

Table 1. Tivoli Netcool Performance Manager - Wireless component userdocumentation (continued)

Document Description

Installing and Using Model Maker - WirelessComponent

Provides instructions for installation and usage ofthe Model Maker application.

Release Summary for Tivoli Netcool PerformanceManager

Additional release-specific information not in theguides.

Upgrading Tivoli Netcool Performance Manager -Wireless Component

Instructions for upgrading Tivoli NetcoolPerformance Manager software.

Using Tivoli Netcool Performance Manager - WirelessComponent

Conceptual information and procedures for usingTivoli Netcool Performance Manager software forperformance, trending analysis and performancealarms.

Tivoli Monitoring Integration - Wireless Component Provides instructions for integrating IBM TivoliMonitoring with Tivoli Netcool PerformanceManager.

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 ConnectConnect, learn, and share with Service Management professionals: product supporttechnical 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 ManagementConnect 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 earlydesigns, sprint demonstrations, product roadmaps, and prerelease code.

v Connect one-on-one with the experts to collaborate and network about Tivoliand 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 trainingFor Tivoli Netcool Performance Manager technical training information, see thefollowing Tivoli Netcool Performance Manager Training website at:https://tnpmsupport.persistentsys.com/training.

Support informationIf you have a problem with your IBM software, you want to resolve it quickly. IBMprovides 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

http://www-01.ibm.com/support/knowledgecenter/SSBNJ7/welcome

http://www-01.ibm.com/support/knowledgecenter/SSBNJ7/welcome

https://www.ibm.com/developerworks/servicemanagement/nsa/index.html

https://www.ibm.com/developerworks/servicemanagement/nsa/index.html

https://www.ibm.com/developerworks/community/groups/service/html/communityview?communityUuid=d4b565fd-04e5-47c2-965a-943ccdfabdb9

https://tnpmsupport.persistentsys.com/training

OnlineAccess the IBM Software Support site at http://www.ibm.com/software/support/probsub.html .

IBM Support AssistantThe IBM Support Assistant is a free local software serviceability workbenchthat helps you resolve questions and problems with IBM softwareproducts. The Support Assistant provides quick access to support-relatedinformation and serviceability tools for problem determination. To installthe Support Assistant software, go to http://www.ibm.com/software/support/isa.

Troubleshooting GuideFor more information about resolving problems, see the problemdetermination information for this product.

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

Typeface conventionsThis publication uses the following typeface conventions:

Bold

v Lowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), 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: "TheLUN address must start with the letter L.")

v New terms in text (except in a definition list): a view is a frame in aworkspace that contains data.

v Variables and values you must provide: ... where myname represents....

Monospace

v Examples and code examplesv File names, programming keywords, and other elements that are difficult

to distinguish from surrounding textv Message text and prompts addressed to the userv Text that the user must typev Values for arguments or command options

Bold monospace

v Command names, and names of macros and utilities that you can typeas commands

About this information vii

http://www.ibm.com/software/support/probsub.html

http://www.ibm.com/software/support/probsub.html

http://www.ibm.com/software/support/isa

http://www.ibm.com/software/support/isa

v Environment variable names in textv Keywordsv Parameter names in text: API structure parameters, command

parameters and arguments, and configuration parametersv Process namesv Registry variable names in textv 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 PerformanceManager Wireless component with Tivoli Netcool/OMNIbus Web GUI.

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

Installing and updating Tivoli Netcool/OMNIbus

Installing and updating the Web GUI component

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

Ensure that you have:v Administrator credentials for Tivoli Netcool/OMNIbus Web GUIv Administrator credentials on the Dashboard Application Services Hub on Jazz

for Service Managementv 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 NetcoolPerformance Manager reports must be set up with a user ID and password by theTivoli 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 thesession either times out, or the user logs out explicitly from the Tivoli NetcoolPerformance Manager portal, or the user exits the browser window that has TivoliNetcool Performance Manager report data.

Java plug-in support

The Tivoli Netcool/OMNIbus Web GUI Active Events List is a Java applet thatruns within a browser on a remote client host. A Web GUI user who has access toTivoli Netcool Performance Manager also has access to Tivoli Netcool PerformanceManager functions. Some of these functions are also displayed by using an appletthat runs within a browser. It is possible that two different applet applicationsmight be running on the same desktop host simultaneously, when a user isaccessing reports by using this integration package. The user needs to downloadand install the Java plug-in that is required by each application.

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

© Copyright IBM Corp. 2006, 2014 1

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/install/concept/omn_ins_installingupgradinguninstalling.html

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_ins_installing.html

v Missing Active Events List selection icons on the main Tivoli Netcool/OMNIbusWeb GUI page.

v Applet loading errors for the Active Events Listv Missing plug-in messages on Tivoli Netcool Performance Manager real-time

reports.

Supported configurationsThe following configurations are supported in this solution. A stand-aloneconfiguration where Tivoli Netcool Performance Manager, TivoliNetcool/OMNIbus server, Tivoli Netcool/OMNIbus Web GUI, and the SNMPMulti-Thread trapd probe are installed on the same server is also supported.

Tivoli Netcool/OMNIbus Server and the SNMP Multi-Thread trapd probe arerecommended to be installed on a separate server than Tivoli Netcool PerformanceManager and Tivoli Netcool/OMNIbus Web GUI. The following configuration ispreferred:

Server 1Tivoli Netcool/OMNIbus and the SNMP Multi-Thread trapd probe

Server 2

v Tivoli Netcool/OMNIbus Web GUIv Tivoli Netcool Performance Manager with Jazz for Service Management

Groups and usersAll 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 creationand tool creation must exist. If such a user does not exist, then create anappropriate user. Ensure that the user is assigned to a groupNetcool_OMNIbus_Admin or Netcool_OMNIbus_User and user role as ncw_admin orncw_user.

Software requirements and dependenciesEnsure 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 Componentv IBM Tivoli Netcool/OMNIbus, Version 8.1v IBM Tivoli Netcool/OMNIbus Web GUI, Version 8.1v SNMP Multi-Thread trapd probe (mttrapd)v Netcool Knowledge Library (NcKL), Version 4.2 or laterv Dashboard Application Services Hub on Jazz for Service Management Version

1.1.0.3Tivoli Netcool/OMNIbus Web GUI uses a client/server architecture and it ishosted inside Dashboard Application Services Hub, which is part of Jazz forService Management. Clients connect to Dashboard Application Services Hub toaccess 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 24Related information:

Introduction to Tivoli Netcool/OMNIbus 8.1.0

Trapd rulesTivoli Netcool Performance Manager provides an event feed only throughMulti-Threaded SNMP Trapd probes. Tivoli Netcool Performance Managerprovides rules files for Enterprise TRAPs issued by Tivoli Netcool PerformanceManager.

The rules file defines how the probe processes event data to create meaningfulTivoli Netcool/OMNIbus alerts. The rules file also creates an identifier for eachalert to uniquely identify the problem source, so that repeated events can bededuplicated.Related information:

Probe rules files

ObjectServerThe preferred deployment of Tivoli Netcool Performance Manager requires theexpansion of the Netcool alert.status table in the ObjectServer. A list anddescriptions of the fields specific to Tivoli Netcool Performance Manager, each ofwhich must be added to the alert.status table in the ObjectServer can be foundhere.

You must modify the ObjectServer schema.

Each Tivoli Netcool/OMNIbus installation must have at least one ObjectServer tostore and manage alert information. You can also set up multiple ObjectServers onone or more host computers.Related information:

Creating and running ObjectServers

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

Procedure1. 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 threeTivoli Netcool Performance Manager trap fields to be saved in thealert.status table.You can use the SQL interactive interface (called nco_sql on UNIX and isql onWindows) to connect to a firewall bridge server, and use SQL commands tointeract with the Firewall Bridge server and retrieve configuration information.

Chapter 1. Prerequisites 3

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/user/concept/omn_ovr_introtonetcoolomnibus.html

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/probegtwy/reference/omn_prb_proberulesfilesyntax.html?lang=en

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/install/task/omn_con_creatingsettingupobjserv.html

3. Modify the script file tnpmforwireless.cgi to map the meaning of the columnsthat are used to known URL parameter names used by Tivoli NetcoolPerformance Manager.

Related information:

SQL interactive interface

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

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


http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/admin/concept/omn_adm_sql_fw_interactiveinterface.html?lang=en

Chapter 2. Integration with Tivoli Netcool/OMNIbus Web GUI

Explains the tasks that are associated with integrating Tivoli Netcool PerformanceManager with the Tivoli Netcool/OMNIbus Web GUI application. You can viewNetcool events in real time by using your Web browser. It works with the TivoliNetcool/OMNIbus application to retrieve real-time event data. The TivoliNetcool/OMNIbus Web GUI customizable dashboards display real-timeperformance 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/OMNIbusWeb GUI combines the ability of Tivoli Netcool Performance Manager to generateSNMP traps when threshold violations are detected, with the application functionof Web GUI.

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 thetrap event is sent to Tivoli Netcool Performance Manager and used to determinethe best report to present. Tivoli Netcool Performance Manager then builds a blockof HTML content that redirects the browser to a Tivoli Netcool PerformanceManager display.

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

Integration strategyOverview 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 NetcoolPerformance Manager specific alarm fields.

v Updating NCKL rules files to place appropriate Tivoli Netcool PerformanceManager specific trap data in the ObjectServer alert.status table.

v Defining a Web GUI tool that runs the script when a Tivoli Netcool PerformanceManager 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.


Tivoli Netcool/OMNIbus server configuration for wireless trapsupport

You must change the database schema to store Tivoli Netcool PerformanceManager specific trap fields in the ObjectServer database to integrate Tivoli NetcoolPerformance Manager with Tivoli Netcool/OMNIbus Web GUI. You also mustdefine new rules to map trap fields to fields in the ObjectServer database.

Adding support to the ObjectServer database schemaSupport must be added to the ObjectServer database to store Tivoli NetcoolPerformance Manager specific SNMP trap fields, by using either the nco_sqlcommand or the nco_config GUI. The ObjectServer schema must be changed tooverlay Tivoli Netcool Performance Manager data into existing columns in thedatabase 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 isused 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 willreflect those fields actually being used to store Tivoli Netcool PerformanceManager data.

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

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

Upgrading support to the ObjectServer database schemaApplicable if you are upgrading an integration. If you are upgrading anintegration, 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 ObjectServerdatabase to update Tivoli Netcool Performance Manager specific SNMP trap fields.


Procedure

To change the code by using the nco_sql command, enter the followingcommands: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.2The installation of Netcool Knowledge Library (NcKL) creates an NC_RULES_HOMEdirectory that contains SNMP rules files. NcKL v1.4 or later contains Trapd rulesfiles for Tivoli Netcool Performance Manager.

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

Note: If you are using AIX, use GNU TAR utility while you extract the files fromNcKL 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 anduncomment 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 laterSome changes that are needed to make to the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules file provided with NcKL v3.3 to support the NcKLv3.3 directory structure.

Procedure1. Extract the $WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip archive on

the Tivoli Netcool Performance Manager server to access the Tivoli NetcoolPerformance 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 probesStart the ObjectServer and probes, specifying the port number that is specified inthe 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 PerformanceManager Wireless Component.The default NCHOME is /opt/IBM/tivoli/netcool.The default OMNIHOME is $NCHOME/omnibusThe default NC_RULES_HOME is $OMNIHOME/probes/linux2x86/rules.

Configuring alarms for Tivoli Netcool/OMNIbusIn Tivoli Netcool Performance Manager, you must create an alarms target, a targetgroup, and an export rule with the destination of the Tivoli Netcool/OMNIbusserver.

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

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


http://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/wls_user_guide/ctnpm_wls_user_guide_alm_exp_2.dita?lang=en

The port that is given in that alarm rule section must match the port that is usedto start the mttrapd process in Tivoli Netcool/OMNIbus.

Installation integration moduleExplains how to place Tivoli Netcool Performance Manager specific files in to theWeb GUI environment, set up a tool in Tivoli Netcool/OMNIbus Web GUI, andassociate the new tool with a list option on the Alerts menu of the Active EventsList.

Right-click an event on the Active Events List, select TNPMforWireless menuoption. A Tivoli Netcool Performance Manager report is displayed that is relevantto the threshold violation information contained in the trap that generated theselected event.

This installation procedure assumes the successful installation of TivoliNetcool/OMNIbus Web GUI and Tivoli Netcool/OMNIbus server. TivoliNetcool/OMNIbus Web GUI must be previously configured to receive and processtrap events from the ObjectServer.

Tool definition

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


Script file detailsWhen you right-click an event in the Active Events List, a Tivoli NetcoolPerformance Manager defined script file is run in the Tivoli Netcool/OMNIbusWeb GUI. Tivoli Netcool/OMNIbus Web GUI builds HTML content that redirectsthe browser to a Tivoli Netcool Performance Manager URL that is specific for theinformation 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 forv TNPMWLIFEventTime - is the day to report for

Tivoli Netcool/OMNIbus 8.1

The Netcool_feature.zip file on the Tivoli Netcool Performance Manager servercontains the JavaScript file that is required for the integration. The location ofcompressed file is as follows:$WMCROOT/conf/netcool_rulesfiles/Netcool_feature.zip

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

The tnpmwforwireless.cgi is the Common Gateway Interface script that is requiredfor 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 GUIinstallation:<NCHOME>/omnibus_webgui/etc/cgi-bin

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

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

chmod 755 tnpmwforwireless.cgi

Stopping Jazz for Service Management application serversYou can stop any Jazz for Service Management application server by using the IBMWebSphere stopServer command. You might need to restart the application serverafter completing a configuration task for an integration service, or stop theapplication server for maintenance. To start the server again, use the startServercommand.

Procedure1. On the relevant Jazz 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:

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

Where

server_nameEnter the name of the application server that was specified when theapplication server profile was created. For example, server1.

WAS_admin_user_nameThe default user name is smadmin.

WAS_admin_passwordThis 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 serversYou can start any Jazz for Service Management virtualization and reporting serversby using the IBM WebSphere startServer command. You might need to restart theapplication server after you complete a configuration task for an integrationservice, or after you take the application server down for maintenance.

About this task

The same procedure applies to any Jazz for Service Management applicationserver.

Procedure1. 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_nameEnter the name of the application server that was specified when theapplication server profile was created. For example, server1.


Creating tool and menu options in Web GUIYou must create new tool and menu options that are created in Web GUI. Thefollowing 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 GUIv Register the tnpmwforwireless scriptv Create new toolv Create new menuv Configure the Alerts menuv Add SNMP trap fields

Logging in to Jazz for Service Management application server

Procedure1. 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 scriptProcedure1. 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 toolProcedure1. 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.


http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tip_original/ttip_start_logon.html

http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_cust_creatingcgiscript.html?lang=en

To complete the URL enter tnpmwforwireless.cgi at the end of the path thatis 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 selectedfields. Selected fields appear in the Selected box. You can select multiplefields 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 inthe Available box and click the Add button. Selected groups appear in theSelected 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 menuA Tivoli Netcool Performance Manager menu option must be created for the newtool.

Procedure1. 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 AvailableItems area of the window. The separator might be moved up and down.

8. Click Save.


The following message is displayed:Menu has been successfully modified.

9. Click Ok to close the message.

Adding SNMP trap fieldsAdd SNMP trap fields to the Entity View.

Procedure1. 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 Addselected 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 ServiceManagement application server

This procedure applies only to Tivoli Netcool/OMNIbus Web GUI systems that areinstalled with Netcool Knowledge Library (NcKL) v4.2. When you install theNetcool Knowledge Library (NcKL), a NC_RULES_HOME directory that contains theSNMP rules files is created. These rules files must be updated to enable integrationwith Tivoli Netcool Performance Manager.

About this task

When you right-click an event in the Active Events List, a script file is run byTivoli Netcool/OMNIbus Web GUI. It builds HTML content that redirects thebrowser to a Tivoli Netcool Performance Manager URL that is specific for theinformation in the selected event.


Procedure1. A compressed file archive on the Tivoli Netcool Performance Manager server

contains all the rules files for the integration. Extract this archive and install thefiles. 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/javascriptcp 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/javascriptcp 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-binchmod 755 tnpmwforwireless.cgi

You can proceed to create new tool and menu options in TivoliNetcool/OMNIbus Web GUI from Jazz for Service Management applicationserver.

Related tasks:Creating new toolCreating new menuA Tivoli Netcool Performance Manager menu option must be created for the newtool.

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

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

About this task

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

Procedure1. Log in to Jazz for Service Management. For more information, see “Logging in

to the reporting interface” on page 162. 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.


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 andNetcool_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 andposition it in your preferred location.If the Active Event List is already open, close and reopen it to see the newmenu option.

12. Click Save.The menu is now updated in the AEL, and is added as an entry in theAvailable items menus list.

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

Results

When you right-click on an entry on the Active Event List, you see the RMVscript as a selectable option in the menu. Select RMV to see a Resource MetricViewer AEL report.Related tasks:Generating the reportsTo generate a Tivoli Netcool Performance Manager report, an event is selectedfrom Active Events List.

Logging in to the reporting interfaceDepending upon your organization’s deployment of Tivoli Common Reporting,you can access the reporting interface directly or through Dashboard ApplicationServices Hub.

About this task

With the Common Reporting interface, you can perform simple lightweight tasksas well as more advanced scalable reporting that is provided by IBM CognosBusiness 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 ServicesHub login page. Both Dashboard Application Services Hub and TivoliCommon Reporting are installed in the same application servingenvironment, and the reporting interface is integrated with DashboardApplication Services Hub.


Access is determined by user roles associated with user IDs. The role thatyou need to access Tivoli Common Reporting is tcrPortalOperator. SeeAuthentication and authorization in Tivoli Common Reporting.

Procedurev 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/consoleWhere:– 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 fullyqualified host name in the URL of the Jazz for Service Managementreporting and UI server. SSO requires that the browser pass LTPA cookiesto the Jazz for Service Management application server, and these cookiescontain the fully qualified host name.

– port is the secure HTTP port number that was specified duringinstallation. The default value is 16311.

– /DASH_context_root is the context root for the console that was specifiedduring installation. The default value is /ibm/console.

2. On the Dashboard Application Services Hub login page, enter the user IDand 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 ApplicationServices 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/dispatchWhere:– 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 fullyqualified host name in the URL of the Jazz for Service Managementreporting server. SSO requires that the browser pass LTPA cookies to theJazz for Service Management application server, and these cookies containthe fully qualified host name.

– port is the non secure HTTP port number that was specified duringinstallation. The default value is 16310.

Check with your organization’s Jazz for Service Management administrator ifyou are unsure of the URL.

2. On the Log on to IBM Cognos Software page, enter the user name andpassword. Click OK.The Common Reporting portal opens.


http://www-03preprod.ibm.com/support/knowledgecenter/api/content/SSEKCU_1.1.0.2/com.ibm.psc.doc_1.1.0.2/tcr_original/ctcr_authorization.html

Generating the reportsTo generate a Tivoli Netcool Performance Manager report, an event is selectedfrom 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 EventsList. A list menu appears that contains the new menu optionsTNPMforWireless 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, thelogin screen appears.

4. Enter your user ID and password.The report that is associated with the selected event is displayed. Subsequentevent selections followed by selection of the TNPMforWireless Report menuoption display the report that is associated with the event in the same browserwindow. 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 asfollows:


Additional informationThis section explains how to:v Use existing ObjectServer alert.status table columnsv 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 Managertrap 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 PerformanceManager trap fields required for Tivoli Netcool/OMNIbus Web GUI integration.The types of mapped elements must match those required by the Tivoli NetcoolPerformance Manager trap fields as follows:OwnerUID int, TNPMWAlarmIdLocation varchar (64), TNPMWHostGrade 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 PerformanceManager trap data fields:v Replace all instances of TNPMWAlarmId with OwnerUID


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_objservObjectServer processes must be stopped and started.

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

Configuring Alarm exporter in Tivoli Netcool PerformanceManager

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

Alarm Exporter


http://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/wls_user_guide/ctnpm_wls_user_guide_alm_exp_2.dita?lang=en

Appendix A. Updating Trapd rules for NcKL v4.2

This procedure applies only to Tivoli Netcool/OMNIbus Web GUI systems that areinstalled with Netcool Knowledge Library (NcKL) v4.2. When you install theNetcool Knowledge Library (NcKL), a NC_RULES_HOME directory that contains theSNMP rules files is created. These rules files must be updated to enable integrationwith Tivoli Netcool Performance Manager.

Important: A compressed file archive on the Tivoli Netcool Performance Managerserver contains all the rules files that are required for the integration. Extract thisarchive 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 ObjectServerdatabase. You must modify Netcool mttrapd probe's rules file and incorporate aTivoli Netcool Performance Manager supplied rules file for Tivoli NetcoolPerformance Manager events/traps to properly populate both the genericObjectServer fields (Summary, Identifier, Severity and so on) and extra TivoliNetcool Performance Manager specific fields already described.

Note: If you are using Solaris or AIX, use GNU TAR while you extract the filesfrom NcKL rules.tar file. Using the Solaris or AIX TAR utilities might strip offsome 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 differsdepending on deployment of Netcool probe rules files. Essentially, the rules filesmust be incorporated within the rest of the Netcool framework. This incorporationrequires 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.rulesibm-METRICAALARMTRAP-MIB.adv.include.snmptrap.rulesibm-METRICAALARMTRAP-MIB.sev.snmptrapibm-METRICAALARMTRAP-MIB.include.snmptrap.lookupibm-METRICAALARMTRAP-MIB.user.include.snmptrap.rules


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

Procedure1. 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.lookupYou 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 4SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_indeterminate 0SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_critical 0SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_major 0SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_minor 0SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_warning 0SNMPTRAP-ibm-METRICAALARMTRAP-MIB-metricaAlarmTrap_unknown 0


Additional changes to Trapd rulesAny changes to the Netcool framework must be done by someone familiar withyour Netcool deployment. Some additional changes to Trapd rules might beneeded.

ibm-METRICAALARMTRAP-MIB.include.snmptrap.rules

You might must change the ibm-METRICAALARMTRAP-MIB.include.snmptrap.rulesfile as per upon your preferences. Do not change the values of the Type field forany of the Tivoli Netcool Performance Manager trap types. Type is used by theObjectServer to automatically clear events from the list when a reset event isreceived that corresponds to a set event already in the list. Set events always havea 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 thereset event will be placed in the clear group (green), which will automatically becleared after a configured amount of time. Therefore, traps that are not green arestill outstanding and might be addressed.

ObjectServer alert.status fields

If you want to use existing ObjectServer alert.status fields, change theibm-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


Appendix B. AelLaunchScript file contents

A Tivoli Netcool/OMNIbus Web GUI menu script. A configuration script that isrequired 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 asAelLaunchScript.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);}



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 inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany 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 (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan, Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law :

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certaintransactions, 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 beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct 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 itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation 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 materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

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

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

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

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

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

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. 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 applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. You may copy,modify, and distribute these sample programs in any form without payment toIBM for the purposes of developing, using, marketing, or distributing applicationprograms conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, mustinclude 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 rightsreserved.

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

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational 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 andtrademark information” at www.ibm.com/legal/copytrade.shtml.

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registeredtrademarks 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 andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

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

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both

Microsoft and Windows are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of TheMinister for the Cabinet Office, and is registered in the U.S. Patent and TrademarkOffice.

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

Notices 29

Java and all Java-based trademarks and logos are trademarks orregistered trademarks of Oracle and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in theUnited States, other countries, or both and is used under license therefrom.

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


��

Printed in USA

Documents

Tivoli Netcool/OMNIbusWeb GUI Integration -Wireless Component · About this information The IBM Tivoli Netcool/OMNIbus Web GUI Integration - Wireless Component describes how to integrate