MDM 13.2 Upgrade Notes
Keycloak upgrade
Starting from version 13.2.0, MDM is using Keycloak 13.0.1 instead of 12.0.4.
This means a new Keycloak version has to be downloaded and installed (see Self-Managed Deployment and Upgrade, section Upgrading Keycloak) and the Ataccama theme and the ataccamaone realm have to be updated as described in this article.
Upgrade theme
The Ataccama theme has been upgraded to 13.1.0 version.
-
Download the
ataccamaone-13.0.2.ziparchive. -
Extract the content of the
ataccamaone-13.0.2.ziparchive to theopt/keycloak/keycloak-13.0.1/themes/ataccamaone/.
Upgrade ataccamaone realm
There have been multiple changes done between 13.1.0 and 13.2.0 version of the ataccamaone realm.
Partial import
Perform a partial import to the already loaded ataccamaone realm.
This option is only for cases when you can be sure that no changes were made to the Keycloak clients definitions.
-
Open the Keycloak Admin Console.
-
Select the
ataccamaonerealm. -
Download the exported
ataccamaone-13_2_0.jsonwith changes. -
From the left navigation tab, select Manage > Import.
-
Change the redirect URIs to correspond to the actual URL values.
-
Choose the file with changed values.
-
Set the following options:
-
Import users: OFF.
-
Import clients: ON.
-
Import realm roles: OFF.
-
If resource exists: Overwrite.
-
-
Select Import.
Manual update
Update the clients parameters manually. This option is for deployments when you do not know if some client configurations has been changed (or you know for sure that it has been changed).
-
Open the Keycloak Admin Console.
-
Select the
attaccamaonerealm. -
Download the
ataccamaone_partial_upgrade-13_2_0_WITH_WEBORIGINS.jsonwith client changes and additions. -
Navigate to Configure > Clients.
-
Select Create.
-
On the Add Client screen, create
one-desktop-browser-clientclient based on the settings retrieved fromataccamaone_partial_upgrade-13_2_0_WITH_WEBORIGINS.jsonfile. -
Update all other clients from the downloaded file with
webOriginsandredirectUris.The full list of clients that have to be updated:
-
mdm-token-client -
mdm-webapp-public-client -
dqit-steps-token-client -
dqit-webapp-token-client
-
Was this page useful?