DOC Asterisk

Installation, conguration et utilisation

Version 1.0 26 juin 2009

Jrmy HAGE pour Nasdy Corp. ee

Table des mati`res e

1 Introduction 2 Installation dUbuntu 3 Installation de zaptel 4 Installation dAsterisk 5 Conguration 5.1 Fichier zapata.conf . . . . . . 5.2 Fichier sip.conf . . . . . . . . 5.3 Fichier extensions.conf . . . . 5.4 Fichier voicemail.conf . . . . 5.5 Le serveur de mail . . . . . . 5.6 Conguration des tlphones ee 5.7 Synth`se Vocale . . . . . . . . e 6 Mode demploi 7 Maintenance 8 Conclusion 3 3 4 5 6 6 7 8 9 10 10 11 11 11 12

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

. . . . . . .

Introduction

Le but est de mettre en place un rseau VoIP dans lentreprise et de le e relier au RTC. Nous prsenterons donc ici les direntes tapes dinstallation, de e e e conguration et de maintenance. Ci-dessous le schma du rseau de lentreprise e e Nasdy.

Figure 1 Rseau Nasdy e

Installation dUbuntu

Linstallation dUbuntu est une installation classique. La version utilise est e Ubuntu 7.10 Desktop (Gutsy Gibbon). La seule subtilit rencontre se trouve e e au niveau de ladresse des dpts. En eet, le support technique des versions e o dUbuntu qui ont plus de 18 mois nest plus assur et ladresse des dpts de e e o ces distributions est modie par celle-ci : e

http ://old-release.ubuntu.com Ainsi, il faut diter le chier /etc/apt/sources.list et remplacer ladresse e suivante http ://archive.ubuntu.com/ par ladresse ci-dessus.

Installation de zaptel

Pour linstaller il faut dabord installer le paquet zaptel ` laide de la coma mande suivante : fuvix0001@fuvix0001 :~$ sudo apt-get install zaptel Seulement, ce paquet ne contient pas le module zaptel ncessaire ` la recone a naissance de la carte. Il faut donc installer le module zaptel ` partir des sources. a On utilisera donc les commandes suivantes : fuvix0001@fuvix0001 :~$ sudo apt-get install module-assistant Cette commande nous permet dinstaller le paquet module-assistant qui nous permettra de rcuprer les sources du module zaptel, de les compiler et de crer e e e un paquet .deb pour le noyau et de linstaller. fuvix0001@fuvix0001 :~$ sudo m-a prepare Prparation de la compilation : Rcupration des headers du kernel et vrication e e e e de lenvironnement de compilation. fuvix0001@fuvix0001 :~$ sudo m-a get zaptel-source Rcupration des sources de zaptel. e e fuvix0001@fuvix0001 :~$ sudo m-a build zaptel Permet de construire le nouveau paquet .deb fuvix0001@fuvix0001 :~$ sudo m-a install zaptel Installation de zaptel ` partir du paquet cr. a ee Maintenant que zaptel est correctement install, il faut le congurer. Pour cela, e rien de plus simple, il existe un commande spcialement faite pour ca. e fuvix0001@fuvix0001 :~$ sudo genzaptelconf Cette commande permet la gnration automatique du chier de conguration e e

zaptel.conf . Enn, on peut lancer le pilote de la carte TDM400P. fuvix0001@fuvix0001 :~$ sudo modprobe wctdm

Puis pour vrier que la carte est bien reconnue, il faut taper la commande e suivante : fuvix0001@fuvix0001 :~$ ztcfg -vv

Si linstallation de zaptel a bien fonctionne, cette commande devrait acher e le message suivant : Zaptel Version : 1.4.3 Echo Canceller : MG2 Configuration ====================== Channel map : Channel 04 : FXS Kewlstart (Default) (Slaves : 04) 1 channels configured On voit bien, quun canal a t congur. Cest le canal numro 4 car la ee e e carte que jai utilis poss`de un seul FXO qui se trouve sur le canal 4. e e

Installation dAsterisk
Pour installer Asterisk, il sut de taper la commande suivante :

fuvix0001@fuvix0001 :~$ sudo apt-get install asterisk

Cependant, il est prfrable dinstaller les paquets permettant davoir des ee messages vocaux en franais. c
fuvix0001@fuvix0001 :~$ sudo apt-get install asterisk-prompt-fr

Asterisk tant install, il sagit maintenant de le congurer. e e

5
5.1

Conguration
Fichier zapata.conf

Asterisk utilise ce chier pour dterminer les param`tres et la conguration e e du matriel tlphonique install dans le syst`me. Il contrle les diverses fonce ee e e o tionnalits associes au canal matriel, comme la prsentation du numro, la e e e e e mise en attente dappels ou la suppression decho. Dans ce chier, nous nous intresserons uniquement ` la section [channels] e a qui dtermine la mthode de signalisation des canaux matriel et ses options. e e e

[channels] language=fr switchtype=national rxwink=300 usecallerid=yes hidecallerid=no callwaiting=yes usecallingpres=yes callwaitingcallerid=yes threewaycalling=yes transfer=yes canpark=yes cancallforward=yes callreturn=yes echocancel=yes echocancelwhenbridged=yes rxgain=0.0 txgain=0.0 group=1 callgroup=1 pickupgroup=1 immediate=no context=incoming; Les appels entrant vont dans le [incoming] de extensions.conf signalling=fxs_ks;Utiliser la signalisation FXS pour un canal FXO channel=>4;RTC connecte au port 4 au module FXO (Rouge) Si quand on laisse un message, et quon appuie sur raccrocher pour le terminer, le messsage continu de senregistrer, vrier que les lignes suivantes ape paraissent bien dans le chier :

usecallingpres=yes callreturn=yes busydetect=yes 6

busycount=4 hanguponpolarityswitch=yes

5.2

Fichier sip.conf

Le chier sip.conf contient les param`tres du canal et les options de chaque e utilisateur. Cest vritablement ici que lon dclare chaque utilisateur, quon e e leurs attribut des droits, une messagerie vocale, etc. La section [general] contient les param`tres du canal et les options par e dfaut de chaque utlisateurs. Les autres sections sont celles de chaque utilisateur. e [general] context=default bindport=5060 bindaddr=0.0.0.0 srvlookup=yes language=fr dtmfmode = rfc2833 [100] type=friend username=100 secret=admin host=dynamic context=home nat=yes qualify=yes [101] type=friend username=101 secret=admin host=dynamic context=home nat=yes qualify=yes mailbox=101@default [102] type=friend username=102 secret=admin host=dynamic context=home nat=yes qualify=yes 7

[103] type=friend username=103 secret=admin host=dynamic context=home nat=yes qualify=yes

5.3

Fichier extensions.conf

Ce chier contient le plan de numrotation. Le plan de numrotation est le e e coeur dun syst`me Asterisk. Il dnit comment Asterisk g`re les appels entrants e e e et sortant. Ce chier se compose gnralement de 5 contextes : e e [general] static=yes writeprotect=no autofallthrough=yes clearglobalvars=no priorityjumping=no [globals] OUTBOUNDTRUNK = Zap/4

; RTC connect au port 4 e

[home] include => outbound-local exten=>103,1,Dial(SIP/103) exten=>102,1,Dial(SIP/102) exten=>101,1,Dial(SIP/101) exten=>100,1,Dial(SIP/100) exten=>500,1,VoiceMailMain() [incoming] exten => s,1,Answer() exten => s,2,background(accueil) exten => s,3,WaitExten() exten => 1,1,Dial(SIP/101,10) exten => 1,2,VoiceMail(101@default) exten => 2,1,Dial(SIP/100,10) exten => 2,2,VoiceMail(101@default) exten => 3,1,Dial(SIP/100&SIP/101,10) 8

exten => 3,2,VoiceMail(101@default) ;Si occupe : message puis raccroche exten => s,102,PlayBack(tt-allbusy) exten => s,103,Hangup() exten exten exten exten => => => => i,1,PlayBack(pbx-invalid) i,2,Goto(incoming,s,1) t,1,PlayBack(vm-goodbye) t,2,HangUp()

[outbound-local] exten => _0ZXXXXXXXX,1,Dial(${OUTBOUNDTRUNK}/${EXTEN}) exten => _0ZXXXXXXXX,2,Congestion() exten => _0ZXXXXXXXX,102,Congestion() Les contextes [incoming] , [home]et [outbound-local]peuvent tr`s bien e se nommer diremment, limportant est que : e le contexte [incoming]concorde bien avec le chier zapata.conf . le contexte [home] concorde avec sip.conf dans la dclaration des utie lisateurs. le contexte [outbound-local] soit le mme que celui inclu dans [home] e

5.4

Fichier voicemail.conf

Ce chier permet de congurer la messagerie vocale. [general] format=wav49|gsm|wav serveremail=nasdy.msg@gmail.com attach=yes skipms=3000 maxsilence=10 silencethreshold=128 maxlogins=3 emailsubject=[PBX]: Nouveau message ${VM_MSGNUM} dans la bo^te vocale ${VM_MAILBOX} emailbody=Cher ${VM_NAME}:\n\n\tVous avez un nouveau message dune dure de ${VM_DUR} provenant du numro ${VM_CALLERID}. Ce message e e a t reu le ${VM_DATE} et est le numro ${VM_MSGNUM} de votre e e c e bo^te vocale. Merci!\n\n\t\t\t\t--Asterisk\n emaildateformat=%d/%h/%Y ` %Hh%M a mailcmd=/usr/sbin/sendmail -t sendvoicemail=yes [zonemessages]

eastern=America/New_York|vm-received Q digits/at IMp central=America/Chicago|vm-received Q digits/at IMp central24=America/Chicago|vm-received q digits/at H N hours military=Zulu|vm-received q digits/at H N hours phonetic/z_p european=Europe/Copenhagen|vm-received a d b digits/at HM [default] 101 => 1234,Roland Ratenan,contact@nasdy.com

5.5

Le serveur de mail

La mise en place de la messagerie vocale ncessite linstallation de ssmtp , e mailx et sendmail . fuvix0001@fuvix0001 :~$ sudo apt-get install ssmtp mailx sendmail

Il faut ensuite congurer ssmtp ` laide du chier /etc/ssmtp/ssmtp.conf a de la mani`re suivante : e root=nasdy.msg@gmail.com mailhub=smtp.gmail.com:587 UseSTARTTLS=YES AuthUser=nasdy.msg@gmail.com AuthPass=nasdy.msg88 rewriteDomain=gmail.com FromLineOverride=YES hostname=fuvix0001 Pour tester le serveur indpendamment dasterisk, faire : e fuvix0001@fuvix0001 :~$ mail adr@dest.com -s test test .

5.6

Conguration des tlphones ee

La conguration par dfaut des tlphones est satisfaisante. Il faut nanmoins e ee e attribuer une adresse IP au tlphone, un username, un mot de passe et ladresse ee du serveur asterisk. Ces donnes doivent bien videmment concorder avec les e e chiers de conguration. Dans account, dans send DTMF, il faut cocher via RTP (RFC2883). Puis dans sip.conf , dans [general] il faut rajouter ou dcommenter la ligne e dtmfmode=rfc2833 . Cela permet, lors de la consultation des messages vocaux, de reconna le mot de passe tap par lutilisateur. tre e 10

5.7

Synth`se Vocale e

Le message daccueil a t cr ` laide du logiciel Dspeech sous Windows et e e ee a de la voix Scansoft Virginie Dri40. Il faut enrigistrer le message au format .wav . Ensuite, sous linux, il faut le convertir en .gsm . fuvix0001@fuvix0001 :~$ sox fichier.wav fichier.gsm

Mode demploi

En interne, si on tape le 100, ceci appelle le poste 100. Idem pour les postes 101 et 102. Quand on tape le 500 cela nous envoie vers la messagerie vocale. Le numro de la bo vocale est 101 et le mot de passe est 1234. e te Depuis lextrieur, si on tape 1, le poste 101 est contact. Si on tape 2, le e e poste 100 est contact. Enn si on tape 3, les 3 postes sont contacts jusqu` ce e e a que lun deux rponde. e Les messages sont dirigs vers ladresse contact@nasdy.com via ladresse ee mail nasdy.msg@gmail.com.

Maintenance

Attention : Pour viter tout probl`me, il vaut mieux laisser la CLI ouverte e e durant lutilisation dAsterisk. Il se peut que le rseau tlphonique ne fonctionne plus. Ceci se passe e ee gnralement au dmarrage du serveur. Pour corriger le probl`me, la manie e e e pulation suivante doit tre faite : e En mode console, ouvrir la CLI dAsterisk : fuvix0001@fuvix0001 :~$ asterisk -r Puis, dans la CLI, taper : fuvix0001*CLI>stop now

Cela vous ramenera ` la console normale. De l`, taper les commandes suia a vantes :

11

fuvix0001@fuvix0001 fuvix0001@fuvix0001 fuvix0001@fuvix0001 fuvix0001@fuvix0001 fuvix0001@fuvix0001

:~$ :~$ :~$ :~$ :~$

sudo rmmod wctdm wcfxo zaptel sudo modprobe zaptel sudo modprobe wctdm ztcfg zttool

La derni`re commande permet de voir si tout sest bien pass. Si la colonne e e alarms de la carte TDM400P est OK, tout sest bien pass. Ensuite selectione ner cette carte et appuyer sur select. Dans la ligne Total/Conf/Act , on doit avoir quelque chose comme 4/ 1/ 1/ . Si on a 4/ 1/ 0/ alors dbrancher et e rebrancher le cble connect ` la carte, le 0 devrait passer ` 1. a ea a Enn, il faut relancer Asterisk : fuvix0001@fuvix0001 :~$ sudo asterisk -vvvvvvvvvvvvvvvvvvvvvvvvvc

Conclusion
Pour toute autre prcision : hage.jeremy@gmail.com . e

12