Install sipX on Debian
This page is about installing sipX version 3.0.1 on Debian Sarge from a custom Debian repository. Everything needed to install sipX is either in the default Debian Sarge or the Calivia repository.
By following the steps below you will end up with sipX installed and configured on a stock Debian Sarge host in no time.
Note: If the host is currently running Apache it will need to be disabled as sipX starts Apache with a custom configuration from /etc/sipxpbx/httpd.conf. This instance of Apache will bind to ports 80 and 8090 (http) and 443 and 8091 (https).
Configure /etc/apt/sources.list
/etc/apt/sources.list
# choose a mirror close to you!
deb http://scm.calivia.com/pub/sipx/debian unstable main
After adding new package sources, Debian must be told about them.
apt-get update will fetch the information about what is available from all the repository URLs in
/etc/apt/sources.list.
Install Sun J2RE 1.5 and create symlinks for keytool
Two symlinks need to be created for Java keytool.
apt-get install sun-j2re1.5
ln -s /usr/lib/j2re1.5-sun/bin/keytool /etc/alternatives/keytool
ln -s /etc/alternatives/keytool /usr/bin/keytool
Install sipxpbx
The only unmet dependency on Sarge is mod_cplusplus. We provide a Debian package for mod_cplusplus-1.5.2 in our repository (
libapache-mod-cplusplus_1.5.2-0_i386.deb and
libapache-mod-cplusplus-dev_1.5.2-0_i386.deb). It will be installed along with the other packages by apt.
sipXportLib will ask you for information using Debian
debconf to create a key and self-signed certificate for both sipXpbx (Apache) and sipXconfig (Jetty). Check out the documentation if you plan to use a certificate from an external authority.
sudo apt-get install sipxpbx
Configure TFTP server
sipXconfig installs tftpd-hpa if it is not already installed. After successful installation of sipXconfig, you need to configure tftpd-hpa to serve the files controlled by sipXconfig.
You need to change one line in
/etc/inetd.conf:
-tftp dgram udp wait root /usr/sbin/in.tftpd /usr/sbin/in.tftpd -s /var/lib/tftpboot
+tftp dgram udp wait root /usr/sbin/in.tftpd /usr/sbin/in.tftpd -s /var/sipxdata/configserver/phone/profile/tftproot/
To activate the change, restart inetd:
/etc/init.d/inetd restart
Start sipXpbx
sipXpbx will be started automatically after it has been installed and configured.
Note: startup of sipXconfig takes some time, so don't be alarmed if port 8443 is not up immediately after you started sipXpbx. If it is still not up after 30 seconds or so, check
/var/log/sipxpbx/sipxconfig.log for errors. If anything with the certificates is wrong, it will not come up.
Check ports
Once everything is installed, verify all processes are running and all ports are listening. Then, point your browser at http://yourhost and set the superadmin user's password to gain access to sipXconfig.