English dropdown-ico

IBM R2E2 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of IBM R2E2, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of IBM R2E2 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of IBM R2E2. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of IBM R2E2 should contain:
- informations concerning technical data of IBM R2E2
- name of the manufacturer and a year of construction of the IBM R2E2 item
- rules of operation, control and maintenance of the IBM R2E2 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of IBM R2E2 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of IBM R2E2, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the IBM service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of IBM R2E2.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the IBM R2E2 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    IBM Netcool/Proviso Tivoli Document Revision R2E2 Cisco IP T elephony 2.4.0.0 T echnology Pack User Guide[...]

  • Page 2

    Note Before using this informat ion and the product it supports, read the information in Notices on page 95. © Copyright IBM Corp. 2010 US Government Users Rest ricted Rights - Use, duplic ation or di sclosure restricted by GSA ADP Schedule Con tract with IBM Corp.[...]

  • Page 3

    IBM Tivoli Netcool/P roviso Cisco IP T e lephony 2.4.0.0 T echnology Pack iii Co n t e n t s Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 4

    Contents iv IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Appendix A: UBA parame ters (Tiv oli Netcool/Pro viso v4.4.3 and later) . . . . . . . . . . . . . . .63 Over view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 INS[...]

  • Page 5

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 1 Chapter 1: In troduction This manual describes the IBM® Tivoli® Netcool®/Pro viso® Cisc o IP T e lephony T echnolog y P ack. Specifically , the manual describes the repor ts that display information abou t the devices and technologies that operate in the Cisco IP T elepho[...]

  • Page 6

    Chapter 1: Introduction 2 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack • Appendix B, Template file (Tivoli Netcool/Proviso pr e-v4.4.3 onl y) Explains the edits that must be made to the pack-speci fic UB A parameters delivered in the pack template file . The Tivoli Net cool/Pr oviso product suite Tiv oli Netcool/Provis[...]

  • Page 7

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 3 Chapter 2: Devices and Ser vices This chapter discusses the following topics: Over view This chapter provides a summar y of Cisco IP T ele phony device technolog y that the Cisco IP T elephony T echnology P ack is designed to suppor t. No t e : This technolog y pa ck supports[...]

  • Page 8

    Chapter 2: Devices and Ser vices 4 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack Cat egories of Ser vice Repor ting The technolog y pack provides the follo wi ng categ ories of ser vice repor ting: •V oice Quality Management — Latency , jitter, pac ket loss , netw ork bandwidth, Class-Based QoS , and element availabil[...]

  • Page 9

    Chapter 2: Devices and Ser vices IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 5 Sources of Collected Data The Tivoli Netcool/Proviso Cisco IP T ele phony T echnolog y P ack uses both SN MP and bulk data collection. The technology pack collects perfor mance data from the following sources: CDR and CMR data is collected in [...]

  • Page 10

    Chapter 2: Devices and Ser vices 6 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack The following figure illustrates the technolog y pack’ s data collection architecture in a CCM environment: P or t for SQL A ccess CallManager Publisher r uns on a Micr osoft SQL Ser ver 2000 server . T o colle ct SQL data from the CallMana[...]

  • Page 11

    Chapter 2: Devices and Ser vices IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 7 • With pre-4.4.3 Tiv oli Netcool/Provi so versions , ensure that the dc.cfg file contains a URI for each CCM Publisher bulk adaptor , and that the URI matc hes the URI of the associated data source in the odbc.ini file. Collecting CDR, CMR, [...]

  • Page 12

    Chapter 2: Devices and Ser vices 8 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack P rerequisites This section describes the prerequisites for the Tivoli Netcool/Pro viso Cisco IP T elephony T echnolog y P ack. SNMP Access The Tivoli Netcool/Pro viso Cisco IP T elephony T echnolog y Pac k needs read access to SNMP ag ents o[...]

  • Page 13

    Chapter 2: Devices and Ser vices IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 9 In addition, the following enter prise parameters must be set: • LocalCDRP ath — A directory for local CDR files wri tten by Ci sco CallManager . If this value is empty or inv alid, the CDR files will not be mov ed. • Primar yCDRUNCP ath[...]

  • Page 14

    Chapter 2: Devices and Ser vices 10 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack The Cisco IP T ele phony T echnolog y P ack pro v ides a f ile that interprets thes e bulk input files. See Bulk adap tor design files on page 11 for more infor mation. Bulk input file name Cisco IP T elephony devices pr oduce Comma-Separated[...]

  • Page 15

    Chapter 2: Devices and Ser vices IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 11 neCluster",0,"","",0,"",3,0,0,1,"607 6",5362499,1273883641,541,2954,487,2849,6,96 ,144,"03d4df7b-78ff-460e-a0bb- 43ccee36cc5f","Phones","StandAloneCl uster","SEP0[...]

  • Page 16

    Chapter 2: Devices and Ser vices 12 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack NO TES[...]

  • Page 17

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 13 Chapter 3: Suppor ted Repor ts and KPIs This chapter discusses the following topics: Over view The Cisco IP T elephony T echnolog y Pac k supplies a set of repor ts to display information about the devices and activity associated with the Cisco IP T elephony environment. The[...]

  • Page 18

    Chapter 3: Supported Repor ts and KPIs 14 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack T able 1 shows a summary of the repor ts in each repor ter set provided b y the Cisco IP T e lephony T echnolog y Pa c k . See the Netcool/Proviso DataView User’ s Guide for more infor mation about reporter sets and the Reporter Set W[...]

  • Page 19

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 15 Repor ter set tree The Cisco IP T elephony T echnology Pack provides the follow ing repor ter sets, which are listed as they appear in the DataView Navig ator tree str uc ture: AP Cisco VOIP Pack Global Customer Reports Call Detail Recor[...]

  • Page 20

    Chapter 3: Supported Repor ts and KPIs 16 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Repor ter set contents This section describes the contents of the repor ter sets provided in the Cisco IP T ele phony T echnolog y P ack, including the key perfor mance indicators (KPIs) for each re port. No t e : If any fields are omit[...]

  • Page 21

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 17 • Cluster T otal Hours of T raffic • ClusterNbP acketsSent • ClusterT otalCall Char ts • T ollBypass vs Nor mal Ougoing PSTN Calls • Company vs External Calls Cluster Quality Resource KPIs • ClusterNbP acketsLost • MLQK •[...]

  • Page 22

    Chapter 3: Supported Repor ts and KPIs 18 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack • ClusterInternationalCall • ClusterLocalCall • ClusterInternalCall • ClusterIncomingCall Char ts • Incoming vs Outg oing Calls Ratio • T ypes of Calls Distribution T op 10 Cluster Call C ompletion KPIs • Cluster P ercenta[...]

  • Page 23

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 19 Char ts • T ollBypass Calls Distribution Chart • Comapny Calls P ercent Distribution Char t T op 10 Cluster Number of Calls KPIs • ClusterT otalCall • ClusterOnNetCall • ClusterIncomingCall • Cluster T otal Number of Outg oin[...]

  • Page 24

    Chapter 3: Supported Repor ts and KPIs 20 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Cluster Utilization MLH Resource KPIs • ClusterT ollBypassCall • ClusterNbP acketsLost • Cluster T otal Number of Company Calls (Nb) • Cluster T otal Hours of T raffic • ClusterNbP acketsR eceiv ed • ClusterSuccessfulCall ?[...]

  • Page 25

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 21 • P ercentag e of Drop Calls (percent) CME(Bulk) V OIP Cisco • SuccessfulCall • Latency • MOS • Jitter • P ercentag e of Pac ket Lost (percent) CME(Bulk) VOIP Cisco • P ercentag e of Successful Calls (Nb) CME(Bulk) V OIP Ci[...]

  • Page 26

    Chapter 3: Supported Repor ts and KPIs 22 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack CDR V oiceMail Usage Resource KPIs • V oicemailP ack ets • V oicemailCallDuration • V oiceMailCall • T otal Number of V oiceMail Dire ct Calls (Nb) CME(Bulk) VOIP Cisco • F orwardT oV oiceMail Char ts • Direct vs Forward Cal[...]

  • Page 27

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 23 • CallDuration • NbPac ketsSent Char ts • Company Calls P ercent Distribution Chart • T ollBypass Calls Distribution Chart CDR Call Distribution Group KPIs • Local • Incoming • LongDistance • Inter national • T otal Num[...]

  • Page 28

    Chapter 3: Supported Repor ts and KPIs 24 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack • SCS • CS • CCR Char ts • Mean Opinion Score T op 10 CDR K-F ac tor KPIs • CCR • ICR • CS • SCS • MLQK Codec Errors on Cluster by C odec KPIs • CauseT emporar yFailure • CauseNetworkOutOfOrder • CauseChannelUnac[...]

  • Page 29

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 25 Infrastructure Call Ma nag er S er ver C CM S er ver Quality Resource KPIs • CCM R ejected Devices (Nb) (Ga uge) • CCM Physical Memory Utilization (percent) • CCM R egistered Devices (Nb) (Gauge) • CCM CPU Utilization (percent) ([...]

  • Page 30

    Chapter 3: Supported Repor ts and KPIs 26 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Char ts • CPU Utilization Distribution Char t • SQL Ser ver Number of Locks Distribution Chart PSTN Gateway Interf ace T op 10 E1/T1 Utilization Resource KPIs • PSTN Gatew ay DS1 Acti ve DS0 Cha nnels (Nb) • Interface Bandwidth [...]

  • Page 31

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 27 • SNMP R esponse Time (ms) (avg last hour) • PSTN Gateway Netw or k Er rors (percent) • PSTN Gatewa y T otal Pa ck ets per Second Char ts • Netw ork Errors percentag e • Number of Acti ve DS0 Channels PSTN Gateway A vailability[...]

  • Page 32

    Chapter 3: Supported Repor ts and KPIs 28 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Char ts • Media Device R egist ration Distribution Char t Gatekeeper Device Gatekeeper Device Qual ity Resource Detail Char t KPIs • Gatekeeper T otal Number of Concur rent Calls (Nb) (Gauge) • Gatek e eper P acket Errors (Nb) •[...]

  • Page 33

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 29 • Call Setup Quality Gatekeeper A vailability Resourc e Detail Char t KPIs • Gatekeeper ICMP I nbound Errors (percent) • SNMP Unav ailable (percent) (avg last hour) • SNMP A vailability (p ercent) (avg last hour) • Gatekeeper I[...]

  • Page 34

    Chapter 3: Supported Repor ts and KPIs 30 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Gatekeeper Interface A vailability Resource KPIs • Interface A vailability (percent) • Inbound Loss (percent) • Outbound Loss (percent) Gatekeeper Inter face Utilizat ion Resource Detail Char t KPIs • Interface Bandwidth Utiliza[...]

  • Page 35

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 31 • GatewayCallsA ctiv e • SIPCallsActiv e • H323CallsActiv e P er fmon Active Calls Group KPIs • CallsActiv e • CallsInProg ress • HuntlistCallsInProg ress • HuntlistCallsActiv e • SIPCallsInProg ress • H323CallsInProg r[...]

  • Page 36

    Chapter 3: Supported Repor ts and KPIs 32 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack P er fmon PSTN Resource KPIs • T1SpansInSer vice • T1ChannelsActiv e • FXSP or tsInSer vice • FX OP or tsActive • BRIChannelsActiv e • FXSP or tsActiv e • FX OP or tsInSer vice • BRISpansInSer vice P er fmon PSTN Group K[...]

  • Page 37

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 33 Key per formance indicators T able 2 lists all of the key perfor mance indicators (K PIs) supported by the Cisco IP T elephony T echnology Pac k. T able 2: K e y perf ormance indicators KPI Comment AttendantConsole ClientsOnli ne T otal [...]

  • Page 38

    Chapter 3: Supported Repor ts and KPIs 34 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack CCM SQL Ser ver number of locks blocking processes T otal number of locks blocking other processes. CCM SQL Ser ver number of pending rw T otal number of reads and writes pending CCR Cumulativ e conceal rat io . Cumulative concealment r[...]

  • Page 39

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 35 Cluster Percentage of Company Calls (percent) Ratio between C ompany calls and T ot al number of Calls Cluster P ercentage of Drop Calls (percent) Ratio betw een DropCalls and T o tal num ber of Calls Cluster P ercentage of Nor m al Call[...]

  • Page 40

    Chapter 3: Supported Repor ts and KPIs 36 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack ClusterIncomingCal l Identifies a call where caller is not an internal extension. An Incomin g call is also: - An Inbound call - An Off-net cal l, coming from the PSTN ClusterInter nalCall An Inter nal Call is a call bet ween 2 inter na[...]

  • Page 41

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 37 ClusterLocalCall Identifi es a call where th e call er is an internal extension and where the calle e is a Local Exter nal PSTN number , according to the Numbe ring Plan (NANP or Other pref ixes). A Local call is also:- An Outbound c all[...]

  • Page 42

    Chapter 3: Supported Repor ts and KPIs 38 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack ClusterShortCall Iden tifies a call succes sfully es tablished, 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 [...]

  • Page 43

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 39 F orwardT oV oiceMail Identifies a call forwarded to another dest ination by the origin al callee. In this case, the destination is one of the V oiceMail extension number, defined in the V oiceMailExten sionRange variable f rom the UBA.x[...]

  • Page 44

    Chapter 3: Supported Repor ts and KPIs 40 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Inbound Los s (percent) Out of all inbound traffic received by this entity , the percent age of PDUs that: (a) containe d defects which prevented them from being deliverable to a higher-layer protocol (bad checksums, bad length, etc.), [...]

  • Page 45

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 41 Latency Designates value that is an esti mate of the netw ork latency , expressed in milliseconds. This value rep resents the average value of the difference between the NTP timestamp i ndicated by the RTP Cont rol Protocol (RTCP) messag[...]

  • Page 46

    Chapter 3: Supported Repor ts and KPIs 42 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack MOS Mean Opinion Score. This is an high level metric. Note: There is n o algorith m for Mean Opinion Score calculations. This is a subjectiv e metric from the end user point of vie w . In voice communications, particu larly Internet tel[...]

  • Page 47

    Chapter 3: Supported Reports and KPIs IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 43 PSTN Gatewa y ICMP Inbound Er rors (percent) Percentag e of inbou nd ICMP er rors PSTN Gatewa y ICMP Outbou nd Er rors (percent) Percentage of outbound SNMP er rors PSTN Gateway Network Errors (percen t) P ercentag e of network er rors o[...]

  • Page 48

    Chapter 3: Supported Repor ts and KPIs 44 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack T1Channels Activ e T otal number of T1 c hannels currently in use in the target device T1SpansInSer vice T o tal number of T1 spans available in the targ et device T o llBypassCall Identifies a call whe re the call er is an inter nal e [...]

  • Page 49

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 45 Chapter 4: C onfigur ing the technology pack This chapter explains how to configure the Cisco IP T ele phony T echnolog y Pack and consists of the following topics: Over view Tiv oli Netcool/Proviso supports the following tw o types of technolog y packs, based on the type of[...]

  • Page 50

    Chapter 4: Configuring the technology pack 46 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack — An X Window server on the DataMart ser ver . No t e : ( T ivoli Netcool/Proviso pre-v4.4.3 ) If there is no graphics card on the DataMart ser ver, you can install the Xvfb virtual fra me buf f er package to provide X W indow ser[...]

  • Page 51

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 47 1-c . Load the shell with the DataMart environment, b y sourcing the dataMart.env file, as follows: . /opt/datamart/dataMart.env No t e : After you load the DataMart environment into th e shell, the PVMHOME v ariabl e is set to the [...]

  • Page 52

    Chapter 4: Configuring the technology pack 48 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 3-a. Change your working director y to $PVMHOME/bin ( /opt/datamart/bin , by default) on the DataMart ser ver . 3-b . Inv oke the DataMart GUI by entering the following command and pressing Enter : pvm 3-c . Click the Configuration [...]

  • Page 53

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 49 5. CCM environment only: Configure the Data Dir ect SQL Ser ver Bridge The Tivoli Netcool/Pro viso Cisco IP T elephony T echnol og y P ack collects data fr om SNMP devices and, through SQL for Call Detail Reco rds , from eac h CCM d[...]

  • Page 54

    Chapter 4: Configuring the technology pack 50 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Imp o r t a n t : I f you do not have a CUCM environment, skip Ste p 6 through St e p 9 , and continue with St ep 10 . 6. CUCM environment only: On the DataChannel host, crea te a dire ctor y for each CUCM ser ver from which CDR, CM[...]

  • Page 55

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 51 collect_cdr If true , ProvisoCUCM r equests CDR and CMR data fr om the CUCM ser ver . If false , ProvisoCUCM will not poll the CUCM ser ver for CDR and CMR data. Example : collect_cdr=true collect_perfmon If true , ProvisoCUCM reque[...]

  • Page 56

    Chapter 4: Configuring the technology pack 52 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack ftp.user User ID requir ed for login to the DataChannel host that issued the SO AP request. Example : ftp.user=provisouser grace_period The time, in milliseconds , to subtract from the polling star t time. The polling start time is [...]

  • Page 57

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 53 No t e : Before pr oceeding to the next ste p , be sure you have configur ed each cucm.pr oper t ies file in the dir ectories you cr ea te d in Step 6. 9. CUCM envi ronment only: Star t all ProvisoCUCM appl ications by r unning the [...]

  • Page 58

    Chapter 4: Configuring the technology pack 54 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack These configurati on files contain sample values . Edit ei ther or both files to assi gn values appropriate for locations in your Cisco I P T elephony CCM or CUCM en vironment. The following table describes the global variables to d[...]

  • Page 59

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 55 site A v ariable assigned to the J avaScr ipt object Site . A Site object d efines a set of properties specific for a site, busi ness department, location , remote offic e, or group of people. Y ou can define multiple Site objects .[...]

  • Page 60

    Chapter 4: Configuring the technology pack 56 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 11. R un the initial SNMP inventory and initiate a discovery. An inv entor y collects data about the network resources that the technolog y pack monitors . After you install an SNMP technology pack, you must cr eate an inv entor y p[...]

  • Page 61

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 57 12-f. Open a second ter minal emulator . 12-g . On the DataChannel ser ver, c hang e your w orking directory to the D ATA_CHANNEL_HOME /conf director y ( /opt/datachannel/conf , b y default), by entering the following command: cd D [...]

  • Page 62

    Chapter 4: Configuring the technology pack 58 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 14-f. Use the following commands to rest art each DataChanne l visual process: cnsw logw amgrw cmgrw 14-g . Use the dccmd command to start all DataChannel applications: dccmd -action start all 14-h. Use the dccmd command to v erify [...]

  • Page 63

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 59 15. Ensure that the bulk input files can be read. T o verify that the UB A application can read the bulk input files, follow these steps: 15-a. Place a bulk input file at the s ource input l ocation. — (Tiv oli Netcool/Prov iso v4[...]

  • Page 64

    Chapter 4: Configuring the technology pack 60 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 16. R un the bulk inventory profile. The UBA application handles the inv entor y and metric s according to the instructions provided in the technology pack design file or files . T he UB A applic ation inser ts the created el ements[...]

  • Page 65

    Chapter 4: Configuring the technology pack IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 61 where: Y ou must use the Inv entory T ool to run a bulk inventory profile . T o r un the bulk inventory profile for this technology pack, perfor m the following steps: 16-a. In the command window where you loaded the DataMar t envir[...]

  • Page 66

    Chapter 4: Configuring the technology pack 62 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 17-f. Click Close to exit the message box, or click Details to view a description of any er rors . 17-g . Optional: Y ou can also deploy repor ts on a regular ba si s by creating a cron e n tr y that makes use of the inventory CLI c[...]

  • Page 67

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 63 Appendix A: UBA parameters ( Tivoli Netc ool/P roviso v4.4.3 and lat er) This appendix provides UNIX refere nce pages for each of the pac k-speci fic UB A parameters supplied with the XSD file for the Cisco IP T ele phony T echnolog y Pac k. T he de scriptions are the same a[...]

  • Page 68

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 64 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack INST ANCES Description Group alias . Component UB A Va l u e Default: VOIP_CISCO_IPT_PERFMON Attribute: Read-o nly Location: Advanced Properties tab Detail The DataChannel suppor ts multiple instances [...]

  • Page 69

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 65 INST ANCES Description Group alias . Component UB A Va l u e Default: VOIP_CISCO_IPT Attribute: Read-only Location: Advanced Properties tab Detail The DataChannel suppor ts multiple instances of tec hnolo[...]

  • Page 70

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 66 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack INST ANCES Description Group alias . Component UB A Va l u e Default: VOIP_CISCO_IPT Attribute: Read-o nly Location: Advanced Properties tab Detail The DataChannel suppor ts multiple instances of tec h[...]

  • Page 71

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 67 VOIP_CISC O_IPT .CCMINPUT .DELETEONAC QUIRE Description Deletes CCM Bulk input files after acquisition. Component UB A Va l u e Default: false Attribute: Writable Location: Advanced Properties tab Detail [...]

  • Page 72

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 68 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISC O_IPT .CCMINPUT .URI Description CCM Bulk input files location. Component UB A Va l u e Default: No default value Attribute: Read-o nly Location: Properties tab Detail The DataChannel applica[...]

  • Page 73

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 69 VOIP_CISC O_IPT .CDRINPUT .DELETEONA C QUIRE Description Deletes CUCM Bulk input files after acquisition. Component UB A Va l u e Default: false Attribute: Writable Location: Advanced Properties tab Detai[...]

  • Page 74

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 70 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISC O_IPT .CDRINPUT .URI Description CUCM Bulk input files location. Component UB A Va l u e Default: No default value Attribute: Read-o nly Location: Properties tab Detail The DataChannel applic[...]

  • Page 75

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 71 VOIP_CISC O_IPT .DESIGNFILE Description J avaScript file t hat controls UB A for CCM or CUCM metrics . Component UB A Va l u e Default: CUCMAdaptor.js Attribute: Read-only Location: Properties tab Detail [...]

  • Page 76

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 72 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISC O_IPT .DESIGNFILE Description J avaScript file t hat controls UB A for CCM or CUCM metrics . Component UB A Va l u e Default: CCMAdaptor.js Attribute: Read-o nly Location: Properties tab Deta[...]

  • Page 77

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 73 VOIP_CISC O_IPT .INPUT_DIRECTOR Y Description P ath to Bulk input files director y for CCM or CUCM metrics . Component UB A Va l u e Default: sqldb:odbc*threade d/username=user&password=pa sswd&en[...]

  • Page 78

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 74 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT .INPUT_DIRECTOR Y Description P ath to Bulk input files director y for CCM or CUCM metrics . Component UB A Va l u e Default: No default value Attribute: Writable Location: Properties t[...]

  • Page 79

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 75 VOIP_CISC O_IPT .INPUT_FTP_P ASSWORD Description FTP or SFTP password for Bulk in put f iles used in CCM or CUCM environments . Component UB A Va l u e Default: No default value Attribute: Writable Locati[...]

  • Page 80

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 76 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT .INPUT_FTP_USERNAME Description FTP or SFTP username for Bulk input files used in CCM or CUCM en v ironments . Component UB A Va l u e Default: No default value Attribute: Writable Loca[...]

  • Page 81

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 77 VOIP_CISC O_IPT .INPUT_HOST Description Hostname for Bulk input files in CCM or CUCM environments. Component UB A Va l u e Default: No default value Attribute: Writable Location: Properties tab Detail The[...]

  • Page 82

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 78 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT .INPUT_HOST Description Hostname for Bulk input files in CCM or CUCM environments. Component UB A Va l u e Default: No default value Attribute: Writable Location: Properties tab Detail [...]

  • Page 83

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 79 VOIP_CISC O_IPT .INPUT_USE_SECURE_FTP Description Acquire CCM or CUCM Bulk i nput files using secure FTP . Component UB A Va l u e Default: false Attribute: Writable Location: Properties tab Detail The IN[...]

  • Page 84

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 80 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT .INPUT_USE_SECURE_FTP Description Acquire CCM or CUCM Bulk i nput files us ing secure FTP . Component UB A Va l u e Default: false Attribute: Writable Location: Properties tab Detail Th[...]

  • Page 85

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 81 VOIP_CISC O_IPT_PERFMON.DESIGNFILE Description J avaScript file that controls UBA for CUCM P erfmon metrics. Component UB A Va l u e Default: CUCMPerfmonAdaptor.js Attribute: Read-only Location: Propertie[...]

  • Page 86

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 82 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT_PERFMON.INPUT_DIRECT ORY Description P ath to Bulk input files director y for CUCM P erfmon metrics. Component UB A Va l u e Default: No default value Attribute: Writable Location: Prop[...]

  • Page 87

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 83 VOIP_CISC O_IPT_PERFMON.INPUT_FTP_P ASSWORD Description FTP or SFTP password for Bulk in put files used fo r collecting P erfmon metrics in CUCM environments . Component UB A Va l u e Default: No default [...]

  • Page 88

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 84 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT_PERFMON .INPUT_FTP_USERNAME Description FTP or SFTP username for Bulk i nput files used for collecting Perfmon metrics in CUCM environments . Component UB A Va l u e Default: No default[...]

  • Page 89

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 85 VOIP_CISC O_IPT_PERFMON.INPUT_HOST Description Hostname for Bulk input files containing P erfmon metrics in CUCM environments . Component UB A Va l u e Default: No default value Attribute: Writable Locati[...]

  • Page 90

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 86 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISC O_IPT_PERFMON.INPUT_USE_SECURE_FTP Description Acquire CUCM P erfmon Bulk i nput files using secure FTP . Component UB A Va l u e Default: false Attribute: Writable Location: Properties tab D[...]

  • Page 91

    Appendix A: UBA parameters ( Tivo li Netcool/Proviso v4.4.3 and later) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 87 VOIP_CISC O_IPT_PERFMON.PERFMON.DELETEONAC QUIRE Description Deletes CUCM P erfmon Bulk i nput files after acquisition. Component UB A Va l u e Default: false Attribute: Writable Location: Advanced Proper[...]

  • Page 92

    Appendix A: UBA pa rameters ( T ivo li Netcool/Proviso v4.4.3 and later) 88 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T e chnology Pack VOIP_CISCO _IPT_PERFMON.PERFMON.URI Description CUCM P e rfmon Bulk input files location. Component UB A Va l u e Default: No default value Attribute: Read-o nly Location: Properties tab Detail The Dat[...]

  • Page 93

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 89 Appendix B: T emplate file ( Tivoli Netc ool/P roviso pre-v4.4.3 only) Y ou should read this appendix after you open the voip_cisco_ipt_sample_dc.cfg template file for editing, as instr ucted in Chapter 4, Configuring the technolog y pack . This appendix describes the pack-s[...]

  • Page 94

    Appendix B: T emplate file ( Tivo li Netcool/Proviso pre-v4.4.3 only) 90 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack The following table describes the values that y ou must pro vide for these UBA parameters . Additional inf ormation about UBA parameters This section provides more information about th e INSTANCES , URI, a[...]

  • Page 95

    Appendix B: T emplate file ( Tivo li Netcool/Proviso pre-v4.4.3 only) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 91 URI The DataChannel UBA application needs to kno w where to find the bulk input files that the supported device generates . T herefore , you m ust specify a Univ ersal Reso urce Identifier (URI) for the lo[...]

  • Page 96

    Appendix B: T emplate file ( Tivo li Netcool/Proviso pre-v4.4.3 only) 92 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack • The UBA tec hnolog y pack requires the DataChann el UB A application to process metrics only . In this scenario , the UB A technolog y pack provides a metrics sc hema in its design file. In this case ,[...]

  • Page 97

    Appendix B: T emplate file ( Tivo li Netcool/Proviso pre-v4.4.3 only) IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 93 UBA.1.101.VOIP_CISCO_IPT.CCMINPUT.DE LETEONACQUIRE=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.1[...]

  • Page 98

    Appendix B: T emplate file ( Tivo li Netcool/Proviso pre-v4.4.3 only) 94 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack NO TES[...]

  • Page 99

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 95 Notices This infor mation was dev eloped for produc ts and ser vices offered in the U .S .A. IBM may not offer the products , ser vices , or features discusse d in this docume nt in other countries. Consult y our local IBM representativ e for infor mation about the products [...]

  • Page 100

    Notices 96 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack Licensees of this program who wish to hav e infor mation a bout it for the pur pose of enabling: (i) the exchange of infor mation between independently create d programs and other prog ra ms (including this one) and (ii) the mutual use of the infor mation which has b[...]

  • Page 101

    Notices IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 97 Other pr oduct an d ser vice na mes might be trademarks of IBM or other companies . © Copyright IBM Corp. 2010. US Go vernment Users R estricted Rights — Use, dupl ication or disclosure restrict ed by GSA ADP Schedule Contract with IBM Corp . J ava and all J ava-b[...]

  • Page 102

    Notices 98 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack[...]

  • Page 103

    IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack 99 A dditional C opyright Inf ormation The following copyright infor mation is for software used b y Tiv oli Netcool/Proviso. Tcl 8.3.3, Combat/T CL 0.7.3, Combat /T CL 0.7.5, TclX 8.3, TK 8.3.3 This s oftware is copyrighte d by the Regents of the University of Califor nia, Su [...]

  • Page 104

    Additional Copyright information 100 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack DISTRIBUTORS HA VE NO OBLIGATION TO PR O VIDE MAINTENANCE, SUPPORT , UPD A TES , ENHANCE MENTS , OR MODIFICA TIONS . V arious cop yrights appl y to this packag e, listed in 3 se parate par ts below . Please ma ke sure that you include all th[...]

  • Page 105

    Additional Copyright information IBM Tivoli Netcool/P roviso Cisco IP T e lephony 2.4.0.0 T echnology Pack 101 • R edistributions in bi nary for m must reproduce th e abo ve co pyright notic e, this list of con ditions and t he follo wing disclaimer in the document ation and/or othe r materials pro vided with the distri bution. • The name of Ca[...]

  • Page 106

    Additional Copyright information 102 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack This software is copyri ghted by the R egent s of the University of California, Su n Microsystems, Inc ., and othe r partie s . The fol lowing ter ms apply to all files associated wi th the software unless explicitly disclaimed in individual[...]

  • Page 107

    Additional Copyright information IBM Tivoli Netcool/P roviso Cisco IP T e lephony 2.4.0.0 T echnology Pack 103 3. Neither the names of Networks Associ ates T echnolog y , Inc, Cambridg e Broadband Ltd., Spar ta, Inc., Cisco , Inc, Beijing University of P osts and T e lecommunications, F abas oft R&D Software GmbH & Co KG or any of its subsi[...]

  • Page 108

    Additional Copyright information 104 IBM Tivoli Netcool/Proviso Cisco IP T elephony 2.4.0.0 T echnology Pack for loss of data, lo ss of profit, or any othe r damage resul ting directly or indirec tly from the use of th e software, even if th e damage is caused by defects in th e software. 3. Y ou may use this software in any applications you build.[...]

  • Page 109

    [...]

  • Page 110

    IBM ®[...]