Note |
---|
Before doing anything, make sure mod_lua and dkjson is enabled/installed in the freeswitch of on both machines. |
1- Recording Script
The first step we need to take on freeswitch is to download Download
file.View file name record.lua Connect to the VM where free switch is installed.
Place it in the "scripts" directory of freeswitch. It can be found under "/usr/local/freeswitch/scripts/" or "/usr/share/freeswitch/scripts/" depending on whether you installed freeswitch recorder from source or package, respectively.
Open record.lua and change the url
url = "http://<ip-address>:9900/mixer/sip-data"
. Andurl = "http://<ip-address>:9900/mixapi"
Create a direcotry/folder in the path /usr/sharelocal/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
...
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 direcotry directory path.
Code Block |
---|
local recording_dir = '/usr/sharelocal/freeswitch/cucmRecording/streams' local mixedRecordingDir = '/usr/sharelocal/freeswitch/cucmRecording/sessions' |
...
Code Block |
---|
#chmod 777 -R "full/address/of/directory" |
2 - Dialplan Configuration
Switch to the dialplan direcotry inside the freeswitch.directory
/usr/local/freeswitch/conf/dialplan
Add the following lines of code in the public .xml file of both freeswitches.
Code Block |
---|
<extension name="outside_call" continue="true"> <condition> <action application="set" data="outside_call=true"/> <action application="log" data="INFO PP-----${sip_from_host}--------------Starting Record Dialplan --------------12124"/> <action application="export" data="RFC2822_DATE=${strftime(%a, %d %b %Y %T %z)}"/> </condition> </extension> <extension name="CUCM Recording Profile"> <action application="log" data="INFO Entering Call from CUCM"/> <condition field="${sip_from_host}" expression="192.168.1.26"> <action application="lua" data="record.lua"/> </condition> </extension> |
in case of multiple CUCM we need to add all the ip addresses using '|' pipe.
Code Block |
---|
<extension name="CUCM Recording Profile">
<action application="log" data="INFO Entering Call from CUCM"/>
<condition field="${sip_from_host}" expression="192.168.1.26|192.168.1.27|192.168.1.28">
<action application="lua" data="record.lua"/>
</condition>
</extension> |
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".
...
Code Block |
---|
<param name="parse-all-invite-headers" value="true"/> |
Now set the rtp-ip, sip-ip, ext-rtp-ip and ext-sip-ip equals to your recorder’s machine ip in external.xml.
Code Block <param name="rtp-ip" value="<ip-address>"/> <param name="sip-ip" value="<ip-address>"/> <param name="ext-rtp-ip" value="<ip-address>"/> <param name="ext-sip-ip" value="<ip-address>"/>
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.
Code Block |
---|
<node type="allow" domain="$${domain}"/>
.
.
<node type="allow" cidr="<CUCM_IP>/32"/> <!--- Add this line and replace "<CUCM_IP>" with the IP address of your CUCM installation --> |
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.
Code Block |
---|
#sudo systemctl restart freeswitch |
7- Utilities
After the Recorder is restarted, Install the following utilities by running the commands:
Code Block |
---|
#sudo apt install -y lua-socket
#sudo apt install -y lua-dkjson |