Target Recording: Difference between revisions

Latest revision as of 19: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.

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

@@ 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 ==
-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
 * FAX quality analysis
@@ Line 19: / Line 23: @@
 == 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:
+=== Web Portal ===
+'''This mode should be used for troubleshooting only.'''
-== Recording options ==
+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 [[TMG-CONTROL_Version_2.7|Toolpack 2.7]] and up only)
-* Calls to recording filtering:
+* Available filtering parameters:
 ** By calling number
 ** By called number
-** By NAP
+** By incoming NAP
-** By routing script
+** 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.
-== Configuration ==
+* Recorded files options:
-=== Using routing scripts ===
+** Record each leg of a call into it's own file
-Toolpack routing scripts are provided with an example filter script for recording calls, which can be easily inserted into any routing script.
+** 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
-For more information, please refer to the [[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]].
-== Accessing recorded file ==
+== Configuration ==
-Recorded files can be accessed from the Tmedia unit's file system (accessible through ssh, scp).
+=== Configuration (and Accessing the recorded calls) ===
+*[[Toolpack:Troubleshooting_D#Target_Recording|Target Recording for 3.0]]
+*[[Toolpack:Troubleshooting_C#Target_Recording|Target Recording for 2.10]]
+*[[Toolpack:Troubleshooting_B#Target_Recording|Target Recording for 2.9]]
+*[[Toolpack:Troubleshooting_A#Target_Recording|Target Recording for 2.8]]
+<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]]