How to configure FOP2 to work with FreeSWITCH

Since FOP2 version 2.3 there is alpha support for freeswitch using ESL. Installation process is similar to an Asterisk install, but it will require some manual work for adding your extensions/conference and queues buttons.

Prerequisites

You must have all the LAMP components on the server, that is you must install MySQL, PHP and Apache or a compatible web server.

Installation

FOP2 must be installed on the same server as FreeSWITCH. Download the corresponding tarball for your distro, extract it and run "make", as any regular installation.

Server configuration

Once the software is installed, you will have to configure it. In /usr/local/fop2/fop2.cfg you will have to comment the following lines by prefixing them with a semicolon:

;manager_user=localhost
;manager_secret=amp111
;manager_port=5038
;manager_host=localhost

You will have to add the FreeSWITCH connetion counterparts:

freeswitch_secret=ClueCon
freeswitch_host=localhost
freeswitch_port=8021

You can test the configuration and ESL connection with the command:

You will also need to create a MySQL database:

And be sure to create a MySQL user that has all privileges over that database:

Once you have that created, be sure the MySQL credentials in configuration files match the user and password you selected on the GRANT line above, look for the files /var/www/html/fop2/config.php and /var/www/html/fop2/admin/config.php and set the credentials in both of them:

$DBHOST = 'localhost';
$DBNAME = 'fop2';
$DBUSER = 'fop2';
$DBPASS = 'fop2pw';

Finally run this script to create all required tables:

The server configuration part is done, now you will need to configure your buttons.

Button configuration

As FreeSWITCH is so vast and open, there is no way to 'detect' your button configuration automatically in a universal way.  

The FOP2 Manager can be modified to read your button configuration from whatever store you might use, by changing the functions-custom.php file. You will have to read it to have a basic understanding on the modifications you might need to perform.

A simpler way, without programming involved, is to configure your buttons manually. You can do so by editing the file /usr/local/fop2/buttons_custom.cfg. Here is an example of some button definitions that will work with FreeSWITCH:  

[SOFIA/INTERNAL/1000]
type=extension
label=Maria
extension=1000
context=192.168.1.1
originatechannel=sofia/internal/1000%192.168.1.1
queuechannel=Maria@192.168.1.1

[CONFERENCE/6000]
type=conference
label=Conference
extension=6000
context=internal

[QUEUE/Support@192.168.1.1]
type=queue
label=Support
extension=5000
context=internal

Supported queue buttons are for the use by mod_callcenter only.

User and preferences configuration