-
Notifications
You must be signed in to change notification settings - Fork 7.9k
Improve procedure for handling open transactions #29748
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
ahus1
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for looking into this.
This would still be necessary if a deployment has XA transactions enabled. But the path is wrong, as it is set for Quarkus to a different value:
| quarkus.transaction-manager.object-store.directory=${kc.home.dir:default}${file.separator}data${file.separator}transaction-logs |
See
keycloak/docs/guides/server/db.adoc
Lines 270 to 283 in 9db1443
| == Using Database Vendors with XA transaction support | |
| {project_name} uses non-XA transactions and the appropriate database drivers by default. | |
| If you wish to use the XA transaction support offered by your driver, enter the following command: | |
| <@kc.build parameters="--db=<vendor> --transaction-xa-enabled=true"/> | |
| {project_name} automatically chooses the appropriate JDBC driver for your vendor. | |
| NOTE: Certain vendors, such as Azure SQL and MariaDB Galera, do not support or rely on the XA transaction mechanism. | |
| XA recovery defaults to enabled and will use the file system location `KEYCLOAK_HOME/data/transaction-logs` to store transaction logs. | |
| NOTE: Enabling XA transactions in a containerized environment does not fully support XA recovery unless stable storage is available at that path. |
Note that XA transactions have been enabled by default in the Quarkus versions up until KC24 (including), and have been disabled by default in KC25 (see #27308).
00f101c to
5ba1468
Compare
|
@ahus1 |
|
@k-tamura - thank you, the updated docs match Keycloak's behavior. To be able to merge this PR, I ask you to squash those commits, and add a Sign-off to the commit. See the file |
Signed-off-by: k-tamura <[email protected]>
|
@ahus1 |
ahus1
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for this fix and making the docs accurate!
|
Thank you - your changes will be part of the next major release of Keycloak (26.0.0) |
This operation should not be necessary in the Quarkus version.