Download & Installation Guide

From FreeSWITCH Wiki

Contents 1 Introduction 2 Operating Systems 2.1 Linux and Unix 2.2 Mac OS X 2.3 Windows 3 Preparation 3.1 Directory Permissions 4 Source Options 4.1 Recommended: Git 4.1.1 Reverting to an Earlier Commit in Git 4.1.2 Revert only certain commit 4.1.3 freeswitch-contrib 5 Compiling and Installation 5.1 Switch to the src/freeswitch Directory 5.2 Installed from Git 5.3 Configure for Compilation 5.4 Edit modules.conf 5.5 Compile and Install 5.6 Compile and Install Sounds 5.7 Ready to Test! 6 Upgrading and Re-installation 6.1 Updating the Source 6.2 Rebuilding 6.3 Upgrading on-the-fly 7 Troubleshooting 7.1 Compile Errors 7.2 Compiling 32 bit on 64 bit Systems 8 Common Prerequisites 8.1 Mandatory 8.2 Optional 9 Distribution Information and Installation 9.1 Arch Linux 9.2 CentOS 9.2.1 YUM Based Installation 9.2.2 Prerequisites 9.2.3 Automatic Startup At Boot 9.2.4 Installation 9.2.5 Release(es) 6 and Later 9.3 Debian 9.3.1 Prerequisites 9.3.2 Installation 9.4 Ubuntu 10.04 LTS 64bit 9.5 Ubuntu 11.10 64bit 9.6 Ubuntu 12.04 LTS 64bit 9.7 Fedora 9.8 FreeBSD 9.8.1 Threading Library 9.8.2 FreeBSD rc.d script 9.9 Gentoo Linux 9.10 openSUSE 9.10.1 Prerequisites 9.10.2 Installation 9.11 pfSense package with GUI 9.12 Red Hat Enterprise Linux 9.13 Solaris 9.13.1 OpenSolaris Nevada 9.13.2 OpenSolaris os200906 9.14 Ubuntu 9.15 Cross Compiling for ARM on Linux 9.16 Cross Compiling for OpenWrt 10 Prebuilt Binaries 10.1 Ubuntu Packages 11 Special Considerations 11.1 ODBC Support 11.1.1 ODBC Installed in non-standard locations 11.2 No Root Access 12 Graphical User Interfaces

Introduction

FreeSWITCH™ is available for source compilation on Unix and Linux distributions as well as Windows. Prebuilt binaries are available for installation on some Linux and Unix distributions as well as Windows.
NOTE: If you're new to FreeSWITCH™ consider purchasing the FreeSWITCH™ book and be sure to read this introductory article: http://www.linuxpromagazine.com/Issues/2009/106/TALK-SOFT.

Operating Systems

Linux and Unix

This page is dedicated to Linux and Unix distributions. Everything required to download and install FreeSWITCH™ can be found below. Experienced Linux users may want to check the Linux Quick Install Guide.

Mac OS X

Mac OS X is based on BSD Unix so much of the information in this document applies to OS X. However, the comprehensive Installation and Tips for Mac OS X guide has detailed installation steps and tips for setting up a 24x7 Mac.

Windows

Information for source and binary installation is found at Installation for Windows which also contains quick start information. Very little information on this page applies to Windows other than the Source Options.

Preparation

Directory Permissions

FreeSWITCH™ can be placed in any directory. However, for Unix and Linux source is typically installed in usr/local/src/freeswitch and binaries in /usr/local/freeswitch. Some systems drop local and use usr/src. These directories are usually root protected after initial OS installation. You should change the owner and group so that root is not needed for installation or execution of FreeSWITCH. You should create and set permissions on /usr/local/freeswitch in this fashion:

Source Options

 

FreeSWITCH™ can be downloaded from multiple locations, which one depends on the level of stability or how up-to-date fixes are required. The best method to download the Git source is via Git. The examples in this document use Git.

Recommended: Git

Git provides access to the latest features and bug fixes added throughout the day. Most often you will only use the "clone" and "pull" commands. There is an excellent Online Git Book available in multiple languages. For help installing Git see Git_Install. The following creates a freeswitch directory and downloads a "clone" of the current source:

cd /usr/local/src
git clone git://git.freeswitch.org/freeswitch.git

Note: git reset --hard <commit_id> - will revert all local changes and reset the working copy to the specified commit.

Reverting to an Earlier Commit in Git

Sometimes when things go terribly wrong with the latest commits (regression-type bugs), you can always revert to an earlier commit with git. Simply type in:

git checkout <revhash>

Where <revhash> is the hash of an earlier commit. You can find the commit hashes here. To go back to the latest commit, simply type in

git checkout master

After the reversion, it is strongly recommended that you (in the following order):

• Report the issue to the FreeSWITCH JIRA
• Run 'git clean -d -f -x' on the root directory of the sources of FreeSWITCH
• Re-bootstrap the code
• Re-run the configure process

... before you re-build the code from an earlier revision.

Revert only certain commit

To reverse only the one commit change on newer build

git log -1 -p <revhash> | patch -p1 -R

freeswitch-contrib

Contributed source is obtained from the freeswitch-contrib tree as follows (this will compile and install updates):

 git clone git://git.freeswitch.org/freeswitch-contrib.git

Sample configs can be downloaded as well:

git clone git://git.freeswitch.org/freeswitch-sample-configs.git

The Latest Build site latest.freeswitch.org is currently empty.

Compiling and Installation

Ensure that the required prerequisites are installed. Also check if there are notes for your distribution in Distribution Information and Installation.

Switch to the src/freeswitch Directory

The remaining commands are executed from the directory containing the FreeSWITCH™ source (use whatever directory the source is located in):

cd /usr/local/src/freeswitch

Installed from Git

If Git was used to download, the configuration files must be built before the first compile. ./bootstrap.sh creates many files including modules.conf. Once this is performed it's not normally required to be performed again:

 ./bootstrap.sh

You can use multiple cores for your bootstrap/config/build, by specifying it at the start, e.g.: (note this may make build errors harder to spot)

 ./bootstrap.sh -j4

Configure for Compilation

./configure sets compilation options. Invoke the following command to configure for compilation:

./configure

You can have the checks cached for each module, by using:

./configure -C

If you want to install FreeSWITCH to a non-standard location you can simply append the --prefix option to the configure script as shown in this example:

./configure --prefix=<example of non standard location>

Edit modules.conf

The modules.conf file contains the list of modules to be compiled, some are commented as they are not required. As your FreeSWITCH™ configuration becomes more complex additional modules may be required. If you plan to test the sample IVR after installation, FLITE must be added to the compile as follows:

1. Use an editor to navigate to and edit /usr/local/src/freeswitch/modules.conf (or whatever directory it was placed into)
2. Search for "flite" and remove the # to uncomment.
3. Save the file.

If this is your first experience with FreeSWITCH™ don't add more than FLITE. Adding functions may result in additional prerequisites that must be installed.

Compile and Install

Invoke the following commands to compile and create the binaries:

make && make install

Note: "make install" does not overwrite existing configuration files in freeswitch/conf if a freeswitch.xml file already exists in conf.

Compile and Install Sounds

There are IVR sound prompts and music on hold files that are optional but must be compiled and installed to run the sample IVR. There are four versions available:

• sounds-install moh-install (8 kHz)
• hd-sounds-install hd-moh-install (16 kHz)
• uhd-sounds-install uhd-moh-install (32 kHz)
• cd-sounds-install cd-moh-install (48 kHz)

The cd sounds are recommended since all the sampling rates are provided resulting in fewer problems. Invoke the following command:

 make all cd-sounds-install cd-moh-install

Ready to Test!

Switch to the freeswitch/bin directory and try some stuff! When you're done read the Getting Started Guide to learn how to configure FreeSWITCH™.

cd /usr/local/freeswitch/bin
./freeswitch

Upgrading and Re-installation

Updating the Source

If FreeSWITCH™ was previously installed using a Git based installation, and only a clean update to the latest tree is required, issue this command:

make current

The make current command will clean your build environment, do a git pull, and then do a make install for you.

Rebuilding

After doing a "git pull" or changing source files, it may be desirable to clean out your build area:

make clean modwipe

Alternatively, you can execute "make current" which will handle the git pull, clean up, and rebuild in one step:

make current

 

To check if there are any new modules execute:

diff build/modules.conf.in modules.conf

If a previously disabled module is now enabled, or there is a requirement to rebuild a single module, execute the following (replace mod_name with the name of the module to build):

 make mod_name-install

Upgrading on-the-fly

 

However it can be done by following these steps below:

After recompilation while FS is still running you can still install:

make install

Note, this will automatically install, and it even first cleans the build dir and the installation dir, which should even work while FS is running, provided no modules are reloaded or loaded:

make current

To make the changes of the new build take effect, FS has to be restarted:

/usr/local/freeswitch/bin/fs_cli -x shutdown elegant restart

This will wait for all traffic to end, yet still allow new traffic. If you want to restart as soon as possible, you can use:

/usr/local/freeswitch/bin/fs_cli -x shutdown asap restart

This will restart FS as soon as there is no more traffic and it will not allow any new traffic to make this happen as soon as possible.

If you want a faster rebuild, you can make use of make's dependency system. Note that this will not make the version command reflect the actual git revision, as the modules making use of it will not be rebuild if there is no change of them in the git tree.

make sync all install

 

To always reflect the actual git version and revision in every module, there should be a function switch_core_get_version() which would be in an object always rebuilt and giving the actual version in return. So far a preprocessor variable is used.

Troubleshooting

Compile Errors

If you encounter compile errors or other bugs be sure to test it again with the latest Git version, then file a bug report at http://jira.freeswitch.org or email freeswitch-dev@lists.freeswitch.org (we prefer that you use Jira so that we can track all issues). Remember FreeSWITCH™ development is always ongoing and requires contributions from everybody.

Compiling 32 bit on 64 bit Systems

To compile a 32-bit binary on a 64-bit system:

CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 ./configure

Common Prerequisites

Mandatory

These mandatory prerequisites provide for compiling the standard FreeSWITCH™ installation and test the supplied configuration and sample IVR. They are sufficient for many production systems.

• GIT or WGET
• AUTOCONF
• AUTOMAKE
• GAWK
• GCC-C++
• LIBJPEG-DEVEL Used by mod_spandsp for basic codecs
• LIBTOOL
• MAKE
• NCURSES-DEVEL

Optional

There are optional modules that can be built and if so may require one or more of the following;

• curl-devel for mod_xml_curl
• expat-devel
• GnuTLS for Dingaling
• libtiff for fax support
• libx11-devel for mod_skypopen
• ODBC or UNIX-ODBC and ODBC-devel see the ODBC page for information
• OpenSSL for SIP SSL & TLS
• python-devel for the python interface
• ZLIB and ZLIB-devel
• libzrtp ZRTP encryption support, see the FreeSWITCH™ ZRTP page

Distribution Information and Installation

Arch Linux

Arch Linux uses the pacman package manager. it also has a ports-like build system called Arch Build System.

To build FreeSWITCH from the latest git, you use the freeswitch-git package. This package is documented on the Arch Linux Wiki

The packages for FreeSWITCH™ stable release (and the zaptel dependency for mod_openzap) are available at the AUR repository:

• Zaptel
• FreeSWITCH

To build these packages follow the instructions of the Makepkg build system.

Alternatively, if you have an AUR helper installed, you may install with

   packer -S freeswitch-git

   yaourt -S freeswitch-git

CentOS

Tested Nov 26, 2010 with CentOS 5.5 x86_64
There were no issues during installation and testing other than EPEL requirements.

YUM Based Installation

FreeSWITCH is now available via yum. You will need to add the FreeSWITCH yum repository

To install the FreeSWITCH Repo

 rpm -Uvh http://files.freeswitch.org/yum/freeswitch-release-1-0.noarch.rpm

Then to install FreeSWITCH with the generic vanilla example configs

 yum install freeswitch-config-vanilla

This will give you a base working FreeSWITCH. At the time of this update (2012-FEB-13) these RPMs are Beta but should be working fine. Please report any bugs in them via JIRA

Prerequisites

Installation of Git required adding the EPEL repository to obtain Git. For EPEL information visit the EPEL site, The EPEL repository is added with 1 click.
Use the yum package manager tool or Add/Remove Applications menu function to add the following packages to a basic installation:

• autoconf
• automake
• gcc-c++
• git-core
• libjpeg-devel
• libtool
• make
• ncurses-devel

 yum install autoconf automake gcc-c++ git-core libjpeg-devel libtool make ncurses-devel pkgconfig

To install the optional packages needed to enable all FreeSWITCH modules to be built:

 yum install unixODBC-devel openssl-devel gnutls-devel libogg-devel libvorbis-devel curl-devel libtiff-devel libjpeg-devel python-devel expat-devel zlib zlib-devel bzip2 which

Automatic Startup At Boot

To get FreeSWITCH to start up automatically at system start, just copy the FreeSWITCH init script into the /etc/init.d directory. An example init script is included in the git repository, under the build directory, named as freeswitch.init.redhat. You may need to modify the script to get FreeSWITCH starting up from the directory where the binaries are installed. After the file has been modified to suit your needs, simply run this command:

 chkconfig --add freeswitch && chkconfig --levels 35 freeswitch on

This procedure will also work exactly the same way on Fedora systems.

Installation

Continue with the normal installation steps or the Linux Quick Install Guide Downloads section.

Release(es) 6 and Later

A change by Red Hat in RHEL 6 and later releases was to compile the kernel to run tickless by default. As previously brought up on the mailing lists, it is recommended that the kernel's tickless feature should be disabled for optimum performance when running FreeSwitch under the newer operating system's kernel. You can disable the tickless feature by appending nohz=off to your boot options under GRUB. The GRUB start up configuration file is located under /boot/grub or as /etc/grub.conf. This is also applicable to Fedora releases 8 and later.

Also, when using release 6 and later, make sure to configure with "./configure --without-pgsql", this is to make sure that FreeSWITCH uses it's own curl library, instead of the system provided, and that it doesn't try to use the system provided postgresql libs. If using the system provided versions linking errors will occur. Hopefully this will be auto detected in a near future. Related Jira issues are: FS-3384, FS-3630, FS-3384 and FS-3393.

Debian

Tested Nov 27, 2010 with Debian 5.0 AMD64
There were no issues during installation and testing. Benefits from a custom kernel with "CONFIG_HZ_1000=y" and "CONFIG_HZ=1000" defined to avoid performance issues. Follow Debian guidelines [1].

Prerequisites

There are a variety of Debian package manager tools such as dpkg, apt, aptitude, and synaptic. The synaptic GUI tool was used for this installation. The System menu Add/Remove Applications function does not offer the required packages, Add the following to a basic Debian installation:

• autoconf
• automake
• gawk (mawk does not work)
• g++
• git-core
• libjpeg62-dev
• libncurses5-dev
• libtool
• make
• python-dev
• pkg-config
• gnutls-bin

 apt-get install autoconf automake g++ git-core libjpeg62-dev libncurses5-dev libtool make python-dev gawk pkg-config gnutls-bin

Installation

Continue with the normal installation steps or the Linux Quick Install Guide Downloads section.

Ubuntu 10.04 LTS 64bit

Tested Dec 23, 2010 with Ubuntu
There were no issues during installation and testing.

Ubuntu 11.10 64bit

Tested Oct 14, 2011 with Ubuntu
Tested Oct 26, 2011 with Ubuntu
The default awk is now mawk and not gawk. Gawk must be installed to compile successfully. Changes in the default GCC toolchain behavior may require other tweaks like the ones described here.

For the latest git head (2011/10/26), libz and pkg-config, are dependencies that were required to build properly. libjpeg-dev is required for spandsp

 apt-get install git-core build-essential autoconf automake libtool libncurses5 libncurses5-dev gawk libjpeg-dev libz-dev pkg-config

Note: If you receive errors in libs/iksemel complaining of an expected ")" this may point to the pkg-config package not being installed. After installing pkg-config you will need to bootstrap the environment again to expand the proper aclocal macros.

To resolve the dependency on gawk, the system awk link was updated to point to gawk using the following command

 update-alternatives --set awk /usr/bin/gawk

Ubuntu 12.04 LTS 64bit

Tested May 2, 2012 with Ubuntu
The default awk is now mawk and not gawk. Gawk must be installed to compile successfully. Changes in the default GCC toolchain behavior may require other tweaks like the ones described here.

For the latest git head (2012/05/02), libz (included in zlib1g-dev), pkg-config, and libssl-dev are dependencies that were required to build properly. libjpeg-dev is required for spandsp.

 sudo apt-get install git-core build-essential autoconf automake libtool libncurses5 libncurses5-dev gawk libjpeg-dev zlib1g-dev pkg-config libssl-dev

To resolve the dependency on gawk, the system awk link was updated to point to gawk using the following command

 sudo update-alternatives --set awk /usr/bin/gawk

Fedora

Tested Nov 12, 2011 with Fedora 16 x86_64
Most modules under Fedora 16 compiles without too much issues with the latest git

On Fedora 14 systems the following may happen:

At this time, the spidermonkey part of compilation fails with many errors such as:

 "jsapi.c: src/jstypes.h no suitable type for jsint8/JSUint8"
 "Fatal error: can't create src/.libs/jsapi.o: permission denied"

Two days of time could not resolve this issue. When it is this will be updated. This is apparently a problem that started with other packages and distributions starting October 2010.

FreeBSD

STOP: If you install using the traditional method (git clone/bootstrap/configure/compile) you MUST use gmake. freeswitch will not compile correctly using BSD make.

Tested Nov 30, 2010 with FreeBSD 8.1 (i386)
Tested Mar 22, 2011 with FreeBSD 8.2-RELEASE (amd64)
Tested Jan 12, 2012 with FreeBSD 9.0-RELEASE (i386)
There were no issues during installation and testing, when building from Git source.

Installing via FreeBSD ports collection (TESTING ONLY!): This way all dependencies are downloaded and installed automatically. Currently this port uses freeswitch-1.0.6.tar.gz and not the latest git. For GIT see below. This port is maintained by user rneese on #freeswitch and #fusionpbx

 portsnap fetch update
 cd /usr/ports/net/freeswitch-core
 make config (enable/disable the modules you need)
 make install clean

Installing FreeBSD dependencies: AUTOCONF, AUTOMAKE, GCC, GIT, GMAKE, GNUMAKE (installed automatically as a dependency to autoconf), GLIBTOOL, LIBNCURSES, WGET. LIBJPEG is needed for mod_spandsp (installation instructions needed)

 pkg_add -r autoconf262
 pkg_add -r gcc34
 pkg_add -r automake19
 pkg_add -r git
 pkg_add -r gmake
 pkg_add -r libtool
 pkg_add -r ncurses
 pkg_add -r wget
 pkg_add -r pkg-config

Get source with Git

cd /usr/src
/usr/local/bin/git clone  git://git.freeswitch.org/freeswitch.git freeswitch-upstream
cd freeswitch-upstream

Build Process After downloading the source with git or with wget

./bootstrap.sh

Edit modules.conf to enable or disable desired modules.

Make sure you are using gmake and not make, it does not build properly with make at the moment on FreeBSD:

./configure
gmake install
gmake samples
gmake sounds-install
gmake moh-install
gmake hd-sounds-install
gmake hd-moh-install

Quick note on installations requiring spandsp and failing because of libtiff (On FreeBSD):

1. Install tiff from ports.

pkg_add -r tiff

2. Bash

export LDFLAGS=-L/usr/local/lib ; export CPPFLAGS=-I/usr/local/include

Or other shells.

setenv LDFLAGS -L/usr/local/lib
setenv CPPFLAGS -I/usr/local/include

Note: LDFLAGS=-L/usr/local/lib can cause problems if you have a library located there and FreeSWITCH uses a library named the same, in which case the FS build will link against your local lib instead of the desired FS-built lib. An example in FS is $(switch_srcdir)/libs/udns which is used in mod_enum. The FreeBSD port dns/udns installs libudns in /usr/local/lib.

3. Compile spandsp

( cd libs/spandsp ; ./configure ; gmake install )

4. Return to your normal FreeSWITCH™ build

PS: export will work if using bash. For other shells step 2 might differ. (like setenv LDFLAGS -L/usr/local/lib , setenv CPPFLAGS -I/usr/local/include)

Threading Library

There are some known issues with FreeBSD's libpthread implementation and APR that can affect throughput at high volume. A possible fix is to use libmap.conf to remap FreeSWITCH™ and its libraries to use libthr (the better performance threading library)

/etc/libmap.conf

[freeswitch]
libc_r.so.5 libthr.so.2
libc_r.so.6 libthr.so.2
libpthread.so.1 libthr.so.2
libpthread.so.2 libthr.so.2

I (Vagabond) haven't tested that this actually fixes the throughput issues because I don't have an environment where throughput is that high (50cps+ according to anthm). If anyone does test this, please update this page with your experiences. Some additional information on this problem can be found here and here, in addition please read the libmap.conf man page for your system and be aware of the scheduler change as of 7.1 to ULE by default (this might make things better or worse, I can't find any numbers for the "new" ULE scheduler, only 2006-7 numbers).

Note: If you use fs_cli and experience regular hangs of the client, you may wish to add an identical entry for it.

Note: In FreeBSD 7, libpthread has been removed and libthr is the default implementation.

FreeBSD rc.d script

However the default installation comes with a rc-script, it doesn't meet the requirements of the FreeBSD rc.d framework. I've created (or actually copy/paste 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

#!/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 you freewwitch server is on public 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.

Gentoo Linux

The FreeSWITCH™ ebuilds are maintained by stkn in the freeswitch-overlay at oss.axsentis.de.
Installation instructions: Installation:Gentoo

openSUSE

Tested Nov 23, 2010 with openSUSE 11.3 x86_64
There were no issues during installation and testing.

Prerequisites

Use the YAST tool or zypper to add the following packages to a basic installation, the "base development" group contains most but not all of these items:

• autoconf
• automake
• gcc-c++
• git
• libjpeg-devel
• libtool
• make
• ncurses-devel

Installation

Continue with the normal installation steps or the Linux Quick Install Guide Downloads section.

pfSense package with GUI

pfSense FreeSWITCH™ package is available for pfSense 1.2.3. The package includes a GUI for FreeSWITCH's configuration. The naming convention for the GUI has been designed to closely match the XML tag names and file names used in the default XML configuration as closely as possible. Install pfSense 1.2.3 based on FreeBSD7, Then go to System -> Packages and click the '+' add button on the right to install FreeSWITCH™ from the packages list. The package is around 50mb because it includes 8khz sounds and music on hold. After the installation FreeSWITCH™ will automatically start. By default it will bind to the WAN IP address.

To download pfSense 1.2.3 go to: http://www.pfsense.com/

Screenshots are here: http://portableusbapps.com/images/FreeSWITCH/

The pfSense FreeSWITCH™ package is being used on many live systems on dedicated hardware and on some virtual machines.

If you already have a firewall in place and just want to use this package as an easy FreeSWITCH™ install you can simply use it as a dedicated device and if desired turn off the firewall in pfSense by going to System -> Advanced -> Disable Firewall then put a check mark in 'Disable all packet filtering.'

Red Hat Enterprise Linux

Installation on RHEL should be similar or identical to CentOS. See the CentOS installation section.

Solaris

Solaris use the jds-cbe environment or fix path to working tr (as per FSBUILD-30).

export PATH=/usr/xpg4/bin:$PATH

• Use Sun Studio 12
• Install SFE (Spec Files Extra)
• Add SFEunixODBC to your Solaris installation

OpenSolaris Nevada

This is the distribution from the opensolaris.org guys, do not mix that up with os200805 which is the new OpenSolaris based distro from SUN.

• Select your development user. I will assume for the time being that the user is called freeswitch.
• Create the target directory for freeswitch

 mkdir /opt/freeswitch; chown freeswitch /opt/freeswitch

• Give your build and development user software installation rights

 usermod -P "Software Installation" freeswitch

• Log out and log back in as the freeswitch user (so that the new permissions become active)

• Download and unpack the new jds-cbe beta package:

 /usr/sfw/bin/wget http://dlc.sun.com/osol/jds/downloads/cbe/test/desktop-cbe-1.7.0-rc1-x86.tar.bz2
 gtar xvfz desktop-cbe-1.7.0-rc1-x86.tar.bz2"

• Install JDS-CBE

 cd desktop-cbe-1.7.0-rc1
 ./cbe-install

• Leave everything as default. Select the Sun Studio compiler as your default compiler.

• Download the spec-files-extra repository into a subdirectory called SFE

 svn co https://pkgbuild.svn.sourceforge.net/svnroot/pkgbuild/spec-files-extra/trunk SFE

• Load the jds-cbe environment.

 . /opt/dtbld/bin/env.sh

• Compile and install SFEunixodbc.

 cd SFE
 pkgtool --download build SFEunixodbc.spec

• Download the FreeSWITCH™ tree.

 git clone git://git.freeswitch.org/freeswitch.git

• Prepare the FreeSWITCH™ sources.

 cd freeswitch; ./bootstrap.sh

• And edit the modules.conf file to select which modules you would like to have installed.

 vim modules.conf

• Configure FreeSWITCH™ sources for 64-bit.

 CFLAGS=-m64 CXXFLAGS=-m64 LDFLAGS=-m64 ./configure --prefix=/opt/freeswitch --enable-core-odbc-support \
--enable-core-libedit-support --enable-64 --with-openssl=/usr/sfw

• Or for 32bit.

 CFLAGS=-m32 CXXFLAGS=-m32 LDFLAGS=-m32 ./configure --prefix=/opt/freeswitch --enable-core-odbc-support \
--enable-core-libedit-support --with-openssl=/usr/sfw

• Run make.

 gmake

• Install FreeSWITCH™ into its target directory.

 gmake install

OpenSolaris os200906

• Edit /etc/system and add the following line, to increase the maximum permissible number of file descriptors per user

 set rlim_fd_max = 1048576

One million FDs ought to be enough for anyone.

• If doing a Git checkout of FreeSWITCH™, it is recommended to create a dedicated ZFS filesystem to hold the git checkout, so that ZFS snapshots can be used on that directory. Create the freeswitch user's home directory first, then create the ZFS filesystem for it.

 root@sol:~# mkdir /export/home/freeswitch; zfs create rpool/export/home/freeswitch

• Create the FreeSWITCH™ user

 root@osol:~# useradd -b /export/home -P "Software Installation" -s /bin/bash -m freeswitch

• Note: OpenSolaris will complain that the username freeswitch is too long, however it does work. Some POSIX utils may truncate the username to freeswit (8 chars)

• Create the target directory for FreeSWITCH™, and set the ownership on that directory, as well as the freeswitch user's home directory

 root@sol:~# mkdir /opt/freeswitch; chown freeswitch /opt/freeswitch; chown freeswitch:staff /export/home/freeswitch

• Give the FreeSWITCH™ user software installation rights

 root@sol:~# usermod -P "Software Installation" freeswitch

• You can add ulimit -n 262144 to the FreeSWITCH™ user's .profile to automatically set a suitable limit

• Log in as the FreeSWITCH™ user and download/unpack the new jds-cbe beta package

 freeswitch@sol:~$ wget http://dlc.sun.com/osol/jds/downloads/cbe/test/desktop-cbe-1.7.0-rc1-x86.tar.bz2
 freeswitch@sol:~$ gtar xjf desktop-cbe-1.7.0-rc1-x86.tar.bz2

• Install the following packages if they are not already

 reeswitch@sol:~$ pfexec pkg install SUNWhea SUNWsfwhea SUNWxcu4 SUNWsprot SUNWxwinc SUNWxorg-headers ss-dev SUNWgnu-automake-110 SUNWscp

• Run the CBE installer

• As root, create a new ZFS filesystem for the FreeSWITCH™ git checkout

 root@sol:~# zfs create rpool/export/home/freeswitch/fs
 root@sol:~# chown freeswitch:staff /export/home/freeswitch/fs

• As freeswitch, check out a copy of FreeSWITCH™

 freeswitch@sol:~$ git clone git://git.freeswitch.org/freeswitch.git fs

• Optionally snapshot the fs filesystem (as root). Rolling back to a previous ZFS snapshot is preferable to a make clean

 oot@sol:~# zfs snapshot rpool/export/home/freeswitch/fs@clean

• As freeswitch, load the jds-cbe environment and bootstrap the source

 freeswitch@sol:~$ cd fs/
 freeswitch@sol:~/fs$ . /opt/dtbld/bin/env.sh
 freeswitch@sol:~/fs$ ./bootstrap.sh

• Configure

freeswitch@sol:~/fs$ CFLAGS="-g -m64 -I/usr/sfw/include -L/usr/sfw/lib -I/usr/gnu/include -L/usr/gnu/lib" \
CXXFLAGS="-g -m64 -I/usr/sfw/include -L/usr/sfw/lib -I/usr/gnu/include -L/usr/gnu/lib" \
LDFLAGS="-m64 -L/usr/sfw/lib -R/usr/sfw/lib -L/usr/gnu/lib -R/usr/gnu/lib /usr/lib/64/0@0.so.1" \
./configure --prefix=/opt/freeswitch --enable-64 --with-openssl=/usr/sfw

• Build FreeSWITCH

 freeswitch@sol:~/fs$ gmake

• Install FreeSWITCH

 freeswitch@sol:~/fs$ gmake install
 freeswitch@sol:~/fs$ gmake sounds-install moh-install

Ubuntu

Visit the Ubuntu Quick Start page.

Cross Compiling for ARM on Linux

These instructions were tested on Linux 2.6.18 (Centos 5) Cross compiling Linux 2.6.21 for ARM using gcc 3.4.6 All commands should be executed from within the main source repository.

Create a modules.conf. (this can be done after configure but it is convenient to do it now)

 cp build/modules.conf.in modules.conf

Decide if you want to include cpp code, if you are running on a small embedded system and don't want to install the 2+MBytes libstdc++.so edit Makefile.am in the root of the source repository and remove all references to switch_cpp.cpp and switch_cpp.h, there is one of each. This will also disable all of FreeSWITCH™'s language modules, edit modules.conf and comment out all the language modules, that is all the lines starting with "language". You can still write C applications with the cpp disabled.

I was not able to get javascript working so you should comment out languages/mod_spidermonkey* from modules.conf and comment out the line "AC_CONFIG_SUBDIRS(libs/js)" in the file configure.in. If you figure out a way to get it working update this page, I wasn't motivated as I did not intend to use it.

If you want to reduce the build time you can comment out other support libraries from configure.in, I only used and tested the following, it saves a lot of build time and I don't know if the other libraries will build:

• libs/srtp
• libs/sqlite
• libs/libedit
• libs/pcre
• libs/apr
• libs/apr-util
• libs/codec/ilbc
• libs/sofia-sip
• libs/libsndfile
• libs/voipcodecs

I already had a version of curl cross compiled so I did not use the version that comes with FreeSWITCH.

Run this command next, it will create all the configure scripts

./bootstrap.sh

Several of the packages cannot detect capabilities of the Cross Compile environment correctly so configure needs to be called with many options to get it to work correctly. Check that the options I have match your Cross Compile environment. Prior to running this the following environment variables must be set: TARGET_CC - the cross compiler HOSTCC - the host compiler CFLAGS - CFLAGS for the cross compiler CPPFLAGS - CPPFLAGS for the cross compiler LDFLAGS - LDFLAGS for the cross compiler These environment variables also need to be set to point to the appropriate tool in the cross compiler's toolchain CC, CXX, AR, LD, GCC, AS, NM, RANLIB, STRIP, SIZE, OBJCOPY & OBJDUMP. Not sure if they are all used, but this is what worked for me.

You will need to adjust some setting to fit your environment, set the "path" in ac_cv_path__libcurl_config and --with-curl, or remove them if you use the version that comes with FreeSWITCH™. Set --with-modinstdir to point to where the FreeSWITCH™ modules will be on the target filesystem.

If you have not done so edit modules.conf so that it will build the modules you desire. If you are unsure, leave this to the defaults. FreeSWITCH™ comes with a good set of modules as the default, until you become more familiar with FreeSWITCH™ it is advised that you not edit modules.conf. A # at the beginning will omit that module from being built. A list of the modules can be obtained from the Modules page.

Once you are done configuring the build environment you need to run the following command. (Your PATH must point to the cross compiler toolchain)

make

I found little use for make install as I didn't want the Cross Compiled version installed on the build system. You will need to copy the FreeSWITCH™ binary, library and modules directly out of the build tree into where ever you need them.

Cross Compiling for OpenWrt

http://wiki.freeswitch.org/wiki/OpenWrt

Prebuilt Binaries

 

The FreeSWITCH™ project maintains binary packages for a number of Linux distributions on the openSUSE Build Service. All external dependencies required by these FreeSWITCH™ packages are either part of the base Linux distros or available in the repository at: http://software.opensuse.org/download/network:/telephony/. If your preferred Linux distro and version is listed there, then we recommend you use these packages.

Ubuntu Packages

• Add the following to /etc/apt/sources.list: (e.g. sourcelist for Ubuntu 9.04 - Jaunty Jackalope)

deb http://ppa.launchpad.net/freeswitch-drivers/freeswitch-nightly-drivers/ubuntu jaunty main 
deb-src http://ppa.launchpad.net/freeswitch-drivers/freeswitch-nightly-drivers/ubuntu jaunty main 

• Update apt-get.

apt-get update

• Search for the FreeSWITCH™ packages in apt.

apt-cache search freeswitch

Choose from the packages listed to complete your FreeSWITCH™ installation. For more info on installing and adding freeswitch PPA for different versions of Ubuntu FreeSWITCH™ Drivers in Launchpad

Special Considerations

ODBC Support

See the ODBC Support document.

ODBC Installed in non-standard locations

As of April 23 2012, a change was made to the configure script to check if the ODBC library is installed. As a consequence, the check fails due to the way how the macro behaves. To resolve this issue, you would issue the following command before you initiate the configure script:

export LIBRARY_PATH="<path to ODBC lib here>"

No Root Access

If you don’t have root access add --prefix=~/freeswitch to the command. NOTE: This is a really bad idea on production systems, not recommended.

 ./configure --prefix=/usr/local/freeswitch

Insert non-formatted text here.

Graphical User Interfaces

See: Freeswitch Gui