FreeSwitch H323

From FreeSWITCH Wiki

Current Status

At this moment (Sep. 13th 2006) FreeSwitch supports H323 via Woomera only.

Mod_woomera is deprecated and will be removed. It needs to be re-written because the protocol has since changed drastically since the original code was written.

Setup Guide

This is a short guide on how to set up H323 for Freeswitch using Woomera.

1) First, download the latest stable sources for PWLib and OpenH323 from http://www.voxgratia.org/downloads.html, depending on the system that you use.

2) Follow the procedure for compiling the above libraries http://www.openh323.org/build.html again, depending on the system that you use.

3) To download Woomera do the following (you need to have a CVS client installed):

cvs -d:pserver:anonymous@voxgratia.cvs.sourceforge.net:/cvsroot/voxgratia login (just press enter when you are asked for a password) 
cvs -z3 -d:pserver:anonymous@voxgratia.cvs.sourceforge.net:/cvsroot/voxgratia co -P woomera 

4) Compile woomera according to the instructions & depending on your system.

5) Assuming that you already have Freeswitch installed on your system:

• In the freeswitch.xml file, uncomment the line

<load module="mod_woomera"/>

in the modules section of the modules.conf part of the config

• In the freeswitch.xml file, go to the woomera.conf part and edit the following lines:

  <configuration name="woomera.conf" description="Woomera Endpoint">
    <settings>
      <param name="debug" value="10"/> (put the value to 0 if you don't need debug output)
    </settings>
    <interface>
      <param name="host" value="localhost"/> (keep this value if you are running woomera on the same system)
      <param name="port" value="42420"/> (this is the default port, it can be set to any allowed port number)
      <param name="audio-ip" value="127.0.0.1"/> (keep this value if you are running woomera on the same system)
      <param name="dialplan" value="XML"/>
     </interface>
  </configuration>

6) Start woomera, using the -p parameter to set the appropriate port which should be the same as the value of the port parameter in the freeswitch.xml file (42420 in this example). An example is:

woomera -n -p 42420 -t

You can set it up to execute in the background or set it up as a daemon/service, but for a start it's best to execute woomera as an application and use the output for debug

7) Start Freeswitch, and you are ready to place H323 calls from the dialplan. For example, if you need to call 5678 through an H323 gateway at x.y.z.w, use the following extension:

<extension name="H323test">
  <condition field="destination_number" expression="^5678$"> 
     <action application="bridge" data="woomera/$1@x.y.z.w"/>  
  </condition> 
</extension>