## page was renamed from Asterisk/Dépannage
= Suivi et débogage d'un serveur Asterisk =

Les commandes de base :

 * démarrer le serveur : `/etc/init.d/asterisk start`  (mais cela est normalement fait au boot de la machine)

 * si vous avez modifié la configuration, demandez à Asterisk de la relire : `/etc/init.d/asterisk reload`. Attention : ne faites JAMAIS de `restart` sinon vous coupez les communications en cours ! Evitez si possible même de faire un reload, cela peut avoir des conséquences également sur les communications en cours.

Asterisk dispose d'un '''mode console''', en ligne de commande, très pratique et qu'il est conseillé d'approfondir si vous voulez vraiment vous amuser avec Asterisk. Ce mode console est disponible avec `asterisk -r` ou `rasterisk`. En ajoutant l'option `-v` vous pouvez de plus déboguer en direct (affichage des logs sur la console). Plus vous mettez de `-v` plus le niveau de débogage est élevé. Pour bien comprendre comment fonctionne Asterisk il est donc conseiller de lancer carrément la commande suivante :

 {{{
# rasterisk -vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv      # on met "plein" de "v"
Asterisk 1.4.17~dfsg-1auf3, Copyright (C) 1999 - 2007 Digium, Inc. and others.
Created by Mark Spencer <markster@digium.com>
Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.
This is free software, with components licensed under the GNU General Public
License version 2 and other licenses; you are welcome to redistribute it under
certain conditions. Type 'core show license' for details.
=========================================================================
This package has been modified for the Debian GNU/Linux distribution
... et ensuite par l'AUF ! Envoyez les bugs à thomas.noel@auf.org
=========================================================================
  == Parsing '/etc/asterisk/extconfig.conf': Found
Connected to Asterisk 1.4.17~dfsg-1auf3 currently running on voip (pid = 5607)
Verbosity is at least 55
voip*CLI>
}}}

Vous êtes alors en mode ligne de commande (''CLI = command line interface''). Elle fonctionne un peu comme sur la ligne de commande d'un Cisco :  tapez `help` pour avoir la liste des commandes, utilisez la touche [Tab] ou `?` pour la complétion automatique, etc.

Une commande extrémement utile est `module reload` :

 {{{
gatekeeper*CLI> module reload
  == Parsing '/etc/asterisk/extconfig.conf': Found
  (...)
gatekeeper*CLI>
}}}
qui va demander à asterisk de relancer tous ses modules. Chacun va relire son fichier de configuration. Vous pouvez être plus précis en ne demandant la recharge que de certains modules, par exemple :

 * `dialplan reload` rechargera le fichier extensions.conf (c'est-à-dire le plan de numérotation des postes)
 * `iax2 reload` ne re-chargera que ce qui concerne IAX

= Quand tout est cassé, réinstallation complète d'Asterisk =

 1. Suppression complète ('''n'oubliez pas de copier d'abord au moins votre clé privée !''') :
 {{{
# /etc/init.d/asterisk stop
# mkdir -p /root/asterisk-backup
# cp -a /etc/asterisk /root/asterisk-backup/etc             # on garde une copie de la configuration
# cp -a /usr/share/asterisk/keys /root/asterisk-backup/keys # on garde une copie des clés
# aptitude purge asterisk asterisk-config-auf asterisk-config-auf-connexions asterisk-app-conference asterisk-prompt-fr asterisk-sounds-main asterisk-moh-auf
# rm -rf /etc/asterisk /usr/share/asterisk /var/lib/asterisk /var/spool/asterisk /var/run/asterisk

}}}

Note : éventuellement, pensez à copier les fichiers de logs pour les statistiques, contenus dans `/var/log/asterisk/`.

 1. Réinstallation :
 {{{
# mkdir -p /usr/share/asterisk/keys                                 # on remet en place la clé privée (début)
# cp -a /root/asterisk-backup/keys/*.key /usr/share/asterisk/keys   # on remet en place la clé privée (fin)
# aptitude install asterisk 
}}}

 1. Reconfiguration : reprendre les configurations des postes clients (`sip.local`, `iax.local`, `extensions.local`, etc.) que vous avez copiées dans `/root/asterisk-backup/etc`.