Stéphan Soulayrol LP Léonard de Vinci – Bagneux (92) Asterisk de A à …K! Avant de commencer Bac pro Schéma d’implantation Installation Sommaire Remerciements et ressources

Asterisk est un IP-PBX (PaBX. VoIP. ) Asterisk est un IP-PBX (PaBX* VoIP*). Il permet d’établir des communications entre les utilisateurs d’un même site et relie ces derniers au reste du monde par le biais de connexions analogiques (POTS*), IP et numériques (T1/E1*). Qui plus est, c'est gratuit! Il est sous licence GPL Open Source. Il est conçu pour fonctionner essentiellement sous Linux. * Chaque fois que vous voyez cette astérisque, vous pouvez retrouver une définition dans le glossaire en cliquant sur cet icône Retour Accueil

Comment implanter Asterisk Retour Accueil

Installation L’image ISO est téléchargeable à l’adresse : http://www.trixbox.org/downloads

Configuration minimale requise La configuration minimale recommandée est au minimum un processeur 40O MHz x86 avec 256 Mo de RAM. Elle ne peut supporter pas plus de 5 postes environs. Cela va dépendre des fonctionnalités utilisées sur Asterisk : Maximum de communications simultanées qu'il devra traiter. Traffic exigeant un traitement numérique avec des codecs compressés. Suppresion de l'echo. Autres processus sur le système. … Ce document a été créé en se basant sur des experimentations sur serveur Asterisk installé sur Pentium IV avec 512 Mo de RAM et 40Go de disque dur.

Toutes les étapes d’installation: 1- Démarrer sur le CD 2- Clavier: fr-latin1 3- [*] System clock uses UTC Europe/Paris

4- password: xxxxx 5- « Package Installation » durée: 10 minutes 6 – Redémarrage (retirer le CD!) Login: root Pwd: xxxxxxx

Première Configuration Configurer les paramètres IP du serveur netconfig 1 2 3 ifup eth0 (pour interface ethernet0 « up » ce qui permet d’activer la carte réseau ifdown permet de la désactiver) Retour Accueil

FreePBX (Configurer l’IP-PBX) Passer en mode de configuration de l’IP-PBX  Création de comptes SIP  Configurer les téléphones IP Thomson ST2030  Configurer le softphone X-Lite  « Francisation » d’Asterisk  Activer la boîte vocale (Voicemail)  Installer une carte Digium  Ajouter des téléphones analogiques Relier l’IPBX au RTC Retour Accueil

Passer en mode de configuration de l’IP-PBX (FreePBX) Il peut être nécessaire d’autoriser l’utilisateur maint en utilisant la commande passwd-maint http://@IP_du_serveur_asterisk Ex: http://bagneux.sen-tr.net

Retour Sommaire

Création de comptes SIP Un compte SIP permet à un utilisateur de téléphoner depuis un téléphone IP ou un softphone. 1 1 3 2

Numéro d’appel Mot de passe

Dans le menu PPX\Config File Editor, on peut accéder au contenu des fichiers de configuration. Ci-contre le contenu du fichier sip_additional.conf Remarque: habituellement, la déclaration des extensions SIP se fait dans le fichier /etc/asterisk/sip.conf

Le fichier extensions_additional Le fichier extensions_additional.conf est aussi modifié comme ci-dessous. Rmq: le plus souvent, le second fichier modifié se nomme extensions.conf. Une seule ligne est alors ajoutée dans le contexte [default] exten => 2004,1,Dial(SIP/2004) Retour Sommaire

Configurer les téléphones IP Thomson ST2030 Pour accéder à la documentation au format PDF, cliquez ici Suivez scrupuleusement ce guide à quelques exceptions près dont voici la liste: Changez l’ordre des codecs Modifier les paramètres de configuration Pour accéder au TP élève de configuration du téléphone au format Word, cliquez ici Retour Sommaire

Changez l’ordre des codecs Retour

Modifier les paramètres de configuration Spécifier l’adresse IP de votre « Asterisk » ou le domaine associé (mon serveur asterisk est joignable à l’URL bagneux.mrim.net; Attention à rediriger les bons ports au niveau du routeur ex: UDP 5060 = SIP par défaut) Retour

Configurer le softphone X-Lite Le softphone retenu est lui aussi gratuit. Il est téléchargeable sur ftp://bagneux.mrim.net et le fichier s'appelle: "X-Lite_Win32_1006e_34025«  Paramétrage au niveau du softphone Allez dans le menu "SIP account settings..." et choisissez "Add... Paramétrez le compte avec les propriétés indiquées ci-dessous : Display name : Nom du compte affiché dans xlite. username : nom du compte déclaré au niveau de l’enregistrement du compte SIP password : mot de passe déclaré au niveau du compte SIP Authorization user name : laisser vide Domain : default  (peu importe le nom entré !!!)   [x]Register with domain and receive incoming calls [x] proxy address : adresse IP du serveur Asterisk ou domaine FQDN associé au serveur Asterisk Retour Sommaire

« Francisation » d’Asterisk Si un utilisateur est injoignable une voix vous indique que: « the person is unavailable !». D’autres réponses de ce type sont préenregistrées. On peut configurer Asterisk pour que ces messages soient en Français. Voici comment procéder :  Il faut inclure par exemple le package FrenchPrompts. On télécharge le package depuis le mode commande : $ wget http://www.sineapps.com/down/FrenchPrompts.tar.gz ou $ wget http://www.asterisk-france.net/afsite/index.php?option=com_content&task=view&id=44&Itemid=2  On décompresse ce package : $ tar xzvf FrenchPrompts.tar.gz -C /var/lib/asterisk/sounds  Et on modifie les fichiers sip.conf et iax.conf présents dans /etc/asterisk en ajoutant la ligne : language=fr D'autres packages de langue, payants ou libres, sont disponibles sur Internet. Pour les liens, consulter le portail voip-info.org : http://www.voipinfo.org/wiki/view/Asterisk+sound+files+international  Editer le fichier /etc/asterisk/indications.conf [general] country=fr  (falcutatif) Modifier les messages envoyés par SMTP de la messagerie vocale (VoiceMail) Editer les 2 fichiers /etc/asterisk/vm_email.inc et /etc/asterisk/vm_general.inc.   Retour Sommaire

Installer une carte Digium Qui est Digium? Cette société fabrique des cartes électroniques destinées au serveur Asterisk. Elles sont 100% compatibles Asterisk. Le modèle que nous utilisons est la TDM411B de la famille TDM410P Carte d’interface téléphonique au format PCI qui peut accueillir jusqu'à 4 modules FXO (pour connecter des lignes téléphoniques analogiques "POTS") ou FXS (pour connecter des téléphones analogiques au PC IPBX Asterisk). Ces cartes on été achetées chez opcom.fr au prix de 240 euros l’unité (à négocier !!!) La TDM411B possède un port FXS et un port FX0. Il existe d’autres fabricants: Installation matérielle: cette carte se place sur un slot PCI; ne pas oublier de brancher la prise molex!!! Installation logicielle : voir diapo suivante

Installation logicielle de la carte Digium En mode commande: 1°) [wouam@pici /] # wget http://ftp.digium.com/pub/zaptel/zaptel-1.2.27.tar.gz; télécharge le dernier pilote; si le site ne fonctionne pas, vous pouvez le trouver sur downloads.digium.com. Note importante: les pilotes sont mis à jour très régulièrement, il se peut que la version soit différente de 1.2.27 2°) [wouam@pici /]# tar –xzvf zaptel-1.2.27.tar.gz; décompresse l’archive 3°) [wouam@pici /]# mv zaptel-1.2.27.tar.gz zaptel; renomme le dossier qui contient les fichiers décompressés, le nouveau dossier s’appelle zaptel 4°) [wouam@pici /]# cd zaptel; se placer dans le dossier zaptel 5°) [wouam@pici /]# nano Makefile; éditer le fichier Makefile avec l’éditeur de texte nano 6°) trouver la ligne ztd-loc # dummy (utiliser le Ctrl + W) et la changer en ztd-loc dummy 7°) [wouam@pici /]# modprobe wctdm; continuer l’installation 8°) [wouam@pici /]# modprobe zaptel; 9°) [wouam@pici /]# genzaptelconf; 10°) [wouam@pici /]# shutdown –r now; redémarrer le PC Suite

Installation logicielle de la carte Digium En guise de vérification, comme indiqué sur la copie d’écran ci-contre, on peut lancer la commande #ztcfg –v. Dans notre cas, on voit alors qu’il y a bien deux voix (2 channels: Fx0 et FxS) qui sont bien installées. La commande #zttool , voir copie d’écran ci-contre, permet aussi de vérifier que la carte est bien installée. On peut éditer le fichier /etc/zaptel.conf qui permet de vérifier que les modules fxo et fxs de la carte ont bien étaient reconnus, ce qui donne (voir diapo suivante)

Retour Sommaire

Ajouter des téléphones analogiques Les étapes à suivre: Vérifier que la carte possédant une interface FxS est bien installée (se référer au sommaire, rubrique « installer une carte Digium »). Ajouter une extension de type ZAP! 1 2 3

1 Le numéro de téléphone associé à cette nouvelle extension Le nom de l’utilisateur du téléphone Le port FXS de la carte PCI Digium (et non pas le FxO!) Puis valider ces informations La nouvelle extension apparaît dans la liste 2 3 4 5 Plus de détails? Cliquer ici Retour Sommaire

Ça ne fonctionne pas…cliquez sur la bouée! Après voir créé cette extension, vous pouvez vérifier que vous avez bien les paramètres ci dessous Numéro du port FxS sur la carte Digium (définition du canal) Permet d’avoir la tonalité Un port FXS (port où est branché le tél. analogique) dialogue avec un port FX0, il utilise une signalisation FX0 Activation du suppresseur d’echo Voici le fichier Linux modifié (zapata_additional.conf) Si vous devez installer un grand nombre de téléphones analogiques Bandeau 19’’ 24RJ11 Ça ne fonctionne pas…cliquez sur la bouée! Retour Sommaire

Si la carte n’est pas reconnue ou bien si cela ne sonne pas, il faut vérifier: - Le contenu du fichier zapata.conf et notamment les paramètres entourés ici: - Le contenu du fichier zapata-auto.conf et notamment le paramètres entourés ici:

Activer la boîte vocale (Voicemail) Pour vérifier que la messagerie vocale est bien installée, on peut vérifier que le module est activé (par défaut il l’est comme sur la copie d’écran ci-dessous) Ensuite, pour chaque extension, il faut activer le voicemail comme indiqué à la diapo suivante:

Pour l’extension 2001, On active la boîte vocale, Pour consulter les messages, on fixe un mot de passe Si on le souhaite, une notification sera envoyée par mail En pièce jointe au mail, on aura le fichier audio correspondant au message laissé par l’appelant Nota Bene: pour que la notification par mail fonctionne, il faut indiquer au serveur Asterisk le serveur SMTP (voir diapo suivante)

Pour indiquer à Asterisk le serveur de messagerie qui prendra en charge les mails, il faut accéder au menu ci-contre Ensuite deux méthodes s’offrent à vous: Vous pouvez installer un serveur de messagerie sur le même serveur qu’Asterisk (non décrit ici) Ou bien indiquer le serveur de messagerie de votre FAI (dans notre cas smtp.orange.fr sur le port tcp 25) Dans la copie d’écran ci-contre (troisième méthode), nous utilisons un serveur de messagerie déjà en place dans la section à l’adresse bagneux.mrim.net Pour finir en guise de vérification, on peut éditer les fichiers contenants la configuration de ces paramètres. Voir diapo suivante:

Vérification Retour Sommaire Retour Sommaire En éditant le fichier main.cf qui se trouve dans /etc/postfix Relayhost=[smtp.orange.fr] Retour Sommaire Retour Sommaire

Il existe plusieurs méthodes pour consulter ses messages Par exemple en composant depuis votre téléphone SIP le numéro *97 Nb: la liste des numéros associé à une fonction se trouvent dans le menu PBX\Basic\Feature Codes Autre exemple, depuis le site http:// « adresse_du_serveur_asterisk », rubrique Voicemail and Recordings Pour personnaliser son message d’accueil, composez le *97 depuis votre téléphone SIP, entrez votre mot de passe et saisissez 0 au clavier du téléphone. Laissez vous guider ensuite. Retour Sommaire

Relier l’IPBX au RTC Pour cela nous allons utiliser le port FXO de notre carte Digium TDM400P. Ce port sera donc relié via le câble adapté (RJ11-RJ11) à la prise téléphonique. Quand cela est fait, il faut créer une route sortante (Outbound Routes) ainsi qu’un Trunk Lire la suite

Commençons par créer le Trunk* DESCRIPTION DE LA COPIE D’ECRAN In use by 1 route: cela indique qu’il y a bien une route sortante qui utilise ce trunk Outbound Caller ID: il s’agit d’un identifiant de ce Tunk. Je l’ai appelé france-telecom Maximum Channels: puisque mes appels sortant passeront par le RTC, je n’aurais qu’une communication possible vers l’extérieur. Si je possédais un abonnement au RNIS je pourrais alors avoir plusieurs voies (channels) vers l’extérieur. Dial Rules: ou « règles d’appels »; ici la règle est très simple c’est-à-dire que tous les numéros composés de dix chiffres (dix X) empruntent ce trunk Outbound Dial Prefix: Pour utiliser ce trunk on doit d’abord composer le 0 pour passer l’autocom de la section puis un second 0 pour passer l’autocom du Lycée Nb: ce trunk pourrait très bien être un trunk SIP c’est-à-dire que votre FAI (comme par exemple free) vous fournissant un compte SIP, vous utiliseriez ce compte pour téléphoner vers l’extérieur. Dans notre cas, nous utilisons notre abonnement au RTC de France Télécom CREATION DE LA ROUTE SORTANTE  Diapo suivante Pour créer un Trunk SIP vous pouvez consulter la copie d’écran suivante

Pour finir, il faut créer la route sortante (Outbound Route) DESCRIPTION DE LA COPIE D’ECRAN Route Name: le nom de la route, je l’ai appelée ext comme extérieur Route Password: on peut filtrer l’accès aux utilisateurs ayant le mot de passe Dial Patterns: Je pourrais interdire ici aux numéros commençant par 06 ou 02 de passer par ce trunk. Mais tout est autorisé à partir du moment où le numéro composé comporte 10 chiffres (d’où la présences des dix X) Trunk Sequence: Cette route sortante utilise le trunk créé à la diapo précédente Retour Sommaire

Exemple de Trunk SIP utilisant le compte SIP fournit avec l’abonnement free Retour Sommaire

Glossaire page1 Accéder au Glossaire page2 Retour Sommaire PaBX: Private Branch eXchange. Autocommutateur privé, utilisé dans les entreprises, assurant les communications internes et le lien avec le réseau téléphonique commuté global. Un autocommutateur est un central téléphonique. VoIP: Voice Over IP. Principe consistant à faire passer des communications téléphoniques numérisées dans des paquets IP. POTS: Plain Old Telephone Service. Le bon vieux service téléphonique de base, en RTC. T1: Norme de lignes de transfert de données numériques, permettant des débits de 1,544 Mbit/s selon la norme américaine, aussi bien pour transporter de la voix que des données. E1/T2: Ligne permettant de transférer des données avec un débit de 2,048 Mbit/s, par circuits à 56 ou 64 kbps, selon la norme utilisée en Europe. Il vaut 30 B + 1 D = PRI, donc davantage que la liaison de type T1 ; par contre, son prix de location est très élevé, quatre fois plus que pour une ligne T1 aux É-U. FxS: Foreign eXchange Subscriber est un port qui raccorde la ligne téléphonique de l’abonné. Cette interface fournit notamment la tonalité, le courant de charge et le voltage pour la sonnerie. Un téléphone standard se branche sur cette interface pour recevoir le service téléphonique. FxO: Foreign eXchange Office est un port qui reçoit la ligne téléphonique. C’est la prise du téléphone ou de la télécopieuse, ou la (les) prise(s) de votre réseau téléphonique analogique. Le FXO offre un indicateur d’état raccroché/décroché (fermeture de circuit). Puisque le port FXO est raccordé à un appareil, tel un téléphone ou une télécopieuse, il est souvent appelé ''périphérique FXO''. Les ports FXO et FXS vont toujours de paire (similaire à la prise mâle et femelle). POE: Power Over Ethernet. Voir 802.3af. Norme définissant le « power over ethernet », c'est-à-dire le fait de transférer du courant électrique en même temps que des données. Les câbles restent du RJ45 catégorie 3 ou 5, la tension continue est de 48 volts. Retour Sommaire Retour Schéma

Glossaire page2 Retour Sommaire RNIS/ISDN: Réseau Numérique à Intégration de Services. Réseau permettant de transporter à la fois de la voix, des images, des données, à l'aide d'un téléphone, d’un ordinateur, d'un fax, d'un PABX. Exemple chez France Télécom : Numéris. Le débit est classiquement de 64 ou 128 kbps. RTC/PSTN: Réseau Téléphonique Commuté. PTSN en anglais. C'est le réseau de téléphone que tout le monde connaît, mais la distinction est nécessaire du fait de l'apparition des RNIS. GSM: Groupe Spécial Mobile ou Groupe Système Mobile. Les anglais ont traduit par Global System for Mobile communications. Norme de communications radio répandue en Europe définissant un réseau cellulaire qui utilise un multiplexage temporel. Bref, c'est le téléphone portable. xDSL: x Digital Subscriber Line. x peut valoir A (ADSL), HS (HSDSL), RA (RADSL), S (SDSL), A (VHSDSL), I (IDSL)n ou rien du tout (DSL). Famille de techniques qui permettent de disposer de débits de plusieurs Mbit/s sur des lignes de téléphone normales. Trunk: Un trunk est la ligne de service téléphonique vous permettant de passer et de recevoir des appels vers l’extérieur. Dans notre cas, le trunk est France Télécom. Retour Sommaire

Ressources et/ou remerciements à Trixbox-2 Without Tears (document au format pdf) de Ben Sharif La société VTX pour son manuel pdf sur la configuration du Thomson ST2030 Retour diapo n°1