Skip to content

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:

  1. Export the old Keycloak configuration.
  2. Remove the old configuration.
  3. Update Keycloak.
  4. Reimport the exported configuration.
  1. Export the existing Keycloak configuration with version 15.

  2. 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.

  3. Download the Keycloak - 21.0.1.40 - msi folder. It is saved as Keycloak - 21.0.1.40 - msi.zip.

  4. Extract the .zip archive.

  5. Stop the service:

    stop-service seal-keycloak
    
  6. Remove the content of the $env:ProgramData\SEAL Systems\data\seal-keycloak\ directory:

    Remove-Item "$env:ProgramData\SEAL Systems\data\seal-keycloak\*" -Force -Recurse
    
  7. 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
    
  8. Open the required firewall ports:

    Set-ExecutionPolicy Bypass -Scope Process -Force; .\firewall.ps1
    
  9. Start the service:

    start-service seal-keycloak
    
  10. Import the old Keycloak configuration into the new version.


Back to top