Skip to main content

Installation

oracdc can be installed from multiple distribution channels.

Prerequisites​

oracdc requires Java 21 or later.

JVM VersionRequired Flags
Java 21–24--enable-preview --enable-native-access=ALL-UNNAMED
Java 25+ (recommended)--enable-native-access=ALL-UNNAMED

Add these flags to the Kafka Connect worker's KAFKA_OPTS environment variable:

export KAFKA_OPTS="--enable-preview --enable-native-access=ALL-UNNAMED"

From Source Code​

Clone the repository​

git clone https://github.com/averemee-si/oracdc.git
cd oracdc

Build the project​

./mvnw clean install -Dgpg.skip

Docker Hub​

Pull the latest oracdc Docker image:

docker pull a2solutions/oracdc

A Snowflake-optimized image is also available:

docker pull a2solutions/oracdc:snowflake

See Docker Hub for available tags and configuration options.

Confluent Hub​

Install using the Confluent Hub client:

confluent-hub install a2solutions/oracdc-kafka:latest

See Confluent Hub listing for more details.

AWS Marketplace​

oracdc is available on AWS Marketplace, optimized for Amazon MSK and AWS Glue Schema Registry:

Maven Central​

Add the dependency to your project:

<dependency>
  <groupId>solutions.a2.oracle</groupId>
  <artifactId>oracdc-kafka</artifactId>
  <version>LATEST</version>
</dependency>

See Maven Central for available versions.

SQL Setup Scripts​

The source repository includes SQL scripts for setting up the Oracle database user and verifying configuration:

  • CDC user creation — grants required privileges for RedoMiner or LogMiner
  • LogMiner check — verifies LogMiner prerequisites
  • RedoMiner views/fixed tables — grants access to required data dictionary views
  • TDE setup — grants required for Transparent Data Encryption support

See the sql/ directory on GitHub for the latest scripts.