Building Debian Packages
- Prepare your environnement
- Get the OpenIMSCore sources
- Copy the debian folder
- Update information
- Build the packages
- Use the packages
This page is supposed to help you building debian packages for the Open IMS Core. In the SVN distribution, the whole things is pre-configured and pre-provisioned with a set of minimal data that should be enough for a simple “Alice-calls-Bob” trial.
Prepare your environnement
In order to build Debian packages, you would have to prepare your environnement. On debian based distribution (Debian, Ubuntu, etc.), just use the following command to install debian utilities :
sudo apt-get install debhelper cdbs lintian build-essential fakeroot devscripts pbuilder dh-make debootstrap dpatch flex libxml2-dev libmysqlclient15-dev sun-java6-jdk ant docbook-to-man
Get Open IMS Core Sources
mkdir openimscore svn checkout https://svn.code.sf.net/p/openimscore/code/ser_ims/trunk openimscore mkdir openimscore-fhoss svn checkout https://svn.code.sf.net/p/openimscore/code/FHoSS/trunk openimscore-fhoss
Copy the debian folder from pkg folder
Browse with a terminal to openimscore (or openimscore-fhoss) folder and use the following command to copy the debian folder
cp -a pkg/debian ./debian
Update changelog file
Changelog file need to be updated in order to build up to date packages. The following command will update the changelog file in debian folder. Feel free to change svnversion to the SVN revision number and comment.
You can also change by hand the distribution into this file. In my example, I build package for Debian Lenny, but you can do it for Ubuntu Intrepid, Jaunty, etc. To change de distribution, you will have to browse to debian folder and change by hand the distribution in the changelog file.
dch -v $(svnversion) "Comments ..."
To build packages use the following command. This will build the deb files in the parent directory
If you built the openimscore packages, you should find 5 packages :
The main package is openimscore. Every package depends on this one except for openimscore-dnsconf
If you built the openimscore-fhoss packages, you should find 2 packages :
While installing a package, some questions will be asked in order to configure your IMS.
Configuration files are located in /etc/openimscore folder.
Log files are located in /var/log/OpenIMSCore folder if you choose to use syslog.
Start scripts are located into /etc/init.d/ (System V). Each IMS component (CSCF or HSS) starts automatically with computer by default. You can restart, stop, etc., system with command like :
sudo /etc/init.d/openimscore-pcscf start|stop|restart|kill|status
Launch scripts are located in /usr/sbin/ (xcscf.sh and fhoss.sh)
openimscore-dnsconf will install and configure bind for your IMS.