installing and using solution packs - ibm · 2014-05-03 · installing and using solution packs....

IBM Tivoli Netcool Performance Manager 1.4Document Revision R2E1

Installing and Using Solution Packs

��

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

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

Contents

About this information . . . . . . . . vIntended audience . . . . . . . . . . . . vOrganization . . . . . . . . . . . . . . vService Management Connect. . . . . . . . . vTivoli technical training . . . . . . . . . . viSupport information . . . . . . . . . . . viConventions used in this publication . . . . . . vi

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

Chapter 1. Introduction . . . . . . . . 1Architecture . . . . . . . . . . . . . . 1Use cases in Solution Pack 3.1.0.0 . . . . . . . 2

Chapter 2. Downloading the SolutionPack 3.1.0.0 . . . . . . . . . . . . . 5Components of the Solution Pack 3.1.0.0 . . . . . 5

Chapter 3. Software requirements andprerequisite software . . . . . . . . . 7Supported configurations . . . . . . . . . . 7

Chapter 4. Special Events Management 9Deploying the Special Event Management dashboardsolution . . . . . . . . . . . . . . . . 9

Using Tivoli Directory Integrator as a dataprovider . . . . . . . . . . . . . . 10Preparing the Tivoli Directory Integratorenvironment . . . . . . . . . . . . . 10Installing Tivoli Directory Integrator . . . . . 11Creating Pweb reports on Tivoli NetcoolPerformance Manager Web client . . . . . . 12Deploying the Dashboard Application ServicesHub data packages on Tivoli Directory Integrator 17Starting the Special Event Management solution 20Running the Special Event Managementdashboard reports . . . . . . . . . . . 20

Deploying the Special Event Management Cognossolution . . . . . . . . . . . . . . . 22

Getting started with common reporting . . . . 22Running the Special Event Management Cognosreport . . . . . . . . . . . . . . . 23

Chapter 5. 4G and Legacy NetworksInteroperability . . . . . . . . . . . 25Getting started with common reporting . . . . . 25

Logging in to the reporting interface . . . . . 25Exporting Cognos report packages. . . . . . 27Importing Cognos report packages . . . . . 27Running the 4G and Legacy NetworksInteroperability reports . . . . . . . . . 28

Chapter 6. Network QoS Assurance . . 31Getting started with common reporting . . . . . 32Running the Network QoS Assurance reports . . . 32Filtering criteria for the reports . . . . . . . . 33Scheduling and emailing an Active Report . . . . 34

Chapter 7. Comprehensive ReportLaunchpad . . . . . . . . . . . . . 35Deploying solution pack report launchpad onDashboard Application Services Hub for WirelineComponent . . . . . . . . . . . . . . 35

Preparing the Tivoli Directory Integratorenvironment . . . . . . . . . . . . . 36Installing Tivoli Directory Integrator . . . . . 37Importing Wireline Dashboard ApplicationServices Hub pages. . . . . . . . . . . 37Special Tivoli Directory Integrator tablesdefinitions . . . . . . . . . . . . . . 38Starting the Report Launchpad solution . . . . 41Running the reports from Report Launchpad . . 42Report List Configuration . . . . . . . . 42

Chapter 8. Troubleshooting thesolution pack . . . . . . . . . . . . 45

Appendix. Common directory locationsfor Jazz for Service Management . . . 47

Notices . . . . . . . . . . . . . . 51

© Copyright IBM Corp. 2014 iii

iv Installing and Using Solution Packs

About this information

Solution Packs can be used to monitor a user-defined cluster of network objectsfrom IBM® Tivoli® Netcool® Performance Manager for some specific use cases. Thisdocument gives step-by-step installation and usage instructions for the SolutionPack 3.1.0.0.

Intended audienceThis document is intended for:v NOC Engineers who want to install and administer data models on a Tivoli

Netcool Performance Manager system.v Radio Optimization Engineersv Network Plannersv Tivoli Netcool Performance Manager Users (TNPM Users)

Readers must be familiar with the following topics:v Tivoli Netcool Performance Manager reporting conceptsv Tivoli Netcool Performance Manager Technology Packsv Common reportingv Jazz for Service Management components

OrganizationRead this summary information to help you find the information that you need.v Chapter 1, “Introduction,” on page 1v Chapter 2, “Downloading the Solution Pack 3.1.0.0,” on page 5v Chapter 3, “Software requirements and prerequisite software,” on page 7v Chapter 5, “4G and Legacy Networks Interoperability,” on page 25v Chapter 6, “Network QoS Assurance,” on page 31v Chapter 4, “Special Events Management,” on page 9v Chapter 7, “Comprehensive Report Launchpad,” on page 35v Chapter 8, “Troubleshooting the solution pack,” on page 45v “Common directory locations for Jazz for Service Management,” on page 47

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.

© Copyright IBM Corp. 2014 v

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

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

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 Wiki on developerWorks

Tivoli technical trainingFor Tivoli technical training information, see the following Tivoli NetcoolPerformance Manager Training website at https://tnpmsupport.persistentsys.com/training.

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

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

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

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

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

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)

vi Installing and Using Solution Packs

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Home

https://tnpmsupport.persistentsys.com/training

https://tnpmsupport.persistentsys.com/training

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 Emphasis of words and letters (words as words example: "Use the wordthat to introduce a restrictive clause."; letters as letters example: "TheLUN address must start with the letter L.")

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

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

Monospace

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

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

Bold monospace

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

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

parameters and arguments, and configuration parametersv Process namesv Registry variable names in textv Script names

About this information vii

viii Installing and Using Solution Packs

Chapter 1. Introduction

IBM Tivoli Netcool Performance Manager Solution Packs provide an integrated,use case driven solution with improved user experience and dashboard capabilitiesin managing customer’s network infrastructure. Currently, the solution packs arenot delivered in the Commercial Off The Shelf (COTS) program with thecorresponding technology packs.

ArchitectureArchitecture of the solution pack version 3.1.0.0 that is released in April 2014.

© Copyright IBM Corp. 2014 1

Use cases in Solution Pack 3.1.0.0Solution Pack 3.1.0.0 contains four use cases that are explained.

Figure 1. Integration of all use case scenarios in Tivoli Netcool Performance Manager Solution Pack 3.1.0.0:

2 Installing and Using Solution Packs

Solution Pack 3.1.0.0 has the following use cases that are combined into one singlepackage:

Table 1. Use cases available in Solution Pack 3.1.0.0

S.no. Use Case Description

1 4G and LegacyNetworksInteroperability

This use case shows how Communications ServiceProviders (CSPs) handle problems of inter-RAT handoverfailures, in terms of where it is occurring, when it startedand which Radio Access Technologies (RAT) is the biggestcontributor.

2 Special EventsManagement

This use case helps Communications Service Providers(CSPs) to actively monitor a user-defined cluster ofnetwork objects, especially for special events.

3 Network QoSAssurance

This use case helps Network Planner to assess the NetworkQoS performance trends and identify worst performingcells by viewing the weekly scheduled and interactiveCognos Active Reports. The insights obtained could beused to improve customer experience by ensuring thenetwork meets data growth and new services requirements.

4 Comprehensive ReportLaunch Pad

This use case helps TNPM users with an easier navigationto report of interest through the DASH capability andprovides the feature to save user’s favorite reports.

Chapter 1. Introduction 3

Chapter 2. Downloading the Solution Pack 3.1.0.0

Solution Pack 3.1.0.0 is available for download on the ISML.

Procedure1. Download the Solution Pack 3.1.0.0 from the IBM Service Management Library

(ISML). You can download the package from:http://www-01.ibm.com/software/brandcatalog/ismlibrary/.

2. Extract the Solution Pack 3.1.0.0 to a location of your choice to find the contentsas described in “Components of the Solution Pack 3.1.0.0.”

Components of the Solution Pack 3.1.0.0

Package name Contents

TNPM Solution Pack 3.1.0.0.zip ibm.tnpm.lte.vn.v2.zip

4G_and_Legacy_Networks_Interoperability.zip

Special_Event_Management.zip

This compressed file has these two components:

v Special_Event_Management_Cognos.zip

v Special_Event_Management_Dash.zip

Network_QoS_Assurance.zip

Report_Launchpad.zip


http://www-01.ibm.com/software/brandcatalog/ismlibrary/

Chapter 3. 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 2. Supported software components

Software Supported versions

Operating system RHEL 5.9, 6.2

Tivoli Netcool Performance Manager 1.4

Jazz for Service Management 1.1.0.2

Tivoli Common Reporting 3.1.0.2

Database10.1.0.1

11.2.0.3

IBM Cognos Business Intelligence 10.2

Microsoft Office 2007

Supported browsers

The following browsers are required to support the Web client and provide accessto the Solution Pack 3.1.0.0 reports:

Browser Versions

Internet Explorer v 8.0

v 9.0

Mozilla Firefox v ESR 17.0.1

v ESR 17.0.2

Important: Do not use Mozilla Firefox to view Network QoS Assurance reports.

Hardware requirements

A minimum of 16 GB server disk space is required for IBM Cognos BusinessIntelligence.

For more information about Hardware requirements for Wireline Component, seehttp://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/config_recommendations/ctnpm_configrecguide_minimumrequirementsforinstallation-1-03.dita?cp=SSBNJ7_1.4.0%2F3-1-1.


http://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/config_recommendations/ctnpm_configrecguide_minimumrequirementsforinstallation-1-03.dita?cp=SSBNJ7_1.4.0%2F3-1-1




For more information about Hardware requirements for Wireless Component, seehttp://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/wls_deployment/ctnpm_wls_deployment_operating_system.dita.

Other requirements

Product Version

LTE Vendor Neutral Technology Pack 2.0.0.0

LTE Vendor Neutral Common Pack(ibm.tnpm.lte.vn.v2.zip)

2.0.0

Related information:

Jazz for Service Management IBM Knowledge Center

Tivoli Netcool Performance Manager IBM Knowledge Center


http://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/wls_deployment/ctnpm_wls_deployment_operating_system.dita



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

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

Chapter 4. Special Events Management

This solution helps to monitor special events, essentially a user-defined cluster ofnetwork objects. The Special Events Management solution contains two of reportpackages in it. Dashboard reports and Cognos reports

Consider the following scenarios on how this solution is helpful:v Special Event in a single location; A rock concert in a stadiumv Special Event in multiple locations; An event conducted across many

geographies like a world cup foot ball matched happening in many cities in acountry

v Special festive seasons in some countries where you see a periodic surge intraffic that requires a close monitoring

v Regular monitoring of routes that are typically used by VIPs in a city wheresafety could be a concern

Target Persona

v NOC Engineersv Radio Optimization Engineers

Benefits

v Activity monitoring of network hotspotsv Fine-tuning of configuration parameters

Components

v LTE Vendor Neutral Technology Packv Special Dashboard Application Services Hub pages that are integrated on

Jazz for Service Management serverv Common reporting on Cognos 10v Data integration by using Tivoli Directory Integrator on Jazz for Service

Management

Deploying the Special Event Management dashboard solutionDeploying the Special Event Management solution on Dashboard ApplicationServices Hub for Wireless Component,

Before you begin

Ensure that you have the following software installed:v Tivoli Netcool Performance Manager 1.4 Wireless Componentv Latest version of the Vendor Neutral Common Pack ibm.tnpm.lte.vn.v2.zip

v Jazz for Service Management v1.1.0.2v Extract the report package Special_Event_Management.zip and also the

Special_Event_Management_Dash.zip files for this solution.


Using Tivoli Directory Integrator as a data providerYou can populate widgets with data from data sets provided by IBM TivoliDirectory Integrator.

Tivoli Directory Integrator is an integrated development environment and runtimeservice for general-purpose, multi-format, multi-directional, real-time datamovement, synchronization and transformation.

Dashboard Application Services Hub can use Tivoli Directory Integrator to retrievedata from different Tivoli and third-party data sources and store the data in datasets. The console then uses the Tivoli Directory Integrator data provider to retrievethese data sets from the Tivoli Directory Integrator server, and use the data inwidgets.

The steps to use Tivoli Directory Integrator as a data provider are summarized asfollows:v Install Tivoli Directory Integrator, the fix pack, and the JAR files. See Preparing

the Tivoli Directory Integrator environment.v Create Tivoli Directory Integrator data sets. Seev Reinitialize the Tivoli Directory Integrator data provider to pick up new and

modified data sets from the Tivoli Directory Integrator server. SeeRelated tasks:“Preparing the Tivoli Directory Integrator environment”Install Tivoli Directory Integrator 7.1.1 Fix Pack 2 and overwrite the OSGI plugins.

Preparing the Tivoli Directory Integrator environmentInstall Tivoli Directory Integrator 7.1.1 Fix Pack 2 and overwrite the OSGI plugins.

Before you begin

For more information about the requirements for Tivoli Directory Integrator, seehttp://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/adminguide11.htm?path=8_11_0_4_4_0#wq20

About this task

The Tivoli Directory Integrator installation media and fix pack are provided withthe Jazz™ for Service Management installation media.

You can install Tivoli Directory Integrator on the same server on which DashboardApplication Services Hub is installed.

Procedure1. Install Tivoli Directory Integrator Version 7.1.1.2. The Tivoli Directory Integrator installation media is in the TDI7.1.1

subdirectory of the extracted Jazz for Service Management installation image onyour local file system.

3. Install Tivoli Directory Integrator Version 7.1.1 Fix Pack 2. For more informationabout applying the fix pack, see the 7.1.1-TIV-TDI-FP0002.README file in the fixpack directory. The Tivoli Directory Integrator fix pack is located in theTDI7.1.1FP2 subdirectory of the extracted Jazz for Service Managementinstallation image on your local file system.

4. Back up the following JAR files in the <TDI_HOME>/osgi/plugins directory.


http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0.2/integrate/tip_t_integrate_install_tdi.html

http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0.2/integrate/tip_t_integrate_install_tdi.html

http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/adminguide11.htm?path=8_11_0_4_4_0#wq20


v com.ibm.di.api.bind.jar

v com.ibm.di.api.rest.jar

By default, <TDI_HOME> is /opt/IBM/TDI/V7.1.1.5. Copy the com.ibm.di.api.bind.jar and com.ibm.di.api.rest.jar files from the

DASH_Home/installableApps to the TDI_HOME/osgi/plugins directory.6. Stop the Tivoli Directory Integrator server or the Configuration Editor. Then,

start the Tivoli Directory Integrator server by starting the Configuration Editor.For more information, see Introducing IBM Tivoli Directory Integrator.

Related concepts:“Using Tivoli Directory Integrator as a data provider” on page 10You can populate widgets with data from data sets provided by IBM TivoliDirectory Integrator.Related information:

IBM Tivoli Directory Integrator, Version 7.1.1 Information Center

Integrating with Dashboard Application Services Hub

Installing Tivoli Directory IntegratorThe Tivoli Directory Integrator installer allows you to install Tivoli DirectoryIntegrator 7.1.1 in its entirety, only those Tivoli Directory Integrator componentsthat you need, upgrade a previous version of Tivoli Directory Integrator (versions6.0, 6.1, 6.1.1, 7.0, or 7.1), or add features to an existing Tivoli Directory Integrator7.1.1 installation.

About this task

Installing Tivoli Directory Integrator 7.1.1 uninstalls a previous version; theuninstallation does not remove any files that the user has created. User createdfiles are still available after the new installation completes. Configuration files suchas global.properties and am_config.properties are migrated to Tivoli DirectoryIntegrator 7.1.1, keeping any custom configuration changes that have been made.The Tivoli Directory Integrator 7.1.1 installation continues to use the featuresavailable in previous versions of Tivoli Directory Integrator:v Administration and Monitoring Console (AMC)v Configuration Editor (CE)v Examplesv IBM User Interface Help System built on Eclipsev Java API Documentationv Runtime Server

Procedure1. Launch the installer directly by using the installation executable file as follows:

Linux 64-bitinstall_tdiv711_linux_x86_64.bin

2. Double-click the executable file, or type the executable file name at thecommand prompt. This launches the installer. The installer is launched. Forinformation on how to use the installer, see Using the platform-specific TDIinstaller.


Chapter 4. Special Events Management 11

http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/intro_tdi_chap2.htm

http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/welcome.htm

http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0/integrate/tip_c_integrate.html

http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/adminguide12.htm#install


Preparing the Tivoli Directory Integrator environment

Creating Pweb reports on Tivoli Netcool Performance ManagerWeb client

Reporting page contains a wizard-like interface that steps you through creating areport definition, or report template. After completing the report definition, youcan run the report immediately.

About this task

For more information on the report creation process in Tivoli Netcool PerformanceManager Web client, see Using Tivoli Netcool Performance Manager - WirelessComponent.

Procedure1. Log in to Tivoli Netcool Performance Manager Web client by using the

following URL:http://<server.ibm.com>:8080/tnpmw

2. Enter the user name and password.3. Click Reporting > define Report.4. Specify the report name. For example, DASH_Report.5. Select the focal entity.

Typically, the focal entity represents the entity type that you want to reporton. For example, if you want to report on the cells in your network, youwould select the cell entity type. For example, select EUtranCell.

6. Select the following fields:The Field Selections section of the report definition allows you to select theperformance measurements, or fields, against which you evaluate yourwireless network. It is in the Field Selections section that you select themetrics that are of interest to you.v EUtranCell.ENodeBFunction_Id (attribute

v EUtranCell.Neutral.Availability._%_Cell_availability

v EUtranCell.Neutral.EUtranCellTraffic.DL_traffic_volume

v EUtranCell.Neutral.EUtranCellTraffic.UL_traffic_volume

v EUtranCell.Neutral.HO_outgoing_inter_RAT._%_IratOutSucc

v EUtranCell.Neutral.Mobility._%_Success_intra_eRan_out

v EUtranCell.Neutral.Retainability._%_Call_drop_all_service

7. Click Extended Functions > Group By > Time – Hour to rank top and bottomfield values.

8. Save the report and exit.9. Click Reporting > new schedule.

Allows you to schedule a report to run at a future date.10. In the New Schedule page, select the following:

v Hourly in Frequency to Run to run every single hourv Database Export in Automatic Export of Report Results

11. Save and exit. Wait for the report to run and create theXP_DASH_DSH2_SCHDLE_RES table.


http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=%2Fcom.ibm.psc.doc_1.1.0%2Fintegrate%2Ftip_t_integrate_install_tdi.html

Note: Replace the name XP_DASH_DSH2_SCHDLE_RES by the table name that isgenerated by Tivoli Netcool Performance Manager Web client.

What to do next

Alternatively, you can import the report by using report_impexp tool. For moreinformation, see “Importing a report by using report_impexp tool.”Related concepts:“Pweb report table definition”When the Pweb report is run for the first time, this table is created with thesefields.Related tasks:“Importing a report by using report_impexp tool”The report_impexp tool provides functionality for importing and exporting reportdefinitions among other things. This procedure is an alternate procedure forimporting a report.

Pweb report table definitionWhen the Pweb report is run for the first time, this table is created with thesefields.v TSTAMP

v EUTRANCELL_ID

v T_HOUR

v ENODEBFUNCTION_ID

v PC_CELL_AVAILABILITY

v DL_TRAFFIC_VOLUME

v UL_TRAFFIC_VOLUME

v PC_IRATOUTSUCC

v PC_SUCCESS_INTRA_ERAN_OUT

v PC_CALL_DROP_ALL_SERVICE

Related concepts:“Pweb report view definition” on page 15Create the view from the report table.Related tasks:“Creating Pweb reports on Tivoli Netcool Performance Manager Web client” onpage 12Reporting page contains a wizard-like interface that steps you through creating areport definition, or report template. After completing the report definition, youcan run the report immediately.“Importing a report by using report_impexp tool”The report_impexp tool provides functionality for importing and exporting reportdefinitions among other things. This procedure is an alternate procedure forimporting a report.

Importing a report by using report_impexp toolThe report_impexp tool provides functionality for importing and exporting reportdefinitions among other things. This procedure is an alternate procedure forimporting a report.


About this task

The report_impexp tool is located in: $WMCROOT/bin. Do not run more than oneinstance of the tool at any particular time. For more information about this tool,see Administering Tivoli Netcool Performance Manager - Wireless Component.

Procedure1. Log in to Tivoli Netcool Performance Manager system as user virtuo.2. Go to <package>/PWEB/.3. Run the following command in a single line:

report_impexp -i -u <user_id> -p <password>-f <file|dir> -l <server_directory>-dup <failonerror|overwrite|ignore>

Where:

Option Description

-i Initiates the import process.

-u <user_id> The username of the user invoking theimport tool.

-p <password> The user's password.

-f <file|dir> Name of xml file from which to import userdocuments.

Can be a reference to a file or a folder. If areference to a folder is given then arecursive search is carried out for all fileswith an .xml extension. Each file is thenimported.

-l <server_directory> Destination on server that is the rootlocation for imported documents. This mustbe a valid user folder location. For example:/Users/sysadm

/Users/peter/folder1

/Users/mary/backup/daily

If the -l option is not used then the locationand associations are taken from theimported document(s).

-dup <failonerror|overwrite|ignore> Import process behavior. This option isspecified with one of the following threeparameters:

failonerrorfail when an existing documentwith the same name is found

overwriteoverwrite when existing documentswith the same names are found

ignore ignore documents that already exist

For example,report_impexp -i -u sysadm -p Sysadm01 -f DASH_schedule.xml -l /Users/sysadm -dup failonerror


.4. Verify that the import is successful by using the following steps:

a. Log in to Tivoli Netcool Performance Manager system as user sysadm.b. Click Reporting > manage report.

Allows you to open a saved report definition or template. You see DASH inthe report listing.

c. Click Reporting > manage schedule.You see DASH_schedule in the schedule listing.

5. Change the frequency of the report by using the following steps:a. Log in to Tivoli Netcool Performance Manager system as user sysadm.b. Click Reporting > manage schedule.c. Select DASH_schedule and click open schedule.d. Click Automatic Export of Report Results and click Edit.e. Go to Database tab and select Database Export under Export Format.f. Click Apply, and then click save schedule.

Related concepts:“Pweb report table definition” on page 13When the Pweb report is run for the first time, this table is created with thesefields.Related tasks:“Creating Pweb reports on Tivoli Netcool Performance Manager Web client” onpage 12Reporting page contains a wizard-like interface that steps you through creating areport definition, or report template. After completing the report definition, youcan run the report immediately.

Pweb report view definitionCreate the view from the report table.

Run the following command in a single line to create the view from the report thatwas created earlier:CREATE OR REPLACE FORCE VIEW "VIRTUO"."UC2_PWEB_REPORT_V"("TSTAMP", "EUTRANCELL_ID", "T_HOUR", "ENODEBFUNCTION_ID","PC_CELL_AVAILABILITY", "DL_TRAFFIC_VOLUME", "UL_TRAFFIC_VOLUME","PC_IRATOUTSUCC", "PC_SUCCESS_INTRA_ERAN_OUT", "PC_CALL_DROP_ALL_SERVICE")AS

SELECT "TSTAMP","EUTRANCELL_ID","T_HOUR","ENODEBFUNCTION_ID",ROUND(NVL("PC_CELL_AVAILABILITY",0),2),"DL_TRAFFIC_VOLUME","UL_TRAFFIC_VOLUME",ROUND(NVL("PC_IRATOUTSUCC",0),2),ROUND(NVL("PC_SUCCESS_INTRA_ERAN_OUT",0),2),ROUND(NVL("PC_CALL_DROP_ALL_SERVICE",0),2)

FROM XP_DASH2_DSH2SCHDL_RES;

Note: Replace the name XP_DASH2_DSH2SCHDL_RES by the table name that isgenerated by Pweb in “Creating Pweb reports on Tivoli Netcool PerformanceManager Web client” on page 12.Related concepts:“Pweb report table definition” on page 13When the Pweb report is run for the first time, this table is created with these


fields.

Creating the index:

Create the index t_hour_idx.

About this task

Use the following command to create the index:CREATE INDEX t_hour_idx

ON XP_DASH_DSH_SCHDLE_RES(T_HOUR);

CREATE INDEX eutrancell_id_idxON XP_DASH_DSH_SCHDLE_RES(EUTRANCELL_ID);

CREATE INDEX enodebfunction_id_idxON XP_DASH_DSH_SCHDLE_RES(ENODEBFUNCTION_ID);

Note: Replace XP_DASH2_DSH2SCHDL_RES by the table name that is generated byTivoli Netcool Performance Manager Web client from here:1. Log in to Tivoli Netcool Performance Manager Web client from the following

URL as smadmin user:http://<server.ibm.com>:8080/tnpmw

2. Click Reporting > manage schedule.3. Select DASH_schedule.

You can find the table name in External Report pane.

Specific tables for Monitoring of Object Cluster for Special EventTivoli Netcool Performance Manager system database event table definitions.

UC2_EVENTLIST table definitionEVENT_IDEVENT_NAMEAVENUEEND_TSTAMPSTART_TSTAMPDESCRIPTION

UC2_EVENT_CELL_MAP table definitionEUTRANCELL_IDEVENT_ID

Use the following SQL statement to create the table:CREATE TABLE UC2_EVENTLIST(EVENT_ID VARCHAR2(50),EVENT_NAME VARCHAR2(100),AVENUE VARCHAR2(100),END_TSTAMP DATE,START_TSTAMP DATE,DESCRIPTION VARCHAR2(2048)) ;

CREATE TABLE UC2_EVENT_CELL_MAP(EUTRANCELL_ID VARCHAR2(50),EVENT_ID VARCHAR2(50)) ;


Deploying the Dashboard Application Services Hub datapackages on Tivoli Directory Integrator

Procedure1. Launch Configure the Configuration Editor from Application > IBM Tivoli

Integrator v7.1.1 > Configuration Editor.2. Use the default workspace directory.

The first time you start the Configuration Editor, it prompts you for aworkspace directory. The workspace directory is the filesystem location whereyour projects are stored. You can change this directory later from the File menu.

3. On the welcome screen, click Create Tivoli Directory Integrator project linkand specify the name of the project as DASH_SPECIAL_EVENTS.

4. Import the <package>/TDI/TDI_Conf.xml file into the project.5. Connect to the wireless component vtdb datasource by following these steps:

a. Go to project > scripts > database_config.b. For Oracle JDBC connection, specify the following information:

JDBC URLjdbc:oracle:thin:@<IP_Address>:1521:vtdb

JDBC Driveroracle.jdbc.driver.OracleDriver

Usernamevirtuo

PasswordVirtuo01

6. Deploy the configuration to the Tivoli Directory Integrator Server by followingthese steps:a. Drag and drop the project to Running server.b. On runtime configuration dialog, click Finish.

7. Copy the ojdbc6.jar file to /opt/IBM/TDI/V7.1.1/jars/3rdparty/others, ifdatabase is not installed on the same server where Tivoli Directory Integrator isinstalled. Tivoli Directory Integrator can now connect to the Oracle database.

Note: You can find the ojdbc6.jar file from $ORACLE_HOME/jdbc/lib/ojdbc6.jar.

8. Restart the Configuration Editor.

Importing Dashboard Application Services Hub PagesIBM Dashboard Application Services Hub allows you to create custom dashboardpages. A page is an arrangement of one or more widgets in the work area of theconsole. A widget is a user interface component that displays information in aconsole dashboard. Dashboard Application Services Hub provides a set ofpredefined widgets. Each widget is configured to retrieve information from a dataprovider that has a connection defined in Dashboard Application Services Hub.Each data provider divides its information into data sets.

Before you begin

For detailed information on predefined widgets, how to edit and customize eachwidget type, and how to create catalogs and pages with widgets, see the


Dashboard Application Services Hub online help orJazz for Service ManagementIntegration Guide.

About this task

Describes the steps to import the packaged Dashboard Application Services HubPages:

Procedure1. Import the following Dashboard Application Services Hub data packages by

running the consolecli commands:

Note: The consolecli commands are entered from the <DASH_HOME>/bindirectory. The default <DASH_HOME> is /opt/IBM/JazzSM/ui./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Special_Event_Management_Folder.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Special_Event_Administration.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Special_Event_Monitoring_Report.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Cell_Details.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Radio_Capacity_Report.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Special_Event_View.zip--username <WAS_admin_user_name> --password <WAS_admin_password> --excludePlugins TCRImportPlugins

2. Extract the custom pages as follows:a. Go to DASH_Profile/installedApps/JazzSMNode01Cell folder. The default

location for DASH_Profile is /opt/IBM/JazzSM/profile.b. Extract the packages by using the following command:

tar xvf <package>/Custom_Pages/DASH_Custom_Pages.tar



Starting Dashboard Application Services Hub services

Procedure1. Start Jazz for Service Management.2. Start Tivoli Directory Integrator derby database by using these steps:

a. Go to /opt/IBM/TDI/V7.1.1/bin.b. Start Tivoli Directory Integrator from command line by using

startSEMServer.sh file.c. Optional: Stop Tivoli Directory Integrator from command line by using

stopSEMServer.sh file.3. Login to Dashboard Application Services Hub from the following URL:

https://<server.ibm.com>:16311/ibm/console/

For more information, see “Logging in to the reporting interface” on page 25.Related tasks:


http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0.2/integrate/tip_c_integrate.html

“Starting Jazz for Service Management application servers”You 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.“Stopping Jazz for Service Management application servers”You 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.

Starting Jazz for Service Management application servers:

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

Procedure

1. On the relevantJazz for Service Management server, open a command window.2. Change to the JazzSM_WAS_Profile/bin directory. The default location for

<JazzSM_WAS_Profile> is /opt/IBM/JazzSM/profile.3. Run the following command:

./startServer.sh server_name

Where

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

Related tasks:“Starting Dashboard Application Services Hub services” on page 18

Stopping Jazz for Service Management application servers:

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

Procedure

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



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

Where


WAS_admin_user_nameThe default user name is smadmin.

WAS_admin_passwordThis is the password that is specified at the time of installation.

Example

stopServer.sh server1 -username smadmin -password jazzsmpwd


Starting the Special Event Management solutionBefore you begin

Copy <package>/Scripts/startSEMServer.sh and <package>/Scripts/stopSEMServer.sh to <TDI_HOME>/bin/

Change the permission of the script by using the following command:Chmod 755 startSEMServer.sh stopSEMServer.sh

Procedure1. Start the Jazz for Service Management. See “Starting Jazz for Service

Management application servers” on page 19.2. Start Tivoli Directory Integrator Derby database by using these steps:

a. Go to /opt/IBM/TDI/V7.1.1/bin.b. Start Tivoli Directory Integrator by using the following command:

./startSEMServer.sh

3. Login to Dashboard Application Services Hub. See “Logging in to the reportinginterface” on page 25

Running the Special Event Management dashboard reportsViewing the reports from Special Event Management dashboard.

About this task

Special Event Management package has these two reporting packages;Special_Event_Management_Dash.zip and Special_Event_Management_Cognos.zip.

Special_Event_Management_Cognos.zip file has a single Radio Capacity Report. Formore information on how to open this report, see “Running the Special EventManagement Cognos report” on page 23.


Procedure1. Log in to Dashboard Application Services Hub server where you have installed

the package as admin user that you have created at the time of installation. See“Logging in to the reporting interface” on page 25.

2. From the navigation bar, click Special Event Management > Special EventMonitoring Report. The Special Event Management widget opens as shown inthe following figure that shows the available Special Events and the CellCluster.

3. Click any cell to see the reports.Every cell has the following set of six reports:v Cell Dropv Cell Availabilityv Outgoing Inter-RAT HOv Intra LTE HOv DL Traffic Volumev UL Traffic Volume

4. Right-click a selected cell from an event to see the Radio Capacity report inCognos.

5. You can add, edit, or remove a special event from the dashboard by followingthese steps:a. Click Special Event Management > Special Event Administration.b. Click Add to add the details of a new event and enter the values for the

required fields:

Option Description

Special Event Name Name of the event. For example, RockConcert

Location Location of the event. For example, NationalStadium, Kuala Lumpur

Start Time Stamp Start time. This entry is for display purposeonly and does not affect the report.

End Time Stamp End time. This entry is for display purposeonly and does not affect the report.

Description Description of the event. For example, RockConcert to accommodate 10,000 people.


Option Description

Selected EutranCell Select the EnodeB and Eutrancell from theSelect Cell dialog.

c. Click Add.d. Optional: Click Edit to modify the event details.e. Optional: Click Remove to remove an event from the dashboard.

Deploying the Special Event Management Cognos solutionDeploying the Special Event Management solution on Dashboard ApplicationServices Hub for Wireless Component for Common Reporting.

Before you begin

Ensure that you have the following software installed:v Tivoli Netcool Performance Manager 1.4 Wireless Componentv Latest version of the Vendor Neutral Common Pack ibm.tnpm.lte.vn.v2.zip

v Jazz for Service Management v1.1.0.2v Extract the report package Special_Event_Management.zip and also the

Special_Event_Management_Cognos.zip files for this solution.

Getting started with common reportingProvides instructions on how to work with reports using IBM Cognos BusinessIntelligence Reporting. You are guided through the basic reporting tasks, withparticular emphasis on techniques that are unique to Performance Management.

Before you begin

Ensure that you have installed the latest version of the Vendor Neutral CommonPack ibm.tnpm.lte.vn.v2.zip.

About this task

This is a simple reference instruction for creating, publishing, importing, andrunning your reports.

Follow these steps to install the reports available in the package:

Procedure1. “Logging in to the reporting interface” on page 252. “Exporting Cognos report packages” on page 273. “Importing Cognos report packages” on page 27


Running the Special Event Management Cognos report

Procedure1. Log in to the Dashboard Application Services Hub reporting interface.2. Open the Special Event Management package in your Public Folders view.

You find the following report:v Radio Capacity Report

3. Click on the report and open it in a new tab.4. Select the required values from the following fields:

Option Description

Network Available networks that are monitored

Region Available regions

Market Available markets

EutranCell Available EutranCells

5. Click Finish and open the report.

Note: Click Allow blocked content in Internet Explorer to view the report.


Chapter 5. 4G and Legacy Networks Interoperability

This solution helps to assure customer experience by monitoring the 3G or 4Ghand over performance and seamless inter working with existing 3G or HSPA datanetwork.

Target persona

v NOC Engineersv Radio Optimization Engineers

Benefits

v Reduce the cost of managing networksv Ensure the transparent user experience across 2G, 3G and 4G LTE

Components

v LTE Vendor Neutral Technology Packv Cognos 10 model for LTE Vendor Neutral Technology Packv Cognos 10 reports

Getting started with common reportingProvides instructions on how to work with reports using IBM Cognos BusinessIntelligence Reporting. You are guided through the basic reporting tasks, withparticular emphasis on techniques that are unique to Performance Management.

Before you begin


Extract the report package 4G_and_Legacy_Networks_Interoperability.zip file forthis solution.

About this task


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

About this task

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


Access the reporting interface:

Dashboard Application Services Hub

Log in to the reporting interface from the Dashboard Application ServicesHub login page. Both Dashboard Application Services Hub and TivoliCommon Reporting are installed in the same application servingenvironment, and the reporting interface is integrated with DashboardApplication Services Hub.

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

Procedurev Access the reporting interface from Dashboard Application Services Hub as

follows:1. Open a web browser and enter the following URL for the Jazz™ for Service

Management UI and reporting server:https://host.domain:port/DASH_context_root

For example: https://myJazzSMserver.ibm.com:16311/ibm/consoleWhere:– host.domain is the fully qualified host name or IP address of the Jazz for

Service Management UI and reporting server.When single sign-on (SSO) is enabled, ensure that you use the fullyqualified host name in the URL of the Jazz for Service Managementreporting and UI server. SSO requires that the browser pass LTPA cookiesto the Jazz for Service Management application server, and these cookiescontain the fully qualified host name.

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

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

2. On the Dashboard Application Services Hub login page, enter the user IDand password. Ensure that user ID has access to Tivoli Common Reporting.Click Log in. The Dashboard Application Services Hub Welcome page opens.

3. In the navigation bar, click Reporting > Common Reporting.The Common Reporting portal is displayed within a Dashboard ApplicationServices Hub portlet page.

v Access the reporting interface directly as follows:1. Open a web browser and enter the following URL for the reporting interface:

http://host.domain:port/tarf/servlet/dispatch

For example: http://myJazzSMserver.ibm.com:16310/tarf/servlet/dispatchWhere:– host.domain is the fully qualified host name or IP address of the Jazz for

Service Management reporting server.

Note: When single sign-on (SSO) is enabled, ensure that you use the fullyqualified host name in the URL of the Jazz for Service Managementreporting server. SSO requires that the browser pass LTPA cookies to theJazz for Service Management application server, and these cookies containthe fully qualified host name.


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

Related tasks:“Exporting Cognos report packages”Export your report package to be able to use it for example, on a different TivoliCommon Reporting instance. You can use this method for Cognos reports only.“Importing Cognos report packages”Import report packages to your workspace using the user interface and start usingan existing report model and reports. This importing method can be used forCognos reports only.

Exporting Cognos report packagesExport your report package to be able to use it for example, on a different TivoliCommon Reporting instance. You can use this method for Cognos reports only.

Procedure1. Log in to the relevant reporting interface in your environment.2. In the reporting interface, select Launch > Administration.3. In the Configuration tab, select Content Administration in the navigation bar.4. To export the report package click New Export icon.

The New Export wizard opens.5. Enter the name for the report package and click Next.6. Accept the default settings and click Next on the subsequent pages.7. Select Save and run once, and then click Finish on the last page. The report

content is archived.Related tasks:“Logging in to the reporting interface” on page 25Depending upon your organization’s deployment of Tivoli Common Reporting,you can access the reporting interface directly or through Dashboard ApplicationServices Hub.

Importing Cognos report packagesImport report packages to your workspace using the user interface and start usingan existing report model and reports. This importing method can be used forCognos reports only.

Before you beginv Ensure that you have installed Tivoli Netcool Performance Manager 1.4.v Ensure that you have installed the Technology Pack.v Download Solution Pack 3.1.0.0 to your local file system. For more information,

see Chapter 2, “Downloading the Solution Pack 3.1.0.0,” on page 5.

Procedure1. Extract the report package ibm.tnpm.lte.vn.v2.zip.

Chapter 5. 4G and Legacy Networks Interoperability 27

2. Copy the reporting package in the Jazz for Service Management server in thefollowing location:<c10_location>/deployment. Where, c10_location is the Cognos installationpath. By default, /opt/IBM/JazzSM/reporting/cognos.

3. Log in to the relevant reporting interface in your environment.4. In the reporting interface, select Launch > Administration.5. In the Configuration tab, select Content Administration in the navigation bar.6. On the toolbar, click New Import icon.

The New Import wizard opens.7. Select the deployed reporting package, and then click Next.8. Use the default package name and click Next.9. Select the check box next to the package that must be deployed and click

Next.10. Accept the default settings and click Next on the subsequent pages.11. Select Save and run once, and then click Finish on the last page. By default,

the package is deployed to the Public Folders and the reports are available incontent store.

Related tasks:“Logging in to the reporting interface” on page 25Depending upon your organization’s deployment of Tivoli Common Reporting,you can access the reporting interface directly or through Dashboard ApplicationServices Hub.

Running the 4G and Legacy Networks Interoperability reportsViewing the 4G and Legacy Networks Interoperability reports

Procedure

Note: In a distributed environment, ensure that timezone is in sync on all theservers.1. Log in to the Dashboard Application Services Hub reporting interface. See

“Logging in to the reporting interface” on page 25.2. Open the 4G Legacy Networks Interoperability package in your Public

Folders view.You find the following reports:v Inter eRAN Handover Graphical Reportv Inter eRAN Handover Report by Cellv Inter eRAN Handover Report by RATv Inter eRAN Handover Tabular Report

3. Click on the report and open it in a new tab.4. Select the required values from the following fields:

Option Description






Note: Click Allow blocked content in Internet Explorer to view the report.

What to do next

You can export a report in HTML, PDF, CSV, Microsoft Excel 2007 formats, andXML. You cannot produce a report in CSV format if you have more than one querythat is defined in the report unless the additional queries are used for prompts.

Chapter 5. 4G and Legacy Networks Interoperability 29

Chapter 6. Network QoS Assurance

This solution provides the capability to assess the Network QoS performancetrends and identify worst performing cells by viewing the easily scheduled andinteractive Cognos Active Reports. Network Planner can analyze and review theQoS performance through the Quality channel indicator (QCI) - based trafficclasses on the radio access network by viewing the offline Active Report (NetworkQoS Report) scheduled weekly. Network Planner can assess the Network QoSperformance and identify worst performing cells by viewing the weekly scheduledoffline Active Report. They can compare the current report with historical report,and easily analyze the performance of access network.

You can view the QoS contribution of the radio network from theworst-contributing resources and worst-trending resources.

Target Persona

v Network Plannerv NOC Engineer

Benefits

v Improve customer experience by ensuring that the network meets datagrowth, new services and applications requirements.

v Enhance competitive positioning by helping the CSP retain customers,grow revenue through differentiated quality of service and userexperience.

Components

v LTE Vendor Neutral Technology PackFor more information about this Technology Pack, see the WirelessTechnology Pack Release Notes on IBM Knowledge Center for TivoliNetcool Performance Manager.

v Cognos 10 Model on LTE Vendor Neutral Technology PackThese are delivered under IBM COTS program and can also be used ascustom extensions by using Tivoli Netcool Performance Manager -Application Studio (NPM - AS). NPM - AS is bundled with TNPM 1.4software.

v Cognos 10 Active ReportsActive Report is an extension of the Cognos report that displaysimportant KPIs from business point of view. It leverages the existing anddashboard reports; converts them to active reports by adding interactivebehavior, and provides end users with an easy-to-consume interface.


Getting started with common reportingProvides instructions on how to work with reports by using IBM Cognos BusinessIntelligence Reporting. You are guided through the basic reporting tasks, withparticular emphasis on techniques that are unique to Performance Management.

Before you begin


Extract the report package Network_QoS_Assurance.zip file for this solution.

About this task


Follow these steps to install the reports available in the package:

Procedure1. “Logging in to the reporting interface” on page 252. “Exporting Cognos report packages” on page 273. “Importing Cognos report packages” on page 27

Running the Network QoS Assurance reportsViewing the Network QoS Assurance reports.

Procedure

Note: In a distributed environment, ensure that timezone is in sync on all theservers.1. Log in to the Dashboard Application Services Hub reporting interface. See

“Logging in to the reporting interface” on page 25.2. Open the Network QoS Assurance package in your Public Folders view. You

find the following reports:

Network QoS Assurance Report for EnodeBThis report helps the network planner to identify the maximum worstEnodeB in a region. This report empowers the customer to view andanalyze their network behavior of filtered worst behaving EnodeB. Thisreport shows the important performance metrics like IP Throughput,Packet Loss Rate and Latency, which helps to analyze the behavior ofthe EnodeB and to take a proactive action to provide good userexperience.

Network QoS Assurance Report for EutranCellThis report helps the network planner to identify the maximum worstperforming Cells in a region. This report empowers the customer toview their network behavior for up to 15 filtered worst behaving Cellsin a region. This report shows the important performance metrics likeIP Throughput, Packet Loss Rate and Latency which help them toanalyze the behavior of the Cells and to take a proactive action toprovide good user experience.


3. Click the Network QoS Assurance Report for EutranCell report and open it ina new tab.

Note: It might take sometime to open the report.4. Select the required values from the following fields:

Option Description




Worst Count Number of worst performing cells to bemonitored; 5, 10 or 15


Note: Click Allow blocked content in Internet Explorer to view the report.6. Optional: Save the report to your local file system as mhtml file and click OK.7. You can follow the steps 3 through 6 to run the Network QoS Assurance

Report for EnodeB report.8. You can schedule and email the active reports. See “Scheduling and emailing

an Active Report” on page 34.

What to do next

The report runs in IBM Cognos Viewer. You can send the Active Reports to aconfigured email and can be accessed offline with the same dashboard appearance.

Filtering criteria for the reportsFiltering is based on these parameters; Quality channel indicator (QCI) and trafficdirection.

QCI QCI traffic classes are used to specify the priorities and performanceattributes for different services offered to the customers. There are nineQCI classes. The details of each QCI class and its representation is asfollows:

QCI Service Description

1 Conversational Voice

2 Conversational Video (Live streaming)

3 Real Time Gaming

4 Non-conversational Video (Buffered streaming)

5 IMS Signalling

6 Buffered Video and TCP-based Services

7 Voice, Live Video, Interactive Gaming



All Represents the total value of performance metrics of all the QCI's at a time

Traffic direction

Chapter 6. Network QoS Assurance 33

An uplink is a connection from data communications equipment towardthe network core. This is also known as an upstream connection.

A downlink is a connection from data communications equipment towardsdata terminal equipment. This is also known as a downstream connection.

Note: There is no Uplink traffic for Highest IP Latency chart.

Scheduling and emailing an Active ReportScheduled reports run at specified times and can be automatically sent by email toa user or a mailing list or posted to an FTP site. For Network QoS Assurancereports, the scheduling is done weekly.

About this task

The procedure here explains emailing the reports automatically. You can email thespecific reports manually also. For more information, see Emailing reports.

Procedurev Log in to the reporting interface.v Select the report that you want to schedule and email. For example, select the

Network QoS Assurance Report for EutranCell report.v On the toolbar, click the Schedule button for the report entry you want to

schedule.v Under Frequency, select By Week, and then select Day.v Under Start, select the last day of the current month as the day you want the

monthly schedule to start.v Under End, click End by and select the last day of the same month next year as

the day you want the weekly schedule to end.v Click OK.v Click the Use my credentials link to make you the schedule owner.

Under Credentials, the name of the current schedule owner appears.

Note: If you are logged on as an anonymous user, information about thecurrent schedule owner is not available.

v Under Options, click Override the default values.v Select the Send a link to the report by email check box and click Edit the

options.v In the Set the email options window, specify the required fields and select the

Include a link to the report check box.v Click OK. The Active Report is sent to the recipient's email address as an mhtml

file to be viewed any time.Related information:

Scheduling reports


http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.2/com.ibm.psc.doc_1.1.0.2/tcr_original/ttcr_emailing.html?lang=en

http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.2/com.ibm.psc.doc_1.1.0.2/tcr_original/ttcr_schedules.html?cp=SSEKCU_1.1.0.2%2F7-1-0-6&lang=en

Chapter 7. Comprehensive Report Launchpad

This solution provides the new capability for TNPM Users to navigate to a reportof their interest from the installed Wireline Technology Packs by using theDashboard Application Services Hub feature that is introduced in Tivoli NetcoolPerformance Manager 1.4. You can also add your most used reports to MyFavorites on the Dashboard Application Services Hub UI.

Wireline technology packs can be grouped into seven main technologies:v Device Managementv Service Managementv Access/Transmissionv MPLS Service/Metro Ethernetv SLA and QoSv Cablev IP Telephony

Target PersonaTNPM Users

Benefits

v Easy navigation to a particular report of interest with just a few clicksv Ability to save the most used reports to My Favorites for repeated use

Components

v Wireline Technology PacksCurrently, the following packs are available for integrating into thisComprehensive Report Launchpad Solution:– MIB-II– Arris DOCSIS 3.0– ALU 5620 SAM– Huawei U2000

v Special Dashboard Application Services Hub (DASH) pages that areintegrated on Jazz for Service Management server

v Data integration by using Tivoli Directory Integrator (TDI) on Jazz forService Management

Deploying solution pack report launchpad on Dashboard ApplicationServices Hub for Wireline Component

Ensure that you have installed the following software:v Tivoli Netcool Performance Manager 1.4 Wireline Componentv Relevant Database. For more information on Tivoli Netcool Performance

Manager Wireline Component requirements, see Configuration Recommendations.v Jazz for Service Management 1.1.0.2v Wireline technology packs


Preparing the Tivoli Directory Integrator environmentInstall Tivoli Directory Integrator 7.1.1 Fix Pack 2 and overwrite the OSGI plugins.

Before you begin

For more information about the requirements for Tivoli Directory Integrator, seehttp://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/adminguide11.htm?path=8_11_0_4_4_0#wq20

About this task

The Tivoli Directory Integrator installation media and fix pack are provided withthe Jazz™ for Service Management installation media.

You can install Tivoli Directory Integrator on the same server on which DashboardApplication Services Hub is installed.

Procedure1. Install Tivoli Directory Integrator Version 7.1.1.2. The Tivoli Directory Integrator installation media is in the TDI7.1.1

subdirectory of the extracted Jazz for Service Management installation image onyour local file system.

3. Install Tivoli Directory Integrator Version 7.1.1 Fix Pack 2. For more informationabout applying the fix pack, see the 7.1.1-TIV-TDI-FP0002.README file in the fixpack directory. The Tivoli Directory Integrator fix pack is located in theTDI7.1.1FP2 subdirectory of the extracted Jazz for Service Managementinstallation image on your local file system.

4. Back up the following JAR files in the <TDI_HOME>/osgi/plugins directory.v com.ibm.di.api.bind.jar

v com.ibm.di.api.rest.jar

By default, <TDI_HOME> is /opt/IBM/TDI/V7.1.1.5. Copy the com.ibm.di.api.bind.jar and com.ibm.di.api.rest.jar files from the

DASH_Home/installableApps to the TDI_HOME/osgi/plugins directory.6. Stop the Tivoli Directory Integrator server or the Configuration Editor. Then,

start the Tivoli Directory Integrator server by starting the Configuration Editor.For more information, see Introducing IBM Tivoli Directory Integrator.

Related concepts:“Using Tivoli Directory Integrator as a data provider” on page 10You can populate widgets with data from data sets provided by IBM TivoliDirectory Integrator.Related information:

IBM Tivoli Directory Integrator, Version 7.1.1 Information Center





http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/intro_tdi_chap2.htm

http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1.1/welcome.htm

http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0/integrate/tip_c_integrate.html

Installing Tivoli Directory IntegratorThe Tivoli Directory Integrator installer allows you to install Tivoli DirectoryIntegrator 7.1.1 in its entirety, only those Tivoli Directory Integrator componentsthat you need, upgrade a previous version of Tivoli Directory Integrator (versions6.0, 6.1, 6.1.1, 7.0, or 7.1), or add features to an existing Tivoli Directory Integrator7.1.1 installation.

About this task

Installing Tivoli Directory Integrator 7.1.1 uninstalls a previous version; theuninstallation does not remove any files that the user has created. User createdfiles are still available after the new installation completes. Configuration files suchas global.properties and am_config.properties are migrated to Tivoli DirectoryIntegrator 7.1.1, keeping any custom configuration changes that have been made.The Tivoli Directory Integrator 7.1.1 installation continues to use the featuresavailable in previous versions of Tivoli Directory Integrator:v Administration and Monitoring Console (AMC)v Configuration Editor (CE)v Examplesv IBM User Interface Help System built on Eclipsev Java API Documentationv Runtime Server

Procedure1. Launch the installer directly by using the installation executable file as follows:

Linux 64-bitinstall_tdiv711_linux_x86_64.bin

2. Double-click the executable file, or type the executable file name at thecommand prompt. This launches the installer. The installer is launched. Forinformation on how to use the installer, see Using the platform-specific TDIinstaller.


Preparing the Tivoli Directory Integrator environment

Importing Wireline Dashboard Application Services Hub pagesIBM Dashboard Application Services Hub allows you to create custom dashboardpages. A page is an arrangement of one or more widgets in the work area of theconsole. A widget is a user interface component that displays information in aconsole dashboard. Dashboard Application Services Hub provides a set ofpredefined widgets. Each widget is configured to retrieve information from a dataprovider that has a connection defined in Dashboard Application Services Hub.Each data provider divides its information into data sets.

Before you begin

For detailed information on predefined widgets, how to edit and customize eachwidget type, and how to create catalogs and pages with widgets, see theDashboard Application Services Hub online help or Jazz for Service ManagementIntegration Guide.

Chapter 7. Comprehensive Report Launchpad 37



http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=%2Fcom.ibm.psc.doc_1.1.0%2Fintegrate%2Ftip_t_integrate_install_tdi.html

About this task

Describes the steps to import the packaged Dashboard Application Services Hubpages:

Procedure1. Import the following Dashboard Application Services Hub data packages by

running the consolecli commands:

Note: The consolecli commands are entered from the DASH_HOME/bin directory../consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Report_Folder.zip--username <WAS_admin_user_name> --password <WAS_admin_password>--excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Report_Launch_Pad.zip--username <WAS_admin_user_name> --password <WAS_admin_password>--excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/ DASH_Report_Category.zip--username <WAS_admin_user_name> --password <WAS_admin_password>--excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Report_Page.zip--username <WAS_admin_user_name> --password <WAS_admin_password>--excludePlugins TCRImportPlugins

./consolecli.sh Import --importFile <package>/DASH_Pages/DASH_Report_Launch_Administration.zip--username <WAS_admin_user_name> --password <WAS_admin_password>--excludePlugins TCRImportPlugins

2. Extract the imported Dashboard Application Services Hub data packages asfollows:a. Go to DASH_Profile/installedApps/JazzSMNode01Cell folder. The default

location for DASH_Profile is /opt/IBM/JazzSM/profile.b. Extract the custom pages by using the following command:

tar xvf <package>/Custom_Pages/DASH_Custom_Pages.tar



Special Tivoli Directory Integrator tables definitionsSpecial Tivoli Directory Integrator tables must be created with these fields. Thesetables must be created in Derby database.

UC4_REPORTLIST table definitionCATEGORY_IDSUBCATEGORY_IDREPORT_IDTECHPACK_IDURL

Creating and importing tables in Derby databaseProcedure1. Create the Derby table by using the following steps:

a. Go to the /opt/IBM/TDI/V7.1.1/bin folder and run the following command:./startNetworkServer.sh

b. Set the CLASSPATH to the derbyclient.jar:derbytools.jar that isavailable in /opt/IBM/TDI/V7.1.1/jars/3rdparty/IBM by using the followingcommand:


http://pic.dhe.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.psc.doc_1.1.0.2/integrate/tip_c_integrate.html

export CLASSPATH=derbyclient.jar:derbytools.jar

c. Run Derby by using the following command:java org.apache.derby.tools.ij

d. Connect and create a new database called DASH_REPORT_LAUNCHPAD by usingthe following command:connect ’jdbc:derby://<server.ibm.com>:1527/DASH_REPORT_LAUNCHPAD;create=true’;

e. Create UC4_REPORTLIST table by using the SQL command:CREATE TABLE UC4_REPORTLIST(CATEGORY_ID VARCHAR(100) NOT NULL,SUBCATEGORY_ID VARCHAR(100) NOT NULL,REPORT_ID VARCHAR(100) NOT NULL,TECHPACK_ID VARCHAR(100) NOT NULL,URL VARCHAR(1024) NOT NULL) ;

2. Update the table manually from CSV file with the following information:Import the report information based on the selected techpack.1) ALU_5620_SAM.csv2) Arris_CMTS_Docsis.csv3) Huawei_U2000.csv4) MIB_II.csvCALL SYSCS_UTIL.SYSCS_IMPORT_TABLE(null,’UC4_REPORTLIST’,’<package>/report_list_cofiguration/<selected techpack>.csv’,’,’,null,null,0);

Starting Dashboard Application Services Hub services

Procedure1. Start Jazz for Service Management.2. Start Tivoli Directory Integrator derby database by using these steps:

a. Go to /opt/IBM/TDI/V7.1.1/bin.b. Start Tivoli Directory Integrator from command line by using

startSEMServer.sh file.c. Optional: Stop Tivoli Directory Integrator from command line by using

stopSEMServer.sh file.3. Login to Dashboard Application Services Hub from the following URL:

https://<server.ibm.com>:16311/ibm/console/

For more information, see “Logging in to the reporting interface” on page 25.Related tasks:“Starting Jazz for Service Management application servers” on page 19You 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.“Stopping Jazz for Service Management application servers” on page 19You 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.

Starting Jazz for Service Management application servers:

You can start any Jazz for Service Management virtualization and reporting serversby using the IBM WebSphere startServer command. You might need to restart the


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

Procedure

1. On the relevantJazz for Service Management server, open a command window.2. Change to the JazzSM_WAS_Profile/bin directory. The default location for


./startServer.sh server_name

Where



Stopping Jazz for Service Management application servers:

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

Procedure

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


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

Where


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


Importing Tivoli Directory Integrator configurationAbout this task

For more information about this task, see http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/index.jsp?topic=%2Fcom.ibm.IBMDI.doc_7.1.1%2Fadminguide10.htm&path=7_4_4

Procedure1. Click IBM Tivoli Directory Intergrator v7.1.1 > Start Configuration Editor.2. Specify a workspace in your local file system.3. Click Create IBM Tivoli Directory Integrator Project and create a project by

name DASH_REPORT_LAUNCHPAD.4. Import the file from <package>/TDI_Conf.xml into the project.5. Drag and drop the project to running server. The Servers panel displays the

status of all configured Servers. You can see by the arrow icon next to'Default.tdiserver' that this Server has been started for you. This panel alsoprovides buttons for defining new Servers, Starting and Stopping your Servers,as well as for refreshing the list and view a Server's log.

6. Click Finish.

What to do next

Refresh the Dashboard Application Services Hub and Tivoli Directory Integratorconnection by using the following steps:1. Login to Dashboard Application Services Hub from the following URL:

https://<server.ibm.com>/:16311/ibm/console/

2. Go to Setting > Connections.3. Select Tivoli Directory Integrator and click Edit.4. Click the save button on the Configure TDI connection page.

Starting the Report Launchpad solutionBefore you begin

Copy <package>/Scripts/startRLPServer.sh and <package>/Scripts/stopRLPServer.sh to <TDI_HOME>/bin/

Change the permission of the script by using the following command:chmod 755 startRLPServer.sh stopRLPServer.sh

Procedure1. Start the Jazz for Service Management. See “Starting Jazz for Service

Management application servers” on page 19.2. Start Tivoli Directory Integrator Derby database by using these steps:

a. Go to /opt/IBM/TDI/V7.1.1/bin.


http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/index.jsp?topic=%2Fcom.ibm.IBMDI.doc_7.1.1%2Fadminguide10.htm&path=7_4_4



b. Start Tivoli Directory Integrator by using the following command:./startWLPServer.sh

3. Login to Dashboard Application Services Hub. See “Logging in to the reportinginterface” on page 25

Running the reports from Report LaunchpadViewing the reports from the Comprehensive Report Launchpad.

Procedure1. Log in to Dashboard Application Services Hub. See “Logging in to the

reporting interface” on page 25.2. From the navigation bar, click Report Launchpad > Report Launchpad. TNPM

Report Launchpad that contains the report group categories opens as shown inthe following figure:

3. Click a report group or technology of your choice. For example, click DeviceManagement to see the Report Category and the Reports under that category.

4. Click a report from the ReportList to see the report. The legacy DataViewreports open in DataView and the Cognos reports open in IBM CognosBusiness Intelligence.

5. Add the report to your favorites by following these steps:a. Click Report Launchpad > Report Launchpad Aministration.b. Click a report of your choice from the Available Report List and click

Refresh. The selected report appears in the Favorite Report pane.

Report List ConfigurationThe Report List Configuration provides the mapping between wireline technologiesand report content category under which a particular report falls into. Reportgrouping categorizes the performance measure into a few common areas within atechnology, for example packet health and traffic, hardware performance or serviceQoS that have a few reports under them.

The Report List Configuration Zip file contains CSV files that lists all the reportsavailable out-of-the-box for each category. Currently, the Report List Configurationzip file contains four CSV files with the following mapping information:v Wireline technology (Device Management, Service/Application Management,

QoS, VoIP, Cable, Access and Metro Ethernet)


v Report Group Report (Cognos or Legacy DataView)v Technology Packv Link to the report to which this information is mapped to

Table 3. Supported technology packs

Technology pack Version

Alcatel-Lucent 5620 SAM 2.14.0.0

Arris CMTS DOCSIS 3.0 2.3.0.0

Huawei U2000 2.1.0.0

MIB-II 2.4.0.0

Note: This file is frequently updated as we add more technology packs and theirreport groups for the Report Launchpad support. The latestReport_List_Cofiguration.zip file is available on the developerWorks from here:https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Report%20List%20Configuration


https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Report%20List%20Configuration



Chapter 8. Troubleshooting the solution pack

Troubleshooting information for solution packs helps you understand, isolate, andresolve problems.

To resolve a problem on your own, you can find out how to identify the source ofa problem, how to gather diagnostic information, and which knowledge bases tosearch. If you need to contact IBM Support, you can find out what diagnosticinformation the service technicians need to help you address a problem.

Some of the known issues that you might notice when you install and use theSolution Pack 3.1.0.0:

4G and Legacy Networks Interoperabilityv Do not press Tab to navigate from one field to another in the 4G and Legacy

Networks Interoperability prompt page. Use mouse to navigate instead forselecting the values for Network, Region, and Market.

Special Event Managementv Date and timestamp are not seen as a tooltip on the six graphs of cell details in

the Special Event Management reports as this is a Dashboard ApplicationServices Hub widget limitation.

v You cannot close the Cell details page does from close control on the specialevents monitoring page from main menu to navigate to another page. You mustlog in to the Dashboard Application Services Hub again to go to another page.

v When you open Cell details page from any cell in Special Event Managementreports, you might see the Call drop graph upside down with wrong x axis andy axis. This is an intermittent issue.

v When you click the maximize control on cell details page in Special EventManagement reports, the report does not fit to the page.

v For best rendering of Cell details reports, do not use Internet Explorer. For moreinformation about browser support, see “Supported configurations” on page 7.

v When you drill-through the reports in Internet Explorer 8, the reports open in asingle tab. When you drill-through the reports in Internet Explorer 9, the reportsopen in different tabs.

Network QoS Assurancev Do not press Tab to navigate from one field to another in the Network QoS

Assurance prompt page. Use mouse to navigate instead for selecting the valuesfor Network, Region, Market, and Worst Count.

v If the two values are very close for current and historical week and if they areoverlapping in the reports, then you can see only the current value when youpoint to the report.

v When you hover the mouse on the graphs for the reports, the value that it isdisplaying is the base unit and not the unit that is mentioned in the charts.

v Radio buttons do not work in the Mozilla Firefox ESR 17.0.1. Report name, Date,and Labels do not appear in Mozilla Firefox ESR 17.0.1.


Report Launchpadv When you try to open the reports in separate tabs, all reports open in the same

tab. This is seen in reports from all four use cases.v All reports are displayed in the same Report tab. This is a limitation in

Dashboard Application Services Hub as the report name cannot be changedduring run time.

v Report titles are not displayed correctly in Internet Explorer 8 and 9 inCompatibility View.


Appendix. Common directory locations for Jazz for ServiceManagement

Jazz™ for Service Management topics use path name variables for paths to commondirectories, for example, home directories.

Jazz for Service Management home directory

The JazzSM_HOME variable describes the location where Jazz for ServiceManagement is installed. This location can be specified during installation. If notspecified, the following default locations are used:

v

v Root user installations: /opt/IBM/JazzSMv Non-root user installations: <user_home_dorectory>IBM/JazzSM

Jazz for Service Management profile directory

The JazzSM_WAS_Profile variable describes the location of the application serverprofile that is used for Jazz for Service Management. This location is in the/profile/ subdirectory of the Jazz for Service Management home directory.

v

v Root user installations: /opt/IBM/JazzSM/profilev Non-root user installations: <user_home_dorectory>IBM/JazzSM/profile

Jazz for Service Management profile name

The JazzSM_Profile_Name variable refers to the name assigned to the WebSphere®

Application Server profile for Jazz for Service Management. The default name isJazzSMProfile.

Installation images home directory

The Install_Imgs_Home variable describes the common root directory that containsthe extracted contents of the installation images depending on the installationscenario.

Full installationIBM DB2®, IBM WebSphere Application Server, and IBM Tivoli CommonReporting if you want to install Tivoli Common Reporting during the fullinstallation flow.

Attention: You must extract the contents of the installation media for thissoftware to the same common root directory, otherwise the full installationdisplays error messages for missing software.

Custom installationIBM WebSphere Application Server, if you do not want to use an existinginstallation; Tivoli Common Reporting if you want to install it after acustom installation of the other integration services.


Note: It is not necessary to extract the contents of the installation mediafor this software to the same common root directory, but it is preferable tomaintain all extracted installation media in a central location.

Jazz for Service Management installation images home directory

The JazzSM_Image_Home variable describes the common root directory in which theJazz for Service Management is extracted. It contains the launchpad, IBMInstallation Manager, IBM Prerequisite Scanner, the Installation Manager repositorywith the software packages for the integration services except Tivoli CommonReporting.

Tip: Ensure that the path to the JazzSM_Image_Home directory does not contain anyspaces or special characters, otherwise the launchpad does not start.

IBM DB2 home

The DB2_HOME variable describes the location where IBM DB2 is installed. Thislocation was specified during installation. If not specified, the following defaultlocations are used:

v

v Root user installations: /opt/ibm/db2v Non-root user installations: $HOME/sqllib

$HOME represents the non-root user's home directory.

WebSphere Application Server home directory

The WAS_HOME variable describes the location where WebSphere Application Serveris installed. This location was specified during installation. If not specified, thefollowing default locations are used:

v

v Root user installations: /opt/IBM/WebSphere/AppServerv Non-root user installations: <user_home_dorectory>IBM/WebSphere/AppServer

Administration Services home directory

The ADMIN_HOME variable describes the location where Administration Servicesis installed. This location can be specified during installation. If not specified, thefollowing default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/adminv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/admin

Administration Services UI home directory

The ADMINUI_HOME variable describes the location where Administration Services UIis installed. This location can be specified during installation. If not specified, thefollowing default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/adminuiv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/adminui


Registry Services home directory

The REGISTRY_HOME variable describes the location where Registry Services isinstalled. This location can be specified during installation. If not specified, thefollowing default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/registryv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/registry

Security Services home directory

The SECURITY_HOME variable describes the location where Security Services isinstalled. This location can be specified during installation. If not specified, thefollowing default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/securityv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/security

Dashboard Application Services Hub home directory

The DASH_HOME variable describes the location where Dashboard ApplicationServices Hub is installed. This location can be specified during installation. If notspecified, the following default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/uiv Non-root user installations: <user_home_dorectory>IBM/JazzSM/ui

Dashboard Application Services Hub profile directory

The DASH_Profile variable describes the location of the application server profilethat is used for Dashboard Application Services Hub. This location is inthe/profiles/ subdirectory of the Jazz for Service Management home directory.

v

v Root user installations: /opt/IBM/JazzSM/profilev Non-root user installations: <user_home_dorectory>IBM/JazzSM/profile

Tivoli Common Reporting home directory

The REPORTING_HOME directory that contains the uninstallation program, theinstallation log files, and Tivoli Common Reporting component files. If notspecified, the following default locations are used:

v

v Root user installations: /opt/IBM/JazzSM/reportingv Non-root user installations: <user_home_dorectory>IBM/JazzSM/reporting

IBM Cognos® installation directory

The c10_location directory that contains the Cognos® installation. If not specified,the following default locations are used:

Appendix. Common directory locations for Jazz for Service Management 49

v

v Root user installations: /opt/IBM/JazzSM/reporting/cognosv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/reporting/

cognos

Full installation log directory

The Simple_install_log_dir directory into which general and offering specific logsare created during full installation:

v

v On UNIX systems: $HOME/jazzsm_launchpad/logs/

IBM Prerequisite Scanner installation directory

The ips_root directory that contains the contents of the extracted PrerequisiteScanner platform package. If not specified, the default locations are used:

v

v On UNIX systems: Install_Imgs_Home/PrereqScanner/UNIX_Linux


Notices

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

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment to


IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. You may copy,modify, and distribute these sample programs in any form without payment toIBM for the purposes of developing, using, marketing, or distributing applicationprograms conforming to IBM's application programming interfaces.

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

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

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

Trademarks

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

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registeredtrademarks or trademarks of Adobe Systems Incorporated in the United States,other countries, or both.

IT Infrastructure Library is a registered trademark of the Central Computer andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

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

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

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

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

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

Notices 53

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

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

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


��

Printed in USA

installing and using solution packs - ibm · 2014-05-03 · installing and using solution packs....

Documents