AgileApps Support Wiki Pre Release

Difference between revisions of "User:Aeric/Old Steps for a New Release"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Β 
(6 intermediate revisions by the same user not shown)
Line 4: Line 4:
#:* <tt>$wgScriptPath = "/{retiredWiki}"</tt>
#:* <tt>$wgScriptPath = "/{retiredWiki}"</tt>
#:* <tt>$wgArticlePath = "/{retiredWiki}/$1"</tt>
#:* <tt>$wgArticlePath = "/{retiredWiki}/$1"</tt>
#:* Comment out Google analytics in LJ skin. (Leave its variables alone.)
#:* Comment out this line to enable search robots on article pages:
# Rename <tt>robots.txt_ALLOW</tt> to <tt>robots.txt</tt> to disable robots.
#::: <tt>$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );</tt>
#:: ==>
#::: <tt>#$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );</tt>
#:* Comment out Google analytics in rally360 skin. (Leave its variables alone.)


In <tt>/{newWiki}</tt>
In <tt>/{newWiki}</tt>
Line 11: Line 14:
#:* <tt>$wgScriptPath = "/{newWiki}"</tt>
#:* <tt>$wgScriptPath = "/{newWiki}"</tt>
#:* <tt>$wgArticlePath = "/{newWiki}/$1"</tt>
#:* <tt>$wgArticlePath = "/{newWiki}/$1"</tt>
#:* Uncomment Google analytics in LJ skin. (Leave its variables alone.)
#:* Uncomment this line to disable search robots on article pages:
# Rename <tt>robots.txt</tt> to <tt>robots.txt_ALLOW</tt> to enable search robots.
#::: <tt>#$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );</tt>
#:: ==>
#::: <tt>$wgNamespaceRobotPolicies = array( NS_MAIN => 'index,follow' );</tt>
#:
#:* Uncomment Google analytics in rally360 skin. (Leave its variables alone.)


#In <tt>/apache_config</tt>:
In <tt>/apache_config</tt>:
# Edit <tt>mediawiki.conf_new</tt>
# Edit <tt>mediawiki.conf_new</tt>
# Change the "wiki" alias to point to the new release:
# Change the "wiki" alias to point to the new release:
Line 34: Line 41:
#:
#:
# Upload <tt>mediawiki.conf_new</tt>
# Upload <tt>mediawiki.conf_new</tt>
# In FileZilla
#* Upload <tt>{newWiki}/LocalSettings.php</tt>
#* Upload <tt>{retiredWiki}/LocalSettings.php</tt>
#:
#In PuTTY or the SSH shell, load the new settings:
#* <tt>pushd /usr/share/mediawiki/apache_conf</tt>
#* <tt>./try</tt>
#: The script does a restart. Ignore the error that says
#::"Could not reliably determine the server's fully qualified domain name".


In FileZilla, <tt>{newWiki}</tt>
Finally, [[User:Aeric/Test|Test the Wiki]]
# Upload <tt>LocalSettings.php</tt>
# Delete <tt>robots.txt</tt>
# Upload <tt>robots.txt_ALLOW</tt> to enable search robots.
Β 
In FileZilla, <tt>{retiredWiki}/</tt>
# Upload <tt>LocalSettings.php</tt>
# Delete <tt>robots.txt_ALLOW</tt>
# Upload<tt>robots.txt</tt> to disable robots.
Β 
In PuTTY or the SSH shell, load the new settings:
# <tt>pushd /usr/share/mediawiki/apache_conf</tt>
# <tt>./try</tt>
Β 
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:
# Go to the wiki without specifying a destination page
#* Ensure that the home page is displayed
# 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 <tt>./revert</tt> 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 <tt>mediawiki.conf_new</tt>:
:<tt>cp mediawiki.conf_new mediawiki.conf_{year}_{month}

Latest revision as of 22:46, 4 September 2013

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".

Finally, Test the Wiki