agorum core unter Linux automatisch starten

Hinweise:

Diese Anleitung dient als reines Beispiel. Wir übernehmen keine Garantie dafür, dass dieses Skript ohne weitere Anpassungen in Ihrer Umgebung / Distribution läuft.
Das Beispiel geht davon aus, dass agorum core im Standard-Verzeichnispfad /opt/agorum/agorumcore installiert ist.

agorum core als Dienst automatisch starten

Unter Linux können Sie Programme als Dienste automatisch starten lassen. Dazu binden Sie ein entsprechendes Startscript in /etc/init.d/ ein. Das nachfolgende Beispiel-Skript läuft erfolgreich auf diversen Debian- und Ubuntu-Systemen.

vim /etc/init.d/agorumcored

#!/bin/sh
### BEGIN INIT INFO
# Provides:             agorumcored
# Required-Start:
# Required-Stop:
# Default-Start:        2 3 4 5
# Default-Stop:         0 1 6
# Short-Description:    agorum core DMS Server
### END INIT INFO

set -e
export PATH="${PATH:+$PATH:}/usr/sbin:/sbin"

. /lib/lsb/init-functions

do_start () {
 log_daemon_msg "Starting agorum core server" "agorumcored"
 if start-stop-daemon --start -b --quiet --oknodo --pidfile /var/run/agorumcore.pid --exec /opt/agorum/agorumcore/scripts/agorumcore start; then
		sleep 10
		log_end_msg 0
 else
   log_end_msg 1
 fi
}

do_startdeferred () {
 log_daemon_msg "Starting agorum core server" "agorumcored"
 if start-stop-daemon --start -b --quiet --oknodo --pidfile /var/run/agorumcore.pid --exec /opt/agorum/agorumcore/scripts/agorumcore startdeferred; then
		sleep 10
		log_end_msg 0
 else
   log_end_msg 1
 fi
}

do_stop () {
 log_daemon_msg "Stopping agorum core server" "agorumcored"
 if start-stop-daemon --start -b --oknodo --pidfile /var/run/agorumcore.pid --exec /opt/agorum/agorumcore/scripts/agorumcore stop; then
		sleep 5
		log_end_msg 0
 else
		log_end_msg 1
 fi
}

case "$1" in
 start)
		do_start
   ;;
 startdeferred)
		do_startdeferred
   ;;
 restart|reload|force-reload)
   do_stop
		do_start
   ;;
 stop)
   do_stop
   ;;
 *)
   echo "Usage: $0 start|stop|restart" >&2
   exit 3
   ;;
esac

:

Erstellen Sie ein neues JavaScript mit dem oben abgebildeten Beispielcode. Benennen Sie das Skript etwa folgendermaßen:
```
agorumcored
```
Legen Sie dieses Skript auf Ihrem agorum core-Server unter folgendem Pfad ab:
```
/etc/init.d
```
Machen Sie das Skript mit folgendem Befehl ausführbar:
```
chmod +x agorumcored
```
Erstellen Sie mit folgendem Befehl die passenden Symlinks in den jeweiligen init-Bereichen:
```
update-rc.d agorumcored defaults
```
Ergebnis: Ab sofort wird agorum core sauber heruntergefahren, wenn Sie den Server rebooten oder herunterfahren.

agorum core als Applikation automatisch starten

agorum core können Sie als Applikation automatisch starten lassen. In den folgenden Abschnitten wird die Methode mit rc-local beschrieben, bei der Sie eine Verzögerungszeit festlegen können.

Startskript-Datei „rc.local“

Das Editieren der Datei findet in einem Texteditor (etwa nano) mit Root-Rechten (sudo) statt. Das Skript hat nach Änderung folgendes Aussehen:

#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel. Make sure
# that the script will "exit 0" on success or any other value on error.
#
# In order to enable or disable this script just change the execution bits.
#
# By default this script does nothing.

sleep 300
/opt/agorum/agorumcore/scripts/agorumcore start

exit 0

Struktur der Datei „rc.local“

Das # am Zeilenanfang definiert die Beschreibung.
Eigene Einträge setzen Sie nach der Beschreibung und vor exit 0.
exit 0 muss immer am Ende der Datei stehen.

Einträge

Die Einträge benötigen kein sudo, da die Dateieinträge immer mit Root-Rechten ausgeführt werden.
Sicherheitshalber geben Sie immer den kompletten Pfad zum gewünschten Programm an, etwa /usr/bin/foo.

Beispiel-Eintrag zum Start des agorum core-Dienstes

Editieren Sie die Datei rc.local und stellen Sie die Verzögerung in Sekunden ein (5 Minuten = 300 Sekunden):
```
sleep 300
```
Geben Sie eine Zeile darunter den Pfad zum Start von agorum core an:
```
/opt/agorum/agorumcore/scripts/agorumcore start
```
Ergebnis: Beim nächsten Systemstart werden die neu hinzugefügten Einträge ausgeführt.