Welcome to the Cisco TelePresence Developer forum! This forum is for integrators and developers only. The topics should be around device integration and development of solutions with Cisco TelePresence equipment only. This is NOT a product support channel. If you have support related questions please contact your local Cisco representative. Topics not following the above rules may be removed  from the forum. Topics that drift off into flame wars or go way off topic may also be removed without further notice.

« Back to TMS Integration

CDR files retrieving

Combination View Flat View Tree View
Threads [ Previous | Next ]
CDR files retrieving
Answer
9/3/12 9:17 AM
Hi all,
 
At the moment i do have a request from a customer to integrate a Java application with the Cisco infrastructure.
 
The Cisco infrastructure is made up:
TelePresence Server varsion 2.2
Telepresence Manamegent Suit: 13.2
 
I'm blocked on how to download the cdr files from the TPS.
 
Reading Cisco manuals I've found a couple of solutions with few questions:
 
 
1)      download the CDR using the API, referencing to the document:
http://www.cisco.com/en/US/docs/telepresence/infrastructure/mcu/admin_guide/cisco_telepresence_infrastructure_cdr_reference_guide.pdf


a.      does exist an API of the TPS or TMS to download the CDR ?
 
b.      is possible to have an example of the CDR obtained by the use of the API ?
 
c.      because of I need only the data of a specific day ( i.e. yesterday ), is possible to filter the data contained in the CDR  retrived by the API ?
 
d.      at page 4/63 I see:
'...CDR logging is always enabled on the TelePresence Server and cannot be disabled. These devices
store the latest 2000 records only, discarding earlier records as necessary. They also do not write logs
to compact flash - they hold the records in memory.'
What do you mean as 'devices' ?
Do you confirm the older records are deleted from the downloaded CDR ? Like the FIFO algorithm.
 
e.      Does exist an attribute in the CDR file to determine if it is a Telepresence device with multiple screens or not
 
f.      Reading the CDR file downloaded using the web interface of the TPS, which is the meaning of the values of the attributes 'context' and 'position'
at the tag <stream> ?
Is possible to have a range of such values ?

 
g.      Which is the value of the tag endpoint_uri when one of the participants is an ISDN terminal ?
at page 20/63 I see:
'...Endpoint's SIP URI or H.323 ID.'
Do you confirm those 2 are the only possible values ?
 
 
 
2)      register my application as an Events listener:
referencing to the document
(http://www.cisco.com/en/US/docs/telepresence/infrastructure/ts/api_guide/Cisco_TelePresence_Server_API_2-2_1-43.pdf)
 
a.      is possible to use the call cdrlog.enumerate to have the events of a specific date ?
 
b.      how is possible to register my Java application via the call feedbackReceiver.configure ?
Do I need to opne a Socket and leave it active all the time ?
 
c.      When the value of conference.status parameter is false does it mean the conference is ended ?
 
d.      If a participant is an ISDN terminal and the meeting is ended which is the value of the attribute callProtocol for the participant present in the participantList ?
Flag

RE: CDR files retrieving
Answer
9/10/12 11:59 AM as a reply to marco.marotta.tecnolife.it (simulated).
I'm not sure how you can download these as an API user but TMS uses this API to generate it's own CDRs for TSes since 13.1: http://www.cisco.com/en/US/docs/telepresence/infrastructure/tms/release_note/Cisco_TMS_Release_Note_13-1.pdf. TMS does not expose this data on a TMS API though so I'm not sure if this is useful for you.
Flag

RE: CDR files retrieving
Answer
9/10/12 4:35 PM as a reply to marco.marotta.tecnolife.it (simulated).
a.      does exist an API of the TPS or TMS to download the CDR ?

 
The CDR events stored on the TS can be downloaded using the cdrlog.enumerate method (see 
 
http://www.cisco.com/en/US/docs/telepresence/infrastructure/ts/api_guide/Cisco_TelePresence_Server_API_2-2_1-43.pdf)
 

c.      because of I need only the data of a specific day ( i.e. yesterday ), is possible to filter the data contained in the CDR  retrived by the API ?

 
No. The API only allows you to filter on event type.
 

d.      at page 4/63 I see:
'...CDR logging is always enabled on the TelePresence Server and cannot be disabled. These devices
store the latest 2000 records only, discarding earlier records as necessary. They also do not write logs
to compact flash - they hold the records in memory.'
What do you mean as 'devices' ?
Do you confirm the older records are deleted from the downloaded CDR ? Like the FIFO algorithm.

 
For 'These devices' read 'the Telepresence Server'. Older records are deleted first, yes. 
 

e.      Does exist an attribute in the CDR file to determine if it is a Telepresence device with multiple screens or not
 

 
Please see http://www.cisco.com/en/US/docs/telepresence/infrastructure/mcu/admin_guide/cisco_telepresence_infrastructure_cdr_reference_guide.pdf - the presence of multiple streams in each direction with context 'main' in the participant media summary will tell you this.
 

f.      Reading the CDR file downloaded using the web interface of the TPS, which is the meaning of the values of the attributes 'context' and 'position'
at the tag <stream> ?
Is possible to have a range of such values ?

See this document, pages 24-27.
http://www.cisco.com/en/US/docs/telepresence/infrastructure/mcu/admin_guide/cisco_telepresence_infrastructure_cdr_reference_guide.pdf 
 

g.      Which is the value of the tag endpoint_uri when one of the participants is an ISDN terminal ?
at page 20/63 I see:
'...Endpoint's SIP URI or H.323 ID.'
Do you confirm those 2 are the only possible values ?

 
Potentially this could be the phone number, or the h323 ID of the gateway, and may be different for dial-in and dial-out participants. It depends on your gateway and its configuration - it would be best to test it and see what you get. 

 
a.      is possible to use the call cdrlog.enumerate to have the events of a specific date ?

 
No. 
 

b.      how is possible to register my Java application via the call feedbackReceiver.configure ?
Do I need to opne a Socket and leave it active all the time ?
 

 
No. You need to impliment an HTTP server to receive feedback POSTS, and give the URL to access it in feedbackReceiver.configure.
 

c.      When the value of conference.status parameter is false does it mean the conference is ended ?

 
Are you referring to one of the return values from conference.status? If so which one? 
 

d.      If a participant is an ISDN terminal and the meeting is ended which is the value of the attribute callProtocol for the participant present in the participantList ?

This will either be h323 or SIP, depending on which protocol was used to dial the ISDN gateway - the TS has no knowledge of ISDN itself.
Flag

 The forum is moderated by R&D and our aim is to answer your questions as soon as possible. If we cannot resolve your issues immediately we will try to give you feedback indicating when you may expect an answer.

Note that in no circumstances are we able or even allowed to give any promises regarding new products, firmware updates, new features, release dates etc. before they are officially released.

If your question is for a specific product please include both the device type (e.g. Codec C60 or Codec 3000 MXP) and software version (e.g. TC 2.1 or F8.0) for us to be able to answer as accurate as possible.