RHIDP-12593: Support pluginDivisionMode: schema for Single Database Deployments (redhat-developer#2099)

* RHIDP-12593: Support pluginDivisionMode: schema for Single Database Deployments

* RHIDP-12593: edits from dev review

* RHIDP-12593: Removed topics per dev review

* RHIDP-12593: short description failed character limit

* RHIDP-12593: added topic based on dev discussion

* RHIDP-12593: updated task based on dev discussion

* RHIDP-12593: removed files that are not needed

* RHIDP-12593: removed assembly that is not needed

* Remove unused assembly file

* Remove unused module file

* RHIDP-12593: edits from dev review

* RHIDP-12593: minor changes to comply with style guide

* RHIDP-12593: updated filename and revised assembly to use new name

* RHIDP-12593: updated short description

* RHIDP-12593: changed filename to match JTBD suggestion

* RHIDP-12593: updated ID to match new filename

* RHIDP-12593: tshooting

* RHIDP-12593: tshooting ID

* RHIDP-12593: edits from peer review

Author: rh-tokeefe

assemblies/configure_configuring-rhdh/assembly-configure-external-postgresql-databases.adoc

@@ -21,6 +21,8 @@ include::../modules/configure_configuring-rhdh/proc-configure-an-external-postgr
 
 include::../modules/configure_configuring-rhdh/proc-migrate-local-databases-to-an-external-database-server-using-the-operator.adoc[leveloffset=+1]
 
+include::../modules/configure_configuring-rhdh/proc-configure-schema-based-plugin-isolation-to-simplify-single-database-provisioning.adoc[leveloffset=+1]
+
 :context: {previouscontext}
 :!previouscontext:
 

modules/configure_configuring-rhdh/proc-configure-schema-based-plugin-isolation-to-simplify-single-database-provisioning.adoc

@@ -0,0 +1,38 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="configure-schema-based-plugin-isolation-to-simplify-single-database-provisioning_{context}"]
+= Configure schema-based plugin isolation to simplify single-database provisioning
+
+[role="_abstract"]
+Configure schema-based plugin isolation to support database users without `CREATEDB` privileges or to reduce database provisioning overhead. Each {product-very-short} plugin uses its own PostgreSQL schema within a single shared database.
+
+.Prerequisites
+
+* An external PostgreSQL instance is configured using the Operator or the Helm chart. 
+* Your database user has `CREATE SCHEMA` privileges on the target database, or your database administrator will create the required schemas.
+
+[NOTE]
+====
+By default, when `pluginDivisionMode` is set to `schema`, {product-very-short} automatically creates the required schemas because the `ensureExists` configuration defaults to `true`. The database user must have `CREATE SCHEMA` privileges on the target database.
+====
+
+.Procedure
+
+. Add `pluginDivisionMode: schema` to the `backend.database` section of your {product-very-short} configuration in the `app-config-rhdh` ConfigMap:
++
+[source,yaml]
+----
+backend:
+  database:
+    client: pg
+    pluginDivisionMode: schema
+    connection:
+      host: ${POSTGRES_HOST}
+      port: ${POSTGRES_PORT}
+      user: ${POSTGRES_USER}
+      password: ${POSTGRES_PASSWORD}
+----
+
+. Save the configuration changes.
+
+. Restart the {product} deployment to apply the new configuration.