Showing posts with label VoIP. Show all posts
Showing posts with label VoIP. Show all posts

Saturday, April 3, 2010

Asterisk vs. FreeSWITCH - This Again? Really?

Sigh. Yet another blogger who thinks that there's some sort of knock-down, drag-out fight between Asterisk and FreeSWITCH. I'll get to that in a minute. First, though, let me give you the quick version of my background so that my biases are clearly enumerated before I give my opinion.

As some of you may know, I work with the FreeSWITCH team. I've been working officially with them for about 18 months. Prior to that I was a relatively active volunteer member of the community for at least another 18 months. Prior to that I had been watching both FreeSWITCH and Asterisk since 2006. That's roughly four years of watching both projects, with using Asterisk heavily at first and then a gradual shift over to FreeSWITCH. When I first heard of Asterisk, I thought, "Awesome! An open source PBX!" (I was an NEC PBX technician for five years in the 1990's and then went to work for a call center for nearly 10 years as the IT and "phone guy" and key/PBX systems are a passion of mine.) I didn't actually try it out until I happened to see the starfish book - TFOT as it's come to be known. I bought it immediately and jumped right in. I'm like many OSS supporters: when someone goes through the trouble of producing "dead tree" documentation for an OSS project then that project must be gaining traction. (Shameless plug: I am writing a FreeSWITCH book with Anthony Minessale and Darren Schreiber for Packt Publishing - watch for it later this year.)

I played a lot with it, joined the Asterisk mailing list and even convinced my then boss to let me buy a four-port T1 card so that I could experiment with PRI lines and connecting to our NEC 2400 PBX. It was a lot of fun, until... CDRs. At that time, Asterisk CDRs were the stuff of nightmares. (Are they still? I don't know - I'll leave that to those who use it in production.) It was about this time that someone - Douglas Garstang, IIRC - was ranting pretty heavily about his own woes with Asterisk. Of course, he was doing this on the Asterisk mailing list and more than a few feathers were ruffled. Trollish behavior aside, he mentioned two syllables that would eventually change my life: FreeSWITCH. I had never heard of it. Of course, this was right around the time with the drama of the OpenPBX/CallWeaver fork. I was new to Asterisk and VoIP and I found this all very confusing. Asterisk seemed so awesome! Why were there those who forked it and those who abandoned it? I didn't know, but I kept learning as much as I could. I checked out FreeSWITCH in the very early days, long before people were using it in production. My impression was simple: it's going to be an awesome project someday, but I can't use it right now. I couldn't use it for the projects I was working on because they all required TDM hardware support. Still, I couldn't help but think that the FreeSWITCH guys were on to something, so I signed up for the mailing list and decided to check in every now and then. In the meantime I kept on tinkering with Asterisk.

Fast-forward to May, 2007. The FreeSWITCH guys created OpenZAP - a TDM hardware abstraction layer. Excellent! Now I could try out FreeSWITCH with my projects. I jumped in with both feet and this is where I really began to learn about the differences between the two projects. I guess I was among the first persons to try using FreeSWITCH with a PRI carrier. I thought I was driving Anthony and Mike Jerris nuts with all of my questions but not only were they patient with me, they expressed appreciation for my efforts to get TDM working with FreeSWITCH and my efforts to document everything that I learned. And learn I did! It was crazy and fun learning all about FreeSWITCH and diving into Q.931 spec docs from AT&T and the ITU. The next year was very educational. The next thing I knew I was at ClueCon 2008 meeting all of these guys in person! I also met Allison Smith, "the voice" of Asterisk. I met Jim van Meggelen. It was a bit overwhelming at first, but everyone was down-to-earth and friendly. Brian K. West has especially helpful, taking me under his wing and showing me around. (He still does, and I love every minute of it! Thanks, Brian! You are an awesome guy who knows more about VoIP and networking than pretty much anyone I've ever met.) By the end of 2008 I was working with the very same guys whom I thought of as rock stars: Anthony, Brian, Mike. I am still working with those great guys today. Too cool.

Pardon the tangent, but that puts this post in perspective. I've spent a lot of time over the past few years with the core FreeSWITCH team. I think my viewpoint of their feelings on the matter of "Asterisk vs. FreeSWITCH" is pretty accurate. That's why I feel it is necessary to comment on the aforementioned blog post by "kallaje" over at simplymentos.wordpress.com. I'll restrict my comments here to the information he presents as factual. I'll do my best to present "our" side's viewpoint. I can't be unbiased but I will do my best to be reasonable. Here goes.

This is the most sought after topic in the history of Telecom industry I suppose.


I have to assume this is hyperbole. If it isn't then the rest of his post really is just the rantings of an uninformed lunatic.


These 2 factions for some reason, I cant understand, are dividing the telecom world.

Wow. We're factions and we're "dividing the telecom world"? I didn't realize that our respective projects were so incredibly important! I'd like to find out what, exactly, precipitated this comment. (More hyperbole perhaps?)


One claiming superiority over the other.

I don't know that either side has ever "claimed superiority" over the other. I do know that many FreeSWITCH users are Asterisk "refugees" who simply wanted or needed a different solution to meet their VoIP needs. As you'll find out in the upcoming FreeSWITCH book, Anthony lobbied for the creation of "Asterisk 2.0" but was met with a range of reactions ranging from ambivalence to hostility. I suppose you could say Anthony Minessale is "Asterisk refugee zero." He started FreeSWITCH, not because he hated Asterisk, but because he wanted Asterisk to be able to do much more than what was available in 2005. We're now in 2010. FreeSWITCH 1.0.5 is about to be released and it is incredible. Is it "superior" to Asterisk? That's a ridiculously subjective question, and an irrelevant one as well. No one on the FreeSWITCH team is out there claiming that FreeSWITCH is "better" or "superior" to Asterisk. What they are saying is that there are many things that FreeSWITCH can do that Asterisk cannot. (Examples: multiple UAs, mix calls to/from any codec and sampling rate, supports sampling rates of 8k, 12k, 16k, 24k, 32k, and 48kHz.) FreeSWITCH being able to do something that Asterisk cannot (or vice versa) is not a claim of superiority. Also, I still subscribe to the Asterisk mailing list. I haven't seen or heard anyone from Digium making any claims about Asterisk being "superior" to FreeSWITCH. I have no idea where this crazy statement came from.


I think both are equally good but differ in the purpose they serve and whom they serve.


Ah, finally a statement that doesn't have me pulling my hair out. The expression "equally good" is very subjective, but that's not the important part of this sentence. Rather, the statement that the projects "differ in the purpose they serve and whom they serve" is key. It is 100% correct. Oh, and kudos for using "whom" correctly and not "who." I wish the blog post consisted of only this sentence because it is the high point of the entire post.


The differentiation is in the number of concurrent call handling and that makes all the difference for choosing one over the other!!!

Yes and no. Yes, FreeSWITCH can ostensibly "handle more calls" than Asterisk. However, Asterisk has been making strides in this area. Olle E Johansson reports that there is a large Asterisk installation that is surpassing 10,000 concurrent calls. Anthony and Brian have experimented with a FreeSWITCH server handling 20,000 calls, but at some point you have to ask, "Why?" and just move on to a different problem. Just because you can put 10K calls on a single box doesn't mean you should. The bottom line is that FreeSWITCH is a soft-switch and Asterisk is an IPPBX. They have lots and lots of overlapping functionality. They each do things the other doesn't. No big deal there. My take on this is simple: use what works for you, regardles of how many calls you need to handle on a single machine.


...but SMB’s must not invest in Windows…


I'm no Windows fan but I don't know that SMB's "must" avoid Windows no matter what. I came from a place that had 100+ Windows XP machines and they worked really well for us. That being said, I do prefer Linux for pretty much all of my server needs. However, many others out there use Windows 2003 and 2008 Server edition with FreeSWITCH and report good success. Like we said before: use what works for you.


Freeswitch [sic] is not simple.


That's a bit of a straw man. Of course, FreeSWITCH isn't "simple." Why? BECAUSE VOIP IS NOT SIMPLE!!! Hello? Have you read all the SIP RFC's out there? Have you seen all the crazy NAT devices and evil SIP ALG's in various products? On the other hand, I suppose you could say that the power of a platform is inversely proportional to it's simplicity. Translation: FreeSWITCH is really powerful.


It’s [sic] SIP Stack is too robust to debug or understand.

Huh? How can a SIP stack be too robust? FreeSWITCH currently uses the Sofia SIP library from Nokia. It's pretty robust. As for not being able to be understood or debugged - what full-featured SIP stack is non-robust enough to debug or understand? Is this person really saying that chan_sip.c is easy to debug or understand? Has he seen the bug reports in Mantis?


Its 407 authentication always nullifies your Avaya trunk.

Perhaps Avaya should actually follow the RFC's and not bastardize SIP the way so many others do. SIP is complicated enough without all of the vendors making their own goofy little quirks and additions.


Its [sic] not a good test platform.


Wrong. It's a great test platform! The FreeSWITCH devs don't pander to those wanting dirty hacks in order to gain interoperability with vendors who choose to cut corners or play fast and loose with the RFCs. If your stuff works with FreeSWITCH then chances are that your stuff really does follow the RFCs. There are some exceptions, of course. Classic example is Sonus and their DTMFs. If you want the sordid details then check this out.


It is too scalable to be handled by a single person.


Except for the hundreds of single persons who use it and administer FreeSWITCH-based VoIP systems every day. I don't have any clue where that statement came from.


Freeswitch [sic] is superb for programmers who really like doing something on the cloud, with Vitelity or Amazon EC2. Great return on investment guaranteed.


I'd have to agree with this. We have many users who like to do stuff in the cloud.


The best part? Its MPL license…. What more do we need as application integrators and designers…. All in a single product.


I generally agree with these statements as well. However, I don't agree that FreeSWITCH doesn't scale down very well. It scales down really well, so well, in fact, that there is a new soft-phone project that will use FreeSWITCH as the telephony engine.


Freeswitch [sic] can never even be managed for a small SMB...If you want to scale Freeswitch [sic] to SMB scenario, then it only means, you need hire someone.


We have hundreds of happy users who would completely disagree with these assertions. However, we don't discourage enterprises from hiring in-house talent to take care of their telecommunications infrastructure. VoIP and FreeSWITCH take time to learn. Frankly, so does Asterisk. The mere presence of voip-info.org is no panacea for curing all the ills one faces when deploying Asterisk. All VoIP systems have some level of complexity and a learning curve. FreeSWITCH is at the high end: lots of power, lots of options, lots of time and effort needed to learn the ins and outs. However, if you download and build FreeSWITCH with its default configuration you will have a simple soft PBX that "just works." In an hour you can be using and learning FreeSWITCH.


When I say, Freeswitch [sic] is difficult to use, I am taking into account the number of resources, help available in the web to do it as well. Its [sic] really really poor.


I would have to disagree with this. FreeSWITCH has a vibrant online community, including an IRC channel and several mailing lists. The three main developers answer questions on both email and IRC pretty much every day. When was the last time Mark Spencer answered a question on email or hung out in #Asterisk to help new users? As far as other resources, yes I understand the challenges. That's why we're writing a book as well as revamping the wiki. I am doing much of this work on my own so it is going slowly, but it definitely is going. The FreeSWITCH wiki does have lots of information, however some of it is really hard to find. We are aware of that and are working on it. (Volunteers welcome, BTW!)


Freeswitch [sic] must remove their big Advertising on Asterisk v/s Freeswitch and focus more on what they are good at.


I just googled "Asterisk vs FreeSWITCH" and mostly everything I found was written by other people. The only thing that we have is "node 117" which is a post that Anthony wrote in response to repeated requests from people who wanted to know the differences between Asterisk and FreeSWITCH. Although the link on the main page (upper left corner) for node 117 says "FreeSWITCH vs. Asterisk" that does not mean the two projects are in some sort of cage match. It simply means, "How does FreeSWITCH compare to Asterisk?" As for this "big advertising" campaign about Asterisk vs. FreeSWITCH - I simply can't find any evidence that it even exists.


They might have been good in blaming before, but its [sic] time to move on and grow up
.

I don't know who was being "blamed" by the FreeSWITCH dev team nor have I heard them "blame" anyone. I don't know what the author is really trying to say. Perhaps he could explain this statement because it seems just plain wrong to me.

Well, those are the comments he made that I wanted to address. As for the state of "us vs. them" here are my personal thoughts. Is there hatred, animosity, and bad blood between the two projects? Absolutely not. Is there some good-natured ribbing going on? Of course! What about the disagreement between Anthony and some of the core Digium guys? Isn't there some bad blood there? Perhaps. But even if there is, does it really matter? Just because two guys have a disagreement doesn't mean that their two projects represent "two factions that are dividing the telecom world." They are simply two different OSS telephony projects with some overlapping functionality.

The bottom line is rather uncomplicated. The FreeSWITCH developers have a very simple motto: use what works, be it FreeSWITCH, Asterisk, YATE, OpenSIPS, Kamailio, or some combination thereof. That's one of the beautiful things about FOSS - you can try them all and pick the one that works for your scenario. Your choice may be different than mine, and I have no problem with that. You may love Asterisk and I may love FreeSWITCH but that doesn't mean we have to be adversaries. So please, no more "Asterisk vs. FreeSWITCH" diatribes. We've all got better things to do.

Wednesday, October 28, 2009

Using mod_xml_curl In FreeSWITCH - How Hard Can It Be? (Part 1)

I've been playing with FreeSWITCH for more than three years. In all that time I've never really had a good reason to use mod_xml_curl. Until now, that is. The good reason is nothing more than my own edification. I like to answer questions on the mailing list and finally I got sick of telling people to use xml_curl without having used it my self.

MOD_XML_CURL: The Magic Module For Dynamic FreeSWITCH Configuration
Okay, here's a quick overview of mod_xml_curl: it's a module in FreeSWITCH that allows parts of the FreeSWITCH configuration to be fetched from a web server that can, in turn, grab the configuration information from a database (or anywhere else for that matter). The primary ways to use xml_curl are for the dialplan and the user directory, but you can also use it for configuration options and for phrase macros. The specific question on the mailing list was about pulling user information from a database, so that's where I decided to start.

NOW WHAT?
I've read about it, I've heard people talk about it, I know lots of people who use it, but I've never done it myself, so the first question I had to answer is this: what do I do first? Well, the specific question was about pulling user information from a database, so I decided the first thing to do would be to look at the sample XML files in the default configuration to get an idea of what kind of XML config stuff I would need to generate and send back to FreeSWITCH. I also poked around in the contrib folder to see what others had done. Finally, I consulted the oft-maligned but generally underappreciated FreeSWITCH wiki. Amazingly, with just these meager resources I was able to get a POC working in just a few hours. Now mind you, I did this in my spare time while avoiding my wife and kids, and with limited resources. (I don't have a stack of VoIP phones on my home LAN like some of you people do.)

BTW, I'm not a Web-programming guru, nor am I a database admin. I'm familiar with these from having tinkered with some LAMP setups. I'm decent with Linux, decent with Apache, decent with MySQL, and somewhat advanced with Perl. Small problem: I don't have MySQL on my laptop which is where I needed to run everything. However, I had installed PostgreSQL version 8.3 for another project. I know almost nothing about PG. Fortunately, I had Mr. William King (quentusrex on IRC - #freeswitch on irc.freenode.net) around and he gave me a few pointers. ("In MySQL I did it this way, how do I do that in PG?") A tip o' the cap to him. So at this point I was all set.

My configuration at the start looked like this:
MacBook Pro with OS X Leopard
Latest SVN of FreeSWITCH
Apache 2.2
Perl 5.8.8
PostgreSQL 8.3

So the first thing I decided to do was create a new database in PG, then create a users table. With William's help and the handy pgadmin3 program I was in business. For kicks, I went back to my table and added an extra column: context. I didn't need this column but I thought it would be a nice little exercise to add this value for each user even though I would usually just want "default" for the context. My table ended up looking like this:

CREATE TABLE users (
uid bigserial NOT NULL,

lastname character varying(15),
firstname character varying(15),
username character varying(11) NOT NULL,
mailbox character varying(11) NOT NULL,
"password" character varying(11) NOT NULL,
context character varying(11) DEFAULT 'default'::character varying,
CONSTRAINT users_pk PRIMARY KEY (uid)
)

Here's a nice little pic of the data I put in there thanks to the "edit data" widget in pgadmin3:

I put first and last names in separate fields because I figured that would be common in a real world scenario. I have the username field which is what I'm kinda using for everything: userid, auth. username and username. (Yeah, I'm cheating, get over it.) I have also a password and a context field. That's it. At this point I was feeling confident. I had the database, a users table, a login role for accessing the database, and a little momentum on my side.

Now I needed to decide which task to handle next: handling the CGI call or figuring out how to query the database. I decided to tackle what I felt was the tougher of the two: handling the xml_curl call and returning information that FreeSWITCH could use. It turns out that it wasn't actually all that tough: I opened up conf/autoload_configs/xml_curl.conf.xml and found this near the top:

<!-- The url to a gateway cgi that can generate xml similar to what's in this file only on-the-fly (leave it commented if you dont need it) -->
<!-- one or more |-delim of configuration|directory|dialplan -->
<!-- <param name="gateway-url" value="http://www.freeswitch.org/gateway.xml" bindings="dialplan"/> -->


I'm no genius but to me that's pretty clear information: I needed a 'binding' for directory. For kicks I left in the 'directory' binding as well. I ended up with this:

<param name="gateway-url" value="http://127.0.0.1/cgi-bin/xmlcurl_sample.pl" bindings="directory|dialplan"/>

I saved everything, started up FS and promptly realized that I didn't actually build mod_xml_curl. No worries. A quick trip to the FS source directory did the trick:

cd /usr/src/freeswitch.trunk
make mod_xml_curl-install

Gotta love FreeSWITCH - way easy. (I added mod_xml_curl to modules.conf and modules.conf.xml so that it would auto build and auto load, respectively.) I loaded up mod_xml_curl and saw no errors or warnings. I saw that it added a new app named "xml_curl" so I looked at the syntax. (Just type 'xml_curl help' to see the syntax.) Basically it just allows you to turn on debug for xml_curl, which dumps a copy of the information returned from the webserver when xml_curl makes a call. The FS CLI shows the file name and path when it creates this debug file.

The next order of business was to observe what my CGI script would see in terms of information coming from xml_curl. Ah Perl, my lovely Swiss-army chainsaw. That was easy:

#!/usr/bin/perl
#
# xmlcurl_sample.pl
#
use strict;
use warnings;
use Data::Dump qw(dump); # I prefer this to Data::Dumper
use CGI.

my $q = CGI->new;
open(FILEOUT,'>','/tmp/cgidump.txt'); ## look in this file to see what's up
print FILEOUT dump($q);
close(FILEOUT);

But where to put this lovely file? I poked around to find my default Apache configs and it turns out that there's an alias for "cgi-bin" so that's where I put my Perl script to handle the CGI call. That's it. Now I can see what's coming in. All I need to do is make a phone call or have a user try to register to FS. (Recall that I set up an xml_curl binding for both 'directory' and 'dialplan'.) Dialing out was easier since I didn't have a phone handy. Naturally since my script didn't return anything useful there were errors on the FS CLI, but I was more interested in what was in my cgidump.txt file:

bless({
".charset" => "ISO-8859-1",
".fieldnames" => {},
".parameters" => [
"hostname",
"section",
"tag_name",
"key_name",
"key_value",
"Event-Name",
"Core-UUID",
"FreeSWITCH-Hostname",
"FreeSWITCH-IPv4",
"FreeSWITCH-IPv6",
"Event-Date-Local",
"Event-Date-GMT",
"Event-Date-Timestamp",
"Event-Calling-File",
"Event-Calling-Function",
"Event-Calling-Line-Number",
"Channel-State",
"Channel-State-Number",
"Channel-Name",
"Unique-ID",
"Call-Direction",
"Presence-Call-Direction",
"Answer-State",
"Channel-Read-Codec-Name",
"Channel-Read-Codec-Rate",
"Channel-Write-Codec-Name",
"Channel-Write-Codec-Rate",
"Caller-Dialplan",
"Caller-Caller-ID-Name",
"Caller-Caller-ID-Number",
"Caller-Network-Addr",
"Caller-Destination-Number",
"Caller-Unique-ID",
"Caller-Source",
"Caller-Context",
"Caller-Channel-Name",
"Caller-Screen-Bit",
"Caller-Privacy-Hide-Name",
"Caller-Privacy-Hide-Number",
"variable_channel_name",
"variable_endpoint_disposition",
"variable_read_codec",
"variable_read_rate",
"variable_write_codec",
"variable_write_rate",
"variable_zrtp_secure_media",
"variable_playback_seconds",
"variable_playback_ms",
"variable_playback_samples",
"variable_current_application_data",
"variable_current_application",
"Hunt-Dialplan",
"Hunt-Caller-ID-Name",
"Hunt-Caller-ID-Number",
"Hunt-Network-Addr",
"Hunt-Destination-Number",
"Hunt-Unique-ID",
"Hunt-Source",
"Hunt-Context",
"Hunt-Channel-Name",
"Hunt-Screen-Bit",
"Hunt-Privacy-Hide-Name",
"Hunt-Privacy-Hide-Number",
],
"Answer-State" => ["answered"],
"Call-Direction" => ["inbound"],
"Caller-Caller-ID-Name" => ["FreeSWITCH"],
"Caller-Caller-ID-Number" => ["0000000000"],
"Caller-Channel-Name" => ["portaudio/9999"],
"Caller-Context" => ["features"],
"Caller-Destination-Number" => ["is_zrtp_secure"],
"Caller-Dialplan" => ["XML"],
"Caller-Network-Addr" => ["192.168.1.110"],
"Caller-Privacy-Hide-Name" => ["false"],
"Caller-Privacy-Hide-Number" => ["false"],
"Caller-Screen-Bit" => ["true"],
"Caller-Source" => ["mod_portaudio"],
"Caller-Unique-ID" => ["718c69cd-48cf-4701-90b1-ab2e471cfb6d"],
"Channel-Name" => ["portaudio/9999"],
"Channel-Read-Codec-Name" => ["L16"],
"Channel-Read-Codec-Rate" => [8000],
"Channel-State" => ["CS_EXECUTE"],
"Channel-State-Number" => [4],
"Channel-Write-Codec-Name" => ["L16"],
"Channel-Write-Codec-Rate" => [8000],
"Core-UUID" => ["9b4e5fe9-9bc9-4bed-915a-3c277cbd760b"],
"Event-Calling-File" => ["mod_dialplan_xml.c"],
"Event-Calling-Function" => ["dialplan_xml_locate"],
"Event-Calling-Line-Number" => [368],
"Event-Date-GMT" => ["Thu, 29 Oct 2009 05:18:05 GMT"],
"Event-Date-Local" => ["2009-10-28 22:18:05"],
"Event-Date-Timestamp" => ["1256793485008872"],
"Event-Name" => ["REQUEST_PARAMS"],
"FreeSWITCH-Hostname" => ["michael-collinss-macbook-pro.local"],
"FreeSWITCH-IPv4" => ["10.15.0.136"],
"FreeSWITCH-IPv6" => ["::1"],
"Hunt-Caller-ID-Name" => ["FreeSWITCH"],
"Hunt-Caller-ID-Number" => ["0000000000"],
"Hunt-Channel-Name" => ["portaudio/9999"],
"Hunt-Context" => ["features"],
"Hunt-Destination-Number" => ["is_zrtp_secure"],
"Hunt-Dialplan" => ["XML"],
"Hunt-Network-Addr" => ["192.168.1.110"],
"Hunt-Privacy-Hide-Name" => ["false"],
"Hunt-Privacy-Hide-Number" => ["false"],
"Hunt-Screen-Bit" => ["true"],
"Hunt-Source" => ["mod_portaudio"],
"Hunt-Unique-ID" => ["718c69cd-48cf-4701-90b1-ab2e471cfb6d"],
"Presence-Call-Direction" => ["inbound"],
"Unique-ID" => ["718c69cd-48cf-4701-90b1-ab2e471cfb6d"],
escape => 1,
hostname => ["michael-collinss-macbook-pro.local"],
key_name => [""],
key_value => [""],
section => ["dialplan"],
tag_name => [""],
"variable_channel_name" => ["portaudio/9999"],
"variable_current_application" => ["execute_extension"],
"variable_current_application_data" => ["is_zrtp_secure XML features"],
"variable_endpoint_disposition" => ["ANSWER"],
variable_playback_ms => [0],
"variable_playback_samples" => [0],
"variable_playback_seconds" => [0],
variable_read_codec => ["L16"],
variable_read_rate => [8000],
variable_write_codec => ["L16"],
variable_write_rate => [8000],
"variable_zrtp_secure_media" => ["true"],
}, "CGI")


Looking closely you can probably guess that I just used the pa (portaudio) command to dial 9999. I was in business! That's all for part 1 of this subject.

To recap: I thought I would try setting up a proof-of-concept script for using mod_xml_curl in FreeSWITCH. I already had Apache, Perl, and PostgreSQL installed on my laptop, and the latest FreeSWITCH SVN. I configured xml_curl.conf.xml to call my CGI script: xmlcurl_sample.pl. I did a very simple data dump of the params sent into the script from xml_curl. This allowed me to verify that communications from xml_curl to my CGI script were functional.

In part 2 I'll talk about sending a response back to the server and setting up the DBI to query a database.