This information was developed for products and
services offered in the U.S.A. IBM
products, services, or features discussed in this
document in other countries. Consult your local IBM
representative for information about the products and
services currently available in your area. Any reference to
an IBM product, program, or service is not intended to
state or imply that only that IBM product, program, or
service may be used. Any functionally equivalent
product, program, or service that does not infringe any
IBM intellectual property right may be used instead.
However, it is the user’s responsibility to evaluate and
verify the operation of any non-IBM product, program,
or service.
IBM may have patents or pending patent applications
covering subject matter described in this document. The
furnishing of this document does not give you any
license to these patents. You can send license inquiries,
in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS)
information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing,
to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the
United Kingdom or any other country where such
provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES
CORPORATION PRO VIDES THIS PUBLICA TION
"AS IS" WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this
statement might not apply to you.
This information could include technical inaccuracies or
typographical errors. Changes are periodically made to
the information herein; these changes will be
®
may not offer the
incorporated in new editions of the publication. IBM
may make improvements and/or changes in the
product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web
sites are provided for convenience only and do not in any
manner serve as an endorsement of those Web sites . The
materials at those W eb sites are not part of the materials
for this IBM product and use of those Web sites is at
your own risk.
IBM may use or distribute any of the information you
supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who wish to have information
about it for the purpose of enabling: (i) the exchange of
information between independently created programs
and other programs (including this one) and (ii) the
mutual use of the information which has been
exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758
U.S.A.
Such information may be available, subject to
appropriate terms and conditions, including in some
cases payment of a fee.
The licensed program described in this document and all
licensed material available for it are provided by IBM
under terms of the IBM Customer Agreement, IBM
International Program License Agreement or any
equivalent agreement between us.
Any performance data contained herein was determined
in a controlled environment. Therefore, the results
obtained in other operating environments may vary
significantly. Some measurements may have been made
on development-level systems and there is no guarantee
that these measurements will be the same on generally
available systems . Furthermore, some measurement may
have been estimated through extrapolation. Actual
results may vary. Users of this document should verify
the applicable data for their specific environment.
Information concerning non-IBM products was
obtained from the suppliers of those products, their
published announcements or other publicly available
sources. IBM has not tested those products and cannot
confirm the accuracy of performance, compatibility or
any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products
should be addressed to the suppliers of those products.
All statements regarding IBM’s future direction or intent
are subject to change or withdrawal without notice, and
represent goals and objectives only.
This information is for planning purposes only. The
information herein is subject to change before the
products described become available.
This information contains examples of data and reports
used in daily business operations. To illustrate them as
completely as possible, the examples include the names
of individuals, companies, brands, and products. All of
these names are fictitious and any similarity to the names
and addresses used by an actual business enterprise is
entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs
in source language, which illustrate programming
Trademarks
techniques on various operating syst ems . You may copy,
modify, and distribute these sample programs in any
form without payment to IBM, for the purposes of
developing, using, marketing or distributing application
programs conforming to the application programming
interface for the operating system for which the sample
programs are written. These examples have not been
thoroughly tested under all conditions. IBM, therefore,
cannot guarantee or imply reliability, serviceability, or
function of these programs. You may copy, modify, and
distribute these sample programs in any form without
payment to IBM for the purposes of developing, using,
marketing, or distributing application programs
conforming to IBM's application programming
interfaces.
If you are viewing this information in softcopy form, the
photographs and color illustrations might not appear.
AIX®, DB2®, developerWorks®, eServer, i5/OS®,
®
IBM
, the IBM logo®, IBMLink, iSeries®, Lotus®,
Netcool
Passport Advantage
OS/390
Enterprise Console
®
, Netcool/Proviso®, OMEGAMON®,
®
, OS/400®, Tivoli®, the Tivoli logo®, Tivoli
®
, pSeries®, Rational®, Redbooks®,
®
, WebSphere®, and zSeries® are
trademarks or registered trademarks of International
Business Machines Corporation in the United States,
other countries, or both.
®
Intel
is a registered trademark of Intel Corporation or
its subsidiaries in the United States, other countries, or
both.
Linux is a trademark of Linus Torvalds in the United
States, other countries, or both.
Microsoft
®
and Windows® are registered trademarks of
Microsoft Corporation in the United States, other
countries, or both.
Java™ and all Java-based
trademarks and logos are
trademarks or registered
trademarks of Sun Microsystems,
Inc. in the United States, other
countries, or both.
Other company, product, and service nam es may be
trademarks or service marks of others.
Copyright International Business Machines
Corporation 2008. All rights reserved.
US Government Users Restricted Rights — Use,
duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.
UNIX® is a registered trademark of The Open Group in
the United States and other countries.
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-Wxvii
Contents
xviiiNetcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
Preface
This manual describes the Netcool/Proviso Cisco IP Telephony Technology Pack, focusing on the Cisco IP
Telephony environment. Specifically, the manual describes the reports for displaying information about the
devices and technologies that operate in the Cisco IP T elephony environment. The manual also describes the data
collection model, properties, resources, collection formulas, and metrics that the Cisco IP Telephony T echnology
Pack provides to create the associated reporter sets.
Note: This technology pack supports the Cisco CallManager (CCM) environment and its new implementation,
the Cisco Unified Call Manager (CUCM) environment. Where this guide refers to Cisco CallManager or CCM,
it also applies to Cisco Unified Call Manager (CUCM), unless an explicit distinction is made.
Audience
The audiences for this manual are the network administration engineers at IBM customer sites who will install,
configure, and use the Cisco IP Telephony Technology Pack as part of their Netcool/Proviso installation. IBM
Professional Services engineers may also find this manual useful.
To install and use the Cisco IP Telephony Technology Pack, you should have a working knowledge of the
following subjects:
•Netcool/Proviso DataMart
•TCP/IP networks
•Telecom network management
•Administration of the operating system
The audiences should also be familiar with the specific technology that the Cisco IP Telephony Technology Pack
deals with, in this case Cisco IP Telephony.
Organization
This guide is organized as follows:
•Chapter 1, Introduction
Provides a general introduction to technology packs.
•Chapter 2, Supported Reports
Provides information about the reports that the Cisco IP Telephony Technology Pack provides for each
device operating in the Cisco IP Telephony environment.
•Chapter 3, Devices and Services
Describes the devices and services that the Cisco IP Telephony Technology Pack supports.
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-Wxix
Preface
•Chapter 4, Element and Sub-Element Properties
Describes the properties that the Cisco IP Telephony Technology Pack discovers during the inventory
process.
•Chapter 6, Sub-Element Grouping Rules
Describes the sub-element collection grouping rules and the NOC repor ting grouping rules that the Cisco
IP Telephony Technology Pack defines.
•Chapter 5, Defined Resources
Provides information about the elements and sub-elements that the technology pack defines in the Proviso
database.
•Chapter 7, Collection Formulas
Provides information about the SNMP and bulk collection formulas included in the Cisco IP Telephony
Technology Pack.
•Chapter 8, Discovery Formulas
Provides information about the Discovery formulas that the Cisco IP Telephony T ec hnology Pack pro vides
for devices operating in the Cisco IP Telephony environment.
•Appendix A, Configuration
Describes how to configure the Cisco IP Telephony Technology Pack.
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-Wxxi
Preface
xxiiNetcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
Chapter 1: Introduction
This chapter discusses the following topics:
Topic Page
Overview1
How is the Data Collected?1
How is the Data Processed and Loaded into the Database?2
How is the Data Reported?3
Overview
Netcool/Proviso Technology Packs are individually installed modules that contain discovery, grouping,
collection, and reporting instructions created by T ec hnology Pack dev elopers or Professional Services personnel
for a specific network technology or network equipment provider, such as Cisco IP Telephony.
Once installed, a Technology Pack “programs” Netcool/Proviso to inventory and group specific network
resources, perform mathematical calculations on raw or aggregated data streams collected from these resources ,
and produce key performance monitoring metrics that are stored on the Netcool/Proviso database. R eporter sets
designed for each Tec hnology Pack query the database for this information and display the results on a web portal
in the form of specialized report tables, graphs, and charts.
This chapter provides an overview of how T echnology Packs work with Netcool/Proviso to collect, process , load,
and report data from a network environment.
How is the Data Collected?
Inventory
After a Netcool/Proviso Technology Pack has been installed, an inventory process must be r u n so that the
Technology Pack’s target network resources can be identified and modeled within Netcool/Proviso as subelements. Sub-ele ments must be cr eated before da ta from any netw ork resource can be collected, processed, and
stored in the database.
How sub-elements are discovered depends on whether the target resources are SNMP resources or non-SNMP
resources:
•For SNMP network resources , a T echnology Pack provides a discovery formula. Discovery formulas are used
to evaluate network resources, determine which resources become sub-elements, and set values for items
defined as properties in the for mula. Once all the sub-elements have been discovered and created in the
database, the inventory process organizes the sub-elements according to the grouping rules provided by a
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W1
Chapter 1: Introduction
Technology Pack. The grouping rules use the properties and values defined within inventory formulas or
adaptor design files to filter the sub-elements into their appropriate collection or reporting groups.
•For non-SNMP network resources, a Te c hnology Pac k provides a Bulk Adaptor Design File. Bulk Adaptor
Design Files define how data fields that reside in files generated by network resources are used to create subelements and set values for items defined as properties.
During the database synchronization phase of the inventory process, the list of discovered sub-elements is
compared to what exists in the database. Newly discovered sub-elements are assigned a resource identifier (RID)
and timestamp, and the database uses both items to create a new entry for the sub-element to reflect the known
state of the network inventory.
Collection
Following the completion of the inventory process, Netcool/Proviso is ready to collect performance data for a
Technology Pack’s target network resources. A Technology Pack provides Netcool/Proviso with collection
formulas that instruct a DataLoad collector resid ing in a DataChannel to collect specific types of performance
data against a particular sub-element.
The types of collection formulas applied to the data depend on whether the sub-element is an SNMP resource
or non-SNMP resource:
formulas instruct the SNMP Collector to take the data gathered during a specified collection interval,
perform some mathematical operation on the data, and output the result as a performance metric.
•For non-SNMP network resources , a Technology Pack provides Bulk collection formulas . A Bulk collection
formula, unlike an SNMP collection formula, has no executable instructions. A Bulk collection formula
consists of a metric name that is mapped by the Bulk Adaptor Design File to a statistic that resides in the
input file generated by a network resource.
Either type of collection formula outputs a metric and corresponding unique metric identifier (MID) that are
passed along the DataChannel to the Complex Metric Engine for processing.
How is the Data Processed and Loaded into the Database?
The Complex Metric Engine (CME) is a component in the DataChannel that performs calculations on data
gathered by the SNMP or Bulk collectors deployed in a network. These calculations include the following:
•Pre-defined formulas that are provided by a Technology Pack
•User-defined formulas created using the CME Formula API
•Time aggregations for sub-elements
In addition to performing calculations on the data stream in the DataChannel, the CME also buffers and sorts
metric records according to their RIDs and MIDs to optimize ho w the data and metrics are stored in the database.
2 Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
Chapter 1: Introduction
CME Operation
The CME is designed to work with data that is gathered over the space of one hour. Within that hour, there are
several distinct phases that characterize the operation of the CME:
•Loading Phase
•Building Phase
•Processing Phase
•Output Phase
Loading Phase
During the beginning of each hour, the CME creates a new netw ork configuration model based on the inv entory
structure that exists in the database at that time. This model is used as a snapshot of the network environment
and serves as the basis for all metric processing for the entire duration of the hour. At the end of the hour, the
CME polls the database for any changes that have been made to the inventory and creates a new network
configuration model for the next hour.
As the CME reloads its configuration hourly, any metrics produced by sub-elements following the last polling
period are rejected by the CME until the beginning of the next hour.
Building Phase
Once the current configuration model has been built, the CME creates a table of sub-elements and metrics that
are expected for the current hour. The CME uses the RIDs and MIDs to build the table and determine which
metrics should be arriving from the collectors. The table also specifies how resources are related, and determines
if there are any CME formulas that must be applied to a sub-element’s metrics once the data is gathered.
Processing Phase
Whenever new data arrives at the CME, it is evaluated and stored in the appropriate ta ble location, along with any
Resource Aggregation information. Once the input and processing dependencies for a metric in the table have
been met, the CME processes the metrics and stores the data until the end of the hour.
Output Phase
At the end of the current hour, the CME outputs everything in memory to the Hourly and Daily Loaders. The
data sent to the database loaders includes the sorted data for the current hour, and resource and group
aggregations for each of the processing periods up to the current time. The Hourly Loader computes group and
resource aggregations, while the Daily Loader creates metric statistics and inserts the data into the database.
How is the Data Reported?
The data collected, processed, and stored in the database by Netcool/Proviso is organized and output for
customers using reporter sets that are designed by developers and Professional Services personnel for a specific
Technology Pack.
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W3
Chapter 1: Introduction
A Tec hnology Pack reporter set is a related group of reports that provide performance information on a specific
set of devices or resources that exist in a network. Each report consists of a series of queries that retriev e related
sub-elements and their corresponding metrics from the database using the RIDs and MIDs assigned during the
inventory and collection processes. The retrieved results are then organized within the report and are displayed
on a web portal in the form of tables, graphs, and charts.
A Technology Pack provides a variety of reports and charts, including:
•Resource Summary Reports (RSTs) (sometimes referred to as Resource Summary Tables) aggregate data
across time for an individual sub-element and defi ne t h e s ta tistics that are relevant for a measure of its
network performance.
•Group Summary Reports (GSTs) (sometimes referred to as Group Summary Tables) aggregate data across
both time and sub-elements, and define the statistics that are relev ant for a measure of netw ork performance
for a group of resources.
•Detail Charts (DCs) display raw data for a metric that has been aggregated for an individual sub-element over
a particular period of time.
•Dashboards display a series of abbreviated tables and charts that provide an overall summary of the metrics
collected for the target network resource supported by the Technology Pack.
•Timeseries charts present time series information, where the x axis is time and the y axis is the data value.
•TopN reports list the N highest values during a specified time range for a specific m etric.
•Resource Distribution charts (often referred to as pie charts) show the distribution of resources across
specific ranges. Typically, a legend for the Resource Distribution chart appears in the report.
•Resource Over Threshold Tables (RTTs) display a list of resources that have violated their threshold for a
specific metric. T ypically , users na vigate to an RTT from a Group Summary Table (GST), using the threshold
overflow cell navigation link.
•Ratio charts show the relationship of a single metric among different resources or a single resource among
different metrics.
4 Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
NOTES
Chapter 1: Introduction
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W5
Chapter 1: Introduction
6 Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
Chapter 2: Supported Reports
This chapter discusses the following topics:
Topic Page
Overview7
Reporter Sets7
Reports9
Overview
The Cisco IP Telephony T ec hnology Pack supplies a set of reports suitable for displaying information about the
devices and activity associated with the Cisco IP Telephony environment.
Reports contain metrics that are generated by the formulas that this technology pack provides. Metric names are
the same as the names of the formulas that generate them. For information about a metric that is listed for a
particular report, see the description of the associated formula in the collection formula chapter of this guide.
This chapter includes information to help you navigate to a particular report on the DataView portal. This
navigation path is the same as the path where the report has been deployed through the DataMart Resource
Editor. Note, however, that some reports are not explicitly deployed on the portal navigation path. You can
display such a report by "drilling down" to it from other reports.
For information about understanding report types, creating reports, configuring reports, viewing and working
with reports, and deploying reports, see the
assumes an understanding of the report-related topics discussed in the
Netcool/Proviso DataView User’s Guide. This Tec hnology Pack User’ s Guide
Netcool/Proviso DataView User’s Guide.
Reporter Sets
Reporter Set Tree
This technology pack provides the reporter sets listed below. The list presents the reporter sets as they appear in
the DataView Navigator tree structure:
AP Cisco VOIP Pack
...Global Customer Reports
...Call Detail Record
......Cluster
......Extension
......K-Factor
......Codec
Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W7
Chapter 2: Supported Reports
...Infrastructure
......CallManager Server
......PSTN Gateway
.........Interface
.........Device
.........DSP Card
......Media Devices
......Gatekeeper
.........Device
.........Interface
......Perfmon
8 Netcool/Proviso Cisco IP Telephony Technology Pack User’s Guide, Version 4.3-W
Loading...
+ 486 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.