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.
mike – Thu, 2006 – 01 – 12 20:04