TEHCC Wiki:Maintenance

Maintenance notes:

System Maintenance

• Update MediaWiki
  • Patch - Available for point releases. Details on the MediaWiki site
    1. Download patch from the dumps site
    2. cd to cd ~/public_html/clubwiki/ directory (the one with LocalSettings.php).
    3. Download (wget) the patch file from the dumps site and gunzip it gunzip mediawiki stable release number.patch.gz.
    4. Use patch -p1 --dry-run to check what will be changed (e.g., patch -p1 --dry-run -i mediawiki stable release number.patch)
    5. If all is well, run patch again without --dry-run.
    6. Check Special:Version and you should see the new version number in place.
    7. Delete patch files rm mediawiki stable release number.patch*

• Upgrade/Reinstall - use to upgrade across major versions or to reinstall a borked install
  1. Download desired version MediaWiki Site using wget to the home directory
  2. Unpack using tar -xvzf (e.g., tar -xvzf mediawiki stable release number.tar.gz)
  3. Delete zipped tarball (e.g., rm mediawiki stable release number.tar.gz)
  4. Move the existing installation to a temporary backup folder mv ~/public_html/clubwiki/ ~/public_html/OLD.yyyymmdd.clubwiki
  5. Move the new installation to the public folder mv ~/mediawiki stable release number ~/public_html/clubwiki
  6. Copy Localsettings.php (to be detailed later)
  7. Copy Images folder (to be detailed later)
  8. Install extensions/handlers (to be detailed later)
  • 1. Composer
    2. Semantic mediawiki
    3. NumberFormat
    4. Maps
    5. Page Forms
    6. Semantic result formats
  1. Run Mediawiki upgrade or command line update
  2. Done!

• Update extensions
  • Composer based (Semantics, others?)
    1. cd to cd ~/public_html/clubwiki/ directory (the one with LocalSettings.php).
    2. Update composer /usr/php/56/bin/php composer.phar self-update
    3. Update using composer /usr/php/56/bin/php composer.phar update
  • Manual extensions - Go to Special:Version and compare what's shown on extension page
    • NumberFormat - Download needed updates and extract into the extension directory tar -xzf extension.tar.gz -C public_html/clubwiki/extensions/

      Note: Special:Version currently shows v0.8.0, but site shows v0.8.1, updating doesn't increment.

  • Remaining extensions are part of MediaWiki and upgraded with it

• Update completion - run maintenance routine from cd ~/public_html/clubwiki/ directory: /usr/php/56/bin/php maintenance/update.php

Site Maintenance

• Cleanup after a spam/vandalism battle
  1. cd to cd ~/public_html/clubwiki/ directory (the one with LocalSettings.php)
  2. Delete archived revisions (deleted page revisions) /usr/php/56/bin/php maintenance/deleteArchivedRevisions.php for dry run, then execute /usr/php/56/bin/php maintenance/deleteArchivedRevisions.php --delete
  3. Delete users older than 7 days with no edits /usr/php/56/bin/php maintenance/removeUnusedAccounts.php --ignore-touched 7 for dry run, then execute /usr/php/56/bin/php maintenance/removeUnusedAccounts.php --ignore-touched 7 --delete