DBZ-4835 update source and destination for deploying connector files;

This commit is contained in:
Bob Roldan 2022-03-18 22:18:47 -04:00 committed by Gunnar Morling
parent eadf9563c2
commit ce113b270a
3 changed files with 23 additions and 26 deletions

View File

@ -20,6 +20,7 @@ asciidoc:
strimzi-version: '0.18.0'
apicurio-version: '2.1.5.Final'
db2-version: '11.5.0.0'
ojdbc8-version: '21.1.0.0'
community: true
registry: 'Apicurio Registry'
registry-name-full: Apicurio API and Schema Registry

View File

@ -1612,10 +1612,11 @@ To deploy a {prodname} Db2 connector, you install the {prodname} Db2 connector a
. Download the link:https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{debezium-version}/debezium-connector-db2-{debezium-version}-plugin.tar.gz[connector's plug-in archive].
. Extract the JAR files into your Kafka Connect environment.
. Add the directory with the JAR files to {link-kafka-docs}/#connectconfigs[Kafka Connect's `plugin.path`].
. Obtain the link:https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[JDBC driver for Db2].
+
. Obtain the link:https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[JDBC driver for Db2]. +
[IMPORTANT]
====
The {prodname} Db2 connector archive does not include the Db2 JDBC driver that {prodname} requires to connect to a Db2 database.
====
. Add the JDBC driver JAR file to the directory with the {prodname} Db2 connector JARs.
. xref:{link-db2-connector}#db2-adding-connector-configuration[Configure the connector and add the configuration to your Kafka Connect cluster.]
. Restart your Kafka Connect process to pick up the new JAR files.

View File

@ -1870,25 +1870,19 @@ To deploy a {prodname} Oracle connector, you install the {prodname} Oracle conne
.Prerequisites
* link:https://zookeeper.apache.org/[Apache ZooKeeper], link:http://kafka.apache.org/[Apache Kafka], and link:{link-kafka-docs}.html#connect[Kafka Connect] are installed.
* Oracle Database is installed, and is xref:{link-oracle-connector}#setting-up-oracle[configured to work with the {prodname} connector].
* You have a copy of the Oracle JDBC driver.
+
[IMPORTANT]
====
Due to licensing requirements, the {prodname} Oracle connector archive does not include the Oracle JDBC driver that the connector requires to connect to an Oracle database.
To enable the connector to access the database, you must add the driver to your connector environment.
For more information, see xref:obtaining-the-oracle-jdbc-driver[Obtaining the Oracle JDBC driver].
====
.Procedure
. Download the {prodname} https://repo1.maven.org/maven2/io/debezium/debezium-connector-oracle/{debezium-version}/debezium-connector-oracle-{debezium-version}-plugin.tar.gz[Oracle connector plug-in archive].
. Extract the files into your Kafka Connect environment.
. xref:obtaining-the-oracle-jdbc-driver[Download the Oracle JDBC driver from Maven Central and extract it to the directory with the connector JAR files.]
. Add the directory with the JAR files to {link-kafka-docs}/#connectconfigs[Kafka Connect's `plugin.path`].
. xref:{link-oracle-connector}#oracle-example-configuration[Configure the connector] and xref:{link-oracle-connector}#oracle-adding-connector-configuration[add the configuration to your Kafka Connect cluster.]
. Restart your Kafka Connect process to pick up the new JAR files.
.Next steps
xref:{link-oracle-connector}#oracle-example-configuration[Configure the connector] and xref:{link-oracle-connector}#oracle-adding-connector-configuration[add the configuration to your Kafka Connect cluster.]
endif::community[]
ifdef::product[]
@ -2141,28 +2135,29 @@ There are two methods for obtaining the driver, depending on the deployment meth
. Complete one of the following procedures, depending on your deployment type:
** If you use {StreamsName} to deploy the connector:
.. Navigate to link:https://repo1.maven.org/maven2/com/oracle/database/jdbc/[Maven Central].
.. In the YAML for the `KafkaConnector` custom resource (CR), add the URL path for the driver to the `artifacts.url` field for the `debezium-connector-oracle` artifact.
.. In the YAML for the `KafkaConnector` custom resource (CR), add the following URL path for the driver to the `artifacts.url` field for the `debezium-connector-oracle` artifact:
+
[source,shell,subs="attributes+"]
----
https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/{ojdbc8-version}/ojdbc8-{ojdbc8-version}.jar
----
+
For more information about the YAML file for the `KafkaConnector` CR, see xref:openshift-streams-oracle-connector-deployment[Using {StreamsName} to deploy a {prodname} Oracle connector].
** If you use a Dockerfile to deploy the connector:
.. From a browser, navigate to link:https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/[Maven Central].
.. Click the directory for your version of Oracle Database, and then download the `ojdbc8.jar` driver file.
.. Copy the downloaded file to the directory that stores the {prodname} Oracle connector files, for example, `_<kafka_home>_/libs`.
+
When the connector starts, it is automatically configured to use the specified driver.
.. From a browser, link:https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/{ojdbc8-version}/ojdbc8-{ojdbc8-version}.jar[download the 'ojdbc8.jar' from Maven Central].
.. Copy the downloaded driver file to the directory that contains the {prodname} Oracle connector JAR file (`debezium-connector-oracle-{debezium-version}.jar`).
endif::product[]
ifdef::community[]
NOTE: If you use the {prodname} Oracle connector with Oracle XStream, download the JDBC driver as part of the Oracle Instant Client package.
NOTE: If you use the {prodname} Oracle connector with Oracle XStream, obtain the JDBC driver as part of the Oracle Instant Client package.
For more information, see xref:obtaining-oracle-jdbc-driver-and-xstreams-api-files[].
.Procedure
. From a browser, navigate to link:https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/[Maven Central].
. Click the directory for your version of Oracle Database, and then download the `ojdbc8.jar` driver file.
. Copy the downloaded file to the `_<kafka_home>_/libs` directory that stores the {prodname} Oracle connector files, for example, `kafka/libs` .
. From a browser, link:https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/{ojdbc8-version}/ojdbc8-{ojdbc8-version}.jar[download the 'ojdbc8.jar' from Maven Central].
. Copy the downloaded driver file to the directory that contains the {prodname} Oracle connector JAR file (`debezium-connector-oracle-{debezium-version}.jar`).
endif::community[]
ifdef::community[]