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 the old version.
-
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 - rpm folder. It is saved as
Keycloak - 21.0.1.40 - rpm.zip
. -
Extract
.zip
archive:unzip "Keycloak - 21.0.1.40 - rpm.zip"
-
Stop the service:
sudo systemctl stop seal-keycloak
-
Remove the content of the
/opt/seal/data/seal-keycloak
directory:sudo rm -rf /opt/seal/data/seal-keycloak/*
-
Change to the
Keycloak - 21.0.1.40 - rpm
directory and start installing the package:cd "Keycloak - 21.0.1.40 - rpm"
sudo sh install.sh
-
Open the required firewall ports:
sudo sh firewall.sh
-
Start the service:
sudo systemctl start seal-keycloak
-
Import the old Keycloak configuration into the new version.