{{tag>BROUILLON}}

====== Lancement automatique de programmes au démarrage ======

Ce tutoriel décrit les logiciels à installer et la démarche à suivre pour faire ...

===== Première méthode : systemd =====

Sous Debian 8, le mécanisme init.d est remplacé par le mécanisme **systemd** que nous présentons ici.

<WRAP center round info 60%>
Nous prenons l'exemple de vncserver sur une <abbr>Raspberry pi(RPI)</abbr>.
</WRAP>

==== Première étape ====

Créez avec les droits d'administration le fichier **/etc/systemd/system/monprogramme.service** pour y écrire ceci :

<code - /etc/systemd/system/monprogramme.service>
[Unit]
Description=Programme monprogramme

[Service]
ExecStart=/bin/monprogramme

[Install]
WantedBy=multi-user.target
</code>

<WRAP center round info 60%>
__**Section [Unit]**__
  ;? Description=Programme monprogramme :: Commentaire descriptif !!

__**Section [Service]**__
  ;? ExecStart=/bin/monprogramme :: commande qui démarre le service. !!

__**Section [Install]**__
  ;? WantedBy=multi-user.target :: s'exécutera au redémarrage si on l'active par une commande enable !!

</WRAP>
<WRAP center round tip 60%>
Dans certains cas, le programme doit être lancé sous un USER particulier, comme pour vncserver sous l'utilisateur **pi** :

<code ->
[Unit]
Description=Programme monprogramme

[Service]
RemainAfterExit=yes
Environment=VNCUSER='pi'
ExecStart=/bin/su $VNCUSER -c 'vncserver :1'
ExecStop=/bin/su $VNCUSER -c 'vncserver -kill :1'

[Install]
WantedBy=multi-user.target
</code>

__**Section [Unit]**__
  ;? Description=Serveur vncserver :: Commentaire descriptif !!

__**Section [Service]**__
  ;? RemainAfterExit=yes :: Nécesaire pour pouvoir démarrer ou arrêter le service. !!
  ;? ExecStart=/bin/su - pi -c '/usr/bin/vncserver :1' :: commande qui démarre le service. (exécutée sous l'utilisateur pi) !!
  ;? ExecSop=/bin/su - pi -c '/usr/bin/vncserver -kill :1' :: commande qui démarre le service. (exécutée sous l'utilisateur pi) !!

__**Section [Install]**__
  ;? WantedBy=multi-user.target :: s'exécutera au redémarrage si une commande enable est lancée. !!

Pour le format du fichier **.service**, voir les pages de man :
  * **systemd.service** [[http://www.freedesktop.org/software/systemd/man/systemd.service.html]]
  * sections [unit] et [install] : **systemd.unit** [[http://www.freedesktop.org/software/systemd/man/systemd.unit.html]]

ou la page [[logiciel:systeme:systemd:start]]
</WRAP>

==== Etape suivante : activation ====

L'activer en lançant :
  * <code>systemctl daemon-reload
systemctl enable vncserver
systemctl start vncserver</code>

===== Deuxième méthode : avec un fichier vncserver.desktop =====

Créez le fichier **/home/pi/.config/monprogramme.desktop** pour y écrire ceci :

<code - /home/pi/.config/vncserver.desktop>
[Desktop Entry]
Type=Application
Name=monprogramme
Exec=monprogramme <args...>
StartupNotify=false
</code>

Au prochain redémarage, monprogramme sera démarré.

Pour l'arrêter, il faut faire :
  * <code>killall monprogramme</code>

et pour le démarrer :
  * <code>monprogramme <args...></code>

===== Troisième méthode : avec init.d =====

<term monprogramme>nom du service à créer</term>

Ce tutoriel décrit la démarche à suivre pour qu'un programme démarre en tant que service.

Il faut pour cela créer un lanceur dans **/etc/init.d**.

Pour un démarrage automatique, il faut l’ajouter comme service au démarrage de Linux.

==== Première étape : créer le lanceur ====

Pour créer un lanceur dans **/etc/init.d**, le plus simple est de partir du modèle fourni **/etc/init.d/skeleton**.

Copiez le fichier **/etc/init.d/skeleton** fourni comme modèle :
  * <code>sudo cp /etc/init.d/skeleton /etc/init.d/monprogramme</code>

<WRAP center round tip 60%>
Voici le contenu du ficher skeleton :

<code - /etc/init.d/skeleton>
#! /bin/sh
### BEGIN INIT INFO
# Provides:          skeleton
# Required-Start:    $remote_fs
# Required-Stop:     $remote_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Example initscript
# Description:       This file should be used to construct scripts to be
#                    placed in /etc/init.d.
### END INIT INFO

# Author: Foo Bar <foobar@baz.org>
#
# Please remove the "Author" lines above and replace them
# with your own name if you copy and modify this script.

# Do NOT "set -e"

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Description of the service"
NAME=daemonexecutablename
DAEMON=/usr/sbin/$NAME
DAEMON_ARGS="--options args"
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0

# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME

# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh

# Define LSB log_* functions.
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
. /lib/lsb/init-functions

#
# Function that starts the daemon/service
#
do_start()
{
	# Return
	#   0 if daemon has been started
	#   1 if daemon was already running
	#   2 if daemon could not be started
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
		|| return 1
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
		$DAEMON_ARGS \
		|| return 2
	# Add code here, if necessary, that waits for the process to be ready
	# to handle requests from services started subsequently which depend
	# on this one.  As a last resort, sleep for some time.
}

#
# Function that stops the daemon/service
#
do_stop()
{
	# Return
	#   0 if daemon has been stopped
	#   1 if daemon was already stopped
	#   2 if daemon could not be stopped
	#   other if a failure occurred
	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
	RETVAL="$?"
	[ "$RETVAL" = 2 ] && return 2
	# Wait for children to finish too if this is a daemon that forks
	# and if the daemon is only ever run from this initscript.
	# If the above conditions are not satisfied then add some other code
	# that waits for the process to drop all resources that could be
	# needed by services started subsequently.  A last resort is to
	# sleep for some time.
	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
	[ "$?" = 2 ] && return 2
	# Many daemons don't delete their pidfiles when they exit.
	rm -f $PIDFILE
	return "$RETVAL"
}

#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
	#
	# If the daemon can reload its configuration without
	# restarting (for example, when it is sent a SIGHUP),
	# then implement that here.
	#
	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
	return 0
}

case "$1" in
  start)
	[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
	do_start
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
	;;
  stop)
	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
	do_stop
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
	;;
  #reload|force-reload)
	#
	# If do_reload() is not implemented then leave this commented out
	# and leave 'force-reload' as an alias for 'restart'.
	#
	#log_daemon_msg "Reloading $DESC" "$NAME"
	#do_reload
	#log_end_msg $?
	#;;
  restart|force-reload)
	#
	# If the "reload" option is implemented then remove the
	# 'force-reload' alias
	#
	log_daemon_msg "Restarting $DESC" "$NAME"
	do_stop
	case "$?" in
	  0|1)
		do_start
		case "$?" in
			0) log_end_msg 0 ;;
			1) log_end_msg 1 ;; # Old process is still running
			*) log_end_msg 1 ;; # Failed to start
		esac
		;;
	  *)
	  	# Failed to stop
		log_end_msg 1
		;;
	esac
	;;
  *)
	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
	echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
	exit 3
	;;
esac
:
</code>
</WRAP>

==== Autres étapes ====

=== Édition du lanceur ===

Ouvrez avec les droits d'administration le fichier **/etc/init.d/monprogramme** et repérez les lignes suivantes:

<code>PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Description of the service"
NAME=daemonexecutablename
DAEMON=/usr/sbin/$NAME
DAEMON_ARGS="--options args"
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME</code>

Renseignez ce qui concerne **monprogramme** :

^Variable^Valeur^Commentaire^
^DESC|**mon programme**|description|
^NAME|**monprogramme**|nom du service dans **/usr/bin**|
^DAEMON|**/usr/bin/$NAME**|monprogramme se trouve dans **/usr/bin** et non dans **/usr/sbin**|
^DAEMON_ARGS|**""**|arguments pour lancer monprogramme|

Ce qui donne:

<code>PATH=/usr/sbin:/usr/bin:/sbin:/bin
DESC="Programme de ..."
NAME=monprogramme
DAEMON=/usr/bin/$NAME
DAEMON_ARGS=""
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME</code>

Editez l'en-tête :
^  le code  ^  devient  ^
|<code>### BEGIN INIT INFO
# Provides:          skeleton
# Required-Start:    $remote_fs
# Required-Stop:     $remote_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Example initscript
# Description:       This file should be used to construct scripts to be
#                    placed in /etc/init.d.
### END INIT INFO</code>|<code>### BEGIN INIT INFO
# Provides:          monprogramme
# Required-Start:    $remote_fs
# Required-Stop:     $remote_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Programme monprogramme
# Description:       Ce fichier lance le service monprogramme
### END INIT INFO</code>|

Pour que le programme crée un fichier **.pid** ((nécessaire pour pouvoir l'arrêter)), ajoutez l'option **--make-pidfile** (ou **-m**) dans les deux lignes commençant par **start-stop-daemon --start...** de la procédure **do_start()**

Ce qui donne dans **/etc/init.d/monprogramme** : 

<code>
#
# Function that starts the daemon/service
#
do_start()
{
	start-stop-daemon --start --quiet --m --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
		|| return 1
	start-stop-daemon --start --quiet --m --pidfile $PIDFILE --exec $DAEMON -- \
		$DAEMON_ARGS \
		|| return 2
[...]
}
</code>

Pour plus de détails, voir la page [[logiciel:os:linux:commandes_linux:start-stop-daemon]]

=== Activation ===

Rendez le script exécutable :
  * <code>sudo chmod +x /etc/init.d/monprogramme</code>

et activez-le :
  * <code>sudo update-rc.d monprogramme defaults</code>

===== Autres étapes =====

===== Conclusion =====

===== Problèmes connus =====

===== Voir aussi =====

  * (en) [[https://learn.adafruit.com/downloads/pdf/running-programs-automatically-on-your-tiny-computer.pdf]] 

----
//Contributeurs principaux : [[:utilisateurs:jamaique]].//

//Basé sur [[http://www.document_source.com|« Titre original de l’article »]] par [Auteur Original].//