| Index: branches/ariel/xmldumps-backup/README.installation |
| — | — | @@ -0,0 +1,46 @@ |
| | 2 | +===Dependencies |
| | 3 | + |
| | 4 | +* Python 2.5 or greater, with the select module on an OS that supports |
| | 5 | + polling on pipes (this excludes Windows). |
| | 6 | +* PHP 2.5 or greater |
| | 7 | +* A fully functional MediaWiki installation with some data in it (depends on |
| | 8 | + mysql and a functioning webserver) |
| | 9 | +* The applications gzip, bzip2, 7zip version 4.58 or better |
| | 10 | +* Command line utilities head, tail, cat |
| | 11 | +* Build the utfnormal php module, located in svn: |
| | 12 | + This depends on swig and libicu-dev, install those. |
| | 13 | + svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/normal/ |
| | 14 | + cd normal; make |
| | 15 | + install the file php_utfnormal.so in the php extension directory (typically |
| | 16 | + something like /usr/lib/php5/20060613 or /usr/lib64/php/modules) |
| | 17 | + create the file utfnormal.ini with the contents "extension=php_utfnormal.so" |
| | 18 | + in the appropriate location (typically /etc/php5/conf.d/ or /etc/php.d) |
| | 19 | + |
| | 20 | +===Setup |
| | 21 | + |
| | 22 | +Check out the scripts from |
| | 23 | +http://svn.wikimedia.org/svnroot/mediawiki/trunk/backup/ |
| | 24 | +for trunk copies, but |
| | 25 | +http://svn.wikimedia.org/svnroot/mediawiki/branches/ariel/xmldumps-backup |
| | 26 | +for the currently running versions with parallelization and various command |
| | 27 | +line arguments: |
| | 28 | + |
| | 29 | + svn co http://svn.wikimedia.org/svnroot/mediawiki/branches/ariel/xmldumps-backup backups |
| | 30 | + |
| | 31 | +Copy the file wikidump.conf.sample to wikidump.conf and edit the values |
| | 32 | +appropriately; see the file README.config for information on the format of the |
| | 33 | +configuration file and the options specified. |
| | 34 | + |
| | 35 | +===Testing |
| | 36 | + |
| | 37 | +Test it: |
| | 38 | + |
| | 39 | +python ./worker.py name-of-db-here |
| | 40 | + |
| | 41 | +and see if it runs. If you have a web server set up which includes somewhere |
| | 42 | +underneath its document root the directory specified for the configuration |
| | 43 | +option "public", you should be able to load up the main index page for that |
| | 44 | +directory (see the configuration option "index") and see something much |
| | 45 | +like our WMF backups page (see http://dumps.wikimedia.org/backup-index.html |
| | 46 | +for an example). |
| | 47 | + |