From 3a0faf5475b2f6c0895d70e5dad6f139497ca8cb Mon Sep 17 00:00:00 2001 From: Wim Deblauwe Date: Fri, 14 Jun 2024 09:17:17 +0200 Subject: [PATCH] Fix the website on https://www.keycloak.org/server/db showing some asciidoc related `ifeval` text Closes #30417 Signed-off-by: Wim Deblauwe Signed-off-by: Alexander Schwartz Co-authored-by: Alexander Schwartz --- docs/guides/server/db.adoc | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/guides/server/db.adoc b/docs/guides/server/db.adoc index 060b2e6c9112..ffd6f24ef0c8 100644 --- a/docs/guides/server/db.adoc +++ b/docs/guides/server/db.adoc @@ -32,9 +32,22 @@ only exists for development use-cases. The `dev-file` database is not suitable f == Installing a database driver -Database drivers are shipped as part of {project_name} except for the Oracle Database<@profile.ifProduct> and Microsoft SQL Server drivers. +Database drivers are shipped as part of {project_name} except for the +<@profile.ifProduct> +Oracle Database and Microsoft SQL Server drivers. + +<@profile.ifCommunity> +Oracle Database driver. + -Install the necessary missing driver manually if you want to connect to one of these databases or skip this section if you want to connect to a different database for which the database driver is already included. +Install the necessary missing driver manually if you want to connect to +<@profile.ifProduct> +one of these databases + +<@profile.ifCommunity> +this database + +or skip this section if you want to connect to a different database for which the database driver is already included. === Installing the Oracle Database driver @@ -268,7 +281,7 @@ The maximum timeout for this lock is 900 seconds. If a node waits on this lock f <@kc.start parameters="--spi-dblock-jpa-lock-wait-timeout 900"/> == Using Database Vendors with XA transaction support -{project_name} uses non-XA transactions and the appropriate database drivers by default. +{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: @@ -278,7 +291,7 @@ If you wish to use the XA transaction support offered by your driver, enter the 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. +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.