Tivoli Netcool Performance Manager - Application Studio ......About this information The IBM Tivoli Netcool Performance Manager: Application Studio Installation and User Guide describes

IBM Tivoli Netcool Performance ManagerTivoli Netcool Performance Manager - Application Studio1.4.0Document Revision R2E5

Tivoli Netcool Performance Manager -Application Studio Installation and UserGuide

��

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

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

Contents

About this information . . . . . . . . vIntended audience . . . . . . . . . . . . vService Management Connect. . . . . . . . . vTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . . vSupport information . . . . . . . . . . . . vConventions used in this publication . . . . . . vi

Typeface conventions . . . . . . . . . . vi

Chapter 1. Introduction . . . . . . . . 1Tivoli Netcool Performance Manager - ApplicationStudio components . . . . . . . . . . . . 2Organization . . . . . . . . . . . . . . 2

Chapter 2. Software requirements andprerequisite software . . . . . . . . . 5Supported configurations . . . . . . . . . . 5Prerequisites for installing Tivoli NetcoolPerformance Manager - Application Studio tools . . 5

Chapter 3. Configuring the prerequisitesoftware on the server . . . . . . . . 7Creating the nasaccess user . . . . . . . . . 7Configuring Tivoli Common Reporting 3.1.0.2 forOracle database . . . . . . . . . . . . . 8Configuring the nasaccess data source for Oracleconnection . . . . . . . . . . . . . . . 9Starting Jazz for Service Management applicationservers . . . . . . . . . . . . . . . . 10Stopping Jazz for Service Management applicationservers . . . . . . . . . . . . . . . . 10Configuring the nasaccess data source . . . . . 11

Chapter 4. Installing and configuringIBM Cognos Framework Manager . . . 13Configuring IBM Cognos Framework Managerconnections . . . . . . . . . . . . . . 13Configuring Framework Manager Oracle connection 13

Chapter 5. Installing the Tivoli NetcoolPerformance Manager - ApplicationStudio . . . . . . . . . . . . . . . 15TCR Time schema installation scripts . . . . . . 15

Installing the TCR Time schema . . . . . . 16WirelessModelling tool . . . . . . . . . . 17

Opening WirelessModelling tool . . . . . . 17Configuring WirelessModelling tool . . . . . 17

CreateModel tool . . . . . . . . . . . . 18Location of the CreateModel script file . . . . 18

Installing Resource Metric Viewer . . . . . . . 19Creating a logins file with appropriate passwords 22Uninstalling Resource Metric Viewer . . . . . 23

Chapter 6. Creating Tivoli NetcoolPerformance Manager common packdata models . . . . . . . . . . . . 25Overview of creating Tivoli Netcool PerformanceManager common pack data model for Wirelesspack modelers . . . . . . . . . . . . . 25Creating a Tivoli Netcool Performance Managercommon pack data model containing a raw datamodel . . . . . . . . . . . . . . . . 26Creating a Tivoli Netcool Performance Managercommon pack data model containing a summarydefinitions model . . . . . . . . . . . . 27Creating a Tivoli Netcool Performance Managercommon pack data model containing a busy hourdefinitions model . . . . . . . . . . . . 29Data model filtering . . . . . . . . . . . 30

Filtering metrics from a model in an existing CIFfile . . . . . . . . . . . . . . . . 31Filtering intervals from existing CIF files . . . 34

Creating a model properties file . . . . . . . 35Generating the Tivoli Netcool Performance Managercommon pack data model contents . . . . . . 36Publishing a Tivoli Netcool Performance Managercommon pack data model . . . . . . . . . 37

Opening a project in Framework Manager . . . 38

Chapter 7. Getting started withCommon reporting . . . . . . . . . 39

Chapter 8. Resource Metric Viewer. . . 41Resource Metric Viewer setup . . . . . . . . 42

Enabling the Resource Metric Viewer withexisting Tivoli Netcool Performance Managercommon pack data models . . . . . . . . 42Active Event List . . . . . . . . . . . 43

Using the Resource Metric Viewer . . . . . . . 44Logging in to the reporting interface . . . . . 44Constructing a report by selecting a subset ofresources and metrics . . . . . . . . . . 45Configuring launch-in-context Active Event Liston Resource Metric Viewer . . . . . . . . 49

Resource Metric Viewer administration . . . . . 52Modify the Resource Metric Viewer template . . 52

Chapter 9. Data availability reporting 55Overview of generating data availability reports . . 55Monitoring the key traffic tables for data availability 56

Selecting tables for data availability for a vendorneutral technology pack . . . . . . . . . 58Selecting tables for data availability for a vendorspecific technology pack . . . . . . . . . 58

Generating data availability components. . . . . 60Data availability formulas . . . . . . . . 61Data availability summaries . . . . . . . . 62

© Copyright IBM Corp. 2015 iii

Provisioning the UDCs and summaries to TivoliNetcool Performance Manager Wireless system . 63Extracting and publishing daily summary model 64Scheduling and running summaries . . . . . 66

Generating data availability reports . . . . . . 68Publishing the generated data availability reports . 69Verifying the data availability report contents . . . 69Creating data availability summary report . . . . 70

Chapter 10. Troubleshooting TivoliNetcool Performance Manager -Application Studio and Commonreporting . . . . . . . . . . . . . . 71Data values that are displayed in the report do notmatch with the columns in the database . . . . . 71Restrict the number of KPIs used in creating areport from a Tivoli Netcool Performance Managercommon pack data model . . . . . . . . . 71Reporting fails with sort key too long error from abusy hour data model . . . . . . . . . . . 71Manually edit the summary name in a dataavailability model if the summary name exceeds 24characters . . . . . . . . . . . . . . . 72Issues with rehomed data in the parent entity levelin Data Availability Reports . . . . . . . . . 73

Issues with Resource Metric Viewer report withcharts and tables that is exported to PDF . . . . 73Data values are not displayed in a Resource MetricViewer report for counters with different timegranularity . . . . . . . . . . . . . . 74Label alarms that might not be handled properly bythe Resource Metric Viewer . . . . . . . . . 74Error with connection failure . . . . . . . . 74Cognos content store might stop daily . . . . . 75

Appendix. Command reference . . . . 77The createmodel command . . . . . . . . . 77rmv_admin command . . . . . . . . . . . 77

Notices . . . . . . . . . . . . . . 81Terms and conditions for product documentation. . 83Trademarks . . . . . . . . . . . . . . 84

Glossary . . . . . . . . . . . . . . 85

Index . . . . . . . . . . . . . . . 87

iv Tivoli Netcool Performance Manager - Application Studio Installation and User Guide

About this information

The IBM Tivoli Netcool Performance Manager: Application Studio Installation and UserGuide describes how to install and use Tivoli Netcool Performance Manager -Application Studio on a Tivoli Netcool Performance Manager 1.4 system.

Intended audienceThis publication is intended for:v Users who want to install and administer on a Tivoli Netcool Performance

Manager common pack data models Tivoli Netcool Performance Managersystem. Tivoli Netcool Performance Manager common pack data models enableCommon Reporting for Tivoli Netcool Performance Manager.

v Modelers who want to create and publish data models for Common Reportingin Tivoli Netcool Performance Manager.

Readers must be familiar with the following topics:v Tivoli Netcool Performance Manager reporting conceptsv Jazz for Service Management or IBM Cognos reportingv IBM Cognos Framework Manager

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:

© Copyright IBM Corp. 2015 v

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

vi Tivoli Netcool Performance Manager - Application Studio Installation and User Guide

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

About this information vii

viii Tivoli Netcool Performance Manager - Application Studio Installation and User Guide

Chapter 1. Introduction

Tivoli Netcool Performance Manager common pack data model extends technologypack data model and Summary and Busy Hour data models to Tivoli CommonReporting on Tivoli Netcool Performance Manager Wireless component. After youinstall a technology pack, you install the corresponding Tivoli Netcool PerformanceManager common pack data model to enable Tivoli Common Reporting. TivoliNetcool Performance Manager common pack data models can be delivered in theCOTS program with the corresponding technology packs, or created andcustomized by customers and IBM Business Partners.

You can create Cognos data models that are Common Data Model (CDM ) - lessmodels by using the Tivoli Netcool Performance Manager - Application Studio.

Tivoli Netcool Performance Manager - Application Studio consists of the followingfeatures and capabilities:

Consistent model generationTivoli Netcool Performance Manager - Application Studio automates thecreation of wireless data models. These models that are generated by usingTivoli Netcool Performance Manager - Application Studio are consistentand less error prone. Many Key Performance Indicators (KPIs) can bemapped automatically.

Simplified model managementTivoli Netcool Performance Manager - Application Studio takes care ofpack management, automatic creation of models and publish the modelsand reports on Dashboard Application Services Hub from Jazz for ServiceManagement.

Reusable data modelsRaw, busy hour and summary data models that are created on one servercan be reused across all servers.

Support for Compatible Query ModeTivoli Netcool Performance Manager - Application Studio contains supportfor Compatible Query Mode. For IBM Cognos Business Intelligence, thequery database (also known as the reporting database) is only accessed bythe reporting engine that runs reports. The reporting engine is installedwith Application Tier Components and is also used by FrameworkManager, Metric Designer, and IBM Cognos Transformer.

Support for Resource Metric ViewerDynamically create reports by using the Resource Metric Viewer.

Data availability reports generationData availability or data coverage describes the completeness of data for areport. You can generate the data availability model that contains reports.

© Copyright IBM Corp. 2015 1

Tivoli Netcool Performance Manager - Application Studio componentsComponents of Tivoli Netcool Performance Manager - Application Studio

Tivoli Netcool Performance Manager - Application Studio consists of the followingcomponents:

WirelessModellingA modeler tool that is required to create your own Tivoli NetcoolPerformance Manager data models. Tivoli Netcool Performance Managerdata modelers can use WirelessModelling to browse a technology pack andextract the technology pack definition metadata, or browse a live TivoliNetcool Performance Manager system and extract summary or busy hourmetadata. The metadata extracted is converted into a CommonIntermediate Format (CIF) file (.tnpmmodel) for later processing into a datamodel.

WirelessModelling contains the following component with in it:

CreateModelCreateModel is a tool that Tivoli Netcool Performance Managerdata modelers use to build Tivoli Netcool Performance Managercommon pack data models. CreateModel processes the CommonIntermediate Format (CIF) file (.tnpmmodel) generated byWirelessModelling tool.

Additional component required for creating the Tivoli Netcool PerformanceManager common pack data models:

TCR Time schemaA mandatory schema for Tivoli Netcool Performance Manager datamodels, and provides a common time dimension for reporting.

OrganizationRead this summary information to help you find the information that you need.v Chapter 1, “Introduction,” on page 1

Describes the Tivoli Netcool Performance Manager - Application Studio toolingand how to use this information.

v Chapter 2, “Software requirements and prerequisite software,” on page 5Describes the Tivoli Netcool Performance Manager - Application Studio softwarerequirements and prerequisite software.

v Chapter 4, “Installing and configuring IBM Cognos Framework Manager,” onpage 13Describes how to install the Framework Manager for publishing the datamodels.

v Chapter 5, “Installing the Tivoli Netcool Performance Manager - ApplicationStudio,” on page 15Describes how to install the Tivoli Netcool Performance Manager - ApplicationStudio component

v Chapter 6, “Creating Tivoli Netcool Performance Manager common pack datamodels,” on page 25Describes how to create a Tivoli Netcool Performance Manager common packdata model.

v Chapter 7, “Getting started with Common reporting,” on page 39

2 Tivoli Netcool Performance Manager - Application Studio Installation and User Guide

Describes the best practices in creating reports from the Tivoli NetcoolPerformance Manager common pack data models that are created by usingTivoli Netcool Performance Manager - Application Studio.

v Chapter 10, “Troubleshooting Tivoli Netcool Performance Manager - ApplicationStudio and Common reporting,” on page 71Describes known issues that you might encounter when you are using TivoliNetcool Performance Manager - Application Studio.

v “Command reference,” on page 77Provides a command reference for Tivoli Netcool Performance Manager -Application Studio commands.

v “Glossary” on page 85Includes Tivoli Netcool Performance Manager - Application Studio terms anddefinitions.

Chapter 1. Introduction 3


Chapter 2. Software requirements and prerequisite software

Ensure that your system meets the minimum software requirements and that allprerequisite software is installed and configured before starting the installation.

Supported configurationsEnsure that you have the following Tivoli Netcool Performance Managerconfiguration with the correct patch levels before you start the installation.

Table 1. Supported software components

Software Supported versions

Tivoli NetcoolPerformance Manager

1.4 - Wireless Component

Jazz™ for ServiceManagement

1.1.0.3

Tivoli CommonReporting

3.1.0.2

IBM DashboardApplication ServicesHub

3.1.0.2

IBM Cognos FrameworkManager

10.2

Jazz™ for Service Management consists of the following components.v Jazz for Service Management integration services

– Administration Services– Dashboard Application Services Hub– Security Services– Registry Services– Administration Services UI– Reporting Services environment– Tivoli Common Reporting

Related information:

Jazz for Service Management on IBM Knowledge Center

Prerequisites for installing Tivoli Netcool Performance Manager -Application Studio tools

Ensure that you fulfill these prerequisites before installing and configuring TivoliNetcool Performance Manager - Application Studio on a Microsoft Windowscomputer.

Microsoft Windows computer hardware

A minimum of 4 GB RAM with a 2 GHz processor.

Microsoft Windows operating system


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

Tivoli Netcool Performance Manager - Application StudioWirelessModelling must be installed on a Microsoft Windows computer.WirelessModelling 1.4.0 is compatible on Windows 7 and MicrosoftWindows XP Professional, x86-32, Win32.

IBM Cognos Framework Manager 10.2

You must have IBM Cognos Framework Manager installed and configuredto communicate with the Tivoli Common Reporting server. You can get theinstallation files from the following download images on PassportAdvantage.

To install Framework Manager, you must first install Framework Managerfrom the CognosModeling directory.

Download the Framework Manager 10.2 from IBM Passport Advantage.

Oracle Client 11.2.0.3

Framework Manager requires an ODBC connection to import and use anOracle data source.

For Oracle ODBC, the Oracle Client with the ODBC add-on is required.

Oracle Instant Client 11.2.0.3You must install the Oracle libraries that are contained in the Oracle instantclient package.

Note: You must install both Oracle Client and Instant Client on the Jazzfor Service Management server.


http://www-01.ibm.com/software/lotus/passportadvantage/

Chapter 3. Configuring the prerequisite software on the server

Ensure that all necessary configuration steps are completed for the prerequisitesoftware on the server.

Creating the nasaccess userThe nasaccess user must be created in the target database. The nasaccess user isresponsible for creating users and for assigning access to the TCR Time schemaand Tivoli Netcool Performance Manager Wireless system schema.

Before you begin

You must have database administrator privileges to perform this task.

Ensure that Dashboard Application Services Hub is up and running. For moreinformation about Dashboard Application Services Hub from Jazz for ServiceManagement, see Installing Tivoli Netcool Performance Manager - Wireless Component.

Ensure that the database is started.

About this task

If the nasaccess user does not exist, a database administrator must create thenasaccess user on the target database before you install the TCR Time schema.This task has to be performed before you start creating the Tivoli NetcoolPerformance Manager common pack data models.

Procedure

Create the main user schema nasaccess and grant permission to the user byrunning the following SQL statement:CREATE USER nasaccess IDENTIFIED BY nasaccessDEFAULT TABLESPACE wm_flexpm TEMPORARY TABLESPACE temp;

Grant Alter Session,Create User, Alter User, Drop User,Grant Any Role, Grant Any Privilege,Analyze Any, Create Any Table, Alter Any Table,Drop Any Table, Select Any Table, Insert Any Table,Update Any Table, Delete Any Table, Create Any Index,Create Any View, Drop Any View, Create Any Synonym,Drop Any Synonym, Create Trigger, Create Sequence,Create Public Synonym, Drop Public Synonym,Create Session, Create Procedure, Create Library,Create Synonym, Create Table, Create Role,Create Type, Create View, Alter Any Trigger,Create Any Trigger, Drop Any Trigger, Alter Any Index,Drop Any Index, Lock Any Table, Comment Any Table,Alter Any Role, Drop Any Role, Alter Any Type,Create Any Type, Drop Any Type, Execute Any Type,Alter Any Sequence, Create Any Sequence, Drop Any Sequence,Select Any Sequence, Unlimited Tablespace, Create Any Procedure,Drop Any Procedure, Execute Any Procedure, Alter Any Procedure,


Grant Any Object Privilege, Resumable, Execute Any Program,Execute Any Class, Create Job, Create Any Job, Create External Job,Analyze Any Dictionary, Select Any Dictionary, Select Any Transaction

To nasaccess;

Configuring Tivoli Common Reporting 3.1.0.2 for Oracle databaseConnect the Tivoli Common Reporting to an Oracle database.

Before you begin

Perform this task with the support of a database administrator.

Make sure that you installed the Oracle database client on the computer whereCognos based Tivoli Common Reporting engine is installed.

Note: You might need to export the TNS_ADMIN environment variable beforestarting the Tivoli Common Reporting server. The TNS_ADMIN variable in thesetTCRenv.sh script must be set to point to the directory where the Oracletnsnames.ora file is. See the Oracle documentation for details.

About this task

To configure the database, connect it to a client, configure calculations for Oraclefunctions, and activate the optional cross-database function.

Procedure1. Edit WebSphere Application Server scripts to use the setTCRenv.sh script. To do

this, append REPORTING_HOME/bin/setTCRenv.sh to the JazzSM_WAS_Profile/bin/setupCmdLine.sh.The default REPORTING_HOME is /opt/IBM/JazzSM/reporting.The default JazzSM_WAS_Profile is /opt/IBM/JazzSM/profile.

2. Add the following information to the setTCRenv.sh file:ORACLE_HOME=/appl/oracle/product/11.2.0/db_1export ORACLE_HOMETNS_ADMIN=$ORACLE_HOME/network/adminexport TNS_ADMINLD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATHexport LD_LIBRARY_PATH

3. Add the following information to startServer.sh file as root user:ORACLE_HOME=/appl/oracle/product/11.2.0/db_1export ORACLE_HOMETNS_ADMIN=$ORACLE_HOME/network/adminexport TNS_ADMINLD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATHexport LD_LIBRARY_PATH

4. Ensure that Tivoli Common Reporting can find Oracle databases:a. Check if the Oracle directory that contains the libraries exists.b. If necessary, create or modify the variable to include the path to Oracle

client library directory:

LIBPATH

LD_LIBRARY_PATH


For example: LD_LIBRARY_PATH = /opt/IBM/JazzSM/reporting/cognos/bin64:/appl/oracle/product/11.2.0/db_1/lib32

c. Save your changes.5. Connect the Oracle database client to the database server by running the Oracle

Net Configuration Assistant, configuring the local net service nameconfiguration, and restarting your system.

Important: Note the name of the connection you created as it is used in one ofthe following steps.

6. Restart the Jazz for Service Management application server.7. Create a database connection for Cognos. See “Configuring the nasaccess data

source” on page 11.Related tasks:“Starting Jazz for Service Management application servers” on page 10You 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.

Configuring the nasaccess data source for Oracle connectionConfigure the nasacess data source for connecting to Oracle

Procedure

Add nasaccess to the tnsnames.ora file on the server in this location:$ORACLE_HOME/network/admin/tnsnames.ora.Edit the tnsnames.ora file and add the following lines to the file:VTDB =(DESCRIPTION =

(ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)(HOST = TNPM_VIRTUO_DATABASE_HOST)(PORT = 1521))

)(CONNECT_DATA =

(SERVICE_NAME = vtdb))

)

nasaccess =(DESCRIPTION =


)(CONNECT_DATA =


)

Where TNPM_VIRTUO_DATABASE_HOST is the Tivoli® Netcool® Performance Manager -Wireless Component database server host name or IP address.

Chapter 3. Configuring the prerequisite software on the server 9

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.

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

Configuring the nasaccess data sourceYou must configure a nasaccess data source connection to connect to an Oracledatabase that has Tivoli Netcool Performance Manager data.

Procedure1. Log in to Dashboard Application Services Hub portal as the administration

user, smadmin.For example: https://<host>:16311/ibm/console/logon.jsp

2. Start the administrative console from Console Settings > WebsphereAdministrative Console and click Launch Websphere administrative console.a. Optional: Enter the WebSphere administrator user ID and password, and

click Log in.b. In the new window from left menu, select Servers > Servers Types >

WebSphere Application Server.c. Select the server that is used by Jazz for Service Management.

By default, server1.d. In the Server Infrastructure section, select Java and Process Management >

Process Definition.e. In the Additional Properties section, select Environment Entries.f. If necessary, create or modify the variable to include the path to Oracle client

library directory:

LIBPATH

LD_LIBRARY_PATH

For example:LD_LIBRARY_PATH=/opt/IBM/JazzSM/reporting/cognos/bin64:/opt/oracle/app/oracle/product/11.2.0/client/lib32

Add two more environment variable entries:v ORACLE_HOME=/opt/oracle/app/oracle/product/11.2.0/db_1v TNS_ADMIN=/opt/oracle/app/oracle/product/11.2.0/db_1/network/admin

g. Save your changes.3. Restart WebSphere Application Server:

“Stopping Jazz for Service Management application servers” on page 10“Starting Jazz for Service Management application servers” on page 10

4. Select the Common Reporting tab.5. Click Launch > IBM Cognos Administration.6. On the Configuration tab, click the New Data Source button to add a data

source.7. Follow the New Data Source wizard and note the following steps:

a. Enter nasaccess in the name field and click Next.b. In the Type list, select Oracle and click Next.c. In the SQL*Net connect string field, enter vtdb.d. In the Signon section, select the User ID, Password, and Create a signon

that the Everyone group can use check boxes.

Chapter 3. Configuring the prerequisite software on the server 11

e. Enter the user ID and password, and then click Finish.f. Test the new data source connection.

Related information:

Connecting to an Oracle database in Compatible mode


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

Chapter 4. Installing and configuring IBM Cognos FrameworkManager

Framework Manager is a modeling tool available for Windows operating systemsfor creating and modifying business views of data models.

About this task

Framework Manager is a Windows-based utility included in the Cognos® Modelingproduct. The installation image for Cognos Modeling is on a separate installationmedia in the following location:\CognosModeling\win32\issetup.exe.

Procedure1. Run the installation image:

\CognosModeling\win32\issetup.exe.2. Provide all the necessary parameters.

For information about installing the Framework Manager, seehttp://www-01.ibm.com/support/knowledgecenter/SSEP7J_10.2.0/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.0.doc/t_installfm.html%23InstallFMFor information about configuring Environment properties for FrameworkManager, seehttp://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tcr_original/ttcr_configure_frameworkmgr.html

Configuring IBM® Cognos® Framework Manager connectionsYou must configure the required Framework Manager connections.

Configure Framework Manager connection

You configure Framework Manager to point to the server on which you publishyour content. If you want to publish content to another server, you must changethese settings to point to the new server.

For information about configuring Framework Manager connections, seehttp://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tcr_original/ttcr_configure_frameworkmgr.html .

Configuring Framework Manager Oracle connection

Procedure1. Add Oracle to your Windows path. For example, C:\oracle\product\11.2.0\

client_1\bin.2. Add nasaccess to the tnsnames.ora file on the server in this location:

C:\appl\oracle\product\ 11.2.0\client_1\network\admin.Edit the tnsnames.ora file and add the following lines to the file:VTDB =(DESCRIPTION =



http://www-01.ibm.com/support/knowledgecenter/SSEP7J_10.2.0/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.0.doc/t_installfm.html%23InstallFM

http://www-01.ibm.com/support/knowledgecenter/SSEP7J_10.2.0/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.0.doc/t_installfm.html%23InstallFM

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




)(CONNECT_DATA =


)

nasaccess =(DESCRIPTION =


)(CONNECT_DATA =


)

Where TNPM_VIRTUO_DATABASE_HOST is the Tivoli Netcool Performance Manager -Wireless Component database server host name or IP address.


Chapter 5. Installing the Tivoli Netcool Performance Manager -Application Studio

The WirelessModelling_<version>-win32.win32.x86.zip file containsWirelessModelling and CreateModel components in it.

Procedure1. Download the WirelessModelling_<version>-win32.win32.x86.zip archive file.2. Extract the WirelessModelling_<version>-win32.win32.x86.zip file to a

location of your choice.For example, C:\npm_app_studio.

Results

You see the following files and folders in C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86:v CreateModel_<version>

– createmodel

– java

v WirelessModelling_<version>

v install_tcrtime.zip

v rmv.zip

– admin

– conf

– lib

– logs

– scripts

– sql

– templates

TCR Time schema installation scriptsThe TCR Time schema is a mandatory for all Tivoli Netcool Performance Managercommon pack data models, and provides a common time dimension for reporting.It must be installed before you can work with any Tivoli Netcool PerformanceManager common pack data models.v Extract the install_tcrtime.zip file from the C:\npm_app_studio\

WirelessModelling_<version>-win32.win32.x86 directory. You have the scriptsfor installing TCR Time schema and for populating the calendar schema tablesfor TCR Time schema.

v Copy the scripts to the server where Tivoli Netcool Performance Managerdatabase is installed.


Installing the TCR Time schemaAll data models have a dependency on the TCR Time schema. The TCR Time is amandatory dependent schema for all Tivoli Netcool Performance Manager commonpack data models, and provides a common time dimension for reporting. It mustbe installed before you can work with any Tivoli Netcool Performance Managercommon pack data model.

Before you begin

Ensure that you have downloaded the TCR Time schema.

Ensure that you have created the nasaccess user. See “Creating the nasaccess user”on page 7

Ensure that you have configured the nasaccess datasource on DashboardApplication Services Hub. See “Configuring the nasaccess data source” on page 11

Procedure1. Install the TCR Time schema by running the following command as user

virtuo:./pre_install.ksh

The pre_install.ksh script is in the folder where you have extracted the TivoliNetcool Performance Manager - Application Studio. For more information, seeChapter 5, “Installing the Tivoli Netcool Performance Manager - ApplicationStudio,” on page 15.

2. Populating the calendar schema table for TCR Time by running the followingcommand as user virtuo:./calendar_refill.ksh <Admin database NASACCESS user name><Admin database NASACCESS user password> <SID>

Example: ./calendar_refill.ksh nasaccess nasaccess vtdb

The calendar_refill.ksh script is in the folder where you have extracted theTivoli Netcool Performance Manager - Application Studio. For moreinformation, see Chapter 5, “Installing the Tivoli Netcool Performance Manager- Application Studio,” on page 15.The calendar_refill.ksh script adds past and future dates to the calendarschema table without clearing existing entries. Typically, you run this actioneach night to add the data for the day after the next day. For example, you canrun the populate action on Monday to create entries for Wednesday. Thisexample enables reporting through the midnight hour, since we have thetimestamps in the calendar for the data arriving. calendar-refill clears thecalendar schema table and repopulates it with past and future dates. Typically,a frequency of once a month is adequate to run the calendar-refill action. Themain purpose of the calendar-refill action is to remove old timestamps.


WirelessModelling toolWirelessModelling is a tool that modelers can use to browse a technology pack andextract the technology pack definition metadata, or browse a live Tivoli NetcoolPerformance Manager system and extract the summary or busy hour metadata.The metadata extracted is converted into a Common Intermediate Format (CIF) file(.tnpmmodel) for later processing into a data model.

Opening WirelessModelling toolWirelessModelling is installed by extracting an archive file to a location of yourchoice. You open WirelessModelling tool by running a Windows executable file.

Before you begin

This procedure assumes that the WirelessModelling files are extracted in theC:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86 folder.

Procedure1. Go to the folder where WirelessModelling executable file is located. For

example C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\WirelessModelling_<version>\launcher.exe.

2. Double-click launcher.exe.3. In the Workspace Launcher window, accept the default location

C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\WirelessModelling_<version>\workspace, or browse to a location of yourchoice for the workspace where your WirelessModelling projects and files arestored and click OK. You can modify this location later if required.WirelessModelling opens in Resource perspective.

Configuring WirelessModelling toolComplete the following tasks to configure the WirelessModelling tool.

Configuring IBM Cognos Business Intelligence preferencesConfigure the Cognos preferences. You must configure the BMT Script Playerlocation before you can publish the Cognos models.

Procedure1. Select Window > Preferences.2. In the Preferences window, select TNPM Preferences > Cognos.3. In the Cognos window, provide the following details:

Option Description

BmtScriptPlayer Executable Path Browse to the location of theBmtScriptPlayer.exe file in your CognosFramework Manager installation. ForCognos 10.2.1, the default location isC:\Program Files\cognos\c10\bin\BmtScriptPlayer.exe.

Chapter 5. Installing the Tivoli Netcool Performance Manager - Application Studio 17

Option Description

Cognos Dispatcher URI A read-only value that is read from theDispatcher URI for external applicationsvalue in IBM Cognos Configuration. Thisvalue shows the server where FrameworkManager publishes content, for example,http://server:port/tarf/servlet/dispatch/ext. You cannot modify this valuehere. If you want to publish content to adifferent server, you must configureFramework Manager to point to the newserver by using IBM Cognos Configuration.

Username WAS_admin_user_name. For example,smadmin.

Password WAS_admin_password.

Namespace The namespace is defined in the Securitysection of IBM Cognos Configuration. Bydefault, VMMProvider.

Configuring the JDBC driverYou must configure the JDBC driver before you can connect to a database.

Procedure1. Select Window > Preferences.2. In the Preferences window, select TNPM Preferences > Database

Configuration.3. Browse to the location of the JDBC driver library file. . For example,

C:\oracle\client\instant\ojdbc6.jar for Oracle 11g.4. In the Preferences window, select TNPM Preferences > Database Details.5. Enter the host name of the working system. For example: myhost.ibm.com.6. Click Apply and click OK.

CreateModel toolCreateModel is a tool that modelers use to build Tivoli Netcool PerformanceManager common pack data models. CreateModel processes the CommonIntermediate Format (CIF) file (.tnpmmodel) generated by WirelessModelling tool.

Location of the CreateModel script fileCreateModel tool is installed by extracting the WirelessModelling_<version>-win32.win32.x86 archive file.

About this task

The createmodel command is available at the following location:C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>\createModel\bin\createmodel.bat.


Installing Resource Metric ViewerResource Metric Viewer must be installed on the server where Jazz for ServiceManagement is installed.

Before you begin

Extract the rmv.zip file to <JAZZSM_HOME> from the location where you havedownloaded and extracted the WirelessModelling_<version>-win32.win32.x86.zipfile. Where <JAZZSM_HOME> is the location where the Jazz for ServiceManagement Components is installed. By default, /opt/IBM/JazzSM.

For more information, see Chapter 5, “Installing the Tivoli Netcool PerformanceManager - Application Studio,” on page 15.

Procedure1. Go to the admin folder and run the rmv_install.sh command by using the

following commands:cd admin./rmv_install.sh

Provide the following inputs.a. Enter the JDBC URL for the administrative database. Due to an Oracle

limitation, the host name cannot exceed 60 characters. If the host nameexceeds 60 characters, use the IP address instead.

Please enter the database url:(jdbc:oracle:thin:@hostname:1521:vtdb):jdbc:oracle:thin:@10.55.236.187:1521:vtdb

b. Enter the directory where the Oracle client is installed.For example,/appl/oracle/product/11.2.0/db_1.

Please enter the location for ORACLE_HOME:(/appl/oracle/product/11.2.0/db_1):/appl/oracle/product/11.2.0/db_1

c. Enter the name of the administrative database user nasaccess

Please enter the username for database:(nasaccess):nasaccess

d. Enter the password of the administrative database user nasaccess

Please enter the password for database:(nasaccess):nasaccess

e. Enter the Jazz for Service Management installation directory. Bydefault,/opt/IBM/JazzSM.

Please enter the JazzSM location:(/opt/IBM/JazzSM):/opt/IBM/JazzSM

f. Enter a Jazz for Service Management administrator user name. By default,smadmin.

Please enter the JazzSM username:(smadmin):smadmin


g. Enter a Jazz for Service Management administrator user name. By default,smadmin.

h. Enter the Cognos Dispatcher port.

Please enter the Dispatcher port:(16310):16310

The install script runs with the following output:Running sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/create_user.sql

PL/SQL procedure successfully completed.

Running sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/create_tables.sql

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.

Grant succeeded.



Running sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/create_views.sql

View created.

View created.

View created.

View created.

View created.

View created.

Running sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/bi_rmv_merge.pks

Package created.

Running sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/bi_rmv_merge.pkb

Package body created.

WASX7209I: Connected to process "server1" on node JazzSMNode01 using SOAP connector;The type of process is: UnManagedProcess

rmv.install.intro


tools.install.configuringJdbctools.install.getJDBCDetailstools.install.getJDBCDetailstools.install.configuringJdbcProvidertools.install.deletingJdbcProvidertools.install.createdJdbcProvidertools.install.configuringJdbcDataSourcetools.install.createdJdbcDataSource

WASX7209I: Connected to process "server1" on node JazzSMNode01 using SOAP connector;The type of process is: UnManagedProcesscom.ibm.isclite.DeployBundleActivator.start(BundleContext context) EntryWASX7327I: Contents of was.policy file://// Template policy file for enterprise application.// Extra permissions can be added if required by the enterprise application.//// NOTE: Syntax errors in the policy files will cause the enterprise application FAIL to start.// Extreme care should be taken when editing these policy files. It is advised to use// the policytool provided by the JDK for editing the policy files// (WAS_HOME/java/jre/bin/policytool).//

grant codeBase "file:${application}" {};grant codeBase "file:${jars}" {};grant codeBase "file:${connectorComponent}" {};grant codeBase "file:${webComponent}" {};

grant codeBase "file:${ejbComponent}" {};

ADMA5078I: Update of isc has started.ADMA5058I: Application and module versions are validated with versions of deployment targets.ADMA5009I: Extracting application archive to/opt/IBM/JazzSM/profile/wstemp/appmgmt/mbean/AppManagement_14501ead05a_1/app_14503982d04/ext/tnpmrmv.war.ADMA5064I: FileMergeTask completed successfully for isc.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.CWLAA10007I: Explanation: The help plug-in of the Integrated Solutions Console module was deployed successfully.User action: No user action required.CWLAA10001I: Explanation: The Integrated Solutions Console module was deployed successfully.User action: No user action required.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5113I: Activation plan created successfully.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5011I: The cleanup of the temp directory for application isc is complete.ADMA5079I: Update of isc has ended. The application or its web modules may require a restart when a saveis performed.

2. Restart the Jazz for Service Management.3. Optional: Run the db2start command to restart the database instance.

cd /./home/smadmin/sqllib/adm/db2stop./home/smadmin/sqllib/adm/db2start

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


Creating a logins file with appropriate passwordsYou must create a logins file containing certain passwords that are required by thermv_admin command. For your security, change the default passwords providedduring installation. If you update any of the passwords, ensure that you updatethe credentials file, or the nasaccess data source, as appropriate.

Before you begin

The following password are required:

smadminThe default Jazz for Service Management administrator user.

nasaccessA control user that you must create on the database before running theinstaller.

About this task

The rmv_admin command automatically encrypts the passwords when creating thelogins file.

For instructions on changing Oracle user or schema passwords, seehttp://www.orafaq.com/wiki/Oracle_database_Security_FAQ#How_does_one_change_an_Oracle_user.27s_password.3F.

If you change the Oracle nasaccess user password, then you must also change theCognos nasaccess data source. If you change the Jazz for Service Managementsmadmin user password, you must recreate the logins file with the new credentials.The old logins file is no longer valid.

Procedure

Enter the following command in one line and provide the passwords whenprompted:# ./rmv_admin.sh -passwordfile ./logins.txt -tipuser smadmin-dbusers tnpm:nasaccess

You see the following output:

Please enter the password for user nasaccess:

nasaccessPlease re-enter the password for user nasaccess:

nasaccessPlease enter the password for user smadmin:

Smadmin01Please re-enter the password for user smadmin:

Smadmin01The following file was created: logins.txtCTGTRR205I The operation createLoginsFile successfully performed.


http://www.orafaq.com/wiki/Oracle_database_Security_FAQ#How_does_one_change_an_Oracle_user.27s_password.3F

http://www.orafaq.com/wiki/Oracle_database_Security_FAQ#How_does_one_change_an_Oracle_user.27s_password.3F

Uninstalling Resource Metric ViewerInstructions on how to uninstall Resource Metric Viewer UI components.

Procedure

Uninstall the Resource Metric Viewer UI component by running the followingcommand as root user:./rmv_uninstall.sh

Enter the required information when you are prompted as follows:Please enter the database url:(jdbc:oracle:thin:@hostname:1521:vtdb):jdbc:oracle:thin:@10.55.236.187:1521:vtdbPlease enter the location for ORACLE_HOME:(/appl/oracle/product/11.2.0/db_1):/appl/oracle/product/11.2.0/db_1Please enter the username for database:(nasaccess):nasaccessPlease enter the password for database:(nasaccess):nasaccessPlease enter the JazzSM location:(/opt/IBM/JazzSM):/opt/IBM/JazzSMPlease enter the JazzSM username:(smadmin):smadminPlease enter the JazzSM password:(smadmin):smadminRunning sql: /opt/IBM/JazzSM/MH_RMV/rmv/sql/drop_all_objects.sql

Package dropped.

View dropped.

View dropped.

Sequence dropped.

Table dropped.

Index dropped.

Table dropped.

Index dropped.

Table dropped.

Table dropped.

Table dropped.

User dropped.

executed uninstallschemaWASX7209I: Connected to process "server1" on node JazzSMNode01 using SOAP connector;The type of process is: UnManagedProcess

bi.uninstall.intro

tools.uninstall.removingJdbc

bi.uninstall.completeWASX7209I: Connected to process "server1" on node JazzSMNode01 using SOAP connector;ADMA5078I: Update of isc has started.CWLAA10005I: Explanation: The Integrated Solutions Console module was removed successfully.ADMA5058I: Application and module versions are validated with versions of deployment targets.


ADMA5009I: Extracting application archive to /opt/IBM/JazzSM/profile/wstemp/appmgmt/mbean/AppManagement_14501ead05a_1/app_14503982d04/ext/tnpmrmv.war.ADMA5064I: FileMergeTask completed successfully for isc.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5113I: Activation plan created successfully.ADMA5005I: The application isc is configured in the WebSphere Application Server repository.ADMA5011I: The cleanup of the temp directory for application isc is complete.ADMA5079I: Update of isc has ended. The application or its web modules may require a restartwhen a save is performed.#


Chapter 6. Creating Tivoli Netcool Performance Managercommon pack data models

Creating a Tivoli Netcool Performance Manager common pack data model forCommon Reporting on Tivoli Netcool Performance Manager requires these TivoliNetcool Performance Manager - Application Studio components.v Use WirelessModelling tool to extract the required metadata from a technology

pack or from the Tivoli Netcool Performance Manager database.WirelessModelling tool outputs the metadata in a Common Intermediate Format(CIF) file (.tnpmmodel) that serves as the input for CreateModel tool.

v Use CreateModel tool to generate a Tivoli Netcool Performance Managercommon pack data model built from the metadata in the CIF file, and allremaining artifacts in the required directory structure for the model contents.

v Finally, use Framework Manager to browse to the model contents and publishthe model in the Tivoli Common Reporting component of the Tivoli NetcoolPerformance Manager system.

Overview of creating Tivoli Netcool Performance Manager commonpack data model for Wireless pack modelers

Wireless pack modelers can follow these steps to create Tivoli Netcool PerformanceManager common pack data models. Each step points to other topics for moredetailed information.

About this task

Ensure that you have an operational Tivoli Netcool Performance Manager systemwith all the Tivoli Netcool Performance Manager - Application Studio componentsinstalled.

Procedure1. Model the data from a technology pack or extract the summary and busy hour

data from the Tivoli Netcool Performance Manager system. See the followingtopics:“Creating a Tivoli Netcool Performance Manager common pack data modelcontaining a raw data model” on page 26“Creating a Tivoli Netcool Performance Manager common pack data modelcontaining a summary definitions model” on page 27“Creating a Tivoli Netcool Performance Manager common pack data modelcontaining a busy hour definitions model” on page 29

2. Optional: Reduce the size of your data model, you can filter out metrics toinclude only those metrics that you want to report on. For more information,see “Data model filtering” on page 30 and for the procedure, see “Filteringmetrics from a model in an existing CIF file” on page 31.

3. Create the model properties file. See “Creating a model properties file” on page35

4. Generate the Tivoli Netcool Performance Manager data model contents. See“Generating the Tivoli Netcool Performance Manager common pack data modelcontents” on page 36


5. Publish the data model. See “Publishing a Tivoli Netcool Performance Managercommon pack data model” on page 37

Creating a Tivoli Netcool Performance Manager common pack datamodel containing a raw data model

You can extract raw data counters from a technology pack. You can then create aTivoli Netcool Performance Manager common pack data model containing a modelthat report authors can use to create reports by using those raw data counters.

Procedure1. In WirelessModelling tool, select File > New > Project.2. Click General > Project, and then click Next.3. Enter the project name. Typically, you use the name of the technology pack.4. Click Finish.5. In the Project Explorer, right-click the new project and select Import. The

Import wizard opens.6. On the Select page of the Import wizard, expand TNPM Pack Modeling and

select Import a Wireless Pack Archive (from archive) or Import a WirelessPack Archive (from expanded folder).

7. Optional: Select Import a Wireless Pack Archive (from expanded folder) toimport a technology pack that is copied from an installed Tivoli NetcoolPerformance Manager system.Browse to the source folder where the pack model is available. For example:v GSM_Nokia_BSS_RG20-4.0.0 Technology Pack

..\admin\techpacks\GSM_Nokia_BSS_RG20\4.0.0\

v UMTS_Nokia_UTRAN_RU40 Technology Pack..\admin\techpacks\UMTS_Nokia_UTRAN_RU40\7.0.0\

Important: For all packs that are not released by IBM as a part of CommercialOff The Shelf (COTS) program or those packs that are customized by you, youmust use Import a Wireless Pack Archive (from expanded folder) option toimport the models.

8. Click Next.9. On the Database details page, specify the following connection details:

v Host: Hostname where the database is installedv Username: Username of the system. By default, virtuov Password: Password for virtuo userv Database SID: SID name to connect. By default, vtdb.

10. Click Test Connection.11. Click Next when the connection is successful.12. Browse to a folder that contains a technology pack and click Open. The

contents of the technology pack are imported and inspected.13. Click Next.14. On the Select Entities page, you can see the vendor and all the entities that are

associated with the pack. Select the required entities and click Next. Typically,you must select the Vendor and Neutral entities


15. On the Save As page, enter a name for the tnpmmodel file. A CommonIntermediate Format (CIF) file (.tnpmmodel) is generated based on the nameof the technology pack. Select your project folder, and then click Finish.

16. In the Project Explorer, select the CIF file to see the contents and browsethrough the resource set and the metric group set to check your data.

17. If you want to reduce the size of the CIF file by only including specificmetrics for particular resources, filter the CIF file as described in “Filteringmetrics from a model in an existing CIF file” on page 31.

18. Generate the data model contents as described in “Generating the TivoliNetcool Performance Manager common pack data model contents” on page36.

19. Publish the Tivoli Netcool Performance Manager common pack data model byusing Framework Manager. For more information about how to publish the,see “Publishing a Tivoli Netcool Performance Manager common pack datamodel” on page 37.

Creating a Tivoli Netcool Performance Manager common pack datamodel containing a summary definitions model

On Tivoli Netcool Performance Manager - Wireless component, you can extract thesummary definitions associated with a particular technology pack from the TivoliNetcool Performance Manager database. You can then create a Tivoli NetcoolPerformance Manager common pack data model containing a model that reportauthors can use to create reports by using those summary definitions.

Before you begin

Ensure that you have configured the JDBC driver in WirelessModelling toolpreferences so that you can connect to the database to extract the summarydefinitions.

Procedure1. In WirelessModelling tool, select File > New > Project.2. Enter the project name. Typically, you use the name of the technology pack.3. Click Next.4. In the Project Explorer, right-click the new project and select Import. The


select Import Summaries.6. Click Next.7. On the Database details page, specify the following connection details:

v Host: Hostname where the database is installed. For example,server.ibm.com

v Username: Username of the system. By default, For example, virtuov Password: Database passwordv Database SID: SID name to connect. By default, vtdb.

8. Click Get Summaries. The database connection is tested.9. Click Next.

10. On the Select Installed Packs page, select one or more technology packs froma list of the installed technology packs on the system. Select UDC from theSelect Installed Packs page if you want to create a Tivoli Netcool Performance

Chapter 6. Creating Tivoli Netcool Performance Manager common pack data models 27

Manager common pack data model with user-defined summaries. Make surethat the provisioned summary definition file has summary type as user. Formore information about the complex summary definition and the associatedentities in the XML file, see Complex summary definition in the AdministeringTivoli Netcool Performance Manager - Wireless Component. Or, select thetechnology pack if you want to use the custom summaries.

11. Click Next. The Select Summaries page opens, showing all of the summariesthat are associated with the selected technology packs.

12. Select the required summaries by vendor, entity, or summary name.13. Select the appropriate check box to filter the selected summaries by raw,

hourly, daily, weekly, or monthly intervals. Select the All summaries checkbox if you want all.

14. Click Next.15. On the Model Details page, specify the following information:

Option Description

Name The model name.Important: You must not use specialcharacters in the model name.

Version The model version.

Vendor The vendor name.

Technology The model technology.Important: You must specify the correcttechnology for the model to be generatedcorrectly.

16. On the Save As page, verify the name for the Common Intermediate Format(CIF) file (.tnpmmodel), select your project folder, and then click Finish.

17. In the Project Explorer, select the CIF file to see the contents.18. Expand the Summary Definition Set to see the summary definitions in the

model.19. Select Window > Show View > View Properties to see the constituent

metrics.20. If you are satisfied with the CIF file contents, update the model properties file

as described in “Creating a model properties file” on page 35.21. Generate a Tivoli Netcool Performance Manager common pack data model as

described in “Generating the Tivoli Netcool Performance Manager commonpack data model contents” on page 36.

22. Publish the Tivoli Netcool Performance Manager common pack data model byusing Framework Manager. For more information, see “Publishing a TivoliNetcool Performance Manager common pack data model” on page 37.


Creating a Tivoli Netcool Performance Manager common pack datamodel containing a busy hour definitions model

On Tivoli Netcool Performance Manager - Wireless component, you can extract thebusy hour definitions associated with a particular technology pack from the TivoliNetcool Performance Manager database. You can then create a Tivoli NetcoolPerformance Manager common pack data model containing a model that reportauthors can use to create reports by using those busy hour definitions.

Before you begin

Ensure that you have configured the JDBC driver in WirelessModelling tool toensure that you can connect to the database to extract the busy hour definitions

Procedure1. In WirelessModelling tool, select File > New > Project.2. Enter the project name. Typically, you use the name of the technology pack.3. Click Next.4. In the Project Explorer, right-click the new project and select Import. The


select Import Busy Hours.6. Click Next.7. On the Database details page, specify the following connection details:

v Host: Hostname where the database is installed. For example,server.ibm.com

v Username: Username of the system. By default, For example, virtuov Password: Database passwordv Database SID: SID name to connect. By default, vtdb.

8. Click Get Busy Hours. The database connection is tested.9. Click Next.

10. On the Select Installed Packs page, select one or more technology packs froma list of the installed technology packs on the system.

11. Click Next. The Select Busy Hours page opens, showing all of the busy hoursthat are associated with the selected technology packs organized by focalentity.

12. Select the required busy hours by vendor, entity, or busy hour name.13. Click Next.14. On the Model Details page, specify the following information:

Option Description

Name The model name.Important: You must not use specialcharacters in the model name.

Version The model version.

Vendor The vendor name.

Technology The model technology.Important: You must specify the correcttechnology for the model to be generatedcorrectly.


15. On the Save As page, verify the name for the Common Intermediate Format(CIF) file, select your project folder, and then click Finish.

16. In the Project Explorer, select the CIF file to see the contents.17. Expand the Busy Hour Definition Set to see the busy hour definitions in the

model.18. Select Window > Show View > View Properties to see the constituent

metrics.19. If you are satisfied with the CIF file contents, update the model properties file

as described in “Creating a model properties file” on page 35.20. Generate the Tivoli Netcool Performance Manager common pack data model

contents as described in “Generating the Tivoli Netcool Performance Managercommon pack data model contents” on page 36.

21. Publish the Tivoli Netcool Performance Manager common pack data model byusing Framework Manager. For more information, see “Publishing a TivoliNetcool Performance Manager common pack data model” on page 37.

Data model filteringBy default, all of the performance metrics and summary and busy hour intervalsfor a particular technology pack are available to be included in a data model forreporting. When creating a Tivoli Netcool Performance Manager common packdata model, it is recommended to filter these metrics to ensure that only metricsthat you need to report on are deployed.

Large data models take longer to generate, merge and deploy and have a largermanagement overhead than smaller data models. It also requires much morememory to manage a larger data model. The maximum recommended size of amanageable data model is 50 MB, this equates to approximately 40000 metrics. Inaddition, the larger the data model, the more difficult it is to find metrics in thedata model.

Filtering the metrics that are included in each data model by metric group canoffer much improved performance, and a targeted set of metrics for particularreporting requirements. If required, you can add additional metric groups byupdating the filter and regenerating the data model for inclusion in a new TivoliNetcool Performance Manager common pack data model.

You can also reduce the model size by filtering out unwanted intervals from yoursummary and busy hour models.

You work from the CIF file that contains the required raw metrics, busy hours, orsummaries from a technology pack or Tivoli Netcool Performance Manager system.Import the CIF file and apply the required filter.


Filtering metrics from a model in an existing CIF fileBefore generating a Tivoli Netcool Performance Manager common pack datamodel, it is recommended that you filter each of your CIF files (.tnpmmodel) toinclude only the metrics that you need to report on.

Before you begin

You must have a filter file containing a list of the metric groups that contain themetrics that you want to include in your reports. The input file format is a simpleflat file in which you specify the metric groups you want in your Cognos model.This filter file is applied to the full CIF file to give a filtered CIF file.

You must have generated the CIF files for each of the raw counters, summaries, orbusy hours that you plan to include in your model.

Procedure1. In WirelessModelling, select File > Import. The Import wizard opens.2. On the Select page of the Import wizard, expand TNPM Pack Modeling and

select Filter an existing Wireless model.3. Select the filter to apply.4. Select the tnpmmodel file that you want to filter. For example,

huawei-gsm-bss-raw.tnpmmodel.5. Click Finish.

Results

A filtered tnpmmodel file is created. For example, huawei-gsm-bss-raw-filtered.tnpmmodel.

The console displays the number of metrics and metric groups in the filtered datamodel.

Identifying metric groups for a filter fileTo create a filter file, you need to identify the metric groups that contain themetrics you want to include.

You can use one of the following methods to map individual metrics to metricgroups.

Identifying metric groups from a CSV file:

Given a list of the required metrics in a CSV file, you can use the CSV file as afilter to identify the associated metric groups.

Before you begin

This task requires a CSV file listing the required metrics, typically provided by thecustomer or user community.

About this task

In Tivoli Netcool Performance Manager - Wireless Component, metric (counter)expressions are typically the loadmap expression.


This procedure assumes a CSV file called LTE_CounterFilter.csv, with the counterIDs in column E as shown.

You load this file into a temporary database table to use as a filter.

Procedure

1. Log in to the wireless database.2. Create a table to store the filtered counters by entering the following command:

create table counter_list (counter_id varchar(50));

3. Copy the CSV file to the wireless server.4. Cut the counter IDs from the CSV file and copy them to another file, for

example counterid.list.cut -d’,’ -f5 LTE_CounterFilter.csv > counterid.list

5. Load the counter list into the counter_list table using the sqlloader. Edit theload.ctl file to create the loader instructionsload data infile ’counterid.list’into table counter_listfields terminated by ","(counter_id)

6. Load the counter list.sqlldr virtuo/Virtuo01@vtdb control=load.ctl

7. Run the following SQL query to get all metric groups for the counters loaded.The query below maps into the wireless dictionary and selects all metric groupsthat include the counter IDs that were loaded.select metric_group from (select e.entity_name || ’.’ || substr(f2.field_name,INSTR(f2.field_name,’.’,1,1)+1,(INSTR(f2.field_name,’.’,-1,1)) - INSTR(f2.field_name,’.’,1,1)-1)METRIC_GROUPfromwmd_dict_table d, wmd_dict_field f, wmd_dict_field f2, wmd_col_def c, lc_loadmap lm,lc_ruleset lr, lc_datasource ld, wmd_dict_field_depend dep,wmn_entity ewhere f.table_id = d.table_idand f2.entity_id = e.entity_idand dep.child_field_id = f.field_idand dep.parent_field_id = f2.field_idand f.field_id = c.field_idand upper(lm.colname) = c.col_nameand upper(lm.tabname) = d.table_nameand lm.ruleset_id = lr.ruleset_idand ld.datasource_id = lr.datasource_idAND lm.expression in (select ’C’ || counter_id from counter_list)) Metric_Filtergroup by metric_grouporder by 1


Results

The query returns the list of metric groups, which you can use as a filter file inWirelessModelling. For example,CPU_Device.CPU_Of_BoardENodeBFunction.BBUENodeBFunction.ENodeBEUtranCell.CQIEUtranCell.Cell_AlgorithmEUtranCell.DRB......PMU_Device.PMURRU_Device.RRU

Identifying resource groups from the model documentation:

WirelessModelling supports the generation of a HTML document representing thecontents of the tech pack. A user can take the unfiltered model and generate theHTML document. In any HTML browser, using this html representation of the datamodel contents the user can search for the counter ID.

Before you begin

You must have a list of the counter IDs or descriptions.

Procedure

1. In WirelessModelling tool, select File > Export. The Export wizard opens.2. On the Select page of the Export wizard, expand TNPM Pack Modeling and

select Export HTML Documentation.3. Click Next.4. Open the HTML document in a browser.5. Search for each counter ID for description to identify the metric group.

Identify metric groups by using a SQL query:

You can use a query on the wireless database to identify the mapping between thecounter ID and the metric group.

Before you begin

You must have a list of the counter IDs.

Procedure

1. Log in to the wireless database.2. Enter the following command:

select e.entity_name || ’.’ || substr(f2.field_name,INSTR(f2.field_name,’.’,1,1)+1,(INSTR(f2.field_name,’.’,-1,1)) - INSTR(f2.field_name,’.’,1,1)-1)METRIC_GROUPfromwmd_dict_table d, wmd_dict_field f, wmd_dict_field f2, wmd_col_def c, lc_loadmap lm,lc_ruleset lr, lc_datasource ld, wmd_dict_field_depend dep,wmn_entity ewhere f.table_id = d.table_idand f2.entity_id = e.entity_idand dep.child_field_id = f.field_idand dep.parent_field_id = f2.field_idand f.field_id = c.field_idand upper(lm.colname) = c.col_nameand upper(lm.tabname) = d.table_name


and lm.ruleset_id = lr.ruleset_idand ld.datasource_id = lr.datasource_idAND lm.expression in (’C1278071421’, ’C1278072439’, ’C1278072520’)

Results

A list of metric groups is returned, for example:METRIC_GROUP------------------------------------Cell.Call_drop_overviewCell.Short_messageCell.Call_drop_due_to_conn_fail

Filtering intervals from existing CIF filesAfter using a particular model, you can decide that there are summary or busyhour intervals that you do not need. You can import the CIF files and filter outthese unwanted intervals at any time.

Filtering an existing summary modelYou can filter a summary model by removing raw, hourly, daily, weekly ormonthly summary intervals from the appropriate CIF file.

About this task

You must have a summary CIF file before you begin.

Procedure1. In the Project Explorer, right-click the new project and select Import. The


select Filter an existing Summary Wireless model.3. Click Next.4. Select the summary intervals that you want to keep in the model.5. Click Next.6. Select the summary CIF file that you want to filter.7. Click Finish. A new CIF file is created containing only the summary intervals

that you specified.

Filtering an existing busy hour modelYou can filter a busy hour model by removing daily, weekly or monthly busy hourintervals from the appropriate CIF file.

About this task

You must have a busy hour CIF file before you begin.

Procedure1. In the Project Explorer, right-click the new project and select Import. The


select Filter an existing Busy Hour Wireless model.3. Click Next.4. Select the busy hour intervals that you want to keep in the model.5. Click Next.


6. Select the busy hour CIF file that you want to filter.7. Click Finish. A new CIF file is created containing only the busy hour intervals

that you specified.

Creating a model properties fileYou can create a model properties file from the sample file provided or create yourown file. Name the new model properties file according to your model and updatethe values in the file as appropriate.

Before you begin

The sample file is available in the following location:C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>\createmodel\sample.properties

Working from a model properties file sample is recommended but if a sample fileis not available, create a file containing the following properties and save it withan appropriate filename.

Note: If you are using a text editor that has word wrap functionality, ensure that itis turned off.

Procedure1. Edit a new file or an existing model properties file. Save the file with the

filename model_name_model.properties.where model_name is the name of the model that the model properties filedescribes.

2. Update the file with the properties shown in this table. Do not put a spacebetween the property and the value, for example PACK_VERSION=1.0.0.

Property Description Example

PACK_SYMBOLIC_NAME The customer facing name for theTivoli Netcool Performance Managercommon pack data model, it must beunique for each model.

ibm.tnpm.net.mobile.lte.hua.eutranNote: Ensure that the pack name isin this format only. Use only dotseparator.

PACK_VERSION The model version 1.0.0

OUTPUT_DIR The directory where the project iscreated in your local machine

C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>\output

DB_HOST Host name of the system where thedatabase is installed

server.my.ibm.comNote: The other parameters relatedto database preferences like DB_PORT,DB_DATABASE_NAME, DB_USER,DB_PASSWORD, you can use the defaultvalues that are given in the sampleproperties file.

DB_PORT Database port number The default port number is 1521.

DB_DATABASE_NAME Database name The database name is vtdb

NASACCESS_USER This is the main user schema The user schema to be configured isnasaccess

NASACCESS_PASSWORD Password for nasaccess user The default password is nasaccess.


Property Description Example

COGNOS_DIR Location of the Cognos directory.This directory contains theBmtScriptPlayer.exe file.

C:\cognos\c10

MEASURE_DIMENSION This a flag to create MeasureDimension for drill down to targetentity level. If you assign the valuesN the model that is created does nothave the Measure Dimension sectionin it there by reducing the size of themodel.

3. Save the new model properties file.

Generating the Tivoli Netcool Performance Manager common packdata model contents

Generate the Tivoli Netcool Performance Manager common pack data modelcontents by running the createmodel.bat command on a model properties file, aCommon Intermediate Format (CIF) file (.tnpmmodel).

Before you begin

To generate a model, you need a model properties file, a Common IntermediateFormat (CIF) file.

About this task

If the path to the CIF file (.tnpmmodel), or the model properties file, containsspecial characters such as spaces, you must enclose the path in quotation marks.

This task assumes the following file locations:v The CreateModel tool is installed in the C:\npm_app_studio\

WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>directory.

v A CIF file and a model properties file are stored in the C:\temp\Models directory.

For more information about the createmodel command, see “The createmodelcommand” on page 77.

Procedure1. From the command line, go to the bin directory by entering the following

command:cd C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>\createmodel\bin

2. Enter the following command on a single line:.\createmodel.bat -generate -model C:\temp\Models\cif_file -propertiesC:\temp\Models\model_name_model.properties {-overwrite}

Where:

cif_file Name of the CIF file (.tnpmmodel).


Note: If you want to create a merged model with raw, summary andbusy hour models that you have a created from a technology pack, youcan specify the folder name where the models are available instead ofthe cif_file name.

model_nameName of the model that the model properties file describes.

If the paths contain special characters, such as spaces, you must enclosethe path in quotation marks.

3. The Tivoli Netcool Performance Manager common pack data model contentsare generated and placed in OUTPUT_DIR\PACK_SYMBOLIC_NAME_PACK_VERSION

Where:

OUTPUT_DIRMaps to the OUTPUT_DIR property in the model.properties file.

PACK_SYMBOLIC_NAMEMaps to the PACK_SYMBOLIC_NAME property in themodel_name_model.properties file.

PACK_VERSIONMaps to the PACK_VERSION property in themodel_name_model.properties file.

Publishing a Tivoli Netcool Performance Manager common pack datamodel

In IBM® Cognos® Framework Manager, you can publish a package to any folder onTivoli Common Reporting server.

Before you begin

Ensure that you open the project in Framework Manager. For more information,see “Opening a project in Framework Manager” on page 38.

Procedure1. Select the package that you want to publish.2. From the Actions menu, click Package > Publish Packages.3. Specify the server to publish the package. The server where Tivoli Common

Reporting is installed.4. Optional: If you are prompted with the Log On page, enter the user name and

password for the server.5. To enable model versioning when you publish to the Tivoli Common

Reporting server, select the Enable model versioning check box and type thenumber of model versions of the package to retain. It sets the number ofmodel versions to retain on the server. The default value is zero for unlimitedversions.

6. Optional: To delete all but the most recently published version on the server,select the Delete all previous model versions check box.

7. Click Next.8. By default, the package is verified before it is published. If you do not want to

verify your model prior to publishing, clear the Verify the package beforepublishing check box. To avoid problems, troubleshoot the package before


publishing it by using the Verify the Package Before Publishing check box inthe Publish wizard to ensure that it is complete and does not contain errors.

9. Click Publish.10. Click Finish.

Note: If you have turned off the flag MEASURE_DIMENSION property in themodel properties file, you might see the following message:BMT-MD-6007 The package contains only regular dimensions but no measure dimension.

Results

After the package is published to the server, it is available to report users.

Opening a project in Framework ManagerYou must open a project before you can import metadata or change the existingmetadata.

Before you begin

Ensure that you generated the Tivoli Netcool Performance Manager common packdata model contents from the file tnpmmodel file. For more information, see“Generating the Tivoli Netcool Performance Manager common pack data modelcontents” on page 36.

Procedure1. In Framework Manager, click Open from the File menu.2. Browse to locate the project folder and click the .cpf file.3. Click Open.


Chapter 7. Getting started with Common reporting

This information explains how users of Tivoli Netcool Performance Managerwireless component can get started with Tivoli Common Reporting for TivoliNetcool Performance Manager. You are guided through the basic reporting tasks,with particular emphasis on techniques that are unique to PerformanceManagement.

Tivoli Common Reporting is based on IBM Cognos Business Intelligence, anenterprise reporting solution. It delivers a subset of IBM Cognos BusinessIntelligence function as a common reporting platform or across the Tivoli portfolio.By using Tivoli Netcool Performance Manager - Application Studio you can extendthe domain-specific reporting capabilities of technology packs to CommonReporting by deploying Tivoli Netcool Performance Manager common pack datamodel on your system.

For best practices in creating reports by using Tivoli Netcool Performance Manager- Application Studio, see https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Application%20Studio%201.4%20(Wireless%20Modelling)%20-%20Common%20Reporting.


https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Application%20Studio%201.4%20(Wireless%20Modelling)%20-%20Common%20Reporting





Chapter 8. Resource Metric Viewer

You can dynamically create reports by using the Resource Metric Viewer.

You can quickly create time series performance reports by using the ResourceMetric Viewer.

You can select an available model from the Resource Metric Viewer and from thismodel, you can select:

ResourcesThe set of resources to be included within the report.

MetricsThe set of metrics to be included in the report.

Time IntervalThe time interval the report is to cover.

GranularityThe time granularity of the data that is being displayed.

Alternatively, you can create a report based on an event from the Active Event Liston the Resource Metric Viewer. The Resource Metric Viewer constructs the reportcharting the performance of the entity that is causing the event.

Note: Resource Metric Viewer is available for Tivoli Netcool Performance ManagerWireless component only.

Models that work with the Resource Metric Viewer

Raw and combined models work with the Resource Metric Viewer.

The Resource Metric Viewer can process both simple and composite models.

Note: Busy Hour and Summary models have limited support with ResourceMetric Viewer. Only default Busy Hour and Summary models are supported.

User roles

Resource Metric Viewer access is restricted to the following roles:v administrator

v biServiceUser

v chartAdministrator

v chartCreator

v chartViewer


Resource Metric Viewer setupThis section covers the basic tasks required to set up the Resource Metric Viewer.

For information about installing the Resource Metric Viewer, see “InstallingResource Metric Viewer” on page 19.

Enabling the Resource Metric Viewer with existing TivoliNetcool Performance Manager common pack data models

Using the Resource Metric Viewer with legacy Tivoli Netcool PerformanceManager common pack data models.

Before you begin

Resource Metric Viewer can be enabled only on Cognos models that have beendeployed.

About this task

This procedure uses the rmv_admin.sh command, which can be found in<JazzSM_Home>/rmv/admin

Where <JazzSM_Home> is the location where the Jazz for Service Managementcomponents are installed. By default, the JazzSM_Home for the wireless componentis: /opt/IBM/JazzSM.

To create or update a Resource Metric Viewer report for a model, follow thesesteps:

Procedurev To enable Resource Metric Viewer reports for a specified pack or for all available

models, run the following command:rmv_admin.sh -rmv -create [ -pack pack_filename | -all ] -logins password_file

For example:./rmv_admin.sh -rmv -create -pack <pack_filename> -logins logins.txt

You can run the rmv_admin.sh -rmv command for all models by using the -allflag.

v To update Resource Metric Viewer reports based on a change to the model, runthe following command:rmv_admin.sh -rmv -update_metrics [ -pack pack_filename | -all ] -logins password_file

For example:./rmv_admin.sh -rmv -update_metrics -pack <pack_filename> -logins logins.txt

You can run the rmv_admin.sh -rmv command for all packs by using the -allflag.

Note: For more information about the rmv_admin.sh -rmv command, see“rmv_admin command” on page 77.


Active Event ListA context menu script is required to launch from the Active Event List into theResource Metric Viewer User Interface.

This script must be added to the WebGUI to support launching into the ResourceMetric Viewer User Interface.

Note: If you have a model with both RNC and BSC, and there are RNC or BSCalarms defined. When the alarms are forwarded to OMNIbus, the alarms might notdisplay correctly in the Resource Metric viewer. It is recommended that you labelsuch alarms. For information about labeling these alarms, see “Label alarms thatmight not be handled properly by the Resource Metric Viewer” on page 74.

AelLaunchScript file contentsA 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);}

Chapter 8. Resource Metric Viewer 43

Using the Resource Metric ViewerThe Resource Metric Viewer allows you to create dynamic reports.

About this task

You can create dynamic reports by using the Resource Metric Viewer:v By selecting a subset of resources and metrics available within a model.v By selecting an event from the Active Event List, which creates a report that is

based on the performance of the relevant entity.

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.


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

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

Constructing a report by selecting a subset of resources andmetrics

By using the Resource Metric Viewer, you can create dynamic reports by distillingthe resource and metric set available for a specific model.

Procedure1. Log in to Dashboard Application Services Hub as the Resource Metric Viewer

user.2. Click Performance > Resource Metric Viewer Selection to open the Resource

Metric Viewer tab in the Dashboard Application Services Hub.


3. You can select a model by using one of the following methods:a. Select a model from the Models list.b. Click an entry from the Saved Selections list to auto populate the

information into the fields.c. Double-click an entry from the Saved Selections list to auto populate the

fields and open the report in new window.4. Use the Filter field to help you locate a specific model. Type the name of the

model, the model name is automatically populated.5. Click the Direct Parents Only check box if you would like the following

Parent Entity and GrandParent Entity list auto-populated with the directparents of the selected entity. If you select the Direct Parents Only check box,skip to step 8.

Note: If the situation occurs that there are multiple direct parents, you mustchoose from the available parent entities by following steps 5 - 7.

6. Select a focal entity from the Focal Entity list. This entity is the main entityfrom which you want to view metrics.

7. Optional: Select Parent Entity and Grand Parent Entity from the list.

Note: The inclusion of a Parent Entity or Grand Parent Entity selection is toallow filtering on the main entity that you are reporting against.For example, if you want to report on all cells for a particular geographicalarea, then you can select that region that can filter out all Cells that are notpart of that region.

8. Optional: Select the Save Selections check box to save this selection to SavedSelections list.Place the cursor in the Saved Selections list and press Enter for the selectionto be added to the list in the cursor location.

9. Click Open in New Window to display the results of your selection. TheOpen in New Window option is present so that your results are displayed in


a new window, and, therefore, able to use all space available in a browserwindow. The Resource Metric View Prompt Page is displayed, you canfurther distill the set of metrics to be included in your report by selectingindividual resources and metrics.

Note: The Resource Metric Viewer Selection settings from the previous sessionare saved and displayed when you log in again.

10. In the Entity Selection section of the Resource Metric View Prompt Page,choose from the set of resources made available through your GrandParentEntity, Parent Entity, and Focal Entity selection in the initial Resource MetricViewer Selection page.The Entity Selection section displays two Choice fields followed by a Resultsfield. The possible contents of each successive field is updated by the selectionin the previous fields.To correctly distill the list of resources you require, follow these steps:a. Select the vendor from the Vendor field.b. Select the technology of the model from the Technology field.c. For each entity, use the Keywords field to filter the set of results.

Use the '%' symbol, which acts as a wildcard, plus any character string toconstruct the filter.Click Search to implement the filter.If you want to find the children for parent entities, you can select theparent entities on the left, and then click Search on the child entity on theright.

d. Select those resources that are relevant within the Choice field.If you want the KL children that are displayed in the Choice field on theright, select it with mouse and click the Search button under Region.

e. Select the resources that you require from the Results field and use theInsert and Remove buttons to set the final selection of resources.


11. In the Metric Selection section of the Resource Metric View Prompt Page,choose from the set of metrics available.a. Filter the set of metrics by using the Keywords field.

Use the '%' symbol, which acts as a wildcard, plus any character string toconstruct the filter.Click Search to implement the filter.

b. Select the metrics that you require from the Results field and use theInsert and Remove buttons to set the final selection of metrics.

12. Set the granularity of the time series by using the Time Granularity list.13. Set the time frame of the report by using the Date Range list, or select a

custom date range by using the Start Time and End Time calendar fields.

14. Set the display format of the output by using the Options section.By using the Options section, you can choose between a Linear andLogarithmic chart. Click Logarithmic if you are plotting metric sets thatcontain massively disparate values; for example, one metric set might covervalues 0 - 1, and another set might cover values 0 - 1000.By using the Options section, you can choose between Chart by entity (oneentity per chart) and Chart by metric (one metric per chart).By using the Options section, you can enable or disable the display of datapoints on the chart. Click Show data point on chart to show the data pointson the chart. By default, No data point on chart is selected to disable thedisplay of data points on the chart.


15. Click Finish. You can view the report that is based on your selections.

Results

You can see the Resource Metric View report that appears as follows:

What to do next

If you want to revert to the prompt page to edit your selection, click the Run (

) button on the upper right of the page. The prompt page retains thepreviously selected entities.

Configuring launch-in-context Active Event List on ResourceMetric Viewer

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 “AelLaunchScript file contents” onpage 43. 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 442. 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 “AelLaunchScript filecontents” on page 43.

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.

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:


Resource Metric Viewer administrationThis section covers the administration tasks you may perform post setup of theResource Metric Viewer.

Modify the Resource Metric Viewer templateThe Resource Metric Viewer uses an XML Cognos report template. You can modifythis report if you wish in report studio to change the prompts, Images, andoperation of the Resource Metric Viewer.

About this task

The resource metric viewer template is located in <JazzSM_Home>/rmv/templates

Where <JazzSM_Home> is the location where the Jazz for Service Managementcomponents are installed. By default, for the wireless component this is:/opt/IBM/JazzSM.

The default Resource Metric Viewer report is designed so that no more than 9resources or metrics will be shown in the chart legend.

To update the model and refresh all Resource Metric Viewer reports, do either ofthe following, that is, use either the XML process or the Report Studio process:

Procedurev Using XML:

1. Go to <JazzSM_Home>/rmv/templates.2. Open and update the existing template.3. Make sure to update the model path by editing the following XML:

<modelPath>/content/package[@name=’gsm.sbh.3’]/model[@name=’2012-03-06T16:19:19.587Z’]</modelPath>

so that the modified report has the following XML:<modelPath>/content/package[@name=’[BIPACKNAME]’]</modelPath>

4. The name of the Resource Metric Viewer template must bermv_template.xml.

5. To update Resource Metric Viewer reports, run the following command:rmv_admin.sh -rmv -update_reports [ -pack pack_filename | -all ] -logins password_file

For example:./rmv_admin.sh -rmv -update_reports -pack <pack_filename> -logins logins.txt


v Using Report Studio:After Resource Metric Viewer has been enabled for at least one pack, thetemplate will be available in common reporting in a folder named rmv.1. Open Resource Metric Viewer template in report studio and save under a

new name.2. Update the report.3. Using Tools > Show Specifications copy XML into new file.4. Modify <modelPath> file to the following:

<modelPath>/content/package[@name='[BIPACKNAME]']</modelPath>


5. Replace report in <JazzSM_Home>/rmv/templates with updated reporttemplate.

6. To update Resource Metric Viewer reports, run the following command:rmv_admin.sh -rmv -update_reports [ -pack pack_filename | -all ] -logins password_file

For example:./rmv_admin.sh -rmv -update_reports -pack <pack_filename> -logins logins.txt


Note: For more information on the rmv_admin.sh -rmv command, see“rmv_admin command” on page 77.



Chapter 9. Data availability reporting

Data availability or data coverage describes the completeness of data for a report.

Summaries are executed every day that are based on data availability. Thesummary will run if there is data that is loaded for a period, regardless of theamount of data. No percentage threshold of data availability is used. If there is nodata present for the period that is being summarized, then the summary is notinitiated. However, summaries can be run to ignore data availability calculations,by executing the summaries on the command line.

You might want to see overall data loading performance at a high level for a fewkey blocks or data sources. And where there is missing data at a high level, theyou must be able to drill down into the lower-level resource instances.

The Tivoli Netcool Performance Manager wireless system includes the dataavailability feature to facilitate that the system is actually loading data.

The Tivoli Netcool Performance Manager wireless system can load and store thisdata. However, IBM recommends that monitoring of data availability isconcentrated on key resource types and metric groups, which are being used forreporting. Typically, when there is missing data, it is for a whole block or objectthat is set so this is reflected without monitoring many tables.

After the summaries for a particular technology pack are identified, you mustcreate a data availability Cognos model that contains these summaries and installthe Cognos model on Jazz for Service Management.

Overview of generating data availability reportsYou can follow these steps to create, publish, and view the data availability or datacoverage reports.

Before you beginv Ensure that you have a fully operational Tivoli Netcool Performance Manager

Wireless system and Tivoli Netcool Performance Manager - Application Studiocomponents installed.

v Run the following commands to grant permission to the nasaccess user:sqlplus virtuo/<password>@vtdbgrant execute on calc_table_hourly_da to nasaccess;grant select on da_hourly_tmp to nasaccess;

Procedure1. “Monitoring the key traffic tables for data availability” on page 56

a. “Selecting tables for data availability for a vendor neutral technology pack”on page 58

b. “Selecting tables for data availability for a vendor specific technology pack”on page 58

2. “Generating data availability components” on page 603. “Provisioning the UDCs and summaries to Tivoli Netcool Performance

Manager Wireless system” on page 63


4. “Extracting and publishing daily summary model” on page 645. “Scheduling and running summaries” on page 666. “Generating data availability reports” on page 687. “Publishing the generated data availability reports” on page 698. “Verifying the data availability report contents” on page 69

Monitoring the key traffic tables for data availabilityIBM recommends these guidelines for monitoring the key traffic tables for differenttechnology packs for generating the data availability reports.

To select the appropriate tables to monitor for data availability, follow theseguidelines:v Load the complete data.v Locate the tables that have data that is loaded by using the SQL statements that

are stated in “Selecting tables for data availability for a vendor neutraltechnology pack” on page 58 and “Selecting tables for data availability for avendor specific technology pack” on page 58.

v From the list of tables in the result set, select the tables that are common fromentities by referencing the raw input files from network elements. Check theProduct Requirements Specification and Functional Specification for a technologypack for blocks in raw files that are mapping to the abbreviated KPI groupname.

v KPI group abbreviated names are the base for the table name without thevendor prefix.

Some example tables from selected technology packs:

Table 2. GSM/GPRS Huawei BSS Technology Pack

NetworkObject Key KPI Groups Loader Block Raw Traffic Table

BSCBSC.Huawei.GSM.Access_traffic_volume

B1275072018 hua_bsc72018vol_tab

BSC BSC.Huawei.GSM.Ps_capability B1275073217 hua_bsc73217_tab

M3UAM3UA_Link.Huawei.GSM.M3UA_link_utilisation

B1275072118 hua_m3ualink72118_tab

SCTP_LinkSCTP_Link.Huawei.GSM.Link_utilisation

B67109468 hua_sctplink09468_tab

SCTP_LinkSCTP_Link.Huawei.GSM.SCTP_IP_usage


SCTP_LinkSCTP_Link.Huawei.GSM.Utilisation


Table 3. Nokia BSS Technology Pack

Network Object Key KPI Groups Loader Block Raw Traffic Table

BSCBSC. Nokia.GSM.Quality_of_Service P_NBSC_QOS nok_bsc_qty_of_service_tab


Table 3. Nokia BSS Technology Pack (continued)


Cell

Cell.Nokia.GSM.Traffic P_NBSC_TRAFFIC nok_cell_traffic_tab

Cell.Nokia.GSM.Resource_Availability P_NBSC_RES_AVAIL nok_cell_res_avail_tab

Cell.Nokia.GSM.Packet_Control_Unit

P_NBSC_PACKET_CONTROL_UNIT nok_cell_pkt_ctl_unit_tab

Cell.Nokia.GSM.Handovers P_NBSC_HO nok_cell_handovers_tab

DLCIDLCI.Nokia.GSM.Frame_Relay

P_NBSC_FRAME_RELAY nok_dlci_frame_relay_tab

PCUPCU.Nokia.GSM.PCU_Utilization

P_NBSC_PCU_UTILIZATION nok_pcu_util_tab

Table 4. Motorola BSS Technology Pack


BSC PerformanceIndicators

BSC.Motorola.GSM.Cell_based_Busy_Hours bsc_all mot_bsc_cell_based_bhs_tab

BSC.Motorola.GSM.SCCP_Performance_and_utolization bsc_statistics mot_bsc_sccp_prf_n_util_tab

Cell performanceindicators

Cell.Motorola.GSM.AMR_TCH AMR_TCH mot_cell_amr_tch_tab

Ethernet_link_moperformance indicators

Ethernet_link_mo.Motorola.GSM.Ethernet_link_statistics eth_statistics mot_eth_link_stats_tab

Gb performanceindicators

Gb.Motorola.GSM.GPRS_Utilization gbl_statistics mot_gblink_gprs_utils_tab

LAPD performanceindicators

LAPD.Motorola.GSM.BSS_data_transmission sdl_statistics mot_LAPD_bss_dat_transm_tab

PCU performanceindicators

PCU.Motorola.GSM.PCU_overview pcu_statistics mot_pcu_pcu_ov_tab

Processor performanceindicators

Processor.Motorola.GSM.GPRS_Utilization pproc_statistics mot_proc_gprs_utilizat_tab

Signalling_Linkperformance indicators

Signalling_Link.Motorola.GSM.MTP_C7_utilization mti_statistics mot_siglnk_mtp_c7_util_tab

C25 performanceindicators

X25.Motorola.GSM.BSS_data_transmission cbl_statistics mot_X25_bss_data_transm_tab

Note: For KPI group Signalling_Link.Motorola.GSM.MTP_C7_utilization, thesummary is defined at Signalling_point level, instead of Signalling_Link object. Asthe Signalling_point level is connected, there can be too much detail atSignalling_Link level for data availability.

Table 5. GPRS_Huawei_CN_SGSN Technology Pack

Network Object Key KPI Group Loader Block Raw Traffic Table

SGSN SGSN.Huawei.GPRS.SGSN_LLC M117440515 hua_sgsn_lls_tab

Routing_AreaRouting_Area.Huawei.GPRS.Iu_Mode_Attach_with_RAI M117440583 hua_iu_mode_attach_rai_tab

M3UA_LinkSetM3UA_LinkSet.Huawei.GPRS.M3UA_link_set M117440657 hua_m3ua_link_set_tab

Chapter 9. Data availability reporting 57

Selecting tables for data availability for a vendor neutraltechnology pack

Select a set of key tables that you are using to report on statistics. This meansmapping the KPI groups. For example, Cell.Neutral.TCH, Cell.Neutral.SDCCHback to the traffic tables where their data is stored. Additionally, in a cross vendorenvironment, vendor neutral tables can provide a view of loading data availabilityby vendor. For optimal result, it is essential to select a vendor neutral traffic tablethat is populated by all the available vendor loadmaps.

About this task

Use the following SQL query sample to select all the vendor neutral cell tables thatyou are loading. This query lists all vendor neutral cell tables that are loaded byboth Nokia GSM BSS loadmap and Motorola GSM BSS loadmaps.

Exampleselect unique(t.table_name)from da_loaded_tables da, wmd_dict_table twhere t.table_name like `VNL_%ànd t.entity_id = (select entity_id from wmn_entity where entity_name = `Cell`)and da.start_date = to_date(`2011-11-07 00:00:00`, `YYYY-MM-DD HH24:MI:SS`)and t.table_name in (select upper(lc.tabname)fromlc_loadmap lc, lc_ruleset r, lc_datasource dwherelc.ruleset_id = r.ruleset_idand d.datasource_id = r.datasource_idand d.datasource_name = `Nokia BSSànd r.type = `Neutralùnionselect upper(lc.tabname)fromlc_loadmap lc, lc_ruleset r, lc_datasource dwherelc.ruleset_id = r.ruleset_idand d.datasource_id = r.datasource_idand d.datasource_name = `Motorola BSSànd r.type = `Neutral`)order by 1;

Note: Union is used to include all the vendor specific technology packs that areloaded to the common vendor neutral tables.

What to do next

Save this list of tables to a properties file. For example,nokia_gsm_bss_tables.properties file.

Selecting tables for data availability for a vendor specifictechnology pack

In this example, reporting is done by using a vendor neutral loadmap such asGSM Huawei BSS VNLM that is merged with GSM Huawei BSS vendor specifictechnology pack.

About this task

When a vendor neutral technology pack is used, raw counters may be mapped totwo storage locations:


v The vendor neutral table. Typically, these tables are named as VNL_.v A vendor specific table that is named after the vendor. For example, HUA_.

Only a subset of the metrics from the vendor specific data source is loaded into thevendor specific tables. Apply the following logic to find the vendor specific tablesthat are loaded with data and with vendor neutral loadmaps merged together withvendor specific loadmap:v For the data source, find the blocks that are loaded to the vendor neutral tables.v Identify the vendor specific tables that are also loaded from the same block. This

is to limit the number of tables to monitor.v Filter this list to include tables that are actively loaded. For example, the Tivoli

Netcool Performance Manager system may have mappings for certain blocks butthese blocks are not activated on the Operation And Maintenance Center (OMC).In the query below, this information is filtered for a particular day that is 10thOctober, where the data loaded is good.

This query lists all vendor specific tables that have data loaded for a specific timeinterval and whose associated blocks are loaded into some corresponding vendorneutral tables. This example is based on Huawei GSM BSS Technology Pack.

Exampleselect unique(l.tabname)from lc_loadmap l, lc_ruleset r, lc_datasource d,wmd_dict_table t, da_loaded_tables dawheret.table_id = da.table_idAND upper(t.table_name) = upper(l.tabname)AND trunc(da.start_date) = to_date(`2011-10-10 00:00:00`, `YYYY-MM-DD HH24:MI:SS`)AND l.ruleset_id = r.ruleset_idand d.datasource_id = r.datasource_idand d.datasource_name = `Huawei GSM BSSànd r.type = `Vendorànd l.tabname not like `nc%ànd l.blockname in (select l.blocknamefrom lc_loadmap l, lc_ruleset r, lc_datasource dwhere l.ruleset_id = r.ruleset_idand d.datasource_id = r.datasource_idand d.datasource_name = `Huawei GSM BSSànd r.type = `Neutralànd l.tabname not like `nc%`group by l.blockname)group by l.tabname;

This SQL query returns a list of tables that drive the data availability definitionand summary definition generation.

Note: If the vendor neutral loadmap is not merged with a vendor specifictechnology pack, use the following SQL query to extract the vendor specific tablesalone:


select unique(l.tabname)from lc_loadmap l, lc_ruleset r, lc_datasource d,wmd_dict_table t, da_loaded_tables dawheret.table_id = da.table_idAND upper(t.table_name) = upper(l.tabname)AND trunc(da.start_date) = to_date(’2011-10-10 00:00:00’, ’YYYY-MM-DD HH24:MI:SS’)AND l.ruleset_id = r.ruleset_idand d.datasource_id = r.datasource_idand d.datasource_name = ’Huawei GSM BSS’and r.type = ’Vendor’and l.tabname not like ’nc%’

What to do next

Save this list of tables to a properties file. For example,huawei_gsm_bss_tables.properties file.

Generating data availability componentsUsing the properties file that has a list of tables, you can now generate the dataavailability formulas and the summaries in data availability model.

Before you begin

Ensure that the following prerequisites are complete:v Ensure that you have configured the JDBC driver in WirelessModelling tool

preferences so that you can connect to the database to extract the summarydefinitions.

v Ensure that you have the properties file that contains the list of tables asdescribed in “Selecting tables for data availability for a vendor specifictechnology pack” on page 58.

v Ensure that you have created the Tivoli Netcool Performance Manager commonpack data model that contains a raw model as described in “Creating a TivoliNetcool Performance Manager common pack data model containing a raw datamodel” on page 26.

Procedure1. In WirelessModelling tool, open the tnpmmodel file that you have created from

the raw model.2. Right-click TNPM Package and select Data Coverage Utilities > Generate Data

Coverage components.3. Click Browse in the Filter file field to locate the properties file you have

created earlier. This file is the output file that contains the list of table names.4. Select Table in the Metric names based on list.5. Select the number of tables from Number of tables for each summary

definition between 10 to 25.

Note: If the number selected is not between 10 to 25, the generatedda_summary.xml and da_udcs.xml files will be empty.

6. Click Next.7. Select File System and locate the output directory where you want to generate

the user defined calculations (UDCs) and summary XML files.


8. Click Finish. If the console is open, you can see the execution. To see theconsole view, select Window > Show view > other > General > Console.If you receive an error message that is related to summary name that exceeds24 characters, see the workaround in“Manually edit the summary name in adata availability model if the summary name exceeds 24 characters” on page72.

Results

You can find the da_summary.xml and da_udcs.xml files in the output directory.

da_udcs.xmlThis file contains the generated data availability UDCs.

da_summary.xmlThis file contains the summaries that include these UDCs at theappropriate resource type level.

These UDCs and summaries must be provisioned to the Tivoli NetcoolPerformance Manager Wireless system.

Data availability formulasThe formulas for data availability are in da_udcs.xml file.

For each resource type, the following user formulas are generated:

Resource type data availability formulaThis formula gives an overview of the data availability across all the tablesthat are being monitored. For example, if 10 tables have been selected atCell level then these 10 tables are included in a single formula calledDA_Neutral_GSM_Cell. This formula provides the overview of the dataavailability at Cell level.

Per table or metric group data availability formulaFor each table that is monitored, a single table (either named based on thetable name or the metric group name) is created. For example, a metriccalled VNL_CELL_TCH_TAB is created. This is data availability for this table.

Count metricMost data availability reports are built at a higher aggregation level that isviewing the data availability across all Cells. A count metric calledDA_Neutral_GSM_Cell_count is included. This metric allows a count of Cells(or any other resource type) to be included in a summary report.

Resource type data availability formulas

To see a summarized view of data availability across a number of tables, a formulathat combines the availability across a number of tables is required. For example,for ATM_VCC, there are 7 tables that are being monitored. This results in a UDCcalled DA_Nokia_ATM_VCC that monitors all ATM_VCC tables.


<udc-data><uuid>DAD1F5ADEE</uuid><header1>DA_Nokia_ATM_VCC</header1><aggregator>A</aggregator><complex>false</complex><entity-name>ATM_VCC</entity-name><data-type>F</data-type><field-name>DA_Nokia_UMTS_ATM_VCC</field-name><expression>(DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.cac_resource.measurement_seconds}])

+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.aal2_packet_queue.measurement_seconds}])+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.resource_reservation.measurement_seconds}])+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.aal2_signalling.measurement_seconds}])+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.saal.measurement_seconds}])+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.vcc_measurement.measurement_seconds}])+ DataAvailKPI("raw", "percentile", [ATM_VCC]![{Nokia.RAN_Usage.Transport_Network.measurement_seconds}]))/7</expression></udc-data>

In Tivoli Common Reporting, this is shown across a number of tables the dataavailability or data loading at Cell level. One of these formulas is included foreach resource type that is being monitored.

Traffic table data availability formulas

Apart from the cross table formula above, individual per table level formulas arealso generated.

<udc-data><uuid>DAE2B31D7B</uuid><header1>DA_NOK_NK_IPROUTE_TAB</header1><aggregator>A</aggregator><complex>false</complex><field-desc>Data availability for metric group ip_route_measurements table NOK_NK_IPROUTE_TAB</field-desc><expression>DataAvailKPI("raw", "percentile", [IP_Route_BTS]![{Nokia.ip_route_measurements.measurement_seconds}])</expression><entity-name>IP_Route_BTS</entity-name><data-type>F</data-type><field-name>NOK_NK_IPROUTE_TAB</field-name>

</udc-data>

Data availability summariesA set of summaries is generated in da_summary.xml file.

A summary is created at specific entity level. This optimization ensures that onlythe required summary for optimal calculation is created.

This summary has the daily intervals configured. In Tivoli Common Reporting, theuser can see the data availability at daily and hourly level.


<summary><name>DA_NOKIA_GSM_TRU_EQUIPMENT</name><source><entity>TRU_Equipment</entity><field-list><field><source-field><entity>TRU_Equipment</entity><field-name>NOK_TRU_EQUIP_TRU_BIE_TAB</field-name></source-field><dest-field></dest-field></field><field><source-field><entity>TRU_Equipment</entity><field-name>DA_Nokia_GSM_TRU_Equipment</field-name></source-field><dest-field></dest-field></field><field><source-field><entity>TRU_Equipment</entity><field-name>DA_Nokia_GSM_TRU_Equipment_Count</field-name></source-field><dest-field></dest-field></field></field-list></source><summary-attributes><intervals-required><interval type="daily" source="raw"/></intervals-required><calculate-late-data>true</calculate-late-data><summary-type>user</summary-type></summary-attributes><enabled>true</enabled></summary>

Provisioning the UDCs and summaries to Tivoli NetcoolPerformance Manager Wireless system

Instructions on how to provision or import UDCs and summary XML files.

Procedurev To import the da_udcs.xml file into the wireless system, run the kpicache_admin

script by using the following syntax:kpicache_admin -u <user> -p <password> -l <filename> <dsname>

Table 6. Parameters for importing the UDC

Option Description

-u <user> User name. Typically, sysadm.

-p <password> Password

-l <filename><dsname> Loads the file <filename> for the datasource<dsname>. The path to where the file islocated must be specified or the script mustbe executed where the file is located. Thename of the server must be used when youspecify the <dsname>, and not the IPaddress.

For example, kpicache_admin -u sysadm -p Sysadm01 -l da_udcs.xml


<server_name>.ibm.comFor more information about the kpicache_admin script, see Administering TivoliNetcool Performance Manager - Wireless Component.

v To provision the da_summary.xml file on the wireless system, run thesummary_admin CLI command by using the following syntax:summary_admin -c -f <filename> [-ignoreaggr <yes|no>]

Table 7. Parameters for importing the summaries

Option Description

-c Mandatory. Use this switch that is used tocreate a summary.

-f <filename> Mandatory. The file name and path of anXML file to use for creating the summary.

[-ignoreaggr <yes|no>] An optional flag to ignore the average ofaverage check.

For example, summary_admin -c -f da_summary.xmlFor more information about the summary_admin command, see AdministeringTivoli Netcool Performance Manager - Wireless Component.

Extracting and publishing daily summary modelExtract the summary definitions that are associated with a technology pack fromthe Tivoli Netcool Performance Manager database. You can then create a TivoliNetcool Performance Manager common pack data model that has a model thatreport authors can use to create reports by using those summary definitions.

Before you begin

Ensure that you have configured the JDBC driver in WirelessModelling toolpreferences so that you can connect to the database to extract the summarydefinitions.

Procedure1. In WirelessModelling tool, open the tnpmmodel file that you have created

from the raw model.2. In the Project Explorer, right-click the new project and select Import.3. On the Select page of the Import wizard, expand TNPM Pack Modeling and

select Import Summaries.4. Click Next.5. On the Database detail page, specify the following database details:

Option Description

Host The host server name, for example,server.ibm.com.

Username The database user name, for example,virtuo.

Password The database password.

6. Click Get Summaries. The database connection is tested.7. Click Next.8. On the Select Installed Packs page, select UDC.


9. Click Next. You can see all the summaries that you have provisionedpreviously.

10. Select all the summaries that are relevant to the technology pack for whichyou are creating data availability model.

11. Select the appropriate check box to filter the selected summaries by raw,hourly, daily, weekly, or monthly intervals. Click All Summaries if you wantsummaries for all intervals.

12. Select the Update Viewer check box to update the view on the SelectSummaries page. That is, if you select individual options such as Raw, Hourlyfrom Select Summaries area, then it displays those individual summaries.

13. Click Next.14. Enter the name vendor and technology of the summary model A CIF file with

summary model is generated.15. Create the model properties file. For more information, see “Creating a model

properties file” on page 35.16. Generate the model. For more information, see “Generating the Tivoli Netcool

Performance Manager common pack data model contents” on page 36.17. For a data availability model, select the summary model.


Important: It is recommended to give the same name as the pack name with.DA as the extension in uppercase to create the data availability model in theSymbolic Name field in the Deploy CIF files page. For example,nokia.gsm.bss.DA.

18. Publish the summary model by using Framework Manager. For moreinformation, see “Publishing a Tivoli Netcool Performance Manager commonpack data model” on page 37.

Scheduling and running summariesThe data availability report is based on daily summary and hourly drill-downresult is calculated during reporting. It is important that these summaries areexecuted periodically. A cron job can be set up to run the summaries as required.For performance reasons, the frequency of this run must be monitored.

Procedure

Note: Create the script DA_summary_cron and copy it to /appl/virtuo/admin/common/cron location.Daily summaries can be run via the scheduler. Alternatively, the daily summarycan be included in a script that is executed from crontab if the current day dataavailability is needed. However, the vendor_cleanup.ksh must remain in the scriptto filter the data availability result to a specific vendor and technology. Thefollowing line is added to the crontab:05 * * * * WMCROOT=/appl/virtuo;export WMCROOT;/appl/virtuo/admin/common/cron/DA_summary_cron> /dev/null 2>&1

#Example Script - DA_summary_cron############################################################!/bin/sh# sdate: A Bourne shell script that# prints the date n days ago.# Set the current month day and year.month=`date +%m`day=`date +%d`year=`date +%Y`daysbefore=0# Add 0 to month. This is a# trick to make month an unpadded integer.month=èxpr $month + 0`# Subtrace n from the current day.day=èxpr $day - $daysbefore`# While the day is less than or equal to# 0, deincrement the month.while [ $day -le 0 ]domonth=èxpr $month - 1`# If month is 0 then it is Dec of last year.if [ $month -eq 0 ]; thenyear=èxpr $year - 1`month=12fi# Add the number of days appropriate to the# month.case $month in1|3|5|7|8|10|12) day=èxpr $day + 31`;;4|6|9|11) day=èxpr $day + 30`;;2)if [ èxpr $year % 4` -eq 0 ]; thenif [ èxpr $year % 400` -eq 0 ]; thenday=èxpr $day + 29èlif [ èxpr $year % 100` -eq 0 ]; thenday=èxpr $day + 28èlseday=èxpr $day + 29`fielseday=èxpr $day + 28`fi;;


esacdone# Print the month day and year.#echo $month $day $yearDAY_S=$day-$month-$yearDAY_E=$day-$month-$year#echo $DAYS#echo $DAYE#Uncomment the next two lines to force a date#DAYS="24-03-2008"#DAYE="24-03-2008"echo `date`### Run summaries# Motorola BSS Summaries/appl/virtuo/bin/summary_admin -r BSC_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r Cell_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r Ethernet_link_mo_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r Gb_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r LAPD_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r PCU_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r Processor_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r Signalling_Link_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r X25_DA -ir daily -fr $DAY_S -er $DAY_E# Huawei BSS Summaries/appl/virtuo/bin/summary_admin -r BSC_DA_Huawei -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r M3UA_link_utilisation_DA -ir daily -fr $DAY_S -er $DAY_E/appl/virtuo/bin/summary_admin -r SCTP_Link_DA -ir daily -fr $DAY_S -er $DAY_E

DB_USERNAME=`$WMCROOT/bin/conf_read dbconnection vtdb|grep \.user=|sed -e 's/.*=//g'èxport DB_USERNAMEORACLE_SID=`$WMCROOT/bin/conf_read dbconnection vtdb|grep \.sid=|sed -e 's/.*=//g'èxport ORACLE_SIDDB_PASSWORD=`$WMCROOT/bin/conf_read dbconnection vtdb|grep \.password=|sed -e 's/.*=//g'èxport DB_PASSWORD

# Need to call the vendor_cleanup for EACH summary.# Parameters:# 1. Do not filter for vendor neutral data coverage summary tables# 2. The vendor you want to KEEP. All other vendors entities will be removed# 3. The name of the DSM table# 4. The identifier field that is being removed# 5. The nc table to use# e.g: /appl/virtuo/admin/common/cron/vendor_cleanup.ksh Huawei Gb_DA gb_id nc_gb/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Huawei GSM BSC_DA_HUAWEI_DSM BSC_ID nc_bsc/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM BSC_DA_DSM BSC_ID nc_bsc/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM Cell_DA_DSM CELL_ID nc_cell/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSMEthernet_link_mo_DA_DSM ETHERNET_LINK_ID nc_ethernet_link_mo/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM Gb_DA_DSM GB_ID nc_gb/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM LAPD_DA_DSM LAPD_ID nc_lapd/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM PCU_DA_DSM PCU_ID nc_pcu/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM Processor_DA_DSM Processor_ID nc_processor/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM GSMSignalling_Link_DA_DSM ss7_point_id nc_ss7_point/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Motorola GSM X25_DA_DSM X25_ID nc_x25/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Huawei GSMM3UA_link_utilisation_DA_DSM M3UA_LINK_ID nc_m3ua_link/appl/virtuo/admin/common/cron/vendor_cleanup.ksh Huawei GSMSCTP_Link_DA_DSM SCTP_LINK_ID nc_sctp_linkecho `date`

Note: You do not have to run the summary_admin part from the script if you do notneed daily summaries. You can comment this part from the script.


Generating data availability reportsGenerates the seven data availability reports based on the data availability modelthat is created.

Procedure1. In WirelessModelling tool, open the tnpmmodel file that you have created from

the data availability model.2. Right-click TNPM Package, and then select Data Coverage Utilities >

Generate Data Availability Reporting.3. On the Client details page, specify the following information:

Option Description

Database Host The Tivoli Netcool Performance Manager -Wireless Component database server hostname or IP address.

Database username By default, virtuo.

Database User(virtuo) Password The virtuo user password.

Cognos Dispatcher URI This is the Jazz for Service Managementserver URI. This URI must be the same asthe Gateway URI that you have set inFramework Manager configuration fromChapter 4, “Installing and configuring IBMCognos Framework Manager,” on page 13.

Username Jazz for Service Management serverusername. By default smadmin

Password The smadmin password.

Namespace By default, VMMProvider.

Report Output Dir Location where the generated reports areavailable. For example, C:/DA_reports/tmp.

4. Click Get Model Details.5. Click Next.6. On the Model details page, specify the following information:

Option Description

Data Availability Summary Model Data Availability model that you havecreated. For example,NOKIA_GSM_FAbis_BSC.DA.

Focal Entity Provisioned entities to be selected from thelist. This entity is the main entity fromwhich we want to view metrics.

Parent Entity Parent entity for the selected focal entity.

7. Click Generate Reports.After the data availability reports are generated in the Report Output Directory.The location is as follows:C:/DA_reports/tmp/NOKIA_GSM_FAbis_BSC.DA.These reports are a set of seven XML files. For NOKIA_GSM_FAbis_BSC.DA modelwith BSC and Abis as selected parent and focal entities, the seven reports are asfollows:


v NOKIA_GSM_FAbis_BSC_20Worst_DDA

v NOKIA_GSM_FAbis_BSC_DDA

v NOKIA_GSM_FAbis_BSC_HDA

v NOKIA_GSM_FAbis_BSC_TABLE_DDA

v NOKIA_GSM_FAbis_BSC_TABLE_HDA

v NOKIA_GSM_FAbis_BSC2_DDA

v NOKIA_GSM_PBSC_Abis_DDA

Note: The format of the XML file is as follows:<Vendor>_<Technology>_<P/F><entity_name>_<H/D>DA

Where:

P is parent entity, F is focal entityH is hourly, D is daily

Publishing the generated data availability reportsPublish the data availability reports to Jazz for Service Management content store.

Procedure1. Start WirelessModelling tool.2. Right-click TNPM Package, and then select Data Coverage Utilities > Publish

Data Availability Reports from a Directory. Publishes all the data availabilityreports that are available in the C:/DA_reports/tmp/<Pack_DA_Model> directory.

3. Optional: Right-click TNPM Package, and then select Data Coverage Utilities> Publish Data Availability Report.

Note: You must select this option only if you do not want to publish all dataavailability report from the directory.You can select the report that you want to publish from the defaultC:/DA_reports/tmp/<Pack_DA_Model> directory.

4. Click Finish.

Verifying the data availability report contentsView the published data availability reports from Jazz for Service Management.

Procedure1. Log in to Jazz for Service Management as the administration user, smadmin.2. Expand Reporting and select the Common Reporting tab.3. Click Public Folders > Data Availability > Contents >

<FAbis_PBSC_DA_Reports>. You can see the seven data availability reportsthat are published.

4. Double-click the report to view.

Note: It is recommended that you drill down to the daily and hourly reportsfrom the parent daily report or drill down to the table hourly report from thetable daily report.


Creating data availability summary reportThis is a one-time task.

About this task

For more information about this task, seehttps://www.ibm.com/developerworks/mydeveloperworks/blogs/cdd16df5-7bb8-4ef1-bcb9-cefb1dd40581/entry/model_maker_1_2_3_tnpm_1_3_2_creating_the_summary_report_on_data_availability_da?lang=en


https://www.ibm.com/developerworks/mydeveloperworks/blogs/cdd16df5-7bb8-4ef1-bcb9-cefb1dd40581/entry/model_maker_1_2_3_tnpm_1_3_2_creating_the_summary_report_on_data_availability_da?lang=en



Chapter 10. Troubleshooting Tivoli Netcool PerformanceManager - Application Studio and Common reporting

When you encounter a problem with using Tivoli Netcool Performance Manager -Application Studio components, the first thing to do is to check the detailed logfiles for that component. Most issues can be solved by referring to the log files.

Read the following known issues if you are experiencing problems with CommonReporting on Tivoli Netcool Performance Manager.

Data values that are displayed in the report do not match with thecolumns in the database

This issue is due to certain lapses in creating reports. When you create a report,follow the best practices that are described in the following link:https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Application%20Studio%201.4%20(Wireless%20Modelling)%20-%20Common%20Reporting.

Restrict the number of KPIs used in creating a report from a TivoliNetcool Performance Manager common pack data model

SymptomsWhen you create a report from a model that has many key performance indicators(KPIs), the report might not show all the KPIs that are selected from a single table.You might see the following error message:ORA-01792: maximum number of columns in a table or view is 1000

CausesThis is an Oracle limitation. An attempt was made to create a table or view withmore than 1000 columns, or to add more columns to a table or view, which pushesit over the maximum allowable limit of 1000. The unused columns in the table arealso counted toward the 1000-column limit.

Resolving the problemTo avoid this issue, plan and create a report with only those KPIs that are needed.Rather than using all the KPIs from a table.

Reporting fails with sort key too long error from a busy hour datamodel

This issue occurs when you are creating a report from the busy hour data models.

SymptomsWhen you are generating a report from a data model that has too many KPIs, youmight see the following error message:ORA-01467: sort key too long

CausesA DISTINCT, GROUP BY, ORDER BY, or SET operations require a sort key longerthan that supported by Oracle. Either too many columns or too many group





functions are specified in the SELECT statement that is used to pull the KPIs froma Stored Busy Hour definition of a data model.

Resolving the problemTo avoid this issue, plan and create a report with only the required KPIs alone andnot use all the KPIs for creating the report.

Manually edit the summary name in a data availability model if thesummary name exceeds 24 characters

An error when you generate the data availability model.

SymptomsWhen you generate the data availability components, you might receive an errormessage:

CausesYou receive this error message when the summary name is longer than 24characters.

Resolving the problemManually edit the summary name in the generated da_summary.xml file to reducethe number of characters to less than 24. For example, the name appears asfollows: DA_HUAWEI_GSM_M3UA_LINKSET.

When you edit the name, make sure that you do not remove theDA_<Vendor>_<Technology> part from the name. For example, do not remove orchange DA_HUAWEI_GSM.

For more information, see “Generating data availability components” on page 60.


Issues with rehomed data in the parent entity level in Data AvailabilityReports

SymptomsIf the parent entity level has rehomed data in the parent daily Data AvailabilityReport, then the instance counts in child entity level are displayed incorrectly.

Resolving the problemTo work around this issue, follow these steps:1. Open the parent daily Data Availability Report in Report Studio. For example,

NOKIA_GSM_FAbis_BSC_DDA report that has rehomed data at the parententity level.

2. Click Query Explorer, and then select Query1.3. Right-click a filter in the Detail Filters, copy, and paste the filter two more

times.4. For each new filter, modify the filters as follows:

Filter 1[Consolidation Views].<Entity>.[TIMESTAMP] < [Consolidation Views].[TIMES].[DATE_KEY_DAY]

For example, if the rehomed parent is Cell in the Data Availability Report, thefilter must be modified as follows:[Consolidation Views].[Cell].[TIMESTAMP] < [Consolidation Views].[TIMES].[DATE_KEY_DAY]

Filter 2[Consolidation Views].<Entity>.[ENDSTAMP] > [Consolidation Views].[TIMES].[DATE_KEY_DAY]

For example, if the rehomed parent is Cell in the Data Availability Report, thefilter must be modified as follows:[Consolidation Views].[Cell].[ENDSTAMP] > [Consolidation Views].[TIMES].[DATE_KEY_DAY]

5. Save the report template and run the parent Daily Data Availability Report.

Issues with Resource Metric Viewer report with charts and tables thatis exported to PDF

SymptomsWhen you create a report with charts and tables in Resource Metric Viewer thathas many metrics, and then export the report to PDF format, you might notice thatmany pages that contain repetitive charts for the metrics are generated.

CausesThis issue is seen because the numbers of metrics to be displayed out runs thedefault size of a PDF page.

Resolving the problemTo avoid this scenario, do not select many metrics in a report with both chart andtables that is to be exported to PDF.

Note: This issue is not seen if the report contains only charts.

Chapter 10. Troubleshooting Tivoli Netcool Performance Manager - Application Studio and Common reporting 73

Data values are not displayed in a Resource Metric Viewer report forcounters with different time granularity

Difference in the display of chart with counter that has different time granularityvalues.

SymptomsWhen you select counters with different measurement value in seconds for timegranularity in a Resource Metric Viewer report, the graph is displayed only for thecounter with lesser granularity value and does not display the line for the counterwith higher granularity.

Resolving the problemTo work around this issue, click Options > Show data point on chart. You can seethe data points for the counter with higher granularity value.

Note: By default, No data point on chart is selected to disable the display of datapoints on the chart.For more information, see “Constructing a report by selecting a subset of resourcesand metrics” on page 45.

Label alarms that might not be handled properly by the ResourceMetric Viewer

As part of setup for the Resource Metric Viewer, it is recommended that you labelthose alarms that might not display properly in the Resource Metric Viewer.

About this task

If you have a model with both RNC and BSC in it, and there are RNC or BSCalarms defined, and those alarms are forwarded to IBM Tivoli/Netcool OMNIbus,perform the following step:

Procedure

Add to the RNC/BSC alarm description Do not open this in RMV from AEL.Where:v RMV is the Resource Metric Viewer.v AEL is the Active Event List.

Note: For information on how to change the description of an alarm, see the topicUpdate an Alarm Definition of the Using Tivoli Netcool Performance Manager - WirelessComponent.

Error with connection failureError that is related to connection failure.

SymptomsYou might encounter the ERR_CONN_FAILED error when you are working onResource Metric Viewer models.

Resolving the problemTo resolve this issue, follow these steps:


v Restart Jazz for Service Management server.v Restart DB2 database.

Related tasks

Starting Jazz for Service Management application serversYou can start any Jazz for Service Management virtualization and reportingservers by using the IBM WebSphere startServer command. You might need torestart the application server after you complete a configuration task for anintegration service, or after you take the application server down formaintenance.Installing Resource Metric ViewerResource Metric Viewer must be installed on the server where Jazz for ServiceManagement is installed.

Cognos content store might stop dailySymptomsYou might experience a shutdown of the Cognos content store daily.

Resolving the problemTo resolve this issue, add the ulimit settings to the following files:v Shell start files, .bash_profile, or .profile

Note: You can change the session-based soft limits by using these files.

v /etc/security/limits.conf

v /etc/security/limits

Note: You can change the maximum limits that are allowed to a user by usingthese files.

ulimit settings provide control over resources that are available to each user via ashell. The lines are as follows:hard nofile 32768hard nproc 25600hard stack 2048

Note: If ulimit settings are added to /etc/security/limits.conf file, then restartthe system. If they are added to other files, then log in again.

Chapter 10. Troubleshooting Tivoli Netcool Performance Manager - Application Studio and Common reporting 75


Appendix. Command reference

A list of commands available for Tivoli Netcool Performance Manager datamodelers and administrators.

The following commands are available:v “The createmodel command”

The createmodel commandUse the createmodel command to generate a Cognos model from a CommonIntermediate Format (CIF) file (.tnpmmodel) generated by WirelessModelling tool.

Location

C:\npm_app_studio\WirelessModelling_<version>-win32.win32.x86\CreateModel_<version>\bin

Assuming that you have extracted CreateModel tool directly on to the C: drive.

Syntax

.\createmodel.bat -generate -model path_to_cif_file -propertiesmodel_name_model.properties -overwrite

Parameters

Option Description

-model path_to_cif_file The full path to the CIF file (.tnpmmodel)generated by WirelessModelling tool.

-properties model_name_model.properties The full path to the properties file for themodel.

-overwrite A mandatory command flag. Deletes all filesin the destination folder for the generatedmodel before generating the model. Thedestination folder is specified in themodel_name_model.properties file.

rmv_admin commandUse the -rmv command flag with the rmv_admin command to create and refreshresource metric viewer reports.

Location

JazzSM_Home/rmv/admin

Where JazzSM_Home is the location where the Jazz for Service ManagementComponents are installed. By default, /opt/IBM/JazzSM.


Syntax

Use this syntax to create Resource Metric Viewer reports for a specified data modelor for all available data models. The model must be deployed before a ResourceMetric Viewer report can be created.

rmv_admin.sh -rmv -create -pack [ pack_name | -all ] -logins password_file

Use this syntax to refresh Resource Metric Viewer reports following a change inthe underlying model, for example when new model version deployed to theserver.

rmv_admin.sh -rmv -update_metrics -pack pack_name | -all ] -logins password_file

Use this syntax to refresh Resource Metric Viewer reports following a change inthe model templates, for example to create custom Resource Metric Viewer reporttemplates.

rmv_admin.sh -rmv -update_reports -pack [ pack_name | -all ] -logins password_file

Use this syntax to list all the published models currently available in content storeincluding the CDM models, with details such as the model name, the version, andthe installation time.

rmv_admin.sh -rmv -list -logins password_file

Use this syntax to list the all the published CDM-less models currently available incontent store, with details such as the model name, the version, and the installationtime.

rmv_admin.sh -rmv -list_nas_model -logins password_file

Use this syntax to list the all the published models that are Resource Metric Viewerenabled in content store, with details such as the model name, the version, and theinstallation time.

rmv_admin.sh -rmv -list_enabled -logins password_file

Use this syntax to remove all obsolete Resource Metric Viewer reports from thesystem. Run this command when you remove a model or Resource Metric Viewerreport from the server.

rmv_admin.sh -rmv -remove

Parameters

When a parameter includes spaces, enclose the complete parameter in doublequotation marks or escape the parameter.

pack_nameThe name of a Tivoli Netcool Performance Manager common pack data modelin the data model repository. When you are listing multiple models leave aspace between each data model name.


password_fileAn encrypted credentials file containing a Jazz for Service Managementadministrative user name and password, and database user name andpassword.

allIf you want to refresh or create reports for all data models in folder.

Appendix. Command reference 79


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


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:


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 83

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.


http://www.ibm.com/legal/us/en/copytrade.shtml

http://www.ibm.com/legal/us/en/copytrade.shtml

Glossary

This glossary includes specific terms and definitions for Tivoli Netcool Performance Manager -Application Studio.

nasaccess user. A database user with the requireddatabase permissions for installing and performingcalendar refill for TCR Time schema. You must createthe nasaccess user before installing the TCR Timeschema.

busy hour determiner. A Key Performance Indicator(KPI) that is used to determine the busiest hour. Themaximum value of this KPI on a particular day definesthe busiest hour. For example, Cell.sms.sms_messagescan determine the busiest hour for SMS traffic.

busy hour value. A Key Performance Indicator (KPI)that is associated with a busy hour determiner andstored for the same hour. For example if the busy hourdeterminer Cell.sms.sms_messages has a busy hour of17:00, then associated busy hour value KPIs such asCell.sms.sms_attempts, Cell.sms.sms_failures canalso be stored.

Common Intermediate Format (CIF). A CIF file(.tnpmmodel) contains the metadata extracted from atechnology pack or from a live Tivoli NetcoolPerformance Manager system by WirelessModellingtool. A CIF file is used as the input by CreateModeltool to generate a Tivoli Netcool Performance Managerdata model.

Tivoli Netcool Performance Manager common packdata model. A Tivoli Netcool Performance Managercommon pack data model is a Cognos data model.Tivoli Netcool Performance Manager common packdata models define their own model data sources. Eachdata source identifies the schema in which the tablesare defined, but is configured to share a commonunderlying Content Manager data source. In thisrelease, data models for raw data, summaries, and busyhours are supported.

connection profile. A profile used to connect to theTivoli Common Reporting server and the Tivoli NetcoolPerformance Manager database.

data source. The definition of the location and accesscredentials of a database, file, or URL from which datais read for reporting.

WirelessModelling tool. A Tivoli Netcool PerformanceManager data modeler tool for Tivoli NetcoolPerformance Manager. Tivoli Netcool PerformanceManager data modelers can use WirelessModelling tobrowse a technology pack and extract the technologypack definition metadata, or browse a live Tivoli

Netcool Performance Manager system and extract thesummary or busy hour metadata. The metadataextracted is converted into a Common IntermediateFormat (CIF) file (.tnpmmodel) for later processing intoa data model.

Framework Manager. Framework Manager is a TivoliCommon Reporting modeling tool for creating andmanaging metadata for use in analysis and reporting.Metadata is published for use by reporting tools as apackage, providing a single, integrated business viewof any number of heterogeneous data sources.

CreateModel tool. A Tivoli Netcool PerformanceManager data modeler tool for Tivoli NetcoolPerformance Manager. Tivoli Netcool PerformanceManager data modelers use CreateModel tool to buildTivoli Netcool Performance Manager data models.CreateModel processes the Common IntermediateFormat (CIF) file (.tnpmmodel) generated byWirelessModelling.

hierarchy table. A table in the data model andassociated schema with a Dimension Model (DM)prefix. DM tables have a direct correlation to theNetwork Configuration (NC) tables in Tivoli NetcoolPerformance Manager - Wireless Component. Each NCtable is mapped to a DM table and each row within theDM table takes into account the rehoming of its parenttables. The views that represent the traffic data arejoined directly to the DM tables, therefore when wereport on data we know the exact hierarchyinformation of the entity/resource at a particular pointin time, without having to query the NC table with atime filter (as is the case in Tivoli Netcool PerformanceManager - Wireless Component).

Tivoli Common Reporting. Tivoli Common Reportingis the common reporting platform for the Tivoliportfolio. Tivoli Common Reporting consists of selectedcomponents of IBM Cognos 8 Business Intelligence, anenterprise reporting solution.



Index

Bbusy hour model 29Busy hours definitions

Tivoli Netcool Performance Managercommon pack data model 26

CCognos model 25

removing from respository 25respository 25

Command 77Command reference 77Component

wireless 5wireline 5

conventionstypeface vi

CreateModelinstalling 18

CSV file 31identifying metric groups 31

DData availability

formulas 61reporting 55summaries 62Summary Report

creating 70Data availability reports

generating 68Data model

filter files 31filtering 30

Eeducation

See Tivoli technical training

FFilter metrics 25Framework Manager 6

JJDBC driver

configuring 18

MMetric groups 33

identifying 31Model properties file

creating 35

OOracle client 6

PPassword

database 27Performance metrics 30Prerequisite

ODBC connection 5security patch 5software 5

RResource groups 33rmv_admin

commands 77

Sservice vservice management connect vSMC vSQL query

using 33Summary definitions

Tivoli Netcool Performance Managercommon pack data model 27

support v

TTivoli Netcool Performance Manager data

modelcreating 29generating contents 36

Tivoli technical training vtraining, Tivoli technical vtypeface conventions vi

WWireless Component 9, 14WirelessModelling

configuring 17installing 17, 25opening 17

Wireline 5



��

Printed in USA

Documents

Tivoli Netcool Performance Manager - Application Studio ......About this information The IBM Tivoli Netcool Performance Manager: Application Studio Installation and User Guide describes