Updating Keycloak¶
Hint - version changes
The new Keycloak version comes with some important changes, see Changes
Updating from Version 15.0.0¶
Hint - internal data structure changes
Due to Keycloak-internal data structure changes you have to proceed as follows:
- Export the old Keycloak configuration.
- Remove the old configuration.
- Update Keycloak.
- Reimport the exported configuration.
-
Export the existing Keycloak configuration with version 15.
-
In a browser, log on to the SEAL Systems delivery platform with your logon data:
https://delivery.sealsystems.de
Hint - logon data
You receive the logon data from your Technical Project Manager at SEAL Systems.
-
Download the Keycloak - 21.0.1.40 - msi folder. It is saved as
Keycloak - 21.0.1.40 - msi.zip
. -
Extract the
.zip
archive. -
Stop the service:
stop-service seal-keycloak
-
Remove the content of the
$env:ProgramData\SEAL Systems\data\seal-keycloak\
directory:Remove-Item "$env:ProgramData\SEAL Systems\data\seal-keycloak\*" -Force -Recurse
-
In a PowerShell (Administrator), change to the
Keycloak - 21.0.1.40 - msi
directory and start installing the package:cd "Keycloak - 21.0.1.40 - msi"
Set-ExecutionPolicy Bypass -Scope Process -Force; .\install.ps1
-
Open the required firewall ports:
Set-ExecutionPolicy Bypass -Scope Process -Force; .\firewall.ps1
-
Start the service:
start-service seal-keycloak
-
Import the old Keycloak configuration into the new version.