From Gentoo Wiki
Jump to:navigation Jump to:search


  • Use wikitest.g.o site as staging area.
  • Update PHP to latest stable release.
  • Update MediaWiki base to v1.31.1.

High-level checklist

  1. Commit notification of planned downtime to infra-status site.
    • Add planned outage details under "Maintenance and outage notices" section of infra-status.
  2. Mark wiki as read-only during data migration and upgrade.
  3. Take a data snapshot of the current wiki on the database cluster. See the infrawiki's runbook for more details here.
  4. Backup current htdocs, copy wiki images to wikitest, then copy wikitest htdocs to updated.
  5. Bring puppet and wiki repositories up to latest revisions.
  6. Update plugins and extensions via composer:
    • Run composer update --no-dev
    • Run php maintenance/update.php to update the schema(s).
  7. Manual plugin updates:
    • Research updates from upstream locations.
        • Potentially upgrade Tyrian's embedded Bootstrap to latest release (v4.x).
  8. Other manual updates:
    • Update copyright year to latest year.
  9. Once satisfied, release read-only or do a rollback.

Post update checklist

Upon success update:

  1. Pending...

Rollback checklist

In the event of update issues, here are procedures to follow:

  1. Halt edits via marking thee database read-only.
  2. Move target back to old database.
  3. Move old script files back.
  4. Revert puppet changes and wiki repository checkouts.
  5. Update/modify infra-status site with details as necessary.
    • Remove notification.
  6. Unlock read-only status on wiki.