Target Recording

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Configuration)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Tmedia]] units, running [[Toolpack]] software and the [[TB_Media_Gateway|Gateway]] application, allow call recording.
+
[[Tmedia]] units, running [[Toolpack]] software and the [[TB_Media_Gateway|Gateway]] application, permit the recording of calls.
Calls are being recorded to ".wav" files on the Tmedia unit's drive.
+
 
 +
Calls are recorded as ".wav" files on the Tmedia unit's drive.  
 +
 
 +
'''WARNING: For this reason, target recording is recommend for troubleshooting only and should be disabled when it is not needed. In addition, recording a large amount of calls simultaneously will have an impact on the system's performance.'''
  
  
 
== Use cases ==
 
== Use cases ==
Target recording can be very useful in a lot of different situation:
+
Target recording is useful in a variety of applications:
 +
 
 
* Voice/line quality control
 
* Voice/line quality control
 
* FAX quality analysis
 
* FAX quality analysis
Line 19: Line 23:
  
 
== Hardware requirements ==
 
== Hardware requirements ==
* [[Tmedia]] unit with DSP resources
+
* [[Tmedia]] unit with IVR DSP resources
 +
* Starting with version 2.8.101, [[Tmedia]] unit with IVR DSP resources or VoIP DSP resources with playing/recording licenses
  
 +
== Recording modes ==
 +
Recording calls can be achieved using 1 of 2 methods:
  
== Recording options ==
+
=== Web Portal ===
 +
'''This mode should be used for troubleshooting only.'''
 +
 
 +
It is easy to use but not flexible.
 +
 
 +
This mode is limited to record based on the following parameters:
 
* Recorded files options:
 
* Recorded files options:
 
** Record each leg of a call into it's own file
 
** Record each leg of a call into it's own file
 
** Record an audio mix of both legs of a call to a single file (only available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
 
** Record an audio mix of both legs of a call to a single file (only available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
* Calls to recording filtering:
+
* Available filtering parameters:
 
** By calling number
 
** By calling number
 
** By called number
 
** By called number
** By NAP
+
** By incoming NAP
** By routing script
+
** By outgoing NAP
  
  
== Configuration ==
+
=== Routing script ===
=== From Web Portal ===
+
This mode can insert recording into any existing routing script.
Call recording can be enabled and configured from the Web Portal, through the Gateway configuration page (see Gateway tab on the left menu in the Web portal).
+
[[File:Target_recording_web.png]]
+
  
Filtering options are combined in a "AND" manner. A call will be recorded only if it matches ALL of the specified filtering options (calling number, called number, incoming NAP, outgoing NAP).
+
It is extremely flexible but requires users to modify their routing scripts.
  
An option left blank is ignored.
+
* Recorded files options:
 +
** Record each leg of a call into it's own file
 +
** Record an audio mix of both legs of a call to a single file (only available with [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
 +
* Available filtering parameters:
 +
** Any call parameters
 +
** Any route parameters
 +
** Any routing scripts parameters
  
These filtering options are global to the Tmedia system. For finer-grain control over call recording, routing scripts can be used.
 
  
=== Using routing scripts ===
+
== Configuration ==
Toolpack routing scripts are provided with an example filter script for recording calls, which can be easily inserted into any routing script.
+
=== Configuration (and Accessing the recorded calls) ===
 
+
*[[Toolpack:Troubleshooting_D#Target_Recording|Target Recording for 3.0]]
For more information, please refer to the [[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]].
+
*[[Toolpack:Troubleshooting_C#Target_Recording|Target Recording for 2.10]]
 
+
*[[Toolpack:Troubleshooting_B#Target_Recording|Target Recording for 2.9]]
== Accessing recorded file ==
+
*[[Toolpack:Troubleshooting_A#Target_Recording|Target Recording for 2.8]]
Recorded files can be accessed from the Tmedia unit's file system (accessible through ssh, scp).
+
<div class="mw-collapsible mw-collapsed" data-collapsetext="other versions" data-expandtext="Click here for other versions" style="width: 400px;">
 +
*[[Web_Portal_Tutorial_Guide_v2.7#Target Recording|Target Recording for 2.7]]
 +
</div>
  
They are also accessible from the Web Portal, through a "download" button available when viewing a Call Trace:
 
  
[[File:Target_recording_call_trace.png]]
+
=== Routing Scripts mode ===
 +
*[[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]]

Latest revision as of 18:01, 9 March 2018

Tmedia units, running Toolpack software and the Gateway application, permit the recording of calls.

Calls are recorded as ".wav" files on the Tmedia unit's drive.

WARNING: For this reason, target recording is recommend for troubleshooting only and should be disabled when it is not needed. In addition, recording a large amount of calls simultaneously will have an impact on the system's performance.


Contents

Use cases

Target recording is useful in a variety of applications:

  • Voice/line quality control
  • FAX quality analysis
  • Lawful interception
  • Debugging
  • Test calls


Software requirements

  • Toolpack software version 2.6 or higher
  • tbstreamserver application configured to be running (it's not running by default)
  • Gateway application (standard with Toolpack unless explicitly replaced by custom call handling application)


Hardware requirements

  • Tmedia unit with IVR DSP resources
  • Starting with version 2.8.101, Tmedia unit with IVR DSP resources or VoIP DSP resources with playing/recording licenses

Recording modes

Recording calls can be achieved using 1 of 2 methods:

Web Portal

This mode should be used for troubleshooting only.

It is easy to use but not flexible.

This mode is limited to record based on the following parameters:

  • Recorded files options:
    • Record each leg of a call into it's own file
    • Record an audio mix of both legs of a call to a single file (only available with Toolpack 2.7 and up only)
  • Available filtering parameters:
    • By calling number
    • By called number
    • By incoming NAP
    • By outgoing NAP


Routing script

This mode can insert recording into any existing routing script.

It is extremely flexible but requires users to modify their routing scripts.

  • Recorded files options:
    • Record each leg of a call into it's own file
    • Record an audio mix of both legs of a call to a single file (only available with Toolpack 2.7 and up only)
  • Available filtering parameters:
    • Any call parameters
    • Any route parameters
    • Any routing scripts parameters


Configuration

Configuration (and Accessing the recorded calls)


Routing Scripts mode

Personal tools