WikiIndex:Recipe for server moves

From WikiIndex
Revision as of 14:32, 20 May 2022 by MarkDilley (talk | contribs) (→‎Post move: remove outdated locations)
Jump to navigation Jump to search

WikiIndex: Recipe for server moves — this meta page here on WikiIndex was originally created to document the procedure of the WikiIndex:Server move 2014. It may also be useful for any future server moves for WikiIndex, or indeed any other wiki site. Template:TOCright

About the move

There should be few (if any) visible differences to WikiIndex once the move is complete. It is simply moving from one hosting platform to another. Here are some good steps to follow during the move.

Prior to the move

Note: The only thing that will be changed on the current server before, during, and after the move is to set it the wiki site read-only, and add a MediaWiki:Sitenotice banner during the move itself. Not mucking with the server preserves a working server that we can fail back to if something unforeseen happens.

  1. Make a complete backup of the wiki. (as of November 14, 2014 ... gzipped up without the cache the backup is 517Mb).
  2. Restore the backup at another temporary domain on the new server.
  3. Upgrade MediaWiki to the most recent version (also upgrade the extensions) on the temporary domain.
  4. Once everything is fixed and tested by the person doing the move, invite the regular contributors to come poke around on the temporary domain to make sure everything looks right and is working.
    • Use /etc/hosts to pretend like the the move is already complete and the domain points to the new server so we can test the virtual host configuration as well.
  5. Once given the thumbs up from the community the actual move will begin.

The actual move

  1. Switch the current WikiIndex wiki site into read-only mode; to ensure that the database is in a consistent state, and that no accounts or edits are created (and subsequently lost) during the move.
  2. Add a site message banner to the top of the wiki site on every page that indicates the move is in progress.
  3. Make a new complete dump of the database and images. That means a new backup will be created which contains all changes to wiki until that point in time.
  4. Restore the fresh dump at the temporary domain.
  5. Upgrade the database to the most recent schema.
  6. Switch DNS to the new new server's IP address.
  7. As DNS propagates visitors will start to go to the new server.
  8. For most people DNS will propagate within a couple of hours, and within 24 hours it will have propagated for everyone.
  9. The new server is not in read-only mode, and does not have the site banner on it telling about the move.

A move with a significant database upgrade will take around 1 hour, with the site in read-only mode and displaying the banner for most visitors for 2-3 hours. Getting a good result is prioritized over keep the read-only period short.

Burn-in

  1. Once DNS has propagated, you will see the wiki site looking and acting like it did before (no longer read-only, no longer having a site banner).
  2. Use it just like you normally would, and report any issues to the person moving the site on their talk page.
  3. Once we feel good that all is as it should be, the original server will be decommissioned. Until that time, it is available as a failsafe backup server that we can revert to (unlikely that we'll need to do that).

Post move

  1. Are automated backups working?