Manual:RunJobs.php/de-formal

This page is a translated version of the page Manual:RunJobs.php and the translation is 22% complete.
Outdated translations are marked like this.

Die Datei runJobs.php ist ein Wartungsskript, mit dem man die Abarbeitung der Warteschlange manuell forcieren kann. Normalerweise werden Jobs in der Warteschlange in Abhängigkeit von der Benutzerinteraktion mit dem Wiki ausgeführt (normale Apache-Anfragen) Standardmäßig ist die Ausführungsrate für Jobs 1:1. Diese Rate kann durch Anpassung von $wgJobRunRate in der Datei LocalSettings.php geändert werden. Beachten Sie, dass die Standardspeichergrenze für einen Job 150 MB beträgt, damit ein fehlerhafter Job nicht den gesamten Speicher des Servers beansprucht.

Möglicherweise brauchen Sie diese Funktion, wenn es zu wenig Datenverkehr in Ihrem Wiki gibt, um die Warteschlange abzuarbeiten oder wenn eine außergewöhnlich große Anzahl von Jobs abzuarbeiten ist. Beachten Sie jedoch, dass dies bei vielen Serverkonfigurationen dazu führen kann, dass Ihr Wiki schleppend oder gar nicht mehr reagiert, bis das Skript abgeschlossen ist. Es wird empfohlen, zuerst 50 oder 100 zu versuchen, um ein Gefühl für die Geschwindigkeit des Skripts zu bekommen, bevor Sie es ohne Parameter ausführen (dieses Skript arbeitet standardmäßig 10.000 Jobs bei jeder Ausführung ab) oder für mehr als ein paar hundert Jobs.

Beachten Sie auch, dass es auch möglich ist, die Job-Warteschlange vollständig zu entleeren, indem Sie die Tabelle job in Ihrer Wiki-Datenbank löschen, wenn Sie versehentlich ein Skript ausgeführt haben, das eine große Anzahl unerwünschter oder nicht benötigter Jobs in die Job-Warteschlange geladen hat Stellen Sie sicher, dass keine Jobs in der Warteschlange sind, die Sie noch brauchen, da die Warteschlange unwiederbringlich gelöscht wird.

Verwendung

php maintenance/runJobs.php

Verwendung für Fortgeschrittene

php runJobs.php [--conf|--dbpass|--dbuser|--globals|--help|--maxjobs|--maxtime|--memory-limit|--nothrottle|--procs|--quiet|--server|--type|--wait|--wiki]

Allgemeine Wartungsparameter

Option/Parameter Description
no parameters Will run all jobs currently in the queue
--help (-h) Display this help message
--quiet (-q) Whether to suppress non-error output
--conf Location of "LocalSettings.php", if not default
--wiki For specifying the wiki ID
--globals Output globals at the end of processing for debugging
--memory-limit Set a specific memory limit for the script, "max" for no limit or "default" to avoid changing it
--server The protocol and server name to use in URLs, e.g. https://en.wikipedia.org. This is sometimes necessary because server name detection may fail in command line scripts.

Script dependant parameters

Option/Parameter Description
--dbuser The DB user to use for this script
--dbpass The password to use for this script

Script specific parameters

Option/Parameter Description
--maxjobs Maximum number of jobs to run
--maxtime Maximum amount of wall-clock time (in seconds)
--procs Number of processes to use
--type Type of job to run. See $wgJobClasses for available job types.
--wait Wait for new jobs instead of exiting
--nothrottle Ignore the job throttling configuration
--result Set to "json" to print only a JSON response

Example

php maintenance/runJobs.php --maxjobs 5 --type refreshLinks
/home/flowerwiki/public_html/w/maintenance$ php runJobs.php --maxjobs 5 --type refreshLinks

2010-10-29 13:50:38 refreshLinks Daisies t=501 good
2010-10-29 13:50:38 refreshLinks Magnolias t=501 good
2010-10-29 13:50:39 refreshLinks Heirloom_Roses t=500 good
2010-10-29 13:50:39 refreshLinks Carnations t=501 good
2010-10-29 13:50:40 refreshLinks Tulips t=563 good
It is not recommended to have "runJobs.php" run indefinitely without any limits (--maxjobs, --maxtime and/or --memory-limit). Typical usage involves periodic runs with at least one of the restrictions set to prevent it from running too long in one go.

Caveats

"runJobs.php" may hang under certain circumstances if you have object caching enabled.

If this happens, create another "LocalSettings.php" file without object caching enabled:

$wgMainCacheType = CACHE_NONE;

Then run "runJobs.php" with the --conf parameter to specify the location of the new LocalSettings.php file with caching disabled.

This is, however, not recommended, since some jobs will purge objects from the object cache, which won't get purged because caching is disabled. This will result in some updates not being reflected on the wiki. Ideally, you should find the cause of the problem, usually a missing PHP extension in the php.ini of the php being run from the command line.

See also