Home

IBM CISCO R2E2 User's Manual

Contents

1. IF specifies the DataChannel Inventory File IP application Examples of IF applications include SAMIF specifies the IF application for the Alcatel Lucent 5620 SAM Technology Pack QCIF specifies the IF application for the Alcatel Lucent 5620 NM Technology Pack CWMIF specifies the IF application for the Cisco CWM Technology Pack UBA specifies the DataChannel UBA application Most UBA technology packs operate with only the UBA application Value Specifies the following information Default identifies the default value if one is specified for the parameter Attribute specifies whether the parameter is writable Location specifies the location of the parameter in the Topology Editor Detail Provides details about the parameter including possible values IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 63 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later INSTANCES Description Group alias Component UBA Value Default VOIP_CISCO_IPT_PERFMON Attribute Read only Location Advanced Properties tab Detail The DataChannel supports multiple instances of technology packs running in a single channel component Therefore there must be a way to guarantee that the DataChannel applications that handle inventory and metrics parse the correct design files and read the appropriate Bulk input files The INSTANCES parameter helps ensure that the
2. MOHMulticastResourceAvailable Perfmon MOH Group KPIs MOHUnicastResourceActive MOHTotalUnicastResources MOHUnicastResourceAvailable MOHMulticastResourceActive MOHTotalMulticastResources MOHMulticastResource Available 32 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Key performance indicators Table 2 lists all of the key performance indicators KPIs supported by the Cisco IP Telephony Technology Pack Table 2 Key performance indicators KPI Comment AttendantConsoleClientsOnline Total number of attendant console clients currently online AttendantConsoleClientsRegistered Total number of attendant console clients registered to the device AuthenticatedCallsActive AuthenticatedPartiallyRegisteredPhone Total number of active authenticated calls Total number of active authenticated extensions which have not completed the registration process AuthenticatedRegisteredPhones Total number of active authenticated and fully registered extensions BRIChannelsActive Total number of BRI channels currently in use in the target device BRISpansInService Total number of BRI spans available in the target device CCM CPU Utilization percent avg last 5 mn The average over the last minute of the percentage of time that this 8e gt P 8 processor was not idle CCM Media Device Registrati
3. Global VOIP KPIs ClusterOffNetCall PSTN Gateway Active DS0 Channels Nb Cluster Total Number of Normal Call Clearing ClusterJitter CCM CPU Utilization percent avg last 5 mn ClusterDropCall ClusterOnNetCall Cluster Percentage of Packet Lost percent ClusterSuccessfulCall PSTN Gateway Network Errors percent ClusterUnsuccessfulCall Interface Bandwidth Utilization Out percent PSTN Gateway Active DS0 Channels Nb Gauge Charts Call Detail Record Cluster Cluster Utilization Resource KPIs Cluster Total Number of Outgoing External Calls Nb Cluster TollBypassCall Cluster Total Number of External Calls Nb Cluster Total Number of Company Calls Nb Cluster Erlang ClusterNbPacketsReceived 16 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Cluster Total Hours of Traffic ClusterNbPacketsSent e Cluster TotalCall Charts TollBypass vs Normal Ougoing PSTN Calls Company vs External Calls Cluster Quality Resource KPIs ClusterNbPacketsLost MLOK ClusterLatency usterJitter luster Total Number of Normal Call Clearing usterDropCall usterSuccessfulCall C C C C C C usterUnsuccessfulCall Charts Successful vs Unsuccessful Calls Drop calls vs Normal call clearing Cluster Call Distribution Resource KPIs Cluster Total Number of Outgoing External Calls Nb ClusterLongDistanceCall ClusterInter
4. spaces oa p p00 tiregi pec ENERO pees EEE ES RD SER REY 72 VOIP_CISCO_IPT INPUT_DIRECTORY 0 0 ec ccc mnn 73 VOIP_CISGO_IPTINPUT _DIRECTORY ci n canse th REPE E DLE EE ri 74 VOIP CISCO IPTINPUT FIP PASSWORD seeeeeeee cee eens 75 VOIP CISCO IPTINPUT FIP USERNAME seessss nn 76 VOIP CISCO IPEINPUT HOST sos sponi ia arta e ER nia FERE Ei FERRE E ad 77 VOIP CISCO IPTINPUT HOST sii e A od S aep oe RE d 78 VOIP_CISCO_IPT INPUT_USE_SECURE_FTP o ooooooooooooooomomommomomomoomoso 79 VOIP CISCO TPT INPUT_USE SECURE FTP average arpa 80 VOIP_CISCO_IPT_PERFMON DESIGMNFILE sseeeeeeee IH 81 VOIP CISCO IPT PERFMONINPUT DIRECTORY ssssssses ee 82 VOIP CISCO IPT PERFMONINPUT FTP PASSWORD ssseeee eee 83 VOIP CISCO IPT PERFMONINPUT FTP USERNAME ssssssssse ee 84 VOIP CISCO IPT PERFMONINPUT HOST ssssssseee ee een 85 VOIP CISCO IPT PERFMON INPUT USE SECURE FIP sseseeeeeeeeeeee 86 VOIP CISCO IPT PERFMON PERFMON DELETEONACQUIRBE seeeeeee 87 VOIP CISCO IPT PERFMON PERFMON URI sseseeeeeeeee eee eee 88 Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only 89 Template file name and lO CO ricotta tbc giro an eX A AA deep deci 89 Pack specific UBA patametets issue cerea apreciar Eds Cees Es ara 89 Additional information about UBA parameters 0 0 0 6 eee cee eens 90 INSTANCES pecche os octal ERE ER E ERES 90 qM rm 91 DB USERNAME 3 32
5. CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE DATA OR PROFTIS WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHER TORTIOUS ACTION ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE Part 2 Netwotks Associates Technology Inc copyright notice BSD Copyright O 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 ate met e Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer e Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither the name of the NAI Labs nor the names of its contributors may be used to endorse or promote products derived from this softwate without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LI
6. IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 77 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP CISCO IPT INPUT HOST Description Hostname for Bulk input files in CCM or CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_HOST parameter specifies the hostname of the server on which the Bulk input files reside These are the files that the UBA parses 78 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP CISCO IPT INPUT USE SECURE FTP Description Acquire CCM or CUCM Bulk input files using secure FTP Component UBA Value Default false Attribute Writable Location Properties tab Detail The INPUT_USE_SECURE_FTP parameter specifies whether FTP File Transfer Protocol or SFTP secure FTP is used To use FTP specify the value false Otherwise to use SFTP specify the value true The default value is false To use the sftp command you must have an SSH client installed on the servers where the Bulk input files reside and where the DataChannel is running Typically an SSH client is installed by default on most Unix systems For more information see your operating system documentation or the sftp manpage Note You cannot do the following Use an FIP client to co
7. UBA channel number collector number 7 instance T IMEZONE GMT UBA lt channel_number gt collector number 7 lt instance gt DESIGNFILE CCMAdaptor js UBA channel number collector number 7 lt instance gt CCMINPUT URI input files location gt UBA channel number collector numberT7 instance CCMINPUT DELETEONACQUIRE true UBA channel number collector number27 INSTANCES lt instance gt UBA channel number collector number27 instance T IMEZONE GMT UBA channel number collector number27 instance DESIGNFILE CUCMAdaptor js UBA channel number collector number27 lt instance gt CORINPUT URI lt imput_files_location2 gt UBA channel number collector number2 instance CORINPUT DELETEONACQUIRE false UBA channel number collector number37 INSTANCES instance UBA channel number collector number37 instance T IMEZONE GMT UBA channel number collector number37 lt instance gt DESIGNFILE CUCMPerfmonAdaptor js UBA channel number collector number37 lt instance gt PERFMON URI nput files location gt UBA channel number collector number37 instance PERFMON DELETEONACQUIRE false IBM Tivoli Netcool
8. Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON INPUT_HOST Description Hostname for Bulk input files containing Perfmon metrics in CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_HOST parameter specifies the hostname of the server on which the Bulk input files reside These are the files that the UBA parses IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 85 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON INPUT_USE_SECURE_FTP Description Acquire CUCM Perfmon Bulk input files using secure FTP Component UBA Value Default false Attribute Writable Location Properties tab Detail The INPUT_USE_SECURE_FTP parameter specifies whether FTP File Transfer Protocol or SFTP secure FTP is used To use FTP specify the value false Otherwise to use SFTP specify the value true The default value is false To use the s tp command you must have an SSH client installed on the servers where the Bulk input files reside and where the DataChannel is running Typically an SSH client is installed by default on most Unix systems For more information see your operating system documentation or the sftp manpage Note You cannot do the following Use an FTP client to connect to an SFTP server Connect to an
9. Comment Cluster Percentage of Company Calls percent Cluster Percentage of Drop Calls percent Ratio between Company calls and Total number of Calls Ratio between DropCalls and Total number of Calls Cluster Percentage of Normal Call Clearing percent Ratio between Calls that have normal termination code and Total numbet of Calls This mettic is the opposite of the Percentage of Drop Calls metric Cluster Percentage of Packet Lost percent Ratio between Packets Lost and Total number of Packets sent and received Cluster Percentage of Successful Calls percent Ratio between Successful Calls and Total number of Calls Cluster Percentage of TollBypass Calls percent Ratio between Toll Bypass Calls and Total number of Calls Cluster Total Hours of Traffic This formula will be useful for future Erlang calculation This is the Total call duration in hours Cluster Total Number of Company Calls Nb Total number of Company Calls A company call is define as An Intrasite IP Call An Intersite IP Call An Intrasite Legacy PBX Call An Intersite Legacy PBX Call Any call with caller and callee that is part of the Internal dial plan is a Company Call Cluster Total Number of Company IP Calls Nb Total number of internal VoIP company calls Cluster Total Number of Company LegacyPBX Calls Nb Total number of Company Legacy PBX Calls A Legacy PBX Call is defined as An intr
10. Example host1 perfmon hostl user admin Example host2 perfmon host2 user admin perfmon interval The interval in milliseconds at which ProvisoCUCM polls the CUCM server for Perfmon data files and checks perfmon output dir for data files pushed there by the CUCM servet Example 5 minutes run interval 300000 perfmon output dir The location on the DataChannel host where the ProvisoCUCM instance generates output in CSV format from a Perfmon data file Example perfmon output dir opt uba perfmon 52 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack Field Description resend sent files If true the CUCM server will re send files that it has already successfully sent Since the CUCM can be configured to send data files to any host specified by CUCM Web administration configuration settings this field must be set to true to ensure that data files ate also sent to the DataChannel host that requested them Use the false setting in the following situations Ifyou prefer to have the data files pushed back to the DataChannel host according to a schedule specified by CUCM Web administration configuration settings Set the CUCM configuration to push the data files back to the DataChannel server where the ProvisoCUCM instance is running If data files are being pushed back to the DataChannel host too slowly for your need
11. e a SUPR ROCHE UE CR PR REPRE ii deb La a 91 Example EROR REGE ERORREL E ga cae sue EINER E EE ERI RE RN ERE RES 92 iv IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 1 Introduction This manual describes the IBM amp 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 to 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 Tivoli 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 e Tivoli Netcool Proviso DataMart TCP IP networks Telecommunications network management e 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 Telepho
12. Additional Copyright information DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS Various copyrights apply to this package listed in 3 separate parts below Please make sure that you include all the parts Up until 2001 the project was based at UC Davis and the first part covers all code written during this time From 2001 onwards the project has been based at SourceForge and Networks Associates Technology Inc hold the copyright on behalf of the wider Net SNMP community covering all derivative work done since then An additional copyright section has been added as Part 3 below also under a BSD license for the work contributed by Cambridge Broadband Ltd to the project since 2001 Part 1 CMU UCD copytight notice BSD like Copyright O 1989 1991 1992 by Carnegie Mellon University Derivative Work 1996 1998 2000 Copyright O 1996 1998 2000 The Regents of the University of California All Rights Reserved Permission to use copy modify and distribute this software and its documentation for any purpose and without fee is hereby granted provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation and that the name of CMU and The Regents of the University of California not be used in advertising or publicity pertaining to distribution of the software without specific written permission
13. FTP server with a client that supports only SFTP 86 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON PERFMON DELETEONACQUIRE Description Deletes CUCM Perfmon Bulk input files after acquisition Component UBA Value Default false Attribute Writable Location Advanced Properties tab Detail The PERFMON DELETEONACQUIRE parameter specifies whether the Bulk input files should be preserved after the UBA acquires them A related parameter PERFMON URI specifies the location of these Bulk input files Set this parameter to the value true to instruct this UBA application to delete the CUCM Perfmon Bulk input files after it acquires them Otherwise set this parameter to false to instruct this UBA application to preserve the Bulk input files after it acquires them IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 87 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON PERFMON URI Description CUCM Perfmon Bulk input files location Component UBA Value Default No default value Attribute Read only Location Properties tab Detail The DataChannel applications that handle inventory and metrics must be directed to the location of the Bulk input files generated by the devices associated with the technol
14. Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack Variable Description site A variable assigned to the JavaScript object Site A Site object defines a set of properties specific for a site business department location remote office or group of people You can define multiple Site objects Objects are distinguished through the site name you pass to the object Create a Site object as follows site new Site MySite In the example MySite is the site name A site object contains the following methods e addLocalCallPrefix string prefix The prefix argument specifies 7 digits in a local call prefix where z is the prefix length If the first 7 digits in a phone number match the prefix the phone number is determined to be a local number Many local call prefixes can be defined for the same site through this method Example site addLocalCallPrefix 999 addExtensionRange int startNumber int endNumber The two arguments specify the extension range for a site beginning with the first extension in the range and ending with the last extension Each number within the range is an internal extension for the named site Many extension ranges can be defined for the site through this method The values allow automatic grouping report navigation by site and path subelement definition Example site addExtensionRange 1000 1830 addVoiceMailRange int
15. Telephony Technology Pack provides a file that interprets these bulk input files See Bu k 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 cs v where Datalype specifies the type of data collected cdr cmr cdrcmr or perfmon CinsterName specifies the name of the cluster from which the data was collected Date specifies the date on which the data was collected The date format is as follows yyyyMMddHHmm where yyyy specifies a four digit integer for example 2010 that identifies the year in which the Cisco IP Telephony produced the CSV file MM specifies a two digit integer for example 05 that identifies the month in which the Cisco IP Telephony produced the CSV file dd specifies a two digit integer for example 15 that identifies the day in which the Cisco IP Telephony produced the CSV file HH specifies a two digit integer for example 08 that identifies the metric hour in which the Cisco IP Telephony produced the CSV file mm specifies a two digit integer for example 35 that identifies the minutes after the metric hour in which the Cisco IP Telephony produced the CSV file SerialNumber specifies the serial number of the file in case there are multiple files for a single period Example cdrcmr cluster 01 2
16. UBA parameters that are not in the dc c fg file The DataChannel installer creates a dc cfg file in the DAT4 CHANNEL HOME conf directory opt datachannel conf by default These pack specific parameters were delivered in a template file called voip cisco ipt sample dc cfg The best practice on adding these pack specific parameters to the dc c g file is to Edit the pack specific UBA parameters in the template file with site specific values Manually add them to the dc cfg file To edit the pack specific UBA parameters in the template file with site specific values follow these steps 12 a On the DataChannel server change your working directory to the DATA CHANNEL HOME scripts voip cisco ipt directory by entering the following command replacing DAT 4 CHANNEL HOME with the DataChannel home directory opt datachannel by default cd DATA CHANNEL HOME scripts voip cisco ipt 12 b Make a backup copy of the voip cisco ipt sample dc cfg template file by entering the following command cp voip cisco ipt sample dc cfg voip cisco ipt sample dc cfg ORIG 12 c In a text editor open the voip cisco ipt sample dc cfg template file for editing 12 d Edit the pack specific UBA parameters according to the instructions provided in Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only 12 e When you are satisfied with your edits write but do not quit the voip cisco ipt sample dc cfg template fil
17. from the PSTN Interface Availability percent Interface availability percentage for a Cisco gatekeeper Interface Bandwidth Utilization In percent Inbound bandwidth utilization percentage for a PSTN gateway interface Interface Bandwidth Utilization Out percent Outbound bandwidth utilization percentage for a PSTN gateway interface Interface Packet Loss percent Total percentage of packets lost for a gatekeeper interface Interface Throughput In kbps Inbound interface throughput measured in kilobits per second Interface Throughput Out kbps Outbound interface throughput measured in kilobits per second Internal An Internal Call is a call between 2 internal extensions managed by one or more CallManager Clusters where the 2 Extension numbets caller and callee are short internal numbers An Internal call or Company call can be An Outbound or Inbound call A call between 2 IP phones from the same site A call between 2 IP phones from different sites A call between 1 IP phone and 1 legacy phone from the same site A call between 1 IP phone and 1 legacy phone from different sites7 Internal IntrasitelP OR IntersiteIP OR IntrasiteLegacyPBX OR IntersiteLegacyPBX7 An On net call pure IP Network transit An Off net call IP to PSTN Gateway call An Internal call can never be A call between an Internal Extension and any External PSTN Number Note Internal extensions are managed through the
18. inbound ICMP errors Percentage of outbound SNMP errors PSTN Gateway Network Errors percent Percentage of network errors observed by a PSTN gateway PSTN Gateway Packet Discards Percentage of PSTN gateway packets discarded PSTN Gateway Total Number of Calls Nb Total number of calls for a PST N device PSTN Gateway Total Number of Calls per mn Calls mn Total number of calls per minute for a PSTN device PSTN Gateway Total Number of Successful Calls Nb Total number of successful calls for a PSTN gateway device PSTN Gateway Total Number of Unsuccessful Calls Nb Total number of unsuccessful calls for a PSTN gateway device PSTN Gateway Total Packets per Second Total number of packets per second for a PSTN gateway device Percentage of Company Calls percent CME Bulk VOIP Cisco Percentage of all calls which were intra company calls Percentage of Drop Calls percent CME Bulk VOIP Cisco Ratio between DropCalls and Total number of Calls Percentage of Packet Lost percent CME Bulk VOIP Cisco Ratio between Packets Lost and Total number of Packets sent and received Percentage of Successful Calls Nb CME Bulk VOIP Cisco Percentage of calls which completed successfully Percentage of TollBypass Calls percent CME Bulk VOIP Cisco Ratio between Toll Bypass Calls and Total number of Calls SCS Severely concealed seconds Conceal
19. of Calls Nb CME Bulk VOIP Cisco TollBypassCall Incoming Top 10 CDR Number of Errors KPIs Percentage of Packet Lost percent CME Bulk VOIP Cisco Percentage of Successful Calls Nb CME Bulk VOIP Cisco Percentage of Drop Calls percent CME Bulk VOIP Cisco ShortCall IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 21 Chapter 3 Supported Reports and KPIs CDR VoiceMail Usage Resource KPIs VoicemailPackets VoicemailCallDuration VoiceMailCall Total Number of VoiceMail Direct Calls Nb CME Bulk VOIP Cisco ForwardToVoiceMail Charts Direct vs Forward Calls ratio Top 10 CDR Call Completion KPIs Percentage of Successful Calls Nb CME Bulk VOIP Cisco Percentage of Drop Calls percent CME Bulk VOIP Cisco Top 10 CDR Call Duration KPIs TollbypassCallDuration CallDuration CDR Quality Group KPIs Percentage of Drop Calls percent CME Bulk VOIP Cisco MOS Latency Jitter Percentage of Packet Lost percent CME Bulk VOIP Cisco Percentage of Successful Calls Nb CME Bulk VOIP Cisco Charts Mean Opinion Score Successful Calls Percent Distribution Chart CDR Utilization Group KPIs Total Number of Calls Nb CME Bulk VOIP Cisco Percentage of TollBypass Calls percent CME Bulk VOIP Cisco NbPacketsReceived Percentage of Company Calls percent CME Bulk VOIP Cisco NbPacketsLost 22 IBM Tivoli Netcool Proviso Cisc
20. only UBA 1 101 VOIP CISCO IPT CCMINPUT DELETEONACQUIRE false UBA 1 101 METRIC STREAM TYPE BOF UBA 1 101 DEBUG WALKBACK ON ADAPTOR ERROR TRUE UBA 1 101 DUAL LOGGING true UBA 1 101 LOG FILTER FEWI 12345 UBA 1 101 SERVICE INSTANCE GLOBAL UBA 1 101 COLLECTOR LIST 101 UBA 1 101 DB USERNAME PV GUI UBA 1 101 DB PASSWORD AAAC UBA 1 101 INVENTORY SUBELEMENT FLUSH THRESHOLD 10 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 93 Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only NOTES 94 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Notices This information was developed for products and services offered in the U S A IBM may not offer the 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 ma
21. password to gain access to the server on which the Bulk input files reside Likewise the UBA uses this same password to gain access to the server on which the Bulk input files reside IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 75 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT INPUT_FTP_USERNAME Description FTP or SFTP username for Bulk input files used in CCM or CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_FTP_USERNAME parameter specifies the username that the server administrator assigned using the ftp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this username to gain access to the server on which the Bulk input files reside Likewise the UBA uses this same username to gain access to the server on which the Bulk input files reside 76 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP CISCO IPT INPUT HOST Description Hostname for Bulk input files in CCM or CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_HOST parameter specifies the hostname of the server on which the Bulk input files reside These are the files that the UBA parses
22. shows a cron entry that periodically performs the grouping operation for a bulk inventory profile called bulk 100 opt datamart dataMart env amp amp inventory name bulk 100 action pregrouping reload opt datamart dataMart env amp amp inventory name bulk 100 action grouping reload noX See the IBM Tivoli Netcool Proviso Command Line Interface Guide for more information about the inventory command Deploy reports After the technology pack installation completes the rules for the new device are automatically loaded into the database The inventory process uses those rules to group elements and subelements You must manually deploy auto group the reports by associating them with groups in the NOC Reporting tree in the DataMart Resource Editor To deploy the Cisco IP Telephony Technology Pack reports follow these steps 17 a Open the Tivoli Netcool Proviso DataMart Resource Editor 17 b Click the ReportSEGroup tab 17 c Move the cursor to the left pane and scroll up to select any group under the SUB ELEMENTS gt NOC Reporting tree 17 d Right click and select the AutoGrouping option from the menu The AutoGrouping option places the reports in dynamically generated groups created during inventory 17 e Click Yes to continue IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 61 Chapter 4 Configuring the technology pack 17 f Click Close to exit the message box or click Details t
23. startNumber int endNumber The two arguments specify the VoiceMail extension range for a site beginning with the first VoiceMail extension in the range and ending with the last extension Each number within the range is an internal VoiceMail extension for the named site Many VoiceMail extension ranges can be defined for the site through this method The values allow automatic grouping report navigation by site and specific reports on the VoiceMail application Example site addVoiceMailRange 9000 9050 e addPstnGatewayIpAddress string ipAddress The argument specifies the IP address of a PSTN gateway Many PSTN gateway addresses can be defined for the named site through this method The values allow automatic grouping report navigation by site and path and gateway subelement definition Example site addPstnGatewayIpAddress 10 1 184 20 Note Use the following method only in the CUCM Config js file addCucmAddress string ipAddress The argument specifies the IP address of a CUCM server in the cluster Example site addCucmAddress 10 1 6 8 Note Ifyou are collecting Perfmon data on multiple hosts ensure that you specify all of the Perfmon hosts in the CUCM Config js file by adding more addCucmAddress lines to the appropriate cluster sections IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 55 Chapter 4 Configuring the technology pack 11 12 Run the initial SNMP in
24. the bulk collection formula names Some technology packs provide several Bulk Adaptor Design Files each of which handles a specific bulk input file format The Cisco IP Telephony Technology Pack provides the following Bulk Adaptor Design Files e CCMAdaptor js e CCMConfig js CCMSupport js e CUCMAdaptor js CUCMConfig js CUCMPerfmonAdaptor js e CUCMSupport js IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 11 Chapter 2 Devices and Services NOTES 12 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 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 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 Formulas section of the IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Reference For information about how to navigate to a pa
25. the polling start time The polling start time is the time that the ProvisoCUCM instance begins polling the CUCM server for data The grace period is intended to help you avoid missing data files that the CUCM has not yet written for the current time period ProvisoCUCM uses the polling start time specified in the field start time of the file cucm TIMESTAMP This file is located in the same directory as the cucm properties file If the file does not exist when ProvisoCUCM is instantiated it starts polling the CUCM server immediately creates cucm TIMESTAMP and writes the curtent time to it Example grace period 100 seconds grace period 100000 Example start time 1 20 2009 at 12 00 start time 1232470820931 perfmon hostN hostname The name of one of the multiple hosts on which Perfmon data is collected Example host1 perfmon hostl hostname hostl example zz Example host2 perfmon host2 hostname host2 example zz perfmon hostN pass The passwotd to access one of the multiple hosts on which Perfmon data is collected Example host1 perfmon hostl pass pass Example host2 perfmon host2 pass pass perfmon hostN port The port number on one of the multiple hosts on which Perfmon data is collected Example host1 perfmon hostl port 443 Example host2 perfmon host2 port 443 perfmon hostN user The user name to access one of the multiple hosts on which Perfmon data is collected
26. tk ERES E ER EET PERIERE eee ERES PCR ES 10 Bulk input tile schiema cote edere lop ie beoe 4 had iene as 10 Bulk adaptor design files cepo le Ri RI rei Ae XR a er YES 11 Chapter 3 Supported Reports and KPIS ccc cece eens cent eeeeeeeneeeennaes 13 foul EET 13 Reporter sets cerati EIE e Or MERE Ie PAR 13 Reporter Set tE ir ida dde dai 15 Reporter setContents ride AA A ARA ES atis 16 Key performance indicator eode A coUe dd Ra de etus bee 33 Chapter 4 Configuring the technology pack ooooccoooccccccnccnnncconnncnnnoo 45 OVE Woods o i A I CIN A a a eee 45 Betote you Depitis wots se o stale nd a 45 Configure the technology pack ic cece ys sa cee RR e eR a d ERR A 46 Verifying TESQUIC S voee edd s e Y GU ad wed REFERT CURAR T eR 62 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack iii Contents Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later 63 OV SEVIS PERPE 63 INSIANGBS 4 3 55 0 0 4a8secsevaeeede seeaShrae s ooo PEE SESE FGae 9 86 TERETE SR RA 64 INSTANCES P 65 INSTANCES i 5e eersc eee enr a a a a 66 VOIP CISCO IPT CCMINPUT DELETEONACQUIRE sseeeeee I 67 VOIP CISGO IPECCMINPUTURI vxkk fee eR ts ce CRAP ea ada URS 68 VOIP CISCO IPT CDRINPUT DELETEONACQUIRE sssssseeeee eee 69 VOIP CISCO IPTE CDRINPUT URT orient eh Rete eee ER Des tase acc 70 VOIP CISCO _IPEDESIGNEIEBE eh br ba d on 71 VOIP CISCO IPEDESIGNFIL
27. to find the bulk input files that the supported device generates Therefore you must specify a Universal Resource Identifier URI for the location of the bulk input files To define this location the Cisco IP Telephony Technology Pack provides a URI parameter in its voip cisco ipt sample dc cfg template file You must specify the URI for each CCM Publisher bulk adaptor configured in the dc c g file Note The URIs that you specify in tbe de cfg file must match the URIs of each CCM Publisher data source defined in the odbe ini file Follow these guidelines when specifying a URI in the template or dc cfg file Use Internet standard URIs Specify the file protocol FTP File Transfer Protocol or SFTP secure FTP The file protocol is appropriate only when specifying a path on the same host computer When using the file protocol specify a full absolute path after the initial file This results in three slashes after the word file because the full path must begin with a slash When using FTP or SFTP use the following syntax ftp username encrypted password Q hostname fu11 path to directory specific string sftp lt username gt lt encrypted_password gt lt hostname gt full path to directory specific_string where lt username gt specifies the user name that the server administrator assigned using the ftp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this u
28. 01005150835 10001 csv Bulk input file schema For Cisco CallManager version 4 x CDR data is stored in a Microsoft SOL Server 2000 database The Cisco IP Telephony Technology Pack connects directly to the database and uses an SOL query to retrieve the data Perfmon is not supported for Cisco CallManager version 4 x For Cisco Unified Communications Manager versions 5 x and higher the ProvisoCUCM Java application uses the AXL SOAP API delivered by the device to collect both CDR and Perfmon data For CDR a SOAP query to the CUCM server requests all CDR data for a certain time period The CUCM server uses FTP to send the data back to a specified host The data is delivered in two formats CDR and CMR which are concatenated to produce a CSV format for the UBA Perfmon data is delivered in band as a response to the SOAP request and is also written into a CSV format for the UBA Example CDR CSV file 1 1 6177065 5362499 1273883641 1 0 760260612 6076 termine 0 1 4 0 0 57 0 0 0 0 0 0 0 0 0 19835742 0 0 0 6096 6096 0 0 4 0 0 0 0 0 0 0 0 0 0 0 0 0 1273883673 6001 593fa05e bcld 4dc5 9cca 6c25184e7e98 Phones 69 SEP00155832DDD1 13 0 0 0 0 0 0 StandAlo IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 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 StandAloneClu
29. BM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 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 nem implementation the Cisco Unified Communications Manager CUCM environment Where this guide refers to CCM the text also applies to CUCM unless an explicit distinction is made Summary of Device Technology The Tivoli Netcool Proviso Cisco IP Telephony Technology Pack collects and reports performance metrics in an Architecture for Voice Video and Integrated Data AVVID environment where Cisco CallManager CCM IP PBXs are deployed The technology pack manages the IP telephony application by focusing on an end to end voice path It uses advanced data consolidation with data coming from the end user the phone extension itself as well as data coming from network infrastructure devices The Cisco IP Telephony Technology Pack operates with the following Cisco versions e Cisco CallManager version 4 e Cisco Unified Communications Manager version 5 e Cisco Unified Communications Manager version 6 e
30. BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED 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 IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE 104 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack
31. CallDuration Time value in Seconds of any call duration with the VoiceMail application Cluster VoicemailPackets Number of Packets Sent Received by the subelement during a call with the VoiceMail This metric comes from the CMR table Its set only once the call is established with one of the VoiceMail extension DSP Card Availability percent DSP card availability percentage DSP Card Resource Utilization percent Total percentage of DSPs in used for a DSP card EncryptedCallsActive Total number of currently active encrypted calls EncryptedPartiallyRegisteredPhones Total number of encrypted extensions which have not completed the registration process EncryptedRegisteredPhones Total number of active authenticated calls FXOPortsActive Total number of FXO ports currently in use in the target device FXOPortsInService Total number of FXO ports available in the target device FXSPortsActive Total number of FXS ports currently in use in the target device FXSPortsInService Total number of FXS ports available in the target device 38 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment Forward To VoiceMail Identifies a call forwarded to another destination by the original callee In this case the destination is one of the VoiceMail extension number define
32. Cisco Unified Communications Manager version 7 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 3 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 Delivery Services and Devices Monitored The Tivoli Netcool Proviso Cisco IP Telephony Technology Pack creates automatic on demand historical and real time reports showing performance and trend analysis for the following services and devices Voice Quality Jitter latency packet drops mean opinion score per cluster per location per business department and even for each extension number CallManager System amp Application Server availability performance CPU load memory service availability disk usage and registered devices PSTN Gateway Devices Catalyst6500 Cisco AS5x00 series Cisco 2600 amp 3600 series E1 amp T1 Serial Links DSO Channel availability and utilization DSP availability and utilization capacity planning bandwidth errots Also total number of calls per gateway total dur
33. DataChannel applications that handle inventory and metrics perform the correct operation for a specific technology pack The value of INSTANCES is one of the following VOIP CISCO IPT with CCM or CUCM metrics VOIP CISCO IPT PERFMON with CUCM Perfmon metrics This is a read only parameter whose value you cannot change Typically the value for INSTANCES is a string that represents the name of the technology pack 64 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later INSTANCES Description Group alias Component UBA Value Default VOIP CISCO IPT Attribute Read only Location Advanced Properties tab Detail The DataChannel supports multiple instances of technology packs running in a single channel component Therefore there must be a way to guarantee that the DataChannel applications that handle inventory and metrics parse the correct design files and read the appropriate Bulk input files The INSTANCES parameter helps ensure that the DataChannel applications that handle inventory and metrics perform the correct operation for a specific technology pack The value of INSTANCES is one of the following VOIP CISCO IPT with CCM or CUCM metrics VOIP CISCO IPT PERFMON with CUCM Perfmon metrics This is a read only parameter whose value you cannot change Typically the value for INSTANCES is a string th
34. ERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE DATA OR PROFTIS WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHER TORTIOUS ACTION ARISING OUT OF OR IN CONNECTION WITH 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 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 101 Additional Copyright information This software is copyrighted by the Regents of the University of California Sun Microsystems Inc and other parties The following terms apply to all files associated with the software unless explicitly disclaimed in individual files The authors hereby grant permission to use copy modify distribute and license this software and its documentation for any purpose provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions No written agreement license or royalty fee is required for any of the authorized uses Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here provided that the 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 ANY PARTY F
35. MITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED 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 IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE Part 3 Cambridge Broadband Ltd copyright notice BSD Portions of this code are copyright O 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 ate met e Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer 100 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Additional Copyright information e Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution The name of Cambridge Broadband Ltd may not be used to endorse or promote products derived from this soft
36. OAP requests IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 73 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT INPUT_DIRECTORY Description Path to Bulk input files directory for CCM or CUCM metrics Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_DIRECTORY parameter specifies the path to the directory where the generated Bulk input files should be stored Do not enter any subdirectories and the actual wildcards used to specify the Bulk input files to be acquired Any subdirectories and wildcards are automatically specified in the URI related parameters An example of an input directory specification is opt uba CCM metrics are accessed through ODBC to a SQL database CUCM metrics are accessed through SOAP requests 74 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT INPUT_FTP_PASSWORD Description FTP or SFTP password for Bulk input files used in CCM or CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_FTP_PASSWORD parameter specifies the password that the server administrator assigned using the ftp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this
37. OPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFTIS OR BUSINESS INTERRUPTION HOWEVER CAUSED 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 IF ADVISED 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 binaty forms with or without modification ate permitted provided that the following conditions are met 1 Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the disclaimer that follows these conditions in the documentation and or other materials provided with the distribution 3 The name JDOM must not be used to endorse or promote products derived from this software without prior written permission For written permission pl
38. OR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE ITS DOCUMENTATION OR ANY DERIVATIVES THEREOF EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT THIS SOFTWARE IS PROVIDED ON AN AS IS BASIS AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS RESTRICTED RIGHTS Use duplication or disclosure by the government is subject to the restrictions as set forth in subparagraph c 1 ii of the Rights in Technical Data and Computer Software Clause as DFARS 252 227 7013 and FAR 52 227 19 Portions Copytight c 1993 1998 Lucent Technologies Inc Permission to use copy modify and distribute this software and its documentation for any purpose and without fee is hereby granted provided that the above copyright notice appear in all copies and that both that the copyright notice and warranty disclaimer appear in supporting documentation and that the names of Lucent Technologies any of their entities not be used in advertising or publicity pertaining to distribution of the software without specific written prior permission Lucent disclaims all warranties with regard to this software including all implied
39. Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 89 Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only The following table describes the values that you must provide for these UBA parameters UBA Parameter Value Meaning lt channel_number gt Replace with the channel number that was configured for this technology pack This channel number appears in the dc c g file lt collector_number gt Replace with the UBA Bulk Collector number that was configured for this technology pack This collector number appears in the dc cfg file lt instance gt Replace with an arbitrary string that identifies a group alias to be associated with subsequent lines in this section of the dc cfg file See Additional information about UBA parameters on page 90 for more information on this UBA parameter value The template file specifies VOIP CISCO IPT as an example If you replace this string with one of your own make sure that you replace it in the other parameters where it is specified lt timexone gt Replace with the correct time zone as specified in the etc default init file on the soutce host For example UBA 1 1 VOIP CISCO IPT TIMEZONE GMT The time zone must be set correctly Otherwise the pack will not deploy input files location Specify the location of the bulk input files that the device generates and the URIs of each CCM Publisher data source defined in the odbc ini file See A
40. R TORTIOUS ACTION ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE Portions Copyright c 2001 2008 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 and Telecommunications c Fabasoft R amp D Software GmbH amp Co KG 2003 oss fabasoft com All rights reserved Redistribution and use in source and binaty forms with or without modification ate permitted provided that the following conditions are met 1 Redistributions of source code must retain the above copytight notice this list of conditions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution 102 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Additional Copyright information 3 Neither the names of Networks Associates Technology Inc Cambridge Broadband Ltd Sparta Inc Cisco Inc Beijing University of Posts and Telecommunications Fabasoft R amp D Software GmbH amp Co KG or any of its subsidiaries brand or product names nor the names of their contributors may be used to endorse or promote products derived from this software without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE C
41. UBA xml adaptor configuration file where the variable ExtensionRange has to be defined International Identifies a call where the caller is an internal extension and where the callee is an International External PSTN number according to the Numbering Plan NANP or Other prefixes An International call is also An Outbound call An Off net call routed towards the PSTN Can be a TollBypassCall if a remote PSTN Gateway is involved in the Voice path Jitter Provides an estimate of the statistical variance of the RTP data packet interarrival time measured in milliseconds This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones 40 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment Latency Designates value that is an estimate of the network latency expressed in milliseconds This value represents the average value of the difference between the NTP timestamp indicated by the RTP Control Protocol RTCP messages and theN TP timestamp of the receivers measuted when these messages are received Cisco CallManager obtains the average by summing all the estimates then dividing by the number of RTCP messages that have been received Value of the Latency in milli seconds This metric comes from the CMR table Its set only once the call is est
42. UO Netcool Proviso Document Revision R2E2 Cisco IP Telephony 2 4 0 0 Technology Pack User Guide r Note Before using this information and the product it supports read the information in Notices on page 95 O Copyright IBM Corp 2010 US Government Users Restricted Rights Use duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp Contents Chapter 1 NOU ri iD 1 Audiente seriei ida o LSE ERR dp TAKES 1 AS A tra examen s M eR ede ices eene ness E t RU RRE a ete etas 1 Chapter 2 Devices and Services ridad 3 OVERVIEW ll tes beu AAA Reet oi es et oe e weeny hd ay 3 Summary of Device Technology crese euius ae rer rr Re a ka amba es be px dee 3 Categories of Service Reporting sese eee ere ay eee a e RR a UE Cn E 4 Services and Devices Monitored i iisr ssec Rr px 3E pa Mead ee ee pane ES 4 Sources of Collected Data ii edo pa De rene A RO LATE S RR Rp Ici ob eR pay 5 Collecting CDR and CMR Data with Cisco CallManager 0 6 eee eee 5 Collecting CDR CMR and Perfmon Data with Cisco Unified Communications Manager n Pt requisites 4s citt bh exe tor RIDE Eu Soie tib A dent NW 8 SNMP ACCESS Let sume eg iere i EY Uy Tivi i A YR CREE ad a pep 8 Cisco CallManager Configuration iuo tot aces bok Lies dod E qb Goa 8 Supported MIBS i ci i5 see x x dss pode dada ada eee Oe pa cake pas 9 Bulk input file Totmats dat i e er A x rac atur E ave qa oa diate as 9 Bulk input file namie cocinas
43. a number of listeners rate the quality of test sentences read aloud over the communications circuit by male and female speakers A listener gives each sentence a rating as follows 1 bad 2 poor 3 fair 4 good 5 excellent The MOS is the arithmetic mean of all the individual scores and can range from 1 worst to 5 best In our context our MOS calculation is based on the consolidation of Jitter Latency and Packets Lost values which give us a good overview of the real MOS value NbPacketsLost Number of Packets Lost by the subelement during a call This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones NbPacketsReceived Number of Packets Received by the subelement during a call This metric comes from the CMR table Its set only once the call is established This mettic is only available for IP Phones NbPacketsSent Number of Packets Sent by the subelement during a call This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones OffNet Identifies a call where at least one PSTN Gateway is involved in the Voice path with the following criteria Inbound or Outbound call Internal or call to from PSTN number Intersite or Intrasite Legacy PBX Call OnNet Identifies a call where the caller is an internal extension and where the callee is also an internal extension f
44. ablished This metric is only available for IP Phones Local Identifies a call where the caller is an internal extension and where the callee is a Local External PSTN number according to the Numbering Plan NANP or Other prefixes A Local call is also An Outbound call An Off net call routed towards the PSTN Can be a TollBypassCall if a remote PSTN Gateway is involved in the Voice path Note Internal extensions are managed through the UBA xml adaptor configuration file where the variable ExtensionRange is defined In order to be able to know whether or not a call will be charged as a Local call an additional variable needs to be set in the UBA xml adaptor configuration file If the first N digits match for this particular site with one of the number configured in this list then the call is tagged as Local LongDistance Identifies a call where the caller is an internal extension and where the callee is a LongDistance External PSTN number according to the Numbering Plan NANP or Other prefixes A Long Distance call is also An Outbound call An Off net call routed towards the PSTN Can be a TollBypassCall if a remote PSTN Gateway is involved in the Voice path MLQK MOS Listening Quality K factor This is an estimate of the MOS score of the last eight seconds of speech measured on the receiving end MLQKav MLQKmn MLQKmx Average MOS Listening Quality K factor for a call Minimum MOS Listening Quality K f
45. actor for the worst sounding eight seconds Maximum MOS Listening Quality K factor for the best sounding cight seconds MOHMulticastResourceActive Total number of currently active message on hold multicast resources MOH MulticastResource Available Total number of available message on hold multicast resources MOHTotalMulticastResources Total number of active and inactive message on hold multicast resources MOH TotalUnicastResoutces Total number of active and inactive message on hold unicast resources MOHUnicastResourceActive Total number of currently active message on hold unicast resources g MOHUnicastResoutceAvailable Total number of available message on hold unicast resources IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 41 Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment MOS Mean Opinion Score This is an high level metric Note There is no algorithm for Mean Opinion Score calculations This is a subjective metric from the end user point of view In voice communications particularly Internet telephony the mean opinion score MOS provides a numerical measure of the quality of human speech at the destination end of the circuit The scheme uses subjective tests opinionated scores that are mathematically averaged to obtain a quantitative indicator of the system performance To determine MOS
46. all where the caller is an internal extension and where the callee is an International External PSTN number according to the Numbering Plan NANP or Other prefixes An International call is also An Outbound call An Off net call routed towards the PSTN Can be a TollBypassCall if a remote PSTN Gateway is involved in the Voice path ClusterIntersiteIPCall Identifies a specific Internal Call where caller and callee are from different location site and using a pure IP Network transit path No PSTN Gateway is involved in the voice Path ClustetJitter Provides an estimate of the statistical variance of the RTP data packet interarrival time measured in milliseconds This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones ClustetLatency Designates value that is an estimate of the network latency expressed in milliseconds This value represents the average value of the difference between the NTP timestamp indicated by the RTP Control Protocol RTCP messages and theNTP timestamp of the receivers measured when these messages are received Cisco CallManager obtains the average by summing all the estimates then dividing by the number of RTCP messages that have been received Value of the Latency in milli seconds This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones ClusterLines Total num
47. aptor js Attribute Read only Location Properties tab Detail Netcool Proviso technology packs control the behavior of the DataChannel UBA application through instructions contained in Bulk Adaptor design JavaScript files The DESIGNFILE parameter identifies the name of a technology pack s design file This is a read only parameter You cannot change the name of the technology pack s Bulk Adaptor design file IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 81 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON INPUT_DIRECTORY Description Path to Bulk input files directory for CUCM Perfmon metrics Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_DIRECTORY parameter specifies the path to the directory where the generated Bulk input files should be stored Do not enter any subdirectories and the actual wildcards used to specify the Bulk input files to be acquired Any subdirectories and wildcards are automatically specified in the URI related parameters An example of an input directory specification is opt uba CUCM Perfmon metrics are accessed through SOAP requests 82 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON INPUT_FTP_PASSWORD Descript
48. asite Legacy PBX Call An intersite Legacy PBX Call Cluster Total Number of External Calls Nb Any call FROM TO the PSTN This is the opposite of a Company Call An External Call is defined as A Local Call A Long Distance Call An International Call An Incoming Call An External Call is like Outgoing External Call Incoming Call Cluster Total Number of Normal Call Cleating Total number of calls which cleared normally for a given cluster Cluster Total Number of Outgoing External Calls Nb Any Outbound call going to the PSTN This metric is a subset of the Cluster Total Number of External Calls An Outgoing External call is define as A Local Call A Long Distance Call An International Call ClusterBlocking Total number of times call blocking occurred This can be due to lack of channel availability or switch congestion Error codes 34 and 42 are used in the calculation ClusterDropCall Identifies a call successfully established but with a specific event during the communication between the 2 parties the call has been dropped accidentally during the communication A Drop call is also A Successful call Any Inbound Outbound or other type of call described above ClusterErlangB ClusterForward To VoiceMail Probability that a new arriving call will be rejected because circuits are busy Identifies a call forwarded to another destination by the original callee In this case the d
49. at represents the name of the technology pack IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 65 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later INSTANCES Description Group alias Component UBA Value Default VOIP_CISCO_IPT Attribute Read only Location Advanced Properties tab Detail The DataChannel supports multiple instances of technology packs running in a single channel component Therefore there must be a way to guarantee that the DataChannel applications that handle inventory and metrics parse the correct design files and read the appropriate Bulk input files The INSTANCES parameter helps ensure that the DataChannel applications that handle inventory and metrics perform the correct operation for a specific technology pack The value of INSTANCES is one of the following VOIP CISCO IPT with CCM or CUCM metrics VOIP CISCO IPT PERFMON with CUCM Perfmon metrics This is a read only parameter whose value you cannot change Typically the value for INSTANCES is a string that represents the name of the technology pack 66 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP CISCO IPT CCMINPUT DELETEONACQUIRE Description Deletes CCM Bulk input files after acquisition Component UBA Value Default false Attribute Writable L
50. ation per gateway Gatekeeper Devices Number of successful unsuccessful requests routing location admission registered endpoints errors Telephony Usage Total number of calls total duration of calls total number of packets per location per business department per extension number top10 clusters or sites offices extensions departments Number of outbound and inbound calls Total accumulated hours of traffic per hour day week month Call Completion Percentage of outgoing and incoming successful unsuccessful calls what are the main errors phones LAN WAN PSTN network congestions no resource available Call Distribution On net vs off net ratio number of IP routed calls vs calls routed toward PSTN number of internal private extension to private extension calls local calls long distance calls international calls Capability to provide statistics on number of calls to mobile networks supported in some countries only Site to Site Path Analysis End to end measurement between customer offices Voice quality call distribution call completion IP telephony usage TopN sites for errors number of calls duration and voice quality IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 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 collec
51. ber of type 18 interfaces lines 36 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment ClusterLocalCall Identifies a call where the caller is an internal extension and where the callee is a Local External PSTN number according to the Numbering Plan NANP or Other prefixes A Local call is also An Outbound call An Off net call routed towards the PSTN Can be a TollBypassCall if a remote PSTN Gateway is involved in the Voice path Note Internal extensions are managed through the UBA xml adaptor configuration file where the variable ExtensionRange is defined In order to be able to know whether or not a call will be charged as a Local call an additional variable needs to be set in the UBA xml adaptor configuration file If the first N digits match for this particular site with one of the number configured in this list then the call is tagged as Local ClusterLongDistanceCall Identifies a call where the caller is an internal extension and where the callee is a LongDistance External PSTN number according to the Numbering Plan NANP or Other prefixes A Long Distance cal call is also An Outbound call An Off net call routed towards the PSTN Can bea TollBypassCall if a remote PSTN Gateway is involved in the Voice path ClusterMOS Mean Opinion Score This is an high level metric Note There is no algorithm fo
52. ctory for each CUCM server from which CDR CMR and Perfmon data files will be requested For example if you will be requesting data files from two CUCM servers you might create the following directories opt datachannel cucml opt datachannel cucm2 These directories will contain the ProvisoCUCM application and other files needed to send SOAP requests to each CUCM server Note If you will be requesting CDR and CMR data files through a master CUCM server you need to create Just one directory for those requests However if you will be requesting Perfmon data you must create a separate directory for each CUCM server from which you will request Perfmon data 7 CUCM environment only Copy the following files into each one of the directories you just created in Step 6 ProvisoCUCM jar cucm properties startcucm sh stopcucm sh These files were included in the technology specific files you copied to DATA CHANNEL HOME scripts voip cisco ipt in step 2 e on page 47 8 CUCM environment only Configure each of the cucm properties files you copied in Step 7 Each cucm properties file is associated with an instance of the ProvisoCUCM application that is located in the same directory as the file The ProvisoCUCM instance reads the cucm properties file to find the address and login credentials of the associated CUCM server the address and login credentials of the DataChannel host for the CUCM server to use when pushing the r
53. currently in the free pool CCM SQL Server number active user connections CCM SQL Server number of blocked users Total number of open user connections Total Number of users blocked by other users CCM SQL Server number of locks Total number of locks being used by SQL Server IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 33 Chapter 3 Supported Reports and KPIs Table 2 Key performance indicators KPI Comment CCM SQL Server number of locks blocking Total number of locks blocking other processes processes CCM SQL Server number of pending rw Total number of reads and writes pending CCR Cumulative conceal ratio Cumulative concealment ratio during a call represented as concealment time speech time CS Conceal seconds The number of seconds of concealment during a call CallDuration Time value in seconds of the call duration CallsActive Total number of currently active calls for the resource or resources specified CallsInProgress Total number of calls being established at the time of sampling CauseCallRejected Call was rejected by the far end CauseChannelUnacceptable Call failure due to lack of acceptable TDM channel CauseDestinationOutOfOrder Called destination is not in service CauseInvalidNumberFormat Call failure due to invalid number format Cause MisdialedTrunkPrefix Call
54. d int inventory objects in float seconds Specifies an inventory success message The inventory successfully completes when an informational message similar to this one displays in the log file If lt int gt is greater than one the UBA application created or updated at least one subelement and the inventory process is successful The log file might record further details if necessaty in the messages associated with the PERF_INVFLUSHPV subelement message category 16 Run the bulk inventory profile The UBA application handles the inventory and metrics according to the instructions provided in the technology pack design file or files The UBA application inserts the created elements subelements and metrics into the database However the UBA application does not handle the grouping of these elements and subelements To handle the grouping of the elements and subelements that were inserted into the database UBA technology packs supply a bulk inventory profile This bulk inventory profile is automatically created when the pack is installed Bulk inventory profiles use the following name syntax bulk N 60 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack whete Syntax item Meaning bulk Identifies this as a bulk inventory profile for a UBA technology pack N Specifies the collector number for example 100 the user s
55. d 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 0 0 Perfmon 0 4 4 0 0 TOTALS 5 14 28 0 0 See the Netcoo Proviso DataView Users Guide for more information about reporter sets and the Reporter Set Wizatd 14 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls 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 Chapter 3 Supported Reports and KPls 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
56. d in the VoiceMailExtensionRange variable from the UBA xml adaptor configuration file Gatekeeper Buffer Utilization percent Percentage of a gatekeeper device s buffer space in use Gatekeeper CPU Utilization percent avg last 5 mn CPU utilization percentage over the last 5 minutes measured Gatekeeper Call Setup Quality percent Percentage of calls that have been set up successfully Gatekeeper ICMP Inbound Errors percent Percentage of inbound ICMP packets which triggered errors Gatekeeper ICMP Outbound Errors percent Percentage of outbound ICMP packets which triggered errors Gatekeeper Packet Errors Nb Total number of packet errors for a gatekeeper device Gatekeeper Total Number of Admission Rejects Nb Total number of admission rejections Gatekeeper Total Number of Admission Requests Nb Total number of gatekeeper admission requests Gatekeeper Total Number of Concurrent Calls Nb Gauge x Total number of concurrent calls for a gatekeeper device Gatekeeper Total Number of Location Rejects Nb Total number of location reject messages sent and received by a gatekeeper device Gatekeeper Total Number of Location Requests Nb Total number of location requests sent and received by a gatekeeper device Gatekeeper Total Number of Registered EndPoints Nb Total number of endpoints registered to a Cisco gatekeeper Gatekee
57. d the shell with the DataChannel environment by following these steps 13 a Log in to the DataChannel server as pvuser 13 b Change your working directory to the DataChannel home directory opt datachannel by default using the following command cd opt datachannel 13 c Load the shell with the DataChannel environment by sourcing the dataChannel env file as follows opt datachannel dataChannel env 14 Restart the DataChannel to activate the UBA and read in changes to the deployed topology v4 4 3 and later or dc cfg pre v4 4 3 only 14 a Open a terminal emulator on the DataChannel server 14 b Use the decmd command to stop all DataChannel applications dccmd action stop all 14 c Use the decmd command to release all daemons running in the DataChannel dccmd action forget all 14 d Use the following command to find the process identifiers pids associated with the DataChannel visual processes DATA CHANNEL HOME bin findvisual whete DATA CHANNEL HOME is opt datachannel by default 14 e Use the following commands to stop each DataChannel visual process kill 9 cnsw pid kill 9 logw pid kill 9 amgrw pid kill 9 cmgrw pid IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 57 Chapter 4 Configuring the technology pack 14 f Use the following commands to restart each DataChannel visual process cnsw logw amgrw cmgrw 14 g Use the dccmd com
58. dditional information about UBA parameters on page 90 for more information about this UBA parameter value Additional information about UBA parameters This section provides more information about the INSTANCES URI and DB USERNAME parameters INSTANCES The DataChannel UBA application supports multiple instances of technology packs running in a single channel component Therefore there must be a way to guarantee that the UBA parses the correct design file and reads the appropriate bulk input files The INSTANCES parameter helps ensure that the DataChannel UBA application performs the correct operation for a specific technology pack The Cisco IP Telephony Technology Pack provides an INSTANCES parameter in its voip cisco ipt sample dc cfg template file You supply an arbitrary string referred to as a group alias to the INSTANCES parameter After you define the INSTANCES parameter with a specific string make sure you specify this string wherever s ane appears in the template file You can associate this group alias with any arbitrary string For example you might associate this group alias with the location for example BOSTON LOWELL BERLIN PARIS and so forth of the data source 90 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only URI The DataChannel UBA application needs to know where
59. e Important Editing the de cfg file is a nontrivial task and prone to error Take your time and check your work carefully To manually add the pack specific UBA parameters to the dc cfg file follow these steps 56 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack 12 Open a second terminal emulator 12 g On the DataChannel server change your working directory to the DATA4 CHANNEL HOME conf directory opt datachannel conf by default by entering the following command cd DATA CHANNEL HOME conf 12 h Make a backup copy of the dc cfg file by entering the following command cp dc cfg dc cfg ORIG 12 i In a text editor open the de c g file for editing 12 j Search for the UBA parameters which begin with the string UBA These parameters were written to the dc cfg file when you configured the UBA Bulk Collector and installed the DataChannel configuration as described in the IBM Tivoli Netcool Proviso Installation Guide 12 k Copy the pack specific UBA parameters from the voip cisco ipt sample dc cfg template file to the dc cfg file 12 1 When you are satisfied with your edits do the following tasks Quit the voip cisco ipt sample dc cfg template file Write and quit the dc cfg file 13 Load the DataChannel environment In subsequent steps you will execute dccmd commands To ensure that you can run these commands loa
60. e input location by issuing a tail command similar to the following example tail f DATA CHANNEL HOME 1log proviso log grep UBA lt channel gt lt collector gt more The following table identifies the success messages that you should look for IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 59 Chapter 4 Configuring the technology pack Success message PERF_INPUT_PROCESSING Processed lt integer gt records in lt float gt seconds lt float gt records minute int records Meaning Specifies a Bulk Adaptor Design File completion message A Bulk Adaptor Design File successfully completes when an informational message similar to this one displays in the log file Success occurs when lt nf gt records equals 0 METRIC STREAM INFO Completed writing metric output DATA CHANNEL HOME UBA channel collector streaming state temp output lt time gt lt instance gt NRAW BOF wrote int metrics int bad resource IDs int bad formula names Specifies a metric creation success message The UBA application successfully creates metrics when a debug 2 message similar to this one displays in the log file For some technology packs the metric creation may be done across different instances of UBA applications Success occurs when f metrics is greater than one 7 bad resource IDs equals 0 and z 7 bad formula names equals 0 PERF INVFLUSH Inserted update
61. e next step 10 Define global variables Global variables are specific to each CCM or CUCM cluster You assign values to global variables in either of the following files CCMConfig js with CCM clusters CUCMConfig js with CUCM clusters The Cisco IP Telephony Technology Pack includes the configuration files CCMConfig js and CUCMConfig 3js In Step 2 e you copied these files to DATA CHANNEL HOME scripts voip cisco ipt typically opt datachannel scripts voip cisco ipt IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 53 Chapter 4 Configuring the technology pack These configuration files contain sample values Edit either or both files to assign values appropriate for locations in your Cisco IP Telephony CCM or CUCM environment The following table describes the global variables to define Variable Description CUSTOMERNAME String specifying the customer s identifier This value allows automatic grouping and report navigation by customet Example var CUSTOMERNAME TELINDUS CMCLUSTER String specifying the cluster s identifier This value allows automatic grouping and report navigation by cluster Example var CMCLUSTER SF OUTBOUNDPREFIX Integer specifying the prefix to dial to call outside of the PBX for example 9 within the US or 0 within Europe Example var OUTBOUNDPREFIX 0 54 IBM Tivoli Netcool
62. ease contact lt request_AT_jdom_DOT_org gt 4 Products derived from this software may not be called DOM nor may JDOM appear in their name without prior written permission from the JDOM Project Management lt request_AT_ dom_DOT_org gt In addition we request but do not require that you include in the end user documentation provided with the redistribution and or in the software itself an acknowledgement equivalent to the following This product includes software developed by the JDOM Project http www jdom org Alternatively the acknowledgment may be graphical using the logos available at http www jdom org images logos THIS SOFTWARE IS PROVIDED AS IS AND ANY EXPRESSED OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFTIS OR BUSINESS INTERRUPTION HOWEVER CAUSED 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 IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE This software consists of voluntary contributions made by many individuals on behalf of the JDOM P
63. ebug If true enables debug mode for ProvisoCUCM operations Error information pertaining to the SOAP interaction with the CUCM server is written to a log file The log file is located in the same directory as the ProvisoCUCM jar and cucm properties files If false debug mode is not enabled Example debug true ftp host The IP address of the DataChannel host where the requested data files are to be returned through FTP The FTP server must be the host where the ProvisoCUCM instance for this cucm properties file is running Examples ftp host 10 4 5 6 ftp host proviso mycorp com ftp pass User password required for login to the DataChannel host that issued the SOAP request Example ftp pass provisopwd ftp remotedir The location on the DataChannel host where the requested data files are to be copied Example ftp remotedir export home pvuser CUCM files ftp secure If true instructs the CUCM server to return the requested data files over a secure FTP connection If false the CUCM server will not use a secure FTP connection Example ftp secure true IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 51 Chapter 4 Configuring the technology pack Field Description ftp user User ID required for login to the DataChannel host that issued the SOAP request Example ftp user provisouser grace period The time in milliseconds to subtract from
64. echnology Pack Chapter 4 Configuring the technology pack 5 CCM environment only Configure the Data Direct SQL Server Bridge The Tivoli Netcool Proviso Cisco IP Telephony Technology Pack collects data from SNMP devices and through SQL for Call Detail Records from each CCM database The technology pack UBA is responsible for retrieving CCM data using the Data Direct SQL server bridge to do so This bridge is part of the UBA installation No additional software is required You need to set up the Data Direct SQL server bridge to get Call Detail Records from each CallManager Publisher The complete configuration is done by editing the DC HOME conf odbc ini file as user pvuser ODBC Data Sources Your Data Sourcei DataDirect 4 20 SQL Server Wire Protocol Your Data Source2 DataDirect 4 20 SQL Server Wire Protocol Your Data SourceN DataDirect 4 20 SOL Server Wire Protocol Your Data Sourcef Driver PV msss20 so Description DataDirect 4 20 SOL Server Wire Protocol Addtess xxxx ox xx 14 33 AnsiNPW Yes Database CDR QuoteId No Your_Data_Source2 Driver PVmsss20 so Description DataDirect 4 20 SQL Server Wire Protocol Address xx xxc xx oxx 1370 AnsiNPW Yes Database CDR QuoteId No Your_Data_SourceN Driver PVmsss20 so Description DataDirect 4 20 SQL Server Wire Protocol Addtess xx xx oxx xx 14 33 AnsiNPW Yes Database CDR QuoteId No ODBC IANAAppCodePage 4 InstallDir opt datachanne
65. echnology Pack 91 Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only For the Cisco IP Telephony Technology Pack DB_US The UBA technology pack requires the DataChannel UBA application to process metrics only In this scenario the UBA technology pack provides a metrics schema in its design file In this case DB US must be set to PV COLL ERNAM The UBA technology pack requires the DataChannel UBA application to process both inventory and metrics In this scenario the UBA technology pack provides metrics and inventory schemas in its design file In this case DB US Example ERNAM E must be set to PV GUI ERNAM E should be set to PV GUI The following example shows the UBA parameter settings for the Cisco IP Telephony Technology Pack UBA 1 98 ROOT DIRECTORY opt datachannel UBA 1 98 1INSTANCES VOIP CISCO IPT UBA 1 98 RUNINTERVAL 900 UBA 1 98 VOIP CISCO IPT TIMEZONE GMT UBA 1 98 VOIP CISCO IPT DESIGNFILE CUCMPerfmonAdaptor js UBA 1 98 VOIP CISCO _IPT PERFMON URI ftp user cryptedpass examplehost opt
66. el Configured an SNMP collector subchannel Created a user account on the server where the ProvisoCUCM application is installed so that the CUCM can FTP the CDR CMR data stream back to the ProvisoCUCM application Note This technology pack contains a Java application ProvisoCUCM that sends data requests to CUCM servers The ProvisoCUCM application requires the Java 2 Enterprise Edition JRE 1 5 J2EB Starting with the Cisco IP Telephony 2 4 0 0 Technology Pack the ProvisoCUCM application supports multiple Perfmon host collection for a single instance of the ProvisoCUCM application Configure the technology pack To configure the Cisco IP Telephony Technology Pack follow these steps 1 Load the DataMart environment To load the shell with the DataMart environment follow these steps 1 a Login to the DataMart server as pvuser 1 b Change your working directory to the DataMart home directory opt datamart by default using the following command cd opt datamart 46 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack 1 c Load the shell with the DataMart environment by sourcing the dataMart env file as follows opt datamart dataMart env Note After you load the DataMart environment into the shell the PV MHOME variable is set to the DataMart home directory opt datamart by default These instructions assume that this variable bas been s
67. equested files via FTP back to the DataChannel host and other required configuration details The following table describes the fields in the cucm properties files Field Description cdr output dir The location on the DataChannel host where the ProvisoCUCM instance generates output from a CDR file and its associated CMR file The output is a single CSV file that contains correlated data from the CDR file and CMR file Example cdr output dir opt uba cdromr 50 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack Field Description collect cdr If true ProvisoCUCM requests CDR and CMR data from the CUCM servet If false ProvisoCUCM will not poll the CUCM server for CDR and CMR data Example collect cdr true collect perfmon If true ProvisoCUCM requests Perfmon data from the CUCM server If false ProvisoCUCM will not poll the CUCM server for Perfmon data Example collect perfmon tru cucm host The IP address of the CUCM server associated with this properties file Examples cucm host 10 1 2 3 cucm host cucm mycorp com cucm pass User password required for login to the CUCM Example cucm pass cucmpwd cucm port The port number for SOAP requests sent to the CUCM server Example cucm port 443 cucm user User ID required for login to the CUCM Example cucm user cucmuser d
68. ert CDRs The referenced system does not need Cisco CallManager installed but does need SQL server and a CDR database This parameter allows movement of the CDRs off of the Cisco CallManager cluster If this parameter is missing CDRs are written locally to the PrimaryCDRUNCPath CDRFlatFileInterval A parameter that determines the amount of time in minutes that a CDR file can be written to before Cisco CallManager closes the CDR file and opens a new one Supported MIBs This technology pack uses the following MIB files cisco 10 mib CISCO CCM MIB my CISCO CDP MIB my CISCO DSP MGMT MIB my CISCO GATEKEEPER MIB my CISCO POP MGMT MIB my MSSQL MIB my tfc1213 MIB II rfc1514 HOSTRESOURCES rfc1907 SNMPv2 MIB rfc2127 ISDN MIB rfc2233 IF MIB Bulk input file formats The Cisco IP Telephony devices gather performance data and other statistics from multiple network elements This data is referred to collectively as network health metrics Each Cisco IP Telephony device produces on an hourly basis a bulk input file that contains the network health metrics and other information The Cisco IP Telephony Technology Pack supports multiple input files where each input file contains data for one polling period only The syntax for these bulk input files is discussed in Bz amp input file name on page 10 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 2 Devices and Services The Cisco IP
69. eshoot operations Tivoli Netcool Proviso DataLoad provides flexible distributed data collection and data import of SNMP and non SNMP data to a centralized database Tivoli Netcool Proviso DataChannel aggregates the data collected through Tivoli Netcool Proviso DataLoad for use by the Tivoli Netcool Proviso DataView reporting functions It also processes on line calculations and detects real time threshold violations Tivoli Netcool Proviso DataView is a reliable application server for on demand web based network reports Tivoli Netcool Proviso Technology Packs extend the Tivoli Netcool Proviso system with service ready reports for network operations business development and customer viewing Figure 1 shows the different Tivoli Netcool Proviso modules Figure 1 Tivoli Netcool Proviso modules DataLoad DataChannel DataMart DataView collects Ww computes _ gt gt provides data p produces and network data aggregations management manages reports and stores data and applications in DataMart DataLoad SNMP Collector DataChannel DataLoad Processor SNMP Collector Dataview Dataview DataLoad i DataChannel DataMart Dataview phas Processor Applications Report Cluster Tivoli Netcool Proviso documentation IBM provides the following Tivoli Netcool Proviso documentation Release notes Configuration recommendations User guides References Technical notes Online help I
70. estination is one of the VoiceMail extension number defined in the VoiceMailExtensionRange variable from the UBA xml adaptor configuration file IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 35 Chapter 3 Supported Reports and KPIs Table 2 Key performance indicators KPI Comment ClusterIncomingCall Identifies a call where caller is not an internal extension An Incoming call is also An Inbound call An Off net call coming from the PSTN ClusterInternalCall An Internal Call is a call between 2 internal extensions managed by one or more CallManager Clusters where the 2 Extension numbers caller and callee are short internal numbers An Internal call or Company call can be An Outbound or Inbound call A call between 2 IP phones from the same site A call between 2 IP phones from different sites A call between 1 IP phone and 1 legacy phone from the same site A call between 1 IP phone and 1 legacy phone from different sites7 Internal IntrasitelP OR IntersiteIP OR IntrasiteLegacyPBX OR IntersiteLegacyPBX7 An On net call pure IP Network transit An Off net call IP to PSTN Gateway call An Internal call can never be A call between an Internal Extension and any External PSTN Number Note Internal extensions are managed through the UBA xml adaptor configuration file where the variable ExtensionRange has to be defined ClusterInternationalCall Identifies a c
71. et 2 Copy technology specific files from the DataMart server to the DataChannel server Technology specific files are used to associate a UBA technology pack with a specific instance of the UBA Note While it is possible to install DataMart and DataChannel on the same server in a typical installation these modules are installed on separate servers If this is the case use ftp to copy the technology specific files Otherwise if DataMart and DataChannel are on the same server use the op command to copy the files to the appropriate DataChannel directory To copy technology specific files to the DataChannel server follow these steps 2 a Log in to the Tivoli Netcool Proviso DataChannel server by entering the user name and password that you specified when installing and configuring a DataChannel The default user name and password are pvuser and PV respectively 2 b Change your working directory to the DATA CHANNEL HOME scripts voip cisco ipt directory by entering the following command replacing DATA_CHANNEL_HOME with the DataChannel home directory opt datachannel by default cd DATA CHANNEL HOME scripts voip cisco ipt 2 c Using the ftp utility in text mode log into the DataMart server using the appropriate user name and passwotd pvuser and PV by default 2 d Using the cd subcommand change your working directory to the SPVMHOME APFiles voip cisco ipt datachannel scripts voip cisco ipt directory 2 e Using the ge
72. failed due to a misdialed trunk prefix CauseNetworkOutOfOrder Call failed because the network was out of order CauseNoAnswerFromUser Call failed because there was no answer at the destination end CauseNoChannelAvailable Call failed due to lack of available channel CauseNoRouteToDestination Call failure due to lack of route to destination CauseNoRouteTransitNetwork Call failued due to lack of available route in the transit network CauseNoUserResponding Call failed because receiving end sent no RTP data CauseNumberChanged Recipient number has changed CauseOther Call failure code is othet CauseResourceUnavailable Call failed due to lack of resources CauseSubscriberAbsent Call failed because the subscriber called is tagged as absent CauseSwitchCongestion Call failed due to switch congestion Cause TemporaryFailure Generic temporaty call failure CauseUnassignedNumber Call failed due to unassigned destination number CauseUserBusy Call failed due to busy received from destination Cluster Erlang Cluster Erlang measured in minutes ClusterCallDuration 60 Cluster Number of Direct VoiceMail Calls Total number of VoiceMail Calls that are Direct call to VoiceMail This is Nb the case when a user dials directly his VoiceMail This metric is the opposite of ForwardTo VoiceMail 34 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI
73. ge the contents of this file with the file inventory subelements txt located in PV MHOME conf typically opt datamart conf on the DataMart server To merge the subelement inventory control rules for the Cisco IP Telephony Technology Pack follow these Steps 4 a Change your working directory to PVMHOME conf by entering the following command cd PVMHOME conf 4 b Copy voip cisco ipt inventory subelements txt to the PVMHOME conf directory by entering the following command cp SPVMHOME APFiles voip cisco ipt datamart conf voip cisco ipt inventory subelements txt 4 c Make a backup copy of the inventory subelements txt file by entering the following command cp inventory subelements txt inventory subelements txt ORIG 4 d Append the contents of voip cisco ipt inventory subelements txt to inventory subelements txt by entering the following command cat voip cisco ipt inventory subelements txt gt gt inventory subelements txt Important Ensure that you use two forward brackets gt gt otherwise the original contents of inventory_subelements txt will be overwritten 4 e Perform a diff on the backed up file and the appended file to ensure that the merge succeeded as shown in the following example diff inventory subelements txt inventory subelements txt ORIG Important If you do not have a CCM environment skip Step 5 and continue with Step 6 48 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 T
74. gt lt instance gt do where Variable Meaning DATA CHANNEL HOME Is opt datachannel by default lt channel gt Specifies the channel number for example 1 that you specified when configuring this DataChannel lt collector gt Specifies the collector number for example 100 that you specified when configuring this UBA bulk collector lt instance gt Tivoli Netcool Proviso v4 4 3 and later Specifies the string for the INSTANCES parameter in the pack XSD file Typically this string represents the name of the pack and is read only You can view the string specified for INSTANCES by using the Topology Editor lt instance gt Tivoli Netcool Proviso pre v4 4 3 only Specifies the string for the INSTANCES parameter in the pack template file You were instructed to copy this parameter to the dc cfg file in a previous step The UBA application then processes the bulk input file according to the instructions in the Bulk Adaptor Design File Note The first time that the UBA processes a bulk input file it passes a metric to the CME The CME rejects this metric as a BAD_METRIC because the metric does not have an associated grouped subelement prior to the time this metric is recorded This is expected behavior The CME accepts metrics from the bulk input files after the inventory is run 15 b Ensure that the UBA application can successfully read the bulk input file that you copied into the sourc
75. hat handle inventory and metrics must be directed to the location of the Bulk input files generated by the devices associated with the technology on which the application operates The CDRINPUT URI parameter specifies the location in Universal Resource Identifier URI format for the specified DataChannel applications to retrieve Bulk input files for CDR data A related parameter CDRINPUT DELETEONACQUIRE specifies whether the UBA application should delete these Bulk input files after it acquires them 70 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT DESIGNFILE Description JavaScript file that controls UBA for CCM or CUCM metrics Component UBA Value Default CUCMA daptor js Attribute Read only Location Properties tab Detail Netcool Proviso technology packs control the behavior of the DataChannel UBA application through instructions contained in Bulk Adaptor design JavaScript files The DESIGNFILE parameter identifies the name of a technology pack s design file CCM metrics require the CCMAdaptor js design file CUCM metrics require the CUCMAdaptor js design file This is a read only parameter IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 71 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT DESIGNFILE Descriptio
76. he CMR table Its set only once the call is established This metric is only available for IP Phones ClusterOffNetCall Identifies a call where at least one PSTN Gateway is involved in the Voice path with the following criteria Inbound or Outbound call Internal or call to from PSTN number Intersite or Intrasite Legacy PBX Call ClusterOnNetCall Identifies a call where the caller is an internal extension and where the callee is also an internal extension from the same site or different sites with the following criteria Outbound call Internal call Intersite or Intrasite IP Call No PSTN Gateway is involved in the Voice path This is a pure IP to IP call IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 37 Chapter 3 Supported Reports and KPIs Table 2 Key performance indicators KPI Comment ClusterShortCall Identifies a call successfully established but with a call duration less than 1 second In this case the CallManager set the CallDuration value to 0 in the CDR table A ShortCall call is also A Successful call Any Inbound Outbound or other type of call described above ClusterSuccessfulCall Identifies a call successfully established Once the call is established the communication starts between the 2 parties A successful call can be an Inbound Outbound or any type of call described above ClusterTollBypassCall Identifies a call where the ca
77. iginal software b credit is given to the original software in the source code and documentation of the derived work c the copyright notice at the top of this document accompanies copyright notices of any modified version Xwpick Copyright O 1993 1994 by Evgeni Chernyaev Permission to use copy modify and distribute this software and its documentation for non commercial purpose is hereby granted without fee provided that the above copyright notice appear in all copies and that both the copyright notice and this permission notice appear in supporting documentation Xwpick is used for printing utilities Sieve of Eratosthenes Copyright Frank Pilhofer fp fpx de Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither the name of Frank Pilhofer nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING
78. ined data collection requests using the Request Editor To set data collection requests to active follow these steps IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 47 Chapter 4 Configuring the technology pack 3 a Change your working directory to PVMHOME bin opt datamart bin by default on the DataMatt server 3 b Invoke the DataMart GUI by entering the following command and pressing Enter pvm 3 c Click the Configuration tab then click Request Editor to open the Request Editor 3 d Click the Collection tab 3 e Click Refresh The predefined data collection requests are loaded into the Request Editor from the database 3 f Click the Inactive button in the Filter group box to display only idle requests 3 g In the Sub Element Groups pane select all idle data collection requests in the following group or groups Root gt Sub Element Collect gt VOIP gt Cisco 3 h Click the Active box under Details The Request Editor toggles the idle setting for these data collection requests from idle to active in the Active column 3 1 Click Save 4 Merge the technology pack subelement inventory text files Subelement inventory control rules for the Cisco IP Telephony Technology Pack are contained in the file voip cisco ipt inventory subelements txt which is installed in the following directory on the DataMart server SPVMHOME APFiles voip cisco ipt datamart conf You must mer
79. ing Typically this event occurs because of a licensing issue The Bulk Adaptor Design File might be corrupt This event causes a syntax error before the UBA application connects to the database The UBA application connects to the database This event causes a message similar to the following example to display DB_CONNECT Connecting to lt sid gt as lt user gt If you see this database connection message without prior errors the UBA application has passed the syntax check 58 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack 15 Ensure that the bulk input files can be read To verify that the UBA application can read the bulk input files follow these steps 15 a Place a bulk input file at the source input location Tivoli Netcool Proviso v4 4 3 and later The source input location for bulk input files is specified using the URI parameter from the pack XSD file which you can view using the Topology Editor Tivoli Netcool Proviso pre v4 4 3 only The source input location for bulk input files is specified using the URI parameter from the template file which you added to the dc c g file in a previous step Within the configured file retrieval interval typically five minutes the UBA application retrieves the bulk input file and copies it to the following directory DATA CHANNEL HOME UBA lt channel gt lt collector
80. ion FTP or SFTP password for Bulk input files used for collecting Perfmon metrics in CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_FTP_PASSWORD parameter specifies the password that the server administrator assigned using the ftp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this password to gain access to the server on which the Bulk input files reside Likewise the UBA uses this same password to gain access to the server on which the Bulk input files reside IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 83 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON INPUT_FTP_USERNAME Description FTP or SFTP username for Bulk input files used for collecting Perfmon metrics in CUCM environments Component UBA Value Default No default value Attribute Writable Location Properties tab Detail The INPUT_FTP_USERNAME parameter specifies the username that the server administrator assigned using the ftp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this username to gain access to the server on which the Bulk input files reside Likewise the UBA uses this same username to gain access to the server on which the Bulk input files reside 84 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack
81. irect call to VoiceMail This is the case when a user dials directly his VoiceMail This metric is the opposite of ForwardToVoiceMail UnsuccessfulCall VoiceMailCall Identifies a call which has not been successfully established In this case the call setup has been rejected and the communication never started between the 2 parties An Unsuccessful call can be an Inbound Outbound or any type of call described above Identifies a call where the final destination callee is a VoiceMail The VoiceMail application is managed through a specific range of extensions number defined site by site using the global variable VoiceMailExtensionRange VoicemailCallDuration Time value in Seconds of any call duration with the VoiceMail application VoicemailPackets Number of Packets Sent Received by the subelement during a call with the VoiceMail This metric comes from the CMR table Its set only once the call is established with one of the VoiceMail extension 44 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 4 Configuring the technology pack This chapter explains how to configure the Cisco IP Telephony Technology Pack and consists of the following topics Topic Page Overview 45 Before you begin 45 Configure the technology pack 46 Overview Tivoli Netcool Proviso supports the following two types of technology packs based on the type of data that
82. iso pre v4 4 3 If there is no graphics card on the DataMart server you can install the Xvfb virtual frame buffer package to provide X Window services as described in the IBM Tivoli Netcool Proviso Installation Guide Access to the SilverStream server Access to the DataChannel server e Have completed the following tasks Reviewed the release notes for the current technology pack Important Release notes contain important information you need to consider before installing a technology pack They also contain information on specific patches that need to be installed before you configure a technology pack Installed the current version of the Tivoli Netcool Proviso components as described in the IBM Tivoli INetcool Proviso Installation Guide Installed the MIB II Technology Pack Note The MIB II Technology Pack is a stand alone technology pack that is contained in its own jar file Installed the Cisco IP Telephony Technology Pack Note Installation instructions for a technology pack can be found in the Appendices of the IBM Tivoli Netcool Proviso Installation Guide covers core and technology packs Upgrade instructions for a technology pack can be found in Chapter 3 of the IBM Tivoli Netcool Proviso Upgrade Guide covers core and technology packs Localization is done automatically during installation of the technology pack Configured at least one DataChannel Configured a UBA bulk collector subchann
83. ity percent Charts AP global Availability DSP Card Utilization Media Devices Media Device Resource KPIs CCM Media Device Registration Availability percent Charts Registration Availability Distribution Chart Media Device Group KPIs CCM Media Device Registration Availability percent IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 27 Chapter 3 Supported Reports and KPls Charts Media Device Registration Distribution Chart Gatekeeper Device Gatekeeper Device Quality Resource Detail Chart KPIs Gatekeeper Total Number of Concurrent Calls Nb Gauge Gatekeeper Packet Errors Nb Gatekeeper Total Number of Admission Requests Nb Gatekeeper Buffer Utilization percent Gatekeeper Total Number of Location Rejects Nb Gatekeeper Total Number of Admission Rejects Nb Gatekeeper Total Packets Nb Gatekeeper Call Setup Quality percent Gatekeeper Total Number of Location Requests Nb Gatekeeper CPU Utilization percent avg last 5 mn Charts Total Number of Packets Admission vs Location Rejects avg CPU Utilization percent Call Setup Quality percent Buffer Utilization percent Packet Errors Nb Admission vs Location Requests avg Active Calls Nb Gatekeeper Device Quality Resource KPIs Gatekeeper Total Number of Concurrent Calls Nb Gauge Gatekeeper Packet Errors Nb Gatekeeper Total Packet
84. l Trace 0 TraceDIl opt datachannel lib odbctrac so TraceFile odbctrace out UseCursorLib 0 All fields above which appear in a ics must be configured according to your CallManager Publisher environment as follows Field Description ODBC Data One entry per CallManager Publisher Sources Note The data source name must match the data source name specified in the corresponding URI Uniform Resource Identifier parameter in the dc c g file Each line in this section should also be associated with a subsection that configures the data source IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 49 Chapter 4 Configuring the technology pack Field Description Data Soutce Name The configuration of the specified data source Data Source Name for example SANFRANCISCO Address the remote IP address and TCP port of the CallManager Publisher Database for example 192 168 1 1 1433 To verify the remote connection configuration establish the connection manually from a shell window telnet XX XX XX XX 1433 ortelnet xx xx xx xx 1370 The remote TCP port can be 1433 or 1370 according to the SQL Server configuration ODBC A elobal section that defines the global environment for the bridge Important Ifyou do not have a CUCM environment skip Step 6 through Step 9 and continue with Step 10 6 CUCM environment only On the DataChannel host create a dire
85. lied with the XSD file for the Cisco IP Telephony Technology Pack The descriptions are the same as those that display in the Topology Editor Help These reference pages are provided for convenience Overview The following pages provide a reference for the UBA parameters that this technology pack provides The reference pages have the following sections Parameter name Each reference page begins with the parameter name using the following syntax device instance schema parameter name whete device specifies the name of the device instance specifies the group alias typically a string that represents the name of the technology pack schema specifies the string passed to the input schema object referenced in the bulk adaptor design file parameter name specifies the name of the parameter In the Detail sections of the reference pages parameter names in the descriptions are typically referenced as schema parameter name or simply parameter name The descriptions do not reference the device or instance part of the parameter name Description A short description that identifies the purpose of the parameter Component The DataChannel application or component to which the parameter applies The value specified for this parameter controls the behavior of this DataChannel application This section can contain the following values BLB specifies the DataChannel BLB Bulk Load Balancer application
86. ll Identifies a call where the caller is an internal extension managed by the CallManager and where the callee can be an internal extension or any external PSTN Number with one or more following criteria Outbound call Off net call The call is going through a PSTN Gateway and caller site and PSTN Gateway site are different An intersiteLegacyPBXCall can be also a TollBypassCall if the PSTN Gateway site is different from the caller site TollBypass calls are interesting to save money for long distance or international calls using a remote PSTN Gateway with local fees7 Example A caller in Boston makes a call to an external PSTN number base in London Because there is an IP VPN between the Boston office and the London office with a PSTN Gateway in London the call goes through the IP network until the Londons PSTN Gateway TollbypassCallDuration Time value in seconds of the call duration when the call is classified as a TollBypass call Total Number of Calls Nb CME Bulk VOIP Cisco Total number of inbound and outbound calls for this Call Manager device Total Number of Outgoing External Calls Nb Any Outbound call going to the PSTN This metric is a subset of the Cluster Total Number of External Calls An Outgoing External call is define as A Local Call A Long Distance Call An International Call Total Number of VoiceMail Direct Calls Nb CME Bulk VOIP Cisco Total number of VoiceMail Calls that are D
87. ller is an internal extension managed by the CallManager and where the callee can be an internal extension or any external PSTN Number with one or more following criteria Outbound call Off net call The call is going through a PSTN Gateway and caller site and PSTN Gateway site are different An intersiteLegacyPBXCall can be also a TollBypassCall if the PSTN Gateway site is different from the caller site TollBypass calls are interesting to save money for long distance or international calls using a remote PSTN Gateway with local fees7 Example A caller in Boston makes a call to an external PSTN number base in London Because there is an IP VPN between the Boston office and the London office with a PSTN Gateway in London the call goes through the IP network until the Londons PSTN Gateway ClusterTotalCall Total Number of Calls including call attempts for the complete Cluster ClusterUnsuccessfulCall Identifies a call which has not been successfully established In this case the call setup has been rejected and the communication never started between the 2 parties An Unsuccessful call can be an Inbound Outbound or any type of call described above Cluster VoiceMailCall Identifies a call where the final destination callee is a VoiceMail The VoiceMail application is managed through a specific range of extensions number defined site by site using the global variable VoiceMailExtensionRange Cluster Voicemail
88. llsInProgress HuntlistCallsInProgress HuntlistCallsActive SIPCallsInProgress H323CallsInProgress GatewayCallsActive SIPCallsActive H323CallsActive Perfmon Security Group KPIs EncryptedCallsActive AuthenticatedPartiallyRegisteredPhone AuthenticatedCallsActive CallsActive AuthenticatedRegisteredPhones EncryptedRegisteredPhones EncryptedPartiallyRegisteredPhones AttendantConsoleClientsRegistered AttendantConsoleClientsOnline Perfmon Security Resource KPIs EncryptedCallsActive AuthenticatedPartiallyRegisteredPhone AuthenticatedCallsActive CallsActive AuthenticatedRegisteredPhones EncryptedRegisteredPhones EncryptedPartiallyRegisteredPhones AttendantConsoleClientsRegistered AttendantConsoleClientsOnline IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 31 Chapter 3 Supported Reports and KPls Perfmon PSTN Resource KPIs T1SpansInService T1ChannelsActive FXSPortsInService EXOPortsActive BRIChannelsActive FXSPortsActive e EXOPortsInService BRISpansInService Perfmon PSTN Group KPIs T1SpansInService T1ChannelsActive FXSPortsInService FXOPortsActive BRIChannelsActive FXSPortsActive FXOPortsInService BRISpansInService Perfmon MOH Resource KPIs MOHUnicastResourceActive MOHTotalUnicastResources MOHUnicastResourceAvailable MOHMulticastResourceActive e MOHTotalMulticastResources
89. logos are gt trademarks of Sun Microsystems Inc in the United Java States other countries or both Other product and service names might be trademarks of IBM or other companies O Copyright IBM Corp 2010 US Government Users Restricted Rights Use duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 97 Notices 98 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Additional Copyright Information The following copyright information is for software used by Tivoli Netcool Proviso 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 Sun Microsystems Inc Scriptics Corporation and other parties The following terms apply to all files associated with the software unless explicitly disclaimed in individual files The authors hereby grant permission to use copy modify distribute and license this software and its documentation for any purpose provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions No written agreement license or royalty fee is required for any of the authorized uses Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here provided that the new terms a
90. mand to start all DataChannel applications dccmd action start all 14 h Use the dccmd command to vetify that all of the DataChannel applications started properly dccmd action status all More specifically make sure that the UBA application associated with the DataChannel you configured for the Cisco IP Telephony Technology Pack is running 14 i Watch the output of the status switch to verify that all the necessary processes are running If these processes are running run the tail utility on the log file for the UBA by issuing a command similar to the following example tail f DATA CHANNEL HOME 1og proviso log grep UBA lt channel gt colletor more where Variable DATA CHANNEL HOME Meaning Is opt datachannel by default channel Specifies the channel number for example 1 you specified when configuring this DataChannel lt collector gt Specifies the collector number for example 100 you specified when configuring this UBA Bulk Collector The trailing dash after lt collector gt Removes extraneous log messages from your view That is the trailing dash guarantees that the command displays only those messages generated by your application The first set of messages relate to syntax checks The following table identifies some events to watch for during the syntax check Event The UBA application starts successfully but then stops executing Mean
91. ment lasting longer than fifty milliseconds or five percent of the voice traffic SIPCallsActive Total number of currently active SIP calls for the resource or resources specified SIPCallsInProgress Total number of SIP calls being established at the time of sampling SNMP Availability percent avg last hour PROVISO Performance Metric works with PVL 1 2 or better SNMP Response Time ms avg last hour SNMP response time measured in milliseconds averaged over the last hour SNMP Unavailable percent avg last hour Created by CME Formula Editor ShortCall SuccessfulCall Identifies a call successfully established but with a call duration less than 1 second In this case the CallManager set the CallDuration value to 0 in the CDR table A ShortCall call is also A Successful call Any Inbound Outbound or other type of call described above Identifies a call successfully established Once the call is established the communication starts between the 2 parties A successful call can be an Inbound Outbound or any type of call described above IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 43 Chapter 3 Supported Reports and KPIs Table 2 Key performance indicators KPI Comment T1ChannelsActive Total number of T1 channels currently in use in the target device T1SpansInService Total number of T1 spans available in the target device TollBypassCa
92. n JavaScript file that controls UBA for CCM or CUCM metrics Component UBA Value Default CCMAdaptor js Attribute Read only Location Properties tab Detail Netcool Proviso technology packs control the behavior of the DataChannel UBA application through instructions contained in Bulk Adaptor design JavaScript files The DESIGNFILE parameter identifies the name of a technology pack s design file CCM metrics require the CCMAdaptor js design file CUCM metrics require the CUCMAdaptor js design file This is a read only parameter 72 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT INPUT_DIRECTORY Description Path to Bulk input files directory for CCM or CUCM metrics Component UBA Value Default sqldb odbc threaded username user amp password passwd amp environment EX AMPLE Attribute Writable Location Properties tab Detail The INPUT_DIRECTORY parameter specifies the path to the directory where the generated Bulk input files should be stored Do not enter any subdirectories and the actual wildcards used to specify the Bulk input files to be acquired Any subdirectories and wildcards are automatically specified in the URI related parameters An example of an input directory specification is opt uba CCM metrics are accessed through ODBC to a SQL database CUCM metrics are accessed through S
93. nationalCall ustet LocalCall uster Total Number of External Calls Nb usterInternalCall usterIncomingCall Charts Types of Calls Distribution Incoming vs Outgoing Calls Ratio Cluster Call Distribution Group KPIs Cluster Total Number of Outgoing External Calls Nb ClusterLongDistanceCall Chapter 3 Supported Reports and KPIs IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 17 Chapter 3 Supported Reports and KPls ClusterInternationalCall ClusterLocalCall ClusterInternalCall ClusterIncomingCall Charts Incoming vs Outgoing Calls Ratio Types of Calls Distribution Top 10 Cluster Call Completion KPIs Cluster Percentage of Successful Calls percent Cluster Percentage of Drop Calls percent Cluster Percentage of Normal Call Clearing percent Cluster Quality Group KPIs ClusterMOS Cluster Percentage of Drop Calls percent MLQK ClusterLatency ClusterJitter Cluster Percentage of Packet Lost percent Cluster Percentage of Successful Calls percent Charts Successful Calls Percent Distribution Chart Mean Opinion Score Cluster Utilization Group KPIs Cluster Percentage of Company Calls percent ClusterIntersiteIPCall Cluster Percentage of TollBypass Calls percent Cluster Erlang ClusterNbPacketsReceived uster Total Hours of Traffic C ClusterNbPacketsSent C ustet TotalCall 18 IBM Tiv
94. nd and Outbound Packet Loss percent IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 29 Chapter 3 Supported Reports and KPIs Gatekeeper Interface Availability Resource KPIs Interface Availability percent Inbound Loss percent Outbound Loss percent Gatekeeper Interface Utilization Resource Detail Chart KPIs Interface Bandwidth Utilization Out percent Interface Bandwidth Utilization In percent Interface Throughput Out kbps Interface Throughput In kbps Charts Inbound vs Outbound Utilization avg APglobal Outbound Utilization percent Inbound vs Outbound Throughput avg APglobal Inbound Utilization percent Outbound Throughput kbps Inbound Throughput kbps Gatekeeper Interface Utilization Resource KPIs Interface Bandwidth Utilization Out percent Interface Bandwidth Utilization In percent Interface Throughput Out kbps Interface Throughput In kbps Charts nbound Utilization Distribution Chart Outbound Utilization Distribution Chart Perfmon Perfmon Active Calls Resource KPIs Calls Active CallsInProgress HuntlistCallsInProgress HuntlistCalls Active SIPCallsInProgress H323CallsInProgress 30 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls GatewayCalls Active SIPCallsActive H323CallsActive Perfmon Active Calls Group KPIs CallsActive Ca
95. nnect to an SFTP server Connect to an FTP server with a client that supports only SFTP IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 79 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP CISCO IPT INPUT USE SECURE FTP Description Acquire CCM or CUCM Bulk input files using secure FTP Component UBA Value Default false Attribute Writable Location Properties tab Detail The INPUT_USE_SECURE _FTP parameter specifies whether FTP File Transfer Protocol or SFTP secure FTP is used To use FTP specify the value false Otherwise to use SFTP specify the value true The default value is false To use the s tp command you must have an SSH client installed on the servers where the Bulk input files reside and where the DataChannel is running Typically an SSH client is installed by default on most Unix systems For more information see your operating system documentation or the sftp manpage Note You cannot do the following Use an FTP client to connect to an SFTP server Connect to an FTP server with a client that supports only SFTP 80 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT_PERFMON DESIGNFILE Description JavaScript file that controls UBA for CUCM Perfmon metrics Component UBA Value Default CUCMPerfmonAd
96. ntly 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 measurements 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
97. ny Organization This guide is organized as follows Chapter 1 Introduction Provides a general introduction to the Tivoli Netcool Proviso product suite Chapter 2 Devices and Services Provides an overview of the device technology supported by the technology pack Chapter 3 Supported Reports and KPIs Provides information about the reporter sets and key performance indicators KPIs that the Cisco IP Telephony Technology Pack provides for each device operating in the Cisco IP Telephony environment Chapter 4 Configuring the technology pack Describes how to configure the Cisco IP Telephony Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later Provides UNIX reference pages for each of the pack specific UBA parameters supplied with the XSD file for the Cisco IP Telephony Technology Pack IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 1 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 configuration as well as to verify and troubl
98. o IP Telephony 2 4 0 0 Technology Pack CallDuration NbPacketsSent Charts Company Calls Percent Distribution Chart TollBypass Calls Distribution Chart CDR Call Distribution Group KPIs Local Incoming LongDistance International Total Number of Outgoing External Calls Nb Internal Charts K Factor Incoming vs Outgoing Calls Ratio Types of Calls Distribution K Factor Resource KPIs MLQKmx MLQKmn MLQK MLQKav ICRmx ICR SCS CS CCR K Factor Group KPIs MLQKmn MLQK MLQKav ICRmx ICR Chapter 3 Supported Reports and KPls IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 23 Chapter 3 Supported Reports and KPIs Codec SCS e CS CCR Charts Mean Opinion Score Top 10 CDR K Factor KPIs CCR ICR e CS SCS MLQK Errors on Cluster by Codec KPIs CauseTemporaryFailure CauseNetworkOutOfOrder CauseChannelUnacceptable CauseUserBusy CauseDestinationOutOfOrder CauseNoRouteTransitNetwork CauseUnassignedNumber CauseNumberChanged CauseNoChannelAvailable e CauseMisdialed TrunkPrefix CauseNoRouteToDestination CauseInvalidNumberFormat CauseNoAnswerFromUser CauseOther CauseNoUserResponding CauseResourceUnavailable CauseCallRejected CauseSubscriberAbsent CauseSwitchCongestion 24 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Infrastructure Chapte
99. o view a description of any errors 17 g Optional You can also deploy reports on a regular basis by creating a cron entry that makes use of the inventory CLI command and the reportGrouping option This option instructs the inventory command to run the report grouping rules and update the deployed reports stored in the database Report grouping rules must first have been created before this option can be used For information on creating report grouping rules see the IBM Tivoli Netcool Proviso DataMart Configuration Guide The following example shows a cron entry that periodically performs the deploy report operation O opt datamart dataMart env amp amp inventory noX reportGrouping See the IBM Tivoli Netcool Proviso Command Line Interface Guide for more information about the inventory command Verifying resources Use the Tivoli Netcool Proviso DataMart Resource Editor to determine whether the technology pack resources elements subelements properties and so on were successfully discovered and created in the database during inventory See the IBM Tivoli Netcool Proviso DataMart Configuration Guide for information about using the Tivoli Netcool Proviso DataMart Resource Editor 62 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later This appendix provides UNIX reference pages for each of the pack specific UBA parameters supp
100. ocation Advanced Properties tab Detail The CCMINPUT DELETEONACQUIRE parameter specifies whether the Bulk input files should be preserved after the UBA acquires them A related parameter CCMINPUT URI specifies the location of the Bulk input files Set this parameter to the value true to instruct this UBA application to delete the CCM Bulk input files after it acquires them Otherwise set this parameter to false to instruct this UBA application to preserve the Bulk input files after it acquires them IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 67 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT CCMINPUT URI Description CCM Bulk input files location Component UBA Value Default No default value Attribute Read only Location Properties tab Detail The DataChannel applications that handle inventory and metrics must be directed to the location of the Bulk input files generated by the devices associated with the technology on which the application operates The CCMINPUT URI parameter specifies the location for the specified DataChannel applications to retrieve these Bulk input files A related parameter CCMINPUT DELETEONACQUIRE specifies whether the UBA application should delete the Bulk input files after it acquires them The syntax for the URI is as follows sqldb odbc threaded username userName password password en
101. ogram 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 Web sites are not patt 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 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 95 Notices Licensees of this program who wish to have information about it for the purpose of enabling 1 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 274A 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 significa
102. ogy on which the application operates The PERFMON URI parameter specifies the location in Universal Resource Identifier URI format for the specified DataChannel applications to retrieve Bulk input files for CDR data A related parameter PERFMON DELETEONACQUIRE specifies whether the UBA application should delete these Bulk input files after it acquires them 88 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only You should read this appendix after you openthevoip cisco ipt sample dc cfg template file for editing as instructed in Chapter 4 Configuring tbe technology pack This appendix describes the pack specific UBA parameters that you need to add to the dc cfg file and explains how to tailor the values to your specific deployment Template file name and location The voip cisco ipt sample dc cfg template file is located in the following directory on the DataChannel server DATA CHANNEL HOME scripts voip cisco ipt opt datachannel scripts voip cisco ipt by default You were instructed to copy the voip cisco ipt sample dc cfg template file in a configuration step step 2 on page 47 described in Chapter 4 Pack specific UBA parameters The voip cisco ipt sample dc cfg template file provides the following pack specific UBA parameters UBA channel number collector number INSTANCES instance
103. oli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Charts TollBypass Calls Distribution Chart Comapny Calls Percent Distribution Chart Top 10 Cluster Number of Calls KPIs ClusterTotalCall ClusterOnNetCall ClusterIncomingCall Cluster Total Number of Outgoing External Calls Nb ClusterOffNetCall Top 10 Cluster Number of Errors KPIs Cluster Percentage of Successful Calls percent ClusterShortCall Cluster Percentage of Packet Lost percent Cluster Percentage of Drop Calls percent Cluster VoiceMail Usage Resource KPIs luster VoicemailPackets usterForwardTo VoiceMail uster VoiceMailCall uster Number of Direct VoiceMail Calls Nb C C ClusterVoicemailCallDuration C C Charts Direct vs Forward Calls ratio Cluster IP vs Legacy Resource KPIs Cluster TollBypassCall Cluster Total Number of External Calls Nb Cluster Total Number of Company Calls Nb Cluster Total Number of Company LegacyPBX Calls Nb Cluster Total Number of Company IP Calls Nb Charts External vs Company Calls Ratio IP vs LegacyPBX Calls Ratio IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 19 Chapter 3 Supported Reports and KPIs Cluster Utilization MLH Resource KPIs ClusterTollBypassCall ClusterNbPacketsLost Cluster Total Number of Company Calls Nb Cluster Total Hours of Traffic Clus
104. ommunications Manager CUCM the technology pack collects CDR CMR and Perfmon data files in either of the following ways Through SOAP requests to the CUCM server and PerfmonPorts API Through a schedule for pushing the data files back to the DataChannel server The schedule is specified by CUCM Web administration configuration settings In both cases the CUCM pushes the data back to the technology pack via FTP The technology pack includes a Java application called ProvisoCUCM This application is responsible for sending the SOAP requests to the CUCM and for producing the CSV files for the UBA from the data files pushed back to the DataChannel server by the CUCM server The ProvisoCUCM finds the address of the CUCM server authentication information and other configuration details in the file cucm properties You install and edit this file when you configure the technology pack as described in Chapter 4 Configuring the technology pack The following figure illustrates the technology pack s data collection architecture in a CUCM environment UBA Bulk Collector ProvisoCUCM SOAP 1 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 7 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 acces
105. on Availability percent Percentage availability that media devices could register with a CCM server CCM Physical Memory Utilization percent In order to know the percentage of memory utilization we have to sum the amount of real system memory allocated to each process and then divide this value with the amount of physical memory contained by the host CCM Registered CTI Devices Nb Gauge Total number of CTI devices which are registered to the CCM CCM Registered Devices Nb Gauge Number of devices currently registered to the CCM device CCM Registered Gateways Nb Gauge CCM Registered Media Devices Nb Gauge CCM Registered Phones Nb Gauge Total number of media gateways registered to a CCM device Total number of media devices registered to a CCM server Total number of IP phones registered to a CCM device CCM Registered VoiceMail Devices Nb Gauge Total number of registered voicemail devices CCM Rejected Devices Nb Gauge Total number of rejected devices CCM SQL Server Availability percentage CCM SQL server availability percentage CCM SQL Server Cache Hit ratio percent Buffer cache hit ratio Percentage of time that a requested data page was found in the data cache instead of being read from disk CCM SQL Server Total number of Pages Total number of pages read and write CCM SQL Server free buffers Nb Total number of data cache buffers
106. pecified when configuring this UBA Bulk Collector O0 noX O0 17 You must use the Inventory Tool to run a bulk inventory profile To run the bulk inventory profile for this technology pack perform the following steps 16 a In the command window where you loaded the DataMart environment change your working directory to SPVMHOME bin opt datamart bin by default on the DataMart server 16 b Invoke the DataMart GUI by entering the following command and pressing Enter pvm 16 c Click Inventory Tool in the Resource tab The Inventory Tool window appears This window displays a list of the existing inventory profiles on the Configuration tab The name of the inventory profile to run is bulk NN where N is the collector number configured for this pack 16 d On the Configuration tab click on the bulk inventory profile for this technology pack and then select Run Profile from the Action menu The Live Information tab displays messages about the status of the profile See the IBM Tivoli INetcool Proviso DataMart Configuration Guide for more information about running an inventory profile 16 e Optional Every time the UBA technology pack design file creates new elements subelements and metrics you must perform the previous steps to group the elements and subelements One way to accomplish this task on a regular basis is to create a cron entry that makes use of the inventory CLI command The following example
107. per Total Packets Nb Total number of packets sent and received by this gatekeeper device GatewayCallsActive Total number of currently active calls for the gateway resource or resources specified H323CallsActive Total number of currently active H 323 calls for the resource or resources specified H323CallsInProgress Total number of H 323 calls being established at the time of sampling HuntlistCallsActive Total number of currently active huntlist calls HuntlistCallsInProgress Total number of currently active huntlist calls ICR Interval Conceal Ratio The average concealment rate measured during the last three seconds of speech ICRmx Maximum conceal ratio during a call IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 39 Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment Inbound Loss percent Out of all inbound traffic received by this entity the percentage of PDUs that a contained defects which prevented them from being deliverable to a higher layer protocol bad checksums bad length etc b were discarded even though no errors are detected i e due to congestion policing or resource limitations or c were discarded because they were of an unknown or unsupported protocol Incoming Identifies a call where caller is not an internal extension An Incoming call is also An Inbound call An Off net call coming
108. r 3 Supported Reports and KPls CallManager Server CCM Server Quality Resource KPIs CCM Rejected Devices Nb Gauge CCM Physical Memory Utilization percent CCM Registered Devices Nb Gauge CCM CPU Utilization percent avg last 5 mn Charts Managed Devices CPU Utilization Distribution Chart CCM Sql Server Resource KPIs CCM SQL Server number of locks CCM SQL Server free buffers Nb CCM SQL Server Cache Hit ratio percent CCM SQL Server number active user connections CCM SQL Server Availability percentage CCM SQL Server number of pending rw CCM SQL Server Total number of Pages CCM SQL Server number of blocked users Charts Cache Hit Ratio percentage Server Availability CCM Sql Server Group KPIs CCM SQL Server number of locks CCM SQL Server free buffers Nb CCM SQL Server number active user connections CCM CPU Utilization percent avg last 5 mn CCM SQL Server number of pending rw CCM SQL Server Total number of Pages CCM SQL Server number of blocked users IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 25 Chapter 3 Supported Reports and KPls Charts CPU Utilization Distribution Chart SQL Server Number of Locks Distribution Chart PSTN Gateway Interface Top 10 E1 T1 Utilization Resource KPIs PSTN Gateway DS1 Active DSO Channels Nb Interface Bandwidth Utilization In percent Interface Bandwidth Utilization Out percent In
109. r Mean Opinion Score calculations This is a subjective metric from the end user point of view In voice communications particulatly Internet telephony the mean opinion score MOS provides a numerical measure of the quality of human speech at the destination end of the circuit The scheme uses subjective tests opinionated scores that are mathematically averaged to obtain a quantitative indicator of the system performance To determine MOS a number of listeners rate the quality of test sentences read aloud over the communications circuit by male and female speakers A listener gives each sentence a rating as follows 1 bad 2 poot 3 fair 4 good 5 excellent The MOS is the arithmetic mean of all the individual scores and can range from 1 worst to 5 best In our context our MOS calculation is based on the consolidation of Jitter Latency and Packets Lost values which give us a good overview of the real MOS value ClusterNbPacketsLost Number of Packets Lost by the subelement during a call This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones ClusterNbPacketsReceived Number of Packets Received by the subelement during a call This metric comes from the CMR table Its set only once the call is established This metric is only available for IP Phones ClusterNbPacketsSent Number of Packets Sent by the subelement during a call This metric comes from t
110. re clearly indicated on the first page of each file where they apply IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE ITS DOCUMENTATION OR ANY DERIVATIVES THEREOF EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT THIS SOFTWARE IS PROVIDED ON AN AS IS BASIS AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION 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 software and 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 the Department of Defense the software shall be classified as Commercial Computer Software and the Government shall have only Restricted Rights as defined in Clause 252 227 7013 c 1 of DFARs Notwithstanding the foregoing the authors grant the U S Government and others acting in its behalf permission to use and distribute the software in accordance with the terms specified in this license SCOTTY Stack Thi
111. ritten permission THE COPYRIGHT HOLDERS AND OTHER CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR OTHER CONTRIBUTORS BE LIABLE FOR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE DATA OR PROFTIS WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHER TORTIOUS ACTION ARISING OUT OF OR IN CONNECTION WITH THE 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 the University of California All Rights Reserved Permission to use copy modify and distribute this software and its documentation for any purpose and without fee is hereby granted provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation and that the name of CMU and The Regents of the University of California not be used in advertising or publicity pertaining to distribution of the software without specific written permission CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIV
112. roject 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 lt http www jdom org gt Regex 1 1a Copyright C 1996 1999 Vassili Bykov It is provided to the Smalltalk community in 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 this agreement 2 The software is provided free of charge and as is in hope that it will be useful with ABSOLUTELY NO WARRANTY The entire risk and all responsibility for the use of the software is with you Under no circumstances the author may be held responsible IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 103 Additional Copyright information for loss of data loss of profit or any other damage resulting directly or indirectly from the use of the software even if the damage is caused by defects 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 and copyright notices are included and intact 5 You may create and distribute modified versions of the software such as ports to other Smalltalk dialects or derived work provided that a any modified version is expressly marked as such and is not misrepresented as the or
113. rom the same site ot different sites with the following criteria Outbound call Internal call Intersite or Intrasite IP Call No PSTN Gateway is involved in the Voice path This is a pure IP to IP call Outbound Loss percent Out of all outbound traffic to be sent by this entity the percentage of PDUs that a contained defects which prevented them from being transferable or b were discarded even though no errors are detected i e due to congestion or resource limitations PSTN Gateway Active DSO Channels Nb Total number of active DSO channels for all of the enabled PRIs in a PSTN device PSTN Gateway Active DSO Channels Nb Gauge Total number of currently active DSO channels for a PSTN gateway PSTN Gateway Call Setup Quality percent Successful Total Percentage of successful call setups for a PSTN gateway device PSTN Gateway DS1 Active DSO Channels Nb Number of Active DSOs Channel that are active for a specific Serial E1 T1 Interface Because there is no specific OID for thisin the MIB we assume that 1 Call 1 DSO Channel 64 kbpsThenThroughput in or out 64000 Active Channels 42 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Table 2 Key performance indicators KPI Comment PSTN Gateway ICMP Inbound Errors percent PSTN Gateway ICMP Outbound Errors percent Percentage of
114. rticular report on the DataView portal see the NOC Reporting tree in the Subelement Groups section of the IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Reference This chapter provides information about deployed reports only For information about understanding report types creating reports configuring reports viewing and working with reports and deploying reports see the Ne coo Proviso DataView Users Guide This Technology Pack User Guide assumes an understanding of the report related topics discussed in the Nezcoo Proviso DataView Users Guide Reporter sets A reporter set contains a group of reporters that together provide information about a specific technology or vendor device Technology pack developers use the Reporter Set Wizard to choose the type of template on which to base the reporter set Technology packs use reporter sets as the framework for defining reports The Cisco IP Telephony Technology Pack reports display on a Web portal the collected information about the devices and technologies that operate in the Cisco IP Telephony environment IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 13 Chapter 3 Supported Reports and KPls 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 Threshol
115. s If this field is false the ProvisoCUCM instance will request the data files from the CUCM server and receive none It will then check for the data files in the location specified by the CUCM Web administration configuration at time intervals specified by run interval or perfmon_interval If the files are there ProvisoCUCM retrieves the files and generates the CSV output to cdr output dir or perfmon output dir with Perfmon data on the DataChannel host that requested the data Example resend sent files tru run interval The interval in milliseconds at which ProvisoCUCM polls the CUCM server for CDR and CMR data files and checks cdr output dir for data files pushed there by the CUCM servet Example 15 minutes cun interval 900000 Note Before proceeding to the next step be sure you have configured each cucm properties file in the directories you created in Step 6 9 CUCM environment only Start all ProvisoCUCM applications by running the startcucm sh file in each directory that you created in Step 6 ProvisoCUCM writes a log file in the same directory where its ProvisoCUCM jar file is located Monitor the log file to make sure that ProvisoCUCM is successfully communicating with the CUCM server Also verify that CSV files are being generated to the output directories cdr_output_dir and or perfmon output dir Note Be sure that all ProvisoCUCM instances are operating successfully before proceeding to th
116. s Nb Gatekeeper Call Setup Quality percent Gatekeeper CPU Utilization percent avg last 5 mn Gatekeeper Total Number of Registered EndPoints Nb Charts CPU Utilization percent 28 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Call Setup Quality Gatekeeper Availability Resource Detail Chart KPIs Gatekeeper ICMP Inbound Errors percent SNMP Unavailable percent avg last hour SNMP Availability percent avg last hour Gatekeeper ICMP Outbound Errors percent SNMP Response Time ms avg last hour SNMP Availability percent avg last hour Charts SNMP Availability percent avg last hour Outbound ICMP Errors percent Availability vs Unavailable SNMP Inbound ICMP Errors percent SNMP Response Time ms avg last hour Gatekeeper Availability Resource KPIs Gatekeeper ICMP Inbound Errors percent Gatekeeper ICMP Outbound Errors percent SNMP Availability percent avg last hour SNMP Response Time ms avg last hour SNMP Response Time ms avg last hour Charts SNMP Responce Time Distribution Chart SNMP Availability Distribution Chart Interface Gatekeeper Interface Availability Resource Detail Chart KPIs Interface Packet Loss percent Interface Availability percent Charts Availability vs Unavailable APglobal Availability percent Inbou
117. s software is copyrighted by Juergen Schoenwaelder the Technical University of Braunschweig the University of Twente and other parties The following terms apply to all files associated with the software unless explicitly disclaimed in individual files The authors hereby grant permission to use copy modify distribute and license this software and its documentation for any purpose provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions No written agreement license or royalty fee is required for any of the authorized uses Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here provided that the 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 ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE ITS DOCUMENTATION OR ANY DERIVATIVES THEREOF EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT THIS SOFTWARE IS PROVIDED ON AN AS IS BASIS AND THE AUTHORS AND IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 99
118. s 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 well as Unity servers and other Cisco media servers running under the Microsoft SQL Server 2000 environment can be configured with the following standard SNMP Extensions HOST MIB PERFMON MIB optional perfmon counters SQL MIB optional SOL Server and Database metrics EXCHANGE MIB optional MS Exchange metrics DHCP MIB optional Dhep server metrics HTTP MIB optional Http server metrics Cisco CallManager Configuration To enable CDR and CMR collection from CCM and CUCM environments some configuration parameters must be set using the CCM System Administrator Configuration settings must be defined separately on every server in a cluster The following configuration service parameters control the generation of CDR records cdrEnabled Determines whether CDR records are generated Default value false CdrLogCallsWithZeroDurationFlag Enables logging of CDR records for calls that were never connected or which lasted less than one second This parameter must be enabled to allow data to be collected on short connections CallDiagnosticsEnabled Determines whether CMR records are generated Only IP phones and MGCP gateways support CMR records Default val
119. sample application programs in source language which illustrate programming techniques on various operating platforms 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 platform 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 The sample programs are provided AS IS without warranty of any kind IBM shall not be liable for any damages arising out of your use of the sample programs If you are viewing this information in softcopy form the photographs and color illustrations might not appear Trademarks IBM the IBM logo and ibm com are trademarks or registered trademarks of International 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 Copyright and trademark information at www ibm com legal copytrade shtml UNIX is a registered trademark of The Open Group in the United States and other countries 96 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Notices Java and all Java based trademarks and
120. ser name to gain access to the server on which the technology pack is installed encrypted password specifies the password that the server administrator assigned using the f tp or sftp utility to the FTP or SFTP user The FTP or SFTP user specifies this password to gain access to the server on which the technology pack is installed The password specified here should be the encrypted passwotd hostname specifies the host name of the server on which the bulk input files are located These are the files that the UBA parses specific string refers to the string that ends an entry for the URI line Example UBA 1 1 VOIP CISCO IPT CDRINPUT URI ftp pvuser CACCDHDBCCCJHCGLGKLPRO0227 opt uba cdroemr To use the s tp command you must have an SSH client installed on the servers where the bulk input files are located and where the DataChannel is running Typically an SSH client is installed by default on most UNIX systems For more information see your operating system documentation or the sftp reference page Note that you cannot do the following Usean FTP client to connect to an SFTP server Connect to an FTP server with a client that supports only SFTP DB USERNAME Use the following guidelines to determine whether you have the correct value for the UBA channel number collector number DB USERNAME parameter in the dc cfg file IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 T
121. soft SQL Server 2000 server To collect SOL 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 Direct SQL server bridge and the SQL Server 2000 server is made through TCP port number 1433 or 1370 according to the Cisco CallManager Publisher configuration TCP IP PORT CallManager 1433 or 1370 Publisher MS SQL Server Troubleshooting Note for SOL Requests If you have problems issuing SQL queries to the Cisco CallManager CCM Publisher check the following list Ensure that tempdb has been set to an adequate size at least 100Mb in order to correctly receive the SQL result set as recommended in the Cisco CallManager Installation Guide e Check the log file proviso log by default for any SOL error messages By default the log file is in the DC_HOME log directory for example opt datachannel log 6 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 2 Devices and Services e 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 C
122. ster SEP00155832DDD5 MLQK 3 2000 MLOKav 3 3000 MLOKmn 1 4000 MLOKmx 3 9000 ICR 0 8200 CCR 0 7600 ICRmx 0 9800 CS 9 SCS 2 MLOKvr 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 T 19835742 0 0 0 6017 6017 0 0 4 0 0 0 0 0 0 0 0 0 0 0 0 0 1273883642 6001 593fa05e bcld 4dc5 9cca 6c25184e7e98 Phones 197 SEP00155832DDD6 13 0 0 0 0 0 0 StandAl oneCluster 0 0 3 0 0 1 6058 10263919 1273883642 128 313 1784 1107 11 1176 62 03d4df7b 78ff 460e a0bb 43ccee36cc5 Phones StandAloneCluster SEP00155832DDD5 MLOK 3 2000 MLQKav 3 3000 MLOKmn 1 4000 MLOKmx 3 9000 ICR 0 8200 CCR 0 7600 ICRmx 0 9800 CS 9 SCS 2 MLOKvr z This example contains both the CDR and CMR data with the CMR data concatenated to the end of the CDR line This example is taken from the output file after the Cisco IP Telephony Technology Pack has processed the two inputs and created the CSV file for the UBA Bulk adaptor design files Tivoli Netcool Proviso supports several data formats for bulk input files including CSV XML and binary Each UBA technology pack provides a Bu k Adaptor Design File to define the data format supported by that technology pack The Bulk Adaptor Design File which is a JavaScript file processes both inventory and statistics data from the same bulk input file The Bulk Adaptor Design File provides a function that creates
123. t subcommand copy the Bulk Adaptor Design Files j s scripts if any and other files if any from the DataMart server to the DataChannel servet 2 Tivoli Netcool Proviso pre v4 4 3 only Copythevoip cisco ipt sample dc cfg template file as follows Using the cd subcommand change your working directory to the SPVMHOME APFiles voip cisco ipt datachannel conf directory Using the get subcommand copy the voip cisco ipt sample dc cfg template file from the DataMart server to the DataChannel server 2 g Exit the ftp utility by entering the bye subcommand 2 h Vetify that the technology specific files are now located in the target directory as follows Tivoli Netcool Proviso v4 4 3 and later Verify that the Bulk Adaptor Design Files j s scripts if any other files if any are now located in the DATA CHANNEL HOME scripts voip cisco ipt directory Tivoli Netcool Proviso pre v4 4 3 only Verify that the Bulk Adaptor Design Files j s scripts if any other files if any and voip cisco ipt sample dc cfg template file are now located in the DATA CHANNEL HOME scripts voip cisco ipt directoty 3 Activate data collection requests During installation of the technology pack all predefined data collection requests are promoted to the database and set to inactive that is idle displays in the Active column of the Tivoli Netcool Proviso DataMart Request Editor You need to activate these predef
124. terNbPacketsReceived ClusterSuccessfulCall ClusterTotalCall ClusterNbPacketsSent ClusterUnsuccessfulCall Charts Cluster Erlang B Group KPIs Cluster Erlang Cluster Total Hours of Traffic ClusterBlocking ClusterLines ClusterErlangB Extension CDR Utilization Resource KPIs Percentage of Drop Calls percent CME Bulk VOIP Cisco Total Number of Calls Nb CME Bulk VOIP Cisco NbPacketsReceived NbPacketsLost CallDuration Percentage of Successful Calls Nb CME Bulk VOIP Cisco NbPacketsSent Charts Percentage of Successful calls Distribution Chart Drop Calls Distribution Chart CDR Quality Resource KPIs e UnsuccessfulCall 20 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls Percentage of Drop Calls percent CME Bulk VOIP Cisco SuccessfulCall Latency MOS e Jitter Percentage of Packet Lost percent CME Bulk VOIP Cisco Percentage of Successful Calls Nb CME Bulk VOIP Cisco Charts Drop Calls Distribution Chart Percentage of Successful calls Distribution Chart CDR Call Distribution Resource KPIs Local Incoming LongDistance nternational Total Number of Outgoing External Calls Nb nternal Charts Incoming vs Outgoing Calls Ratio Types of Calls Distribution Top 10 CDR Number of Calls KPIs Total Number of Outgoing External Calls Nb Total Number
125. terface Throughput In kbps Interface Throughput Out kbps PSTN Gateway E1 T1 Availability Resource KPIs Interface Availability percent Interface Packet Loss percent Charts Availability Distribution Chart PSTN Gateway E1 T1 Interface Utilization Resource KPIs Interface Throughput Out kbps Interface Bandwidth Utilization In percent PSTN Gateway DS1 Active DSO Channels Nb Interface Throughput In kbps Interface Bandwidth Utilization Out percent Charts nbound Utilization Distribution Chart Outbound Utilization Distribution Chart Device PSTN Gateway Device Quality Resource KPIs PSTN Gateway Packet Discards PSTN Gateway Active DSO Channels Nb 26 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Chapter 3 Supported Reports and KPls SNMP Response Time ms avg last hour PSTN Gateway Network Errors percent PSTN Gateway Total Packets per Second Charts Network Errors percentage Number of Active DSO Channels PSTN Gateway Availability Resource KPIs PSTN Gateway ICMP Outbound Errors percent PSTN Gateway ICMP Inbound Errors percent SNMP Response Time ms avg last hour SNMP Availability percent avg last hour Charts SNMP Responce Time Distribution Chart SNMP Availability Distribution Chart DSP Card PSTN Gateway DSP Card Resource KPIs DSP Card Resource Utilization percent DSP Card Availabil
126. they collect SNMP SNMP packs are MIB based and their configuration is relatively straightforward Bulk or UBA Bulk technology packs collect data against non SNMP devices and rely on the UBA of the Tivoli Netcool Proviso DataChannel to process the data Prior to Tivoli Netcool Proviso version 4 4 3 bulk packs could be very difficult to configure and in many cases required extensive Tivoli Netcool Proviso domain knowledge Tivoli Netcool Proviso version 4 4 3 introduces a GUI to configure Tivoli Netcool Proviso UBA technology packs on supported Tivoli Netcool Proviso platforms The Cisco IP Telephony Technology Pack is an SNMP and UBA technology pack Before you begin Before configuring the Cisco IP Telephony Technology Pack ensure that you Have the following software and documentation for your version of Tivoli Netcool Proviso Release notes for the current technology pack release IBM Tivoli Netcool Proviso Installation Guide IBM Tivoli Netcool Proviso Upgrade Guide if performing an upgrade IBM Tivoli Netcool Proviso DataMart Configuration Guide Important Refer to this guide to create an inventory profile and initiate a discovery Access to the Tivoli Netcool Proviso DataMart server IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 45 Chapter 4 Configuring the technology pack An X Window server on the DataMart server Note Tivoli Netcool Prov
127. ts 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 data Microsoft performance counter metrics Perfmon Bulk CDR and CMR data is collected in Cisco CallManager CCM environments and Cisco Unified Communications Manager CUCM environments The technology pack accesses CDR and CMR data differently in each environment The following sections provide an overview of how the technology pack accesses CDR and CMR data in these different environments A basic understanding of the different access methods will help you when you configure the technology pack Note Perfmon is not supported for Cisco CallManager version 4 x Collecting CDR and CMR Data with Cisco CallManager With Cisco CallManager CCM the technology pack collects CDR and CMR data through SQL requests to the CallManager Publisher SQL database IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 5 Chapter 2 Devices and Services The following figure illustrates the technology pack s data collection architecture in a CCM environment UBA Bulk Collector SQL CallManager Publisher Port for SOL Access CallManager Publisher runs on a Micro
128. uba perfmon csv UBA 1 98 VOIP CISCO IPT PERFMON DELETEONACQUIRE false UBA 1 98 METRIC STREAM TYPE BOF UBA 1 98 DEBUG WALKBACK ON ADAPTOR ERROR TRUE UBA 1 98 DUAL LOGGING true UBA 1 98 LOG FILTER FEWI 12345 UBA 1 98 SERVICE INSTANCE GLOBAL UBA 1 98 COLLECTOR LIST 98 UBA 1 98 DB USERNAME PV GUI UBA 1 98 DB PASSWORD AAAC UBA 1 98 INVENTORY SUBELEMENT FLUSH THRESHOLD 1 UBA 1 99 ROOT DIRECTORY opt datachannel UBA 1 99 INSTANCES VOIP CISCO IPT UBA 1 99 RUNINTERVAL 900 UBA 1 99 VOIP CISCO IPT TIMEZONE GMT UBA 1 99 VOIP CISCO IPT DESIGNFILE CUCMAdaptor js UBA 1 99 VOIP CISCO IPT CDRINPUT URI ftp user cryptedpass examplehost opt uba cdremr csv UBA 1 99 VOIP CISCO IPT CDRINPUT DELETEONACQUIRE false UBA 1 99 METRIC STREAM TYPE BOF UBA 1 99 DEBUG WALKBACK ON ADAPTOR ERROR TRUE UBA 1 99 DUAL LOGGING true UBA 1 99 LOG FILTER FEWI 12345 UBA 1 99 SERVICE INSTANCE GLOBAL UBA 1 99 COLLECTOR LIST 99 UBA 1 99 DB USERNAME PV GUI UBA 1 99 DB PASSWORD AAAC UBA 1 99 INVENTORY SUBELEMENT FLUSH THRESHOLD 1 UBA 1 101 ROOT DIRECTORY opt datachannel UBA 1 101 1NSTANCES VOIP CISCO IPT UBA 1 101 RUNINTERVAL 900 UBA 1 101 VOIP CISCO IPT TIMEZONE EST UBA 1 101 VOIP CISCO IPT DESIGNFILE CCMAdaptor js UBA 1 101 VOIP CISCO IPT CCMINPUT URI sqldb odbc threaded username sa amp password n etcool amp environment SF 92 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix B Template file Tivoli Netcool Proviso pre v4 4 3
129. ue alse MaxCdrRecords Controls the maximum number of CDRs on the system When this limit is exceeded the oldest CDRs are automatically removed once a day along with the related CMR records Default value 1 5 million records The Tivoli Netcool Proviso Cisco IP Telephony Technology Pack never deletes records IBM recommends retrieving CDRs every hour or every four hours This polling interval permits the system administrator to decrease the maximum number of CDRs on the CallManager and to improve performance IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 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 the database The value specifies either FLAT or DB Default value DB For performance reasons the Tivoli Netcool Proviso Cisco IP Telephony Technology Pack collects CDRs using SQL requests not flat files Tivoli Netcool Proviso does not support FLAT for CDR collection PrimaryCDRDSN An optional parameter that references the primary CDR server on which to ins
130. ventory and initiate a discovery An inventory collects data about the network resources that the technology pack monitors After you install an SNMP technology pack you must create an inventory profile using the Inventory Tool Wizard and then initiate a discovery by executing the inventory profile using the Inventory Tool Running the initial inventory against SNMP objects is an intricate task and unfortunately beyond the scope of this configuration chapter For instructions on using the Inventory Tool Wizard to create an inventory profile and the Inventory Tool to execute the inventory profile see the IBM Tivoli Netcoo Proviso DataMart Configuration Guide Edit pack specific UBA parameters based on the following Tivoli Netcool Proviso platforms Tivoli Netcool Proviso v4 4 3 and later Tivoli Netcool Proviso pre v4 4 3 Tivoli Netcool Proviso v4 4 3 and later In this release of Tivoli Netcool Proviso you were instructed to modify the technology pack specific UBA parameters when you installed the Cisco IP Telephony Technology Pack using the Topology Editor If you did not modify the UBA parameters with site specific values or you want to make additional edits you can do so now Otherwise you can go to the next step See the Installing Technology Packs chapter of the IBM Tivoli Netcool Proviso Installation Guide for more information Tivoli Netcool Proviso pre v4 4 3 The Cisco IP Telephony Technology Pack requires specific
131. vironment dataSourceName For example sqldb odbc threaded username sa password netcool environment SANFRANCISCO Note The URIs you specify must match the URIs of each CCM Publisher data source defined in the odbc ini file 68 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and late VOIP_CISCO_IPT CDRINPUT DELETEONACQUIRE r Description Deletes CUCM Bulk input files after acquisition Component UBA Value Default false Attribute Writable Location Advanced Properties tab Detail The CDRINPUT DELETEONACQUIRE parameter specifies whether the Bulk input files should be preserved after the UBA acquires them A related parameter CDRINPUT URI specifies the location of these Bulk input files Set this parameter to the value true to instruct this UBA application to delete the CUCM Bulk input files afte it acquires them Otherwise set this parameter to false to instruct this UBA application to preserve the Bulk input files after it acquires them f IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack 69 Appendix A UBA parameters Tivoli Netcool Proviso v4 4 3 and later VOIP_CISCO_IPT CDRINPUT URI Description CUCM Bulk input files location Component UBA Value Default No default value Attribute Read only Location Properties tab Detail The DataChannel applications t
132. ware without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED 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 IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE BLT 2 4u Portions c 1993 AT amp T c 1993 1998 Lucent Technologies c 1994 1998 Sun Microsystems Inc and c 1987 1993 The Regents of the University of California Permission to use copy modify and distribute this software and its documentation for any purpose and without fee is hereby granted provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation and that the names of AT amp T Lucent Technologies Inc Sun Microsystems Inc and The Regents of the University of California not be used in advertising or publicity pertaining to distribution of the software without specific w
133. warranties of merchantability and fitness In no event shall Lucent be liable for any special indirect or consequential damages or any damages whatsoever resulting from loss of use data or profits whether in an action of contract negligence or other tortuous action arising out of or in connection with the use or performance of this software UCD SNMP 4 2 5 Portions 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 documentation for any purpose and without fee is hereby granted provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation and that the name of CMU and The Regents of the University of California not be used in advertising or publicity pertaining to distribution of the software without specific written permission CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS IN NO EVENT SHALL CMU OR THE REGENTS OF THE UNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM THE LOSS OF USE DATA OR PROFTIS WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHE
134. y have patents or pending patent applications covering subject matter described in this document The furnishing of this document does not grant 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 character set DBCS information contact the IBM Intellectual Property Department in your country or send inquiries in writing to Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd 1623 14 Shimotsuruma Yamato shi Kanagawa 242 8502 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 PROVIDES THIS PUBLICATION 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 incorporated in new editions of the publication IBM may make improvements and or changes in the product s and or the pr

Download Pdf Manuals

Related Search

Related Contents

Bose Solo Sistema de Som TV Manual do Proprietário  AcadSuite  Lite Power 4  Plena System Pre-amplifier and Call Stations  カタログ - 121ware.com  T35800_0008_20060246_EML_IS_R1 CS4b  R 55(C) R 99(C)  Crème atelier  A Compact Intermediate Format for SIMICS  Gigaset S810H  

Copyright © All rights reserved. Failed to retrieve file