Page MenuHomePhabricator

Change the user-visible domain of OTRS wiki
Open, Needs TriagePublic

Description

https://otrs-wiki.wikimedia.org needs to have its user-visible domain name changed to https://vrt-wiki.wikimedia.org

Consensus on the name of the domain was reached with the VRT leaders (formerly known as OTRS admins). vtrs-wiki was considered but as the wiki is the home to the community and not just information about the system and software, VRT properly represents the purpose. We also decided against using "internal" in the URL.

We'd like to see if this task can be completed by the end of May 2021, but it's understandable if it takes longer. New icons are coming, probably the week of 3 May.

Event Timeline

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.

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.

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.

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.

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?

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.

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 :)

Keegan renamed this task from Alias or rename OTRS-wiki to Set up a new DNS name for OTRS wiki.Apr 19 2021, 4:36 PM
Krenair renamed this task from Set up a new DNS name for OTRS wiki to Change the user-visible domain of OTRS wiki.Apr 19 2021, 5:23 PM
Krenair updated the task description. (Show Details)

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

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

I'm going to be the one doing this. Claiming.

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.

Improvements & finalization

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

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.

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?

@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.

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.

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/