diff --git a/documentation/modules/ROOT/nav.adoc b/documentation/modules/ROOT/nav.adoc index 0fc11cdad..c0d6a131e 100644 --- a/documentation/modules/ROOT/nav.adoc +++ b/documentation/modules/ROOT/nav.adoc @@ -21,6 +21,7 @@ ** xref:connectors/postgresql.adoc[PostgreSQL] ** xref:connectors/oracle.adoc[Oracle] ** xref:connectors/sqlserver.adoc[SQL Server] +** xref:connectors/db2.adoc[Db2] ** xref:connectors/cassandra.adoc[Cassandra] * Integrations ** xref:integrations/serdes.adoc[Change Event SerDes] diff --git a/documentation/modules/ROOT/pages/connectors/db2.adoc b/documentation/modules/ROOT/pages/connectors/db2.adoc index 5250215ff..e94528642 100644 --- a/documentation/modules/ROOT/pages/connectors/db2.adoc +++ b/documentation/modules/ROOT/pages/connectors/db2.adoc @@ -31,6 +31,8 @@ All of the events for each table are recorded in a separate Kafka topic, where t The functionality of the connector is based upon the https://www.ibm.com/support/pages/q-replication-and-sql-replication-product-documentation-pdf-format-version-101-linux-unix-and-windows[ASN Capture/Apply agents] that enable SQL Replication within DB2. +In order to use ASN and hence this connector, you need to have a license for the IBM InfoSphere Data Replication (IIDR) product. +It is not required that IIDR itself is installed. The capture agent generates ASN tables for all tables in CDC mode, these ASN tables can be queried via a SQL interface in order to read change events. Using this mechanism a Db2 ASN capture agent monitors all databases and tables that the user is interested in and stores the changes into specifically created ASN tables. @@ -1043,13 +1045,12 @@ The `connect.decimal.precision` schema parameter contains an integer representin == Deploying a connector If you've already installed https://zookeeper.apache.org[Zookeeper], http://kafka.apache.org/[Kafka], and http://kafka.apache.org/documentation.html#connect[Kafka Connect], then using Debezium's Db2` connector is easy. -First download the https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{debezium-version}/debezium-connector-db2-{debezium-version}-plugin.tar.gz[connector's plugin archive], extract the JARs into your Kafka Connect environment. +First download the https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{debezium-version}/debezium-connector-db2-{debezium-version}-plugin.tar.gz[connector's plugin archive], +extract it, and add the contained directory to https://docs.confluent.io/current/connect/managing/install.html#install-connector-manually[Kafka Connect's plug-in path]. -In addition, due to licensing reasons you need to explicitly obtain the jdbc driver for Db2. -This is available at link:https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[Db2 jdbc driver]. - -Then add the directory with the JARs to http://docs.confluent.io/{confluent-platform-version}/connect/userguide.html#installing-plugins[Kafka Connect's classpath]. -Restart your Kafka Connect process to pick up the new JARs. +In addition, due to licensing reasons you need to separately obtain the https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[JDBC driver for Db2]. +Add the JDBC driver JAR to the directory with the Debezium Db2 connector JARs. +Restart your Kafka Connect process to pick up the new connector. If immutable containers are your thing, then check out https://hub.docker.com/r/debezium/[Debezium's Container images] for Zookeeper, Kafka and Kafka Connect with the Db2 connector already pre-installed and ready to go. You can even link:/docs/openshift/[run Debezium on OpenShift]. diff --git a/documentation/modules/ROOT/pages/connectors/index.adoc b/documentation/modules/ROOT/pages/connectors/index.adoc index 77fbf21ac..35150bf81 100644 --- a/documentation/modules/ROOT/pages/connectors/index.adoc +++ b/documentation/modules/ROOT/pages/connectors/index.adoc @@ -9,9 +9,10 @@ We currently have the following connectors: * xref:connectors/postgresql.adoc[PostgreSQL] * xref:connectors/sqlserver.adoc[SQL Server] * xref:connectors/oracle.adoc[Oracle] (Incubating) +* xref:connectors/oracle.adoc[Db2] (Incubating) * xref:connectors/cassandra.adoc[Cassandra] (Incubating) [NOTE] ==== An incubating connector is one that has been released for preview purposes and is subject to changes that may not always be backward compatible. -==== \ No newline at end of file +==== diff --git a/documentation/modules/ROOT/pages/install.adoc b/documentation/modules/ROOT/pages/install.adoc index 9c3e7423f..37a0a6b99 100644 --- a/documentation/modules/ROOT/pages/install.adoc +++ b/documentation/modules/ROOT/pages/install.adoc @@ -33,6 +33,7 @@ The connector plugins are available from Maven: * https://repo1.maven.org/maven2/io/debezium/debezium-connector-mongodb/{install-version}/debezium-connector-mongodb-{install-version}-plugin.tar.gz[MongoDB Connector plugin archive] * https://repo1.maven.org/maven2/io/debezium/debezium-connector-sqlserver/{install-version}/debezium-connector-sqlserver-{install-version}-plugin.tar.gz[SQL Server Connector plugin archive] * https://repo1.maven.org/maven2/io/debezium/debezium-connector-oracle/{install-version}/debezium-connector-oracle-{install-version}-plugin.tar.gz[Oracle Connector plugin archive] (incubating) +* https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{install-version}/debezium-connector-db2-{install-version}-plugin.tar.gz[Db2 Connector plugin archive] (incubating) * https://repo1.maven.org/maven2/io/debezium/debezium-connector-cassandra/{install-version}/debezium-connector-cassandra-{install-version}-plugin.tar.gz[Cassandra plugin archive] (incubating) If immutable containers are your thing, then check out https://quay.io/organization/debezium[Debezium's container images] (https://hub.docker.com/r/debezium/[alternative source] on DockerHub) for Apache Kafka, Kafka Connect and Apache Zookeeper, with the different Debezium connectors already pre-installed and ready to go. Our xref:tutorial.adoc[tutorial] even walks you through using these images, and this is a great way to learn what Debezium is all about. @@ -59,7 +60,8 @@ xref:connectors/mysql.adoc#deploying-a-connector[MySQL Connector], xref:connectors/postgresql.adoc#deploying-a-connector[Postgres Connector], xref:connectors/mongodb.adoc#deploying-a-connector[MongoDB Connector], xref:connectors/sqlserver.adoc#deploying-a-connector[SQL Server Connector], -xref:connectors/oracle.adoc#deploying-a-connector[Oracle Connector] +xref:connectors/oracle.adoc#deploying-a-connector[Oracle Connector], +xref:connectors/db2.adoc#deploying-a-connector[Db2 Connector] or xref:connectors/cassandra.adoc#deploying-a-connector[Cassandra Connector] and use the link:https://docs.confluent.io/{confluent-platform-version}/connect/restapi.html[Kafka Connect REST API] to add that connector configuration to your Kafka Connect cluster. When the connector starts, it will connect to the source and produce events