installing and configuring common packs · it also processes online calculations and detects...

56
IBM Tivoli Netcool Performance Manager Wireline Component July 2015 Document Revision R2E1 Installing and Configuring Common Packs

Upload: others

Post on 15-Jul-2020

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

IBM Tivoli Netcool Performance ManagerWireline ComponentJuly 2015Document Revision R2E1

Installing and Configuring CommonPacks

���

Page 2: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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

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

Page 3: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Contents

About this information . . . . . . . . vIntended audience . . . . . . . . . . . . vTivoli Netcool Performance Manager - WirelineComponent. . . . . . . . . . . . . . . vOrganization . . . . . . . . . . . . . . viService Management Connect . . . . . . . . viiTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . viiSupport information . . . . . . . . . . . viiConventions used in this publication . . . . . viii

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

Chapter 1. Introduction to Tivoli NetcoolPerformance Manager JDBC Driver . . . 1Architecture . . . . . . . . . . . . . . 1Using Tivoli Netcool Performance Manager JDBCDriver . . . . . . . . . . . . . . . . 4Technology pack resource set definition . . . . . 4

Chapter 2. Software requirements andprerequisite software . . . . . . . . . 7Supported configurations . . . . . . . . . . 7Prerequisites for using Tivoli Netcool PerformanceManager JDBC Driver on the Microsoft Windowscomputer . . . . . . . . . . . . . . . 7Preparing your environment . . . . . . . . . 8

Chapter 3. Installing the Tivoli NetcoolPerformance Manager JDBC Driversoftware . . . . . . . . . . . . . . 9Troubleshooting the JDBC Driver installation . . . 10

Chapter 4. Installing and configuringIBM Cognos Business Intelligence. . . 13Installing Cognos Business Intelligence (Cognos BI) 13Configuring Cognos Business Intelligence . . . . 14

Restarting the web server. . . . . . . . . 15

Configuring IBM Cognos Configuration . . . . 15

Chapter 5. Installing and configuringFramework Manager . . . . . . . . . 17Configuring Framework Manager connections . . . 17

Chapter 6. Configuring technologypacks for enabling common reporting . 19

Chapter 7. Getting started withcommon reporting. . . . . . . . . . 21Importing common pack data model package intoCognos . . . . . . . . . . . . . . . . 21Running a report . . . . . . . . . . . . 22Enabling Tivoli Netcool Performance Manager datain Cognos . . . . . . . . . . . . . . . 23Importing generated virtual tables into FrameworkManager . . . . . . . . . . . . . . . 25

Query conditions and limitations . . . . . . 25Creating a package in Framework Manager . . . 27Creating a report in Report Studio. . . . . . . 28

Chapter 8. Enabling multitenancy . . . 29

Chapter 9. Troubleshooting TivoliNetcool Performance Manager JDBCDriver and Common reporting. . . . . 31Troubleshooting the datasource connection failurewhile installing JDBC Driver . . . . . . . . 31

Notices . . . . . . . . . . . . . . 33Terms and conditions for product documentation. . 35Trademarks . . . . . . . . . . . . . . 36

Additional copyright notices . . . . . 37

© Copyright IBM Corp. 2015 iii

Page 4: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

iv Installing and Configuring Common Packs

Page 5: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

About this information

Describes how to install and configure Common Packs on a Tivoli® Netcool®

Performance Manager 1.4 system.

IBM Cognos is integrated in Wireline Common Packs by using the TivoliNetcoolPerformance Manager JDBC Driver.

Intended audienceThis publication is intended for:v Users who want to install and administer common pack data models on a Tivoli

Netcool Performance Manager Wireline Component system. Common pack datamodels are required for Common Reporting for Tivoli Netcool PerformanceManager.

v Modelers who want to create and deploy common pack data models forCommon Reporting in Tivoli Netcool Performance Manager.

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

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

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

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

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

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

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

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

The following figure shows the different Tivoli Netcool Performance Managermodules.

© Copyright IBM Corp. 2015 v

Page 6: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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

The documentation is available for viewing and downloading on the informationcenter at http://www-01.ibm.com/support/knowledgecenter/SSBNJ7_1.4.0/com.ibm.tnpm_1.4_kc.doc/tnpm_1.4_kc_welcome.html?lang=en.

OrganizationRead this summary information to help you find the information that you need.v Chapter 1, “Introduction to Tivoli Netcool Performance Manager JDBC Driver,”

on page 1Describes the Tivoli Netcool Performance Manager JDBC Driver components andhow to use this information.

v Chapter 2, “Software requirements and prerequisite software,” on page 7Describes the Tivoli Netcool Performance Manager JDBC Driver softwarerequirements and prerequisite software.

v Chapter 3, “Installing the Tivoli Netcool Performance Manager JDBC Driversoftware,” on page 9Describes how to install the Tivoli Netcool Performance Manager JDBC Driverfor creating the data models.

v Chapter 4, “Installing and configuring IBM Cognos Business Intelligence,” onpage 13Describes how to install IBM Cognos Business Intelligence.

v Chapter 5, “Installing and configuring Framework Manager,” on page 17Describes how to install the Framework Manager for publishing the commonpack data models.

vi Installing and Configuring Common Packs

Page 7: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

v Chapter 6, “Configuring technology packs for enabling common reporting,” onpage 19Describes the configuration steps to enable the technology packs for commonreporting.

v Chapter 7, “Getting started with common reporting,” on page 21Describes the best practices in creating reports from the common pack datamodels that are created with the help of Tivoli Netcool Performance ManagerJDBC Driver.

v Chapter 8, “Enabling multitenancy,” on page 29Describes how multitenancy is enables in common pack data models.

v Chapter 9, “Troubleshooting Tivoli Netcool Performance Manager JDBC Driverand Common reporting,” on page 31Lists the known issues that are associated with some common packs.

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

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

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

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

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

Tivoli Netcool Performance Manager 1.4 community on developerWorks

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

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

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

IBM Support AssistantThe IBM Support Assistant is a free local software serviceability workbenchthat helps you resolve questions and problems with IBM softwareproducts. The Support Assistant provides quick access to support-related

About this information vii

Page 8: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

information 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 Keywordsv Parameter names in text: API structure parameters, command

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

viii Installing and Configuring Common Packs

Page 9: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

v Script names

About this information ix

Page 10: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

x Installing and Configuring Common Packs

Page 11: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 1. Introduction to Tivoli Netcool PerformanceManager JDBC Driver

IBM Tivoli Netcool Performance Manager common pack data model extendstechnology pack model for Tivoli Common Reporting. After you install atechnology pack, you use IBM Cognos® Framework Manager to open and createthe corresponding Tivoli Netcool Performance Manager common pack data modelto enable Tivoli Common Reporting. Tivoli Netcool Performance Manager commonpack data models can be delivered in the Commercial Off The Shelf (COTS)program with the corresponding technology packs, or created and customized bycustomers and IBM Business Partners.

Tivoli Netcool Performance Manager JDBC Driver consists of the following featuresand capabilities:

Exposed Tivoli Netcool Performance Manager views

v Group Summary Table (GST)v Resource Time Series table (RTS)v Resource Aggregated Time Series Table (RATS)

Improved performance

v Tivoli Netcool Performance Manager JDBC Driver replaces Cognos XMLdata source.

v Tivoli Netcool Performance Manager JDBC Driver supports SQL Selectto query the required data

Improved usability

v Tivoli Netcool Performance Manager virtual tables such as GST, RTS andRATS are exposed through JDBC reflection API. Based on this JDBCreflection API, common pack data models are created by using IBMCognos Framework Manager.

v The common pack data models that are created are simple to use, andmanage.

ArchitectureCognos integration with the help of Tivoli Netcool Performance Manager JDBCDriver in Tivoli Netcool Performance Manager 1.4.

In the earlier versions of Tivoli Netcool Performance Manager, IBM Cognos isintegrated through Tivoli Common Reporting servlet by using XML interface,where JDBC exposes Tivoli Netcool Performance Manager datalets as storedprocedures.

© Copyright IBM Corp. 2015 1

Page 12: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

The new Tivoli Netcool Performance Manager JDBC Driver is introduced toimprove performance, usability and expose the Tivoli Netcool PerformanceManager views.

Figure 1. Cognos integration in earlier versions of Tivoli Netcool Performance Manager:

2 Installing and Configuring Common Packs

Page 13: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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 which are virtualized by TivoliNetcool Performance Manager JDBC Driver. These tables do not exist in theRDBMS database.

Restrictions in Tivoli Netcool Performance Manager JDBC Driver:v Supports only SQL Select statements from a single virtual table.v SQL join statements and query transformations are handled by Cognos report

engine.

Figure 2. Cognos integration in Tivoli Netcool Performance Manager 1.4

Chapter 1. Introduction to Tivoli Netcool Performance Manager JDBC Driver 3

Page 14: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Using Tivoli Netcool Performance Manager JDBC DriverHow Tivoli Netcool Performance Manager JDBC Driver supports in Cognos datamodeling.

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 common pack data modelsv Optional: Third-party SQL Client connection for troubleshooting

Technology pack resource set definitionThe technology pack resource set definition.

Figure 3. Cognos integration for common reporting through Tivoli Netcool Performance Manager JDBC Driver

4 Installing and Configuring Common Packs

Page 15: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

The technology pack resource set definition is stored in DataView registry databaseand appears as follows:

The LOCAL branch can be used for resource types that are defined in packextensions and customized packs so that Tivoli Netcool Performance ManagerJDBC Driver is able to visualize the virtual tables for use. Three virtual tables; GST,RST and RATS are generated for each resource set configuration.

Virtual tables

The virtual tables provide the following capabilities:v Provides federated access to Near Real Time (NRT) access to non SQL

in-memory databases and historical database.v Hides complexity of pivoting skinny-tuple fact table and slowly changing

dimension tables.v Hides complexity of dimensions implemented as generalized recursive

hierarchies.v Enforces multi-tenancy security.v Supports single table query only.

Chapter 1. Introduction to Tivoli Netcool Performance Manager JDBC Driver 5

Page 16: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Table 1. Summary of the virtual tables

Table name Columns DescriptionMandatory filtercolumns

GST v List of configured metrics

– AVG

– COUNT

– SUM

– MIN

– MAX

v Group Identifier

– GROUP_NAME

–GROUP_DISPLAY_NAME

– GROUP_PATH

– GROUP_DB_IDX

v START_DATE

v END_DATE

Provides aggregationfor the selectedgroup over the timeperiod ofSTART_DATE toEND_DATE

start_dateend_dategroup_path

RTS v Metrics in its granularityare retrieved based on thebounded timestamp andresource name.

v Resource Identifier

– NAME

– DISPLAY_NAME

– PATH

– DB_IDX

v TIMESTAMP

Provides the selectmetrics in itsgranularity for theselected timestamprange.

timestampgroup_path

RATS v Metrics are aggregatedbased on the granularityspecified for the timerange.

v Resource Identifier

– NAME

– DISPLAY_NAME

– PATH

– DB_IDX

v START_TIME

v END_TIME

Provides the selectmetrics in thespecified granularityfor the selected timerange.

start_timeend_timegranularitygroup_path

6 Installing and Configuring Common Packs

Page 17: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 2. Software requirements and prerequisite software

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

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

Table 2. Supported software components

Software Supported versions

Operating system RHEL 5.9, 6.x

Windows 7

Tivoli NetcoolPerformance Manager

1.4 - Wireline Component

IBM Cognos BusinessIntelligence

10.2.1 with Fix Pack 2Note: IBM Cognos must be installed separately andindependently of the Cognos that comes with Jazz™ for ServiceManagement.

IBM CognosFramework Manager

10.2.1

Related information:

Business Intelligence Installation and Configuration Guide 10.2.1

Prerequisites for using Tivoli Netcool Performance Manager JDBCDriver on the Microsoft Windows computer

Ensure that you fulfill these prerequisites before installing and configuring TivoliNetcool Performance Manager JDBC Driver on a Microsoft Windows computer.

Microsoft Windows computer hardware

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

IBM Cognos Framework Manager 10.2.1

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

Install Framework Manager from CognosModeling directory.

Download the Framework Manager 10.2.1 from IBM Passport Advantage.

Java Runtime EnvironmentEnsure that IBM Java, version 6 is installed on the PC and exists on thePATH environment variable of your Windows computer.

© Copyright IBM Corp. 2015 7

Page 18: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

(Optional) SQuirrel SQL Client 3.5.0You can configure and use the SQL client to connect to Tivoli NetcoolPerformance Manager via the Tivoli Netcool Performance Manager JDBCDriver.

Preparing your environmentSteps to prepare you target environment where you installed the Cognos.

About this task

Procedurev Set the JAVA_HOME environment variable to point to the installation location of

your Java Runtime Environment (JRE).

Note: 64 -bit Java is required for the Cognos server.v Verify that the Tivoli Netcool Performance Manager Data Access Layer (DAL)

connection is accessible by using the following URL in your browser:http://<<dashHost>>:<dashPort>/ibm/tnpm/dal/configuration

v Verify that Cognos is up and running by using the following URL:http://<cognos_host>/ibmcognos

v Use the correct vendor JDBC driver libraries according to the database that youare using. If the Cognos server does not have database installed on it, copy thefollowing vendor JDBC driver files to the server to a location of your choice:

– db2jcc4.jar

– ojdbc6.jar

v Append the c10_location/bin64 directory to the appropriate library pathenvironment variable.

LD_LIBRARY_PATH

LIBPATH

8 Installing and Configuring Common Packs

Page 19: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 3. Installing the Tivoli Netcool Performance ManagerJDBC Driver software

Before you begin

Ensure that you have installed the Tivoli Netcool Performance Manager, Version1.4. You can find the tnpm-jdbc.tar file in this location:/<JazzSM_HOME>/products/tnpm/dataview/misc/jdbcBy default, <JazzSM_HOME> is /opt/IBM/JazzSM

Ensure that you set the Java path correctly. For more information, see Setting thepath.

Procedure1. Download the tnpm-jdbc.tar archive file to a location of your choice.2. Extract the tnpm-jdbc.tar file to a location of your choice.

For example, /tmp/. You see the following directory structure:

bin directoryContains the scripts to install the Tivoli Netcool Performance ManagerJDBC Driver into the Cognos instance setup based on the configurationin the tnpmjdbcds.template.xml template file.v installCognosJDBC.sh

v tnpmjdbcds.template.xml

installLib directoryContains the JAR files that are referenced by Tivoli NetcoolPerformance Manager JDBC Driver during installation.v axis.jar

v com.ibm.tivoli.tnpm.cognos.pit.cognos.sdk_1.0.1.jar

v common_1.0.0.jar

v commons-discovery.jar

v commons-logging.jar

v jaxrpc.jar

v wsdl4j-1.5.1.jar

lib directoryContains the JAR files that are referenced by Tivoli NetcoolPerformance Manager JDBC Driver during runtime.v commons-codec-1.3.jar

v commons-jexl-1.1.jar

v commons-logging-1.1.1.jar

v derby_compile.jar

v hummingbird.jar

v tnpm-jdbc.jar

3. Include Java into your shell PATH if required.4. Run the following command from the bin directory:

./installCognosJDBC.sh

© Copyright IBM Corp. 2015 9

Page 20: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

The parameters to be used to run the command are displayed as follows:Licensed Materials - Property of IBM5724-W865724-X63(C) Copyright IBM Corporation 2009. All Rights Reserved.

Usage: installCognosJDBC.sh cognosHome cognosDispatcher cognosUser cognosPassword nativeJDBCdashHost dashPort tnpmUser tnpmPasswordwhere cognosHome Home directory of cognos e.g. /opt/IBM/cognos_10.2.1

cognosDispatcher Url to cognos dispatcher e.g. http://10.55.236.111:9300/p2pd/servlet/dispatchcognosUser Name of a valid cognos user e.g. tipadmin or NA if no authenticationcognosPassword Password of the cognos user e.g. tipadmin or NA if no authenticationcognosNamespace Namespace for cognos login e.g. VMMProvider or NA if no authenticationnativeJDBC Fullpath name for native jdbc driver ojdbc6.jar or db2jcc4.jar location e.g.

/opt/oracle/product/11.2.0/jdbc/lib/ojdbc6.jardashHost Hostname or IP Address of DataView e.g. 10.55.236.111dashPort Port of DataView e.g. 16310tnpmUser Username for connection to tnpm-jdbctnpmPassword Password for connection to tnpm-jdbc

Where:The default Cognos home directory is /opt/ibm/cognos/c10_64.cognosNamespace is the unique namespace ID as the displayed name can bedifferent from the unique namespace ID that is configured in CognosConfiguration. For example, use the following command in a single line:

./installCognosJDBC.sh /opt/IBM/cognos_10.2.1 http://<IP_address>:9300/p2pd/servlet/dispatch smadmin smadmin LDAP_TDS/opt/oracle/product/11.2.0/jdbc/lib/ojdbc6.jar<dashHost> <dashPort> <tnpmUser> <tnpmPassword>

./installCognosJDBC.sh /opt/IBM/cognos_10.2.1 http://<IP_address>:9300/p2pd/servlet/dispatch smadmin smadmin LDAP_TDS/opt/db2/product/10.1.0/java/db2jcc4.jar<dashHost> <dashPort> <tnpmUser> <tnpmPassword>

Results

You can see the default TNPM.JDBC Cognos data source connection in theConfiguration tab in IBM Cognos Administration page.

What to do next

Test the datasource connection to ensure that the connection to the server whereDashboard Application Services Hub installed is successful.

Troubleshooting the JDBC Driver installationPerform these troubleshooting steps if the installation of JDBC Driver fails.

Procedure1. Ensure that you can access the following URL:

http://<dashHost>:<dashPort>/ibm/tnpm/dal/configuration.2. Perform the following logging configuration:

v Create logging.properties file with the following contents:# Specify the handlers to create in the root logger# (all loggers are children of the root logger)# The following creates two handlershandlers = java.util.logging.ConsoleHandler, java.util.logging.FileHandler

10 Installing and Configuring Common Packs

Page 21: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

# Set the default logging level for the root logger.level = FINEST

# Set the default logging level for new ConsoleHandler instancesjava.util.logging.ConsoleHandler.level = FINEST

# Set the default logging level for new FileHandler instancesjava.util.logging.FileHandler.level = ALLjava.util.logging.FileHandler.pattern=/opt/ibm/cognos/c10_64/logs/tnpm-jdbc.logjava.util.logging.FileHandler.limit=100000000java.util.logging.FileHandler.count=4java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatterjava.util.logging.FileHandler.append=true

# Set the default formatter for new ConsoleHandler instancesjava.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

# Set the default logging level for the logger named com.mycompany#com.ibm.cognos.sqlTestGeneratorFramework.level = FINEST

Note: You can specify a different path to place the tnpm-jdbc.log file. Bydefault, the path is: /opt/ibm/cognos/c10_64/logs/

v Copy the logging.properties file to the following location:<cognos_install_dir>/webapps/p2pd/WEB-INF/lib/logging.properties

3. Copy the Cognos generated query and test the query in SQuirrel SQL Client toidentify the blocking components.

Related information:

Troubleshooting Cognos Business Intelligence 10.2.1

Chapter 3. Installing the Tivoli Netcool Performance Manager JDBC Driver software 11

Page 22: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

12 Installing and Configuring Common Packs

Page 23: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 4. Installing and configuring IBM Cognos BusinessIntelligence

You can install all IBM Cognos Business Intelligence components on one computer.This is useful when you are setting up a test or evaluation environment, or forsmall production environments. To use IBM Cognos BI, you must install allcomponents that are selected by default in the installation wizard.

About this task

Server components

Server components provide the user interfaces for reporting, analysis,scorecarding, and event management, as well as the server function forrouting and processing user requests.

Server components provide the user interfaces for reporting and dataexploration, as well as the server function for routing and processing userrequests. In the installation program, you can select to install the followingserver components:v Gatewayv Application Tier Componentsv Content Manager

For more information, see Business Intelligence Installation andConfiguration Guide 10.2.1.

Installing Cognos Business Intelligence (Cognos BI)IBM Cognos Business Intelligence is a web-based business intelligence solutionwith integrated reporting, analysis, scorecarding, and event management features.IBM Cognos Business Intelligence includes IBM Cognos Business IntelligenceServer and IBM Cognos Business Intelligence Modeling.

Before you begin

Verify that you have the required patches that are installed on your computerbefore you install the product. See IBM Software Compatibility reports

Procedure1. If you are installing to a directory with other IBM Cognos BI components, stop

the IBM Cognos service.2. Set the JAVA_HOME environment variable to point to the installation location of

your Java Runtime Environment (JRE).An example of the installation location of a Java Runtime Environment is/directory/java/java_version/jre. IBM Cognos BI requires a JVM, such as theone that is provided by IBM, to run on Linux operating system. If you areinstalling in a location with other IBM Cognos BI components, use the existingJAVA_HOME environment variable.

3. To start the installation wizard, go to the operating system directory and thentype./issetup

© Copyright IBM Corp. 2015 13

Page 24: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

4. Follow the directions in the installation wizard and copy the required files toyour computer.

5. In the Finish page of the installation wizard, do the following tasks:v If you want to see the log files, click View for the appropriate log file.v If you want to see late-breaking information about the product, select the

check box for IBM Cognos Release Notes.v Do not configure IBM Cognos BI immediately because you must do other

tasks first to ensure that your environment is properly set up. Ensure that theIBM Cognos Configuration check box is clear.Later you can configure IBM Cognos BI by using IBM Cognos Configurationby typing cogconfig.sh in the c10_location/bin64 directory.By default, the c10_location is opt/ibm/cognos/c10_64.

v Click Finish.6. Append the c10_location/bin64 directory to the appropriate library path

environment variable.

LD_LIBRARY_PATH

Configuring Cognos Business IntelligenceUse IBM Cognos Configuration to configure IBM Cognos Business Intelligencecomponents and to start and stop IBM Cognos services.

Procedure1. Go to the <Webserver_installation>/conf directory.2. Open the httpd.conf file in an editor.

The default location for httpd.conf file is /etc/httpd/conf/httpd.conf.3. Ensure that both the server name and web server port number values are

specified for the ServerName property.4. Add the following information: By default, c10_location is

/opt/ibm/cognos/c10_64/.ScriptAlias /ibmcognos/cgi-bin "c10_location/cgi-bin"<Directory "c10_location/cgi-bin">AllowOverride NoneOptions NoneOrder allow,denyAllow from all<Directory>

Alias /ibmcognos "c10_location/webcontent<Directory "c10_location/webcontent">Options Indexes MultiViewsAllowOverride NoneOrder allow,denyAllow from all<Directory>

The <Directory> directive is optional.

Note: Ensure that you define the /ibmcognos/cgi-bin alias before the/ibmcognos alias.

Important: ibmcognos is the default value that is used in the Gateway URI andController URI for gateway values in IBM Cognos Configuration. If you do notuse ibmcognos for the ScriptAlias and Alias values, ensure that you change

14 Installing and Configuring Common Packs

Page 25: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

the Gateway URI and Controller URI for gateway values to match the valuesyou use. Also, ensure that you use the same value for the ibmcognos part of theScriptAlias and Alias values as shown in the examples.

5. Save your changes.6. Restart the web server.7. Configure the IBM Cognos Configuration.

Results

Users can access the server by entering the URL in their browser. For example,http://servername:port/ibmcognos.

Restarting the web serverYou can use service httpd command to restart the web server.

Procedure

Log in as root user and type the following commands:To start the web server:# service httpd start

To stop the web server:# service httpd stop

To check the status of the web server:# service httpd status

Configuring IBM Cognos ConfigurationSpecify the server name or an IP address in the URI properties that are used byIBM Cognos Business Intelligence. This ensures that users in different locations canconnect to reports and workspaces that are sent by email. By default, the URIproperties specify the localhost.

Procedure1. Go to the Cognos installation location.2. Export JAVA_HOME=/opt/IBM/WebSphere/AppServer/java/jre/.3. Change directory to/opt/ibm/cognos/c10_64/bin64.4. Run ./cogconfig.sh.

If IBM Cognos Configuration does not open, ensure that you set the DISPLAYenvironment variable.If you see a JAVA.Lang.unsatisfied link message, verify that you are using asupported version of Java.If you see a Java.lang.unsupportedClassVersionError message, ensure thatyou are using a 64-bit version of Java. IBM Cognos Configuration opens.

5. In the Explorer window, click Environment.6. In the Properties window, change the localhost portion of all URI properties to

the name or IP address of your IBM Cognos BI server as follows:

Name Value

Gateway URI http://<cognos_server>:80/ibmcognos/cgi-bin/cognos.cgi

Chapter 4. Installing and configuring IBM Cognos Business Intelligence 15

Page 26: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Name Value

Dispatcher URI http://<cognos_server>:9300/p2pd/servlet/dispatch

7. Save the configuration.

What to do next

Grant access to view the Cognos Reporting tree to a specified user (for example,smadmin) from DataView that is installed on Jazz for Service Managementserver,Administration > Network Performance > User Preferences Management.For more information, see Using and Administering DataView.

16 Installing and Configuring Common Packs

Page 27: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 5. Installing and configuring Framework Manager

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

About this task

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

Procedure1. Run the installation image:

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

For information about installing the Framework Manager, see Installing andConfiguring IBM Cognos Framework Manager.For information about configuring Environment properties for FrameworkManager, see Environment Properties for Framework Manager Computers.

Configuring Framework Manager connectionsYou must configure the required Framework Manager connections.

Configure Framework Manager connection

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

For information about configuring Framework Manager connections, seeConfiguring Framework Manager connection.

© Copyright IBM Corp. 2015 17

Page 28: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

18 Installing and Configuring Common Packs

Page 29: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 6. Configuring technology packs for enablingcommon reporting

Typical configuration steps for technology packs for enabling common reporting.

About this task

After you install the technology pack, perform these steps before you run thecommon pack reports.

Procedure1. Enable user access to Cognos Reporting tree in DataView.

a. Log in to Dashboard Application Services Hub portal.b. Select Administration > User Preferences Management.

1) Select the user profile to access Cognos reports. By default, smadmin.2) Select the Access tab to edit the user access.3) Select Cognos Reporting tree.4) Save the changes.

2. Create a time zone or calendar. For more information, see Aggregation Sets.3. Link a time zone to Cognos Reporting tree.

a. As pvuser, open a terminal.b. Create a file linkGroupTZ.txt. File content format must be as follows:

<Sub-element group>|_|<Calendar type>|_|<Timezone>|_|

For example:Cognos Reporting|_|CME Permanent|_|Greenwich Mean Time|_|

c. Source the DataMart environment by using the following command:source /opt/datamart/dataMart.env

d. Run the following resmgr example command to review timezone to groupassociations:$ resmgr -export segp -colNames "npath cal.name tz.name" –file linkGroupTZ.txt

$ vi linkGroupTZ.txtAnd append the last line

# type = segp# col = npath cal.name tz.name# filter =# order =# sep = |_|# sepRec =# rule =# filterRule =## cmdLine = -export segp -colNames "npath cal.name tz.name"~NOC Reporting|_|CME Permanent|_|Greenwich Mean Time|_|~GMT+1|_|CME Permanent|_|Eastern European Time|_|~GMT-1|_|CME Permanent|_|Azores Time|_|~Moscow GMT+3|_|CME Permanent|_|Moscow Standard Time|_|~CST-6|_|CME Permanent|_|Central Standard Time|_|

© Copyright IBM Corp. 2015 19

Page 30: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

e. Run the resmgr command to set the time zone to Cognos Reporting tree asfollows:resmgr –import segp –colNames “name cal.name tz.name” -file linkGroupTZ.txt

Example of output is as follows:

# type = segp# col = name cal.name tz.name# filter =# order =# sep = |_|# sepRec =# rule =# filterRule =## cmdLine = -export segp -colNames "name cal.name tz.name"NOC Reporting|_|CME Permanent|_|Greenwich Mean Time|_|Cognos Reporting|_|CME Permanent|_|Greenwich Mean Time|_|

For more information, see Linking DataView Groups to timezone.

What to do next

Follow these steps:1. As root user, export JAVA_HOME by using the following command:

Export JAVA_HOME=/opt/IBM/WebSphere/AppServer/java/jre/

2. Start the IBM Cognos Configuration window by using the followingcommands:cd /opt/ibm/cognos/c10_64/bin64./cogconfig.sh

3. Click the Restart icon and ensure that the restart process is completed.

20 Installing and Configuring Common Packs

Page 31: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 7. Getting started with common reporting

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

Before you begin

Ensure that you have installed the latest version of the technology pack by usingthe latest version of the ProvisoPackInstaller.

About this task

Tivoli Common Reporting is based on IBM Cognos Business Intelligence, anenterprise reporting solution. It delivers a subset of IBM Cognos BusinessIntelligence function as a common reporting platform across the Tivoli portfolio. Byusing Tivoli Netcool Performance Manager JDBC Driver you can extend thedomain-specific reporting capabilities of technology packs to Common Reportingby deploying Tivoli Netcool Performance Manager JDBC Driver on your system.

Importing common pack data model package into CognosTo use the common pack data model package and other content, you must importthem from the deployment archive.

Procedure1. Extract the ibm.tnpm.<tech_pack>_<version>_build_<build_number>.zip. You

get <tech_pack>.Reporting.Package.zip file.2. Copy the reporting package in the Cognos server at the following path as

root user:<c10_location>/deployment. Where, c10_location is the Cognos installationpath. By default, /opt/ibm/cognos/c10_64.

3. Log in to IBM Cognos Business Intelligence server and open IBM CognosConnection.

Note: Log in to the stand-alone Cognos server and not to the Cognos that isbundled with Tivoli Common Reporting on Dashboard Application ServicesHub.

4. In the upper-right corner, click Launch > IBM Cognos Administration.5. On the Configuration tab, click Content Administration.6. On the toolbar, click New Import button.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. Click Finish on the last page.

By default, the package is deployed to the Public Folders.

© Copyright IBM Corp. 2015 21

Page 32: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

12. To run once now or later, click Save and run once.13. On the next page, click Now, and then click Run.14. Select View the details of this import after closing this dialog check box and

click OK.The new package is available in the Public Folders.

15. Select Save and run once.16. Click OK.

New packages should now be in the Public Folders.

Running a reportRun your report to see the data that is retrieved. Save time by validating it first tocheck for errors. You can also run a report or a group of reports in IBM CognosConnection. Furthermore, you can save report outputs to a file system. You canspecify not to render a report page if it does not contain any data. When you run areport in an export format such as PDF, delimited text (CSV), Microsoft Excelspreadsheet software (XLS), the IBM Cognos report name is used as the exportedfile name.

About this task

If you run a report that uses functions or features not supported by the datasource, an error message appears. Periodically test your reports while you authorthem in IBM Cognos Report Studio to ensure that you do not encounter multipleerror messages when you run the report.

Procedure1. Open a report.2. If you want to clear parameter values that are stored on the IBM Cognos

Business Intelligence server, from the File menu, click Clear Parameter Values.Parameter values that are stored by the IBM Cognos Business Intelligenceserver include signon, validation, and prompt information. For example, if youdefine two data source connections in IBM Cognos Connection that point to thesame data source, you are prompted to choose one when you run a report. Thisinformation is stored so that you are not prompted each time that you run thereport.

3. You want to view only the tabular data, from the Run menu, click ViewTabular Data.If the report contains multiple queries, you must first click an object, such as alist or crosstab, that uses the query for which you want to view the tabulardata.Use this command to ensure that the right results appear. For example, youcreate a calculation and you want to ensure that it is giving you the results thatyou want.

4. If you want to set run options, from the Run menu, click Run Options.The default value is the value of the selected corresponding run option in IBMCognos Connection.

Note: The run options that you set apply only to the current session. Whenyou close Report Studio, the options return to the default settings.

5. From the Run menu, click one of the options to produce the report in theformat you want.

22 Installing and Configuring Common Packs

Page 33: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

You can produce a report in HTML, PDF, CSV, various Microsoft Excel formats,and XML. You cannot produce a report in CSV format if you have more thanone query that is defined in the report unless the additional queries are usedfor prompts.

Results

The report runs in IBM Cognos Viewer. After the report has finished running, youcan run the report again in the same format or in a different format. If you run thereport again in CSV or XLS format, the report appears in a new browser window.

Enabling Tivoli Netcool Performance Manager data in CognosAdding metrics and attributes to a resource type in a COTS technology pack.

About this task

You must perform the following tasks to enable the data model into Cognos:v Define a resource type by associating metrics and attributes to a resource type.v Import generated virtual tables into Framework Manager to generate a Cognos

model.v Package and publish the Cognos model into the Cognos server.v Create a report in Report Studio.

Procedure1. Launch the dbRegEdit for DataView by running the following command:

./dbRegEdit User/Password@Oracle_TNS_Name Registry_Key

Table 3. Database access and registry information

Header Header

User The user name being used to connect to thedatabase. For example, PV_ADMIN.

Password The user name being used to connect to thedatabase. For example, PV_ADMIN.

Name The name of the Oracle database. Forexample, PV.

Chapter 7. Getting started with common reporting 23

Page 34: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Table 3. Database access and registry information (continued)

Header Header

Registry_Key The name of the registry key for the TivoliNetcool Performance Manager componentthat will be updated. The main registry keysare as follows:

v DATABASE

Tivoli Netcool Performance ManagerOracle database

v CHANNELS

Tivoli Netcool Performance ManagerDataChannel

v CMGR

Tivoli Netcool Performance ManagerDataChannel

v DATALOAD

Tivoli Netcool Performance ManagerDataLoad

v DATAMART

Tivoli Netcool Performance Manager

v DATAVIEW

Tivoli Netcool Performance ManagerDataView

For example:./dbRegEdit pv_admin/pv@pv DATAVIEW

For more information about the dbRegEdit tool, see Using the dbRegEdit utility.The parameters associated with the specified registry key are displayed in yourdefault text editor. To change the settings for a parameter, use your text editorfunctionality to edit the values that appear between double quotation marks.

2. Go to TABLE.PACK in the text editor.TABLE.PACK is reserved for Cognos enabled technology packs that are releasedin COTS program by IBM.TABLE.LOCAL is reserved for pack extensions or customization.

3. Add the new resource types, associated attributes and metrics for the resourcetypes.List all attribute names under ATTRIBUTE branch. Node name must be ATTR<n>, where n is the unique running number per resource type.List all associated metric IDs under METRIC branch. Node name must be METR<n>, where n is the unique running number per resource type.

4. Write and quit the file.5. Restart the IBM Cognos server.

24 Installing and Configuring Common Packs

Page 35: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Importing generated virtual tables into Framework ManagerSteps to import the virtual tables into Framework Manager.

Procedure1. In Framework Manager, click Open from the File menu.2. Enter a name in the Project name field.3. Specify a location to save your project and click OK.4. Select English from the Select Language page and click OK.5. Click Actions > Run Metadata Wizard.6. In the Select Data Source page, click Data Sources and click Next.7. Select TNPM.JDBC data source from the list and click Next.8. In the Select Objects page, expand Tables. You can see the new virtual tables

that are created.9. Select the tables to import and click Next.

10. In the Generate Relationships page, accept the default values and clickImport. You can see the generated common pack data model in the ProjectExplorer pane.

Query conditions and limitations

Query conditionsv For each virtual table, mandatory keys are:

– Group information (group path or group_id)– Start date– End date

v If you do not provide the mandatory information, the Tivoli NetcoolPerformance Manager JDBC Driver searches based on the following information:– Group = lowest group level accessible by user– Start date = yesterday’s date– End date = today’s date

v Filter can be specified on where clausev Supported operators are:

– in– between– <– >– <=– >=

Limitationsv Column to column comparison:

Select resource_name from rfc_mib2_device_gstwhere group_path = ’NOC Reporting’And "COUNT(AP~Specific~SNMP~Devices~ICMP~Ping Replies Sent (per second))" >"COUNT(AP~Specific~SNMP~Devices~ICMP~Pings Received (per second))";

v Literal in Select clause:

Chapter 7. Getting started with common reporting 25

Page 36: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Select 'xyz' from rfc_mib2_device_ratswhere group_path = ’NOC Reporting’And "COUNT(AP~Specific~SNMP~Devices~ICMP~Ping Replies Sent (per second))" >"COUNT(AP~Specific~SNMP~Devices~ICMP~Pings Received (per second))";

v Literal to literal condition:Select * from rfc_mib2_device_gstwhere 1 = 2

v Repetitive selection of same column:Select resource_name, resource_name from rfc_mib2_device_ratswhere group_path = ’NOC Reporting';

Note: GST or RATS date column does not return timestamp.v NOT operator:

Select resource_name, resource_name from rfc_mib2_device_gstwhere group_path != ’NOC Reporting';

v LIKE operator:Select resource_name, resource_name from rfc_mib2_device_ratswhere group_path like ’NOC Reporting%';

v Grouping by column name:Select resource_name, count(1) from rfc_mib2_device_gstwhere group_path ’NOC Reporting ';group by location

Note: Grouping is only supported in RTS on time rounding.v Aggregation based on filtered result:

Select count(1) from rfc_mib2_device_gstwhere group_path ’NOC Reporting 'and location='KL';

v Ordering of result:Select resource_name, location from rfc_mib2_device_ratswhere group_path = ’NOC Reporting'Order by resource_name

v Limiting of result:Select resource_name, location from rfc_mib2_device_gstwhere group_path = ’NOC Reporting'And rownum < 10[or limit 1,10 ]

Table 4. Sample SQL Select queries in the virtual tables

Virtual table SQL query

GST Select name, group_path, start_date, end_date,"SUM(AP~Generic~Universal~Throughtput~Outbound Volume (PDUs))","COUNT(AP~Generic~Universal~Throughtput~Outbound Volume (PDUs))","MAX(AP~Generic~Universal~Throughtput~Outbound Volume (PDUs))","MIN(AP~Generic~Universal~Throughtput~Outbound Volume (PDUs))","AVG(AP~Generic~Universal~Throughtput~Outbound Volume (PDUs))"from rfc_mib2_interface_qstwhere start_date = ’2014-02-19’and end_date = ’2014-01-20’and granularity = ’1 Day’and group_path = ’Cognos Reporting~RFC MIB II’;

26 Installing and Configuring Common Packs

Page 37: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Table 4. Sample SQL Select queries in the virtual tables (continued)

Virtual table SQL query

RTS Select name, path, timestamp,"AP~Generic~Interface~Delivered Packets","AP~Generic~Universal~Throughput~Outbound Volume (octets)","DisplaySpeed"from rfc_mib2_interface_rtswhere timestamp > ’2014-02-19 00:00:00’and timestamp < ’2014-02-20 00:00:00’and group_path = ’Cognos Reporting~RFC MIBII~Interface’and name = ’10.212.4.25_if<2>’;

RATS Select name, path, start_time, end_time,"min(AP~Generic~Universal~Throughput~Outbound Volume (PDUs))"from rfc_mib2_intreface_ratswhere start_time >= ’2014-02-19 00:00:00’and end_time <= ’2014-02-20 00:00:00’and granularity = ’60’and group_path = ’Cognos Reporting~RFC MIB II~Interface’

The supported granularity for the tables is as follows:daydayshourhoursminminsminuteminutesmonthmonthsrawsecondsecondsweekweeks

Creating a package in Framework ManagerUse these steps to create a package in Framework Manager by using the commonpack data model that is imported.

Procedure1. Click Packages folder, and from the Actions menu, click Create > Package.2. In the Provide Name page, type the name for the package and, if you want, a

description and screen tip.3. Click Next.4. In the Define objects page, Select the objects that you want.

Note: Framework Manager supports ctrl+shift and alt+shift functionality.Use these keystrokes to select multiple objects that you wish to include orhide in the cube. For example, if you wish to only include two items in alarge branch, select the entire branch, then use ctrl+shift to unselect theitems you wish to include, and hide the remaining selected items.

5. In the Select the Function Lists page, select the function lists you want.6. Click Finish.7. When you are prompted to open the Publish Package Wizard, click Yes.

Chapter 7. Getting started with common reporting 27

Page 38: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

8. In the Select Location page, accept the default values and click Next.9. Accept the default access permissions for the package and click Next.

10. Click Publish.11. Select Exit this wizard and click Finish.

Creating a report in Report StudioWhen you create a report, you are creating a report specification. The reportspecification defines the queries and prompts that are used to retrieve data and thelayouts and styles that are used to present the data. For simplicity, the reportspecification is named by the same name as the report.

Procedure1. In the IBM Cognos Connection home page, on the Public Folders tab, go to the

package that you want to use as a data source.2. From the Launch menu in the upper right corner, click the Report Studio link.3. Click Create new.4. Choose a basic report layout and click OK. For example, List. The basic report

layout appears in the report page.5. From the Source tab, drag data items to the report object. A flashing black bar

indicates where you can drop a data item. Data items in the report appear onthe Data Items tab.

6. From the File menu, click Save or click Save as to save a copy of the reportunder a different name.

7. From the Run menu, click one of the options to produce the report in theformat you want.You can produce a report in HTML, PDF, CSV, various Microsoft Excel formats,and XML. You cannot produce a report in CSV format if you have more thanone query that is defined in the report unless the additional queries are usedfor prompts.The report runs in IBM Cognos Viewer. After the report has finished running,you can run the report again in the same format or in a different format. If yourun the report again in CSV or XLS format, the report appears in a newbrowser window.

28 Installing and Configuring Common Packs

Page 39: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 8. Enabling multitenancy

Multi-tenancy provides the capability to support multiple customers ororganizations (tenants) by using a single deployment of an application, whileensuring that each tenant can access only the data that they are authorized to use.Such applications are called multi-tenant applications.

Multi-tenant applications minimize the extra costs associated with theseenvironments. IBM Cognos Business Intelligence provides built-in multi-tenancycapabilities. Before you can use IBM Cognos multi-tenancy, you must modifyconfiguration files in your IBM Cognos Business Intelligence installation.

To enable Cognos® multitenancy capabilities, you set advanced authenticationproperties on all the computers where the Content Manager is configured, andthen restart the IBM® Cognos service. For more information about howmultitenancy is enables in common pack data models that are created with thehelp of Tivoli Netcool Performance Manager JDBC Driver, seehttps://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Netcool%20Performance%20Manager/page/Enable%20TNPM%20(Wireline)%20Multi-tenancy%20in%20Cognos%2010.2.1%20(Standalone)Related information:

Multiple Tenant Environments in Cognos 10.2

© Copyright IBM Corp. 2015 29

Page 40: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

30 Installing and Configuring Common Packs

Page 41: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Chapter 9. Troubleshooting Tivoli Netcool PerformanceManager JDBC Driver and Common reporting

When you encounter a problem with using Tivoli Netcool Performance ManagerJDBC Driver components, the first thing to do is to check the detailed log files forthat component. Most issues can be solved by referring to the log files.

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

Troubleshooting the datasource connection failure while installingJDBC Driver

SymptomsWhen you are installing the JDBC Driver, you might notice the followingdatasource connection failure error:

Resolving the problemTo resolve this issue, follow these steps:1. In Cognos server, go to the path where tnpm.dar file is downloaded. The

default location of darfiles is /<tmp>/.cache/darfiles.2. Delete the tnpm.dar file.3. Test the datasource connection again.

© Copyright IBM Corp. 2015 31

Page 42: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

32 Installing and Configuring Common Packs

Page 43: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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

Page 44: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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:

34 Installing and Configuring Common Packs

Page 45: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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 35

Page 46: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

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.

36 Installing and Configuring Common Packs

Page 47: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Additional copyright notices

The following copyright information is for software used by Tivoli NetcoolPerformance Manager Wireline Component.

Tcl 8.3.3, Combat/TCL 0.7.3, Combat/TCL 0.7.5, TclX 8.3, TK 8.3.3

This software is copyrighted by the Regents of the University of California, SunMicrosystems, Inc., Scriptics Corporation, and other parties. The following termsapply to all files associated with the software unless explicitly disclaimed inindividual files.

The authors hereby grant permission to use, copy, modify, distribute, and licensethis software and its documentation for any purpose, provided that existingcopyright notices are retained in all copies and that this notice is included verbatimin any distributions. No written agreement, license, or royalty fee is required forany of the authorized uses. Modifications to this software may be copyrighted bytheir authors and need not follow the licensing terms described here, provided thatthe new terms are clearly indicated on the first page of each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANYPARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIALDAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITSDOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THEAUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN"AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

GOVERNMENT USE: If you are acquiring this software on behalf of the U.S.government, the Government shall have only "Restricted Rights" in the softwareand related documentation as defined in the Federal Acquisition Regulations(FARs) in Clause 52.227.19 (c) (2). If you are acquiring the software on behalf of theDepartment of Defense, the software shall be classified as "Commercial ComputerSoftware" and the Government shall have only "Restricted Rights" as defined inClause 252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the authorsgrant the U.S. Government and others acting in its behalf permission to use anddistribute the software in accordance with the terms specified in this license.

SCOTTY Stack

This software is copyrighted by Juergen Schoenwaelder, the Technical University ofBraunschweig, the University of Twente, and other parties. The following termsapply to all files associated with the software unless explicitly disclaimed inindividual files.

The authors hereby grant permission to use, copy, modify, distribute, and licensethis software and its documentation for any purpose, provided that existing

© Copyright IBM Corp. 2015 37

Page 48: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

copyright notices are retained in all copies and that this notice is included verbatimin any distributions. No written agreement, license, or royalty fee is required forany of the authorized uses. Modifications to this software may be copyrighted bytheir authors and need not follow the licensing terms described here, provided thatthe new terms are clearly indicated on the first page of each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANYPARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIALDAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITSDOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THEAUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN“AS IS” BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

Various copyrights apply to this package, listed in 3 separate parts below. Pleasemake sure that you include all the parts. Up until 2001, the project was based atUC Davis, and the first part covers all code written during this time. From 2001onwards, the project has been based at SourceForge, and Networks AssociatesTechnology, Inc hold the copyright on behalf of the wider Net-SNMP community,covering all derivative work done since then. An additional copyright section hasbeen added as Part 3 below also under a BSD license for the work contributed byCambridge Broadband Ltd. to the project since 2001.

Part 1: CMU/UCD copyright notice: (BSD like)

Copyright © 1989, 1991, 1992 by Carnegie Mellon University

Derivative Work - 1996, 1998-2000

Copyright © 1996, 1998-2000 The Regents of the University of California

All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the name of CMUand The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIMALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BELIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES ORANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATAOR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITHTHE USE OR PERFORMANCE OF THIS SOFTWARE.

38 Installing and Configuring Common Packs

Page 49: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Part 2: Networks Associates Technology, Inc copyright notice (BSD)

Copyright © 2001, Networks Associates Technology, Inc

All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:v Redistributions of source code must retain the above copyright notice, this list of

conditions and the following disclaimer.v Redistributions in binary form must reproduce the above copyright notice, this

list of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

v Neither the name of the NAI Labs nor the names of its contributors may be usedto endorse or promote products derived from this software without specificprior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Part 3: Cambridge Broadband Ltd. copyright notice (BSD)

Portions of this code are copyright © 2001, Cambridge Broadband Ltd.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:v Redistributions of source code must retain the above copyright notice, this list of

conditions and the following disclaimer.v Redistributions in binary form must reproduce the above copyright notice, this

list of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

v The name of Cambridge Broadband Ltd. may not be used to endorse or promoteproducts derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER “AS IS” ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITEDTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THECOPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

Additional copyright notices 39

Page 50: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

BLT 2.4u

Portions (c) 1993 AT&T, (c) 1993 - 1998 Lucent Technologies, (c) 1994-1998 SunMicrosystems, Inc., and (c) 1987-1993 The Regents of the University of California.

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the names ofAT&T, Lucent Technologies Inc., Sun Microsystems, Inc. and The Regents of theUniversity of California not be used in advertising or publicity pertaining todistribution of the software without specific written permission.

THE COPYRIGHT HOLDERS AND OTHER CONTRIBUTORS DISCLAIM ALLWARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL THE COPYRIGHT HOLDERS OR OTHER CONTRIBUTORS BE LIABLEFOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANYDAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA ORPROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITHTHE USE OR PERFORMANCE OF THIS SOFTWARE.

CMU-SNMP 1.14

CMU/UCD copyright notice: (BSD like)

Copyright 1989, 1991, 1992 by Carnegie Mellon University

Derivative Work - 1996, 1998-2000 Copyright 1996, 1998-2000 The Regents of theUniversity of California

All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the name of CMUand The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIMALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BELIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES ORANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATAOR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH

40 Installing and Configuring Common Packs

Page 51: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

THE USE OR PERFORMANCE OF THIS SOFTWARE.

Scotty 2.8, incrTCL 3.0, [incr TCL] 3.2

Portions Copyright (c) 1987-1994 The Regents of the University of California.Copyright (c) 1994-1995 Sun Microsystems, Inc.

This software is copyrighted by the Regents of the University of California, SunMicrosystems, Inc., and other parties. The following terms apply to all filesassociated with the software unless explicitly disclaimed in individual files.

The authors hereby grant permission to use, copy, modify, distribute, and licensethis software and its documentation for any purpose, provided that existingcopyright notices are retained in all copies and that this notice is included verbatimin any distributions. No written agreement, license, or royalty fee is required forany of the authorized uses. Modifications to this software may be copyrighted bytheir authors and need not follow the licensing terms described here, provided thatthe new terms are clearly indicated on the first page of each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANYPARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIALDAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITSDOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THEAUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANYWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN"AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NOOBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,ENHANCEMENTS, OR MODIFICATIONS.

RESTRICTED RIGHTS: Use, duplication or disclosure by the government is subjectto the restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in TechnicalData and Computer Software Clause as DFARS 252.227-7013 and FAR 52.227-19.

Portions Copyright (c) 1993-1998 Lucent Technologies, Inc.

Permission to use, copy, modify, and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appear in all copies and that both that the copyright notice andwarranty disclaimer appear in supporting documentation, and that the names ofLucent Technologies any of their entities not be used in advertising or publicitypertaining to distribution of the software without specific, written priorpermission.

Lucent disclaims all warranties with regard to this software, including all impliedwarranties of merchantability and fitness. In no event shall Lucent be liable for anyspecial, indirect or consequential damages or any damages whatsoever resultingfrom loss of use, data or profits, whether in an action of contract, negligence orother tortuous action, arising out of or in connection with the use or performanceof this software.

Additional copyright notices 41

Page 52: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

UCD SNMP 4.2.5

Portions Copyright 1989, 1991, 1992 by Carnegie Mellon University. DerivativeWork - 1996, 1998-2000, Copyright 1996, 1998-2000 The Regents of the University ofCalifornia All Rights Reserved

Permission to use, copy, modify and distribute this software and its documentationfor any purpose and without fee is hereby granted, provided that the abovecopyright notice appears in all copies and that both that copyright notice and thispermission notice appear in supporting documentation, and that the name of CMUand The Regents of the University of California not be used in advertising orpublicity pertaining to distribution of the software without specific writtenpermission.

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIMALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALLIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENTSHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BELIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES ORANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE, DATAOR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITHTHE USE OR PERFORMANCE OF THIS SOFTWARE.

Portions Copyright: (c) 2001-2003, Networks Associates Technology, Inc, (c)2001-2003, Cambridge Broadband Ltd, (c) 2003-2005, Sparta, Inc., (c) 2004, Cisco,Inc and Information Network Center of Beijing University of Posts andTelecommunications, (c) Fabasoft R&D Software GmbH & Co KG, [email protected].

All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list ofconditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer in the documentation and/or othermaterials provided with the distribution.

3. Neither the names of Networks Associates Technology, Inc, CambridgeBroadband Ltd., Sparta, Inc., Cisco, Inc, Beijing University of Posts andTelecommunications, Fabasoft R&D Software GmbH & Co KG or any of itssubsidiaries, brand or product names, nor the names of their contributors may beused to endorse or promote products derived from this software without specificprior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

42 Installing and Configuring Common Packs

Page 53: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

JDOM 1.0

Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin. All rights reserved.

Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list ofconditions, and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, thislist of conditions, and the disclaimer that follows these conditions in thedocumentation and/or other materials provided with the distribution.

3. The name "JDOM" must not be used to endorse or promote products derivedfrom this software without prior written permission. For written permission, pleasecontact <request_AT_jdom_DOT_org>.

4. Products derived from this software may not be called "JDOM", nor may"JDOM" appear in their name, without prior written permission from the JDOMProject Management <request_AT_jdom_DOT_org>.

In addition, we request (but do not require) that you include in the end-userdocumentation provided with the redistribution and/or in the software itself anacknowledgement equivalent to the following:

"This product includes software developed by the JDOM Project(http://www.jdom.org/)." Alternatively, the acknowledgment may be graphicalusing the logos available at http://www.jdom.org/images/logos.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS ORTHE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

This software consists of voluntary contributions made by many individuals onbehalf of the JDOM Project and was originally created by Jason Hunter<jhunter_AT_jdom_DOT_org> and Brett McLaughlin <brett_AT_jdom_DOT_org>.For more information on the JDOM Project, please see <http://www.jdom.org/>.

Additional copyright notices 43

Page 54: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

Regex 1.1a

Copyright (C) 1996, 1999 Vassili Bykov. It is provided to the Smalltalk communityin hope it will be useful.

1. This license applies to the package as a whole, as well as to any component of it.By performing any of the activities described below, you accept the terms of thisagreement.

2. The software is provided free of charge, and ``as is'', in hope that it will beuseful, with ABSOLUTELY NO WARRANTY. The entire risk and all responsibilityfor the use of the software is with you. Under no circumstances the author may beheld responsible for loss of data, loss of profit, or any other damage resultingdirectly or indirectly from the use of the software, even if the damage is caused bydefects in the software.

3. You may use this software in any applications you build.

4. You may distribute this software provided that the software documentation andcopyright notices are included and intact.

5. You may create and distribute modified versions of the software, such as portsto other Smalltalk dialects or derived work, provided that:

a. any modified version is expressly marked as such and is not misrepresented asthe original software;

b. credit is given to the original software in the source code and documentation ofthe derived work;

c. the copyright notice at the top of this document accompanies copyright noticesof any modified version.

44 Installing and Configuring Common Packs

Page 55: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and
Page 56: Installing and Configuring Common Packs · It also processes online calculations and detects real-time threshold violations. ... technical experts who provide their perspectives and

����

Printed in USA