systemd-Dienst

VARIOS AI Update-Helfer (varios.sh) als systemd-Service einrichten und betreiben

Für On-Premise-Installationen stellt VARIOS AI das Skript varios.sh bereit. Es überwacht im Hintergrund die Datei update_version und führt bei einer neuen Zielversion automatisch ein Update durch (Docker-Images ziehen, Container neu starten, Migrations-Skripte ausführen).

Damit der Update-Helfer nach einem Neustart des Servers zuverlässig startet, können Sie ihn als systemd-Service registrieren.

Docker muss installiert und startbar sein. After=docker.service legt die Start-Reihenfolge fest; Wants=docker.service startet Docker beim Start dieses Services mit — auch wenn Docker nicht für den Autostart aktiviert ist. Für Server-Neustarts empfehlen wir zusätzlich systemctl enable docker.service. Der Service führt varios.sh --daemon direkt aus — die Ausgabe landet in journald, nicht in varios.log.

---

​

Service-Datei

Passen Sie WorkingDirectory an das Verzeichnis an, in dem varios.sh liegt:

varios-update.service

[Unit]
Description=Start varios.sh
After=docker.service
Wants=docker.service

[Service]
Type=simple
ExecStart=/bin/sh ./varios.sh --daemon
WorkingDirectory=/docker/varios/

[Install]
WantedBy=multi-user.target

---

​

Einrichtung

1. WorkingDirectory anpassen

   Setzen Sie WorkingDirectory in varios-update.service auf den absoluten Pfad zum VARIOS-Installationsverzeichnis mit varios.sh, docker-compose.yml und .env (z. B. /docker/varios/).

2. Service-Datei installieren und systemd neu laden

   cp varios-update.service /etc/systemd/system/
   systemctl daemon-reload
   

   Ohne daemon-reload erkennt systemd die neue Service-Datei nicht — enable oder start schlagen dann fehl.

3. Service aktivieren und starten

   systemctl enable --now varios-update.service
   
4. Einrichtung prüfen

   systemctl status varios-update.service
   

   Der Status sollte active (running) anzeigen.

   Logs live mitlesen: journalctl -u varios-update.service -f

---

​

Betrieb

Steuern Sie den Helfer ausschließlich über systemd — nicht über ./varios.sh --stop. Der systemd-Service startet varios.sh --daemon direkt im Vordergrund und legt dabei keine varios.pid an. ./varios.sh --stop greift daher nur, wenn der Helfer zuvor manuell ohne systemd gestartet wurde.

# Status prüfen
systemctl status varios-update.service

# Update-Überwachung stoppen (z. B. vor Wartungsarbeiten)
systemctl stop varios-update.service

# Update-Überwachung wieder starten
systemctl start varios-update.service

# Autostart deaktivieren (Service bleibt bis zum nächsten Stopp aktiv)
systemctl disable varios-update.service

systemctl stop beendet die Update-Überwachung. Laufende docker compose-Befehle innerhalb eines Updates können dabei unterbrochen werden, weil systemd den Service-Prozess und seine Kindprozesse beendet (KillMode=control-group).

---

​

Logs und Fehlersuche

Quelle	Befehl	Inhalt
systemd (primär)	journalctl -u varios-update.service -f	Update-Prüfungen, Update-Ablauf, Fehler
systemd (letzte Einträge)	journalctl -u varios-update.service -n 50 --no-pager	Kürzliche Historie für die Fehlersuche

varios.log und varios.pid werden nur erzeugt, wenn Sie ./varios.sh ohne systemd manuell starten — nicht bei Betrieb über diesen Service.

​

Typische Prüfschritte

Service startet nicht

• Läuft Docker? systemctl status docker.service
• Stimmt WorkingDirectory mit dem Installationsverzeichnis überein?
• Wurde nach dem Kopieren der Service-Datei systemctl daemon-reload ausgeführt?
• Details: journalctl -u varios-update.service -n 50 --no-pager

Service läuft, aber kein Update

• Enthält .env die aktuelle VERSION=?
• Liegt in update_version eine abweichende Zielversion?
• Protokoll prüfen: journalctl -u varios-update.service -f

Helfer läuft doppelt

• Prüfen, ob zusätzlich ein manuell gestarteter Helfer läuft: pgrep -af varios.sh
• Manuell gestarteten Helfer beenden: ./varios.sh --stop (nur wenn varios.pid existiert)
• systemd-gesteuerten Helfer beenden: systemctl stop varios-update.service