Difference between revisions of "Asterisk from source"

From OpenVZ Virtuozzo Containers Wiki
Jump to: navigation, search
(terms used are linked to; fixed english; fixed external links; fixed cd command)
(added debian dependencies)
Line 6: Line 6:
 
== Building Asterisk in a [[CT]] ==
 
== Building Asterisk in a [[CT]] ==
 
Asterisk PBX server itself is compiled out of the shelf in a [[container]] provided that development tools are installed. The functionality of the resulting executable is enough to support simple VoIP telephony.
 
Asterisk PBX server itself is compiled out of the shelf in a [[container]] provided that development tools are installed. The functionality of the resulting executable is enough to support simple VoIP telephony.
 
+
=== Debian Dependencies ===
 +
<pre>apt-get install build-essential libncurses-dev</pre>
 +
=== Compiling ===
 
<pre>
 
<pre>
 
wget http://downloads.digium.com/pub/asterisk/releases/asterisk-x.x.xx.tar.gz
 
wget http://downloads.digium.com/pub/asterisk/releases/asterisk-x.x.xx.tar.gz
Line 20: Line 22:
 
To configure Asterisk itself see, for example, http://downloads.oreilly.com/books/9780596510480.pdf.
 
To configure Asterisk itself see, for example, http://downloads.oreilly.com/books/9780596510480.pdf.
  
== MeetMe problem ==
+
=== MeetMe problem ===
 
Unfortunately, one particular module called MeetMe (conferencing tool) will be switched off from compilation. This happens due to external dependency on 'zaptel' package. Zaptel provides support for some hardware cards for FXO/FXS analog telephony marketed by Digium (the company behind Asterisk), and on top of that supplies so called <code>ztdummy</code> kernel module. Ztdummy works like a simple metronome which is required to synchronize multiple sound streams in case of conference call.  
 
Unfortunately, one particular module called MeetMe (conferencing tool) will be switched off from compilation. This happens due to external dependency on 'zaptel' package. Zaptel provides support for some hardware cards for FXO/FXS analog telephony marketed by Digium (the company behind Asterisk), and on top of that supplies so called <code>ztdummy</code> kernel module. Ztdummy works like a simple metronome which is required to synchronize multiple sound streams in case of conference call.  
  

Revision as of 22:43, 16 October 2008

General

Asterisk is free and open source code to create software PBX server. See http://www.asterisk.org/ for details. The package runs perfectly inside an OpenVZ container. Some users run up to 60 containers with Asterisk deployed for production per single hardware node. Although the easiest way to install Asterisk into a container is to use pre-build package from Linux distribution, occasionally one may need to have a possibility to build it from source tarball available on developer's site.

In order to do so the following remarks are worth reading.

Building Asterisk in a CT

Asterisk PBX server itself is compiled out of the shelf in a container provided that development tools are installed. The functionality of the resulting executable is enough to support simple VoIP telephony.

Debian Dependencies

apt-get install build-essential libncurses-dev

Compiling

wget http://downloads.digium.com/pub/asterisk/releases/asterisk-x.x.xx.tar.gz
tar xzf asterisk-x.x.xx.tar.gz
cd asterisk-x.x.xx
./configure
make
make install
make samples

The last command is not needed in case you have your own configuration as it installs some sample configuration files. To configure Asterisk itself see, for example, http://downloads.oreilly.com/books/9780596510480.pdf.

MeetMe problem

Unfortunately, one particular module called MeetMe (conferencing tool) will be switched off from compilation. This happens due to external dependency on 'zaptel' package. Zaptel provides support for some hardware cards for FXO/FXS analog telephony marketed by Digium (the company behind Asterisk), and on top of that supplies so called ztdummy kernel module. Ztdummy works like a simple metronome which is required to synchronize multiple sound streams in case of conference call.

If you do not plan to use analog telephone lines, hence don't like in install the hardware, nothing is lost provided you run your HN with 2.6.XX kernel. You just need to play a little trick with Asterisk make system: download zaptel tarball from the same location as Asterisk itself, and copy it's header zaptel.h to location /usr/include/zaptel/zaptel.h in CT where you plan to build Asterisk. This tweaks MeetMe for installation.

HN configuration

Finally you need to make sure that on HN ztdummy kernel module is loaded and the access to /dev/zap/pseudo device file is granted to the container:

modprobe ztdummy
vzctl set 240 --devnodes zap/pseudo:rw --save