AgileApps Support Wiki Pre Release

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

From AgileApps Support Wiki
imported>Aeric
(Created page with "====Setup: On Local System==== # In <tt>/lj__{retired_version}__/LocalSettings.php</tt>: #:* <tt>$wgScriptPath = "/lj__{retired_version}__"</tt> #:* <tt>$wgArticlePath = "/lj__{r...")
 
imported>Aeric
Line 1: Line 1:
====Setup: On Local System====
====Setup: On Local System====
# In <tt>/lj__{retired_version}__/LocalSettings.php</tt>:
In <tt>/{retiredWiki}</tt>
#:* <tt>$wgScriptPath = "/lj__{retired_version}__"</tt>
# Edit <tt>LocalSettings.php</tt>:
#:* <tt>$wgArticlePath = "/lj__{retired_version}__/$1"</tt>
#:* <tt>$wgScriptPath = "/{retiredWiki}"</tt>
#:* <tt>$wgArticlePath = "/{retiredWiki}/$1"</tt>
#:* Comment out Google analytics in LJ skin. (Leave its variables alone.)
#:* Comment out Google analytics in LJ skin. (Leave its variables alone.)
# Rename <tt>robots.txt_ALLOW</tt> to <tt>robots.txt</tt> to disable robots.
# Rename <tt>robots.txt_ALLOW</tt> to <tt>robots.txt</tt> to disable robots.


#In <tt>/lj__{now_curent_version}__/LocalSettings.php</tt>:
In <tt>/{newWiki}</tt>
#:* <tt>$wgScriptPath = "/wiki"</tt>
# Edit <tt>LocalSettings.php</tt>:
#:* <tt>$wgArticlePath = "/wiki/$1"</tt>
#:* <tt>$wgScriptPath = "/{newWiki}"</tt>
#:* <tt>$wgArticlePath = "/{newWiki}/$1"</tt>
#:* Uncomment Google analytics in LJ skin. (Leave its variables alone.)
#:* Uncomment Google analytics in LJ skin. (Leave its variables alone.)
# Rename <tt>robots.txt</tt> to <tt>robots.txt_ALLOW</tt> to enable search robots.
# Rename <tt>robots.txt</tt> to <tt>robots.txt_ALLOW</tt> to enable search robots.
#In <tt>/apache_config</tt>:
# Edit <tt>mediawiki.conf_new</tt>
# Change the "wiki" alias to point to the new release:
#:<tt>Alias /wiki /user/share/mediawiki/{newWiki}</tt>


====Setup: On the Server====
====Setup: On the Server====
# Start VPN
# Start VPN
# Login as root using PuTTY or SSHshell
# Login as root using PuTTY or SSHshell
# Edit <tt>/etc/httpd/conf.d/mediawiki.conf</tt>
#:<tt>Alias /wiki /user/share/mediawiki/lj__(now_current_version)</tt>
#: (For sanity's sake, move that line and accompanying comment so it is in front of the appropriate <tt><Directory></tt> section.)


====Deploy====
====Deploy====
Do these steps as close to simultaneously as possible:
Do these steps as close to simultaneously as possible:


# In FileZilla, <tt>lj{old_version}/</tt>
In FileZilla, <tt>apache_config</tt>
#:* Upload <tt>LocalSettings.php</tt>
# Get the current configuration file, just in case someone else modified it
#:* Rename <tt>robots.txt_ALLOW</tt> to <tt>robots.txt</tt> to disable robots.
#: <tt>./get_conf</tt>
#:
# Save the current settings:
#: <tt>cp mediawiki.conf  mediawiki.conf_sav</tt>
#:
#:
# In FileZilla, <tt>lj(new_version)</tt>
# Upload <tt>mediawiki.conf_new</tt>
#:* Upload <tt>LocalSettings.php</tt>
 
#:* Rename <tt>robots.txt</tt> to <tt>robots.txt_ALLOW</tt> to enable search robots.
In FileZilla, <tt>{newWiki}</tt>
# Upload <tt>LocalSettings.php</tt>
# Delete <tt>robots.txt</tt>  
# Upload <tt>robots.txt_ALLOW</tt> to enable search robots.


Then in the SSH shell, do an Apache cold start:
In FileZilla, <tt>{retiredWiki}/</tt>
#<tt>service httpd stop</tt>
# Upload <tt>LocalSettings.php</tt>
#: (The service has to be down for cache clearing to work properly).
# Delete <tt>robots.txt_ALLOW</tt>
#:
# Upload<tt>robots.txt</tt> to disable robots.
#<tt>htcacheclean -r -p/var/cache/mod_proxy</tt>
 
#: ''Learn more:'' http://httpd.apache.org/docs/2.2/programs/htcacheclean.html
In PuTTY or the SSH shell, load the new settings:
#:
# <tt>pushd /usr/share/mediawiki/apache_conf</tt>
#<tt>service httpd start</tt>, and ignore error
# <tt>./try</tt>
#:"Could not reliably determine the server's fully qualified domain name"
 
The script does a restart. Ignore the error that says
"Could not reliably determine the server's fully qualified domain name".


{{Note|The cold start takes negligible time, and unlike a reload or restart, there
Test the new server and the old:
is no process optimization, therefore no shortcuts--which makes "correct result"
:* If all is not well, use <tt>./revert</tt> to restore the old settings
the most probable outcome.}}
:* If all is well, make backup of <tt>mediawiki.conf_new</tt>.
:* Wait a day
:*

Revision as of 18:30, 17 October 2012

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 the new server and the old:

  • If all is not well, use ./revert to restore the old settings
  • If all is well, make backup of mediawiki.conf_new.
  • Wait a day