wiki/HowtoSupervisor.md

Howto Supervisor

C'est un système qui permet à ses utilisateurs de surveiller et de contrôler un certain nombre de processus. il est destiné à être utilisé pour contrôler les processus liés à un projet ou à un client, et est conçu pour démarrer comme tout autre programme au démarrage.

http://supervisord.org/

# apt install supervisor

Configuration

Fichier /etc/supervisor/supervisord.conf

Par exemple pour écouter sur le port TCP/9001 (sans authentification) :

[inet_http_server]
port = 127.0.0.1:9001

On peut ensuite faire :

$ supervisorctl -s http://127.0.0.1:9001 status

Exemple

Si l'on souhaite surveiller le process /home/bar/foo

# cat /etc/supervisor/conf.d/foo.conf
[program:foo]
user=bar
command=/home/bar/foo
autostart=true
autorestart=true
stderr_logfile=/home/bar/log/foo.error.log
stdout_logfile=/home/bar/log/foo.log

# supervisorctl reread 
# supervisorctl update

# supervisorctl
foo                    RUNNING   pid 42042, uptime 0:42:42
supervisor> stop foo
foo: stopped
supervisor> start foo
foo: started
supervisor> help

default commands (type help <topic>):
=====================================
add    exit      open  reload  restart   start   tail   
avail  fg        pid   remove  shutdown  status  update 
clear  maintail  quit  reread  signal    stop    version

En cas de soucis

On vérifie si le process tourne encore

# ps -ef | grep supervisord

Si c'est le cas on peut le kill (et kill -9 si ça n'a pas suffit).

Si ce n'est plus le cas, il se peut qu'il soit nécessaire de supprimer la socket

# unlink /var/run/supervisor.sock