freeswitch/debian
Travis Cross eb7200bbe5 Avoid mod_java on Debian wheezy
We're already avoiding it on sid and jessie; now we're hitting build
failures with it on wheezy.

ref: FS-6811
2014-09-09 16:25:17 +00:00
..
source debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
.gitignore Add freeswitch-all debian package 2013-10-18 19:52:16 +00:00
AUTHORS Cleanup whitespace in debian/ 2013-12-10 03:53:17 +00:00
README.Debian Make debian/README files more markdown-like 2014-02-23 22:39:15 +00:00
README.source git.freeswitch.org is DEAD... Long Live git via http://stash.freeswitch.org 2014-07-15 17:34:16 -05:00
bootstrap.sh Avoid mod_java on Debian wheezy 2014-09-09 16:25:17 +00:00
changelog debian: version bump 2012-05-24 17:27:28 +00:00
compat debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
control-modules Add mod_bert to debian packaging 2014-09-09 14:27:27 +00:00
copyright Remove remaining traces of mod_spidermonkey 2014-07-18 19:07:38 +00:00
docs debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-doc.docs debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-doc.install debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-mod-java.install.tmpl debian: install freeswitch.jar with mod_java 2012-05-15 07:19:51 +00:00
freeswitch-mod-managed.install.tmpl debian: Handle mod_managed .dll more idiomatically 2013-07-26 21:56:07 +00:00
freeswitch-mod-perl.install.tmpl Install perl module files needed by mod_perl 2013-10-19 19:55:22 +00:00
freeswitch-mod-pocketsphinx.install.tmpl debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-systemd.freeswitch.service Change to ncwait so that the service start script will block until FS is actually started 2014-06-23 10:03:53 -05:00
freeswitch-systemd.install debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-sysvinit.freeswitch.default -rp is not an ok default option it should not be used in normal circumstances it forces an unsafe environment with realtime threads on single cpu systems. Real time mode will enable by default on systems with enough cpus 2014-06-21 21:42:46 +05:00
freeswitch-sysvinit.freeswitch.init FS-6642 --resolve 2014-07-11 11:04:08 -05:00
freeswitch-timezones.install Create freeswitch-timezones debian package 2014-06-24 00:39:14 +00:00
freeswitch.install debian: don't install scripts/ with freeswitch 2012-05-15 07:18:50 +00:00
freeswitch.postinst Avoid overaggressive chmod/chown on upgrade 2014-08-28 12:24:44 +00:00
freeswitch.postrm debian: whitespace 2012-05-06 22:46:36 +00:00
freeswitch.preinst debian: whitespace 2012-05-06 22:46:36 +00:00
freeswitch.prerm debian: massage the prerm script to pass lintian 2012-05-07 16:17:11 +00:00
gbp.conf debian: don't force-create the orig tarball 2012-05-28 16:35:00 +00:00
libfreeswitch-dev.install debian: don't distribute .la file with libfreeswitch-dev 2012-05-09 23:15:03 +00:00
libfreeswitch1.install debian: separate out libfreeswitch1 2012-05-09 23:15:02 +00:00
license-reconcile.yml remove opezap from tree, it has been replaced by freetdm 2014-05-06 11:05:54 -04:00
rules Set new `cache_dir` for debian 2014-09-04 21:09:46 +00:00
util.sh FS-6689 #comment next time please attach a diff #resolve 2014-07-25 07:31:13 -05:00

README.source

FreeSWITCH for Debian
=====================

Introduction
------------

Because FreeSWITCH has so many modules it was necessary to create a
system to autogenerate the majority of the packaging.  This in done
mostly in the file debian/bootstrap.sh.  This bootstrap needs to run
before any other step of the packaging, though we do try to
autogenerate it when possible.

Getting the FreeSWITCH sources
------------------------------

Everything that follows will assume that you're in the base directory
of a FreeSWITCH git repository.  You can achieve this with:

    aptitude update && aptitude install -y git
    mkdir -p /usr/src/freeswitch
    git clone https://stash.freeswitch.org/scm/fs/freeswitch.git /usr/src/freeswitch/src
    cd /usr/src/freeswitch/src

Ensuring you have a clean build directory
-----------------------------------------

Every time you start over, you should make sure your build directory
is perfectly clean and clear of untracked files.  You can accomplish
this with:

    git clean -fdx && git reset --hard origin/master

Using the packaging to do a normal build
----------------------------------------

Let's say you don't want to build the Debian packages; you just want
to build FS.  You'll need certain dependencies installed on your
system to do this.  And you probably want to configure FS in the same
way we do for the packaging.  You can let the packaging files do this
work for you so you don't have to manually keep track of which
dependencies are required to build FS.  Build as follows:

    aptitude update && aptitude install -y devscripts equivs build-essential
    my_release=$(awk '/deb .*\/debian/{print $3; exit}' /etc/apt/sources.list)
    (cd debian && ./bootstrap.sh -c $my_release)
    sed -i debian/control -e '/^#/d' && sed -i debian/control -e '/^$/N;/^\n$/D'
    mk-build-deps -i
    make -f debian/rules .stamp-configure && make

The debian/modules.conf file
----------------------------

If the file debian/modules.conf is present, we read that file and only
build and package the files listed there.  Otherwise, we build every
module except the ones that either should not be packaged, or for
which we don't yet have good packaging.

The format of debian/modules.conf is:

    ## comments should start with two hash characters
    <category>/<module_name>

Building the Debian packaging
-----------------------------

If you want actualy Debian binary or source packages to upload to your
own repository, you'll need to build them as described here.  We have
some fancy automatic tools to accomplish this.  The tools allow you to
start from a very bare Debian image and generate working packages.
Building in this manner is only supported on Debian sid, though it
will generate packages for all supported Debian releases.  Simply run:

    ./debian/util.sh build-all -ibn -z9

Building only some modules
--------------------------

If you don't need all the modules to build, create a modules.conf file
outside of your source tree and pass the -f option to build-all.  e.g.:

    echo "applications/mod_commands" > /tmp/modules.conf
    ./debian/util.sh build-all -ibn -z9 -f /tmp/modules.conf

Testing a particular module under packaging
-------------------------------------------

If you need to build a small set of modules for compile testing in the
pbuilder environment, you can run:

    ./debian/util.sh build-all -dni -z1 -a amd64 -c sid -l "applications/mod_commands"

Getting help with debian/util.sh
--------------------------------

The debian/util.sh has many options.  You can see the documentation
for these options by running:

    ./debian/util.sh -h

The debian/control-modules file
-------------------------------

The build dependencies, runtime dependencies, and other details about
modules can be configured in the debian/control-modules file.  Even
though this file looks a bit like a debian control file and has a
similar format, we are parsing this file ourselves so the format is a
bit more restricted.

debian/control-modules currently supports the following fields:

    # lines that begin with the hash character are comments
    #
    # every block must start with a Module field
    Module: <category>/<module_name>
    Description: <short description>
     <long description> # empty lines with "."s are not yet supported
    Build-Depends: <build deps for this module>
    Depends: <runtime deps for this module>
    Recommends: <recommended packages>
    Suggests: <suggested packages>
    Distro-Conflicts: <distributions on which this module should not be built> # not yet implemented

During bootstrap we build a file control-modules.gen.  If the
control-modules file is properly formatted, this generated file should
be identical.  This is a sanity check mechanism for our parsing, as
well as a way to automatically reorganize the file.

Building Debian packages without util.sh
----------------------------------------

Building the packages without util.sh is not recommended as util.sh
takes care of many non-trivial details.  If needed, however, the
packages can be built:

    distro=sid
    ver="$(cat build/next-release.txt | sed -e 's/-/~/g')~n$(date +%Y%m%dT%H%M%SZ)-1~${distro}+1"
    git clean -fdx && git reset --hard origin/master
    ./build/set-fs-version.sh "$ver"
    git add configure.ac && git commit -m "bump to custom v$ver"
    (cd debian && ./bootstrap.sh -c $distro)
    dch -b -m -v "$ver" --force-distribution -D "unstable" "Custom build."
    dpkg-buildpackage -b -us -uc -Zxz -z9
    git reset --hard HEAD^

To build for a stable branch, do this:

    distro=sid # update as needed
    stable_ver="1.2.1" # update as needed
    ver="$(echo "$stable_ver" | sed -e 's/-/~/g')~n$(date +%Y%m%dT%H%M%SZ)-1~${distro}+1"
    git clean -fdx && git reset --hard refs/tags/v${stable_ver}
    ./build/set-fs-version.sh "$ver"
    git add configure.ac && git commit -m "bump to custom v$ver"
    (cd debian && ./bootstrap.sh -c $distro)
    dch -b -m -v "$ver" --force-distribution -D "unstable" "Custom build."
    dpkg-buildpackage -b -us -uc -Zxz -z9
    git reset --hard origin/master

Building the freeswitch-sounds and freeswitch-music packages
------------------------------------------------------------

The source packages for sounds and music on hold are maintained in a
separate repository.  Each set of sounds has a separate version number
and the processing of the sounds is quite different from what we're
doing here, so trying to maintain a merged debian/ between FreeSWITCH
and the sounds and music would be a mess.

To build the Debian packages for freeswitch-sounds-* and
freeswitch-music-*:

    git clone https://github.com/traviscross/freeswitch-sounds.git
    cd freeswitch-sounds && cat debian/README.source

 -- Travis Cross <tc@traviscross.com>, Wed, 19 Mar 2014 19:07:23 +0000