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         importImages.php
  55         Imports images into the wiki
  56
  57         importTextFile.php
  58         Imports the contents of a text file into a wiki page
  59
  60         nukePage.php
  61         Wipe a page and all revisions from the database
  62
  63         reassignEdits.php
  64         Reassign edits from one user to another
  65
  66         rebuildImages.php
  67         Update image metadata records
  68
  69         rebuildMessages.php
  70         Update the MediaWiki namespace after changing site language
  71
  72         rebuildtextindex.php
  73         Rebuild the fulltext search indices
  74
  75         refreshLinks.php
  76         Rebuild the link tables
  77
  78         removeUnusedAccounts.php
  79         Remove user accounts which have made no edits
  80
  81         runJobs.php
  82         Immediately complete all jobs in the job queue
  83
  84         update.php
  85         Check and upgrade the database schema to the current version