Document toolboxDocument toolbox

(14.3) Recorder Configurations

 

Before doing anything, make sure mod_lua and dkjson is enabled/installed on both machines. 

1- Recording Script

  • Download file.

  • Place it in the "scripts" directory. It can be found under "/usr/local/freeswitch/scripts/" or "/usr/share/freeswitch/scripts/" depending on whether you installed recorder from source or package, respectively.

  • Open record.lua and change the url url = "http://<ip-address>:9900/mixer/sip-data". And url = "http://<ip-address>:9900/mixapi"

  • Create a direcotry/folder in the path /usr/local/freeswitch with the name cucmRecording. now enter to this cucmRecording folder and create two more folders/directories with names “streams“ and “sessions”.
    The directory/folder can be created with

mkdir <directry or folder name>
  • Edit/open the recording script (record.lua) and assign the correct paths to the "recording_dir" and "mixedRecordingDir" variables.

  • The correct path can be found via "pwd” command after checking into each directory, the “pwd” command will print the working directory path.

local recording_dir = '/usr/local/freeswitch/cucmRecording/streams' local mixedRecordingDir = '/usr/local/freeswitch/cucmRecording/sessions'
  • Make sure to assign all user permissions to both directories used in these variables.

#chmod 777 -R "full/address/of/directory"

2 - Dialplan Configuration

  • Switch to the dialplan directory /usr/local/freeswitch/conf/dialplan

  • Add the following lines of code in the public .xml file.

 

in case of multiple CUCM we need to add all the ip addresses using '|' pipe.

3 - SIP Profiles

  • Switch to the sip_profiles directory in /usr/local/freeswitch/conf/sip_profiles.

  • Edit the internal.xml and external.xml SIP profiles and enable or uncomment the Third Party Call Control option in both of them.

  • Change the value flag to "true" if it is set to "false" or "proxy".

  • We also need to add one more line to the internal.xml file if it doesn't already exist.

  • Now set the rtp-ip, sip-ip, ext-rtp-ip and ext-sip-ip equals to your recorder’s machine ip in external.xml.


4- Access Control List (ACL)

Navigate to the directory "/usr/local/freeswitch/conf/autoload_configs"

Open the file "acl.conf.xml" and add the following line “<node type="allow" cidr="<CUCM_IP>/32"/>” under the "<node type="allow" domain="$${domain}"/>" line. (Replace <CUCM_IP> with the IP address of your CUCM installation). In case of multiple CUCM send invite recorder, add multiple lines each to allow each one of the CUCMs.

5-Disable STUN

Navigate to the file vars.xml in /usr/local/freeswitch/conf open the file and comment out following lines.

<X-PRE-PROCESS cmd="stun-set" data="external_rtp_ip=stun:stun.freeswitch.org"/>

<X-PRE-PROCESS cmd="stun-set" data="external_sip_ip=stun:stun.freeswitch.org"/>

Since it is a pre process we need to restart the Recorder.

7- Utilities

After the Recorder is restarted, Install the following utilities by running the commands: