Hello @Keegan!

Thanks for creating this request. I would like to ask a few questions about this change:

• Are we working for a particular deadline? Please note that wiki-management stuff can easily get pretty complex (especially when it comes to wiki renaming), and that most of it is volunteer-handled (by @Ladsgroup and me)
• Is there a "do not do this before <date>"? In another words, when would you like this change to happen, in the ideal world?
• From the other tickets, it looks like legal-related stuff is the reason why we're moving away from OTRS branding. To which decree do we need to get rid of "otrs"? For instance, I'm wondering whether the internal wiki ID can stay "otrs_wikiwiki" (note that changing that will likely be really really complex).
• The wiki's sitename is currently "OTRS Wiki" (it's the thing that appears in the footer ["About OTRS Wiki"] and in the <title> tag, ie. what appears in your browser tab). What should it be changed to? I assume "VRTS Wiki"?
• What about interwiki links? Right now, you can link to OTRS wiki via [[otrswiki:foo]] (this links to https://otrs-wiki.wikimedia.org/wiki/Foo). Would you want to change that too?

New logo would be definitely be needed – I will need a link to a SVG uploaded on Wikimedia Commons, if possible :).

That's all from me for now.

Best,
Martin

@Urbanecm thanks for the questions. We'll probably want to pursue this in more depth in at least a week or two. We're undertaking the renaming stuff so we can do it on our own pace and schedule before the time ever comes when we get an order to do this for legal reasons. This way we can plan at our own pace.

I'll add in your questions into the task description on Monday.

Why not https://vrt.wikimedia.org or https://vrt-internal.wikimedia.org ?

Seconding what Martin said. Renaming a wiki is extremely complex and we have done it only once (b-x-old to be-tarask and that one is not also finished properly yet) and it's still quite a mess (probably the renaming script is also terribly broken by now) and all renames are blocked T172035: Blockers for Wikimedia wiki domain renaming (while some of the blockers are not applicable here, like wikidata support). It's also risky given that it can bring down all wikis.

If there's problem with trademark or legal. We might be able to make it work (given that it's a private wiki, doesn't need wikidata, ...) with lots of efforts and testing but if it's just naming. Let's wait until the blocker task is fully (on my volunteer work roadmap)

From the other tickets, it looks like legal-related stuff is the reason why we're moving away from OTRS branding. To which decree do we need to get rid of "otrs"? For instance, I'm wondering whether the internal wiki ID can stay "otrs_wikiwiki" (note that changing that will likely be really really complex).

Internal wiki id can't be changed. DBAs said it clearly before.

In T280400#7011164, @Ladsgroup wrote:

From the other tickets, it looks like legal-related stuff is the reason why we're moving away from OTRS branding. To which decree do we need to get rid of "otrs"? For instance, I'm wondering whether the internal wiki ID can stay "otrs_wikiwiki" (note that changing that will likely be really really complex).

Internal wiki id can't be changed. DBAs said it clearly before.

You can create a new wiki, create all accounts and import content. It's complex, but doable, IMO.

In T280400#7011162, @Ladsgroup wrote:

Seconding what Martin said. Renaming a wiki is extremely complex and we have done it only once (b-x-old to be-tarask and that one is not also finished properly yet) and it's still quite a mess (probably the renaming script is also terribly broken by now) and all renames are blocked T172035: Blockers for Wikimedia wiki domain renaming (while some of the blockers are not applicable here, like wikidata support). It's also risky given that it can bring down all wikis.

If there's problem with trademark or legal. We might be able to make it work (given that it's a private wiki, doesn't need wikidata, ...) with lots of efforts and testing but if it's just naming. Let's wait until the blocker task is fully (on my volunteer work roadmap)

I understand the complexities here. I'm pretty sure that a satisfactory outcome in the short term would be a new alias for the wiki, and looking at the project board that seems like a less-complex thing to do. Am I correct in that assumption?

The problem I have here (and it's coming from my ignorance, sorry) is to what does it mean to alias the wiki (in technical terms). Can you explain on that? What do you exactly expect to happen? Again. I'm really sorry but slightly different ideas might mean completely different things in the backend/implementation.

In T280400#7011162, @Ladsgroup wrote:

Renaming a wiki is extremely complex and we have done it only once (b-x-old to be-tarask and that one is not also finished properly yet) and it's still quite a mess (probably the renaming script is also terribly broken by now) and all renames are blocked T172035: Blockers for Wikimedia wiki domain renaming

So I've been thinking about this because I could've sworn we did more than just be-x-old. Looking back it seems be-x-old was not the only wiki renaming, just the only wiki renaming of a language-project wiki instead of a special wiki. I tracked down the file we use for special DB name <-> domain name mappings and looking at the history in https://gerrit.wikimedia.org/r/plugins/gitiles/operations/mediawiki-config/+blame/refs/heads/master/multiversion/MWMultiVersion.php#204 we did also rename chapcom.wikimedia.org -> affcom.wikimedia.org in T41482 and et.wikimedia.org -> ee.wikimedia.org in T31919. Those being special (and in the case of chapcom, private) wikis likely makes them better precedents for this.

In all those cases we kept the internal name of the wiki the same (so you still need the old name in the config files), but the domain that users see/use was changed.

It seems to me that once we have the new DNS and apache config set up, it's a case of adding the new entry to the staticMappings list, possibly swapping around some config like wgCrossSiteAJAXdomains, updating wgServer/wgCanonicalServer/wgSitename and co., possibly updating RB/Parsoid config (I imagine that's changed since I last touched it), and finally setting up redirects in apache. Don't even think we need to deal with favicons and namespaces in this case, just the logo.

tl;dr: I think we can do a wiki domain rename here:

• add new name to dns
• add new name to apache config
• add to staticMappings
• change these in mediawiki-config:

tests/multiversion/MWMultiVersionTest.php:                      [ 'otrs_wikiwiki', 'otrs-wiki.wikimedia.org' ],
tests/urls.txt:https://otrs-wiki.wikimedia.org/wiki/Main_page
wmf-config/CommonSettings.php:          'otrs-wiki.wikimedia.org',
wmf-config/CommonSettings.php:          'otrs-wiki.m.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => '//otrs-wiki.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => 'https://otrs-wiki.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => 'OTRS Wiki',
wmf-config/logos.php:   'otrs_wikiwiki' => '/static/images/project-logos/otrs_wikiwiki.png',

• update the interwiki map on meta appropriately and go through the dumpInterwiki process
• find and update any RB/Parsoid/etc. config needed
• set up redirects for old name in apache

@Keegan: Before people start opening PRs, are you sure you want it to be vrts-wiki.wikimedia.org and not vrt-wiki.wikimedia.org or one of @Bugreporter's suggestions?

Thanks for the investigation!

In T280400#7011990, @Krenair wrote:

In T280400#7011162, @Ladsgroup wrote:

Renaming a wiki is extremely complex and we have done it only once (b-x-old to be-tarask and that one is not also finished properly yet) and it's still quite a mess (probably the renaming script is also terribly broken by now) and all renames are blocked T172035: Blockers for Wikimedia wiki domain renaming

we did also rename chapcom.wikimedia.org -> affcom.wikimedia.org in T41482 and et.wikimedia.org -> ee.wikimedia.org in T31919. Those being special (and in the case of chapcom, private) wikis likely makes them better precedents for this.

In all those cases we kept the internal name of the wiki the same (so you still need the old name in the config files), but the domain that users see/use was changed.

Yes, these are the tasks I was looking at in the project that made this seem possible for what we're trying to do here and this is what I meant by "alias," setting up a new name in DNS and replacing the URL in the config. There's no need to rename the entire database or anything like that here for certain, we need a new URL. Now that I know more about how to say all this I'll edit the task.

In T280400#7011993, @Krenair wrote:

tl;dr: I think we can do a wiki domain rename here:

• add new name to dns
• add new name to apache config
• add to staticMappings
• change these in mediawiki-config:

tests/multiversion/MWMultiVersionTest.php:                      [ 'otrs_wikiwiki', 'otrs-wiki.wikimedia.org' ],
tests/urls.txt:https://otrs-wiki.wikimedia.org/wiki/Main_page
wmf-config/CommonSettings.php:          'otrs-wiki.wikimedia.org',
wmf-config/CommonSettings.php:          'otrs-wiki.m.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => '//otrs-wiki.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => 'https://otrs-wiki.wikimedia.org',
wmf-config/InitialiseSettings.php:      'otrs_wikiwiki' => 'OTRS Wiki',
wmf-config/logos.php:   'otrs_wikiwiki' => '/static/images/project-logos/otrs_wikiwiki.png',

• update the interwiki map on meta appropriately and go through the dumpInterwiki process
• find and update any RB/Parsoid/etc. config needed
• set up redirects for old name in apache

@Keegan: Before people start opening PRs, are you sure you want it to be vrts-wiki.wikimedia.org and not vrt-wiki.wikimedia.org or one of @Bugreporter's suggestions?

I am not sure. I'll confirm a name in a meeting with the admins scheduled for later this week and update the task accordingly.

Thanks for the help here :)

Hello @Keegan, just double checking, can you confirm https://vrt-wiki.wikimedia.org is the final name?

In T280400#7037472, @Urbanecm wrote:

Hello @Keegan, just double checking, can you confirm https://vrt-wiki.wikimedia.org is the final name?

@Urbanecm Yes, Confirmed. Thanks!

Change 682996 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/dns@master] Add vrt-wiki.wikimedia.org and vrt-wiki.m.wikimedia.org

https://gerrit.wikimedia.org/r/682996

Change 683000 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/puppet@production] Add vrt-wiki.wikimedia.org to mediawiki.yaml

https://gerrit.wikimedia.org/r/683000

Change 682996 merged by Dzahn:

[operations/dns@master] Add vrt-wiki.wikimedia.org and vrt-wiki.m.wikimedia.org

https://gerrit.wikimedia.org/r/682996

Change 683000 merged by Jbond:

[operations/puppet@production] Add vrt-wiki.wikimedia.org to mediawiki.yaml

https://gerrit.wikimedia.org/r/683000

Change 690680 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/mediawiki-config@master] WIP: Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 1)

https://gerrit.wikimedia.org/r/690680

Change 692452 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/mediawiki-config@master] Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 2)

https://gerrit.wikimedia.org/r/692452

Change 692454 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/puppet@production] Add redirect from otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org

https://gerrit.wikimedia.org/r/692454

@Keegan confirmed off-Phab this is ready to go at any time.

I tried to write down how I feel we can do this migration. @Ladsgroup @Krenair I'd appreciate if you could have a look at this plan and give feedback, and if one of you could be around during the migration window.

Preparation (done)

• Add vrt-wiki.wikimedia.org to DNS
• Add vrt-wiki.wikimedia.org to Apache

Migration

This will require a dedicated window.

• Add vrt-wiki.wikimedia.org to static mappings (should make vrt-wiki.wikimedia.org work, and redirect to otrs-wiki.wikimedia.org on MW layer); https://gerrit.wikimedia.org/r/c/operations/mediawiki-config/+/690680
• Change wgServer and wgCanonicalServer to vrt-wiki.wikimedia.org (should make vrt-wiki.wikimedia.org the new domain); https://gerrit.wikimedia.org/r/c/operations/mediawiki-config/+/692452

Improvements & finalization

Can be done via regular B&C / Puppet windows.

• Add redirects on apache level via Puppet: https://gerrit.wikimedia.org/r/c/operations/puppet/+/692454
• Change visual appearance (logos, icons) per to-be-delivered instructions from @Keegan / Community Relations

Possible issues

• WebAuthn 2FA – webauthn binds to a given domain, and given that's what we're going to change here, all users of webauthn will be unable to use it after the migration.
  • SOLUTION: Make sure there are no WebAuthn users before migration, and advice any such users to temporarily switch to TOTP-based 2FA instead. List is at P16027 and fortunately, it's not a very used feature at this wiki.
• ??? @Krenair @Ladsgroup Please help identify what could go wrong here.

so far it looks good to me.

This was scheduled for May 26, 15:00 UTC. Note that the wiki might behave weirdly during the move, and it's not impossible something will break after its done.

Martin: Sounds good, thanks. If you re-run your WebAuthn query now you should get a more convenient result :)

@DC: I notice you made https://otrs-wiki.wikimedia.org/w/index.php?title=MediaWiki:Sitenotice&diff=106111&oldid=105487&diffmode=source - I'm wondering why we think there would definitely be downtime? Did I misunderstand part of the plan?

In T280400#7108523, @Krenair wrote:

@DC: I notice you made https://otrs-wiki.wikimedia.org/w/index.php?title=MediaWiki:Sitenotice&diff=106111&oldid=105487&diffmode=source - I'm wondering why we think there would definitely be downtime? Did I misunderstand part of the plan?

The text of the banner is a c&p from a message from @Keegan to the VRTS admins. If no downtime is expected, I'm happy to change that.

In T280400#7108523, @Krenair wrote:

Martin: Sounds good, thanks. If you re-run your WebAuthn query now you should get a more convenient result :)

@DC: I notice you made https://otrs-wiki.wikimedia.org/w/index.php?title=MediaWiki:Sitenotice&diff=106111&oldid=105487&diffmode=source - I'm wondering why we think there would definitely be downtime? Did I misunderstand part of the plan?

That was at my direction. It's my understanding that the wiki may be down for a moment (or longer), and it's better to overcommunicate and people can expect the wiki to be inaccessible for a moment and have it not be rather than a vague "something might happen." If the wiki is never inaccessible, then there'll be no problem all around.

Change 690680 merged by jenkins-bot:

[operations/mediawiki-config@master] Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 1)

https://gerrit.wikimedia.org/r/690680

Mentioned in SAL (#wikimedia-operations) [2021-05-26T15:08:14Z] <urbanecm@deploy1002> Synchronized multiversion/MWMultiVersion.php: 945ee9c5e88166984bf12e4039d692fe06498e40: Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (T280400; 1/2) (duration: 01m 06s)

Change 692452 merged by jenkins-bot:

[operations/mediawiki-config@master] Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 2)

https://gerrit.wikimedia.org/r/692452

Mentioned in SAL (#wikimedia-operations) [2021-05-26T15:11:51Z] <urbanecm@deploy1002> Synchronized wmf-config/: 490435edb4ea4cc10ba435125ba547231fc7f1e7: Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (T280400) (duration: 01m 07s)

Change 692454 merged by Legoktm:

[operations/puppet@production] Add redirect from otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org

https://gerrit.wikimedia.org/r/692454

Mentioned in SAL (#wikimedia-operations) [2021-05-26T15:18:44Z] <urbanecm> otrs_wikiwiki was moved to vrt-wiki.wikimedia.org (T280400)

This mostly happened. vrt-wiki.wikimedia.org is now the new domain for otrs_wikiwiki.

Lingering part of this task is making a new logo.

In T280400#7116261, @Keegan wrote:

Lingering part of this task is making a new logo.

Assuming the logo on https://www.znuny.org does not reach a threshold of originality, I boldly set that logo on https://phabricator.wikimedia.org/project/profile/210/

In T280400#7010512, @Urbanecm wrote:

New logo would be definitely be needed – I will need a link to a SVG uploaded on Wikimedia Commons, if possible :).

@Urbanecm the new logo is available at https://commons.wikimedia.org/wiki/File:Wikimedia_VRT_RGB_logo.svg

Please let me know if we need anything other than that file to finish this off. Thanks so very much for your work on this.

Change 704996 had a related patch set uploaded (by Urbanecm; author: Urbanecm):

[operations/mediawiki-config@master] otrs_wikiwiki: Update logo to use VRT instead of OTRS

https://gerrit.wikimedia.org/r/704996

In T280400#7217729, @Keegan wrote:

In T280400#7010512, @Urbanecm wrote:

New logo would be definitely be needed – I will need a link to a SVG uploaded on Wikimedia Commons, if possible :).

@Urbanecm the new logo is available at https://commons.wikimedia.org/wiki/File:Wikimedia_VRT_RGB_logo.svg

Please let me know if we need anything other than that file to finish this off. Thanks so very much for your work on this.

I think that'd be all for the "wiki rebranding part". Patch uploaded, and will deploy it next week.

Change 704996 merged by jenkins-bot:

[operations/mediawiki-config@master] otrs_wikiwiki: Update logo to use VRT instead of OTRS

https://gerrit.wikimedia.org/r/704996

Mentioned in SAL (#wikimedia-operations) [2021-07-20T11:46:25Z] <urbanecm@deploy1002> Synchronized static/images/project-logos: e52ae37dc2010ed2483328921a274e4934940791: otrs_wikiwiki: Update logo to use VRT instead of OTRS (T280400; 1/3) (duration: 00m 57s)

Mentioned in SAL (#wikimedia-operations) [2021-07-20T11:47:22Z] <urbanecm@deploy1002> Synchronized wmf-config/logos.php: e52ae37dc2010ed2483328921a274e4934940791: otrs_wikiwiki: Update logo to use VRT instead of OTRS (T280400; 2/3) (duration: 00m 56s)

Mentioned in SAL (#wikimedia-operations) [2021-07-20T11:48:18Z] <urbanecm@deploy1002> Synchronized logos/config.yaml: e52ae37dc2010ed2483328921a274e4934940791: otrs_wikiwiki: Update logo to use VRT instead of OTRS (T280400; 3/3) (duration: 00m 56s)

Change 713309 had a related patch set uploaded (by RLazarus; author: RLazarus):

[operations/puppet@production] httpbb: Update tests to reflect rename from otrs-wiki to vrt-wiki.

https://gerrit.wikimedia.org/r/713309

Change 713309 merged by RLazarus:

[operations/puppet@production] httpbb: Update tests to reflect rename from otrs-wiki to vrt-wiki.

https://gerrit.wikimedia.org/r/713309

Change 761717 had a related patch set uploaded (by Zabe; author: Zabe):

[operations/puppet@production] Remove otrs-wiki.wikimedia.org from mediawiki.yaml

https://gerrit.wikimedia.org/r/761717

Change 761717 merged by RLazarus:

[operations/puppet@production] Remove otrs-wiki.wikimedia.org from mediawiki.yaml

https://gerrit.wikimedia.org/r/761717