Commit f5d755fa authored by Sebastien Decugis's avatar Sebastien Decugis
Browse files

Updated documentation, included information for OpenSUSE and Fedora

parent 377c3dc7
### Very short install notes for Fedora (tested on Fedora 13)
# Please refer to other INSTALL files for more detailed instructions.
### Very short install notes for Fedora (tested on Fedora 13 and 14)
# Please refer to other INSTALL files for more detailed instructions (e.g. extension-specific notes).
Dependencies on Fedora 13 (from minimal system):
......@@ -7,8 +7,18 @@ Dependencies on Fedora 13 (from minimal system):
# yum install mercurial
Following dependencies are optional, depending on which extensions you plan to compile
# yum install postgresql-server postgresql-devel
# yum install mysql-server mysql-devel
app_acct:
# yum install postgresql-server postgresql-devel
app_sip:
app_diameap:
# yum install mysql-server mysql-devel
dict_legacy_xml:
# yum install libxml2 libxml2-devel
dbg_interactive:
# yum install swig python-devel
Fetching the latest source:
......@@ -20,3 +30,8 @@ Compiling in a separate directory:
# cd test.build
# cmake ..
# make
There is currently no Fedora-specific package for freeDiameter.
You are welcome to contribute packaging scripts! Please contact with
dev@freediameter.net for more details.
### Very short install notes for OpenSUSE (tested on OpenSUSE 11.3)
# Please refer to other INSTALL files for more detailed instructions (e.g. extension-specific notes).
Dependencies on OpenSUSE 11.3 (from minimal server system installation):
# zypper install cmake make gcc flex bison lksctp-tools-devel libgnutls-devel libgcrypt-devel
# zypper install mercurial
Following dependencies are optional, depending on which extensions you plan to compile
app_acct:
# zypper install postgresql-server postgresql-devel
app_sip:
app_diameap:
# zypper install libmysqlclient-devel
(would also need a server, not sure which package is appropriate)
dict_legacy_xml:
# zypper install libxml2 libxml2-devel
dbg_interactive:
# zypper install swig python-devel
Fetching the latest source:
# hg clone http://www.freediameter.net/hg/freeDiameter
# cd freeDiameter
Compiling in a separate directory:
# mkdir test.build
# cd test.build
# cmake ..
# make
There is currently no OpenSUSE-specific package for freeDiameter.
You are welcome to contribute packaging scripts! Please contact with
dev@freediameter.net for more details.
......@@ -21,16 +21,27 @@ The following packages are required to compile freeDiameter from source:
Additionnaly, these ones may be useful:
mercurial gdb
In order to build app_acct extension, you will also need the package libpq-dev.
In order to build app_sip or app_diameap extension, you will also need the package libmysqlclient-dev.
In order to build dict_legacy_xml extension, you will need libxml2-dev.
Extensions additional dependencies:
app_acct:
libpq-dev
app_sip:
app_diameap:
libmysqlclient-dev
dict_legacy_xml:
libxml2-dev
dbg_interactive:
swig python-dev
If your debhelper environment is recent (> 7.3.9 to provide cmake support),
the following commands should generate the freeDiameter packages for you:
# Install the dependencies for building the source:
sudo apt-get -y install mercurial cmake make gcc bison flex libsctp-dev libgnutls-dev libgcrypt-dev libpq-dev libmysqlclient-dev libxml2-dev ssl-cert debhelper fakeroot
sudo apt-get -y install mercurial cmake make gcc bison flex libsctp-dev libgnutls-dev libgcrypt-dev ssl-cert debhelper fakeroot \
libpq-dev libmysqlclient-dev libxml2-dev swig python-dev
# Retrieve the latest version of the source package
cd
......
......@@ -21,10 +21,17 @@ INSTRUCTIONS to setup a new build slave for the freeDiameter buildserver:
- install freediameter dependencies as follow:
# pkg_add -r -v wget
# pkg_add -r -v `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.freebsd -O - | grep -v -e "^#"`
c) OpenSUSE:
$ sudo zypper install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.opensuse -O - | grep -v -e "^#"`
d) Fedora:
$ sudo yum install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.fedora -O - | grep -v -e "^#"`
2) Create the "test" database for app_acct test (we assume the tests are run as user "test" here)
- check INSTALL.FreeBSD file for specific PostgreSQL pre-install instructions.
- These are the instructions for Debian/Ubuntu, adjust as needed:
- These are the instructions for Debian/Ubuntu/OpenSUSE, adjust as needed:
# su - postgres
# createuser test
Shall the new role be a superuser? (y/n) n
......@@ -49,6 +56,7 @@ INSTRUCTIONS to setup a new build slave for the freeDiameter buildserver:
"Route-Record3" bytea,
"Route-Record4" bytea );
\q
3) Create a directory ~/fDtests
$ cd
......@@ -65,7 +73,7 @@ INSTRUCTIONS to setup a new build slave for the freeDiameter buildserver:
For FreeBSD, in addition do:
$ echo "set(CTEST_BUILD_OPTIONS \"\${CTEST_BUILD_OPTIONS} -DFLEX_EXECUTABLE:FILEPATH=/usr/local/bin/flex\")" >> local.cmake
6) Run the runscript.sh script once to check it works properly (freeBSD might require: ln -s /usr/local/bin/bash /bin/bash)
6) Run the runtests.sh script once to check it works properly (freeBSD might require: ln -s /usr/local/bin/bash /bin/bash)
7) Set up a crontab to run the script
$ wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/cronjob.sh
......
# Fedora packages names of dependencies for nightly tests (using "yum install <packages>"):
cmake make gcc flex bison lksctp-tools-devel gnutls-devel libgcrypt-devel mercurial
postgresql-server postgresql-devel
mysql-server mysql-devel
libxml2 libxml2-devel
swig python-devel
# 1: install base system and ports
# 2: install wget with command: pkg_add -r -v wget
# Finally, install the other packages from this file
bash cmake mercurial flex bison gnutls postgresql84-client postgresql84-server mysql50-client libxml2
# pkg_add -r -v `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.freebsd -O - | grep -v -e "^#"``
bash cmake mercurial flex bison gnutls postgresql84-client postgresql84-server mysql50-client libxml2 swig
# OpenSUSE packages names of dependencies for nightly tests (using "zypper install <packages>"):
# zypper install `wget http://www.freediameter.net/hg/freeDiameter/raw-file/tip/contrib/nightly_tests/prereqs.opensuse -O - | grep -v -e "^#"`
cmake mercurial make gcc flex bison lksctp-tools-devel libgnutls-devel libgcrypt-devel
postgresql-server postgresql-devel libmysqlclient-devel libxml2-devel swig python-devel
# Afterwards, you may need to issue the following command so that postgresql starts at boot:
# insserv postgresql
# Packages (Ubuntu names)
cmake mercurial make gcc flex bison binutils libsctp-dev libgnutls-dev valgrind wget libpq-dev postgresql libmysqlclient-dev libxml2-dev libxml2
cmake mercurial make gcc flex bison binutils libsctp-dev libgnutls-dev valgrind wget libpq-dev postgresql libmysqlclient-dev libxml2-dev libxml2 swig python-dev
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment