sipXecs on Debian and Ubuntu

Debian Etch packages for sipXecs 3.8 RC2.

The packages are built from the 3.8 snapshot of July 4/5 2007, available from http://sipxecs.sipfoundry.org/temp/sipXecs/3.8/SRC/.

sipXecs 3.8 for Debian

See also README.Debian and changelog in every package for more information on Debian specific issues.

  • sipXecs lives in the following directories on Etch:
    • /etc/sipxpbx
    • /usr/lib/sipx
    • /usr/share/doc/sipx
    • /var/lib/sipx
    • /var/run/sipxpbx
    • /var/log/sipxpbx
    • /var/www/sipx
  • development packages (-dev)
    • contain the include and header files
  • documentation packages (-doc)
    • contain developer documentation
  • debug symbol packages (-dbg)
    • contain the debug symbols
  • library packages
    • library packages have been split in two parts, library and binaries
    • this is also the case for the 12 libraries in sipxregistry (libRedirectorHunt1 libRedirectorPickUp1 libRedirectorENUM1 libRedirectorSubscribe1 libRedirectorISN1 libRegistrarImpliedMWI1 libRedirectorAuthRouter1 libRedirectorTest1 libRedirectorJoin1 libRedirectorAliasDB1 libRedirectorRegDB1 libRedirectorMapping1)
    • all library packages are called libLIBRARYNAME (instead of LIBRARYNAMElib)
    • package name of the sipxmediaadapterlib library is libsipxmediaprocessing1
  • new package syslogviewer (sipxportlib)
    • syslogviewer
  • new package siptest (sipxtacklib)
    • dialogdisplay, dialogwatch, subscribe-dialog-test, siptest
    • depends on perl, libxml-parser-perl
  • new package sipviewer (sipxtacklib)
    • sipviewer and Java libraries
    • depends on Java, xbase-clients
  • new package syslog2siptrace (sipxtacklib)
    • merge-logs, siplog2sip, syslog2siptrace, siptrace-merge
    • depends on perl
  • sipxcommserverlib
    • the package now generates the certificates and keys from user data collected using debconf (by feeding the data into /etc/sipx/ssl/SSL_DEFAULTS and then calling gen-ssl-keys.sh and install-cert.sh with the values set in this file)
  • new package sipxpbx-l10n-en-us
    • installs the English American voice prompts and the standard VM scripts for American English
  • new package sipxwatchdog (sipxpbx)
    • contains watchdog binary, scripts and config files for watchdog and keepalive
    • all server packages (sipxvxml, sipxpublisher, sipxregistry, sipxproxy, sipxconfig, sipxacd, sipxpbx) depend on sipxwatchdog
    • sipxwatchdog installs the initscript, but only sipxecs or sipxecs-dist actually start sipX
  • new meta packages sipxecs and sipxecs-dist
    • limit installed dependencies in a HA setup to a minimum and to deal with the initscript getting installed too early (see sipxwatchdog)
    • both meta packages pull in all required dependencies, excluding tftp and ftp server
    • sipxpbx service is started when the sipxecs{-dist} package is installed
    • it is not recommended to install the packages one-by-one, but instead to use the meta package
    • sipxecs depends on all server packages and therefore installs a complete sipXecs system
    • sipxecs-dist only depends on sipxwatchdog, sipxregistry and sipxproxy, which are the only components required in a HA setup. sipxecs-dist does not depend on sipxpbx.
  • new package sipxtools (new in 3.7)
    • utilities and tools
  • PostgreSQL config
    • add access permissions for user sipx on databases SIPXCONFIG, SIPXCDR and SIPXACD_HISTORY from localhost
    • limit access to user postgres (instead of all) from localhost (UNIX and TCP/IP). These are both required during installation (but could be removed once installed)
  • TFTP server
    • either tftpd-hpa or atftpd can be used
    • install sipxconfig-tftpd-hpa or sipxconfig-atftpd to get the chosen TFTP server plus customized settings for sipXconfig
    • sipxconfig-tftpd-hpa conflicts with sipxconfig-atftpd, only one can be installed at any one time
    • sipxconfig will automatically configure the chosen TFTP server (with backup of the existing configuration)
  • FTP server
    • vsftpd can be installed with package sipxconfig-vsftpd
    • other ftp-servers may be used, but need to be configured manually
  • removal of sipXecs
    • on apt-get remove --purge, all traces of sipXecs are completely removed from the machine (including configuration, databases and logfiles)
  • sipxwatchdog alerts
    • the watchdog process sends mail to user sipx. /etc/aliases routes messages to sipx to user root, change /etc/aliases to send them off the host make sure the local MTA is setup correctly
  • MTA
    • postfix will be installed as preferred dependency, but any other mail-transport-agent can be used

Debian Etch sipXecs package repository

http://scm.calivia.com/pub/sipx/debian/dists/etch/

/etc/apt/sources.list

# sipXecs
deb     http://scm.calivia.com/pub/sipx/debian  etch 3.8
deb-src http://scm.calivia.com/pub/sipx/debian  etch 3.8

PGP key for secure apt

msl at calivia dot com

 pub 1024D/8E105CDC 2005-08-26
 0x9A9C81838E105CDC
 Key fingerprint = D323 67D4 BDB2 DCE8 D03F 4384 9A9C 8183 8E10 5CDC

Import PGP key into apt

 gpg --keyserver pgpkeys.mit.edu --recv-key 8E105CDC
 gpg -a --export 8E105CDC | sudo apt-key add -

Support

For support, feedback and enhancments please use the sipX-users mailinglist. The packages do work for me, but your mileage may vary.

Disclaimer of Warranty and Liability

All packages downloadable from this site are provided "AS-IS" and without warranty, express and implied, including but not limited to any implied warranties of merchantability and fitness for a particular purpose. In no event will Calivia be liable for any damages, including lost profits, lost savings, or other incidental or consequential damages, even if Calivia is advised of the possibility of such damages, or for any claim by you or any third party.