Extension:DumpsOnDemand
DumpsOnDemand Release status: stable |
|
---|---|
Implementation | Special page |
Description | Allows users to request and download database dumps on the wiki |
Author(s) | Mainframe98talk |
Latest version | 1.0.2 (2020-03-28) |
Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
MediaWiki | >=1.41.0 |
Database changes | No |
License | MIT License |
Download | Readme |
|
|
|
|
Quarterly downloads | 7 (Ranked 127th) |
Public wikis using | 5,645 (Ranked 47th) |
Translate the DumpsOnDemand extension if it is available at translatewiki.net | |
Vagrant role | dumpsondemand |
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.
Installation
edit- Download and move the extracted
DumpsOnDemand
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/DumpsOnDemand - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'DumpsOnDemand' );
- Configure as required.
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Vagrant installation:
- If using Vagrant , install with
vagrant roles enable dumpsondemand --provision
Configuration
editParameters
edit$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 thedumpsondemand-limit-exempt
right can ignore this restriction.$wgDumpsOnDemandFileBackend
- This setting specifies an ObjectFactory spec for aFileBackend
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 theFileBackend
class and specifying it in this setting.
User rights
editdumpsondemand
- 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 thedumpsondemand
right to request a new dump.dumprequestlog
- This user right allows users to view the database dump request log.
Other important notes
edit- 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
totrue
, but that is only recommended for small wikis or wikis with sufficient job running capacity.