maintenance/README

   1 == MediaWiki Maintenance ==
   2
   3 The .sql scripts in this directory are not intended to be run standalone,
   4 although this is appropriate in some cases, e.g. manual creation of blank tables
   5 prior to an import.
   6
   7 Most of the PHP scripts need to be run from the command line. Prior to doing so,
   8 ensure that the LocalSettings.php file in the directory above points to the
   9 proper installation.
  10
  11 Certain scripts will require elevated access to the database. In order to
  12 provide this, first create a MySQL user with "all" permissions on the wiki
  13 database, and then place their username and password in an AdminSettings.php
  14 file in the directory above. See AdminSettings.sample for specifics on this.
  15
  16 === Brief explanation of files ===
  17
  18 A lot of the files in this directory are PHP scripts used to perform various
  19 maintenance tasks on the wiki database, e.g. rebuilding link tables, updating
  20 the search indices, etc. The files in the "archives" directory are used to
  21 upgrade the database schema when updating the software. Some schema definitions
  22 for alternative (as yet unsupported) database management systems are stored
  23 here too.
  24
  25 The "storage" directory contains scripts and resources useful for working with
  26 external storage clusters, and are not likely to be particularly useful to the
  27 vast majority of installations. This directory does contain the compressOld
  28 scripts, however, which can be useful for compacting old data.
  29
  30 === Maintenance scripts ===
  31
  32 As noted above, these should be run from the command line. Not all scripts are
  33 listed, as some are Wikimedia-specific, and some are not applicable to most
  34 installations.
  35
  36         changePassword.php
  37         Reset the password of a specified user
  38
  39         cleanupSpam.php
  40         Mass-revert insertion of linkspam
  41
  42         deleteOldRevisions.php
  43         Erase old revisions of pages from the database
  44
  45         dumpBackup.php
  46         Backup dump script
  47
  48         dumpHTML.php
  49         Produce an HTML dump of a wiki
  50
  51         importDump.php
  52         XML dump importer
  53
  54         importTextFile.php
  55         Imports the contents of a text file into a wiki page
  56
  57         nukePage.php
  58         Wipe a page and all revisions from the database
  59
  60         reassignEdits.php
  61         Reassign edits from one user to another
  62
  63         rebuildImages.php
  64         Update image metadata records
  65
  66         rebuildMessages.php
  67         Update the MediaWiki namespace after changing site language
  68
  69         rebuildtextindex.php
  70         Rebuild the fulltext search indices
  71
  72         refreshLinks.php
  73         Rebuild the link tables
  74
  75         removeUnusedAccounts.php
  76         Remove user accounts which have made no edits
  77
  78         runJobs.php
  79         Immediately complete all jobs in the job queue
  80
  81         update.php
  82         Check and upgrade the database schema to the current version