About

These docs are BARE minimum to allow Freeswitch to compile. It will use the default compiler on your platform unless you override it with CC and CXX variables prior to configure. None of the extra hoops need to be jumped through any longer. It should just WORK out of the box and we can address any specific issues as they come up. Anyone wishing to help improve this updated documentation please email brian@freeswitch.org or contact bkw_ on IRC,

Maintainer Needed

We need YOU to maintain this port of FreeSWITCH. Please contact one of the FreeSWITCH core developers on Freenode IRC channel #freeswitch or the freeswitch-users@lists.freeswitch.org mailing list to help them keep the code current for this operating system.

Build Environment

This is part of the Installation documentation which you should review first. It provides notes unique to FreeBSD 10.2. If you're on FreeBSD it will default to using clang. If you want to force it, export CC=`which clang` and export CXX=`which clang++` or if you prefer, use gcc and g++. The following will build the default modules.conf, and additional modules you wish to enable may require more dependencies. To enable or disable modules edit modules.conf file and comment or uncomment modules with #. This build procedure is tested on FreeBSD 11.2:

FreeSWITCH Master

pkg install autoconf automake curl git gmake jpeg-turbo ldns libedit libtool openssl pcre pkgconf speex sqlite3 wget sudo libsndfile lua52 opus tiff
cd /usr/local/src/;
git clone https://freeswitch.org/stash/scm/fs/freeswitch.git

cd freeswitch
./bootstrap.sh -j
./configure 
gmake
sudo gmake install cd-sounds-install cd-moh-install

If you get gmake error stating no-extended-offsetof, then execute code below and run ./configure again:

sed -i' ' -e s:'-Wno-extended-offsetof:-Wno-invalid-offsetof -Wunknown-warning-option:' Makefile;
sed -i' ' -e s:'-Wno-extended-offsetof:-Wno-invalid-offsetof:' configure;

If you want to change directory prefix, enable Postgresql support, use configure like this (taken from FuxionPBX build script):

pkg install postgresql10-server postgresql10-client sudo;

#Initialize database
sudo sysrc postgresql_enable="YES";
sudo service postgresql initdb;
sudo service postgresql start;
sudo -u postgres psql -c "SELECT version();";
sudo -u postgres psql -c "CREATE DATABASE freeswitch;";
sudo -u postgres psql -c "CREATE USER fsuser with encrypted password 'fspass';";
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE freeswitch to fsuser;";

./configure --prefix=/usr/local/freeswitch --disable-dependency-tracking --enable-core-pgsql-support --disable-fhs;

If you want to enable mod_av you need to install libav and mp4v2 packages:

pkg install autoconf automake curl git gmake jpeg-turbo ldns libedit libtool openssl pcre pkgconf speex sqlite3 wget sudo libsndfile lua52 opus tiff libav mp4v2;
cd /usr/local/src/;
git clone https://freeswitch.org/stash/scm/fs/freeswitch.git

cd freeswitch
./bootstrap.sh -j
./configure 
gmake
sudo gmake install cd-sounds-install cd-moh-install

To fix building mod_av with deprecated functions edit mod_av Makefile:

vi /usr/local/src/freeswitch/src/mod/applications/mod_av/Makefile
# edit CFLAGS lines and add -Wno-deprecated-declarations:
 
AVCODEC_CFLAGS = -I/usr/local/include -Wno-deprecated-declarations
AVFORMAT_CFLAGS = -I/usr/local/include -Wno-deprecated-declarations
AVRESAMPLE_CFLAGS = -I/usr/local/include -Wno-deprecated-declarations
AVUTIL_CFLAGS = -I/usr/local/include -Wno-deprecated-declarations

FreeSWITCH 1.6

pkg install autoconf automake curl git gmake jpeg ldns libedit libtool openssl pcre pkgconf speex sqlite3 wget sudo
cd /usr/local/src/;
git clone -b v1.8.7 https://freeswitch.org/stash/scm/fs/freeswitch.git

cd freeswitch
./bootstrap.sh -j
./configure 
gmake
sudo gmake install cd-sounds-install cd-moh-install

FreeSWITCH 1.8.7

pkg install autoconf automake curl git gmake jpeg ldns libedit libtool openssl pcre pkgconf speex sqlite3 wget sudo
cd /usr/local/src/;
git clone -b v1.8.7 https://freeswitch.org/stash/scm/fs/freeswitch.git

cd freeswitch
./bootstrap.sh -j
./configure 
gmake
sudo gmake install cd-sounds-install cd-moh-install

FreeBSD rc.d script

The default installation comes with an rc-script but it doesn't meet the requirements of the FreeBSD rc.d framework. I've created (or actually copy/pasted it from Postfix) a script that does meets the rc.d requirements. Create the example below in /usr/local/etc/rc.d and give it the name 'freeswitch'

/usr/local/etc/rc.d/freeswitch

rc.d/freeswitch

#!/bin/sh
#
# PROVIDE: freeswitch
# REQUIRE: LOGIN cleanvar
# KEYWORD: shutdown
#
# Add the following lines to /etc/rc.conf to enable freeswitch:
# freeswitch_enable:       Set it to "YES" to enable freeswitch.
#                          Default is "NO".
# freeswitch_flags:        Flags passed to freeswitch-script on startup.
#                          Default is "".
#
. /etc/rc.subr
name="freeswitch"
rcvar=${name}_enable
load_rc_config $name
: ${freeswitch_enable="NO"}
: ${freeswitch_pidfile="/usr/local/freeswitch/run/freeswitch.pid"}
start_cmd=${name}_start
stop_cmd=${name}_stop
pidfile=${freeswitch_pidfile}
freeswitch_start() {
        /usr/local/freeswitch/bin/freeswitch ${freeswitch_flags}
		echo -n "Starting FreeSWITCH: "
}
freeswitch_stop() {
        /usr/local/freeswitch/bin/freeswitch -stop
}
run_rc_command "$1"

After creating the file it's time to change the permissions, otherwise it can't be executed. Go to /usr/local/etc/rc.d and issue the following command

chmod u-w,ugo+x freeswitch

Now it's time for calling the script from /etc/rc.conf. Put the two line below in the rc.conf file. The first one executes the startup script itself, the second one pipes the parameters.

freeswitch_enable="YES"
freeswitch_flags="-nc"

In this example FreeSWITCH™ gets started with the parameters -nc (no console, you can access the console later using fs_cli). If your Freeswitch server has a IP address and not behind a NAT router, add the "-nonat" parameter (This will disable NAT traversal feature of FreeSWITCH). After a reboot you should see something like this in your console:

10381 Backgrounding.

Page tree

About

Build Environment

FreeBSD rc.d script

5 Comments

Nicholas Schoonover

sean

John Boteler

Kim Culhan

Eric Masson