Manual:RunJobs.php

Details
runJobs.php file is a maint-scripts>Special:MyLanguage/Manual:Maintenance scripts|maintenance script to manually force the jobqueue>Special:MyLanguage/Manual:Job queue|job queue to run. Under normal circumstances jobs in the queue are run as a function of user interaction with the wiki (ordinary apache requests). The default rate jobs are run is 1 to 1 and can be changed by adjusting  in  file.

You may wish to use this script because your wiki's traffic is too slow to clear the queue, or there may be an exceptionally large number of jobs to clear. Be advised though that for many server configurations this can cause your wiki to become sluggish or even unresponsive until the script completes. You would be advised to first try 50 or 100 to get a feel for the script's speed before running it with no parameters (this script defaults to 10,000 jobs cleared each time it is run) or for more than a few hundred jobs.

Note also that if you accidentally ran a script that loaded the job queue with a large number of undesired or unneeded jobs it is also possible to completely clear the job queue by clearing the jobtable>Special:MyLanguage/Manual:Job table|job table in your wiki database. Be certain there are no jobs in the queue you need as all jobs will be irretrievably deleted.

Usage
 php maintenance/runJobs.php

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

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   run indefinitely without any limits ( ,  </> and/or <tvar|code3> </>). 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_DB;

Then run "runJobs.php" with the <tvar|code> </> parameter to specify the location of the new <tvar|LocalSettings> </> file with caching disabled.