DBZ-8090 Split content off to new file and add via include directives

documentation/modules/ROOT/pages/connectors/db2.adoc

@@ -2418,7 +2418,8 @@ Information about the properties is organized as follows:
 * xref:db2-required-configuration-properties[Required configuration properties]
 * xref:db2-advanced-configuration-properties[Advanced configuration properties]
 * xref:debezium-db2-connector-database-history-configuration-properties[Database schema history connector configuration properties] that control how {prodname} processes events that it reads from the database schema history topic.
-** xref:debezium-db2-connector-pass-through-database-driver-configuration-properties[Pass-through database schema history properties]
+* xref:debezium-db2-connector-pass-through-database-driver-configuration-properties[Pass-through database schema history properties]
+* xref:db2-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients[Pass-through database schema history properties]
 * xref:debezium-db2-connector-pass-through-database-driver-configuration-properties[Pass-through database driver properties] that control the behavior of the database driver.
 
 
@@ -3121,11 +3122,18 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+[id="debezium-db2-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-db2-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} connector pass-through database driver configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-driver-configuration-properties.adoc[leveloffset=+1]
 
+
+
 // Type: assembly
 // ModuleID: monitoring-debezium-db2-connector-performance
 // Title: Monitoring {prodname} Db2 connector performance

documentation/modules/ROOT/pages/connectors/informix.adoc

@@ -1967,7 +1967,9 @@ Information about the properties is organized as follows:
 * xref:informix-required-configuration-properties[Required configuration properties]
 * xref:informix-advanced-configuration-properties[Advanced configuration properties]
 * xref:debezium-informix-connector-database-history-configuration-properties[Database schema history connector configuration properties] that control how {prodname} processes events that it reads from the database schema history topic.
-** xref:debezium-informix-connector-pass-through-database-driver-configuration-properties[Pass-through database schema history properties]
+* xref:debezium-informix-connector-kafka-signals-configuration-properties[Kafka signals configuration properties]
+* xref:debezium-informix-connector-kafka-notifications-configuration-properties[Sink notifications configuration properties]
+* xref:debezium-informix-connector-pass-through-database-schema-history-properties[Pass-through database schema history properties]
 * xref:debezium-informix-connector-pass-through-database-driver-configuration-properties[Pass-through database driver properties] that control the behavior of the database driver.
 
 
@@ -2679,16 +2681,21 @@ Set the value to `0` (zero) to remove the timeout limit.
 
 include::{partialsdir}/modules/all-connectors/ref-connector-configuration-database-history-properties.adoc[leveloffset=+1]
 
-[id="debezium-{context}-connector-kafka-signals-configuration-properties"]
+[id="debezium-informix-connector-kafka-signals-configuration-properties"]
 ==== {prodname} connector Kafka signals configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-signals-configuration-properties.adoc[leveloffset=+1]
 
-[id="debezium-{context}-connector-kafka-notifications-configuration-properties"]
+[id="debezium-informix-connector-kafka-notifications-configuration-properties"]
-==== {prodname} connector sink notifications configuration properties
+==== Pass-through Kafka sink notification configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+[id="debezium-informix-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-informix-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} connector pass-through database driver configuration properties
 

documentation/modules/ROOT/pages/connectors/mariadb.adoc

@@ -455,6 +455,12 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+
+[id="debezium-mariadb-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-mariadb-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} connector pass-through database driver configuration properties
 

documentation/modules/ROOT/pages/connectors/mysql.adoc

@@ -549,11 +549,18 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+[id="debezium-mysql-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-{context}-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} connector pass-through database driver configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-driver-configuration-properties.adoc[leveloffset=+1]
 
+
+
 // Type: assembly
 // ModuleID: monitoring-debezium-mysql-connector-performance
 // Title: Monitoring {prodname} MySQL connector performance

documentation/modules/ROOT/pages/connectors/oracle.adoc

@@ -4284,11 +4284,18 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+[id="db2-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-oracle-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} Oracle connector pass-through database driver configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-driver-configuration-properties.adoc[leveloffset=+1]
 
+
+
 // Type: assembly
 // ModuleID: monitoring-debezium-oracle-connector-performance
 // Title: Monitoring {prodname} Oracle connector performance

documentation/modules/ROOT/pages/connectors/postgresql.adoc

@@ -3820,6 +3820,12 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+
+[id="postgresql-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-{context}-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} connector pass-through database driver configuration properties
 

documentation/modules/ROOT/pages/connectors/sqlserver.adoc

@@ -3322,12 +3322,17 @@ include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-s
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-kafka-notification-configuration-properties.adoc[leveloffset=+1]
 
+
+[id="sqlserver-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients"]
+==== Pass-through database schema history properties for configuring producer and consumer clients
+
+include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc[leveloffset=+1]
+
 [id="debezium-sqlserver-connector-pass-through-database-driver-configuration-properties"]
 ==== {prodname} SQL Server connector pass-through database driver configuration properties
 
 include::{partialsdir}/modules/all-connectors/ref-connector-pass-through-database-driver-configuration-properties.adoc[leveloffset=+1]
 
-
 // Type: assembly
 // ModuleID: refreshing-capture-tables-after-a-schema-change
 // Title: Refreshing capture tables after a schema change

documentation/modules/ROOT/partials/modules/all-connectors/ref-connector-pass-through-database-history-properties-for-configuring-producer-and-consumer-clients.adoc

@@ -0,0 +1,25 @@
+{prodname} relies on a Kafka producer to write schema changes to database schema history topics.
+Similarly, it relies on a Kafka consumer to read from database schema history topics when a connector starts.
+You define the configuration for the Kafka producer and consumer clients by assigning values to a set of pass-through configuration properties that begin with the `schema.history.internal.producer.\*` and `schema.history.internal.consumer.*` prefixes.
+The pass-through producer and consumer database schema history properties control a range of behaviors, such as how these clients secure connections with the Kafka broker, as shown in the following example:
+
+[source,indent=0]
+----
+schema.history.internal.producer.security.protocol=SSL
+schema.history.internal.producer.ssl.keystore.location=/var/private/ssl/kafka.server.keystore.jks
+schema.history.internal.producer.ssl.keystore.password=test1234
+schema.history.internal.producer.ssl.truststore.location=/var/private/ssl/kafka.server.truststore.jks
+schema.history.internal.producer.ssl.truststore.password=test1234
+schema.history.internal.producer.ssl.key.password=test1234
+
+schema.history.internal.consumer.security.protocol=SSL
+schema.history.internal.consumer.ssl.keystore.location=/var/private/ssl/kafka.server.keystore.jks
+schema.history.internal.consumer.ssl.keystore.password=test1234
+schema.history.internal.consumer.ssl.truststore.location=/var/private/ssl/kafka.server.truststore.jks
+schema.history.internal.consumer.ssl.truststore.password=test1234
+schema.history.internal.consumer.ssl.key.password=test1234
+----
+
+{prodname} strips the prefix from the property name before it passes the property to the Kafka client.
+
+See the Kafka documentation for more details about link:https://kafka.apache.org/documentation.html#producerconfigs[Kafka producer configuration properties] and link:https://kafka.apache.org/documentation.html#consumerconfigs[Kafka consumer configuration properties].