Line 8: |
Line 8: |
| * [http://wiki.sugarlabs.org wiki.sugarlabs.org] | | * [http://wiki.sugarlabs.org wiki.sugarlabs.org] |
| * [http://wiki-devel.sugarlabs.org wiki-devel.sugarlabs.org] | | * [http://wiki-devel.sugarlabs.org wiki-devel.sugarlabs.org] |
− | * [http://pe.sugarlabs.org pe.sugarlabs.org] | + | * [http://pe.sugarlabs.org pe.sugarlabs.org] - Peru Local Lab (in maintenance mode) |
− | * [http://cl.sugarlabs.org cl.sugarlabs.org]
| |
− | * [http://co.sugarlabs.org co.sugarlabs.org]
| |
− | * [http://ar.sugarlabs.org ar.sugarlabs.org]
| |
| | | |
| == Hosted on == | | == Hosted on == |
Line 28: |
Line 25: |
| == Local Labs contacts == | | == Local Labs contacts == |
| | | |
− | * Peru: [[User:Sebastian|Sebastian Silva]] | + | * Peru: [[User:Sebastian|Sebastian Silva]] (in maintenance mode) |
− | * Colombia: Cristian Paul Peñaranda Rojas
| |
− | * Argentina: Gustavo Ibarra
| |
− | | |
− | Local labs, please confirm contacts and add links.
| |
| | | |
| == Sysadmins == | | == Sysadmins == |
| | | |
| * [[Wiki Team/Contacts]] for wiki content and user accounts | | * [[Wiki Team/Contacts]] for wiki content and user accounts |
− | * [[User:Bernie|Bernie Innocenti]] for hosting issues - I'M NO LONGER ACTIVELY MAINTAINING THIS | + | * [[User:Bernie|Bernie Innocenti]] for hosting issues - '''EMERITUS - PLEASE DON'T EXPECT SUPPORT''' |
| + | * [[User:Srevin03|Srevin Saju]] ('''srevinsaju''' on #sugar) for MediaWiki issues |
| * [[User:Sebastian|Sebastian Silva]] for the Local Labs wikis | | * [[User:Sebastian|Sebastian Silva]] for the Local Labs wikis |
| | | |
Line 46: |
Line 40: |
| Except for trivial changes, work on the wiki should be carried in the parallel wiki-devel instance before landing onto the production instance. | | Except for trivial changes, work on the wiki should be carried in the parallel wiki-devel instance before landing onto the production instance. |
| | | |
− | {{Highlight|'''Note:''' The devel wiki has an outdated snapshot of the page database and its own slightly different server configuration.}} | + | {{Highlight|'''Note:''' The devel wiki has an out of date snapshot of the DB and a slightly different LocalConfig.php.}} |
| | | |
− | Sometimes the devel instance contains interim work performed by various wiki helpers. Do not sync changes blindly to the
| + | {{Highlight|'''Note:''' Often, the devel instance contains changes performed by various wiki admins to test extensions and configuration options. Do not sync LocalConfig.php blindly to the production wiki! Use vimdiff. |
− | production wiki! | |
| | | |
| Before overwriting the page database, please | | Before overwriting the page database, please |
| * observe http://wiki-devel.sugarlabs.org/go/Category:Under_construction | | * 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). | | * 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 <code>config/index.php</code> to setup a new MediaWiki instance and then I've thrown away the generated <code>LocalConfig.php</code>:
| |
− |
| |
− | 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
| |
| | | |
| == Installation == | | == Installation == |
Line 104: |
Line 67: |
| git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/$i extensions-all/$i --branch REL1_34; | | git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/$i extensions-all/$i --branch REL1_34; |
| (cd extensions && ln -s ../extensions-all/$i); | | (cd extensions && ln -s ../extensions-all/$i); |
| + | composer update --no-dev |
| done | | done |
| | | |
− | == Visual Editor == | + | == Upgrading == |
− | | |
− | 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 http://freedom.sugarlabs.org:8001/
| |
− | | |
− | == Upgrade notes ==
| |
| | | |
| '''Note:''' Before blindly following the procedure below, check the official documentation for anything that might have changed: | | '''Note:''' Before blindly following the procedure below, check the official documentation for anything that might have changed: |
Line 124: |
Line 80: |
| git branch -a | grep REL | sort -V | | git branch -a | grep REL | sort -V |
| git checkout -b REL1_XX origin/REL1_XX | | git checkout -b REL1_XX origin/REL1_XX |
− | git submodule update --init | + | git submodule update --init --recursive |
− | | |
− | The skins also need to be updated from time to time (particularly after a major release). Instead of checking out hundreds od skins with the official process, we can update only the skins we have installed:
| |
− | | |
− | cd skins
| |
− | for i in MonoBook Timeless Vector; do
| |
− | (cd $i && git fetch && git checkout -b REL1_34 origin/REL1_34)
| |
− | done
| |
− | | |
− | As of this writing, only Vector is enabled in LocalSettings.php, but it's always best to keep the skins in sync in case we want to test them.
| |
| | | |
| The "extensions-all" directory contains a bunch of git repositories stitched together with 'git submodule'. | | The "extensions-all" directory contains a bunch of git repositories stitched together with 'git submodule'. |
Line 140: |
Line 87: |
| cd extensions-all | | cd extensions-all |
| for ext in *; do (cd $ext && git fetch && git checkout -b REL1_XX origin/REL1_XX); done | | for ext in *; do (cd $ext && git fetch && git checkout -b REL1_XX origin/REL1_XX); done |
| + | |
| + | Along with the extensions, we would also need to update the skins to the latest release. We officially use Vector (fro Desktop) and Minerva Neue (for Mobiles, v1.35+, Minerva Neue is the official responsive theme used by Wikipedia). |
| + | |
| + | cd skins |
| + | for skin in *; do (cd $skin && git fetch && git checkout -b REL1_XX origin/REL1_XX); done |
| + | |
| + | Please revise if the following steps are still needed: |
| | | |
| You also need to update some dependencies using a PHP manager called 'composer': | | You also need to update some dependencies using a PHP manager called 'composer': |
Line 153: |
Line 107: |
| php maintenance/update.php --conf /srv/www-sugarlabs/pe.sugarlabs.org/wiki/LocalSettings.php | | php maintenance/update.php --conf /srv/www-sugarlabs/pe.sugarlabs.org/wiki/LocalSettings.php |
| (replace pe.sugarlabs.org for the correct path for your local lab) | | (replace pe.sugarlabs.org for the correct path for your local lab) |
| + | |
| + | == Obsolete documentation == |
| + | |
| + | === SemanticMediaWiki === |
| | | |
| If the SemanticMediaWiki extension is enabled (we don't use it), also refresh its tables: | | If the SemanticMediaWiki extension is enabled (we don't use it), also refresh its tables: |
Line 158: |
Line 116: |
| cd extensions/SemanticMediaWiki/maintenance | | cd extensions/SemanticMediaWiki/maintenance |
| php SMW_setup.php | | php SMW_setup.php |
| + | |
| + | === Skins === |
| + | |
| + | As of this writing, the default skin vector is integrated into MediaWiki, and we don't load other skins in LocalSettings.php. |
| + | |
| + | The skins also need to be updated from time to time (particularly after a major release). Instead of checking out hundreds od skins using the official process, we refresh only the skins that are installed: |
| + | |
| + | cd skins |
| + | for i in MonoBook Timeless; do |
| + | (cd $i && git fetch && git checkout -b REL1_34 origin/REL1_34) |
| + | done |
| + | |
| + | |
| + | === 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 <code>config/index.php</code> to setup a new MediaWiki instance and then I've thrown away the generated <code>LocalConfig.php</code>: |
| + | |
| + | 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 |