Nova Resource:Wikispore/Runbook

Setting up a new Wikispore instance

1. Follow the steps in Help:MediaWiki-Vagrant in Cloud VPS#Setting up your instance with MediaWiki-Vagrant.
2. Download custom Wikispore Vagrant roles from gerrit 546156: (get inside the Vagrant box with cd /srv/mediawiki-vagrant; vagrant ssh if needed, then) cd /vagrant and cherry-pick the patch (command can be copied by visiting the previous link, clicking More > Download, selecting Anonymous HTTPS and the Cherry Pick field).
3. If this is a test instance, run vagrant hiera role::wikispore::beta true in the Cloud VPS box, from the /srv/mediawiki-vagrant directory.
4. Run vagrant provision in the Cloud VPS box, from the /srv/mediawiki-vagrant directory.

Copying the DB of another Wikispore instance

(i.e. syncing up test with production

1. On the source server, get into vagrant, dump with e.g. mysqldump wiki | gzip -9 -c > /vagrant/wikispore.sql.gz
2. Move the dump to the target server, e.g. from your local machine run scp wikispore.wmflabs.org:/srv/mediawiki-vagrant/wikispore.sql.gz wikispore-test.wmflabs.org:/srv/mediawiki-vagrant/wikispore.sql.gz
3. On the target server, get into vagrant, import with e.g. zcat /vagrant/wikispore.sql.gz | mysql wiki

Adding a new namespace

1. Go to Special:Namespaces
2. Click on Add a namespace (you need to be admin)
3. Number should be the smallest available even number starting with 3000 (per this). Default and Canonical should be checked. Name should be the namespace name. Reason can be ignored (it's shown in the logs).
4. Add the corresponding talk namespace; the number should be one higher.