IBM Tivoli Netcool Performance Manager 1.4.1Wireline ComponentDocument Revision R2E1

Tivoli Netcool OMNIbus Web GUIIntegration Guide

���

NoteBefore using this information and the product it supports, read the information in “Notices” on page 21.

© Copyright IBM Corporation 2010, 2015.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

IBM Tivoli Netcool/OMNIbus Web GUIIntegration . . . . . . . . . . . . . vIntended audience . . . . . . . . . . . . vWhat this publication contains . . . . . . . . vTivoli Netcool Performance Manager - WirelineComponent . . . . . . . . . . . . . . viService Management Connect . . . . . . . . viiTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . viiSupport information . . . . . . . . . . . viiConventions used in this publication . . . . . . vii

Typeface conventions . . . . . . . . . . viii

Chapter 1. Overview of the integrationsolution . . . . . . . . . . . . . . . 1Supported configurations . . . . . . . . . . 1Prerequisites . . . . . . . . . . . . . . 2

Configuration files . . . . . . . . . . . 3

Chapter 2. Integrating the products . . . 5Configuring the topology to support the integration 5Configuring the ObjectServer database. . . . . . 6

Updating the ObjectServer database schema . . . 6Updating TRAPD Rules . . . . . . . . . 6

Chapter 3. Creating pages for theintegration task . . . . . . . . . . . 9Copying the script tool into the tools directory . . 10

Starting Jazz for Service Management applicationservers . . . . . . . . . . . . . . . 11Stopping Jazz for Service Managementapplication servers . . . . . . . . . . . 11

Chapter 4. Configuring IBM TivoliNetcool/OMNIbus Web GUI in Jazz forService Management server . . . . . 13Assigning the appropriate roles to users . . . . . 13Adding the tool to the Alert menu. . . . . . . 13Adding the Tivoli Netcool Performance Managertrap fields to the Entity View . . . . . . . . 14

Chapter 5. Troubleshootingperformance threshold violation events 15The Performance Threshold Violation View . . . . 15Using the Performance Threshold Violation View. . 16Using the Troubleshoot Events View . . . . . . 16Viewing the resource attributes . . . . . . . . 17The graphs in Launch-in-Context andNavigate-to-Context do not appear . . . . . . 18Restoring the Tivoli Netcool Performance Managersplash screen . . . . . . . . . . . . . . 19

Notices . . . . . . . . . . . . . . 21Terms and conditions for product documentation. . 23Trademarks . . . . . . . . . . . . . . 24

© Copyright IBM Corp. 2010, 2015 iii

iv IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

IBM Tivoli Netcool/OMNIbus Web GUI Integration

The IBM® Tivoli Netcool/OMNIbus Web GUI Integration - Wireline Componentdocument describes how to integrate Tivoli® Netcool/OMNIbus Web GUI, Version8.1 with the Wireline component of IBM Tivoli Netcool Performance Manager,Version 1.4.1.

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 publication containsThis publication contains the following sections:v Chapter 1, “Overview of the integration solution,” on page 1

Describes the overview of the integration solution.v Chapter 2, “Integrating the products,” on page 5

Describes how to complete the integration by using the configuration files fromthe instructions provided.

v Chapter 3, “Creating pages for the integration task,” on page 9Describes how to create Dashboard Application Services Hub pages for each ofthe Threshold Violation View options.

v Chapter 4, “Configuring IBM Tivoli Netcool/OMNIbus Web GUI in Jazz forService Management server,” on page 13Describes the tasks to enable and configure the IBM Tivoli Netcool/OMNIbusWeb GUI tool in Jazz for Service Management.

v Chapter 5, “Troubleshooting performance threshold violation events,” on page15Describes how you can troubleshoot network performance problems by viewingdetailed information about threshold violation events in the PerformanceThreshold Violation View.

© Copyright IBM Corp. 2010, 2015 v

Tivoli Netcool Performance Manager - Wireline ComponentIBM Tivoli Netcool Performance Manager consists of a wireline component(formerly Netcool/Proviso) and a wireless component (formerly Tivoli NetcoolPerformance Manager for Wireless).

Tivoli Netcool Performance Manager - Wireline Component consists of thefollowing subcomponents:v DataMart is a set of management, configuration, and troubleshooting GUIs. The

Tivoli Netcool Performance Manager System Administrator uses the GUIs todefine policies and configuration, and to verify and troubleshoot operations.

v DataLoad provides flexible, distributed data collection and data import of SNMPand non-SNMP data to a centralized database.

v DataChannel aggregates the data collected through Tivoli Netcool PerformanceManager DataLoad for use by the Tivoli Netcool Performance ManagerDataView reporting functions. It also processes online calculations and detectsreal-time threshold violations.

v DataView is a reliable application server for on-demand, web-based networkreports.

v Technology Packs extend the Tivoli Netcool Performance Manager system withservice-ready reports for network operations, business development, andcustomer viewing.

The following figure shows the different Tivoli Netcool Performance Managermodules.

Tivoli Netcool Performance Manager documentation consists of the following:v Release notesv Configuration recommendationsv Installation and upgrade informationv User guidesv Technical notesv Online help

vi IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

The documentation is available for viewing and downloading on the informationcenter 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:

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.

IBM Tivoli Netcool/OMNIbus Web GUI Integration vii

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

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 Guide

Chapter 1. Overview of the integration solution

Threshold violation events that are generated from Tivoli Netcool PerformanceManager are displayed in the Active Event List (AEL) in IBM TivoliNetcool/OMNIbus Web GUI. This integration enables the diagnosis of networkperformance problems by providing detailed information about thresholdviolations in a Performance Threshold Violation View.

The integration solution combines the ability of Tivoli Netcool PerformanceManager to generate SNMP traps when threshold violations are detected, with theability of Web GUI to monitor events.

In the background, Tivoli Netcool Performance Manager uses the Multi-ThreadedSNMP trapd probe to provide an event feed to Tivoli Netcool/OMNIbus.Configure Tivoli Netcool Performance Manager to send SNMP traps to Tivoli onIBM Tivoli Netcool/OMNIbus when critical network devices cross a performancethreshold that can affect service.

The Performance Threshold Violation Portlet that can be started from TivoliNetcool Performance Manager displays performance threshold violation details forevents that are listed in the Active Event List portlet.

Launch-in-Context

Select a Tivoli Netcool Performance Manager alarm in the AEL and display thePerformance Threshold Violation View in a new tab.

Navigate-to-Context

On Jazz for Service Management server, you can see both the AEL and thePerformance Threshold Violation View. Select a Tivoli Netcool PerformanceManager alarm in the AEL and display the details of that event in the PerformanceThreshold Violation View.

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

are recommended to be installed on a separate server than Tivoli NetcoolPerformance Manager and IBM Tivoli Netcool/OMNIbus Web GUI. Thefollowing configuration is preferred:

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

Server 2

– IBM Tivoli Netcool/OMNIbus Web GUI– Tivoli Netcool Performance Manager with Jazz for Service

Management

© Copyright IBM Corp. 2010, 2015 1

v A single Tivoli Netcool Performance Manager deployment with DashboardApplication Services Hub that is configured to send traps to the IBM TivoliNetcool/OMNIbus.

v Multiple DataView servers on Dashboard Application Services Hub that areassociated with a single Tivoli Netcool Performance Manager deployment. Youmust repeat the integration steps on each DataView server.

PrerequisitesBefore you start the integration, ensure that you have the prerequisites.

You must have the following credentials:v Administrator credentials on the Dashboard Application Services Hub on Jazz

for Service Managementv Administrator credentials on the IBM Tivoli Netcool/OMNIbus server

You must have the following software:v IBM Tivoli Netcool Performance Manager, 1.4.1v tnpmWebgui.tar

Locate this file that contains the integration script from the directory where youextracted the 1.4.1 packages.

v IBM IBM Tivoli Netcool/OMNIbus, Version 8.1v Dashboard Application Services Hub on Jazz for Service Management, Version

1.1.1.0.IBM Tivoli Netcool/OMNIbus Web GUI uses a client/server architecture and itis hosted 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

Note: If you are using Internet Explorer 9.0, make sure that you have Java 1.8update 25 for best rendering of the Troubleshoot Events page.

– Internet Explorer 9, 10– Mozilla Firefox ESR 24– Google Chrome 24, 26, 29

You must have the following configuration:v Tivoli Netcool Performance Manager and Tivoli Netcool/OMNIbus Web GUI

installed in the same Jazz for Service Management instance that is configured tosend events to the IBM Tivoli Netcool/OMNIbus ObjectServer.

v Each of the following applications that are configured and running:– IBM Tivoli Netcool/OMNIbus Web GUI– IBM Tivoli Netcool/OMNIbus ObjectServer– SNMP Multi-Thread trapd probe (mttrapd)

The mttrapd (SNMP) probe is a generic probe that is used to process SNMPtraps. It is a multi-threaded probe and supports both UDP and TCP traps.

Related information:

Introduction to Tivoli Netcool/OMNIbus

2 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Configuration filesThe integration solution provides a number of configuration files. The integrationcan be installed as either Launch-in-Context or navigate to context option and aconfiguration file is provided for each option. You must choose which option toinstall as you can install one or the other. Installing both options is not supported.

tnpmWebgui.tar packageA package that has the scripts to create the Dashboard Application ServicesHub integration pages. The contents of the package are as follows:

tnpmWebgui.warA collection of the .nova files and rules files that are needed forintegration between Tivoli Netcool Performance Manager andTivoli Netcool/OMNIbus. During the integration, these files arecopied to the <OMNI_HOME directory structure to enable the displayof the AEL.

mttrapd.templateThis is a template that can be used for the mttrapd.rules file.

trapdProvisoWebtop.rulesA rules file that contains specific Tivoli Netcool PerformanceManager fields to be incorporated in the ObjectServer database. Itis added to the mttrapd.rules file by using the include command.

tnpmThresholdView_launchInContext.novaA script that defines the Web GUI tool for the Launch-in-Contextoption from Dashboard Application Services Hub. If you choosethis option, copy this file to the Web GUI tools directory in the Jazzfor Service Management installation. The default Web GUI toolsdirectory is /opt/IBM/netcool/omnibus_webgui/etc/configstore/ncwTools/.

tnpmThresholdView_navigateToContext.novaA script that defines the Web GUI tool for the Navigate-to-Contextoption from Dashboard Application Services Hub. If you choosethis option, copy this file to the Web GUI tools directory in the Jazzfor Service Management installation. The default Web GUI toolsdirectory is /opt/IBM/netcool/omnibus_webgui/etc/configstore/ncwTools/.

deploy.shA script that creates Dashboard Application Services Hub pages for each ofthe Threshold Violation View options.

Chapter 1. Overview of the integration solution 3

4 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Chapter 2. Integrating the products

Complete the integration by using the configuration files and instructionsprovided.

Note: To enable a user to acknowledge or take ownership of events, the same useraccount must exist in Tivoli Netcool/OMNIbus and in Tivoli Netcool/OMNIbusWeb GUI.

Quick referencev On the Tivoli Netcool Performance Manager server where the Topology Editor is

installed, perform the following steps:– “Configuring the topology to support the integration”

v On the IBM Tivoli Netcool/OMNIbus server, perform the following steps:– “Updating the ObjectServer database schema” on page 6.– “Updating TRAPD Rules” on page 6.

Related information:

Configuring Jazz for Service Management for a central user registry

Configuring the topology to support the integrationChange the following topology property values on the Tivoli Netcool PerformanceManager server where the Topology Editor is installed, typically the databaseserver.

Procedure1. Log in as the root user.2. Change to the directory that contains the Topology Editor. For example:

# cd /opt/IBM/proviso/topologyEditor

3. Enter the following command:# ./topologyEditor

Note: If your DISPLAY environment variable is not set, the Topology Editormight fail with a Java assertion message (core memory dump).

4. Update the following property values on each of the CME.x.x components:

Property Value

LOG_TRAPS true

TRAP_DESTINATION <OMNIbus_server_ IP_address>:162

5. Update the following property values on the Log Server component:

Property Value

TRAP_PORT 162

TRAP_HOST <OMNIbus_server_ IP_address>

6. Log out of the server.

© Copyright IBM Corp. 2010, 2015 5

Configuring the ObjectServer databaseChange the database schema to store Tivoli Netcool Performance Manager-specifictrap fields in the IBM Tivoli Netcool/OMNIbus ObjectServer database. Define newrules to map trap fields to fields in the ObjectServer database.

Updating the ObjectServer database schemaAdd support for the IBM Tivoli Netcool/OMNIbus ObjectServer database to storeTivoli Netcool Performance Manager - specific SNMP trap fields by using thenco_sql command.

Before you begin

You must have IBM Tivoli Netcool/OMNIbus administrator credentials.

Procedure1. Log in to the ObjectServer database.2. Enter the following commands:

cd $NCHOMEnco_sql -server NCOMS -user root -password passwordalter table alerts.status add column provisoSubElementIndex int;alter table alerts.status add column provisoThresholdType int;alter table alerts.status add column provisoViolationTime time;alter table alerts.status add column provisoSubElementGrpIndex int;alter table alerts.status add column provisoFormulaIndex int;goquit

What to do next

Change the mttrapd.rules file to place the appropriate trap fields in thecorresponding ObjectServer database fields.Related information:

Probe rules files

Updating TRAPD RulesTo update TRAPD rules, you must place specific Tivoli Netcool PerformanceManager files in the ObjectServer database.

Before you begin

The mttrapd.rules files can be found at:

$<OMNI_HOME>/probes/operating_system/mttrapd.rulesBy default, <OMNI_HOME> is opt/IBM/tivoli/netcool.

Procedure1. Copy the archive file and extract it by running the following commands:

cd <JazzSM_HOME>/products/tnpm/dataviewcp /tnpmWebgui.tar.gz .gunzip tnpmWebgui.tar.gztar -xvf tnpmWebgui.tar

6 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

The default <JazzSM_HOME> location is /opt/IBM/JazzSM. Contents of thetnpmWebgui.tar file:v console/webgui/tnpmWebgui.war

v console/webgui/configuration/probe/mttrapd.template

v console/webgui/configuration/probe/trapdProvisoWebtop.rules

v console/webgui/configuration/tools/tnpmThresholdView_launchInContext.nova

v console/webgui/configuration/tools/tnpmThresholdView_navigateToContext.nova

2. Copy the trapdProvisoWebtop.rules file that is included in this package to thedirectory that contains the rules file for the mttrapd probe. For example, onRHEL enter the following command:cp <JazzSM_HOME>/products/tnpm/dataview/console/webgui/configuration/probe/trapdProvisoWebtop.rules

/opt/netcool/omnibus/probes/linux2x86/

Note: The trapdProvisoWebtop.rules file must be in same directory as themttrapd.rules file and included in the mttrapd.rules file by using the includecommand.

3. In the rules file for the mttrapd probe (mttrapd.rules), locate the line if(match($generic-trap, "6")). Add the following code snippet to the if block.

# Deal with Proviso traps

if (match($enterprise, ".1.3.6.1.4.1.2929")){include "/opt/IBM/tivoli/netcool/omnibus/probes/linux2x86/trapdProvisoWebtop.rules"}

After you add the code snippet, the mttrapd.rules file, at the added sectionnow looks like:if (match($generic-trap, "6"))

{@Summary = "Enterprise:" + $enterprise + " Generic Trap:" + $generic-trap +" Specific Trap:" + $specific-trap + ""}## if it is not an Enterprise Specific snmp trap deal with# the Generic Trap it must be## Add the following code to mttrapd.rules

# Deal with Proviso traps

if (match($enterprise, ".1.3.6.1.4.1.2929")){

include "/opt/IBM/tivoli/netcool/omnibus/probes/linux2x86/trapdProvisoWebtop.rules"

}

If necessary, replace /opt/IBM/tivoli/netcool/omnibus/probes/linux2x86/ withthe correct path to the trapdProvisoWebtop.rules file in your deployment.

4. Stop and restart the mttrapd probe.Related information:

Setting up probes to acquire event data

Chapter 2. Integrating the products 7

8 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Chapter 3. Creating pages for the integration task

Running the deploy.sh script creates Dashboard Application Services Hub pagesfor each of the Threshold Violation View options.

Before you begin

Ensure that you copy the files in the tnpmWebgui.tar.gz file to the<JazzSM_HOME>/products/tnpm/dataview directory as described in “UpdatingTRAPD Rules” on page 6.

About this task

This task creates a page for both the Navigate to Context and theLaunch-in-Context options. The Troubleshooting Events page for theNavigate-to-Context option is available from the Dashboard Application ServicesHub navigation from the Network Events > Troubleshoot Events option.

The page for the Launch in Context option is created but is not available in thenavigation.

Note: If you have upgraded from Webtop to Web GUI and you notice that theNetwork Events > Troubleshoot Events option is not displayed correctly in thenavigation after completing this task, run the deploy.sh script again.

Procedure1. Change to the directory <JazzSM_HOME>/products/tnpm/dataview/.2. As user root, enter the following command on one line to run the deploy.sh

script:JazzSM_HOME/products/tnpm/dataview/bin/deploy.sh JazzSM_HOME<DASH_administrator_username><DASH_administrator_password> -warfile console/webgui/tnpmWebgui.war

For example: /opt/IBM/JazzSM/products/tnpm/dataview/bin/deploy.sh /opt/IBM/JazzSM smadmin smadmin -warfile console/webgui/tnpmWebgui.war

3. To verify that the Navigate-to-Context page was created, log out and log in toJazz for Service Management and click the Performance task in the leftnavigation pane.

4. Ensure that the Network Events > Troubleshoot Events option is available.

What to do next

Ensure that your users can access Web GUI tasks, such as the AEL.

© Copyright IBM Corp. 2010, 2015 9

Copying the script tool into the tools directoryWeb GUI allows users to create their own event management tools by usingscripts. The integration package offers a choice between two scripts for theThreshold Violation View tool.

About this task

The integration package provides a choice of tools, you must choose which of thetools you want to install as only one can be installed at a time.v tnpmThresholdView_launchInContext.nova

v tnpmThresholdView_navigateToContext.nova

Procedure1. Copy only one of the tools that are provided in the tnpmWebgui.tar.gz file to

the Web GUI tools directory in the Jazz for Service Management installation:v Launch-in-Context.

cp JazzSM_home/products/tnpm/dataview/console/webgui/configuration/tools/tnpmThresholdView_launchInContext.nova<webgui_home_directory>/etc/configstore/ncwTools

v Navigate-to-Context.cp JazzSM_home/products/tnpm/dataview/console/webgui/configuration/tools/tnpmThresholdView_navigateToContext.nova<webgui_home_directory>/etc/configstore/ncwTools

Where, by default, <webgui_home_directory> is /opt/IBM/Tivoli/netcool/omnibus_webgui.

2. Using the appropriate Jazz for Service Management administrator credentials,stop and start the l server. For more information about these steps, see Startingand Stopping the server.

3. To verify that the tool was created, log in to Jazz for Service Management andclick Administration > Event Management Tools > Tool Creation. The ToolCreation page is displayed.

4. Ensure that tnpmThresholdView_launchInContext ortnpmThresholdView_navigateToContext is displayed in the list of tools.

What to do next

Ensure that your users can access Web GUI tasks.Related tasks: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 down the application server for maintenance.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 you complete a configuration task for an integration service, or stop theapplication server for maintenance. To start the server again, use the startServercommand.

10 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

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 down the application server 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.

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 you complete 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.

Chapter 3. Creating pages for the integration task 11

Example

stopServer.sh server1 -username smadmin -password jazzsmpwd

12 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Chapter 4. Configuring IBM Tivoli Netcool/OMNIbus Web GUIin Jazz for Service Management server

Perform the following tasks to enable and configure the IBM TivoliNetcool/OMNIbus Web GUI tool in Jazz for Service Management.

Assigning the appropriate roles to usersEnsure that users have access to Web GUI tasks by assigning them the appropriateroles in the Dashboard Application Services Hub.

Procedure1. Log in to the Jazz for Service Management server.2. Click Users and Groups > Administrative User Roles. The Administrative

User Roles page opens.3. Assign the appropriate roles to each user:

a. Click the user ID.b. In the Roles list, select the ncw_admin and ncw_user roles.c. Click Apply.

Adding the tool to the Alert menuTo use the tool you have created, add the tool as an entry to the Alert menu in theActive Event List (AEL) menu.

Procedure1. In the Jazz for Service Management navigation, click Administration > Event

Management Tools > Menu Configuration.2. From the Available menus list, select alerts and click Modify.

The Menus Editor window is displayed.3. From the Available Items list, select tool to see the list of tools. Depending on

your previous selection, one of the following tools is available in the list:v tnpmthredholdview_launchinContext

v tnpmthredholdview_navigatetoContext

4. Select the tnpmthredholdview_launchinContext tool and click the arrowbutton to add the tool to the Current items list.

5. To change the menu item name, click the Rename button and type ShowViolation Details, and then click Save.

6. Position the new item in the menu.7. Click Save.

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

© Copyright IBM Corp. 2010, 2015 13

Adding the Tivoli Netcool Performance Manager trap fields to theEntity View

Add the Tivoli Netcool Performance Manager trap fields to the Entity View.

About this task

If you have upgraded from Webtop, the basic view now exists in the SystemViews category under Administration > Event Management Tools > Views.

Procedure1. In the Jazz for Service Management navigation, click Administration > Event

Management Tools > Views.2. Show all global views by clicking the down arrow beside My Views and

selecting Global Views.3. Select Default.4. In the Available fields list, select all fields with the prefix proviso and move

them to the Event list view list. The Tivoli Netcool Performance Manager fieldsinclude:v provisoSubElementGrpIndex

v provisoSubElementIndex

v provisoViolationTime

v provisoThresholdType

v provisoFormulaIndex

Note: If these fields show 0 values in the AEL screen, the PerformanceThreshold Violation does not work correctly.

5. Click Save and Close.

14 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Chapter 5. Troubleshooting performance threshold violationevents

If you have installed an IBM Tivoli Netcool/OMNIbus Web GUI integrationsolution, you can troubleshoot network performance problems by viewing detailedinformation about threshold violation events in the Performance ThresholdViolation View.

Threshold violation events that are generated from Tivoli Netcool PerformanceManager are displayed in the Active Event List (AEL) of IBM TivoliNetcool/OMNIbus Web GUI. By selecting a Tivoli Netcool Performance Managerevent, you can access threshold and attribute information for a resource.Depending on how your system has been set up, you access the PerformanceThreshold Violation View by using one of these methods:

The Performance Threshold Violation ViewThe Performance Threshold Violation View presents information about thresholdviolations on metrics for a given resource.

The view displays threshold violation information in a time series chart containingthe metric values before, during and after the threshold was violated. The chartalso displays the threshold configuration values for the given resource and metriccombination. The view also provides details of the resource attributes, such as itsname and type.

The view displays a single time series chart with threshold configuration lines for agiven:v Resourcev Metricv Threshold Typev Violation Time

The chart displays the time on the X axis and the value of the metric on the Y axis.If the metric values do not include 0, the Y axis does not include zero in the scale.

The chart period is 24 hours. The chart starts 12 hours before the thresholdviolation time, and ends 12 hours after the violation time. If the threshold violationtime is less than 12 hours before the current time, then the chart starts 24 hoursbefore the current time.

If the metric is aggregated, then the granularity of the metric values is taken fromthe granularity for the daily period. This granularity is either the granularity set bythe user, or the system default granularity as appropriate.

Note: The information displayed in the Performance Threshold Violation View isshown in the time zone of the client browser. For this information to align with theActive Event List (AEL), set the AEL to display the same time zone as the clientbrowser.

© Copyright IBM Corp. 2010, 2015 15

Using the Performance Threshold Violation ViewDiagnose network performance problems by viewing detailed information aboutthreshold violations in the Performance Threshold Violation View.

Procedure

1. In theDashboard Application Services Hub navigation, select Incident ( )> Events > Active Event List (AEL) The Active Event List (AEL) windowopens.

2. In the AEL pane, select an event that is generated by Tivoli NetcoolPerformance Manager.

3. Right-click the selected event and select Show Violation Details from themenu. The Performance Threshold Violation View opens in a new tab with atime series chart containing resource and threshold information.

4. Click the Diagnose button to open the Performance Diagnostic View. A timeseries chart plotting the selected resource is displayed. You can use thePerformance Diagnostic View to view related resources or metrics, and to lookat the resource over different periods.

Using the Troubleshoot Events ViewThe Troubleshoot Events view shows the Active Event List (AEL) and thePerformance Threshold Violation View in two horizontal panes.

Procedure1. In the Dashboard Application Services Hub navigation, select Performance >

Network Events > Troubleshoot Events. The Troubleshoot Events page opens.

16 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

2. In the AEL pane, select an event that is generated by Tivoli NetcoolPerformance Manager.

3. Right-click an event and select Show Violation Details. The PerformanceThreshold Violation View is updated with information about the thresholdviolation.

4. Click the Diagnose button to open the Performance Diagnostic View.A time series chart plotting the selected resource is displayed. You can use thePerformance Diagnostic View to view related resources or metrics, and to lookat the resource over different periods.

Viewing the resource attributesYou can see the list of attributes and the attribute values for the resource that isdisplayed in the Performance Threshold Violation View.

About this task

The names and values are displayed exactly as they are stored in the TivoliNetcool Performance Manager data store (including the same language).

Procedure1. On the Performance Threshold Violation View, click Resource Summary. The

resource summary pop-up window displays the attributes and values for theresource.

2. Click to close the pop-up window.

Chapter 5. Troubleshooting performance threshold violation events 17

The graphs in Launch-in-Context and Navigate-to-Context do notappear

SymptomsThe graphs in Launch-in-Context and Navigate-to-Context do not appear in theAEL and Performance Threshold Violation View windows.

Resolving the problemTo resolve this issue, follow these steps:1. Check if the proviso.log file has THRSHEVENT entry by using this command:

$ tail -f /opt/datachannel/log/proviso.log | grep THRSHEVENT

If you cannot see THRSHEVENT entries in the proviso.log file, then look at thethreshold configuration in the Resource Editor and ensure that the threshold isenabled and mode, burst and period thresholds are set.

2. The proviso database fields that are specified in “Adding the Tivoli NetcoolPerformance Manager trap fields to the Entity View” on page 14 must havenonzero values for the graphs Performance Threshold Violation View to becorrect.

3. If you have a collection ObjectServers, Aggregation Object servers and agateway between the two ObjectServers, the gateway trapd file also needs tohave the proviso fields defined. Bounce the gateway process after adding thefields.

4. Connect to the datasource that is specified in the AEL screen.v Run the following SQL statement by using the nco_config utility:

select provisoSubElementIndex, provisoFormulaIndex, provisoThresholdType from alerts.statuswhere provisoThresholdType != 0;

v Run the SQL on other relevant data sources.v Check if there is a gateway between the collection Omnibus server and the

aggregation Omnibus server, and that proviso fields have nonzero values inthe database. Ensure that the gateway trapdProvisoWebtop.rules file isupdated.You can see the nonzero values for the proviso fields selected. If not, thencheck if the trapdProvisoWebtop.rules file is correct.

5. Optional: Add debug statements into the /opt/netcool/omnibus/probes/linux2x86/trapdProvisoWebtop.rules file as follows:case ".1.3.6.1.4.1.2929":log(DEBUG, " into case for 2929 ")

@Class = 40268@Manager = "Trapd Probe PROVISO"@Agent = "PROVISO"@AlertGroup = "Threshold_Alarm"@NodeAlias = $PeerIPaddress

$provisoSubElementIndex = $1$provisoElementName = $2$provisoSubElementName = $3$provisoSubElementLabel = $4$provisoSubElementCustomerLabel = $5$provisoSubElementFamily = $6$provisoFormulaName = $7$provisoThresholdValue = $8log(DEBUG, " provisoSubElementIndex, $1 = ["+$1+"]")log(DEBUG, " provisoFormulaIndex,$24= ["+$24+"]")log(DEBUG, " provisoSubElementGrpIndex,$23 = ["+$23+"]")

18 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

log(DEBUG, " provisoViolationTime, $25 = ["+$25+"]")@provisoSubElementGrpIndex = $23@provisoFormulaIndex = $24@provisoViolationTime = $25

6. Check for the log messages in logs that are generated by IBM TivoliNetcool/OMNIbus in ncw.log file.

7. Check for correct ncw_admin and ncw_user roles for the user.

Restoring the Tivoli Netcool Performance Manager splash screen

SymptomsTypically, when two or more products are installed on Jazz for ServiceManagement, the generic IBM splash is displayed. In this integration, these filescan be seen:v OMNIbusWebgui.war

v DataView has these modules:– tnpmConsole.war

– tnpmDal.war

– legacyDataview.war

Resolving the problemTo restore the Tivoli Netcool Performance Manager splash screen, edit the two Jazzfor Service Management configuration files. To do this, follow these steps:

CAUTION:Make sure that you edit the files correctly. Back up the original files before youedit and incorrect editing and saving of these files can corrupt the Jazz forService Management installation. The server process might not come up after abounce. There is no easy way to restore the server.

1. Determine all the modules that are installed on Jazz for Service Managementserver.

2. Change to the /opt/IBM/JazzSM/profile directory and run the followingcommand to search for the ibm-portal-topology.xml file:find . -name ibm-portal-topology.xml |xargs grep about-page |grep -v wstemp |grep -v installedApps|grep -v isclite|grep-v tnpmConsole

Sample output:./profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/OMNIbusWebGUI.war/WEB-INF/ibm-portal-topology.xml:<about-page>item.layoutElement.About</about-page>

Note: If you see more entries than the one, contact the IBM SupportProfessional.

3. Change directory to where the ibm-portal-topology.xml file is located andbackup the file by using the following command:cp ibm-portal-topology.xml ibm-portal-topology.xml.bak

4. Edit the ibm-portal-topology.xml file in OMNIbusWebGUI.war that you have abackup and remove the following line alone:<about-page>item.layoutElement.About</about-page>

5. Save and exit the editor.6. Search for components.xml file in the /opt/IBM/JazzSM directory by using this

command:

Chapter 5. Troubleshooting performance threshold violation events 19

find . -name components.xml | xargs grep about-page |grep -v wstemp |grep -v installedApps|grep -v isclite.ear

Sample output shows the file that contains two entries for about-page. Afterthe edit, the file must have only one <about-page> entry; the one that youwant Jazz for Service Management to display as follows:./profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/isclite.war/WEB-INF/components.xml:<registry:about-page>item.layoutElement.About</registry:about-page>

./profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/isclite.war/WEB-INF/components.xml:<registry:about-page>tnpm.console.page.about</registry:about-page>

7. Change directory to the ./profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/isclite.war/WEB-INF/ and make abackup of the file as follows:cp components.xml components.xml.bak

8. Open the components.xml file in the editor, and then remove the following linethat occurs in the OMNIbusWEBgui.war section of the xml file:<registry:about-page>item.layoutElement.About</registry:about-page>

Keep the Tivoli Netcool Performance Manager entry.9. Save and exit the editor.

10. Bounce the Jazz for Service Management server1 process.

20 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

Notices

This information was developed for products and services that are offered in theUSA.

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 grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785United States of America

For license inquiries regarding double-byte character set (DBCS) information,contact the IBM Intellectual Property Department in your country or sendinquiries, 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 orimplied warranties in certain transactions, therefore, this statement may not applyto 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 websites are provided forconvenience only and do not in any manner serve as an endorsement of those

© Copyright IBM Corp. 2010, 2015 21

websites. The materials at those websites are not part of the materials for this IBMproduct and use of those websites 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 CorporationDepartment number/Building numberSite mailing address_City, State; Zip Code_USA (or appropriate country)

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 measurements 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:

22 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

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 toIBM, 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. The sampleprograms are provided "AS IS", without warranty of any kind. IBM shall not beliable for any damages arising out of your use of the sample programs.

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

Portions of this code are derived from IBM Corp. Sample Programs.

© Copyright IBM Corp. _enter the year or years_. All rights reserved.

Terms and conditions for product documentationPermissions for the use of these publications are granted subject to the followingterms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBMwebsite.

Personal use

You may reproduce these publications for your personal, noncommercial useprovided that all proprietary notices are preserved. You may not distribute, displayor make derivative work of these publications, or any portion thereof, without theexpress consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within yourenterprise provided that all proprietary notices are preserved. You may not makederivative works of these publications, or reproduce, distribute or display thesepublications or any portion thereof outside your enterprise, without the expressconsent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses orrights are granted, either express or implied, to the publications or anyinformation, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in itsdiscretion, the use of the publications is detrimental to its interest or, asdetermined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in fullcompliance with all applicable laws and regulations, including all United Statesexport laws and regulations.

Notices 23

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESEPUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDINGBUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

TrademarksIBM, 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 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.

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.

24 IBM Tivoli Netcool Performance Manager: Tivoli Netcool OMNIbus Web GUI Integration Guide

����

Printed in USA