Summary of the content on the page No. 1
IBM
Tivoli
Netcool/Proviso
Document Revision R2E2
Cisco IP Telephony 2.4.0.0 Technology Pack
User Guide
Summary of the content on the page No. 2
Note Before using this information and the product it supports, read the information in Notices on page 95. © Copyright IBM Corp. 2010 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Summary of the content on the page No. 3
Contents Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 2:
Summary of the content on the page No. 4
Contents Appendix A: UBA parameters (Tivoli Netcool/Proviso v4.4.3 and later). . . . . . . . . . . . . . .63 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 INSTANCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 INSTANCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 5
Chapter 1: Introduction This manual describes the IBM® Tivoli® Netcool®/Proviso® Cisco IP Telephony Technology Pack. Specifically, the manual describes the reports that display information about the devices and technologies that operate in the Cisco IP Telephony environment. Note: This technology pack supports the Cisco CallManager (CCM) environment and its new implementation, the Cisco Unified Communications Manager (CUCM) environment. Where this guide refers to CCM, the text also applies
Summary of the content on the page No. 6
Chapter 1: Introduction • Appendix B, Template file (Tivoli Netcool/Proviso pre-v4.4.3 only) Explains the edits that must be made to the pack-specific UBA parameters delivered in the pack template file. The Tivoli Netcool/Proviso product suite Tivoli Netcool/Proviso is made up of the following components: • Tivoli Netcool/Proviso DataMart is a set of management, configuration and troubleshooting GUIs that the Tivoli Netcool/Proviso system administrator uses to define policies and configurati
Summary of the content on the page No. 7
Chapter 2: Devices and Services This chapter discusses the following topics: Topic Page Overview 3 Summary of Device Technology 3 Sources of Collected Data 5 Prerequisites 8 Supported MIBs 9 Overview This chapter provides a summary of Cisco IP Telephony device technology that the Cisco IP Telephony Technology Pack is designed to support. Note: This technology pack supports the Cisco CallManager (CCM) environment and its new implementation, the Cisco Unified Communications Manager (CUCM)
Summary of the content on the page No. 8
Chapter 2: Devices and Services Categories of Service Reporting The technology pack provides the following categories of service reporting: •Voice Quality Management — Latency, jitter, packet loss, network bandwidth, Class-Based QoS, and element availability. • Call Signaling Management — Call setup and termination metrics, based on data from Call Detail Records (CDRs). • Converged Network Infrastructure Management — Network and system devices in charge of the Service and Voice Data Packets
Summary of the content on the page No. 9
Chapter 2: Devices and Services Sources of Collected Data The Tivoli Netcool/Proviso Cisco IP Telephony Technology Pack uses both SNMP and bulk data collection. The technology pack collects performance data from the following sources: Source of Collected Data Collection Type PSTN gateway, media gateway SNMP Gatekeeper SNMP Cisco CallManager Server SNMP Each server in the cluster has an SNMP agent Call Detail Records (CDR) Bulk Accounting data Call Maintenance Records (CMR) Bulk Voice quality d
Summary of the content on the page No. 10
Chapter 2: Devices and Services The following figure illustrates the technology pack’s data collection architecture in a CCM environment: Port for SQL Access CallManager Publisher runs on a Microsoft SQL Server 2000 server. To collect SQL data from the CallManager Publisher, an SQL bridge must be set up on the machine where Tivoli Netcool/Proviso DataLoad resides. This bridge is provided as part of the Tivoli Netcool/Proviso Cisco IP Telephony Technology Pack. The connection between the Data
Summary of the content on the page No. 11
Chapter 2: Devices and Services • With pre-4.4.3 Tivoli Netcool/Proviso versions, ensure that the dc.cfg file contains a URI for each CCM Publisher bulk adaptor, and that the URI matches the URI of the associated data source in the odbc.ini file. Collecting CDR, CMR, and Perfmon Data with Cisco Unified Communications Manager With Cisco Unified Communications Manager (CUCM), the technology pack collects CDR, CMR, and Perfmon data files in either of the following ways: • Through SOAP requests
Summary of the content on the page No. 12
Chapter 2: Devices and Services Prerequisites This section describes the prerequisites for the Tivoli Netcool/Proviso Cisco IP Telephony Technology Pack. SNMP Access The Tivoli Netcool/Proviso Cisco IP Telephony Technology Pack needs read access to SNMP agents of PSTN gateway, gatekeeper, and CallManager Server devices. Customers must provide a valid IP address and community name to access these devices. UDP Port number 161 needs to be open in the remote firewalls. CallManager servers, as wel
Summary of the content on the page No. 13
Chapter 2: Devices and Services In addition, the following enterprise parameters must be set: • LocalCDRPath — A directory for local CDR files written by Cisco CallManager. If this value is empty or invalid, the CDR files will not be moved. • PrimaryCDRUNCPath — A central collection point for CDR files. If this value is empty or invalid, the CDR files will not be moved. The installation procedure sets this parameter. • CDRFormat — A parameter that determines whether the files are written to
Summary of the content on the page No. 14
Chapter 2: Devices and Services The Cisco IP Telephony Technology Pack provides a file that interprets these bulk input files. See Bulk adaptor design files on page 11 for more information. Bulk input file name Cisco IP Telephony devices produce Comma-Separated Values (CSV) files that are named using the following syntax: DataType_ClusterName_Date_SerialNumber.csv where: • DataType specifies the type of data collected: cdr, cmr, cdrcmr, or perfmon. • ClusterName specifies the name of the
Summary of the content on the page No. 15
Chapter 2: Devices and Services neCluster",0,"","",0,"",3,0,0,1,"6076",5362499,1273883641,541,2954,487,2849,6,96 ,144,"03d4df7b-78ff-460e-a0bb- 43ccee36cc5f","Phones","StandAloneCluster","SEP00155832DDD5","MLQK=3.2000;MLQKav =3.3000;MLQKmn=1.4000;MLQKmx=3.9000;ICR=0.8200;CCR=0.7600;ICRmx=0.9800;CS=9;SCS= 2;MLQKvr=;z=" 1,1,8590499,10263919,1273883642,1,0,760260611,"6058","termine",0,1,4,0,0,51,0,0, 0,0,0,0,0,"0","0",19835742,0,0,0,"6017","6017","",0,0,4,0,0,0,0,0,0,0,0,0,0,"0", "0",0,1273883642,
Summary of the content on the page No. 16
Chapter 2: Devices and Services NOTES 12 IBM Tivoli Netcool/Proviso Cisco IP Telephony 2.4.0.0 Technology Pack
Summary of the content on the page No. 17
Chapter 3: Supported Reports and KPIs This chapter discusses the following topics: Topic Page Overview 13 Reporter sets 13 Reporter set tree 15 Reporter set contents 16 Key performance indicators 33 Overview The Cisco IP Telephony Technology Pack supplies a set of reports to display information about the devices and activity associated with the Cisco IP Telephony environment. The reports contain metrics that are generated by the formulas that this technology pack provides. The metric name
Summary of the content on the page No. 18
Chapter 3: Supported Reports and KPIs Table 1 shows a summary of the reports in each reporter set provided by the Cisco IP Telephony Technology Pack. Table 1: Reporter set summary Reporter set Dashboard Group Resource Detail Threshold CallManager Server 0 1 2 0 0 Cluster 1 4 5 0 0 Codec 0 0 1 0 0 DSP Card 0 0 1 0 0 Device 0 0 2 0 0 Device 2 0 2 0 0 Extension 0 3 4 0 0 Global Customer Reports 0 0 1 0 0 Interface 0 0 2 0 0 Interface 2 0 2 0 0 K-Factor 0 1 1 0 0 Media Devices 0 1 1
Summary of the content on the page No. 19
Chapter 3: Supported Reports and KPIs Reporter set tree The Cisco IP Telephony Technology Pack provides the following reporter sets, which are listed as they appear in the DataView Navigator tree structure: AP Cisco VOIP Pack Global Customer Reports Call Detail Record Cluster Extension K-Factor Codec Infrastructure CallManager Server PSTN Gateway Interface Device DSP Card Media Devices Gatekeeper Device Interface Perfmon IBM Tivoli Netcool/Proviso Cisco IP Telephony 2.4.0.0 Technology Pack 15
Summary of the content on the page No. 20
Chapter 3: Supported Reports and KPIs Reporter set contents This section describes the contents of the reporter sets provided in the Cisco IP Telephony Technology Pack, including the key performance indicators (KPIs) for each report. Note: If any fields are omitted from the CDR or CMR data, the corresponding metric fields in the reports have dashes instead of zeroes. Global Customer Reports Global VOIP KPIs • ClusterOffNetCall • PSTN Gateway Active DS0 Channels (Nb) • Cluster Total Number
