Asterisk de A à …K!

Stéphan SoulayrolLP Léonard de Vinci – Bagneux (92)

Remerciements et ressources

Installation

Sommaire

Bac proAvant de commencer

Schéma d’implantation

Qui plus est, c'est gratuit! Il est sous licence GPL Open Source. Il est conçu pour fonctionner essentiellement sous Linux.

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*).

* 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

INTERNET

GSM*PSTN/RTC*

ISDN/RNIS*

INTERNET

Passerelles Opérateurs

Routeur xDSL*

Téléphone IPNuméroInterne: 2004

PC + SoftPhone

Tél. Analogique

IPBX ASTERISK

FxS*

FxO*

Lignes numériques (SO, TO)

Ligne Analogique

Switch

POE*

06019842240565991221

FAI(DSLAM)

LAN

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

netconfig1

2

3 ifup eth0 (pour interface ethernet0 « up » ce qui permet d’activer la carte réseauifdown 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

Activer la boîte vocale (Voicemail)

Configurer les téléphones IP Thomson ST2030

Configurer le softphone X-Lite

Installer une carte Digium

« Francisation » d’Asterisk

Relier l’IPBX au RTC Ajouter des téléphones analogiques

Retour Accueil

Passer en mode de configuration de l’IP-PBX(FreePBX)

http://@IP_du_serveur_asterisk

Ex: http://bagneux.sen-tr.net

Il peut être nécessaire d’autoriser l’utilisateur maint

en utilisant la commande passwd-maint

Retour Sommaire

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

1

32

1

Mot de passe

Numéro d’appel

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

Retour Sommaire

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)

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

Retour Sommaire

Pour accéder au TP élève de configuration du téléphone au format Word, cliquez ici

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-LiteLe 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 SIPAuthorization user name : laisser videDomain : 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.gzou$ 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’archive3°) [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 zaptel4°) [wouam@pici /]# cd zaptel; se placer dans le dossier zaptel5°) [wouam@pici /]# nano Makefile; éditer le fichier Makefile avec l’éditeur de texte nano6°) trouver la ligne ztd-loc # dummy (utiliser le Ctrl + W) et la changer en ztd-loc dummy 7°) [wouam@pici /]# modprobe wctdm; continuer l’installation8°) [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

• 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

1

2

3

4

5

Plus de détails? Cliquer ici

Retour Sommaire

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

Retour Sommaire

Bandeau 19’’ 24RJ11

Ça ne fonctionne pas…cliquez sur la bouée!

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’appelantNota 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érificationEn é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

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 Schéma

Accéder au Glossaire page2

• 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.

Glossaire page2

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