Sommaire

  1. Avant propos
  2. Infrastructure matériel et réseau nécessaire
  3. Mise à jour depuis Asterisk 1.2
  4. Installation du système Asterisk AUF
    1. Ajout des sources
    2. Installation d'Asterisk
    3. Création d'une paire clé privée + clé publique pour l'interconnexion
    4. Diffusion de la clé publique
    5. Utilisation de la clé privée
  5. Lancement du serveur
  6. Premiers tests
  7. Configuration des comptes clients
    1. Configuration détaillée pour un téléphone IP matériel
  8. Annexes
    1. Annexe 1 : suivi et débogage du serveur
    2. Annexe 2 : quand tout est cassé, réinstallation complète d'Asterisk
    3. Annexe 3 : statistiques

Avant propos

Cette page présente l'installation du logiciel Asterisk qui est un commutateur téléphonique privé (PABX) que nous utilisons à l'AUF pour notre système de voix sur IP (VoIP). Cette page se concentre sur les aspects spécifiques à l'installation «AUF». Pour des informations plus générales, voir :

Infrastructure matériel et réseau nécessaire

Vous devez disposer d'une machine Debian Etch sur la DMZ. Dans un premier temps, si possible, prendre une machine qui ne fait rien d'autre, cela permettrait de voir la charge (une petite machine de test suffit) et d'éviter de casser d'autres choses autour. Une fois que tout sera testé, vous pourrez déployer sur une machine de production qui fait éventuellement autre chose.

La machine doit :

Note 1 : si votre DMZ est en IP privée, ajoutez un DNAT vers cette machine pour le protocole IAX (4569/UDP).

Note 2 : suivant les clients SIP que vous utilisez, vous pourrez peut-être y fixer les ports SIP et RTP, ce qui simplifie un peu les règles de pare-feu. Ceci étant, avoir des clients IAX simplifie beaucoup la vie ! Si possible, évitez d'utiliser le protocole SIP (pour l'instant).

Mise à jour depuis Asterisk 1.2

Si vous avez déjà un serveur en Debian Etch qui tourne avec l'ancienne version Asterisk 1.2, vous devez le mettre à jour. Ces paquets ne sont en effet plus maintenus. La mise à jour est simple et ne demande que 10 minutes d'interruption de service VoIP. La procédure est disponible ici : /MiseAJour14

Si votre serveur est encore en Debian Sarge, vous devez le migrer vers Etch. Les paquets VoIP pour Debian Sarge ne sont plus maintenus (depuis très longtemps).

Installation du système Asterisk AUF

Si vous avez déjà un système Asterisk AUF en version 1.2, reportez-vous à la section ci-dessus (Mise à jour).

La version Asterisk fournie par Debian Etch est la 1.2, elle un peu ancienne et non supportée par les développeurs d'Asterisk. Nous avons donc construit des paquets compatibles avec Debian Etch proposant la version 1.4 d'Asterisk. Ces paquets sont en partie construits à partir des paquets disponibles dans la future version Debian Lenny.

L'installation n'est disponible que pour Debian Etch i386. Une version amd64 suivra. En revanche, aucune version pour Sarge n'est prévue.

Ajout des sources

Il faut ajouter les sources de paquets suivantes dans le fichier /etc/apt/sources.list:

Comme après toute modification de sources.list, mettre à jour la liste des paquets disponibles dans les sources :

Notez bien : ces sources de paquets sont signées, pour que APT leur fasse confiance il vous faut ajouter la clé publique du dépôt AUF. Si vous ne l'avez pas déjà fait, il suffit d'installer le paquet auf-keyring puis de recharger à nouveau la liste des paquets :

Installation d'Asterisk

Installer Asterisk avec :

Les paquets suivants seront installés automatiquement, par dépendance :

Note : durant cette installation, un message vous sera affiché de la part du paquet asterisk-config-auf vous signalant que vous n'avez pas encore de clefs pour Asterisk. C'est normal... vous n'en avez pas encore ;-) Continuez la lecture de cette procédure d'installation, tout y est expliqué.

Création d'une paire clé privée + clé publique pour l'interconnexion

Afin d'être intégré au système VoIP de l'AUF, vous devez disposer d'un couple de clés, privée et publique. La clé publique sera diffusée sur l'ensemble des autres noeuds VoIP de l'Agence afin qu'ils vous autorisent à appeler leurs postes. La clé privée sera, comme son nom l'indique, connue de votre serveur Asterisk seul.

/!\ Attention : si vous installez un nouveau serveur mais que vous aviez déjà le service VoP en place, utilisez la clé privée de votre ancien serveur au lieu d'en gérer une nouvelle. Il suffira ensuite de mettre à jour votre enregistrement DNS voip.xx.auf.org pour qu'il pointe vers l'adresse IP de votre nouveau serveur.

  1. Pour générer vos clés (uniquement si vous n'en aviez pas déjà) : 
    $ /usr/sbin/astgenkey -q -n auf-implantation     # exemples : auf-dakar, auf-ifmt, auf-montreal

    Note : astgenkey nécessite openssl. Si astgenkey ne fonctionne pas, faites un aptitude install openssl

  2. Puis copiez ces clés pour que Asterisk les prenne en compte : 
    # cp auf-implantation.pub auf-implantation.key /usr/share/asterisk/keys
# chown -R root.asterisk /usr/share/asterisk/keys/*
# chmod 644 /usr/share/asterisk/keys/*.pub
# chmod 640 /usr/share/asterisk/keys/*.key

Conservez précieusement le fichier auf-implantation.key : sans cette clé privée vous ne pourrez plus appeler d'autres systèmes !

Diffusion de la clé publique

Indiquez votre clé publique sur la page /Clefs et prévenez-moi (ThomasNoël) afin que je l'ajoute à la liste des clés à distribuer.

Cette clé sera ajoutée au paquet asterisk-config-auf-connexions. Vous pourrez ensuite appeler tous les sites qui mettront à jour ce paquet sur leur système, puisqu'ils disposeront de votre clé publique et sauront donc vous reconnaître.

Utilisation de la clé privée

Pour que votre clé privée soit utilisée par Asterisk, vous devez (re)configurer le paquet asterisk-config-auf. Celui-ci va détecter votre clé privée (si elle est correctement installée dans /usr/share/asterisk/keys/) et vous poser quelques questions de base. Pour effectuer cette configuration :

Le paquet va alors vous demander de confirmer le nom de votre noeud VoIP, sous la forme auf-implantation où implantation est en général le nom de la ville de votre implantation. Quelques exemples : auf-dakar, auf-paris, auf-bap1 et auf-bap2, auf-caimaurice, etc.

Quelques explications rapides sur le paquet asterisk-config-auf :

Lancement du serveur

Activer le démarrage automatique d'asterisk au démarrage de la machine dans /etc/default/asterisk :

Puis lancer le serveur :

Premiers tests

Configurez un client (IAX de préférence) et enregistrez-le sur votre Asterisk avec le compte "test", mot de passe "test". Essayez d'appeler le *11 (echo).

Si votre clé publique a déjà été distribuée, essayer d'appeler 0033*11 (echo Paris) et 001*11 (echo Montreal). Puis, demandez à quelqu'un hors de votre implantation d'essayer d'appeler votre echo puis son poste (00xxx*11, où xxx est l'extension internationale de votre pays).

Dès que ça marche, supprimez le compte test (dans les fichiers /etc/asterisk/auf/*.local) !

Configuration des comptes clients

Pour chaque poste client qui sera installé dans votre implantation (téléphone IP matériel ou logiciel), vous devez créer un compte. Tout se passe dans /etc/asterisk/auf. Les fichiers dont le nom se termine par .local sont ceux que vous devez adapter.

  1. /etc/asterisk/auf/sip.local : les comptes SIP locaux

  2. /etc/asterisk/auf/iax.local : les comptes IAX locaux. Note : si vous avez installé votre Asterisk avant le 10 janvier 2007, ce fichier est un lien symbolique vers sip.local. Cependant, vous pouvez rapidement avoir besoin d'une configuration différente : faites-en un fichier séparé.

  3. /etc/asterisk/auf/extensions.local : les associations entre numéro de téléphone et compte local à appeler

  4. /etc/asterisk/auf/voicemail.local : les boites vocales

Quand vous touchez à ces fichiers, n'oubliez pas ensuite de faire un /etc/init.d/asterisk reload. Attention, lors d'un reload si iax.conf a changé Asterisk oublie les clients qui étaient actuellement enregistrés : il faudra attendre au plus 2 minutes afin que tous les clients (les téléphones IP) se soient bien ré-enregistrés. Autrement dit : essayez de faire vos reload en heure creuse.

Configuration détaillée pour un téléphone IP matériel

A ajouter dans `/etc/asterisk/auf/iax.local`
; section à ajouter pour chaque poste

[prenom.nom]
; type=friend veut dire qu'il peut appeler _et_ être appelé
type=friend
; callerid : comment sera vu l'utilisateur par les personnes qu'il voudra contacter
; Il faut être TRES PRECIS ici, attention aux guillemets (") et aux signes < et >
; Prenom NOM : doit faire au maximum 16 caractères, uniquement ASCII (aucun accent)
;              afin de bien s'afficher sur un téléphone IP (écran LCD de 16 caractères)
; 00pppnnn   : numéro du poste, avec préfixe international. Uniquement des chiffres, aucun espace
callerid="Prenom NOM" <00pppnnn>
; Cette boite doit exister dans voicemail.local
mailbox=206@AUF
; Paramètres d'authentification. Note : on met le mot de passe en clair
user=prenom.nom
secret=mot_de_passe
; host=dynamic : l'adresse IP du poste sera connue lors de la connexion de celui-ci
host=dynamic
; Contexte dans lequel se place ce poste (en gros, indique quels sont les numéros
; qu'il aura le droit d'appeler : ils doivent être dans le même contexte que lui)
context=AUF
; Codec : on n'accepte que le codec ulaw (belle qualité, quasiment pas de compression.
; Asterisk effectuera la compression si besoin, par exemple pour une communication 
; internationale avec un pays à faible bande passante.
disallow=all
allow=ulaw
A ajouter dans `/etc/asterisk/auf/extensions.local`
; nnn est le numéro local du poste (sans le préfixe international)
exten => nnn,1,Macro(AUFDial,prenom.nom)
A ajouter dans `/etc/asterisk/auf/voicemail.local`
; nnn  : le numéro local du poste concerné
; PASS : le mot de passe, idéalement 3 ou 4 chiffres (et uniquement des chiffres !)
; Note : on met un "-" devant le mot de passe afin qu'Asterisk ne tente pas de le 
;        changer ; nous cherchons cependant une solution permettant aux personnes
;        de modifier leur mot de passe...
nnn => -PASS,Prenom NOM,prenom.nom@auf.org

Pour des petits exemples plus concrets, voir /ExempleDeConfiguration

Annexes

Annexe 1 : suivi et débogage du serveur

Les commandes de base :

Asterisk dispose d'un mode console, en ligne de commande, très pratique et qu'il est conseillé d'approfondir si vous voulez vraiment vous amuser avec Asterisk. Ce mode console est disponible avec asterisk -r ou rasterisk. En ajoutant l'option -v vous pouvez de plus déboguer en direct (affichage des logs sur la console). Plus vous mettez de -v plus le niveau de débogage est élevé. Pour bien comprendre comment fonctionne Asterisk il est donc conseiller de lancer carrément la commande suivante :

Vous êtes alors en mode ligne de commande (CLI = command line interface). Elle fonctionne un peu comme sur la ligne de commande d'un Cisco : tapez help pour avoir la liste des commandes, utilisez la touche [Tab] ou ? pour la complétion automatique, etc.

Une commande extrémement utile est module reload :

qui va demander à asterisk de relancer tous ses modules. Chacun va relire son fichier de configuration. Vous pouvez être plus précis en ne demandant la recharge que de certains modules, par exemple :

Annexe 2 : quand tout est cassé, réinstallation complète d'Asterisk

  1. Suppression complète (n'oubliez pas de copier d'abord au moins votre clé privée !) : 

    # /etc/init.d/asterisk stop
# mkdir -p /root/asterisk-backup
# cp -a /etc/asterisk /root/asterisk-backup/etc             # on garde une copie de la configuration
# cp -a /usr/share/asterisk/keys /root/asterisk-backup/keys # on garde une copie des clés
# aptitude purge asterisk asterisk-config-auf asterisk-config-auf-connexions asterisk-app-conference asterisk-prompt-fr asterisk-sounds-main asterisk-moh-auf
# rm -rf /etc/asterisk /usr/share/asterisk /var/lib/asterisk /var/spool/asterisk /var/run/asterisk

Note : éventuellement, pensez à copier les fichiers de logs pour les statistiques, contenus dans /var/log/asterisk/.

  1. Réinstallation : 
    # mkdir -p /usr/share/asterisk/keys                                 # on remet en place la clé privée (début)
# cp -a /root/asterisk-backup/keys/*.key /usr/share/asterisk/keys   # on remet en place la clé privée (fin)
# aptitude install asterisk

  2. Reconfiguration : reprendre les configurations des postes clients (sip.local, iax.local, extensions.local, etc.) que vous avez copiées dans /root/asterisk-backup/etc.

Annexe 3 : statistiques

Voir la sous page /Stats : mise en place d'un système de statistiques pour Asterisk

CatégorieLogiciel CatégorieVoIP CatégorieRecommandationDRI