background image

Chapter 4:  Configuring the technology pack

IBM Tivoli Netcool/Proviso Cisco IP Telephony 2.4.0.0 Technology Pack

53

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 the 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.js

. In Step 2-e, you copied these files to 

DATA_CHANNEL_HOME

/scripts/voip_cisco_ipt

 (typically, 

/opt/datachannel/scripts/voip_cisco_ipt

).

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 are also sent to the 

DataChannel host that requested them.
Use the 

false

 setting in the following situations:

If you 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 needs. 

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=true

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 server.

Example (15 minutes):

 

run_interval=900000

Field

Description

Summary of Contents for CISCO R2E2

Page 1: ...IBM Netcool Proviso Tivoli Document Revision R2E2 Cisco IP Telephony 2 4 0 0 Technology Pack User Guide ...

Page 2: ...formation and the product it supports read the information in Notices on page 95 Copyright IBM Corp 2010 US Government Users Restricted Rights Use duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp ...

Page 3: ...nager 5 Collecting CDR CMR and Perfmon Data with Cisco Unified Communications Manager 7 Prerequisites 8 SNMP Access 8 Cisco CallManager Configuration 8 Supported MIBs 9 Bulk input file formats 9 Bulk input file name 10 Bulk input file schema 10 Bulk adaptor design files 11 Chapter 3 Supported Reports and KPIs 13 Overview 13 Reporter sets 13 Reporter set tree 15 Reporter set contents 16 Key perform...

Page 4: ...T INPUT_FTP_USERNAME 76 VOIP_CISCO_IPT INPUT_HOST 77 VOIP_CISCO_IPT INPUT_HOST 78 VOIP_CISCO_IPT INPUT_USE_SECURE_FTP 79 VOIP_CISCO_IPT INPUT_USE_SECURE_FTP 80 VOIP_CISCO_IPT_PERFMON DESIGNFILE 81 VOIP_CISCO_IPT_PERFMON INPUT_DIRECTORY 82 VOIP_CISCO_IPT_PERFMON INPUT_FTP_PASSWORD 83 VOIP_CISCO_IPT_PERFMON INPUT_FTP_USERNAME 84 VOIP_CISCO_IPT_PERFMON INPUT_HOST 85 VOIP_CISCO_IPT_PERFMON INPUT_USE_S...

Page 5: ...k you should have a working knowledge of the following subjects Tivoli Netcool Proviso DataMart TCP IP networks Telecommunications network management Administration of the operating system The audiences should also be familiar with the specific technology that the Cisco IP Telephony Technology Pack deals with in this case Cisco IP Telephony Organization This guide is organized as follows Chapter 1...

Page 6: ...aChannel 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 P...

Page 7: ...co 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...

Page 8: ...Cisco 2600 3600 series E1 T1 Serial Links DS0 Channel availability and utilization DSP availability and utilization capacity planning bandwidth errors Also total number of calls per gateway total duration 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 tota...

Page 9: ...f 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 ...

Page 10: ...sco 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 Troubleshooting Note for SQL Requests If you have problems issuing SQL queries to the Cisco CallManager CCM Publisher check the following list Ensure that tempdb has been set ...

Page 11: ...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 pu...

Page 12: ... 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 ...

Page 13: ...erver 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 use...

Page 14: ...ecifies 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_201005150835_10001 csv Bulk input file schema For Cisco CallManager version 4 x CDR data is stored in a Microsoft SQL Ser...

Page 15: ...CS 2 MLQKvr 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 bina...

Page 16: ...Chapter 2 Devices and Services 12 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack NOTES ...

Page 17: ...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 Netcool Proviso DataView User s Guide This Technology Pack User Guide assumes an understanding of the report ...

Page 18: ...User s Guide for more information about reporter sets and the Reporter Set Wizard Table 1 Reporter set summary Reporter set Dashboard Group Resource Detail Threshold CallManager Server 0 1 2 0 0 Cluster 1 4 5 0 0 Codec 0 0 1 0 0 DSP Card 0 0 1 0 0 Device 0 0 2 0 0 Device 2 0 2 0 0 Extension 0 3 4 0 0 Global Customer Reports 0 0 1 0 0 Interface 0 0 2 0 0 Interface 2 0 2 0 0 K Factor 0 1 1 0 0 Media...

Page 19: ...hony 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 ...

Page 20: ...IP 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 ...

Page 21: ...Call Clearing ClusterDropCall ClusterSuccessfulCall ClusterUnsuccessfulCall 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 ClusterInternationalCall ClusterLocalCall Cluster Total Number of External Calls Nb ClusterInternalCall ClusterIncomingCall Charts Typ...

Page 22: ...cent 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 perce...

Page 23: ... percent ClusterShortCall Cluster Percentage of Packet Lost percent Cluster Percentage of Drop Calls percent Cluster VoiceMail Usage Resource KPIs ClusterVoicemailPackets ClusterForwardToVoiceMail ClusterVoicemailCallDuration ClusterVoiceMailCall Cluster Number of Direct VoiceMail Calls Nb Charts Direct vs Forward Calls ratio Cluster IP vs Legacy Resource KPIs ClusterTollBypassCall Cluster Total N...

Page 24: ...cketsSent 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 NbPa...

Page 25: ...alls Distribution Chart CDR Call Distribution Resource KPIs Local Incoming LongDistance International Total Number of Outgoing External Calls Nb Internal 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 of Calls Nb CME Bulk VOIP Cisco TollBypassCall Incoming Top 10 CDR Number of Errors KPIs P...

Page 26: ...entage 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 Utilizat...

Page 27: ...ibution Chart TollBypass Calls Distribution Chart CDR Call Distribution Group KPIs Local Incoming LongDistance International Total Number of Outgoing External Calls Nb Internal Charts Incoming vs Outgoing Calls Ratio Types of Calls Distribution K Factor K Factor Resource KPIs MLQKmx MLQKmn MLQK MLQKav ICRmx ICR SCS CS CCR K Factor Group KPIs MLQKmn MLQK MLQKav ICRmx ICR ...

Page 28: ...KPIs CauseTemporaryFailure CauseNetworkOutOfOrder CauseChannelUnacceptable CauseUserBusy CauseDestinationOutOfOrder CauseNoRouteTransitNetwork CauseUnassignedNumber CauseNumberChanged CauseNoChannelAvailable CauseMisdialedTrunkPrefix CauseNoRouteToDestination CauseInvalidNumberFormat CauseNoAnswerFromUser CauseOther CauseNoUserResponding CauseResourceUnavailable CauseCallRejected CauseSubscriberAb...

Page 29: ...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 SQ...

Page 30: ... Interface Throughput Out kbps PSTN Gateway E1 T1Availability 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 DS0 Channels Nb Interface Throughput In kbps Interface Bandwidth Utiliza...

Page 31: ...teway 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 Availability percent Charts AP global Availability DSP Card Utilization Media Devices Media Device Resource KPIs CCM...

Page 32: ...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 Quali...

Page 33: ...d 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 Av...

Page 34: ... Charts Inbound vs Outbound Utilization avg AP global Outbound_Utilization_ percent Inbound vs Outbound Throughput avg AP global 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 ...

Page 35: ...fmon Security Group KPIs EncryptedCallsActive AuthenticatedPartiallyRegisteredPhone AuthenticatedCallsActive CallsActive AuthenticatedRegisteredPhones EncryptedRegisteredPhones EncryptedPartiallyRegisteredPhones AttendantConsoleClientsRegistered AttendantConsoleClientsOnline Perfmon Security Resource KPIs EncryptedCallsActive AuthenticatedPartiallyRegisteredPhone AuthenticatedCallsActive CallsActi...

Page 36: ...nsInService T1ChannelsActive FXSPortsInService FXOPortsActive BRIChannelsActive FXSPortsActive FXOPortsInService BRISpansInService Perfmon MOH Resource KPIs MOHUnicastResourceActive MOHTotalUnicastResources MOHUnicastResourceAvailable MOHMulticastResourceActive MOHTotalMulticastResources MOHMulticastResourceAvailable Perfmon MOH Group KPIs MOHUnicastResourceActive MOHTotalUnicastResources MOHUnica...

Page 37: ...now 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 G...

Page 38: ...ailed 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 ...

Page 39: ...PBX Calls A Legacy PBX Call is defined as An intrasite 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 Nor...

Page 40: ...e 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...

Page 41: ...ubjective 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 poor 3 fair 4 good 5 excellent The MOS is the arithmetic mean of al...

Page 42: ... 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 ClusterVoiceMailCall Identifies a call where the final...

Page 43: ...on Requests Nb Total number of gatekeeper admission requests Gatekeeper Total Number of Concurrent Calls Nb Gauge 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 ...

Page 44: ...l 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 pho...

Page 45: ... 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 Outb...

Page 46: ...vailable 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 Intersit...

Page 47: ...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 Concealment lasting longer than fifty milliseconds or five percent of the voice tr...

Page 48: ...lls 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 C...

Page 49: ...s 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 followin...

Page 50: ...ound 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 colle...

Page 51: ...ftp utility in text mode log into the DataMart server using the appropriate user name and password pvuser and PV by default 2 d Using the cd subcommand change your working directory to the PVMHOME APFiles voip_cisco_ipt datachannel scripts voip_cisco_ipt directory 2 e Using the get subcommand copy the Bulk Adaptor Design Files js scripts if any and other files if any from the DataMart server to th...

Page 52: ...Mart server PVMHOME APFiles voip_cisco_ipt datamart conf You must merge the contents of this file with the file inventory_subelements txt located in PVMHOME 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 c...

Page 53: ...urceN DataDirect 4 20 SQL Server Wire Protocol Your_Data_Source1 Driver PVmsss20 so Description DataDirect 4 20 SQL Server Wire Protocol Address xx xx xx xx 1433 AnsiNPW Yes Database CDR QuoteId No Your_Data_Source2 Driver PVmsss20 so Description DataDirect 4 20 SQL Server Wire Protocol Address xx xx xx xx 1370 AnsiNPW Yes Database CDR QuoteId No Your_Data_SourceN Driver PVmsss20 so Description Da...

Page 54: ...nvironment 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 ...

Page 55: ...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 ...

Page 56: ...1232470820931 perfmon hostN hostname The name of one of the multiple hosts on which Perfmon data is collected Example host1 perfmon host1 hostname host1 example zz Example host2 perfmon host2 hostname host2 example zz perfmon hostN pass The password to access one of the multiple hosts on which Perfmon data is collected Example host1 perfmon host1 pass pass Example host2 perfmon host2 pass pass per...

Page 57: ...e 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 are also sent to the DataChannel host that requested them Use the false setting in the following situations If you prefer to have the data files...

Page 58: ...he global variables to define Variable Description CUSTOMERNAME String specifying the customer s identifier This value allows automatic grouping and report navigation by customer 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 p...

Page 59: ... The values allow automatic grouping report navigation by site and path subelement definition Example site addExtensionRange 1000 1830 addVoiceMailRange int 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 ext...

Page 60: ...n Tivoli Netcool Proviso pre v4 4 3 The Cisco IP Telephony Technology Pack requires specific UBA parameters that are not in the dc cfg file The DataChannel installer creates a dc cfg file in the DATA_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 ...

Page 61: ...d the DataChannel environment In subsequent steps you will execute dccmd commands To ensure that you can run these commands load 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 th...

Page 62: ...tifies some events to watch for during the syntax check Variable Meaning DATA_CHANNEL_HOME Is opt datachannel by default channel Specifies the channel number for example 1 you specified when configuring this DataChannel collector Specifies the collector number for example 100 you specified when configuring this UBA Bulk Collector The trailing dash after collector Removes extraneous log messages fr...

Page 63: ...ects 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 source input location by issuing a tail command simi...

Page 64: ...en an informational message similar to this one displays in the log file Success occurs when int records equals 0 METRIC_STREAM_INFO Completed writing metric output DATA_CHANNEL_HOME UBA channel collector streaming state temp output time instance NRAW BOF wrote int metrics int bad resource IDs int bad formula names Specifies a metric creation success message The UBA application successfully create...

Page 65: ...is task on a regular basis is to create a cron entry that makes use of the inventory CLI command The following example shows a cron entry that periodically performs the grouping operation for a bulk inventory profile called bulk_100 0 opt datamart dataMart env inventory name bulk_100 action pregrouping reload noX 0 opt datamart dataMart env inventory name bulk_100 action grouping reload noX See th...

Page 66: ... 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 0 opt datamart dataMart env inventory noX reportGrouping See the ÌBM Tivoli Netcool Proviso Command Line Interface Guide for more information about the inventory command Verifying r...

Page 67: ...e 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 thi...

Page 68: ...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 CU...

Page 69: ...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 m...

Page 70: ...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 m...

Page 71: ...tion 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 t...

Page 72: ...s 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 usernam...

Page 73: ...ion 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 after it acquires them Otherwise set this parameter...

Page 74: ...nel 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 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 CDR...

Page 75: ...Value Default CUCMAdaptor 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 CUCMA...

Page 76: ...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 CUCMAd...

Page 77: ...MPLE 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 di...

Page 78: ...ation 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 op...

Page 79: ...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 g...

Page 80: ...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 g...

Page 81: ...ck 77 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 ...

Page 82: ... Pack 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 ...

Page 83: ...ansfer 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 ope...

Page 84: ...ansfer 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 ope...

Page 85: ...omponent UBA Value Default CUCMPerfmonAdaptor 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 ...

Page 86: ... 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 ...

Page 87: ...CM 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 sa...

Page 88: ...CM 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 sa...

Page 89: ...CO_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 ...

Page 90: ...le 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 you...

Page 91: ...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 thi...

Page 92: ... 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 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 param...

Page 93: ...emplate file provides the following pack specific UBA parameters UBA channel_number collector_number1 INSTANCES instance UBA channel_number collector_number1 instance TIMEZONE GMT UBA channel_number collector_number1 instance DESIGNFILE CCMAdaptor js UBA channel_number collector_number1 instance CCMINPUT URI input_files_location1 UBA channel_number collector_number1 instance CCMINPUT DELETEONACQUI...

Page 94: ...u might associate this group alias with the location for example BOSTON LOWELL BERLIN PARIS and so forth of the data source UBA Parameter Value Meaning channel_number Replace with the channel number that was configured for this technology pack This channel number appears in the dc cfg file collector_number Replace with the UBA Bulk Collector number that was configured for this technology pack This...

Page 95: ...me full path to directory specific_string where username 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 user 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 ftp or sftp utilit...

Page 96: ...sv 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...

Page 97: ...P_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 ...

Page 98: ...Appendix B Template file Tivoli Netcool Proviso pre v4 4 3 only 94 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack NOTES ...

Page 99: ...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 ...

Page 100: ...tion 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 t...

Page 101: ...ht be trademarks of IBM or other companies Copyright IBM Corp 2010 US Government Users Restricted Rights Use duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp Java and all Java based trademarks and logos are trademarks of Sun Microsystems Inc in the United States other countries or both ...

Page 102: ...Notices 98 IBM Tivoli Netcool Proviso Cisco IP Telephony 2 4 0 0 Technology Pack ...

Page 103: ...rnment 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 701...

Page 104: ...ATA OR PROFITS 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 Networks Associates Technology Inc copyright notice BSD Copyright 2001 Networks Associates Technology Inc All rights reserved Redistribution and use in source and binary forms with or without modification are permitted provided that...

Page 105: ...ty pertaining to distribution of the software without specific written 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 RESULTIN...

Page 106: ...ution of the software without specific written prior permission Lucent disclaims all warranties with regard to this software including all implied 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 tort...

Page 107: ...sion please contact request_AT_jdom_DOT_org 4 Products derived from this software may not be called JDOM nor may JDOM appear in their name without prior written permission from the JDOM Project Management request_AT_jdom_DOT_org 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 ...

Page 108: ...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 ab...

Page 109: ......

Page 110: ...IBM ...

Reviews: