Installation et configuration d'un serveur IPBX Asterisk 1.4

Sommaire

1 - Installation d’Asterisk 1.1 Prérequis

1.2 Récupération des sources

1.3 Compilation

2 - Configuration d’Asterisk 2.1 sip.conf

2.2 extensions.conf

2.3 Prise en compte des configurations

3 - Ajout de fonctions 3.1 Transfert d’appel

3.2 Mise en attente

3.3 Messagerie vocale

3.4 Configuration du MTA pour la messagerie vocale

4 - Asterisk en temps réel avec MySQL 4.1 Prérequis

4.2 Récupération des sources Asterisk Add-Ons

4.3 Compilation

4.4 Configuration initiale

4.5 Migration du fichier sip.conf

4.6 Migration du fichier extension.conf

1 - Installation d'Asterisk

1.1 Prérequis

Liste des dépendances nécessaires à l’installation :

- glibc-source

- ncurses-dev

- zlib1g-dev

1.2 Récupération des sources

Direction www.asterisk.org pour récupérer les sources.

Il est conseillé de choisir la version LTS (Long Time Support), ici la version 1.4.

On télécharge l’archive dans le répertoire /usr/src/, puis on détare :

1.3 Compilation

On se déplace dans le répertoire détarré et on compile:

On crée des fichiers de configuration d’exemple.

On copie le bon script init pour le lancement automatique au démarrage suivant sa distribution,

ici Debian.

# cp /usr/src/astrisk/contrib/init.d/rc.debian.asterisk /etc/init.d/asterisk

Attention : Ce script semble problématique sur Debian 5. En effet, si Asterisk est lancé

par ce biais, la consommation du CPU monte à 99% en permanance.

Un moyen de contourner ce problème peut être de passer par inittab, en ajoutant dans celui-ci :

Le 2 correspond au runlevel, donc de cette manière asterisk se lance au démarrage et se

relance grâce au respawn si le processus meurt pour n’importe quelle raison. On n’oublie pas

de désactiver le script init au démarrage :

2 - Configuration d’Asterisk

Pour qu’Asterisk fonctionne de manière basique, il est nécessaire de modifier seulement deux

fichiers de configuration : sip.conf et extensions.conf.

Ces fichiers de configurations se trouvent dans /etc/asterisk.

2.1 sip.conf

C’est dans ce fichier que l’on définit les comptes sip des utilisateurs. Pour être fonctionnel, un

compte a besoin d’au minimum 6 lignes :

Voyons en détail chaque ligne :

[utilisateur1] est le début du bloc SIP. Les informations présentes après cette ligne

concerneront le compte [utilisateur1].

type=friend permet d’appeler et d’être appelé.

host=dynamic l’adresse ip du client est définie par DHCP. Si son IP était fixe on l’aurait

précisé ici.

user=utilisateur1 le nom utilisateur

secret=mysceret le mot de passe en clair

context=default le contexte auquel le compte est associé dans le dialplan (servira pour le

fichier extensions.conf)

Une liste des options possibles :

http://www.voip-info.org/wiki/view/Asterisk+config+sip.conf\#SIPconfigurationspeersandclients

A noter qu’en utilisant ’secret’, le mot de passe est stocké en clair. Il est préférable d’utiliser

’md5secret’, qui, comme son nom l’indique, utilisera un hash md5. Voici la structure nécessaire

pour la génération du hash :

Par défaut le realm est ’asterisk’. Pour générer le hash de l’utilisateur toto qui a pour mot de

passe ’tutu’ avec bash, on fait donc :

2.2 extensions.conf

C’est dans ce fichier que l’on définit le dialplan, c’est à dire le plan de la numérotation. On

explicite l’action qui se déroulera si l’on compose un numéro. Voici ce que pourrait contenir

ce fichier :

Le [default] est ce qu’on appelle un contexte. Le contexte est une zone où la portée des

actions est limitée. Cela permet par exemple d’attribuer deux numéros identiques à des

utilisateurs différents, l’un ou l’autre sera contacté suivant le contexte définit dans le compte

SIP de l’utilisateur cherchant à les joindre.

La ligne suivante nous montre comment enregistrer une extension.

On commence par le mot clé exten suivi d’une flèche =>.

Le 100 est le numéro que l’on souhaite associer, c’est ce que l’on composera sur le téléphone.

Le 1 est le numéro de séquence. On peut en effet ordonner plusieurs actions pour une même

extension.

Dial(SIP/utilisateur1) est l’action à effectuer. On appelle ici la fonction Dial(), qui déclenche

l’appel, avec pour argument SIP/utilisateur1 pour appeler le compte SIP utilisateur1.

Ici donc, pour tous les utilisateurs du contexte default, composer le 100 appelera l’utilisateur1

Un petit exemple pour assimiler la notion de séquence :

Ici, j’attends 5 secondes avant de sonner, puis j’appelle l’utilisateur1.De nombreuses actions

sont possibles, au dela du simple appel. En voici une liste :

http://www.voip-info.org/tiki-index.php?page=Asterisk+-+documentation+of+application+commands

2.3 Prise en compte des configurations

Pour toute modification du sip.conf et du extensions.conf, il est nécessaire qu’Asterisk

recharge ces fichiers. Pour cela, on se logue sur la console d’Asterisk :

Puis on recharge Asterisk :

La commande suivante permet de recharger uniquement le dialplan (extensions.conf) :

A ce moment-là, le serveur est opérationnel. L’utilisateur1 possède un compte SIP et un numéro

lui est associé. Il ne reste plus qu’à ajouter d’autres utilisateurs et mettre à jour le dialplan.

3 - Ajout de fonctions

Il faut noter que le transfert d’appel et la mise en attente sont souvent directement implémentés

dans les softphone et les terminaux SIP. Les manipulations suivantes permettent de les activer

directement dans Asterisk, ce qui permet de s’affranchir d’un logiciel ou matériel particulier.

3.1 Transfert d’appel

Il est nécessaire avant tout d’activer les tonalités DTMF à la fois côté client et serveur. Pour

Asterisk, il suffit d’ajouter la ligne suivante dans sip.conf, dans le contexte [général] ou pour

chaque utilisateur :

La démarche à suivre côté client dépend du client, il faut regarder du coté des paramètres SIP.

Pour activer le transfert d’appel, il suffit simplement de modifier les paramètres de la fonction

Dial dans extensions.conf :

Après SIP/utilisateur1, nous avon ajouté les options t et T qui autorisent l’appelé et l’appelant

à transférer l’appel (nous reviendrons sur les deux virgules précédentes dans une prochaine

section).

Pour effectuer le transfert, il faut appuyer durant une communication sur le # (on entend à ce

moment la ”transfer”) suivi du numéro sur lequel on souhaite transférer l’appel.

3.2 Mise en attente

La mise en attente permet de mettre une communication en pause. Cela est très utile, car du

coup la ligne est libérée. On peut alors composer un autre numéro, ou récupérer l’appel sur un

autre poste.

Il est là aussi nécessaire d’activer les tonalités DTMF (cf section précédente). Pour activer la

mise en attente, il suffit d’ajouter la ligne suivante dans le contexte default du fichier

extensions.conf :

Pour mettre son interlocuteur en attente lors d’un appel, il faut composer le #700. Le serveur

attribue un numéro au sein du parc d’attente. On peut alors raccrocher, changer de poste, et

reprendre l’appel en composant le numéro annoncé par le serveur.

3.3 Messagerie vocale

Si on veut que la voix de la messagerie soit en français, il faut le spécifier lors de la

compilation d’Asterisk à l’aide de la commande :

Il faut ensuite ajouter dans le contexte [general] de sip.conf la ligne suivante :

On crée une boite vocale dans le fichier /etc/asterisk/voicemail.conf, dans la partie [default] :

Le 100 est le numéro de téléphone auquel on associe la boite vocale.

Le 1010 est le mot de passe de la messagerie.

Suivent le nom de l’utilisateur, ainsi que son mail. Le mail servira à l’alerter en cas de

réception de message vocal, à condition qu’un MTA soit correctement configuré (nous le

verrons plus tard).

La boite vocale est maintenant déclarée, il reste à l’inclure dans extensions.conf pour qu’elle

soit utilisée :

Nous avions déjà vu un exemple de séquences, en voici un nouveau.

La première action effectuée lorsque l’on compose le 101 est l’appel de l’utilisateur1. Le 10

situé après la virgule est le timeout avant de passer à la deuxième séquence. C’est pour cela

que l’on avait mis deux virgules de suite dans la section transfert d’appel.

Une fois le timeout atteint, on bascule sur la deuxième séquence, qui est l’appel de la boite

vocale avec la fonction Voicemail.

Enfin, on raccroche avec la fonction Hangup.

3.4 Configuration du MTA pour la messagerie vocale

Il est en effet très intéressant de passer par une alerte mail lors de la réception d’un message :

l’utilisateur est alors au courant qu’il a un message, et peut l’écouter directement en pièce jointe.

On a déjà renseigné l’adresse mail de l’utilisateur dans voicemail.conf, il ne reste plus qu’à

configurer un MTA.

J’ai ici arbitrairement choisi exim4, car c’est le MTA par défaut de Debian.

Puisque exim4 est déjà installé, on va simplement le reconfigurer :

dpkg-reconfigure exim4-config

Type de configuration : Distribution directe par SMTP (site Internet)

Nom de courriel du système :le FQDN

Liste d’adresses IP où Exim sera en attente de connexions SMTP entrantes : 127.0.0.1

Autres destinations dont le courriel doit être accepté : vide

Domaines à relayer : vide

Machines à relayer : vide

Faut-il minimiser les requêtes DNS (connexions à la demande) ? Non

Méthode de distribution du courrier local : Format "mbox" dans /var/mail

Faut-il séparer la configuration dans plusieurs fichiers ? Non

Le serveur mail va se relancer, Asterisk est désormais capable d’envoyer des mails d’alerte avec le

message vocal en pièce jointe.

4 - Asterisk en temps réel avec MySQL

Comme nous venons de le voir, pour que toute modification de sip.conf ou extensions.conf

soit prise en compte, il est nécessaire de recharger le serveur Asterisk. Si on a un vrai besoin

d’une prise en compte en temps réel et d’une plus grande souplesse dans la configuration, la

migrer vers MySQL peut être extrêmement intéressant.

On peut en fait se servir de tables au lieu de fichiers de configuration. Lorsque l’on modifiera

ces tables, celles-ci seront prises en compte instantanément, sans avoir besoin de recharger le

serveur.

Cette fonctionnalité, bien que puissante, est considérée comme experimentale. C’est pour

cette raison qu’elle n’est pas présente directement dans les sources. Il est nécessaire de

télécharger et installer les Add-Ons d’Asterisk.

4.1 Prérequis

Dépendances nécessaires :

- mysql-client

- mysql-server

- libmysqlclient-dev

4.2 Récupération des sources Asterisk Add-Ons

Toujours sur www.asterisk.org, on télécharge les sources dans /usr/src puis on détarre :

4.3 Compilation

On se déplace dans le répertoire détaré et on compile :

Il est conseillé de vérifier avec make menuselect si les modules dépendants de mysql sont bien

activés et s’il ne manque aucune dépendance.

4.4 Configuration initiale

Une fois la compilation effectuée, il on copie ces 2 fichiers :

Les paramètres de connexion d’Asterisk à MySQL sont définis dans le fichier res_mysql.conf :

4.5 Migration du fichier sip.conf

En premier lieu il est nécessaire de créer la base ’asterisk’ dans MySQL.

On entre la requete SQL suivante à l’aide du client mysql en ligne de commande ou au travers

d’une interface web de type phpmyadmin :

Puis on crée la table ’sip’ :

mysql>CREATE TABLE ‘sip‘ (

‘id‘ int(11) NOT NULL auto_increment,‘name‘ varchar(80) NOT NULL default ’’,

‘accountcode‘ varchar(20) default NULL,‘amaflags‘ varchar(13) default NULL,

‘callgroup‘ varchar(10) default NULL,‘callerid‘ varchar(80) default NULL,

‘canreinvite‘ char(3) default ’yes’,‘context‘ varchar(80) default NULL,

‘defaultip‘ varchar(15) default NULL,‘dtmfmode‘ varchar(7) default NULL,

‘fromuser‘ varchar(80) default NULL,‘fromdomain‘ varchar(80) default NULL,

‘fullcontact‘ varchar(80) default NULL,‘host‘ varchar(31) NOT NULL default ’’,

‘insecure‘ varchar(4) default NULL,‘language‘ char(2) default NULL,

‘mailbox‘ varchar(50) default NULL,‘md5secret‘ varchar(80) default NULL,

‘nat‘ varchar(5) NOT NULL default ’no’,‘deny‘ varchar(95) default NULL,

‘permit‘ varchar(95) default NULL,‘mask‘ varchar(95) default NULL,

‘pickupgroup‘ varchar(10) default NULL,‘port‘ varchar(5) NOT NULL default ’’,

‘qualify‘ char(3) default NULL,‘restrictcid‘ char(1) default NULL,

‘rtptimeout‘ char(3) default NULL,‘rtpholdtimeout‘ char(3) default NULL,

‘secret‘ varchar(80) default NULL,‘type‘ varchar(6) NOT NULL default ’friend’,

‘username‘ varchar(80) NOT NULL default ’’,‘disallow‘ varchar(100) default ’all’,

‘allow‘ varchar(100) default ’g729;ilbc;gsm;ulaw;alaw’,

‘musiconhold‘ varchar(100) default NULL,‘regseconds‘ int(11) NOT NULL default ’0’,

‘ipaddr‘ varchar(15) NOT NULL default ’’,‘regexten‘ varchar(80) NOT NULL default ’’,

‘cancallforward‘ char(3) default ’yes’,‘setvar‘ varchar(100) NOT NULL default ’’,

PRIMARY KEY (‘id‘),

UNIQUE KEY ‘name‘ (‘name‘),

KEY ‘name_2‘ (‘name‘)

) TYPE=MyISAM ROW_FORMAT=DYNAMIC;

La requête est intentionnellement lourde pour avoir tous les champs disponibles dès le départ.

Cela permet d’affecter des valeurs par défaut sur certains champs, et d’avoir les autres déjà prêts

pour plus tard, au cas où.

On va créer un compte avec cette requête :

Pour vérifier, on va utiliser le CLI de MySQL. On se connecte sur la base asterisk :

On regarde les champs précédemment remplis :

Enfin, on va spécifier à Asterisk d’aller chercher les paramètres SIP dans MySQL. Il suffit

d’ajouter ces 2 lignes à la fin du fichier extconfig.conf :

Au prochain redémarrage d’Asterisk, il ira chercher les données des comptes SIP dans la table

sip de MySQL en complément du fichier sip.conf.

4.6 Migration du fichier extension.conf

On crée la table SQL ’extensions’ :

On renseigne cette table avec un numéro de téléphone associé au compte SIP précédemment

créé :

On vérifie à l’aide de la requête suivante :

La structure est quasiment identique au fichier extensions.conf.

Comme précédemment, il faut rajouter une ligne à extconfig.conf pour dire à Asterisk d’aller

chercher les extensions dans MySQL :

# echo ’extensions => mysql,asterisk,extensions’ >> /etc/asterisk/extconfig.conf

Enfin, il faut rajouter à la fin de extensions.config une ligne renvoyant vers la base SQL :

Au prochain redémarrage d’Asterisk, les extensions seront chargées à partir de la table MYSQL

’asterisk’, en complément du fichier extensions.conf.