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 Upgrade Guide, 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.zip
archive. -
Extract the content of the
ataccamaone-13.0.2.zip
archive 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
ataccamaone
realm. -
Download the exported
ataccamaone-13_2_0.json
with 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
attaccamaone
realm. -
Download the
ataccamaone_partial_upgrade-13_2_0_WITH_WEBORIGINS.json
with client changes and additions. -
Navigate to Configure > Clients.
-
Select Create.
-
On the Add Client screen, create
one-desktop-browser-client
client based on the settings retrieved fromataccamaone_partial_upgrade-13_2_0_WITH_WEBORIGINS.json
file. -
Update all other clients from the downloaded file with
webOrigins
andredirectUris
.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?