From Sugar Labs
< Service
Revision as of 06:42, 18 July 2015 by SAMdroid (talk | contribs) (Move parsoid to container.yml)
Jump to navigation Jump to search



Hosted on


Administrative contact

<webmaster at>

Account Creation

Local Labs contacts

  • Peru: Sebastian Silva
  • Colombia: Cristian Paul Peñaranda Rojas
  • Argentina: Gustavo Ibarra

Local labs, please confirm contacts and add links.


Wiki instances

The main wiki lives here at /srv/www-sugarlabs/wiki/

Except for trivial changes, work on the wiki should be carried on in the parallel wiki-devel instance before landing onto the production instance.

Note: The devel wiki has an outdated snapshot of the page database and its own slightly different server configuration.

Sometimes the devel instance contains interim work performed by various wiki helpers. Do not sync changes blindly to the production wiki!

Before overwriting the page database, please

  • observe
  • 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
chown -R icarito:sugarwiki-pe
rm -r images/*
vim LocalSettings.php
vim SecretSettings.php
  • Create apache virtual host:
 cp -a /etc/apache2/sites-available/ /etc/apache2/sites-available/
 vim /etc/apache2/sites-available/
  • 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/ .
 (go to
 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


Our MediaWiki instances are installed from git to allow easy rebasing of our changes on upgrades.

git clone wiki-devel
cd wiki-devel
git co -b REL1_19 remotes/origin/REL1_19
git clone extensions-all
cd extensions-all
git submodule update --init
cd ../extensions
# for each needed extensions
ln -s ../extensions-all/EXT

For the full details on this installation method, see

Visual Editor

This wiki has the VisualEditor extension.

In order to do that, we need the parsoid node js service. Since Sunjammer is running too old of a version, this service is hosted on freedom. It can be started using:

container.yml start /home/sam/parsoid -d

And is accessed at

Upgrade notes

We update our MediaWiki instances by simply pulling from the remote git repo and then switching to a different stable branch:

git pull
git co -b REL1_xx remotes/origin/REL1_xx

The "extensions-all" directory contains a bunch of git repositories stitched together with 'git submodule'. To update it:

cd extensions-all
git submodule update

Now run update script:

php maintenance/update.php

In the case of Local Labs wikis the correct command for performing the updates is:

php maintenance/update.php --conf /srv/www-sugarlabs/
(replace for the correct path for your local lab w)

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

cd extensions/SemanticMediaWiki/maintenance
php SMW_setup.php