Documentation du service VoIP

Documentation du service VoIP

Responsable : Jarod Boulanger-Flémal

Statut de l'étape : en attend de validation

Organisation des configurations

Les fichiers de configuration du service VoIP se trouvent trouve tous dans le fichier /etc/asterisk du container du Docker asterisk et sont trouvable ici.

Ils ont organisés de la manière suivante :

• Les utilisateurs sont définis dans le fichier users.conf
• Le service principal est configuré dans le fichier sip.conf
• Les extensions sont configurer dans le fichier extensions.conf

Maintenance

Procédure pour mettre à jour le(s) logiciel(s) serveur

L'image docker utilise debian lite, pour mettre a jour n'import quel packet du conteneur il faut donc s'y connecter avec la commande docker exec -it asterisk asterisk /bin/bash et ensuite lancer la commande de mise a jour apt update pour vérifier que tout les packets sont a jour puis apt ugrade pour les installer.

Procédure en cas d'ajout d'un nouvel utilisateur

L'ajout d'un utilisateur va demander la modification de deux fichier : users.conf pour la création du compte avec sont numéro et le changement de extensions.conf pour ajouter un chemin vers le numéro précédemment créé.

Voici la template pour la création d'un utilisateur dans le fichier users.conf :

[100]
type=friend ;permet de ce connecter a se compte même si l'adrress IP est mauvaise, de notre peer permettrai plus de sécurité
username=jarod ;nom d'utilisateur
callerid=100 ;numero a appeler
secret= ;mot de passe
context=test ;fait référence a la partie context (test en l'occurence) du fichier extensions.conf
host=dynamic ;dynamic veux dire que le numéro doit être enregistrer pour recevoir et envoyer des appels
allow=all #qui peux appeler se numéro

Puis ajouter ça route dans le fichier extensions.conf :

exten => 100,1,Dial(SIP/100) #100 étant le numéro de l'utilisateur ajouter et SIP le protocole

une fois les fichier modifier, relancer le Conteneur avec la commande docker restart asterisk

Procédure en cas de départ d'un employé

Même procédure que précédemment mais au lieu d'ajouter la configuration, supprimer la configuration de l'utilisateur.

• Supprimer ça configuration du fichier user.conf.
• Supprimer ça route du fichier extensions.conf.
• Relancer le service avec la commande sudo docker restart asterisk

Troubleshooting

Procédures et collecte d'information

En cas de dysfonctionnement, voici les éléments à observer pour trouver des informations de debug :

Logs : Fichiers /var/log/asterisk

• Procédure de test 1 : Taper la commande "nmap 176.96.231.198" pour tester la joignabilité du service sur le port 5060.
• Procédure de test 2 : Taper la commande "docker ps" pour vérifier que le docker est bien en état de fonctionnement.
• Procédure de test 3 : Relancer le service en mode interactif pour les logs en direct du service.
• Procédure de test 3 : Avec la commande docker exec -it asterisk asterisk -rvvvvv entrer mode console, nous allons tester trois commandes.

1. sip show peers cette commande va nous montrer l'utilisateur, l'IP du serveur, le port, le status de la communication et le nombre de communication sur le serveur. Si le status est "OK" cela veut dire que le problème ne viens pas des points cité précédemment.
2. sip show registry cette commande montre les extensions enregistrées avec l'IP, le nom de l'utilisateur et le statut du registre. Si status de l'exentions est toujours en attente, le problème peut venir des extensions.
3. sip show users cette commande permet de voir que si tout les configurations des comptes utilisateur enregistré son correcte.

Erreurs fréquentes

• Fichier de configuration erronée ou manquant.

Ce mettre en mode console lors du lancement du docker pour bien vérifier que le services charge bien tout les configurations.

• Firewall activer sur le port 5060 en TCP et UDP.

Résolution : bien vérifier le port utiliser par asterisk (5060 par défaut) et l'ouvrire