• stc.org
• STC-On
• STC Forum
• STC World Search

Search

From StcWiki

[edit] Overview

First thing you should have in place is a local working directory where all STC-Online is under Subversion; if you don't, stop right now and contact Lou Quillio to see where you stand because you can't do any upgrades without working under Subversion. Since it's possible future admins may be using Windows or Mac, we'll try and cover the steps for both instances.

Except for the Subversion related parts, these instructions are largely based on the suggested MediaWiki upgrade protocols, Upgrading MediWiki. You should at least look them over and get an idea of what's going on. Always direct your attention to information about the specific version you're upgrading to.

Finally, before we begin, if any of the wiki's source files or stock templates have been modified, then these modifications may need to be recreated after the upgrade, but hopefully not as such changes should be preserved when under version control.

[edit] Process

Upgrade Process (based on going from 1.5.3 to 1.6.5)

1. Important backup step I: Make a copy of all the wiki server files to a local directory for safe keeping (be sure to copy the files, not move them). Name the folder as version-xxx-old, where "xxx" is the major, minor, and patchlevel number of the version your updating from (e.g., 1.5.3).
2. Important backup step II: Make a MySQL database dump of the wiki database tables; name the file as

   db-backup-xxx.sql

   , where again the "xxx" matches the version number you're updating from (e.g., 1.5.3). Add this file to your local backup directory for safe keeping.
3. Download the latest MediaWiki stable release from SourceForge > MediaWiki. Unpack the new wiki package into an out-of-the-way location--not in the working directory under subversion! (This will be a temporary directory you can delete later.)
4. Important svn step I: (The Subversion process is actually four steps: Update, Add, Commit, Transfer. This is the first step.) Update your local working directory that's under Subversion.
5. Copy the complete set of new wiki files over the old ones in the working directory under Subversion.
6. Ensure that the

   AdminSettings.php

   file exists and is up to date with the existing wiki's database account information.
7. Important svn step II: Look at all the folders and files in the "wiki" directory to ensure they are under subversion. If any file or folder is not, use Subversion's Add function to add them into Subversion (this will mark the file/folder with a blue cross).
8. Important svn step III: Run a Subversion svn Commit on the "wiki" directory. Be sure to add a comment like "Updating MediaWiki to version x.x.x." to register the change in Subversion. This svn Commit process will take a few moments.

(--Destry 00:19, 28 July 2007 (UTC): Some steps still need added here but wiki is having a fit, I'll come back to it.)