Editing User:Ashley/Wiki upgrade plan Q2 2014

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

wiki.maemo.org upgrade plan — ETA: Q2 2014 (likely early May/June)

old notes from 13 May 2013:
<pre><nowiki>
16:20:33 <ashley> also, could someone explain to me just how garage/wiki are "married" to each other? where is the "master" user data? I was thinking of writing an AuthPlugin < http://www.mediawiki.org/wiki/AuthPlugin > to handle the wiki logins since MediaWiki does not natively and will not support lowercase user names and hacking MW core to make it "support" such a thing is ugly and very error-prone and causes a lot of issues
16:21:44 <DocScrutinizer05> I'm  not sure wiki and garage are linked in any way
16:22:23 <merlin1991> wiki accounts are sepperated from garage accounts
16:23:43 <ashley> wiki's [[Special:UserLogin]] page allows only to log in, there isn't a "create an account" link; manually trying to access [[Special:UserLogin/signup]] informs you that the requested action is restricted to administrators; when I created my garage account, I was able to log in to the wiki with that account
[...]
16:54:52 <Woody14619> My understanding is that wiki got its auth from Midgard, which gets updated from garage (or used to anyway)
</nowiki></pre>

What are these in the server's root directory and do we need 'em?

* <code>etc_wiki_20130507.tar.gz</code>
* <code>etc_wiki_20130513_to_check.tar.gz</code>
* <code>etc_wiki_20130515.tar.gz</code>

Configuration files are in <code>/etc/mediawiki</code>.

<code>/etc/mediawiki-extensions</code> contains
* <code>extensions-available</code> — symlinks
* <code>extensions-enabled</code> — empty folder
* <code>extensions.php</code> — Debian-specific junk which includes ExtensionFunctions.php (yuck) and all the extensions in <code>/etc/mediawiki-extensions/extensions-enabled</code>

Apache is in <code>/etc/apache2</code>

Actual MediaWiki sources are in <code>/var/lib/mediawiki/</code> — lots of symlinks there, btw.

<code>/var/lib/mediawiki/</code>
* <code>config/</code> — getting a "permission denied" here; TODO figure out what this is and if it's needed
* <code>extensions/</code> — mostly symlinks but a couple real dirs, too
* <code>images/</code> — all files uploaded to the wiki via [[Special:Upload]]
* <code>skins/</code> — symlink to <code>/usr/share/mediawiki/skins</code>
* <code>apc.php</code> — lines 41-42 are giving me the heebie-jeebies

Get rid of the useless 'wikiadmin' and 'nokiaeditors' groups:
<pre><nowiki>
DELETE FROM user_groups WHERE ug_group IN ('wikiadmin', 'nokiaeditors');
</nowiki></pre>

Migrate user preferences from old skin name to new skin name ('''after''' the upgrade!):
<pre><nowiki>
UPDATE user_properties SET up_value = 'maemo' WHERE up_property = 'skin' AND up_value = 'monobookmaemo2009';
</nowiki></pre>

<code>$wgLogo</code> points to a nonexistent image (plus it's using <code>$IP</code> which it shouldn't be since <code>$IP</code> is a filesystem path).

== The master plan ==
'''THIS IS NOT COMPLETE YET, I'M JUST PLANNING IT!'''
# Backup everything. If necessary, ask sysops to take a snapshot of the machine (probably would make sense to set the wiki to read-only mode via <code>$wgReadOnly</code> *before* doing that, though); it'd be a safe bet if we have enough time & resources for that. Otherwise a backup of the database & images will have to do.
# Download latest stable version of MediaWiki from [[mediawikiwiki:Download|MeidaWiki.org]] into a '''sane, self-contained''' directory, such as <code>/var/www/wiki</code>
## Put new skin files into <code>/var/www/wiki/skins/Maemo</code>
### TODO: Where should the master version of this skin be hosted? Currently I think it's hosted on [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/maemo2midgard/mediawiki/skins/MonoBookMaemo2009.php?view=markup garage.maemo.org], but I wouldn't mind moving it to the official MediaWiki git repository, git.wikimedia.org
## Download any and all necessary extensions into <code>/var/www/wiki/extensions</code> from git.wikimedia.org
### Need my updated version of the GForgeAuthentication extension, which pulls user data from garage.maemo.org; this means also that the new configuration variable <code>$wgGForgeAuthenticationConfiguration</code> has to be defined in LocalSettigs.php.
### Can we publish the source of the new version of GForgeAuthentication? (Old version contains hard-coded passwords, so it's a no-go.)
## Copy old LocalSettings.php over to <code>/var/www/wiki</code> and edit them accordingly (see previous note about GForgeAuthentication etc.)
# Move images over from <code>/var/lib/mediawiki/images/</code> into <code>/var/www/wiki/images/</code>
# Run <code>/var/www/wiki/maintenance/update.php</code> to perform any and all database upgrades
# Test that nothing's blown up...
# ???
# PROFIT!

==Open questions==
# What kind of Apache changes are needed? '''BONUS:''' Would like to fix the "plus sign bug" which prevents accessing pages like [[PEAP+MSCHAPv2 WiFi authentication setup]] directly.
# Service interruption — how much downtime will there be?
# If something goes totally kaboom, how easy/hard will it be to restore from a backup?
# Lowercase wiki user names — do we '''really''' need to deal with these or can we just force them to be uppercase (because MW does not support lowercase user names without ugly core hacks)?
## Apparently the canonical form of my name is in lowercase, so it'll be easy for me to test it out. In the worst case I can hack up a maintenance script that changes all initial lowercase names (in MediaWiki's <code>user</code> table) to an initial uppercase (which is standard MW convention). GForgeAuthentication seems to be (correctly) enforcing uppercase in its <code>getCanonicalName</code> function

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "http://wiki.maemo.org/User:Ashley/Wiki_upgrade_plan_Q2_2014"

Personal tools

Navigation

Views

Editing User:Ashley/Wiki upgrade plan Q2 2014

@@ Line 50: / Line 50: @@
 '''THIS IS NOT COMPLETE YET, I'M JUST PLANNING IT!'''
 # Backup everything. If necessary, ask sysops to take a snapshot of the machine (probably would make sense to set the wiki to read-only mode via <code>$wgReadOnly</code> *before* doing that, though); it'd be a safe bet if we have enough time & resources for that. Otherwise a backup of the database & images will have to do.
-# Download latest stable version of MediaWiki from [[mediawikiwiki:Download|MediaWiki.org]] into a '''sane, self-contained''' directory, such as <code>/var/www/wiki</code>
+# Download latest stable version of MediaWiki from [[mediawikiwiki:Download|MeidaWiki.org]] into a '''sane, self-contained''' directory, such as <code>/var/www/wiki</code>
 ## Put new skin files into <code>/var/www/wiki/skins/Maemo</code>
 ### TODO: Where should the master version of this skin be hosted? Currently I think it's hosted on [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/maemo2midgard/mediawiki/skins/MonoBookMaemo2009.php?view=markup garage.maemo.org], but I wouldn't mind moving it to the official MediaWiki git repository, git.wikimedia.org