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 this line to enable search robots on article pages:

   $wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );

   ==>

   #$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );

   • Comment out Google analytics in rally360 skin. (Leave its variables alone.)

In /{newWiki}

1. Edit LocalSettings.php:

   • $wgScriptPath = "/{newWiki}"
   • $wgArticlePath = "/{newWiki}/$1"
   • Uncomment this line to disable search robots on article pages:

   #$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );

   ==>

   $wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );

   • Uncomment Google analytics in rally360 skin. (Leave its variables alone.)

In /apache_config:

1. Edit mediawiki.conf_new
2. 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
4. In FileZilla
   • Upload {newWiki}/LocalSettings.php
   • Upload {retiredWiki}/LocalSettings.php

5. In PuTTY or the SSH shell, load the new settings:
   • pushd /usr/share/mediawiki/apache_conf
   • ./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}