Betrieb

Wartung

Die beiden Cron-Einträge stehen in Cron einrichten.

Die Befehle

Befehl Was er tut
formrelay:cleanup Aufbewahrungsfristen durchsetzen, hängende Zustellungen neu einreihen, eingespielte Update-Pakete entfernen. Ohne --force verändert er nichts (Testlauf)
formrelay:check Voraussetzungen prüfen, ohne etwas zu ändern
formrelay:mail-test [adresse] [--no-dns] Mail-Versand prüfen: wirksame Konfiguration (ohne Passwort), Verbindung, Test-Mail (Vorgabe: an den ersten Administrator), Antwort des Servers, SPF/DMARC-Hinweise. Exit-Code 1, wenn die Test-Mail nicht angenommen wurde
formrelay:install Einrichten — siehe Installation
formrelay:installed Exit-Code 0, wenn die Installation eingerichtet ist, sonst 1
queue:work --stop-when-empty Die Warteschlange abarbeiten und sich beenden, sobald sie leer ist
queue:restart Laufende Worker nach ihrem aktuellen Auftrag beenden, damit sie mit neuem Code starten
queue:failed Endgültig gescheiterte Aufträge auflisten; queue:retry stellt sie erneut ein, queue:flush löscht sie

Aufräumen: die Kategorien

Kategorie Was
Zugestellte Einsendungen nach Ablauf der Aufbewahrung ihres Formulars — nie länger als die Höchstdauer unter Einstellungen → Funktionen
Unzustellbare Einsendungen nach der Frist für Unzustellbares (7, 14 oder 30 Tage, Vorgabe 30)
Gescheiterte Aufträge (failed_jobs) nach derselben Frist
Tageszähler je Formular nach 90 Tagen
Hängende Zustellungen seit 24 Stunden ohne Versuch — werden neu eingereiht, nicht gelöscht
Eingespielte Update-Pakete Pakete unter storage/app/private/updates/, deren Fassung nicht neuer ist als die installierte. Ohne Datei VERSION bleiben sie liegen

Der Lauf rechnet jede Frist mit den Werten neu, die jetzt gelten. Eine gesenkte Höchstdauer wirkt deshalb beim nächsten Lauf auch auf Einsendungen, die schon gespeichert sind. Einsendungen, die noch zugestellt werden, haben keine Frist.

Einsendungen werden zusätzlich minutengenau gelöscht, sobald ihre Frist abläuft — über die Warteschlange. Der tägliche Lauf fängt ab, was dabei liegen bleibt. Die geltenden Fristen zeigt die Karte „Geltende Fristen" unter Einstellungen → Wartung.

Dasselbe Aufräumen steht in der Oberfläche unter Einstellungen → Wartung: „Testlauf", dann „Jetzt aufräumen" mit Bericht.

Läuft der Cron?

Einstellungen → Systemdaten, Karte „Zeitsteuerung (Cron)" zeigt je Auftrag den letzten Lauf. Ist einer nie gelaufen oder länger her, als sein Takt erwarten lässt, erscheint oben auf derselben Seite eine Warnung.

Nicht mitgezählt werden der Testlauf ohne --force und das Aufräumen über den Knopf unter Einstellungen → Wartung. Ein Aufruf von Hand zählt dagegen wie ein Cron-Lauf — die Anzeige kennt nur den letzten tatsächlichen Lauf, nicht seinen Auslöser.

Regelmäßig ansehen

  • Einstellungen → Systemdaten: Warnungen, freier Platz auf der Festplatte.
  • php artisan queue:failed auf gescheiterte Aufträge.
  • storage/logs/laravel.log auf wiederkehrende Fehler.

Quelle dieser Seite: docs/betrieb/wartung.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.