Hi everyone,
i wanted to share one of my findings on the MAS 9.2 upgrade. There is a very specific bug when upgrading from MAS 9.1 to 9.2.
Before you start upgrading check the .spec.settings.routingMode in the Suite CR. it should be set to subdomain. if it is set to path then that is going to break the home Route after upgrade.
Longer explanation:
on some versions of MAS DevOps ansible collection, and MAS CLI as well, the default setting for the routingMode was path. This change was itroduced in version 29.11.0 (https://github.com/ibm-mas/ansible-devops/releases/tag/29.11.0) via a pull request #1974 (https://github.com/ibm-mas/ansible-devops/pull/1974). It was later changed to subdomain in version 34.0.1 (https://github.com/ibm-mas/ansible-devops/releases/tag/34.0.1) via pull request #2032 (https://github.com/ibm-mas/ansible-devops/pull/2032). All of the MAS CLI releases using DevOps collection between version 29.11.0 and 34.0.1 would be setting the routing mode to path.
If you have deployed MAS using MAS DevOps collection or MAS CLI with those versions you most probably have the routingMode set to path.
That was not an issue as in MAS 9.1 that setting did not do anything at all. However, in 9.2 that setting does actually control how MAS Routes are being created in OCP. After upgrading MAS operator tries to apply the change, but since the routingMode parameter should not be changed post initial deployment, operator fails miserably. But it does corrupt one of the routes - the home one. Direct link to manage still works, but the home and navigator do not.
What to do if you already did the upgrade and now have the corrupted Route?
go to Suite CR and change the routingMode to subdomain. Next go to Routes and find Route pointing to navigator Service. in the yaml of that route delete the .spec.path parameter and change the .spec.host to <instance>.home.<instance>.<domain> (ex: dev.home.dev.apps.whateverdomain.com)
Cheers,
WW
------------------------------
Witold Wierzchowski
Solution Architect
Cohesive Poland
------------------------------