Installation de Asterisk 1.4 sous Debian Etch

Accueil

Published by sebastien on mai 31st, 2008 in VoIP, Asterisk

Ce tutoriel relate l’installation du logiciel de téléphonie PBX libre Asterisk, ainsi que les pilotes d’interfaces téléphoniques Zaptel; plus particulièrement le pilote ztdummy qui nous permet d’avoir une source de synchronisation temporelle (timing) pour les conférences (meetme) et la musique en attente (music-on-hold). Nous complèterons l’installation avec les librairies PRI (Libpri) pour les interfaces T1/E1 ainsi que certains modules additionnels (Addons) qui nous permettront entre autres de communiquer avec une base de données MySQL.

Il est à noter que beaucoup d’informations ont été prises de ce tutoriel, qui lui est basé sur cet autre tutoriel.

Commençons d’abord par télécharger les quatre items mentionnés précédemment:

wget http://downloads.digium.com/pub/asterisk/asterisk-1.4-current.tar.gz

wget http://downloads.digium.com/pub/zaptel/zaptel-1.4-current.tar.gz

wget http://downloads.digium.com/pub/libpri/libpri-1.4-current.tar.gz

wget http://downloads.digium.com/pub/asterisk/asterisk-addons-1.4-current.tar.gz

Ensuite, décompressons les archives (.tar.gz) téléchargées:

tar zxvf asterisk-1.4-current.tar.gz

tar zxvf zaptel-1.4-current.tar.gz

tar zxvf libpri-1.4-current.tar.gz

tar zxvf asterisk-addons-1.4-current.tar.gz

Installation des dépendances

La compilation des modules Zaptel nécessite la présence des en-têtes (headers) du noyau de Linux; nous installerons donc celles-ci:

apt-get install linux-headers-`uname -r`

La compilation de Asterisk requiert elle aussi certains logiciels et librairies:

apt-get install libncurses5-dev bison libssl-dev libcap-dev libnewt-dev zlib1g-dev procps gcc g++ make binutils doxygen

Si vous pensez avoir besoin des fonctionnalités ODBC ainsi que de la fonction de plan d’appel func_curl (ce qui est mon cas), installez les deux librairies suivantes. L’installation de celles-ci n’est nullement obligatoire pour le bon fonctionnement de Asterisk.

apt-get install unixodbc-dev libmyodbc libmysqlclient15-dev libcurl4-openssl-dev

De plus, je vous propose d’installer des librairies supplémentaires qui vous permetteront d’utiliser les codecs audio libres Speex et Ogg Vorbis:

apt-get install sox libsox-fmt-all libspeex-dev libogg-dev libvorbis-dev

Installation de Zaptel

Nous allons maintenant compiler et installer la suite de pilotes Zaptel, en entrant d’abord dans le répertoire créé précédemment par la décompression de l’archive:

cd zaptel-1.4-current

./configure

make menuselect (optionnel)

make

make install

make config

Une fois les pilotes créés (sous forme de modules), nous nous assurerons que le module ztdummy soit lancé directement à l’exécution de zaptel (qui est lui-même lancé au démarrage). Ouvrons le fichier /etc/default/zaptel dans un éditeur de texte:

vim /etc/default/zaptel

Puis enlevons le dièse (#) qui se trouve devant la ligne suivante:

#MODULES= »$MODULES ztdummy »

Enregistrons nos modifications, et lançons zaptel:

/etc/init.d/zaptel start

L’installation du pilote ztdummy est terminée; passons maintenant à l’installation des libraires PRI.

Installation de Libpri

Bien que les librairies PRI ne nous soient d’aucune utilité si nous n’avons aucune interface T1/E1, l’installation de celles-ci est conseillée et vient compléter l’installation d’Asterisk.

cd ../libpri-1.4-current

make

make install

C’est tout. Passons maintenant à l’installation d’Asterisk.

Installation de Asterisk

Une fois à l’intérieur du dossier créé précédemment lors de la décompression de l’archive (.tar.gz) de Asterisk, nous aurons à exécuter quelques commandes qui compileront et installeront Asterisk sur le système.

cd ../asterisk-1.4-current

./configure

make menuselect (optionnel)

make

make install

Si tout se passe bien, l’installation devrait se terminer et on devrait vous proposer deux nouvelles commandes qui, respectivement, créent les échantillons de fichiers de configuration dans /etc/asterisk et créent les fichiers de documentation.

make samples

make progdocs

Nous créerons finalement les scripts de démarrage et d’arrêt dans les dossiers représentant les différents niveaux d’exécutions (/etc/rcX.d):

make config

Installation des Addons

Les addons d’Asterisk nous permettent, dans le cas de app_addon_sql_mysql, cdr_addon_mysql, res_config_mysql, de respectivement effectuer des requêtes SQL à l’intérieur d’un plan d’appel (dial plan), entreposer les détails des appels (CDR) ainsi que les instructions contenues dans certains fichiers de configuration (qui permet une modification et une application en temps réel) à l’intérieur d’une base de données MySQL.

cd ../asterisk-addons-1.4-current

./configure

make menuselect (optionnel)

make

make install

Sécurisation et configuration d’Asterisk

Dans un soucis de sécurité, nous créerons un utilisateur et un groupe sans privilèges sous lesquels nous lancerons Asterisk; puis, nous modifierons les permissions des divers fichiers/dossiers installés plus tôt sur le système pour que Asterisk y ait bien accès:

adduser –system –no-create-home –home /var/lib/asterisk –shell /bin/false asterisk

addgroup –system asterisk

adduser asterisk asterisk

adduser asterisk audio

Nous allons maintenant faire en sorte que Asterisk utilise bel et bien le nom d’utilisateur et le groupe créés précédemment lors de son exécution, en allant modifier son script de démarrage. Commençons par ouvrir ce fichier avec un éditeur de texte:

vim /etc/init.d/asterisk

Puis, enlevons les dièses (#) devant les lignes suivantes:

#AST_USER=”asterisk”

#AST_GROUP=”asterisk”

Créons maintenant un dossier distinct où le process ID (PID) de Asterisk pourra résider.

mkdir /var/run/asterisk

chown asterisk.asterisk /var/run/asterisk

Nous nous devons alors d’avertir Asterisk que son dossier d’exécution a été changé, en effectuant une modification dans le fichier asterisk.conf.

vim /etc/asterisk/asterisk.conf

Remplaçons maintenant la ligne contenant astrundir => /var/run par la ligne suivante:

astrundir => /var/run/asterisk

Pour que Asterisk puisse accéder (lire) et/ou sauvegarder (écrire) de l’information à l’intérieur de fichiers présents dans différents dossiers, ceux-ci doivent lui appartenir. Nous devrons donc changer la propriété (lire ici ownership) de ces dossiers:

chown -R asterisk.asterisk /etc/asterisk

chown -R asterisk.asterisk /usr/lib/asterisk

chown -R asterisk.asterisk /var/log/asterisk

chown -R asterisk.asterisk /var/spool/asterisk

chown -R asterisk.asterisk /var/lib/asterisk

chown -R asterisk.asterisk /dev/zap/pseudo

Si vous avez décidé d’installer les jeux de sons français, il se peut que tout ce qui à trait aux nombres (chiffres, dates, heures, etc.) soit tout de même dit en anglais, que vous le vouliez ou non. Pour palier à ce problème, il suffit de créer le lien symbolique suivant:

ln -s /var/lib/asterisk/sounds/fr/digits /var/lib/asterisk/sounds/digits/fr

Démarrons finalement Asterisk à partir de la ligne de commande, en prenant soin d’activer la console et la verbosité (-cvv), dans le but d’être informé d’une quelconque erreur fatale.

asterisk -U asterisk -G asterisk -cvv

Dans l’éventualité d’une d’erreur qui empêcherait l’exécution de Asterisk, une petite recherche (sur Google, par exemple) de ce message s’imposerait; à moins de circonstances particulières, les chances que vous soyez le/la seul(e) a avoir rencontré cette erreur jusqu’à maintenant sont quasi-nulles, et il est très probable qu’une solution à celle-ci ait déjà été trouvée par la communauté.

Si par contre, tout s’est bien passé (on l’espère!), nous sommes maintenant prêts à démarrer Asterisk à partir du script d’exécution créé plus tôt par la commande make config.

/etc/init.d/asterisk start

Et voilà! Asterisk est installé et est en cours d’exécution.

viaInstallation de Asterisk 1.4 sous Debian Etch | Sébastien Couture.