Change the user-visible domain of OTRS wiki
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	Keegan
	Apr 16 2021, 6:33 PM

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.

Details

Subject	Repo	Branch	Lines +/-
Remove otrs-wiki.wikimedia.org from mediawiki.yaml	operations/puppet	production	+0 -2
httpbb: Update tests to reflect rename from otrs-wiki to vrt-wiki.	operations/puppet	production	+7 -1
otrs_wikiwiki: Update logo to use VRT instead of OTRS	operations/mediawiki-config	master	+3 -2
Add redirect from otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org	operations/puppet	production	+3 -0
Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 2)	operations/mediawiki-config	master	+5 -5
Move otrs-wiki.wikimedia.org to vrt-wiki.wikimedia.org (part 1)	operations/mediawiki-config	master	+2 -0
Add vrt-wiki.wikimedia.org to mediawiki.yaml	operations/puppet	production	+2 -0
Add vrt-wiki.wikimedia.org and vrt-wiki.m.wikimedia.org	operations/dns	master	+2 -0

Customize query in gerrit

Related Objects
Search...

Status	Assigned	Task
Open	Keegan	T280392 Migrate Wikimedia away from OTRS software and branding
Resolved	Keegan	T280693 Update interwiki map on Meta
Resolved	Urbanecm	T280400 Change the user-visible domain of OTRS wiki

Event Timeline

Keegan created this task.Apr 16 2021, 6:33 PM

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 added a project: User-Urbanecm.Apr 16 2021, 8:10 PM

NoFWDaddress subscribed.Apr 16 2021, 8:40 PM

DannyS712 subscribed.Apr 16 2021, 9:33 PM

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

taavi removed Keegan as the assignee of this task.Apr 17 2021, 9:35 AM

Zabe subscribed.Apr 17 2021, 3:45 PM

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.

Krenair subscribed.Apr 18 2021, 1:06 PM

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

Krenair assigned this task to Keegan.Apr 19 2021, 4:34 PM

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)

Krenair mentioned this in T280693: Update interwiki map on Meta.Apr 22 2021, 11:03 PM

Keegan updated the task description. (Show Details)Apr 26 2021, 4:26 PM

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

gerritbot added a project: Patch-For-Review.Apr 27 2021, 5:00 PM

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

Aklapper added a parent task: T280693: Update interwiki map on Meta.May 9 2021, 3:13 AM

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

Maintenance_bot removed a project: Patch-For-Review.May 13 2021, 4:10 PM

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

gerritbot added a project: Patch-For-Review.May 13 2021, 8:11 PM

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.

Frostly subscribed.May 25 2021, 11:49 PM

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.

Ruthven awarded a token.May 26 2021, 3:30 PM

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.

Urbanecm triaged this task as Low priority.Jul 16 2021, 4:23 PM

Keegan closed this task as Resolved.Jul 19 2021, 5:20 PM

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)