Cron-Job

Der Cron-Prozess von Moodle ist ein PHP-Skript, das zum Moodle-Standardpaket gehört, und das regelmäßig im Hintergrund ausgeführt werden muss. Das Moodle-Cron-Skript führt in verschiedenen Zeitabständen verschiedene Aufgaben aus.

Wichtig: Sie müssen den Cron-Prozess unbedingt aufsetzen, andernfalls funktioniert Ihre Moodle-Site nicht richtig.

Es wird empfohlen, den Cron-Job jede Minute laufen zu lassen, wie es für das asynchrone Löschen von Aktivitäten bei Verwendung des Papierkorbs erforderlich ist.

Das Cron-Programm (welches das Moodle-Cron-Skript ausführt) ist Kernbestandteil jedes UNIX-basierten Systems (inkl. Linux und OSX). Es wird verwendet, um alle Arten von zeitabhängigen Diensten laufen zu lassen. Unter Windows ist die einfachste Lösung das Anlegen eines Tasks im Windows Task Scheduler, das in regelmäßigen Zeitabständen ausgeführt wird.

Einen Cron-Job einrichten bedeutet im Wesentlichen, eine Zeile in die Liste der Cron-Prozesse auf Ihrem Server einzutragen. Auf Unix-basierten Systemen ist diese Liste eine Datei crontab, die alle Nutzer/innen des Servers haben.

Allgemeines

Dieser Abschnitt gibt einige allgemeine Hintergrundinformationen. Serverabhängige Informationen finden Sie weiter unten.

Das Aufsetzen eines Cron-Prozesses erfordert zwei Schritte:

1. Das richtige Kommando identifizieren, das ausgeführt werden muss.
2. Die richtige Stelle auf Ihrem Server finden, an der das Kommando eingetragen werden muss.

Das richtige Kommando identifizieren

In Moodle gibt es zwei Möglichkeiten, das Cron-Skript auszuführen:

1. CLI-Skript (CLI = command line interpreter, Kommandozeileninterpreter): Der Pfad zu diesem Skript ist <moodle_installationsverzeichnis>/admin/cli/cron.php. Dieses Skript muss von einem PHP CLI Programm auf Ihrem Server ausgeführt werden, z.B. durch folgendes Kommando:

/usr/bin/php <moodle_installationsverzeichnis>/admin/cli/cron.php Sie können (und sollten) diesen Befehl von Kommandozeile aus testen, um zu sehen, ob er funktioniert. Hinweis: Prüfen Sie, ob Ihre Kommandozeilen-PHP-Version kompatibel mit Ihrer Moodle-Version ist. Das Kommandozeilen-PHP-Programm ist nicht dasselbe PHP-Programm, das Ihre Website nutzt und beide PHP-Programme haben nicht immer dieselbe Version.

1. Wenn Sie aus irgendeinem Grund nicht das CLI-Skript verwenden können, dann gibt es als Alternative ein webbasiertes Skript. Dieses Skript ist allerdings als "veraltet/deprecated" markiert und kann in zukünftigen Moodle-Versionen gelöscht sein. Dieses Skript muss im Webbrowser aufgerufen werden, der Zugriff erfolgt über die URL <code>http://Ihre.Moodle.Site/admin/cron.php</code>. Sie können einen kommandozeilen-basierten Webbrowser verwenden (z.B. wget), d.h. das Kommando könnte z.B. lauten:

/usr/bin/wget http://Ihre.Moodle.Site/admin/cron.php Der Vorteil dieses Kommandos besteht darin, dass es von überall ausgeführt werden kann, also nicht notwendigerweise von Ihrem Moodle-Server aus (auf den Sie evtl. gar keinen Zugriff haben), sondern von irgend einem Server aus, auf den Sie zugreifen dürfen.

Das webbasierte Moodle-Cron-Skript

• Wenn Sie die Wahl haben, verwenden Sie NICHT das webbasierte Skript. Es wird wahrscheinlich in zukünftigen Moodle-Version nicht mehr mit ausgeliefert.
• Ab Moodle 2.9 kann der Cron-Job standardmäßig nicht mehr über den Browser gestartet werden. Wenn Sie es doch versuchen, erhalten Sie eine Fehlermeldung:

Der Internetzugriff für diese Seite wurde deaktiviert. bzw. !!! Sorry, internet access to this page has been disabled by the administrator. !!!

• Sie können diese Einstellung auf der Seite Einstellungen > Website-Administration > Sicherheit > Website-Rechte ändern, indem Sie das Häkchen bei Cron nur über die Befehlszeile ausführen entfernen.
  • Warnung: Das Ausführen des Cron-Skripts über den Browser kann sensible Daten für Unbefugte anzeigen. Deshalb wird empfohlen, nur das CLI-Cron-Skript oder das webbasierte Cron-Skript mit Passwortschutz zu verwenden.
  • Das Passwort können Sie auf derselben Seite in der Einstellung Kennwort für cron eintragen. Wenn Sie das Feld leer lassen, dann läuft das webbasierte Cron-Skript ohne Passwortschutz.
  • Der Aufruf des webbasierten Cron-Skripts mit Passwortschutz lautet:

http://Ihre.Moodle.Site/admin/cron.php?password=IhrPasswort

Den richtigen Platz auf dem Server finden

Dieser Platz hängt ganz wesentlich von Ihrem System ab. Lesen Sie die Dokumentation für Ihre Plattform oder von Ihrem Hosting-Provider. In den meisten Fällen müssen Sie das richtige Kommando (siehe vorheriger Abschnitt) in eine Datei eintragen - entweder über eine ggeignete Benutzerschnittstelle oder durch direktes Editieren dieser Datei.

Wenn Sie das CLI-Skript verwenden, dann müssen Sie außerdem sicherstellen, dass es vom richtigen Nutzer (des Servers) ausgeführt wird. Diese Einschränkung gilt nicht, wenn Sie das webbasierte Skript verwenden.

Beispiel: Einrichten des Cron-Prozesses unter Ubuntu/Debian Linux, angemeldet als Nutzer root:

• Verwende das crontab-Kommando, um den Crontab-Editor für den Nutzer www-data zu öffnen (das ist der Apache Webservernutzer auf Debian-basierten Systemen):

   $ crontab -u www-data -e

• Ergänzen Sie im Crontab-Editor folgende Zeile, um das CLI-Skript alle 15 Minuten auszuführen:

   */1 * * * * /usr/bin/php  /path/to/moodle/admin/cli/cron.php >/dev/null

Hinweis: Der Eintrag >/dev/null am Ende der Zeile sendet alle Ausgaben des Skripts an "bin" und und verhindert, dass Sie jede Minute eine E-Mail erhalten.

Den Cron-Job auf Ihrem System einrichten

Wählen Sie die passende Information für Ihren Server (englisch):

• Cron unter Unix/Linux
• Cron unter Windows
• Cron unter Mac OS X
• Cron unter Webhosting
• Cron unter 1and1 Server

Cron-Dienste von Drittanbietern

Neben der Verwendung von cron auf Ihrem eigenen Server gehostet wird, können SieCron-Dienste (in der Regel als Webcron) von Drittanbieterbn nutzen:

• cron-job.org ist ein kostenloser Service mit deutscher Webseite, der auch minütlich funktioniert.
• EasyCron - Ein Webcron Dienstleister, der die Notwendigkeit von crontab oder andere Aufgabenplaner, um cron-Job eingestellt beseitigt.

Cron-Einstellungen in Moodle

Als Administrator/in können Sie auf der Seite Einstellungen > Website-Administration > Sicherheit > Website-Rechte verschiedene Einstellungen für den Cron-Prozess vornehmen.

Remote Cron

Wenn Sie das webbasierte Cron-Skript verwenden, können Sie den Moodle-Cron-Job von einem beliebigen anderen Server aus steuern.

Planung der einzelnen Cron-Jobs

Als Administrator/in können Sie auf der Seite Einstellungen > Website-Administration > Server > Geplante Vorgänge die Ausführung der einzelnen Cron-Jobs detailliert festlegen, siehe Geplante Vorgänge.

Cron-Jobs für verschiedene Moodle-Server laufen lassen

• Die Cron-Jobs können parallel laufen. Die Prozesse verwenden "Locking". Auf diese Weise können mehrere Webserver den Cron-Job für ein und dieselbe Moodle-Instanz anstoßen.
• Wenn Sie verschiedene Moodle-Instanzen auf ein und demselben Server betreiben, dann muss für jede Instanz ein Cron-Job eingerichtet werden. Es kann sogar ein einzelner Webserver verschiedene Moodle-Instanzen in verschiedenen Domänen betreiben (über virtuelle Maschinen, siehe https://httpd.apache.org/docs/2.2/vhosts/index.html)

Fehlerbehandlung bei geplanten Vorgängen

Manchmal kann es passieren, dass eine einzelne Cron-Job-Aufgabe nicht richtig läuft. Vor Moodle 2.7. führte ein solcher Fehler dazu, dass alle nachfolgenden Cron-Job-Aufgaben nicht mehr abgearbeitet wurden. Die einzige Möglichkeit festzustellen, obb der Cron-Job vollständdig und erfolgreich durchgelaufen ist, war eine automatisierte Prüfung der Cron-Job-Ausgabe (z.B. die Suche nach der Ausgabe "Cron completed at").

Ab Moodle 2.7. beeinflusst ein Fehler bei der Abarbeitung einer Cron-Job-Aufgabe nicht die erfolgreiche Bearbeitung der anderen Aufgaben. Wenn ein Fehler auftritt, wird dieser Fehler markiert und eine Wiederholung der Bearbeitung angesetzt.

Auf der Seite Geplante Vorgänge finden Sie eine Übersicht, welche Cron-Job-Aufgaben aktuell als fehlerhaft markiert sind: Bei diesen Aufgaben steht in der Spalte Fehlerverzögerung eine von Null verschiedene Zahl (diese Zahl gibt an, wie viele Sekunden bis zur nächsten Ausführung verbleiben). Fehlerhafte Cron-Job-Aufgaben können Sie direkt von der Kommandozeile aufrufen und prüfen, welche konkreten Fehlermeldungen die Ausgabe dann liefert

Siehe auch

• Geplante Vorgänge
• Wikipedia-Artikel über Cron
• MDL-50694

Diskussionsbeiträge im Kurs Using Moodle auf moodle.org:

• How to log the output of a Scheduled Task on Windows