IBM Tivoli Netcool Performance Manager 1.4Document Revision R2E1

Getting Started with CommonReporting

���

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

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

Contents

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

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

Chapter 1. Common Reporting on TivoliNetcool Performance Manager . . . . . 1Tivoli Common Reporting . . . . . . . . . . 1

Tivoli Common Reporting components . . . . 2Administering Dashboard Application Services Hub 3

Logging in to the reporting interface in TivoliNetcool Performance Manager . . . . . . . 4

Authoring a web-based report . . . . . . . . 6Using Tivoli Common Reporting template . . . 6Report Specifications . . . . . . . . . . 7Creating Reporting Models and Packages . . . . 7

Performing ad-hoc reporting . . . . . . . . . 9

Chapter 2. Reports containing bothWireless and Wireline data . . . . . . 11

Chapter 3. Getting started with Wirelinereports. . . . . . . . . . . . . . . 13Wireline data source . . . . . . . . . . . 13Creating a report . . . . . . . . . . . . 13Emailing reports . . . . . . . . . . . . . 14Scheduling reports . . . . . . . . . . . . 15Cognos Active Reports . . . . . . . . . . 16Dashboard reports . . . . . . . . . . . . 17Design considerations for Wireline report authors . 17

Modifying timestamps in custom charts to roundup to minutes instead of milliseconds . . . . 18Conforming to Cognos reporting guidelines . . 18Microsoft Excel formatting limitations . . . . 18

Chapter 4. Getting started withWireless reports . . . . . . . . . . 19Authoring a simple report . . . . . . . . . 19Authoring an efficient report . . . . . . . . 20Authoring a drill-down report . . . . . . . . 22Authoring a charting report . . . . . . . . . 23Drill-through reports . . . . . . . . . . . 25

Authoring a drill-through target report . . . . 25Authoring a drill-through source report . . . . 26

Including multiple granularity items in the samereport . . . . . . . . . . . . . . . . 29

Displaying multiple granularity items withdrill-down only . . . . . . . . . . . . 29Displaying multiple granularity items with drillup and drill down . . . . . . . . . . . 30UDC calculations and drill downs . . . . . . 31

Chapter 5. Known Common Reportingissues . . . . . . . . . . . . . . . 33

Appendix. Common directory locationsfor Jazz for Service Management1.1.0.3 . . . . . . . . . . . . . . . 35

Notices . . . . . . . . . . . . . . 39Terms and conditions for product documentation. . 41Trademarks . . . . . . . . . . . . . . 42

© Copyright IBM Corp. 2011, 2015 iii

iv IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Introduction

The IBM® Cognos® Business Intelligence Reporting application provides the Tivoli®

Common Reporting interface with several advanced reporting functions.

Getting Started with Common Reporting describes how to get started with CommonReporting in IBM Tivoli Netcool® Performance Manager Wireline and WirelessComponents.

With Tivoli Common Reporting, you can run and view reports in different reportformats, on your desktop or mobile devices. You can email reports and work withreports offline.

You can access the reporting interface directly from the Cognos CommonReporting URL, through Dashboard Application Services Hub, or through a Tivoliproduct’s user interface.

Service Management ConnectConnect, learn, and share with Service Management professionals: product supporttechnical experts who provide their perspectives and expertise.

Access Network and Service Assurance community at https://www.ibm.com/developerworks/servicemanagement/nsa/index.html. Use Service ManagementConnect in the following ways:v Become involved with transparent development, an ongoing, open engagement

between other users and IBM developers of Tivoli products. You can access earlydesigns, sprint demonstrations, product roadmaps, and prerelease code.

v Connect one-on-one with the experts to collaborate and network about Tivoliand the Network and Service Assurance community.

v Read blogs to benefit from the expertise and experience of others.v Use wikis and forums to collaborate with the broader user community.Related information:

Tivoli Netcool Performance Manager 1.4 community on developerWorks

Tivoli Netcool Performance Manager technical trainingFor Tivoli Netcool Performance Manager technical training information, see thefollowing Tivoli Netcool Performance Manager Training website at:https://tnpmsupport.persistentsys.com/training.

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

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

© Copyright IBM Corp. 2011, 2015 v

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

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

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

Typeface conventionsThis publication uses the following typeface conventions:

Bold

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

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such as Tip:, and Operating system considerations:)

v Keywords and parameters in text

Italic

v Citations (examples: titles of publications, diskettes, and CDs)v Words defined in text (example: a nonswitched line is called a

point-to-point line)v Emphasis of words and letters (words as words example: "Use the word

that to introduce a restrictive clause."; letters as letters example: "TheLUN address must start with the letter L.")

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

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

Monospace

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

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

Bold monospace

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

v Environment variable names in textv Keywords

vi IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

v Parameter names in text: API structure parameters, commandparameters and arguments, and configuration parameters

v Process namesv Registry variable names in textv Script names

Introduction vii

viii IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Chapter 1. Common Reporting on Tivoli Netcool PerformanceManager

An overview of Common Reporting for Tivoli Netcool Performance Manager 1.4users through the Dashboard Application Services Hub in Jazz for ServiceManagement V1.1.0.3. Both Dashboard Application Services Hub and TivoliCommon Reporting are installed in the same application service environment, andthe reporting interface is integrated with Dashboard Application Services Hub.Related information:

Jazz for Service Management overview

Using Tivoli Common Reporting

Tivoli Common ReportingReporting Services is an integration service for users to administer, run, edit, andcreate Tivoli reports. It is a follow-on implementation of the Tivoli CommonReporting component. Reporting Services provide web-based, launch-in-contextreport administration, and editing.

Use the Common Reporting to publish, find, manage, organize, and view yourorganization’s Business Intelligence content, such as reports, scorecards, andagents. If you have the necessary permissions, you can access the Report Studioand Query Studio or access the administration functions for contentadministration, including scheduling and distributing reports, and creating jobs.

With Tivoli Common Reporting, you get the following advantages:

Simplified interactionSimplified interfaces and interactions for report writers to create,customize, and publish reports faster and easier. Reporting workspaces,with free form layout, allows users drag sections from different reports tocreate workspaces with reporting content and enhance interactivity.

Powerful report formatsBuilt-in interactivity that is provided by Active Reports format. Email usersan active report, which has interactive functions that the users can useoffline. Interactive functions include clickable charts, sorting, tabs, andradio buttons, and check box filtering.

Trending capabilitiesSupports trending to a report by using bar, line, area, bubble, and scattercharts, and with just a few clicks. Supports averages across series or foreach series.

Mobile device supportSupports viewing and running reports on mobile devices, including AppleiPad, iPhone, Android, BlackBerry, and Windows. Uses native applicationsfor iPad and BlackBerry. Users can also interact offline with Active Reportswith the iPad application.

On-demand and self-service reportingBridges gap between business and professional report authors. Enablereport users to create and save multi-query ad hoc reports through the

© Copyright IBM Corp. 2011, 2015 1

drag features, without the need for professional report writer’sinvolvement. Supports enhanced user experience through easymodification of layout and format. Users can drag and resize widgets.They can filter data with a few clicks. Users can choose from a greatervariety of charts to support trending. Compatible with IBM Cognos ReportStudio.

Cross-product report linkingExtends the capability of cross-product report linkage for seamless flowbetween related reports of various Tivoli products.

Robust Reporting EngineSimplified configuration with Java™ Database Connectivity (JDBC) support.Optimized SQL generation of complex queries for better runtimeperformance.

Related information:

Tivoli Common Reporting

Getting started with reports

Tivoli Common Reporting componentsTivoli Common Reporting consists of data stores, reporting engines, theircorresponding web user interfaces, and a command-line interface. Tivoli CommonReporting provides a flexible structure that can be adapted for load balancing.

The core components are as follows:

Cognos-based Tivoli Common Reporting engineThe dispatcher is the entry point for IBM Cognos service requests sent by aweb server gateway or other software. The dispatcher handles the routingrequests and balances the load of user requests to the various IBM Cognosservices.

Cognos gatewayA portal for communication between Tivoli Common Reporting Server andthe Cognos-based Tivoli Common Reporting engine.

Cognos Content StoreA database that contains data that IBM Cognos uses to operate. The datacomprises report specifications, published models, and the packages thatcontain them; connection information for data sources; information aboutthe external namespace, and the Cognos namespace itself; and informationabout scheduling and bursting reports.

Common Reporting user interfaceA web user interface that provides a portal for IBM Cognos and acomponent that interacts with the Cognos Content Store. The user interfaceis used to publish, find, manage, organize, and view organization's reports.You can access the reporting interface directly from the Cognos CommonReporting URL, through Dashboard Application Services Hub, or througha Tivoli product’s user interface.

IBM Cognos MobileAn application that provides mobile device support in Tivoli CommonReporting. After Cognos Mobile is installed in the same application serviceenvironment as Tivoli Common Reporting, users can run and view reportsanywhere or any time on their mobile devices such as smartphones or

2 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

tablet computers. It is bundled with Tivoli Common Reporting on theTivoli Common Reporting installation media.

IBM Cognos Framework ManagerA modeling tool to create data models. It is shipped with Jazz for ServiceManagement, on its own installation media.

IBM Cognos Business Intelligence ReportingTivoli Common Reporting is based on Cognos Business IntelligenceReporting version 10.2. The following Cognos components are availablewith Tivoli Common Reporting:v Query Studio - a reporting tool for creating simple queries and reports.v Report Studio - a web-based tool for creating sophisticated reports

against multiple databases.v Event Studio - a web-based tool for monitoring data to detect business

events and to performs tasks when those events occur, such as sendingemails or running reports.

v Connection - an application where you can view and manage all yourreports.

v Workspace - a web-based tool for authoring simple reports andexploring your data.

v Workspace advanced - a tool for performing advanced data analysis andcreating reports with various data sources.

Related information:

IBM Tivoli Common Reporting on developerWorks

IBM Cognos Customer Center.

Administering Dashboard Application Services HubDashboard Application Services Hub administration tasks include setting up theconsole, managing users, exporting and importing data, and configuring the typeof mobile devices to use the mobile version of the console.

About this task

If Dashboard Application Services Hub and Administration Services are installed inthe same Installation Manager software package group, that is, the JazzSM_HOMEdirectory, the following actions occur:v Dashboard Application Services Hub is registered a managed resource with the

Administration Services administration service provider.v The Dashboard Application Services Hub task bundle is also installed. This task

bundle contains tasks to administer and implement best practices for DashboardApplication Services Hub.

You can run these administration tasks by using the Administration Services CLIor UI. Depending on the administration task, you might have to restart theDashboard Application Services Hub application or the Jazz for ServiceManagement application server in which it is installed.

Dashboard Application Services Hub also provides a command-line interface towork with console elements such as dashboards, views, widgets, charts, andpreference profiles. You can run commands to list these elements, list roles that are

Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 3

assigned to them, then add or delete roles. The CLI also provides import andexport commands.Related information:

Administering Dashboard Application Services Hub

Dashboard Application Services Hub command reference

Logging in to the reporting interface in Tivoli NetcoolPerformance Manager

You can access the reporting interface directly or through Dashboard ApplicationServices Hub.

Before you begin

Ensure that you have the appropriate login credentials from your administrator.

About this task

With the Common Reporting interface, you can perform simple lightweight tasksand more advanced scalable reporting that is provided by IBM Cognos BusinessIntelligence Reporting.v Create on-demand reports.v Use the web-based report authoring.v Email reports.

Tip: To access the Cognos documentation, click in the reporting interface.

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 serviceenvironment, and the reporting interface is integrated with DashboardApplication Services Hub.

Access is determined by user roles that are associated with user IDs. Therole that you need to access Tivoli Common Reporting istcrPortalOperator. See Authentication and authorization in TivoliCommon Reporting.

Direct accessLog in to the reporting interface from its own login page.

Tivoli product’s user interfaceLog in to the reporting interface from a Tivoli product’s login page. TivoliCommon Reporting is integrated with a Tivoli product.

Procedurev Access the reporting interface from Dashboard Application Services Hub as

follows:

4 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

1. Open a web browser and enter the following URL for the Jazz for ServiceManagement UI and reporting server:https://host.domain:port/DASH_context_root

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

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

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

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

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

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

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

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

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

Service Management reporting server.

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

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

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

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

v Access the reporting interface from a Tivoli product’s user interface. WirelineDataView component is installed on the same server as the Jazz for ServiceManagement server.

Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 5

Authoring a web-based reportCreate reports in a web-based tool that professional report authors use to buildsophisticated, multiple-page, multiple-query reports against multiple databases.You can create any reports that your company requires, such as invoices,statements, and weekly sales and inventory reports.

Procedure1. Log in to the reporting interface. See “Logging in to the reporting interface in

Tivoli Netcool Performance Manager” on page 42. In the reporting interface, select Launch > Report Studio.

After you select a report package that you want to use, the Report Studioopens.

Note: The report charts have been updated in IBM Cognos Version 10.2 but aredisabled in Report Studio by default. To activate the new charts for yourpackage, in Report Studio go to Tools > Options and clear Use legacy chartauthoring.

3. Use the menu controls to create a report or edit existing ones by formatting thelayout and manipulating the data in the report.

Tip: Use Tivoli Common Reporting template to ensure consistency among yourreports.

4. Save your report, and run it anytime you must present its underlying data.

What to do next

Learn more about web-based report authoring in Report Studio ProfessionalAuthoring User Guide available on clicking F1 from the Report Studio.Related information:

How IBM Cognos Business Intelligence Works

Report Studio User Guide 10.2.0

Using Tivoli Common Reporting templateTivoli Common Reporting report template contains a standard layout pattern thatyou can use to create your reports. Use the template to ensure consistency amongyour reports and give them a common look and feel.

About this task

The Tivoli Common Reporting template contains a prompt page and a properreport page. You can manage the pages in the Page Explorer pane. You can use theprompt page to add filters to your reports. By default, it allows you to specify thedate range of the report but you can also customize the filters according to yourneeds. The proper report page contains page number, date and time when thereport was created.

Procedure1. Log in to the relevant reporting interface in your environment. See “Logging in

to the reporting interface in Tivoli Netcool Performance Manager” on page 4.2. In the reporting interface, select Launch > Report Studio. After you select a

report package that you want to use, the Report Studio opens.

6 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

3. Select Create new > TCR Template.4. Customize the parameters to suit your needs. Open the Toolbox nd drag items

onto the report pages.5. Save your report to be able to run it anytime you need.Related information:

Working with reports

Report SpecificationsWhen authors create a report, they are actually creating a report specification. Thereport specification is an XML representation of the queries and prompts that areused to retrieve data, as well as the layouts and styles that are used to present thedata. For simplicity, the report specification is called the report.

Report specifications can be useful to report authors for troubleshooting. You cansee the XML specification for a report at any time by selecting Tools > ShowSpecifications from Report Studio.

In addition, you can view the specification for a selected object with the ShowSpecification (Selection) menu option.

You can also programmatically create or modify reports by using an editing tool towork with report specifications. You then use the IBM Cognos SoftwareDevelopment Kit to implement the reports in your IBM Cognos BusinessIntelligence environment.Related information:

Report Studio User Guide 10.2.1

Creating Reporting Models and PackagesA model serves as an insulating layer between IBM Cognos BI reporting users andthe database. Packages are model subsets that ensure users are provided with dataappropriate for the reporting they need to do, and that the data is structured inways that make sense from a business perspective. A model structures, adds to,and manages data in ways that make sense to business users. For example, amodel defines business rules, data descriptions, data relationships, businessdimensions and hierarchies, and other administrative tasks.

Report specifications

Modeling

Models can be based on the compatible query mode or the dynamic query mode.The compatible query mode supports legacy reports and is required for some datasources. The dynamic query mode is recommended for new applications of IBMCognos Business Intelligence.

The dynamic query mode provides the following benefits:v It is optimized for complex queries and larger data volumes.v It provides advanced query capabilities, such as in-memory caching, which can

improve query planning, execution, and results.

Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 7

v It enables the use of IBM Cognos Dynamic Cubes as data sources, which allowlow-latency, high-performance OLAP analytics over large relational datawarehouses.

Because stored data is typically designed for storage and not for reporting, a datamodeler uses Framework Manager to create metadata models. Models structure,add to, and manage data in ways that make sense to business users. Models definebusiness rules, data descriptions, data relationships, and business dimensions andhierarchies.

Planning and creating a model is an important task that should be performed by amodeler or a modeling team familiar with both the database structure and theneeds of the business users. Models and packages that are well-designed from thestart ensure that user requirements are met, data is secure, and your IBM CognosBI application can be easily administered. For IBM Cognos BI reporting, modelsand packages are created using Framework Manager. For more information, see theIBM Cognos Framework Manager User Guide. In Tivoli Netcool Performance Manager- Wireless Component, Tivoli Netcool Performance Manager - Application Studiocan be used to create enhanced models. Model Maker is also supported for earliermodels to define the metadata models from the technology packs. Modificationsand other customization to the data model can be done by using the FrameworkManager.

Creating a model is an important task that should be planned and executed by amodeler or a modeling team familiar with both the database structure and theneeds of your business users.

When you create a model, youv Specify the metadata to import from data sources defined in the IBM Cognos BI

content storev Refine the metadata by adding business names, descriptions, multilingual

values, calculations, filters, and other componentsv Specify joins and relationshipsv Organize the data for presentation in ways that make sense to business users

and add value to your databasesv Add security to the metadata to determine who can use the metadata and for

what purposes

Packaging

After a model is created, packages are published to locations on the IBM CognosBI server where report authors can use them to create reports. A different package,containing only the necessary information, can be published for each group ofusers.

Reports cannot contain data from more than one package. When publishing apackage, it is important to ensure that the package contains all the data required tomeet the needs of the intended users.

The hierarchical structure of a package controls the way in which folders, reports,and other data objects are structured in the interface used by the report author. Italso controls how security is applied to the objects, and how easy it is to deploythe package to other environments. As a result, it is important to ensure that thestructure of a package makes sense from the perspective of a business user, andnot just from an administrative perspective.

8 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Related information:

Installing and Using Tivoli Netcool Performance Manager - Application Studio

Installing and Using Model Maker

Performing ad-hoc reportingCreate reports ad-hoc by using simple queries and formatting.

Before you begin

To perform ad-hoc reporting you have to have some report packages imported.

Procedure1. Log in to the reporting interface in your environment. See “Logging in to the

reporting interface in Tivoli Netcool Performance Manager” on page 4.2. In the reporting interface, select Launch > Query Studio.3. Start Query Studio.4. Select a package to work with. A New window opens in which you can create

a report.5. Select and insert items from the navigation tree to complete the report.

Tip: Change the appearance of the data by using the menu icons.6. When the report data and appearance is edited, save the report by specifying a

Name, and optionally a Description, and a Screen tip.

Results

You have now created your ad-hoc report.

What to do next

Learn more about authoring the reports in the IBM Cognos Query Studio UserGuide.

Chapter 1. Common Reporting on Tivoli Netcool Performance Manager 9

10 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Chapter 2. Reports containing both Wireless and Wirelinedata

You can include both Wireless and Wireline data in the same report.

You can use the following information for creating and using reports that containboth Wireline and Wireless data:

Tivoli Netcool Performance Manager Data ProviderIt exposes the data sets from both Wireless and Wireline data sources,which are groups of data sets. The following diagram explains how this isimplemented:

Download the data_provider_1.1.zip file from Integrated ServiceManagement Library (ISML) to use this solution.

© Copyright IBM Corp. 2011, 2015 11

12 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Chapter 3. Getting started with Wireline reports

This information can help you get started with Common Reporting on Wirelinenetworks with Tivoli Netcool Performance Manager.

Wireline data sourceThe data source that is used in Cognos 10 is called TNPM.JDBC.

The data source gives access to Technology pack resource set definition.

The Cognos is integrated through new Cognos Dynamic Query Model engine withthe support of Tivoli Netcool Performance Manager JDBC Driver. The TivoliNetcool Performance Manager JDBC Driver exposes traffic data in the followingvirtual tables:v Group Summary Table (GST)v Resource Aggregated Time Series Table (RATS)v Resource Time Series Table (RTS)

Virtual tables are conceptualized database tables that are virtualized by TivoliNetcool Performance Manager JDBC Driver. These tables do not exist in theRDBMS database.

You can achieve the following objectives by using Tivoli Netcool PerformanceManager JDBC Driver:v Cognos integration for common reportingv Cognos data modeling by using Framework Manager for creating Tivoli Netcool

Performance Manager data modelsv Optional: Third-party SQL Client connection for troubleshootingRelated information:

Installing and Configuring Common Packs

Creating a reportTo create a report, follow these steps:

Procedure1. In Common Reporting, select a package. In this example, select the

ibm.tnpm.huawei.u2000 package.2. On the toolbar, click Launch and select Report Studio. The Report Studio

opens.3. On the Welcome window, select Create a new report. A window opens.4. On the New window, select List, and click OK. An empty report, containing a

list (a single row table), opens.5. Expand the package in the Source Pane on the left. Drag data items in to the

list. For example:a. Expand ibm.tnpm.huawei.u2000 > Presentation Views > Tivoli Netcool

Performance Manager (TNPM) > TNPM huawei u2000 (Presentation) >Card Raw.

© Copyright IBM Corp. 2011, 2015 13

b. Drag the following data items to the list:v TIMESTAMP

v DISPLAY_NAME

v Memory Occupancy[100872][raw]

v CPU Occupancy[100006][raw]

c. Select TIMESTAMP in the list and sort it in ascending order.

6. Click Run > Run Report – HTML to run the report.7. Click File > Save As to save the report.

Emailing reportsEmail your reports to share them with the group of people who do not have accessto the reporting portal.Related information:

Emailing Reports on Jazz for Service Management on IBM Knowledge Center

14 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Scheduling reportsYou schedule a report to run it later or at a recurring date and time. You can createa schedule to run a report one time or repeatedly.

Procedure1. Log in to the reporting interface. See “Logging in to the reporting interface in

Tivoli Netcool Performance Manager” on page 42. Click Reporting > Common Reporting to select a package.

For example, select the ibm.tnpm.mib2 package.3. Select a report that you want to run as scheduled report and click the Schedule

icon ( ).4. In the Schedule page, configure the following schedule options:

a. Set the priority for the scheduled report.Select a lower number for higher priority. The default is 3.

b. Under Frequency, select how often you want the schedule to run.The Frequency section is dynamic and changes with your selection. Waituntil the page is updated before you select the frequency.

c. Under Daily frequency, select how often you want the schedule to run eachday. You can choose to schedule an entry either by the minute or by thehour.When you specify a daily frequency, you can select a time period when youwant the entry to run during the day, for example, between 9:00 am and5:00 pm. This way, you can restrict the running of entries to periods duringthe day when updates are needed.

d. Under Start, select the date when you want the schedule to start.e. Under End, select when you want the schedule to end.

If you want to create the schedule but not apply it right away, select theDisable the schedule check box. To later enable the schedule, clear thecheck box.

f. Select formats, languages, delivery method as needed.g. Under Prompt values, select the Override the default values check box.h. Click Set > OK.

A prompt page opens.5. From the Run as list, select Scheduled Report.

Note: To manually run a report, select One time Report.Edit the values as needed in the following screen:

Chapter 3. Getting started with Wireline reports 15

6. Click Finish and click OK in the Schedule page to save the changes to theschedule.

What to do next

Click Edit link to modify the scheduling options or click Clear to reset all thevalues.Related information:

Schedule Management

Cognos Active ReportsIBM Cognos Active Report is a report output type that provides a highlyinteractive and easy-to-use managed report. Active reports are built for businessusers, allowing them to explore their data and derive more insight. Cognos ActiveReports contain the data that they present and are based on MHTML, a webarchive format. Cognos Active Reports also comes with a new set of widgets thatcan be interconnected.

When the host name changes, the charts are dynamically updated. The advantageis that a report encapsulating data is that it can be transported outside the TivoliCommon Reporting system. Existing reports can be converted and saved asCognos Active Reports that are encapsulating the data.

Active reports make business intelligence easier for the casual user. Report authorsbuild reports that are targeted at their users' needs, keeping the user experiencesimple and engaging. Active reports can be consumed by users who are offline,making them an ideal solution for remote users such as the sales force.

Active reports are an extension of the traditional IBM Cognos report. You can useexisting reports and convert them to active reports by adding interactive behavior,

16 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

providing users with an easy-to-consume interface. Like existing IBM Cognosreports, you can run active reports from IBM Cognos Connection and schedule andburst them to users.

You build active reports with the same objects that you use to build other reporttypes. However, there are objects that are specific to active reports. These objectsfall into two categories:v Active report controlsv Active report variables

Note: Because Cognos Active Reports contain the data, it is not recommended tocreate such reports with large number of records for performance reasons. If theCognos Mobile component is installed, it is essential to consider the potentialcommunication costs that might be incurred loading Cognos Active Reports onmobile devices.Related information:

Active Reports

Business analytics proven practices

Business analytics proven practices - Cognos Active Reports

Dashboard reportsA dashboard is a visual display of the most important information that a userneeds. The information is consolidated and arranged on a single screen so that itcan be monitored at a glance. Dashboard reports display several different reportobjects in one report, but the information in the report is static. Workspaces thatare created in Cognos Workspace are a collection of IBM Cognos content that youassemble into an interactive workspace. Content is displayed in widgets.

You can also create dashboards within IBM Cognos Connection. In thesedashboards, content is displayed in portlets within pages.Related information:

Example - Create a Dashboard Report

Pages and Dashboards

Design considerations for Wireline report authorsFor best results when authoring reports for Common Reporting, keep in mind thefollowing design considerations and limitations.

Be aware of the following behavior:v If you include images in your reports, test them thoroughly with the Excel

output.

Chapter 3. Getting started with Wireline reports 17

Modifying timestamps in custom charts to round up tominutes instead of milliseconds

By default, timestamps in reports created by using the wireline data models arerounded up to milliseconds. This task explains how to change the report to roundthe timestamps up to minutes instead.

About this task

This procedure assumes that time data item found on the Source is inserted intothe chart or table in Report Studio as shown. Repeat these steps as required whilecreating custom charts or tables.

Procedure1. Double-click on a time data item. The Data Item Expression window opens.2. In the Expression Definition window, enter the following expression:

substring(cast( data_item_path ,varchar(30)),1,16)

where data_item_path is the path of the selected data item. This expressionremoves seconds and milliseconds, resulting in the display of year-month-dayhour:minute only.

3. Save the expression by clicking OK.

Conforming to Cognos reporting guidelinesTo conform to the Cognos reporting guidelines, leave table cells with no data blankrather than using a dash (-) to indicate no data.

In Wireline reports for previous Wireline versions, dashes were used (-) in tablecells where there is no data.

Microsoft Excel formatting limitationsWhen authoring reports, be aware that wireline users can still experience someformatting problems with charts that have a decimal number on the y-axis. Theseissues are due to formatting limitations in Microsoft Excel 2007.

If this problem occurs, use Report Studio to modify the chart and change the dataformat property of the y-axis to the Number with 2 decimal places option.

Also, be aware that for best results when exporting reports to Excel, users aredirected to always select Microsoft Excel 2007. Due to formatting limitations inolder versions of Excel, exporting in versions such as 2000 or 2002 can produceincompatible charts. Always ensure that you test your reports in Microsoft Excel2007.

If you include icons in your reports, test them thoroughly with the Excel exportoption.

18 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Chapter 4. Getting started with Wireless reports

This information can help you get started with Common Reporting on Wirelessnetworks with Tivoli Netcool Performance Manager.Related information:

Reporting Best Practices

Best practices and reporting recipes by using Tivoli Netcool PerformanceManager - Application Studio

Report Studio User Guide 10.2.1

Query Studio User Guide 10.2.1

Authoring a simple reportYou can follow these basic steps to create a simple report. This example uses thepackage that is created when the Huawei GSM BSS common pack is published.

Procedure1. In Common Reporting, select a package. In this example, select the Huawei

GSM BSS package.2. On the toolbar, click Launch and select Report Studio. Report Studio opens.3. On the Welcome window, select Create a new report or template.4. On the New window, select List, and click OK. An empty report opens

containing a list (a single row table).5. Select a Time attribute from the Insertable Objects window and drag it into

the list. For best results, use the keys where possible. In this example, drag theTCR Time (Presentation) > Time > Keys > DATE_KEY_HOUR key into thelist.

6. Select a primary key or an entity ID and drag it into the list right beside theDATE_KEY_HOUR key. Ensure that your selection is in the list, if a singletonis created, click Undo and try again. In this example, drag TNPM MobileGSM (Presentation) > TNPM GSMCell > TNPM GSMCell > CELL_ID intothe list.

7. Select metrics and drag them into the list next to the CELL_ID column. In thisexample, drag TNPM Huawei GSM BSS V900 Measurements (Presentation)> TNPM Huawei GSM BSS V900 Measurements Cell Measurements >Cell.AMR_calls > Cell.Huawei.GSM.AMR_calls >CALL_DROP_AMRFR_CAll_FAIL_TIMES.

8. Create a prompt page by highlighting CELL_ID and DATE_KEY_HOUR, and

clicking the Build prompt page button on the toolbar. The prompt pageis automatically generated.

9. Save the report as Simple_Report in My Folders.10. Return to Common Reporting and click the My Folders tab.

11. Find Simple_Report in the list of reports and click the Run button to runthe report.

Related information:

© Copyright IBM Corp. 2011, 2015 19

Creating report

Authoring an efficient reportThe Tivoli Netcool Performance Manager database relies heavily on an Oraclefeature called Partition Pruning to efficiently process data. Reports must be definedin a certain way to ensure that Oracle has enough information to identify datapartitions.

About this task

You can build a prompt page to ensure that Oracle has the required information toidentify data partitions. These steps assume that you have created a list report with15-minute data by dragging the appropriate report items into the report.

Procedure1. As this data is 15-minute data, drag the DATE_KEY_15 key into the report.

You remove this key later as it is used only as a quick method to build aprompt.

2. Select the DATE_KEY_15 column and click the Build Prompt page button on thetoolbar. A prompt is created for the report.

20 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

3. Return to the report definition page and remove the DATE_KEY_15 column byright-clicking and selecting cut. You must remove the key or the report displaysonly the raw data with the drill up.

4. Save and run the report.

Chapter 4. Getting started with Wireless reports 21

Authoring a drill-down reportIn this example, we edit the Simple_Report report to allow drill up and drill downlevels for both time and resource (entity) in the report.

Procedure1. In Common Reporting, select the package used to create the simple report. In

this example, select the Huawei GSM BSS package.2. On the toolbar, click Launch and select Report Studio. Report Studio opens.3. Select Open an existing report or template, select Simple_Report and Open.4. Save the report as Drill_Down_Report.5. Edit the report to use Cell Hierarchy and Time (Dimensional) by completing

the following steps:a. Delete the CELL_ID and the DATE_KEY_HOUR columns.b. In the vertical toolbar beside the Insertable Objects window, point to the

Query Explorer button to see Query Explorer and select Query1.c. Delete both filters. to remove the current prompt pages. With the removal

of CELL_ID, and DATE_KEY_HOUR, these filters are no longer useful inthe context of this report.

d. Point to Page Explorer button to see the Page Explorer, right-click onPrompt Page1 and select Delete to delete the prompt page.

e. In Page Explorer, click Page1 to return to the list.f. Drag the following elements into the list. You can navigate further into the

file structure as required.v TCR Time (Presentation) > Time (Dimensional) > Year > Day

v CDM Mobile GSM (Presentation) > CDM GSM > Cell Hierarchy >Network to Cell > Cell

6. From the main menu, select Data > Drill Behaviour.7. On the Basic tab of the Drill Behaviour window, select the Allow drill-up and

drill down option and click OK. You can now drill on entity and time whenyou run this report. If you want, you can also add a filter to restrict the timescope on which the report is displayed, the prompt page is not as useful inthis scenario as it would restrict the drilling process.

8. Add a filter to limit the time scope of the report by completing the followingsteps:a. In the vertical toolbar beside the Insertable Objects window, point to the

Query Explorer button to see Query Explorer and select Query1.b. In the Insertable Objects window, select the Toolbox tab.c. Drag a filter into the Detailed Filters pane from the Insertable Objects pane

. In this example, the filter is set to report on the previous 7 days. In thedialog box for the calculation, insert the following calculation:[TCR Time (Presentation)].[Time].[DATE_KEY_DAY] > _add_days(current_date, -8)AND[TCR Time (Presentation)].[Time].[DATE_KEY_DAY] <= _add_days(current_date, -1)

d. For this filter to work, the DATE_KEY_DAY key must be in the report.Drag DATE_KEY_DAY into the list.

22 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

e. The DATE_KEY_DAY key does not need to be displayed so you can hideit. Select the title of the column, and in the Properties window, set BoxType to none, Select the column body and in the Properties window, setBox Type to none.

9. Save the Drill_Down_Report report.10. Return to Common Reporting and click the My Folders tab.

11. Find Drill_Down_Report in the list of reports and click the Run button torun the report.

12. When the report viewer has appeared, the entries under Cell and Day shouldbe highlighted, you can click these entries to perform a drill down or you canright-click and select drill up to perform a drill up.

Authoring a charting reportCharts are a graphical representation of tabular data. They can be used to quicklyidentify large numeric data for different areas of business. They are commonlyused in dashboard style reports.

Procedure1. In Common Reporting, select a package.2. On the toolbar, click Launch and select Report Studio. Report Studio opens.3. On the Welcome window, select Create a new report or template.4. On the New window, select Chart, and click OK. The Insert Chart window is

displayed.5. In the Chart group list, select a group. For this example, select Column.6. In the Chart Type pane, select a chart type. For this example, select Column

with 3-D Visual Effect.7. Click OK. A blank chart displays in the work area.

8. A column chart has three drop zones; Default measure (y-axis), Series, andCategories (x-axis).

9. From the Source tab in the Insertable Objects pane, drag a data item to theSeries drop zone. In this example, we drag the Raw KPI to the Series dropzone.

Chapter 4. Getting started with Wireless reports 23

10. From the Source tab in the Insertable Objects pane, drag a TCR data item tothe Categories drop zone. In this example, we also include the CELL_IDmeasure from the Orders query subject in the Default measure drop zone.

11. From the Standard toolbar, click Run Report. The results are displayed.

24 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Drill-through reportsCreating drill-through access within a report makes it easier for you to navigatethrough large reports or to link separate reports containing related information.

When you create drill-through access, you can create a bookmark that lets younavigate through a particular dimension of a report or pass a parameter from asource report to a target report. When the drill-through data item value in thesource report is selected, the target report opens. The target report is filtered on theparameter that was passed from the source report. This filtering allows you to linkseparate reports with related information. For the following example, we set updrill-through access using two separate reports: a target report, and a sourcereport.

Authoring a drill-through target reportA target report opens after you click a data item value in a source report. Typically,this report contains related or more detailed information about the source report.Setting up drill-through access gives the user quick access to detailed informationwithout having to navigate through folders to run another report.

About this task

The MTP3_DSP_ID resource is set up as the drill-through text in the target report.When you click the MTP3_DSP_ID drill-through text, the target report opens,displaying raw data for KPIs for the MTP3_DSP_ID that was selected in thesource report.

The Date_Key_Hour key is added to the report and hidden; it is used in the drillthrough, but not required in the report.

Procedure1. Create or open a list report to use as the target report.2. Add MTP3_DSP_ID, Date_Key_Hour, Date_Key_Hour and raw KPIs columns.3. Hide the Date_Key_Hour key in the report:

a. Click the list column body for the Date_Key_Hour data item and, in theProperties panel, set Box Type = None.

b. Click the list column title for the Date_Key_Hour data item and, in theProperties panel, set Box Type = None.

4. Save the target report. For this example, save the target report as Test Targetreport.

What to do next

Create a source report that contains raw data for all resources.

Chapter 4. Getting started with Wireless reports 25

Authoring a drill-through source reportA source report contains the data item value that you can click to drill-through tothe target report to view more detailed information.

About this task

To set up the source report to contain the drill-through definition, you need toknow the name and location of the target report and the parameter used in thefilter of the target report.

Procedure1. Create or open a list report to use as the target report.2. Add MTP3_DSP_ID, Date_Key_Hour, and raw KPIs columns.3. In the work area, select the item to be used as the drill-through. For this

example, select MTP3_DSP_ID as the drill-through.

Note: To activate the Drill-Through Definitions option, you must first make aselection in the work area.

4. Click Launch on the toolbar and select Drill-Through Definitions. TheDrill-Through Definitions window is displayed.

5. Click the New Drill-Through Definition button. A new Drill-Throughdefinition is created.

26 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

6. Under Report, choose the target report.7. Select the target report and click the Open button. For this example, select

Test Target report.8. From the Action list, select how the target report renders during drill-through.

v Run The Report, runs the report and displays the most recent data.v View Most Recent Report, displays the most recent saved output version of

the report.v Default, uses the report action defined in Cognos Connection.

9. From the Format list, select the output format for the report when it runs. Youcan choose HTML, PDF, Excel 2007, Excel 2002, Excel 2000 Single Sheet,Delimited Text (CSV), XML, and Default, which uses the output formatdefined in Cognos Connection.

10. Optionally, select the Open In New Window check box to open the targetreport in a new window when it is accessed from the source report. If you donot select this check box, the target report replaces the source report in theCognos Viewer.

11. Click Edit to display details the parameters from the target report. TheParameters window is displayed.

12. From the Method list, select the method for passing the parameter. You canchoose from Do Not Use Parameter, which does not pass the parameter; PassData Item Value, which passes a value from a data item within the sourcereport; Pass Parameter Value, which passes a parameter value from the sourcereport; or Default, which does not pass the parameter. For this example, selectPass Data Item Value.

13. From the Value list, select the Data Item value from the source report. In thisexample, we use Date_Key_Day and MTP3_DSP_ID.

Chapter 4. Getting started with Wireless reports 27

14. Click OK. The parameters to pass to the drill-through definition display in theParameters pane on the Drill-Through Definitions window.

15. From the Display Prompt Pages list, select an option for when to display theprompt pages. The available options are Always, Based On The DefaultPrompt Settings Of The Target Report, and Only When Required ParameterValues Are Missing. For this example, select Only When Required ParameterValues Are Missing.

16. Click OK. Report Studio updates the report. The data item being used as adrill-through object becomes a hyperlink, and the drill-through icon isdisplayed.

17. Run the report to test the drill-through. The source report opens in CognosViewer and the data items containing the drill-through definition display ashyperlinks that allow you to drill-through to the target report.

18. From the column containing the drill-through definition links, click ahyperlink. The drill-through target report displays with detailed informationabout the selected item. In this example, the target report opens and displaysdetailed information about the raw KPIs for the selected resource and daterange.

28 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Including multiple granularity items in the same reportYou can include items of multiple granularity in the same report. Use this set ofexamples and information to help you with this feature.

Displaying multiple granularity items with drill-down onlyThis example task assumes that you want to display data of multiple granularitiesin the same report. You can drill up and drill down by time or by resource, in thisexample, the drill-down is by time. The lowest level of granularity is 5 minutes,the 5-minute timestamp value is displayed in the report. The other data is drilleddown to this level.

About this task

Table 1. Granularity and KPI

Granularity KPI

5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL

10 min IMM_ASS_CH_ALLOC_REQ_SD

15 min PREFER_TCHH_IP_HDLC_TRANS

30 min IMM_ASS_CH_ALLOC_FAIL_SD

60 min TCH_CALL_DROP_TA

The report definition is as follows:

To report correctly, additional information needs to be added to the report:

Procedure1. From the Keys folder under the Times object, drop and drag the DATE keys of

all the traffic data of a higher granularity.

(As we are reporting at 5 minutes, we drop in the keys for 10, 15, 20, 30, andHour)

2. Hide those keys in the report:a. Keeping the Ctrl key pressed, click the column headers and column of each

of these keys.b. In the Properties pane, set Box Type property to None.

Chapter 4. Getting started with Wireless reports 29

Note: To view these objects again, view the report definition in Page Structuremode: View > Page Structure.

3. Run the report.

Results

The 5-minute data is displayed. The other timestamps are drilled down.

Due to the way Common Reporting displays reports, metrics that have a greatertime granularity than the level at which the report is based can show duplicateresults. You can avoid these duplicates by using the method detailed in the “UDCcalculations and drill downs” on page 31 topic. The UDC is as follows:if (DATE_KEY_15 = DATE_KEY_HOUR) then([TCH_CALL_DROP_TA])elsenull

Displaying multiple granularity items with drill up and drilldown

This example task assumes that you want to display data of multiple granularitiesin the same report. You can drill up and drill down by time or by resource. Herewe are going to create a report with some counters drilled up and some drilleddown by time.

About this task

Taking the example data in the table, you can create a report that reports data at30-minute intervals. Hence, expect the 5, 10 and 15-minute data to drill up and thehourly data to drill down.

Table 2. Granularity and KPI

Granularity KPI

5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL

10 min IMM_ASS_CH_ALLOC_REQ_SD

15 min PREFER_TCHH_IP_HDLC_TRANS

30 min IMM_ASS_CH_ALLOC_FAIL_SD

60 min TCH_CALL_DROP_TA

Procedure1. Drag all the KPIs, CELLID, and 30-minute object into the table. For each object

that you want to drill down on, you must include the key for that granularity.Therefore, in this example, you can drag in the DATE_KEY_HOUR key.

30 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

2. Hide those keys in the report:a. Keeping the Ctrl key pressed, click the column headers and column of each

of the keys.b. In the Properties menu, set Box Type to None.

Note: To view these objects again, view the report definition in Page Structuremode: View > Page Structure.

3. Run the report.

UDC calculations and drill downsThis example partially replicates the functionality of Tivoli Netcool PerformanceManager - Wireless Component. In a drill-down scenario, we create a User DefinedCalculation (UDC) that is calculated at run time as the sum of two othercalculations. However, one raw counter has a 5-minute granularity and the otherhas an hourly granularity. The expected result is that we add the counters togetheronly when the timestamps match, that is, on the hour.

The report result is as follows; we add the hourly column only when thetimestamps are equal.

Chapter 4. Getting started with Wireless reports 31

This result is achieved as follows, the method used here avoids problems with datacorruption.

Add the following columns to the report:

[TNPM Huawei BSS Measurements(Consolidation)].[Cell.Huawei.Generic.Local_switch_call_drops].[BSCLOOP_FAIL_APPLY_TRSL_FAIL]

[TNPM Huawei BSS Measurements(Consolidation)].[Cell.Huawei.Generic.TCH_call_fail_per_cell].[TCH_CALL_DROP_TA]

When creating the UDC, use the column values rather than the database values.That is, when creating the expression in the Data Item Expression window, choosethe metrics from the Data Items tab, rather than the Source tab.

This method performs the calculation on the visible results in the existing columns,rather than the values taken from the database.

Edit the UDC formula to be something as follows:IF( [TCR Time (Presentation)].[Time].[DATE_KEY_5] =[TCR Time (Presentation)].[Time].[DATE_KEY_HOUR] )THEN([BSCLOOP_FAIL_APPLY_TRSL_FAIL] +[TCH_CALL_DROP_TA]

)ELSE([BSCLOOP_FAIL_APPLY_TRSL_FAIL] )

Now that the UDC is complete the two metrics you added can be hidden bysetting the Box Type property to none in the Properties pane.

If the timestamps match we add the counters together, otherwise we display onlythe counter from the 5 minute data.

32 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Chapter 5. Known Common Reporting issues

Common Reporting in Tivoli Netcool Performance Manager Model Maker 1.4 isbased on IBM Tivoli Common Reporting 3.1.0.2, which delivers a subset of IBMCognos Business Intelligence 10.2 functions.

When you work with performance management reports in Common Reporting,you might encounter some of the following known limitations or issues. Theseissues or limitations can be caused by Tivoli Netcool Performance Manager, or bythe underlying IBM Tivoli Common Reporting or IBM Cognos BI products.

Known issues are documented in the Known Issues with Tivoli Netcool PerformanceManager 1.4 technical note in the Support knowledge base at:http://www-01.ibm.com/support/docview.wss?uid=swg21574017.Related information:

Troubleshooting Tivoli Common Reporting

Troubleshooting Problems with Dashboard widgets

IBM Tivoli Common Reporting community on developerWorks

© Copyright IBM Corp. 2011, 2015 33

34 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Appendix. Common directory locations for Jazz for ServiceManagement 1.1.0.3

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

© Copyright IBM Corp. 2011, 2015 35

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 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 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, the

following default locations are used: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, the

following default locations are used:v Root user installations: /opt/IBM/JazzSM/adminuiv Non-root user installations: /home/nonrootuser_name/IBM/JazzSM/adminui

36 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

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, the

following default locations are used: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, the

following default locations are used: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 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 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 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:

v Root user installations: /opt/IBM/JazzSM/reporting/cognos

Appendix. Common directory locations for Jazz for Service Management 1.1.0.3 37

v 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 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 On UNIX systems: Install_Imgs_Home/PrereqScanner/UNIX_LinuxRelated information:

Common directory locations

38 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

Notices

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

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

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

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

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

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

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto you.

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

Any references in this information to non-IBM websites are provided forconvenience only and do not in any manner serve as an endorsement of those

© Copyright IBM Corp. 2011, 2015 39

websites. The materials at those websites are not part of the materials for this IBMproduct and use of those websites is at your own risk.

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

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

IBM CorporationDepartment number/Building numberSite mailing address_City, State; Zip Code_USA (or appropriate country)

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

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

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

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

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

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

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

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

COPYRIGHT LICENSE:

40 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. The sampleprograms are provided "AS IS", without warranty of any kind. IBM shall not beliable for any damages arising out of your use of the sample programs.

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

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

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

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

Applicability

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

Personal use

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

Commercial use

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

Rights

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

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

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

Notices 41

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

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

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

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

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

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

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

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

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

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

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

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

42 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting

����

Printed in USA