From Gentoo Wiki
Jump to:navigation Jump to:search


  • Use wikitest site as staging area.
  • Update PHP to latest stable release.
  • Update base to MediaWiki 1.30.1.

Update 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 and move it to the new database cluster.
  4. Backup current htdocs, copy wiki images to wikitest, then copy wikitest htdocs to wiki.
  5. Bring puppet and wiki repositories up to latest revisions.
  6. Update plugins via composer:
    • Run composer update --no-dev
    • Run php maintenance/update.php to update the schema
  7. Manual plugin updates:
  8. When satisfied, release read-only or do a rollback.

Post update checklist

Upon success update:

  1. Reevaluate Login and Notifications on small screens (bug #615260).
  2. Flow extension seems fragile.
    • Evaluate if Flow can be enabled on more pages after experimenting more with Flow extension updates.
    • Flow has a nasty habit of hard-encoding the wiki id (which defaults to "DBSchema-DBPrefix") into its data. This means changes to the schema name or prefix is not possible if Flow data is to be preserved.
  3. Merge wiki accounts that have been on the todo list. - Done! (Brian Evans (grknight) )

Rollback checklist

In the event of issues with the update, 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 infra-status site with details.
  6. Resume edits.