Académique Documents
Professionnel Documents
Culture Documents
Trix Box
Trix Box
-1-
Sommaire Introduction..................................................................................................................................3 Trixbox? ...................................................................................................................................3 Les composants de lIPBX.......................................................................................................3 1. IP PBX .................................................................................................................................3 2. Tlphones ...........................................................................................................................3 3. Passerelle SIP .......................................................................................................................4 4. Rseau local .........................................................................................................................4 II. Installation....................................................................................................................................4 A. Pr-requis l'installation..........................................................................................................4 B. pour obtenir de l'aide................................................................................................................8 C. Changer dadresse IP (configurer ladresse IP en statique) .....................................................8 III. Configurer Trixbox ................................................................................................................10 A. Installer les modules de trixbox ............................................................................................. 11 B. Prparer son Dial Plan (plan de numrotation)......................................................................12 C. Configuration des extensions internes ...................................................................................13 1. extension ZAP....................................................................................................................13 2. Pour le soft phone ..............................................................................................................14 3. Pour le PAP2 ......................................................................................................................15 IV. Configuration des softphones.................................................................................................16 A. Configuration de X-Lite.........................................................................................................16 B. Configuration du PAP2 ..........................................................................................................16 1. dbridage du PAP2 .............................................................................................................16 2. Activer la ligne...................................................................................................................16 V. Configuration des trunks............................................................................................................17 VI. Communications entrantes et sortantes..................................................................................18 A. Etablissement d'une route de sortie (outbound route) :..........................................................18 B. Etablissement d'une route d'entre (Inbound route):..............................................................19 1. groupe dappels (ring group)..............................................................................................19 2. Les Menus vocaux (IVR)...................................................................................................19 3. Contraintes de temps (Time conditions) ............................................................................21 4. Inboud routes......................................................................................................................21 VII. Complment ...........................................................................................................................23 A. Installation dune carte TDM22B ..........................................................................................23 1. Petite explication sur la syntaxe des cartes TDM ..............................................................23 2. Explication sur FXO/FXS..................................................................................................23 3. Installation..........................................................................................................................23 B. Procdure de sauvegarde Trixbox ..........................................................................................26 A. B. I.
-2-
I. Introduction
A. Trixbox?
Trixbox est un ensemble d'outils et d'utilitaires de tlcommunication compils pour devenir un vritable IP PBX. Les principales caractristiques de TRIXBOX sont : Asterisk, le cur du systme tlphonique gestion des relations clients A2Billing Calling Card platform (tarification des appels) Flash Operator Panel, a screen-based operators console web confrence outils de configuration utilisateurs de Trixbox
1. IPBX
L'IPBX est installer sur un ordinateur. Vous devriez consacrer entirement un PC cet usage. La configuration minimum dcrite ci dessous est suffisante pour faire tourner un IPBX dans un petit rseau . Nanmoins, votre vieil ordinateur PII mont au grenier peut faire l'affaire. Pentium 2 350 Mhz ou suprieur (P3 800 recommand) 256Mo RAM au plus au mieux... 4Go de disque dur minimum (trixbox prend la totalit du disque dur l'installation) carte Ethernet 10/100Mo lecteur de CDRom switch 4-8 ports 10/100 (selon configuration)
2. Tlphones
Vous pouvez acheter des tlphones IP.... ou vous pouvez utiliser un ATA (Adaptateur de Tlphone Analogique) conu par Linksys, Netcomm, Sipura ou d'autres, qui vous permettront d'utiliser un tlphone analogique (le PAP2 de Linksys permet de brancher 2 tlphones). Ces ATA se trouvent -3-
facilement chez les commerants spcialiss ou sur des magasins en ligne comme LDLC.com (une quarantaine d'euros pour le PAP2) Pour commencer, le plus facile et le moins coteux est d'installer un softphone sur un ordinateur connect au rseau. Le plus utilis est x-lite.
3. Passerelle SIP
Si vous voulez communiquer avec d'autres utilisateurs du rseau RTC, vous devez passer par un oprateur de tlphonie (par exemple France Tlcom). Pour la VOIP c'est la mme chose, vous devez passer par un prestataire de service, acheter des minutes le plus souvent, comme chez wengo.
4. Rseau local
Vous devez configurer une adresse IP fixe pour votre IPBX. Pour faire simple, assurez-vous que votre IPBX est dans la mme plage d'adresse que votre rseau existant.
II. Installation
Vous pouvez installer trixbox sur une machine virtuelle sur votre pc sous windows (une version de trixbox est destine cet usage). Ou installer trixbox sur une machine ddie. La deuxime solution est privilgier. Cette machine est destine tourner 24h/24, et ne jamais tre arrte. D'autre part, le partage des ressources de la machine entre trixbox et d'autres applications journalires telles que des jeux, surfer sur le net ou autres nierait au bon fonctionnement de trixbox. Pour la stabilit, il est conseill d'installer trixbox sur une machine ddie. C'est ce que nous faisons par la suite.
A. Pr-requis l'installation
Rcuprez la dernire version ISO stable (pas bta) de trixbox ici1. Gravez l'image ISO que vous venez de tlcharger sur un CD vierge. Vrifiez que votre PC dmarrera partir du CD (dans le BIOS, ordre de chargement) **Attention, toutes les donnes prsentes sur vos disques durs seront effaces lors de l'installation. Dmarrez votre PC trixbox avec le CD dans le lecteur et appuyez sur entre. L'cran suivant apparat quelques instants plus tard. Pressez F2 pour voir les diffrentes options. Toutefois ce n'est pas vraiment ncessaire. Pressez [entre] pour commencer l'installation.
1 Http://www.trixbox.org/downloads
-4-
On vous demande de choisir la configuration clavier que vous utilisez. Utilisez les flches pour slectionner le type de clavier choisi et utilisez la touche tabulation pour slectionner OK ou Back. Slectionnez fr and validez sur OK en appuyant sur [entre].
-5-
choisissez votre fuseau horaire Ensuite on vous demande d'entrer un mot de passe root. Retenez bien ce mot de passe. Il sert administrer votre systme.
Entrez votre mot de passe root L'installation commence ds la confirmation du mot de passe en formatant les disques durs. Comptez 30 min 1h pour une installation complte et configurable. A la fin de l'installation, le CD est ject. Prenez-le et attendez que le systme redmarre.
-6-
-7-
Aprs un moment, le dmarrage continue et une liste de lignes de code apparat. a peut prendre un moment : c'est la compilation d'Asterisk qui se fait. (seulement au premier dmarrage) Quand la compilation d'Asterisk est termine, a redmarre tout seul. Une fois redmarr, trixbox est prt pour la suite de la configuration et effectuer les changements du systme par dfaut.
Lcran daide vous donnera aussi les commandes ncessaires au changement de mot de passe des diffrents utilisateurs, par exemple passwd-maint pour lutilisateur maint et passwd pour lutilisateur root.
-8-
Slectionnez [Yes] pour configurer le rseau et validez. Vous arrivez alors sur lcran suivant :
Utilisez la touche tabulation pour naviguer entre les diffrents champs. Entrez lIP qui doit tre donne votre serveur Asterisk, le masque de sous rseau, la passerelle par dfaut, et le DNS primaire comme dans lexemple ci dessus. Dans le champ adresse IP (IP address), entrez ladresse IP en tenant compte de votre plage dadresse IP. Masque de rseau (Netmask) : le plus souvent 255.255.255.0 ( moins dun rseau domestique spcial) Passerelle par dfaut : (Default gateway) : Cest ladresse IP de votre routeur. DNS primaire (primary nameserver) : Si vous restez dans votre groupe de travail vous pouvez entrer ladresse de votre passerelle par dfaut. Quand vous avez fini, validez en appuyant sur OK. Vous avez la possibilit maintenant de changer le mot de passe administrateur, cest facultatif, mais fortement conseill Passwd-maint Passwd Redmarrons maintenant la machine Amportal stop Shutdown r now Asterisk dmarrera avec la nouvelle adresse IP.
-9-
III.Configurer Trixbox
Dsormais, vous pouvez vous connecter http://adresseIP/ (par exemple 192.168.1.100) avec votre navigateur prfr pour configurer trixbox partir dun ordinateur de votre rseau. Vous accdez la page daccueil de votre trixbox, o vous avez accs aux fonctionnalits utilisateurs. Avant de pouvoir y accder, trixbox doit tre configur.
Vous devez basculer en mode admin pour configurer trixbox. Pour cela, cliquez que le bouton [switch] dans le coin suprieur droit de lcran. On vous demande alors le nom dutilisateur et le mot de passe par dfaut. (maint & password sauf si vous lavez chang au 3.2.)
- 10 -
- 11 -
Faites cela avec les modules dont vous avez besoin. Vous pourrez toujours en ajouter ou en enlever plus tard. Feature Code Admin Voicemail (boite vocale) IVR (Menu vocal) Queues (Gestion des files d'attente) Times Conditions (contrainte sur la date et l'heure) Conferences (confrence) Music on Hold (Musique d'attente) Recordings (enregistrer une conversation) Call Forward (transfrer un appel) Call Waiting (Mise en attente) Backup & Restore (Sauvegarde) Cliquez sur Process en bas de la liste une fois que vous avec slectionn les modules ci dessus. Sur la page de confirmation, cliquez sur confirm. Vous devriez obtenir une page qui vous affiche que tous les modules ont t installs avec succs. Lorsqu'une barre rouge apparat en haut de la page web (Apply configuration changes?), c'est que des modifications ont t effectues sur le systme. Si vous voulez les appliquer et faire disparatre la barre rouge, cliquez dessus. Ceci relance Asterisk.
visant rduire le cot global de mes appels. Les appels vers les portables (qui commencent par 06) doivent tre routs vers le port FXO 2 de ma carte Digium TDM400 (ma ligne entreprise). Les appels vers les fixes (qui commencent par 01-02-03-03-05-09 ) doivent tre routs vers le port FXO 1 de ma carte Digium (ma ligne prive). Je passe volontairement sur les autres types de numro pour simplifier. Extensions internes: 100 tlphone sans fil connect au port FXS de ma carte digium dans le bureau d'entreprise. 101 X-lite, un softphone sur mon ordinateur, utilisable par l'entreprise ou le priv. 102-- Un linksys PAP22 sur lequel je branche un tlphone classique pour l'usage priv uniquement.
Linksys PAP2 C'est fait pour mon dial plan ... trs simple.
DID Alert Info: <blank> Outbound CID: <blank> Emergency CID: <blank> Channel: 1 (le port FXS de ma carte digium) Fax Extension: freePBX default Fax Email: <blank> Fax Detection Type: None Pause after answer: 0 Record Incoming: On Demand Record Outgoing: On Demand Voicemail & Directory: Enabled Voicemail password: 100 (Le mme que le numro de l'extension, faisons simple!) Email address: (mon mail) Pager email address: <blank> Email attachment: Yes (Je veux recevoir mes messages vocaux avec mes mails) Play CID: No(lire le numro de l'appelant) Play Envelope: No Delete Vmail: Yes (Avec cette option, les messages sont envoys sur ma boite mail et supprims de trixbox. Sinon, quand je supprime les messages de ma boite mail, je dois aussi les supprimer de trixbox manuellement) Vm options: <blank> Vm context: default Cliquez sur submit. Cliquez sur la barre rouge pour appliquer les options.
Voicemail password: 101 Email address: (my email address) Pager email address: <blank> Email attachment: Yes (Je veux recevoir mes messages vocaux avec mes mails) Play CID: No(lire le numro de l'appelant) Play Envelope: No Delete Vmail: Yes (Avec cette option, les messages sont envoys sur ma boite mail et supprims de trixbox. Sinon, quand je supprime les messages de ma boite mail, je dois aussi les supprimer de trixbox manuellement) Vm options: <blank> Vm context: default Cliquez sur submit. Cliquez sur la barre rouge pour appliquer les options.
3. Pour le PAP2
On reprend la mme dmarche que pour le softphone. Dans FreePBX, cliquez sur Setup puis Extensions. Slectionnez Generic SIP device dans le menu droulant et cliquez sur Submit. J'utilise ces paramtres: User Extension: 102 Display name: PAP2 Direct DID: <blank> DID Alert Info: <blank> Outbound CID: <blank> Emergency CID: <blank> Secret: 102(n'importe quoi, du moment que vous vous en souvenez) Dtmfmode: rfc2833 Fax Extension: freePBX default Fax Email: <blank> Fax Detection Type: None Pause after answer: 0 Privacy Manager: No Record Incoming: On Demand Record Outgoing: On Demand Voicemail & Directory: Enabled Voicemail password: 102 Email address: (my email address) Pager email address: <blank> Email attachment: Yes (Je veux recevoir mes messages vocaux avec mes mails) Play CID: No(lire le numro de l'appelant) Play Envelope: No Delete Vmail: Yes (Avec cette option, les messages sont envoys sur ma boite mail et supprims de trixbox. Sinon, quand je supprime les messages de ma boite mail, je dois aussi les supprimer de trixbox manuellement) Vm options: <blank> Vm context: default Cliquez sur submit. Cliquez sur la barre rouge pour appliquer les options.
- 15 -
A. Configuration de X-Lite
A la premire installation, l'assistant de configuration SIP s'ouvre automatiquement, sinon vous pouvez cliquer sur la flche dirige vers le bas dans le haut de la fentre et choisissez SIP Account Settings Cliquez sur Add Display Name : Soft Phone User Name : 101 Password : 101 Authorization user name : 101 Domain : 192.168.1.3 (l'adresse IP de votre Trixbox) Domain Proxy Cochez Register with Domain and receive incoming calls Slectionnez Target domain Cliquez sur OK. Cliquez sur close. X-Lite est maintenant correctement configur et doit s'enregistrer sur votre Trixbox.
B. Configuration du PAP2
En France, cet appareil est vendu dans plus de 95% des cas en conjonction dune offre de tlphonie chez loprateur PhoneSystems (devenu Keyyo - ahhh, vente lie, quand tu nous tiens), ce qui fait que lappareil est malheureusement pr-configur et brid et que lutilisateur na donc pas accs linterface dadministration de lappareil. Ceci peut paratre problmatique au dpart, mais ne se rvle finalement pas trs gnant car il existe une petite procdure trs simple permettant de contourner ce bridage dorigine. Bien entendu, il est possible de trouver des appareils non brids dorigine, mais ils restent trs rares sur le march (voire introuvables, ce qui est vraiment dommage).
1. dbridage du PAP2
Attention, ne branchez pas votre PAP2 sur Internet avant de l'avoir dbrider!!! Vous pouvez suivre la procdure de dbridage cette adresse: http://ponceto.free.fr/blog/?p=3#more-3.
2. Activer la ligne
Votre PAP2 doit tre dbrid pour commencer cette tape. Nous configurerons la ligne 13. Quand vous tes logus sur l'interface web4 du PAP2 cliquez sur l'onglet Line 1.
Il y a deux lignes distinctes disponibles sur le PAP2, c'est dire la possibilit de se connecter deux registrars diffrents, ou de connecter deux extensions sur un mme registrar, par exemple deux tlphones. 4 http://{adresse-ip-du-pap2}/admin/advanced/
- 16 -
Line1 Line Enable NAT Mapping Enable NAT Keep Alive Enable Proxy Display Name User ID Password Dial Plan
5
Yes Yes Yes L'adresse IP de votre trixbox Le nom de votre connexion (ce que vous voulez) 102 102 (*xx|[3469]11|0|00|[2-9]xxxxxx|1xxx[29]xxxxxxS0|xxxxxxxxxxxx.|xxx|xx)
Votre PAP2 est oprationnel si la diode phone1 est allume sur le devant du botier. Si ce n'est pas le cas, ouvrez les ports 5060/5061 de votre routeur.
5 Une documentation en anglais sur la rdaction de dial plan d'un PAP2 : http://www.netphonedirectory.com/pap2_dialplan2.htm
- 17 -
Sur ce tlphone, composez le *77. Vous entendrez un bip qui signale le commencement de lenregistrement. Quand vous aurez fini, raccrochez. Entrez un nom (sans extension de fichier) pour votre enregistrement et cliquez sur save. Rptez la manuvre autant de fois quil y a denregistrement effectuer. Il est maintenant temps dutiliser ces enregistrements dans les menus vocaux. Premirement, crez un IVR6. Setup=>IVR=>add IVR Jai utilis ces paramtres pour mon premier IVR : Change Name: heure de boulot Timeout: 10 Enable Directory: coch Directory Context: default Enable Direct Dial: coch (a permet aux appelants dentrer directement lextension interne quils veulent joindre.) Announcement: Merci (Mon message merci enregistr prcdemment) Pour les options, jen ai 2. Je fais donc decrease options. Si vous en avez plus ou moins, vous dajouter ou de retirer le nombre ncessaire doptions. Option 1: 2 Core Ring groups <600> 3 Core Soft phone <102> Cliquez sur save. Cliquez sur la barre rouge en haut de lcran pour appliquer. Crez un nouveau IVR de la mme faon. Change Name: heure de fermeture Timeout: 10 Enable Directory: coch Directory Context: default Enable Direct Dial: coch (a permet aux appelants dentrer directement lextension interne quils veulent joindre.) Announcement: fermeture (Mon message merci enregistr prcdemment) Pour les options, jen ai 2. Je fais donc decrease options. Si vous en avez plus ou moins, vous dajouter ou de retirer le nombre ncessaire doptions. Option 1: 2 Core sans fil <100>
- 20 -
*** NOTE: astuce : Je sais que jai laiss les mmes options pour heure de fermeture et heure de boulot. Simplement, mon enregistrement fermeture ne dit pas que lon peut tapez 2 pour avoir lextension Je veux que quelquun au courant de ce truc puisse me joindre tout de mme. *** NOTE: Pourquoi je commence avec loption 2 dans mon IVR? A cause du format de mes extensions en 1xx. Parce que si je commence si je commence par loption 1, quand les appelants essaieront de me joindre au travers du menu vocal, asterisk mettra un certain temps comprendre que ce nest pas une extension. Cette astuce permet dviter une grande perte de temps.
Cliquez sur Submit changes. Cliquez sur la barre rouge en haut de lcran pour appliquer les changements.
4. Inboud routes
Dans Setup=>Inboud routes, ajoutez une nouvelle route Add incoming route. Vous pouvez router les appels par numro de lappelant, numro compos, ou canal zap. Nous routerons nos appels par cette dernire option. Renseignez le canal utiliser (zaptel channel), prenons le 1. Laissez tous les autres champs vides. Allez directement Set Destinations. Slectionnez Core ring groups <601>. Pour le deuxime canal, prenez le 2. Dans set destinations, slectionnez time conditions <entrant>. DID Number: <blank> Caller ID Number: <blank> Zaptel Channel: <blank>
- 21 -
Fax Extension: disabled Privacy Manager: No Alert Info: <blank> Set Destination: Time Conditions: entrant (Celui quon vient juste de crer) Cliquez sur submit, puis sur la barre roue en haut de lcran. Votre trixbox est dsormais oprationnel. Vous pouvez passer des appels, en recevoir. Rappelez vous que le plus important est de bien dfinir ses besoins au dpart, sur le papier avec la prparation du dial plan. Ensuite, vous navez plus qu suivre les tapes pas pas de ce tutorial, en les adaptant votre cas.
- 22 -
VII. Complment
A. Installation dune carte TDM22B 1. Petite explication sur la syntaxe des cartes TDM
Le fabricant de ce type de carte est digium, la socit qui dveloppe Asterisk. Ceux sont des cartes TDM400P, modulables, c'est dire que l'on peut y ajouter des modules FXO/FXS. Les conventions de dnomination des bundles TDM est la suivante, TDM X Y B, o : - X est le nombre de module FXS, - Y est le nombre de module FXO - B signifie que le produit est un bundle La TDM22B est, donc, une carte TDM400P avec 2 modules FXS et 2 modules FXO.
3. Installation
Pr requis A ce stade, on suppose que l'on dispose d'un ordinateur qui fonctionne, avec un distribution linux installe (dans l'exemple CentOS et trixbox), et asterisk install non configur. On administre l'ordinateur par le rseau via SSH. La configuration minimum pour ce type de carte est un PIII 500MHz et 64Mo de ram. Pour une utilisation optimum, je conseille plutt 256Mo de ram et un processeur de frquence de calcul suprieure 1GHz.
- 23 -
Analyse du contenu de /etc/zaptel.conf (Si le contenu de votre fichier n'est pas identique, vous devez le complter) # Global data loadzone = fr defaultzone = fr fxsks=3,4 (3 et 4 sont les emplacements des FXS) fxoks=1,2 (1 et 2 sont les emplacements des FXO) Ensuite on lance la configuration avec la commande ztcfg -vvvv. (l'argument -vvvv est pour le mode extra verbeux, ainsi on obtient plus de dtails sur la russite ou non de la configuration de la carte). La sortie doit se faire sans erreur. La copie d'cran suivante montre ce que l'on doit obtenir.
- 24 -
Si on obtient l'erreur ci dessous, c'est que la configuration n'est pas bonne. N'oublions pas que sur un port FXO, on branchera une FXS et inversement. Dans ce fichier on configure la signalisation. De ce fait sur un port FXS on configure la signalisation FXO et inversement! ZT_CHANCONFIG failed on channel 1: Invalid argument (22) Did you forget that FXS interfaces are configured with FXO signalling and that FXO interfaces use FXS signalling? exemple : Ligne PSTN sur un port FXS = DEGATS
- 25 -
Dplacez FreePBX.
le
curseur
sur
Astrisque.
Dans
le
menu
droulant
cliquez
sur
Dans la nouvelle fentre qui souvre, cliquez sur tools en haut de la page. - 26 -
Pour sauvegarder la configuration en cours, cliquez dans le menu de droite sur add Backup schedule. A noter que lon peut automatiser cette tche et lexcuter rgulirement. Il suffit de choisir dans le menu droulant la frquence laquelle on veut sauvegarder sa configuration.
- 27 -
Cliquez sur le bouton System Configuration, et dans le menu droulant Run backup, slectionnez Now. On peut donner un nom sa sauvegarde, tel que la date du jour au format JJ-MM-AA. Validez en cliquant sur submit changes.
Pour restaurer une sauvegarde archive, cliquer sur Backup & Restore dans le menu de gauche. Puis cliquez sur Restore from Backup dans le menu de droite.
- 28 -
Cliquez sur la sauvegarde remettre en place. Choisissez le fichier de sauvegarde. Et cliquez sur Restore System Configuration.
- 29 -
Cliquez sur OK. Attention, ceci efface la configuration en cours et remplace avec la sauvegarde.
- 30 -