Installation de l'Asterisk PBX et de l'interface de provisionnement Web Asterisk sur Linux

Installation de l’Asterisk PBX et de l’interface de provisionnement Web Asterisk sur Linux

J’ai lu à propos d’Asterisk et je voulais l’essayer car je vais bientôt le gérer/dépanner au travail, alors j’ai pensé à me lancer et à acquérir une expérience de base. Tout d’abord, j’ai configuré une machine avec Linux RedHat ES4, mais je pense que n’importe quelle distribution Linux ferait l’affaire. Kubuntu/Ubuntu, Fedora ou Mandriva fonctionneraient bien.

Voici comment procéder :

Installez Linux et notez l’adresse IP de la machine.
Passez en mode root, puis téléchargez les fichiers tar actuels depuis http://downloads.digium.com/pub vers /usr/src :

Asterisk vers /asterisk
Zaptel vers /zaptel
Libpri vers /libpri
asterisk-addons vers /asterisk-addons

Suivez les commandes ci-dessous pour décompresser chaque paquet dans /usr/src (dans cet exemple, j’utilise des versions à jour, changez les numéros de version selon les versions que vous avez téléchargées) :

tar -zxvf asterisk-1.4.4.tar.gz  
ln -s asterisk-1.4.4 asterisk  
tar -zxvf zaptel-1.4.2.1.tar.gz  
ln -s zaptel-1.4.2.1 zaptel  
tar -zxvf libpri-1.4.0.tar.gz  
mv libpri-1.4.0 libpri  
tar -zxvf asterisk-addons-1.4.1.tar.gz  
mv asterisk-addons-1.4.1 asterisk-addons

Commencez à installer les différents paquets en suivant ces commandes, encore une fois, en tant que root :

Doit être exécuté avant de construire Asterisk (REMARQUE : Vous devrez peut-être redémarrer si vous voyez des erreurs concernant des sources de noyau manquantes.) :

cd /usr/src/zaptel  
./configure  
make menuselect (assurez-vous que votre fenêtre de terminal est réglée pour au moins 80x21 ou la commande de sélection de menu vous donnera une erreur)  
make  
make config

Optionnel (je l’ai fait de toute façon) : Si vous avez des cartes numériques Zaptel :

cd ../libpri  
make clean  
make install

Doit être installé après zaptel et (si vous en avez besoin) libpri (je l’ai également fait) :

cd ../asterisk  
./configure  
make menuselect # pour une configuration supplémentaire  
make  
make install  
make samples  
make config

Optionnel. Doit être exécuté après l’installation d’Asterisk :

cd ../asterisk-addons  
./configure  
make  
make install

C’est le bon moment pour sauvegarder certains fichiers. Sauvegardez à la fois sip.conf et extensions.conf qui se trouvent dans le dossier /etc/asterisk en exécutant ces commandes :

cd /etc/asterisk  
cp sip.conf sip.backup  
cp extensions.conf extensions.backup

Maintenant que tout est installé (à moins que vous n’ayez eu des erreurs, si c’est le cas, allez sur linuxforums.org et postez des messages là-bas avec vos problèmes [MEILLEUR FORUM LINUX JAMAIS !]), il est temps de démarrer Asterisk pour la première fois en entrant cette commande :

cd /usr/sbin  
asterisk -vvvvgc (cela démarrera en mode débogage, ce qui est bon pour découvrir les erreurs)

Il y a plusieurs extensions déjà préconfigurées dans l’installation de base, et les voici :

extension : 1000 (la première à essayer !)
extension : 1234 (est une extension. appelez vmail et entrez ceci comme l’extension et le mot de passe 4242)
extension : 1235 (composez ceci et laissez un message pour vous-même)
extension : 1236 (une autre extension)
Vmail principal : 8500
Test externe pour appel SIP : 500
test d’écho : 600

Alors passez des appels à ces numéros en utilisant un téléphone SIP comme X-Lite ou un téléphone de bureau compatible SIP comme le Mitel 5212/5224. Pour passer un appel, tapez le numéro d’extension # suivi du signe @ et de l’adresse IP de la machine exécutant le logiciel Asterisk. Assurez-vous que le pare-feu est désactivé ou configuré pour autoriser le port 5060 entrant/sortant.

FÉLICITATIONS ! Vous l’avez fait !

Gestionnaire Asterisk

Il existe également un gestionnaire Asterisk. Pour l’activer, vous devez modifier le fichier /etc/asterisk/manager.conf et décommenter les quatre lignes ci-dessous en supprimant le ; sur :

;[mark] (c'est le nom d'utilisateur à utiliser dans l'astman)
;secret = mysecret (c'est le mot de passe à utiliser dans astman)
;read = system,call,log,verbose,command,agent,user,config
;write = system,call.log,verbose,command,agent,user,config

pour qu’il ressemble à :

[mark] (c'est le nom d'utilisateur à utiliser dans l'astman)  
secret = mysecret (c'est le mot de passe à utiliser dans astman)  
read = system,call,log,verbose,command,agent,user,config  
write = system,call.log,verbose,command,agent,user,config

Enregistrez le fichier.

Vous devrez également redémarrer Asterisk. Pour ce faire, depuis l’invite de commande CLI, tapez

restart

maintenant.

Une fois redémarré, à l’invite de commande d’Asterisk, vous pouvez taper manager show users qui vous indiquera quels utilisateurs de gestionnaire sont configurés, donc le nôtre est mark avec le mot de passe mysecret.

Maintenant, ouvrez une nouvelle fenêtre de terminal, passez en mode root, puis tapez :

/usr/sbin/astman localhost

nom d’utilisateur = mark
mot de passe = mysercet

Faites un appel au 1000 et vous verrez votre appel là.

Vous pouvez également utiliser la version Web appelée AJAM :

Gestionnaire Asterisk Javascript Asynchrone (AJAM)

AJAM est une nouvelle technologie disponible dans Asterisk 1.4 qui permet aux navigateurs Web ou à d’autres applications et pages Web activées par HTTP d’accéder directement à l’interface de gestion Asterisk (AMI) via HTTP. Configurer votre serveur pour traiter AJAM implique quelques étapes :

Configurez le serveur HTTP Asterisk :

Décommentez la ligne enabled=yes dans /etc/asterisk/http.conf pour activer le micro serveur HTTP intégré d’Asterisk.
Si vous souhaitez qu’Asterisk livre réellement des pages HTML simples, CSS, JavaScript, etc., vous devez décommenter enablestatic=yes
Ajustez vos paramètres bindaddr et bindport selon vos besoins d’accessibilité ou laissez-les par défaut.
Ajustez votre préfixe si nécessaire, qui doit être le début de toute URI sur le serveur à faire correspondre. La valeur par défaut est asterisk et le reste de ces instructions suppose cette valeur.

Autoriser l’accès au gestionnaire via HTTP

Assurez-vous d’avoir à la fois enabled = yes et webenabled = yes configurés dans /etc/asterisk/manager.conf.
Vous pouvez également utiliser httptimeout pour définir un délai d’attente par défaut pour les connexions HTTP.
Assurez-vous d’avoir un nom d’utilisateur/mot de passe de gestionnaire.

Une fois ces modifications de configuration terminées, vous pouvez recharger ou redémarrer Asterisk et vous devriez pouvoir pointer votre navigateur Web vers des URI spécifiques qui vous permettront d’accéder à diverses fonctions Web. Une liste complète peut être trouvée en tapant show http à l’CLI d’Asterisk.

Exemples :

http://localhost:8088/asterisk/manager?action=login&username=mark&secret=mysecret

Cela vous connecte à la vue “HTML” de l’interface du gestionnaire. Une fois connecté, Asterisk stocke un cookie sur votre navigateur (valide pendant la durée de httptimeout) qui est utilisé pour se connecter à la même session.

http://localhost:8088/asterisk/rawman?action=status

En supposant que vous vous êtes déjà connecté au gestionnaire, cette URI vous donnera une sortie “brute” du gestionnaire pour la commande “status”.

http://localhost:8088/asterisk/mxml?action=status

Cela vous donnera la même vue d’état mais représentée comme des données AJAX, théoriquement compatible avec RICO ( http://www.openrico.org).

http://localhost:8088/asterisk/static/ajamdemo.html

Si vous avez activé le support du contenu statique et que vous avez effectué un make install, Asterisk servira une page de démonstration qui présente une interface “astman” en direct, mais très basique. Vous pouvez vous connecter avec votre nom d’utilisateur/mot de passe pour le gestionnaire et avoir une vue de base des canaux ainsi que transférer et raccrocher des appels. Cela n’a été testé que dans Firefox, mais pourrait probablement être fait pour fonctionner dans d’autres navigateurs également.

Une bibliothèque d’exemple ( astman.js) est incluse pour faciliter la création d’interfaces HTML de gestionnaire.

Notez que pour la démo, il n’est nécessaire d’aucun serveur Web externe.