Flow/2013-12 Deployment

We have the Tuesday 2013-12-10 1pm (13:00-15:00 PDT) deployment window for our deployment to enable Flow on a few pages on mediawiki.org

• gerrit config patch is Gerrit change 94106
• tracking bug bug 56506

The pages

mediawiki.org

Talk:Flow QA, Talk:Sandbox, Talk:Flow

testwiki

testwiki:Talk:Flow QA, testwiki:Talk:Sandbox

test2

test2wiki:Talk:Flow QA, test2wiki:Talk:Sandbox

There's no content to archive:

• Talk:Flow QA doesn't exist
• Talk:Sandbox is a redirect to Project:Sandbox and nothing links to it.
• Talk:Flow is a redirect to Talk:Flow Portal and only has two links.

Checklist

• N Not done Reedy +1 on Gerrit change 94106 we deployed outselves
• In progress Chris Steipp security review bug 57270, met Monday 2013-12-01 9:30 PST
•  Done ops (Faidon) OK bug 57279
•  Done We won't have dedicated memcache servers for this
•  Done this plan. Talk:Flow live at 2013-12-11 15:24 PST!

Pre-deploy

•  Done Edit the pages to say "Flow team will enable Flow on this page on 2013-12-04. After that, if you can see this then we reverted or something has gone wrong." For bonus points, make {{Flow-enabled }}.
•  Done a DBA needs to create 'flowdb' on the extension1 cluster. RT ticket 6486 filed.

Deploy steps

The wikis involved are running 1.23wmf6. It's wikitech:How to deploy code#Case_1d: new extension, with some database changes.

L10n messages

•  Done push out extension code
  • add the submodule and +2 the submodule change per wikitech:How to deploy code#Case_1d: new extension
  • +2 Gerrit change 100551 which adds Flow to wmf-config/extension-list
  • Follow wikitech:Configuration files#extension-list and ExtensionMessages-XXX.php, run mergeMessageFileList.php by hand to check for errors.
  • run scap to push Flow code and rebuild l10n cache
  • en-beta Flow QA page still works!

Database tables and records

•  Done Create Flow tables and workflow definitions in 'flowdb' on extension1 cluster.
  • Follow greg-g's e-mail to run these commands on host terbium, not tin:
  • Backport --wikidb parameter to maintenance/sql.php to wmf6 (Gerrit change 100909) and sync-file it.
  • On terbium run mwscript sql.php --wikidb=flowdb --cluster=extension1 --wiki=test2wiki extensions/Flow/flow.sql to create the tables on flowdb on extension1.
  • Fetch Gerrit change 94106 config change with wgFlowDefaultDb and wgFlowCluster settings (Flow still not enabled on any pages)
  • sync-file the updated wmf-config/InitialiseSettings.php, InitialiseSettings-labs.php, and CommonSettings.php files in that order.
  • Run mwscript --wiki=test2wiki maintenance/FlowInsertDefaultDefinitions.php to add the default workflow definitions

(If we can't create the tables and default definitions then a DBA has to run the raw commands. RT ticket 6486 we succeeded)

Enable Flow

•  Donepush out config changes that enable it on certain pages
  • +2 Gerrit change 100911
    • sync-file the updated wmf-config/InitialiseSettings.php file.

Follow up

•  Done monitor for errors.
  • only exception was someone crafting a bogus workflow UUID in a URL (we're working on it)
  • no fatals

•  Done run QA tests on test2.mediawiki.org. (chrismcmahon did). Need to adjust user rights of Selenium_user (bug 58375)

• • probably have to fix beta cluster for Flow on separate flowdb (see Matthias comment) – we left beta cluster not using separate flowdb on separate cluster with separate ExternalStore.
  •  Done our labs config override didn't work, Gerrit change 100945 fixes.

Testing

• Visit the URLs.
• Point browsertests on test2wiki at Talk:Main Page (using LiquidThreads), and Talk:Flow_QA (using Flow).