User:Aeric/Old Steps for a New Release

Setup: On Local System

In /{retiredWiki}

1. Edit LocalSettings.php:

   • $wgScriptPath = "/{retiredWiki}"
   • $wgArticlePath = "/{retiredWiki}/$1"
   • Comment out Google analytics in LJ skin. (Leave its variables alone.)

2. Rename robots.txt_ALLOW to robots.txt to disable robots.

In /{newWiki}

1. Edit LocalSettings.php:

   • $wgScriptPath = "/{newWiki}"
   • $wgArticlePath = "/{newWiki}/$1"
   • Uncomment Google analytics in LJ skin. (Leave its variables alone.)

2. Rename robots.txt to robots.txt_ALLOW to enable search robots.

1. In /apache_config:
2. Edit mediawiki.conf_new
3. Change the "wiki" alias to point to the new release:

   Alias /wiki /user/share/mediawiki/{newWiki}

Setup: On the Server

1. Start VPN
2. Login as root using PuTTY or SSHshell

Deploy

Do these steps as close to simultaneously as possible:

In FileZilla, apache_config

1. Get the current configuration file, just in case someone else modified it

   ./get_conf

2. Save the current settings:

   cp mediawiki.conf mediawiki.conf_sav

3. Upload mediawiki.conf_new

In FileZilla, {newWiki}

1. Upload LocalSettings.php
2. Delete robots.txt
3. Upload robots.txt_ALLOW to enable search robots.

In FileZilla, {retiredWiki}/

1. Upload LocalSettings.php
2. Delete robots.txt_ALLOW
3. Uploadrobots.txt to disable robots.

In PuTTY or the SSH shell, load the new settings:

1. pushd /usr/share/mediawiki/apache_conf
2. ./try

The script does a restart. Ignore the error that says "Could not reliably determine the server's fully qualified domain name".

Test

Test the new wiki:

1. Go to the wiki without specifying a destination page
   • Ensure that the home page is displayed
2. Click a link
   • Ensure that the page displays
   • Ensure that the link is correct

Repeat the same steps to test the retired wiki.

If all is not well, use ./revert to restore the old Apache configuration settings. (You shouldn't need to undo changes to LocalSettings.php, but be prepared to do so, just in case.)

If all is well, make backup of mediawiki.conf_new:

cp mediawiki.conf_new mediawiki.conf_{year}_{month}