Asterisk from source

From OpenVZ Virtuozzo Containers Wiki
Revision as of 06:08, 3 August 2012 by Kir (talk | contribs) (Reverted edits by ThomasKelly (talk) to last revision by Jholladay)
Jump to: navigation, search

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.

Since Digium is retiring Zaptel with the use of Dahdi, the header you will use to build meetme module to work with Dahdi is called user.h. Just copy this file to /usr/include/dahdi/user.h in CT then build your Asterisk , you should get the MeetMe working.

TTY Problem

After I have installed asterisk, the service wouldn't start and give me the following error:

Starting asterisk: Cannot find your TTY

The solution is to edit /usr/sbin/safe_asterisk , comment out the TTY= line. I found my at the very top of the file, about the 5th line. Now I am able to start, stop, restart the asterisk service all I want.

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

This will create /dev/zap/pseudo and /lib/udev/devices/zap/pseudo in your container. The group/owner will be root/root and the permissions will be 644. If you're running Asterisk under the asterisk user in your container, you will need to set the proper ownership for these devices in your VE. The /dev/zap devices are recreated whenever the container is restarted. The /lib/udev/devices/zap files are persistent. The key to only doing this once is to make sure you change the ownership in the VE of the /lib/udev/devices/zap files in addition to the /dev/zap files.

To set the necessary ownership in the VE:

vzctl exec 240 chown -R asterisk /dev/zap /lib/udev/devices/zap
vzctl exec 240 chgrp -R asterisk /dev/zap /lib/udev/devices/zap