STC Wiki Upgrades Under Subversion
From StcWiki
May 8, 2006 post on STCDev Forum by Destry (has more details than the Help post):
Background
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.
Except for the Subversion related parts, these instructions are largely based on the suggested MediaWiki upgrade protocols, Upgrading MediWiki (http://meta.wikimedia.org/wiki/Help:Upgrading_MediaWiki). 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. (I'll be documenting modifications as they occur so there will be a record of everything to follow, if needed.)
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 (http://sourceforge.net/projects/wikipedia/). 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 (e.g., "Updating MediaWiki to version x.x.x.") to register the change in Subversion. This SVN Commit process will take a few moments.
9. Important SVN step IV: Using a secure file transfer protocol application, and copy the newly commited files to the server. This will take quite a while to finish, about 2 hours.
10. Open a Secure Shell to the TextDrive server and go to the maintenance folder in the wiki directory if you don't have a secure shell client and you use WinXP I suggest using PuTTY) (http://www.chiark.greenend.org.uk/~sgtatham/putty/). Once there run the index file by typing the following at the secure shell command prompt: php index.php
11. In the same maintenance directory, run a links refresh by typing the following at the secure shell command prompt: php refreshLinks.php
12. Finally, open the wiki in a Web browser and go to Special:Version (http://stc-on.org/wiki/Special:Version) to see that the wiki is at the version expected. You might even browse around and try a few things to make sure all seems in working order.
It's at this point you would restore any wiki modifications that may exist. You would do this following steps 7 - 9 above, working locally, adding to subversion, then transferring.
