Extension:DumpsOnDemand

MediaWiki extensions manual
OOjs UI icon advanced.svg
DumpsOnDemand
Release status: stable
DumpsOnDemandExtension.png
Implementation Special page
Description Allows users to request and download database dumps on the wiki
Author(s) Mainframe98talk
Latest version 1.0.0 (2020-03-28)
Compatibility policy release branches
MediaWiki 1.35.0+
Database changes No
License MIT License
Download
Readme
  • $wgDumpsOnDemandUseDefaultJobQueue
  • $wgDumpsOnDemandRequestLimit
  • $wgDumpsOnDemandDumpFileBackend
  • $wgDumpsOnDemandCompression
  • dumprequestlog
  • dumpsondemand
  • dumpsondemand-limit-exempt
Translate the DumpsOnDemand extension if it is available at translatewiki.net
Check usage and version matrix.
Issues Open tasks · Report a bug

The DumpsOnDemand extension allows users to request and download database dumps on the wiki. Database dumps can be downloaded from Special:RequestDump. If the user has the dumpsondemand right, they can request a new dump whenever they like. Two dumps are available: a dump containing only the current revisions, suitable for bot use and a dump containing all revisions, suitable for archiving.

DumpsOnDemand is based on the Dumps sub-extension for Wikia's WikiFactory extension.

InstallationEdit

  • Download and place the file(s) in a directory called DumpsOnDemand in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'DumpsOnDemand' );
    
  • Configure as required.
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

ConfigurationEdit

ParametersEdit

  • $wgDumpsOnDemandUseDefaultJobQueue - This setting will make the jobs used by DumpsOnDemand execute unconditionally. By default, none of the dump jobs are run, unless specified by the job runner. Enabling this setting is only recommended for small wikis or wikis that have sufficient job runner capacity.
  • $wgDumpsOnDemandCompression - This setting configures which compression format should be used to compress the dumps. By default, DumpsOnDemand chooses an algorithm based on the available PHP extension. An invalid option will result regular dumps without compression. Supported options are:
    • gz for GZip
    • bz2 for BZip2
    • zip for Zip
  • $wgDumpsOnDemandRequestLimit - This setting configures the time between subsequent dump requests. It specifies an amount in seconds that should have passed before a new dump can be requested. Users with the dumpsondemand-limit-exempt right can ignore this restriction.
  • $wgDumpsOnDemandFileBackend - This setting specifies an ObjectFactory spec for a FileBackend instance. The provided object will be used by DumpsOnDemand to write the dumps too and read the urls from. DumpsOnDemand only provides a backend that writes to $wgUploadDirectory, but you can add your own by extending the FileBackend class and specifying it in this setting.

User rightsEdit

  • dumpsondemand - This user right allows users to request a new dump on Special:RequestDump.
  • dumpsondemand-limit-exempt - This user right allows users to ignore the time limit between dump requests. Users must still have the dumpsondemand right to request a new dump.
  • dumprequestlog - This user right allows users to view the database dump request log.

Other important notesEdit

  • DumpsOnDemand generates the dumps using the JobQueue. Given that the creation of a database dump can take a long time, DumpsOnDemand jobs are not executed along with the regular jobs by default. This can be disabled by setting $wgDumpsOnDemandUseDefaultJobQueue to true, but that is only recommended for small wikis or wikis with sufficient job running capacity.

See alsoEdit