Cron-Job: Unterschied zwischen den Versionen

Aktuelle Version vom 6. April 2013, 13:05 Uhr

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 Skript führt in verschiedenen Zeitabständen verschiedene Aufgaben aus, z.B. E-Mails-versenden, Moodle-Berichte aktualisieren, RSS-Feeds aktualisieren , Aktivitätenabschluss kennzeichnen, Forumsbeiträge veröffentlichen. Da zu verschiedenen Aufgaben verschiedene Zeitintervalle gehören, werden nicht alle Aufgaben jedes Mal ausgeführt, wenn das Cron-Skript gestartet wird.

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

Wenn der Cron-Prozess nicht richtig funktioniert, bekommen Sie eine entsprechende Meldung auf der Seite Website-Administration-Mitteilungen. Damit lässt sich der Cron-Job überprüfen.

Um das Moodle-Cron-Skript in regelmäßigen Abständen auszuführen, wird ein spezielles Programm (typischerweise cron) verwendet.

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

Das Aufsetzen eines Cron-Prozesses erfordert zwei Schritte:

Das richtige Kommando identifizieren, das ausgeführt werden muss.
Den richtigen Platz auf Ihrem Server finden, wo das Kommando eingetragen werden muss.

Das richtige Kommando identifizieren

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

CLI-Skript (CLI = command line interpreter, Kommandozeileninterpreter): Der Pfad zu diesem Skript ist /path_to_moodle/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 /path/to/moodle/admin/cli/cron.php

Webbasiertes Skript: 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.

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:

   */15 * * * * /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 alle 15 Minuten eine E-Mail erhalten.

Alternativ können Sie folgende Zeile eintragen, um das webbasierte Skript alle 15 Minuten auszuführen:

   */15 * * * * /usr/bin/wget -q -O /dev/null/ http://Ihre.Moodle.Site/admin/cron.php

Siehe auch Cron unter Windows bzw. Cron unter Mac OS X für Windows- bzw. MacOSX-Server (englische Anleitungen).

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.

Siehe auch

Wikipedia-Artikel über Cron

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

Cron - can someone give me a quick confirmation of function?
Cronjob Question
Slow cron : avoiding simultaneous cron
Visibility of cron.php
How to log the output of a Scheduled Task on Windows - this discussion explains a nice trick that can be very useful when you are experiencing problems with your Windows Scheduled Task and you need to log the output of the Scheduled Task to a log file.

@@ Zeile 1: / Zeile 1: @@
-{{Zum Übersetzen}}
+{{Installation}}
-Siehe [[:en:Cron]]
-{{Moodle installieren}}
+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 Skript führt in verschiedenen Zeitabständen verschiedene Aufgaben aus, z.B. E-Mails-versenden, Moodle-Berichte aktualisieren, RSS-Feeds aktualisieren , Aktivitätenabschluss kennzeichnen, Forumsbeiträge veröffentlichen. Da zu verschiedenen Aufgaben verschiedene Zeitintervalle gehören, werden nicht alle Aufgaben jedes Mal ausgeführt, wenn das Cron-Skript gestartet wird.
-Einige Module von Moodle prüfen regelmäßig, ob bestimmte Aufgaben ausgeführt werden müssen. Moodle überprüft z.B. ob es im Forum neue Einträge gibt, die per Email an Nutzer versandt werden müssen.
-==Cron-Job-Skript==
+'''Wichtig''': Sie müssen den Cron-Prozess unbedingt aufsetzen, andernfalls funktioniert Ihre Moodle-Site '''nicht''' richtig.
-Das Skript, das all diese Vorgänge steuert, finden Sie im Admin-Verzeichnis und heißt cron.php. Diese Datei läuft nicht von alleine. Sie müssen einen Mechanismus einrichten, der die Datei z.B. alle fünf Minuten ausführt. Dazu ist es erforderlich, dass ein "Impuls" für jedes Modul ausgelöst wird.
-Der Auslöser dieses Impulses muss nicht von dem Server erfolgen auf dem Moodle installiert ist.. Wenn Sie auf diesem Server keine Cron-Jobs ausführen können, kann dies von einem anderen Server ausgelöst oder von Ihrem PC gestartet werden. Es ist lediglich nötig, die Datei cron.php alle fünf Minuten aufzurufen.
+Wenn der Cron-Prozess nicht richtig funktioniert, bekommen Sie eine entsprechende Meldung auf der Seite '''Website-Administration-Mitteilungen'''. Damit lässt sich der Cron-Job überprüfen.
-Testen Sie zuerst, ob die Datei funktioniert. Rufen Sie sie mit Ihrem Browser auf:
+Um das Moodle-Cron-Skript in regelmäßigen Abständen auszuführen, wird ein spezielles Programm (typischerweise <code>cron</code>) verwendet.
-http://example.com/moodle/admin/cron.php
+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.
-Nehmen Sie nun einige Einstellungen vor:
-Aufruf des Skripts von der Kommandozeile
-Rufen Sie die Datei wie zuvor auf. Nehmen Sie dazu z.B. den Unix-Befehl 'wget':
- wget -q -O /dev/null http://example.com/moodle/admin/cron.php
+==Allgemeines==
+Das Aufsetzen eines Cron-Prozesses erfordert zwei Schritte:
+#Das richtige Kommando identifizieren, das ausgeführt werden muss.
+#Den richtigen Platz auf Ihrem Server finden, wo das Kommando eingetragen werden muss.
-In diesem Beispiel wird das Ergebnis abgelegt (nach /dev/null).
+===Das richtige Kommando identifizieren===
+In Moodle gibt es zwei Möglichkeiten, das Cron-Skript auszuführen:
+# CLI-Skript (CLI = command line interpreter, Kommandozeileninterpreter): Der Pfad zu diesem Skript ist ''/path_to_moodle/admin/cli/cron.php''. Dieses Skript muss von einem PHP CLI Programm auf Ihrem Server ausgeführt werden, z.B. durch folgendes Kommando:
+<code>/usr/bin/php /path/to/moodle/admin/cli/cron.php</code>
+# Webbasiertes Skript: Dieses Skript muss im Webbrowser aufgerufen werden, der Zugriff erfolgt über die URL <nowiki><code>http://Ihre.Moodle.Site/admin/cron.php</code></nowiki>. Sie können einen kommandozeilen-basierten Webbrowser verwenden (z.B. <code>wget</code>), d.h. das Kommando könnte z.B. lauten:
+<code>/usr/bin/wget http://Ihre.Moodle.Site/admin/cron.php</code>
+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 gleiche mit lynx:
+===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.
- lynx -dump http://example.com/moodle/admin/cron.php > /dev/null
+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.
-Alternativ können Sie eine separate PHP-Version nutzen, die über die Kommandozeile gesteuert wird. Der Vorteil dieser Variante ist, dass in den Log-Dateien des Web-Servers der Aufruf von cron.php nicht ständig protokolliert wird. Der Nachteil dieser Variante besteht darin, dass Sie einen Zugang zur Kommando-Zeile der PHP-Version benötigen.
+'''Beispiel''': Einrichten des Cron-Prozesses unter Ubuntu/Debian Linux, angemeldet als Nutzer <code>root</code>:
+*Verwende das crontab-Kommando, um den Crontab-Editor für den Nutzer <code>www-data</code> 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:
+    */15 * * * * /usr/bin/php  /path/to/moodle/admin/cli/cron.php >/dev/null
+:'''Hinweis''': Der Eintrag <code>>/dev/null</code> am Ende der Zeile sendet alle Ausgaben des Skripts an "bin" und und verhindert, dass Sie alle 15 Minuten eine E-Mail erhalten.
+*Alternativ können Sie folgende Zeile eintragen, um das webbasierte Skript alle 15 Minuten auszuführen:
+    */15 * * * * /usr/bin/wget -q -O /dev/null/ http://Ihre.Moodle.Site/admin/cron.php
- /opt/bin/php /web/moodle/admin/cron.php
+Siehe auch [[:en:Cron_with_Windows_OS|Cron unter Windows]] bzw. [[:en:Cron_with_MAC_OS_X|Cron unter Mac OS X]] für Windows- bzw. MacOSX-Server (englische Anleitungen).
-( Windows) C:\apache\php\php.exe C:\apache\htdocs\moodle\admin\cron.php
+==Cron-Einstellungen in Moodle==
+Als Administrator/in können Sie auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Sicherheit > [[Website-Rechte]]'' verschiedene Einstellungen für den Cron-Prozess vornehmen.
-===Manuelles Ausführen über den Administrationsbereich===
+==Remote Cron==
-[[Bild:MoodleCron.png|thumb|300px|Hinweise]]
+Wenn Sie das webbasierte Cron-Skript verwenden, können Sie den Moodle-Cron-Job von einem beliebigen anderen Server aus steuern.
-Ist das Script seit 24h nicht ausgeführt worden, so wird im Administrationsbereich der moodle-Seite darauf hingewiesen. In diesem Fall können Sie einfach dem Link folgen um den Job auszuführen.
+==Siehe auch==
+* [http://de.wikipedia.org/wiki/Cron Wikipedia-Artikel über Cron]
-===Automatische Ausführung des Skripts alle 5 Minuten===
+Diskussionsbeiträge im Kurs ''Using Moodle'' auf moodle.org:
+*[http://moodle.org/mod/forum/discuss.php?d=41827 Cron - can someone give me a quick confirmation of function?]
+*[http://moodle.org/mod/forum/discuss.php?d=97684 Cronjob Question]
+*[http://moodle.org/mod/forum/discuss.php?d=97457 Slow cron : avoiding simultaneous cron]
+*[http://moodle.org/mod/forum/discuss.php?d=117168 Visibility of cron.php]
+*[http://moodle.org/mod/forum/discuss.php?d=139263#p609060 How to log the output of a Scheduled Task on Windows] - this discussion explains a nice trick that can be very useful when you are experiencing problems with your Windows Scheduled Task and you need to log the output of the Scheduled Task to a log file.
-Bei UNIX- Systemen: Use cron. Passen Sie ihre Einstellungen für Cron- Jobs über die Komandozeile mit folgendem Befehl an "crontab -e" und fügen Sie folgende Zeile hinzu:
+[[Category:Website-Administration]]
- */5 * * * * wget -q -O /dev/null http://example.com/moodle/admin/cron.php
-Bei Windows-Systemen: Der einfachste Weg ist hier mein Programm zu benutzen, moodle-cron-for-windows.zip wodurch die Anpassungen ganz einfach sind. Sie können alternativ dazu, die in Windows enthaltene Funktion "Scheduled Tasks" benutzen.
-===Bei Web Hosting Services===
-Die Oberflächedes Web Host Services bietet Ihnen die Möglichkeit, einen Cron Job einzurichten. Z.B. Cpanel Systeme: Hier gibt es einen Button "Cron jobs". Geben Sie hier die folgenden Unix-Befehle ein.
-Kommando-Zeile von Unix nutzen
-Es gibt verschiedene Kommandozeilenprogramme, die Sie aufrufen können. Auf Ihrem Server sind vielleicht nicht alle verfügbar.
-Z.B. das Unix-Utility 'wget':
- wget -q -O /dev/null http://example.com/moodle/admin/cron.php
-In diesem Beispiel wird das Ergebnis nicht aufgewahrt (to /dev/null).
-Das gleiche unter lynx:
- lynx -dump http://example.com/moodle/admin/cron.php > /dev/null
-Alternativ können sie eine standalone version von PHP nutzen, die kompiliert in der Kommandozeile läuft. Der Vorteil liegt darin, dass der Webserver nicht unnötig beansprucht wird. Der Nachteil liegt darin, dass Sie per Kommandozeile Zugang zu PHP benötigen.
- /opt/bin/php /web/moodle/admin/cron.php
-{{Credits}} [https://docs.moodle.org/19/de/Cron-Job}}
-[[Category:Administrator]]
 [[en:Cron]]

Documentation