IBM Tivoli Netcool Performance Manager 1.4.1Document Revision R2E1

Documentation Overview

���

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

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

Contents

About this publication . . . . . . . . vIntended audience . . . . . . . . . . . . vWhat this publication contains . . . . . . . . vTivoli Netcool Performance Manager - WirelineComponent. . . . . . . . . . . . . . . vService Management Connect . . . . . . . . viTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . viiSupport information . . . . . . . . . . . viiConventions used in this publication . . . . . . vii

Typeface conventions . . . . . . . . . . vii

Chapter 1. Documents for Wireline andWireless components . . . . . . . . . 1

Chapter 2. Technical Notes - Wirelinecomponent . . . . . . . . . . . . . 5

Chapter 3. Online help . . . . . . . . 7

Chapter 4. Supporting documentation . . 9

Notices . . . . . . . . . . . . . . 11Terms and conditions for product documentation. . 13

Trademarks . . . . . . . . . . . . . . 14

© Copyright IBM Corp. 1997, 2015 iii

iv IBM Tivoli Netcool Performance Manager: Documentation Overview

About this publication

IBM Tivoli Netcool Performance Manager, Version 1.4.1 is a bundled productconsisting of two main components. A wireline component (formerly Tivoli®

Netcool/Proviso), and a wireless component (formerly Tivoli Netcool PerformanceManager for Wireless).

The Installing Tivoli Netcool Performance Manager - Wireline Component tells youhow to install and configure Tivoli Netcool Performance Manager by using Oracleand DB2® databases.

Note: If you are upgrading Tivoli Netcool Performance Manager, see the IBMTivoli Netcool Performance Manager Upgrade Guide - Wireline component.

Important: Before installing Tivoli Netcool Performance Manager, you are advisedto read the Installing Tivoli Netcool Performance Manager - Wireline Component.Release notes can contain information specific to your installation that is notcontained in this guide. Failure to consult the release notes might result in acorrupted, incomplete, or failed installation.

Intended audienceThe audience for this manual is anyone wishing to learn more about TivoliNetcool® Performance Manager - Wireline and Wireless component, and thedocumentation that has been created to describe it.

What this publication containsThis publication contains the following sections:v Chapter 1, “Documents for Wireline and Wireless components,” on page 1v Chapter 2, “Technical Notes - Wireline component,” on page 5v Chapter 3, “Online help,” on page 7v Chapter 4, “Supporting documentation,” on page 9

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.

© Copyright IBM Corp. 1997, 2015 v

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

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

The following figure shows the different Tivoli Netcool Performance Managermodules.

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

The documentation is available for viewing and downloading on the informationcenter at http://www-01.ibm.com/support/knowledgecenter/SSBNJ7/welcome.

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

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

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

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

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

vi IBM Tivoli Netcool Performance Manager: Documentation Overview

Related information:

Tivoli Netcool Performance Manager 1.4 community on developerWorks

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

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

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

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

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

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

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

About this publication vii

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

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

Monospace

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

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

Bold monospace

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

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

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

viii IBM Tivoli Netcool Performance Manager: Documentation Overview

Chapter 1. Documents for Wireline and Wireless components

The supporting documents for Tivoli Netcool Performance Manager 1.4.1 release.

Note: All the documents are in DITA format and are documented as per IBMStandards.

Common documents

Release NotesAddresses installation, upgrade, and other getting-started issues.

Quick Start GuideGets you started with a typical installation of Tivoli Netcool PerformanceManager.

Tivoli Netcool Performance Manager OverviewDescribes new features and enhancements in Tivoli Netcool PerformanceManager Version 1.4.1 product.

Wireline component

Configuration RecommendationsProvides all system requirements for Tivoli Netcool Performance Managerand lists all required software (such as Oracle and DB2). ConfigurationRecommendations is meant as a partner for the Installing Tivoli NetcoolPerformance Manager - Wireline Component and the Upgrading TivoliNetcool Performance Manager - Wireline Component.

Installing Tivoli Netcool Performance Manager - Wireline ComponentExplains how to install and provisionally configure Tivoli NetcoolPerformance Manager and attendant software (such as Oracle and DB2).

Upgrading Tivoli Netcool Performance Manager - Wireline ComponentExplains how to upgrade Tivoli Netcool Performance Manager 1.4 to TivoliNetcool Performance Manager 1.4.1.

Using and Administering DataViewExplains how to administer DataView, how to use DataView forperformance viewing and reporting, and how advanced users can useDataView to extend technology packs.

Configuring and Operating DataMartExplains how to configure DataMart, and how to use command line toolsto configure Tivoli Netcool Performance Manager.

Troubleshooting Tivoli Netcool Performance ManagerDescribes how to manage and troubleshoot problems with Tivoli NetcoolPerformance Manager. The guide also lists error messages that areproduced by DataChannel and DataLoad, with explanations and remedialactions. Replaces an earlier Technical Note.

Using Mass Data ExtractionDescribes how to use the Mass Data Extraction utility.

Database AdministrationDescribes how to optimize the use of the Tivoli Netcool PerformanceManager database.

© Copyright IBM Corp. 1997, 2015 1

Composite Subelement ConfigurationDescribes how Tivoli Netcool Performance Manager is used to modelservices within an inventory. Specifically, Composite SubelementConfiguration guide describes how to create composite subelementstructures to provide performance monitoring in an inventory.

Configuring and Using the Bulk DataLoad CollectorDescribes the Tivoli Netcool Performance Manager Bulk Collector anddiscusses the Tivoli Netcool Performance Manager PvLine file format thatis processed by the Bulk Collector.

Tivoli Netcool/OMNIbus Web GUI Integration - Wireline ComponentDescribes how to integrate IBM Tivoli Netcool /OMNIbus Web GUI withthe wireline component of Tivoli Netcool Performance Manager.

Command Line Interface ReferenceDescribes in reference format the command line tools that you can use toconfigure Tivoli Netcool Performance Manager.

CME Formula API Developer's ReferenceDescribes how to create and deploy ECMAScript files that use the TivoliNetcool Performance Manager Complex Metric Engine (CME) FormulaAPI.

DataAccess API GuideDescribes the DataAccess API that you can use to integrate the DataViewreporting system into an external portal. With DataAccess, you can useother graphical packages to query the database metrics directly.

Properties ReferenceDescribes the configurable properties that are used by Tivoli NetcoolPerformance Manager.

SNMP Formula Language ReferenceProvides detailed information about the SNMP formula language that isused by the technology packs for IBM Tivoli Netcool PerformanceManager. The intended audience is application engineers who need tomodify the formulas that are used by the technology packs.

Wireless component guides

Installing Tivoli Netcool Performance Manager - Wireless ComponentExplains how to install and provisionally configure Tivoli NetcoolPerformance Manager and attendant software (such as Oracle and DB2).

Upgrading Tivoli Netcool Performance Manager - Wireless ComponentExplains how to upgrade Tivoli Netcool Performance Manager 1.4 to TivoliNetcool Performance Manager 1.4.1 Wireless component.

Administering Tivoli Netcool Performance Manager - Wireless ComponentProvides instructions and general information on how to maintain andsupport.Tivoli Netcool Performance Manager

Using Tivoli Netcool Performance Manager - Wireless ComponentProvides instructions and general information on how to use Tivoli NetcoolPerformance Manager software to create and view performance analysisreports for a telecommunications network.

Deploying Tivoli Netcool Performance ManagerProvides guidelines to be used when you plan a deployment of a WirelessTivoli Netcool Performance Manager Component system.

2 IBM Tivoli Netcool Performance Manager: Documentation Overview

IBM Tivoli Monitoring Integration - Wireless ComponentDescribes the integration of Tivoli Netcool Performance Manager with IBMTivoli Monitoring.

Installing and Using Tivoli Netcool Performance Manager - Application Studio -Wireless Component

Describes how to install and use Tivoli Netcool Performance Manager -Application Studio, 1.4.1 on a Windows computer.

Tivoli Netcool Performance Manager for Wireless DevelopmentToolkit

Technology packs are independent modules that provide domain-specific anddata-neutral data models, vendor-specific metrics, and key performance indicators(KPIs), along with reports and graphs. Technology packs are available for bothwireless technologies and fixed/IP services and technologies. To know more aboutTivoli Netcool Performance Manager for Wireless Development Toolkitdocumentation, see Tivoli Netcool Performance Manager for Wireless DevelopmentToolkit Release Notes.

Chapter 1. Documents for Wireline and Wireless components 3

4 IBM Tivoli Netcool Performance Manager: Documentation Overview

Chapter 2. Technical Notes - Wireline component

Technical notes for this release.

Version Reporting tools for Tivoli Netcool Performance ManagerExplains how to use the Tivoli Netcool Performance Manager CLI utilitiesto obtain information about the Tivoli Netcool Performance Managerapplications installed on your system.

Avoiding Inventory Synchronization Issues With UBAExplains how to avoid inventory synchronization issues with UBA.

Moving Elements Between SNMP Collectors and Data ChannelsDescribes to move elements between SNMP collectors that share the sameDataChannel and also supports moving elements between separateDataChannels in your environment.

Portal and Technology Pack LocalizationDescribes how to localize the technology packs that display on the portal.

Performance GuidelinesDescribes how to get the best performance from your IBM Tivoli NetcoolPerformance Manager system.

© Copyright IBM Corp. 1997, 2015 5

6 IBM Tivoli Netcool Performance Manager: Documentation Overview

Chapter 3. Online help

The online help for this release.

Online help suites are provided for the following Tivoli Netcool PerformanceManager components:v DataMartv DataViewv Wireless Web Client

© Copyright IBM Corp. 1997, 2015 7

8 IBM Tivoli Netcool Performance Manager: Documentation Overview

Chapter 4. Supporting documentation

The supplementary documentation for this release.

The following documents are available for download from the Integrated ServiceManagement Library (ISM Library):https://www-304.ibm.com/software/brandcatalog/ismlibrary/v DataView Page Design Toolkit: Installation and User Guide – Describes how to

install and use the DataView Page Design Toolkit to create or update the pagedesign of DataView reports.

v High Availability documentation:

Tivoli Netcool Performance Manager Wireline Cluster Operations Guide 1.5Describes an example system that was configured to provide highavailability.

Tivoli Netcool Performance Manager Wireline High Availability Installationand Configuration 1.3

Describes the steps necessary to install and configure components ofTivoli Netcool Performance Manager in a highly available configuration.

Tivoli Netcool Performance Manager Wireline High Availability Overview 1.3Describes high availability solutions for the Tivoli Netcool PerformanceManager product.

Sun Cluster Tivoli Netcool Performance Manager Wireline Agent Guide 1.1Describes how Sun Clusters can be used with Tivoli NetcoolPerformance Manager to create a high availability Tivoli NetcoolPerformance Manager system.

To know more about Tivoli Netcool Performance Manager wireline on Red HatEnterprise Linux (RHEL) in a High Availability (HA) configuration with HighAvailability Disaster Recovery feature (HADR), seehttps://www.ibm.com/developerworks/community/wikis/form/api/wiki/2eed5677-1246-4b21-9e6a-3b0866204ca4/page/807bc74b-e4c1-4c18-ab69-d8b9da5dfea8/attachment/d5c45034-a140-465b-a11a-f4052ac3a094/media/High%20Availability%20for%20Tivoli%20Netcool%20Performance%20Manager%20133-v12.docx

Related information:

Tivoli Netcool Performance Manager 1.4 Wiki

© Copyright IBM Corp. 1997, 2015 9

10 IBM Tivoli Netcool Performance Manager: Documentation Overview

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. 1997, 2015 11

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:

12 IBM Tivoli Netcool Performance Manager: Documentation Overview

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 13

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.

14 IBM Tivoli Netcool Performance Manager: Documentation Overview

����

Printed in USA