✎ tutoriel:comment_transformer_un_programme_en_service [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== Comment transformer un programme en service ======

===== Définition =====

Service est traduit en anglais par daemon. Originellement **DAEMON** pour « Disk And Execution MONitor » est un programme réalisant des tâches de fond du système sous Unix. Appelé aussi driver sur d'autres systèmes. En temps normal, son fonctionnement ne doit pas être remarqué par l'utilisateur. Un démon peut aussi être un sous-programme appelé par un programme principal (dans ce cas on parle « sérieusement » de bibliothèque partagée).

----

===== Pourquoi ce tutoriel =====

Il est parfois nécessaire de transformer un programme en daemon, surtout lors de mise en place de serveur. Par exemple, les serveurs de jeux, ou des programmes de téléchargement automatique tel que **SABnzbd**. Le problème est que les scripts pour « daemonizer » que l'on trouve sur internet, sont mal conçus, voire dangereux pour le système en cas de mauvaise utilisation.

----

===== Mise en place =====

Il faut d'abord créer un script **sh** que nous appellerons dans notre exemple **SABnzbd.sh**. Le nom ici donné est tout à fait arbitraire. Généralement, par facilité, on préférera lui donner le même nom que le programme que l'on va transformer en démon.

<note warning>Il faut au préalable avoir rendu ce [[tutoriel:script_shell|programme exécutable]].
Pour cela, on lance son [[:editeur_de_texte|éditeur]] favori, soit [[:nano]] ou [[:vim]] en ligne de commande, soit [[:gedit]], [[:kate]] ou [[:mousepad]].
</note>

==== Script ====

On utilise proprement start-stop-daemon qui permet de transformer n'importe quel programme en démon.

<note important>Configurer correctement l'entête du script en fonction de votre utilisation!</note>

Voici un exemple pour **SABnzbd** :

<file bash SABnzbd.sh>
#!/bin/sh -e

DAEMON="/opt/SABnzbd-0.4.11/SABnzbd.py" #ligne de commande du programme, attention à l'extension .py.
daemon_OPT="-d -p -f /home/jfb/SABnzbd/sabnzbd.ini"  #argument à utiliser par le programme
DAEMONUSER="user" #utilisateur du programme
daemon_NAME="SABnzbd.py" #Nom du programme (doit être identique à l'exécutable).
#Attention le script est un script bash, le script ne portera donc pas l'extension .py mais .sh.

PATH="/sbin:/bin:/usr/sbin:/usr/bin" #Ne pas toucher

test -x $DAEMON || exit 0

. /lib/lsb/init-functions

d_start () {
        log_daemon_msg "Starting system $daemon_NAME Daemon"
	start-stop-daemon --background --name $daemon_NAME --start --quiet --chuid $DAEMONUSER --exec $DAEMON -- $daemon_OPT
        log_end_msg $?
}

d_stop () {
        log_daemon_msg "Stopping system $daemon_NAME Daemon"
        start-stop-daemon --name $daemon_NAME --stop --retry 5 --quiet --name $daemon_NAME
	log_end_msg $?
}

case "$1" in

start|stop)
                d_${1}
                ;;

restart|reload|force-reload)
                        d_stop
                        d_start
                ;;

force-stop)
               d_stop
                killall -q $daemon_NAME || true
                sleep 2
                killall -q -9 $daemon_NAME || true
                ;;

status)
                status_of_proc "$daemon_NAME" "$DAEMON" "system-wide $daemon_NAME" && exit 0 || exit $?
                ;;
        *)
                echo "Usage: /etc/init.d/$daemon_NAME {start|stop|force-stop|restart|reload|force-reload|status}"
                exit 1
                ;;
esac
exit 0
</file>

Maintenant on sauvegarde le fichier dans son répertoire home "/home/user/sabnzbd", ensuite on va le déplacer dans /etc/init.d et lui donner les bons droits d'exécution.

<code>
sudo cp /user/home/sabnzbd /etc/init.d/.
sudo chmod 0755 /etc/init.d/sabnzbd
</code>

On reload les daemons du système :
<code>
systemctl daemon-reload
</code>

On teste notre script :

<code>
sudo /etc/init.d/sabnzbd start
* Starting system SABnzbd Daemon

sudo /etc/init.d/sabnzbd stop
* Stopping system SABnzbd Daemon  
</code>

Maintenant on ajoute le service au démarrage de l'ordinateur :

<code>
sudo update-rc.d sabnzbd defaults

Adding system startup for /etc/init.d/sabnzbd ...
   /etc/rc0.d/K20sabnzbd -> ../init.d/sabnzbd
   /etc/rc1.d/K20sabnzbd -> ../init.d/sabnzbd
   /etc/rc6.d/K20sabnzbd -> ../init.d/sabnzbd
   /etc/rc2.d/S20sabnzbd -> ../init.d/sabnzbd
   /etc/rc3.d/S20sabnzbd -> ../init.d/sabnzbd
   /etc/rc4.d/S20sabnzbd -> ../init.d/sabnzbd
   /etc/rc5.d/S20sabnzbd -> ../init.d/sabnzbd

</code>

Pour le retirer :

<code>
sudo update-rc.d -f sabnzbd remove

Removing any system startup links for /etc/init.d/sabnzbd ...
   /etc/rc0.d/K20sabnzbd
   /etc/rc1.d/K20sabnzbd
   /etc/rc2.d/S20sabnzbd
   /etc/rc3.d/S20sabnzbd
   /etc/rc4.d/S20sabnzbd
   /etc/rc5.d/S20sabnzbd
   /etc/rc6.d/K20sabnzbd
</code>

Voila, votre programme fonctionne en tant que daemon et sera lancé automatique au démarrage de l'ordinateur.

----

===== Documentation supplémentaire  et liens =====

* [[man>start-stop-daemon]] de Ian Jackson
  * [[man>update-rc.d]]
  * [[wpfr>Daemon_(informatique)]]
  * http://jargonf.org/wiki/d%C3%A9mon
  * http://www.linuxtricks.fr/wiki/systemd-les-commandes-essentielles

----
//Contributeurs : Rédigée et maintenue par [[:utilisateurs/RedLemon]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : N R I L B Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported