Add H2 upgrade to release notes and migration guide

Relates to keycloak/keycloak#12607
Relates to keycloak/keycloak#11292
Relates to keycloak/keycloak#10113

Co-authored-by: andymunro <48995441+andymunro@users.noreply.github.com>
This commit is contained in:
Alexander Schwartz 2022-10-14 18:40:53 +02:00 committed by Hynek Mlnařík
parent fcd1381682
commit e999186b84
2 changed files with 36 additions and 2 deletions

View file

@ -9,4 +9,11 @@ More details can be found at the https://www.keycloak.org/server/hostname[Config
= Improvements to `kc.bat` when running Keycloak on Windows
In this release, we are making important changes to `kc.bat` in order to give the same experience as when running on Linux.
In this release, we are making important changes to `kc.bat` to give the same experience as when running on Linux.
= Upgrade of embedded H2 database
{project_name} ships for development purposes with an H2 database driver. As it is intended for development purposes only, it should never be used in a production environment.
In this release, the H2 driver has been upgraded from version 1.x to version 2.x.
See link:{upgradingguide_link}[{upgradingguide_name}] for details on how to migrate.

View file

@ -1,3 +1,30 @@
= RESTEasy Version Update
Updated the RESTEasy version of Keycloak Admin REST Client to the next major version.
Updated the RESTEasy version of Keycloak Admin REST Client to the next major version.
= H2 Version Update
{project_name} ships for development purposes with an H2 database driver.
As it is intended for development purposes only, it should never be used in a production environment.
In this release, the H2 driver has been upgraded from version 1.x to version 2.x.
This change might require changes to the H2 JDBC URL or migration of the H2 database files in an existing Keycloak setup.
== Changes to the H2 JDBC URL
For Keycloak to run with its JPA legacy store with H2 version 2.x, the JDBC URL requires the attribute `NON_KEYWORDS=VALUE`.
In a setup where H2 is initialized by Keycloak without extra parameters, Keycloak will append the attribute automatically.
This is the default for development setups.
If an H2 JDBC URL is provided on the command line or in a configuration file, and it already contains the `NON_KEYWORDS=` attribute in the JDBC URL, this attribute needs to be amended with the `VALUE` keyword.
If the connection factory for the H2 database is initialized outside Keycloak, that initialization needs to take care of adding the `NON_KEYWORDS` attribute.
See the H2 documentation http://www.h2database.com/html/commands.html#set_non_keywords[on the `NON_KEYWORDS` attribute] for details.
== Upgrade of H2 database files
H2 database base files created with H2 version 1.x should not be used with version 2.x.
Purge existing H2 database files to start with an empty database, export and import the realms using Keycloak's export and import functionality, or refer to the http://www.h2database.com/html/migration-to-v2.html[migration notes on the H2 database project's website] for details on how to migrate H2 database contents.