Target Recording

From TBwiki
(Difference between revisions)
Jump to: navigation, search
 
(18 intermediate revisions by 4 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 9: Line 14:
 
* Debugging
 
* Debugging
 
* Test calls
 
* Test calls
 +
  
 
== Software requirements ==
 
== Software requirements ==
Line 14: Line 20:
 
* [[Toolpack_Application:tbstreamserver|tbstreamserver]] application configured to be running (it's not running by default)
 
* [[Toolpack_Application:tbstreamserver|tbstreamserver]] application configured to be running (it's not running by default)
 
* [[TB_Media_Gateway|Gateway]] application (standard with [[Toolpack]] unless explicitly replaced by custom call handling application)
 
* [[TB_Media_Gateway|Gateway]] application (standard with [[Toolpack]] unless explicitly replaced by custom call handling application)
 +
  
 
== 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:
 +
 
 +
=== Web Portal ===
 +
'''This mode should be used for troubleshooting only.'''
 +
 
 +
It is easy to use but not flexible.
  
== Recording options ==
+
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]]
+
  
=== Using routing scripts ===
+
It is extremely flexible but requires users to modify their routing scripts.
Optionally, recording can be controller by enabling a routing script filter.
+
  
For more information, please refer to the [[Routing_script_tutorial:Mini_Development_Guide#Recording_call_legs|routing script mini tutorial guide]].
+
* 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
 +
 
 +
 
 +
== Configuration ==
 +
=== 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>
  
== Accessing recorded file ==
 
Recorded files can be accessed from the Tmedia unit's file system (accessible through ssh, scp).
 
  
They are also accessible from the Web Portal, through a download the "call trace" section when viewing a call trace.
+
=== 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