La tlphonie Open Source

Asterisk

Installation et mise en oeuvre dun PaBX VoIP

Traduction de Alexandre Belloni, Yann Serra et Giles Carr

De Jim Van Meggelen, Leif Madsen & Jared Smith

Asterisk
La tlphonie Open Source

Jim Van Meggelen, Leif Madsen & Jared Smith

Asterisk
La tlphonie Open Source
Traduction dAlexandre Belloni, Yann Serra et Giles Carr

Digit Books
diteur de livres numriques Brest

---infos@digitbooks.fr http://www.digitbooks.fr

 Digit Books, 2009, pour la traduction franaise Couverture : Yves Buraud Illustration de Un capitaine de quinze ans de Jules Verne (1877-78) de Henri Meyer.

ISBN : 9782815000086 Prix : 33

http://www.digitbooks.fr/catalogue/9782815000086.html

OReilly Media, 2008 Ldition originale de ce livre a t publie aux tats-Unis par OReilly Media sous le titre Asterisk.

Les programmes gurant dans ce livre ont pour but dillustrer les sujets traits. Il nest donn aucune garantie quant leur fonctionnement une fois compils, assembls ou interprts dans le cadre dune utilisation professionnelle ou commerciale.

Toute reprsentation ou reproduction, intgrale ou partielle, faite sans le consentement de lauteur, de ses ayants droit, ou ayants cause, est illicite (loi du 11 mars 1957, alina 1er de larticle 40). Cette reprsentation ou reproduction, par quelque procd que ce soit, constituerait une contrefaon sanctionne par les articles 425 et suivants du Code pnal. La loi du 11 mars 1957 autorise uniquement, aux termes des alinas 2 et 3 de larticle 41, les copies ou reproductions strictement rserves lusage priv du copiste et non destines une utilisation collective dune part et, dautre part, les analyses et les courtes citations dans un but dexemple et dillustration.

Table des matires

Table des matires Prface
Audience . . . . . . . . . . . . . . Organisation . . . . . . . . . . . . Logiciel . . . . . . . . . . . . . . . Conventions utilises dans ce livre Utiliser les exemples . . . . . . . . Comment nous contacter . . . . . Remerciements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

v xi
xi xi xiii xiii xiii xiv xiv

1 Une rvolution pour la tlphonie

La VoIP et le goure entre tlphonies conventionnelle et en rseau Les grands changements exigent une technologie souple . . . . . . Asterisk, le PABX du hacker . . . . . . . . . . . . . . . . . . . . . . . Asterisk : Le PABX professionnel . . . . . . . . . . . . . . . . . . . . La communaut Asterisk . . . . . . . . . . . . . . . . . . . . . . . . Ltude de cas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ce livre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1
2 3 4 5 5 7 8

2 Prparation dun systme pour Asterisk

Choix du matriel pour le serveur Environnement . . . . . . . . . . Matriel Tlphonique . . . . . . Types de poste tlphonique . . . Considrations sur Linux . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9
11 18 22 25 29 29

vi

Table des matires

3 Installation dAsterisk
De quels paquetages aurai-je besoin ? . . . . . Tlchargement du code source . . . . . . . . Menu de slection . . . . . . . . . . . . . . . . Compilation de Zaptel . . . . . . . . . . . . . . Compilation de libpri . . . . . . . . . . . . . . Compilation dAsterisk . . . . . . . . . . . . . Installation dannonces complmentaires . . . Problmes rcurrents de compilation . . . . . Chargement rapide dAsterisk et de Zaptel . . Chargement des modules de Zaptel sans script Chargement de libpri sans script . . . . . . . . Chargement dAsterisk sans script . . . . . . . Rpertoires utiliss par Asterisk . . . . . . . . AsteriskNOW . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31
31 34 36 37 40 40 43 43 47 47 49 49 50 54 57

4 Conguration initiale dAsterisk

De quoi ai-je vraiment besoin ? . . . . . . . . . . . . . . . . . Gestion des chiers de conguration dinterface . . . . . . . Initialisation du plan de numrotation de test . . . . . . . . Canaux FXO et FXS . . . . . . . . . . . . . . . . . . . . . . . Conguration dun canal FXO connect au RTC . . . . . . . Conguration dun canal FXS pour un tlphone analogique Conguration de tlphones SIP . . . . . . . . . . . . . . . . Connexion un fournisseur de service SIP . . . . . . . . . . Connexion entre deux systmes Asterisk via SIP . . . . . . . Conguration dun tlphone logiciel IAX . . . . . . . . . . Connexion un fournisseur de service IAX . . . . . . . . . . Connexion de deux systmes Asterisk via IAX . . . . . . . . . Utilisation de modles dans les chiers de conguration . . . Dbogage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

59
60 61 62 63 64 69 70 85 88 93 96 97 101 102 103

5 Les bases des plans de numrotation

Syntaxe du plan de numrotation . . . . . . . . . . Plan de numrotation lmentaire . . . . . . . . . . Construction dun plan de numrotation interactif Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

105
105 109 112 128

Table des matires

vii

6 Concepts avancs du plan de numrotation

Expressions et manipulation de variables . . . . . . . . . . . . . . . . . . . . . . Fonctions du plan de numrotation . . . . . . . . . . . . . . . . . . . . . . . . . Branchement conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Messagerie vocale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilisation de la base de donnes dAsterisk (AstDB) . . . . . . . . . . . . . . . . Fonctionnalits pratiques dAsterisk . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

129
129 132 133 136 140 142 145 148

7 Comprendre la tlphonie
Tlphonie analogique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tlphonie numrique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Le rseau tlphonique numrique commutation de circuit . . . . . . . . . . . Rseaux commutation de paquets . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

149
149 152 159 164 164

8 Protocoles pour la VoIP

Ore en protocoles VoIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Protocoles VoIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Codecs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Qualit de service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Asterisk et la VoIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scurit en VoIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

167
168 168 174 177 180 181 183 185

9 Asterisk Gateway Interface (AGI)

Principes de la communication AGI . . . . . . . . . . . . . . . . . . . . . . . . . crire des scripts AGI en Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Crer des scripts AGI en PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . crire des scripts AGI en Python . . . . . . . . . . . . . . . . . . . . . . . . . . . Le dbogage avec AGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

187
187 189 194 199 203 205

viii

Table des matires

10 Asterisk Manager Interface (AMI) et Adhearsion

Linterface Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FOP , le panneau oprateur instantan . . . . . . . . . . . . . . . . . . . . . . . . Le dveloppement Asterisk avec Adhearsion . . . . . . . . . . . . . . . . . . . .

207
207 211 211

11 Lenvironnement Asterisk GUI

Pourquoi une interface graphique pour Asterisk ? . . . . . . . . . . . . . . . . . Quest-ce que linterface graphique ? . . . . . . . . . . . . . . . . . . . . . . . . . Architecture de Asterisk GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation de linterface graphique dAsterisk . . . . . . . . . . . . . . . . . . . Dveloppement pour Asterisk GUI . . . . . . . . . . . . . . . . . . . . . . . . .

223
223 224 226 227 228

12 Intgration avec une base de donnes relationnelle

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation de la base de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . Installation et conguration de ODBC . . . . . . . . . . . . . . . . . . . . . . . . Conguration de res_odbc pour laccs notre base . . . . . . . . . . . . . . . . Utilisation du temps rel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temps rel statique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temps rel dynamique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Stockage denregistrements dtaills des appels . . . . . . . . . . . . . . . . . . . La vogue de la fonction func_odbc : lexemple du bureau partag . . . . . . . . Message vocal avec ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cration du type pour grand objet . . . . . . . . . . . . . . . . . . . . . . . . . . Conguration de voicemail.conf pour le stockage par ODBC . . . . . . . . . . . Test de la messagerie vocale via ODBC . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

239
239 239 241 243 244 244 247 248 250 260 261 263 264 266

13 Gestion de votre systme Asterisk

Enregistrement dtaill des appels . . . . . . . . . . . . . . . . . . . . . . . . . . Gestion de la journalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Excution dAsterisk en mode sans privilges . . . . . . . . . . . . . . . . . . . . Personnalisation des invites de commande . . . . . . . . . . . . . . . . . . . . . Mlodie dattente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

267
267 269 269 272 272 275

Table des matires

ix

14 Pot-pourri
Festival . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Les chiers dappel . . . . . . . . . . . . . . . . . . . . . . . DUNDi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mthodes alternatives de stockage de la messagerie vocale Asterisk et Jabber (XMPP) . . . . . . . . . . . . . . . . . . Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

277
277 279 280 286 289 289

15 Asterisk : lavenir de la tlphonie

Les problmes de la tlphonie traditionnelle . Lvolution du modle . . . . . . . . . . . . . . Les promesses de la tlphonie Open Source . Lavenir dAsterisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

291
291 294 294 300

A Les canaux VoIP

IAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

309
309 321

B Lexique des applications C Lexique des commandes AGI D Les chiers de conguration E Fonctions du plan de numrotation dAsterisk F Actions Asterisk Manager Interface G Exemple avec func_odbc Index

339 441 455 489 513 551 557

Prface
Ceci est un livre pour ceux qui dcouvrent AsteriskTM . Asterisk est une plateforme de tlphonie open source conue principalement pour fonctionner sous Linux. Asterisk combine plus de 100 ans de connaissances en tlphonie dans une suite robuste dapplications de tlcommunications troitement intgres. La puissance dAsterisk rside dans sa nature personnalisable complte par une conformit aux normes ingale. Aucun autre PABX (Private Automatic Branch eXchange, commutateur tlphonique priv) ne peut tre dploy de tant de faons cratives. Les applications telles que la messagerie vocale, les confrences, les les dattente et les agents dappels, les musiques dattente et les mises en garde dappels sont toutes des fonctionnalits standard intgres directement au logiciel. Dailleurs, Asterisk peut sintgrer avec dautres technologies dont dautres PABX ferms et propritaires peuvent peine rver. Asterisk peut sembler intimidant et complexe un nouvel utilisateur. Cest pourquoi la documentation est si importante sa croissance. La documentation abaisse la barrire dentre et aide les gens considrer les possibilits. Produit avec le gnreux support dOReilly Media, Asterisk : la tlphonie Open Source a t inspir par le travail commenc par lAsterisk Documentation Project. Nous avons parcouru un long chemin et ce livre est la ralisation dun dsir de livrer la documentation qui prsente les lments les plus fondamentaux dAsterisk : les choses que quelquun dcouvrant Asterisk doit savoir. Cest le premier volume de ce qui, nous sommes certains, deviendra une norme bibliothque de connaissances propos dAsterisk. Ce livre a t crit par, et pour, la communaut Asterisk.

Audience
Ce livre est destin ceux qui dcouvrent Asterisk mais nous supposons que vous connaissez ladministration de base de Linux, le rseau et les autres disciplines informatiques. Si ce nest pas le cas, nous vous encourageons explorer la vaste et merveilleuse bibliothque quOReilly publie sur ces sujets. Nous supposons aussi que vous dcouvrez le monde des tlcommunications, la fois la tlphonie commute traditionnelle et le nouveau monde de la voix sur IP.

Organisation
Ce livre est organis selon les chapitres suivants :

xii

Prface
Chapitre 1, Une rvolution de la tlphonie

Cest ici que nous couperons le petit bois pour allumer le feu. Asterisk va changer le monde des tlcoms et cest ici que nous discutons les raisons de cette armation.

Chapitre 2, Prparer un systme pour Asterisk

Expose quelques considrations que vous devez avoir en tte en concevant un systme de tlcommunications. Vous pouvez sauter ce chapitre si vous voulez aller directement linstallation mais ce sont des concepts importants comprendre si jamais vous avez mettre un systme Asterisk en production.

Chapitre 3, Installer Asterisk

Recouvre lacquisition, la compilation et linstallation dAsterisk.

Chapitre 4, Conguration initiale dAsterisk

Dcrit la conguration initiale dAsterisk. Ici, nous couvrirons les chiers de conguration importants qui doivent exister pour dnir les canaux et les fonctionnalits disponibles de votre systme.

Chapitre 5, Les bases du plan de numrotation

Prsente le coeur dAsterisk, le plan de numrotation.

Chapitre 6, Concepts avancs de plan de numrotation

Fait le tour de concepts de plan de numrotation plus avancs.

Chapitre 7, Comprendre la tlphonie

En laissant temporairement Asterisk de ct, ce chapitre prsente quelques unes des technologies importantes utilises par les Rseaux Tlphoniques Commuts Publics.

Chapitre 8, Protocoles pour la VoIP

Aprs avoir dcrit la tlphonie traditionnelle, ce chapitre traite de la voix sur IP .

Chapitre 9, LAsterisk Gateway Interface (AGI)

Prsente un des composants les plus tonnant, lAsterisk Gateway Interface. En utilisant Perl, PHP et Python, nous expliquerons comment les programmes externes peuvent tre utiliss pour ajouter des fonctionnalits presque sans limites votre PABX.

Chapitre 10, Asterisk pour le Geek

Ne fait quaeurer brivement une profusion de fonctionnalits extraordinaires ; toutes font partie du phnomne Asterisk.

Chapitre 11, Asterisk : la tlphonie Open Source

Prdit le futur o lopen source transforme compltement une industrie srieusement en attente dune rvolution.

Logiciel

xiii

Logiciel
Ce livre se focalise sur la documentation dAsterisk version 1.2, cependant, nombre de conventions et dinformations contenues dans ce livre sont indpendantes de cette version. Linux est le systme dexploitation sur lequel nous avons fait fonctionner et test Asterisk, avec un penchant pour la syntaxe Red Hat. Nous avons dcid que bien que les distributions base sur Red Hat ne sont peut-tre pas le choix prfr de tout le monde, son organisation et ses utilitaires sont toutefois familiers beaucoup dadministrateurs Linux.

Conventions utilises dans ce livre

Les conventions typographiques suivantes sont utilises dans ce livre :

Italique

Indique les nouveaux termes, les URL, les adresses lectroniques, les noms de chier, les extensions de chier, les chemins, les rpertoires et les utilitaires Unix.

Chasse fixe

Indique les commandes, les options, les paramtres et les arguments qui doivent tre substitus dans les commandes.

Chasse fixe en gras

Montre les commandes ou tout autre texte devant tre tap tel quel par lutilisateur. Aussi utilis pour marquer limportance dans le code.

Chasse fixe en italique [ Mots-cls et autres ] { choix-1 | choix-2 }

Montre le texte qui doit tre remplac par les valeurs de lutilisateur.

Indique les mots-cls et arguments optionnels.

Signie soit choix-1, soit choix-2.

Cette icne indique un avertissement ou une mise en garde.

xiv

Prface

Remerciements
Tout dabord, nous devons remercier notre diteur Michael Loukides pour son retour inestimable et son incroyable tact pour nous dire de r-crire une section (ou un chapitre) quand ctait ncessaire, tout en nous faisant croire que ctait notre ide. Mike nous a remont le moral quand nous tions dprims et nous a ramen sur terre lorsque nous tions arrogants. Tu es un matre, Mike, et voir le nombre de livres qui ont reu ta supervision ditoriale aide comprendre les raisons du succs de OReilly Media. Merci aussi Rachel Wheeler, notre secrtaire de rdaction, Colleen Gorman, notre secrtaire ddition, et les autres acteurs de lombre du dpartement des productions OReilly. Ce sont eux qui ont fait de notre livre un livre OReilly. Tous les membres de la communaut Asterisk remercieront Jim Dixon pour avoir cr le premier matriel de tlphonie open source, lanc la rvolution et donn ses crations la communaut. Merci Tim OReilly pour nous avoir donn une chance dcrire ce livre. notre quipe de relecture gnreuse et impitoyable : Rich Adamson, Prsident de Network Partners Inc., pour ta connaissance encyclopdique du RTC et ta volont infatigable de partager ton exprience. Ta gnrosit, mme en face des ds les plus imposants, est source dinspiration pour nous tous.

Remerciements

xv

Dr. Edward Guy, Chief Scientist, Pulver Innovations, pour ton valuation trs juste et complte de chacun des chapitres et pour ta matrise dAsterisk. Kristian Kielhofner, Prsident, KrisCompanies et crateur dAstLinux, pour la plus excellente des distributions : AstLinux Joel Sisko, Intgrateur Systme, pour avoir brav le feu. Travis Smith, pour tes conseils valables et dans les temps. Ted Wallingford, pour avoir montr la voie avec Switching to VoIP dOReilly. Brian K. West, pour ton engagement dans la communaut, Asterisk, notre livre et la tlphonie open source. Joshua Colp, pour avoir support et rpondu aux nombreuses questions poses par Leif. Robert M. Zigweid, non seulement pour ton valuation exhaustive de notre livre (spcialement pour ton travail courageux sur les annexes) mais aussi pour avoir le nom le plus cool de tout lunivers. Anthony Minessale (alias anthm) est un hros mconnu du dveloppement dAsterisk. Nombreux sont ceux qui ont contribu au dveloppement dAsterisk ; peu sont ceux qui peuvent armer avoir gal les eorts dAnthony. Finalement et le plus important, merci Mark Spencer pour GAIM, Asterisk et DUNDi, et pour avoir livr ses crations la communaut open source.

Leif Madsen
Le chemin menant la nalisation de ce livre fut long, presque trois ans. Lorsque jai commenc utiliser Asterisk, probablement comme vous, je ne connaissais rien sur Asterisk, trs peu sur la tlphonie traditionnelle et encore moins sur la voix sur IP . Jai plong dans ce monde nouveau et excitant et pris tout ce que je pouvais. Pendant une priode de deux mois dalternance pour laquelle je nai pas trouv de travail immdiatement, jai absorb autant que jai pu, posant des questions, essayant diverses choses et observant ce que le systme pouvait faire. Malheureusement, il existait trs peu voire pas du tout de documentation pour Asterisk part des rponses mes questions par Brian K. West sur IRC et quelques exemples de plans de numrotation par John Todd. Bien sr, cette mthode ntait pas extensible. Ntant pas un programmeur, je voulais quand mme contribuer la communaut. Et que dtestent le plus les programmeurs ? La documentation ! Je commenais alors The Asterisk Documentation Assignment (TADA), une premire bauche des dbuts dun livre. Peu aprs lavoir publi sur mon site internet, un gars intelligent du nom de Jared Smith se prsenta. Il avait des projets similaires pour crire un livre au format papier pour la communaut et nous entreprmes humblement lAsterisk Documentation Project. Jared monta un simple site web http://www.asteriskdocs.org , un serveur CVS et la premire version du livre au format DocBook. partir de l, nous avons commenc rassembler des informations, puis les membres de la communaut en proposrent leur tour. En juin 2004, un individu du nom de Jim Van Meggelen commena se montrer sur les listes de diusion et contribuer en apportant beaucoup dinformations et de documentation. Ctait clairement quelquun que nous voulions dans notre quipe ! Jim avait limagination et le dynamisme pour nous motiver, Jared et moi, et travailler sur quelque chose de plus ambitieux. Jim nous amena des annes dexprience et une nesse dcriture que nous pouvions dicilement imaginer. Le noyau dur de lquipe constitu, nous nous lanmes dans un plan de cration de volumes de connaissances sur Asterisk, conduisant nalement une bibliothque complte et une grande quantit dinformations. Ce livre est la premire pierre de cet dice.

xvi

Prface

Avant toutes choses, je dois surtout remercier mes parents, Rick et Carol, pour mavoir toujours encourag dans mes eorts, me permettant de raliser mes rves, et avoir toujours plac mes besoins avant les leurs. Sans leur exprience, leur comprhension et leur perspicacit, il aurait t impossible daccomplir ce que jai fait. Je vous aime beaucoup tous deux ! Jaimerais remercier Felix Carapaica et Bill Farkas du Sheridan Institute of Technology pour leur dvouement lavance de la connaissance. Leur enseignement a complt mon apprentissage initial et ma permis dtendre exponentiellement ma comprhension du routage et des tlcommunications. Il y a beaucoup trop de gens remercier individuellement mais les personnes suivantes ont t, et sont toujours, les plus inuentes pour ma comprhension dAsterisk : Olle Johansson, Steven Sokol, Joshua Colp, Brian K. West, John Todd et William Sull pour mon premier tlphone VoIP. Et pour ceux que je nai pas mentionn, un grand merci ! Et bien sr, je dois remercier Jared Smith et Jim Van Meggelen pour avoir vu et compris la vritable importance de la documentation, tout ceci aurait t impossible sans vous.

Jared Smith
Jai commenc travailler avec Asterisk au printemps 2002. Je venais de commencer un nouveau travail pour une entreprise de marketing et jai ni par devoir faire un long voyage jusqu un centre dappel distant avec mon collgue RSI. Sur le long retour la maison, nous avons parl dinnovation en tlphonie et il mentionna un petit projet de tlphonie open source dont il avait entendu parler appel Asterisk. Pendant les quelques mois suivants, jai pu convaincre lentreprise dacheter un kit de dveloppement Digium et jai commenc jouer avec Asterisk pendant mes heures de travail. Les mois suivants, je devins de plus en plus engag dans la communaut Asterisk. Je lisais les listes de diusion. Jai fouill les archives. Je tranais sur le canal IRC esprant trouver des petites ppites de connaissances dAsterisk. Au fur et mesure, jobtenai nalement une vue densemble susante pour faire fonctionner Asterisk. Cest alors que a devint amusant. Avec laide du RSI et laccord du PDG, nous avons alors plani de convertir entirement notre architecture Asterisk, incluant notre sige social et tous nos centres dappels distants. En chemin, nous avons travers beaucoup de territoires inconnus et je commenai penser crer un bon recueil de connaissances sur Asterisk. Au cours du projet, nous avons pu faire des choses innovantes, comme inventer lagrgation IAX ! Quand tout fut men bien, nous avions environ quarante serveurs Asterisk disperss en de nombreux points gographiques et communicant les uns avec les autres pour fournir un systme de tlphonie VoIP professionnel. Celui-ci traite actuellement environ un million de minutes dappel par mois, sert une centaine demploys, met en relation 27 connexions voix T1 et fait conomiser environ 20 000 dollars par mois en frais de tlcommunications lentreprise. Bref, notre projet Asterisk est un succs clatant ! Au milieu de limplmentation de ce projet, je rencontrai Leif sur un des canaux IRC dAsterisk. Nous avons parl des faons daider les nouveaux utilisateurs dAsterisk et dabaisser la barrire dentre. Nous avons alors plani de documenter plus entirement Asterisk. Je voulais vraiment une bonne documentation au format papier (en gros, un livre quun nouvel utilisateur pourrait prendre pour apprendre les bases dAsterisk). peu prs au mme moment, le nombre de nouveaux utilisateurs sur les listes de diusion et les canaux IRC a

Remerciements

xvii

formidablement grossi et nous sentions qucrire un livre sur Asterisk amliorerait grandement le rapport signal/bruit. LAsterisk Documentation Project tait n ! Depuis lors, nous avons crit de la documentation pour Asterisk. Je naurais jamais pens que cela serait aussi ardu bien quenrichissant. (Jai plaisant avec Leif et Jim sur le fait quil serait plus facile et moins controvers dcrire un livre exhaustif appel Religion, Rgulation de la vente darmes et Sushis que de couvrir tout ce quAsterisk a orir en dtails susants !) Ce que vous voyez ici est le rsultat direct de nombreuses nuits sans sommeil et de longs weekends passs aider la communaut Asterisk, aprs tout, cest le moins que nous puissions faire si lon prend en compte ce quAsterisk nous a apport. Nous esprons que cela inspirera dautres membres de la communaut documenter les changements et les nouvelles fonctionnalits pour le bnce de tout le monde. Maintenant, remercions quelques personnes : Premirement, jaimerais remercier ma merveilleuse pouse. Elle a support de nombreuses nuits solitaires pendant que je trimais avec mon clavier. Jaimerais quelle sache combien je lapprcie, elle et son inni soutien. Jaimerais aussi remercier mes enfants pour avoir fait du mieux quils pouvaient pour me rappeler les choses importantes de la vie. Je vous aime ! mes parents : merci pour tout ce que vous avez fait pour maider grandir et apprendre au l des ans. Vous tes les meilleurs parents quon puisse souhaiter. Dave Carr et Michael Lundberg : merci de mavoir laiss tudier Asterisk pendant les heures de travail. Que Dieu vous sourie et vous accorde la joie dans tout ce que vous entreprendrez. Leif et Jim : merci davoir support mes blagues stupides, mon insistance pour que nous fassions les choses de la bonne faon et mon emploi du temps insens. Merci de mavoir pouss jusquau bout et davoir fait de moi un meilleur auteur. Cela a vraiment t un plaisir travailler avec vous deux et jespre collaborer avec vous sur dautres projets ! Mark Spencer : merci pour ton support, ton dvouement et ton amiti sans faille. Tu as t une ressource inestimable pour ce travail et je crois sincrement que tu as lanc une rvolution dans le monde de la tlphonie. Tu es toujours le bienvenu chez moi et ma table ! Aux autres personnes exceptionnelles de Digium : merci pour votre aide et votre soutien. Nous sommes particulirement reconnaissants de votre volont de nous donner une meilleure vision du code dAsterisk et pour avoir fait don de matriel pour nous permettre de mieux documenter le kit de dveloppement dAsterisk. Steven Sokol, Steven Critcheld, Olle E. Johansson et tous ceux qui ont contribu lAsterisk Documentation Project et ce livre : merci ! Nous naurions pas pu le faire sans votre aide et vos suggestions.

Jim Van Meggelen

Pour moi, tout a commenc au printemps 2004, assis mon bureau au support technique de lentreprise de tlcoms pour laquelle jai travaill pendant presque quinze ans. Sans ds dignes de mes comptences, je passais mon temps essayer de voir ce que javais ralis ces quinze dernires annes. Jtais coinc dans une industrie qui avait gch beaucoup trop dopportunits et qui par consquent avait delle mme chut de faon spectaculaire et embarrassante du statut de chrie des investisseurs celui de plaisanterie connue mme des plus incultes. Jtais suppos me sentir heureux dtre lun des rares a avoir encore du travail, mais quel travail ingrat ! Nous savions que notre industrie stait eondre : les produits que nous vendions ne pouvaient esprer fournir les solutions que le client dsirait, mme si lindustrie

xviii

Prface

promettait linverse. Ils manquaient de souplesse et les prix taient compltement irralistes par rapport aux fonctionnalits proposes (ou, plus prcisment qui ntaient pas proposes). Lindustrie ne montrait aucun signe de changement imminent. Jai rv pendant de longues annes dun PABX open source mais je navais jamais vraiment su comment une telle chose pourrait venir moi. Javais abandonn lide quelques annes plus tt. Je savais que pour russir, un PABX open source devrait relier les mondes de la tlphonie traditionnelle et des tlcoms bass sur les rseaux. Je navais jamais trouv quelque chose qui semblait prt. Alors, un beau jour de printemps, jai lanc une recherche Google sans enthousiasme avec la phrase open source telephony et jai dcouvert un nouvel horizon pour les tlcoms : Asterisk, le PABX Open Source. Elle tait l : la chose prcise dont jai rv pendant tant dannes. Les nuages se dissiprent, le soleil apparut au travers, laventure attendait. Je navais aucune ide de comment jallais contribuer mais je savais ceci : la tlphonie open source allait engendrer une rvolution ncessaire et bnque dans lindustrie des tlcoms et, dune manire ou dune autre, jallais en faire partie. Pour moi, qui tait plus un intgrateur quun dveloppeur, javais besoin dune faon de contribuer la communaut. Il ne semblait pas y avoir une pnurie de dveloppeurs mais il y avait clairement un manque de documentation. a ressemblait quelque chose que je pouvais faire. Je savais crire, je connaissais une chose ou deux sur les PABX et javais dsesprment besoin de parler de ce phnomne qui a rendu les tlcoms plaisants nouveau. Si je dois contribuer une seule chose dans ce livre, jespre que vous attraperez un peu de mon enthousiasme pour le sujet de la tlphonie open source. Cest un incroyable cadeau qui nous a t oert mais aussi une incroyable responsabilit. Quel d merveilleux. Quelle opportunit gigantesque. Quel plaisir dlicieux ! Tout dabord, je dois remercier Leif et Jared pour mavoir invit rejoindre lAsterisk Documentation Project. Jai pris un immense plaisir travailler avec vous deux et je suis constamment surpris de la manire dont nos personnalits se compltent. Nous sommes une quipe vraiment quilibre. ma femme Killi et mes enfants Kaara, Joonas et Joosep (qui se rappellent toujours de venir me voir quand je disparais trop longtemps dans mon repaire souterrain) : vous tes ma source dinspiration. Votre amour est la force qui manime et je vous remercie. videmment, je me dois de remercier mes parents Jack et Martiny, pour avoir toujours cru en moi, quelles que soient les rgles que jai enfreintes. Dans quelques annes, jaurai mes propres adolescents et ce sera votre tour de rire ! Mark Spencer : merci pour toutes les choses pour lesquelles tous les autres te remercient mais aussi, personnellement, merci pour avoir donn gnreusement de ton temps la communaut Asterisk. Le Toronto Asterisk Users Group (http://www.taug.ca ) a fait un saut quantique en avant aprs que tu sois venu nous parler et cet vnement fait dsormais partie de notre histoire. Ah oui, et merci pour les bires aussi. Finalement, merci la communaut Asterisk. Ce livre est notre cadeau pour vous. Nous esprons que vous prendrez autant de plaisir le lire que nous en avons eu lcrire.