Service/wiki

Hostnames

• wiki.sugarlabs.org
• wiki-devel.sugarlabs.org
• wiki-testing.sugarlabs.org
• pe.sugarlabs.org
• cl.sugarlabs.org
• co.sugarlabs.org
• ar.sugarlabs.org

Hosted on

Machine/sunjammer

Administrative contact

<webmaster at sugarlabs.org>

Sysadmins

• Wiki Team/Contacts for wiki content and access
• Bernie Innocenti for host issues
• Sebastian Silva for issues with local labs

Wiki instances

The main wiki lives here:

/srv/www-sugarlabs/wiki/ 

Except for trivial changes, work on the wiki should be carried on in the wiki-devel instance, then moved to wiki-testing for feedback before putting it into the production instance.

Note: The devel and testing wikis share the same page database, but have separate server configurations.

Sometimes the devel and testing instances contain interim work performed by various wiki helpers. Do not sync changes blindly to the production wiki!

Before overwriting the page database, please

• observe http://wiki-devel.sugarlabs.org/go/Category:Under_construction
• announce the plan on systems@ and to any collaborators who have signed their 'Under construction' pages in the template (such as by using the 'E-mail this user' link in the sidebar for the wiki user's page, even when it is a red link or not yet created).

Creating a Local Labs wiki

• Add a group for the wiki (vigr)

cd /srv/www-sugarlabs
cp -a co.sugarlabs.org pe.sugarlabs.org
chown -R icarito:sugarwiki-pe pe.sugarlabs.org
cd pe.sugarlabs.org/wiki
rm -r images/*
vim LocalSettings.php
vim SecretSettings.php

• Create apache virtual host:

 cp -a /etc/apache2/sites-available/pe.sugarlabs.org /etc/apache2/sites-available/ar.sugarlabs.org
 vim /etc/apache2/sites-available/ar.sugarlabs.org
 a2ensite ar.sugarlabs.org

• Create DB with some clever trick. I reused config/index.php to setup a new MediaWiki instance and then I've thrown away the generated LocalConfig.php:

 mv LocalConfig.php LocalConfig.good
 cp -a /srv/www-sugarlabs/co.sugarlabs.org/config .
 (go to http://ar.sugarlabs.org/wiki/config/index.php)
 rm -r config LocalConfig.php
 mv LocalConfig.good LocalConfig.php

• Create tables for OpenID:

mysql -u root -p pe_sugarlabswiki < extensions/OpenID/openid_table.sql

Upgrade notes

Our Mediawiki instances are installed from Subversion. We update them by simply switching to a different stable branch.

Because the "extensions" directory comes from a different repository, we need to take care not to confuse Subversion's little mind when it sees it. Hence, we keep around a copy of the original extensions directory from the main repository.

mv extensions extensions.keep
mv extensions.orig extensions
svn switch http://svn.wikimedia.org/svnroot/mediawiki/branches/REL1_16/phase3
mv extensions extensions.orig
mv extensions.new extensions
cd extensions
svn switch http://svn.wikimedia.org/svnroot/mediawiki/branches/REL1_16/extensions
cd ..

Now run update scripts:

cd maintenance
php update.php

If the SemanticMediaWiki extension is enabled (we don't use it), also refresh its tables:

cd extensions/SemanticMediaWiki/maintenance
php SMW_setup.php