Skip to content

RDSC-6347: RDI 2.4.0 upgrade notes for Debezium 3.7 - #4491

Draft
orhanabdula-prog wants to merge 4 commits into
redis:mainfrom
orhanabdula-prog:RDSC-6347-rdi-2-4-0-release-notes
Draft

orhanabdula-prog wants to merge 4 commits into
redis:mainfrom
orhanabdula-prog:RDSC-6347-rdi-2-4-0-release-notes

Conversation

@orhanabdula-prog

@orhanabdula-prog orhanabdula-prog commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Docs for the RDI 2.4.0 upgrade to Debezium 3.7. Jira: RDSC-6347. Related RDI change: RedisLabs/redis-data-integration#2975.

Keep as draft until RDI 2.4.0 is released.

What changes for users

RDI 2.4.0 moves its collector from Debezium 3.5 to Debezium 3.7. Some settings that worked before now fail or behave differently:

  • Oracle: some LogMiner tuning settings, such as log.mining.batch.size.* and log.mining.sleep.time.*, no longer exist, and RDI rejects them. Users tune log.mining.log.count.min and log.mining.log.count.growth.max instead.
  • MySQL and MariaDB: snapshot.mode: never is no longer allowed. Use no_data.
  • MariaDB: the TLS setting database.ssl.mode takes new values, for example verify-ca instead of verify_ca.
  • PostgreSQL: user-defined types are reported without their schema, for example geometry instead of "inventory"."geometry".

What this PR changes

Page Change
installation/upgrade.md New "Upgrading to RDI 2.4.0" section: what to remove or change before you upgrade.
release-notes/rdi-2-4-0.md New draft release notes. The date and the other 2.4.0 changes are added at release.
prepare-dbs/oracle.md Fixes the archive log property name, because the old name was silently ignored. The custom Docker image steps now start from the RDI 2.4.0 Debezium image instead of an old 3.0.8 image.
supported-types.md Recommends only the online_catalog mining strategy, because the other one is deprecated.
prepare-dbs/my-sql-mariadb.md Shows the TLS example separately for MySQL and MariaDB.
installation/install-k8s.md Updates the Debezium image tag to 3.7.0.Final-rdi.2.
data-pipelines/pipeline-config.md, 1.19.1/data-pipelines/pipeline-config.md, embeds/rdi-snapshot-modes.md Splits the snapshot mode notes by version. The shared snippet keeps only what is true for every version, the 1.19.1 page keeps its Debezium 3.5 notes, and the latest page gets new Debezium 3.7 notes.

Before merging

  • Confirm that 3.7.0.Final-rdi.2 is the final image tag for 2.4.0.
  • Test-build the Oracle custom Docker images on the new base image.
  • Ask RDI engineering whether ddl.parser.type: legacy works for MariaDB sources. Debezium defines it only for MySQL.
  • When the 2.2.x versioned docs folder is created, add the Debezium 3.5 snapshot notes to its pipeline-config.md, as in 1.19.1/.
  • Regenerate reference/config-yaml-reference.md in the release reference PR.

Follow-ups in separate PRs

  • The 2.0.0 and 1.19.1 Oracle pages still use the wrong archive log property name.
  • data-pipelines/pipeline-config.md says RDI 2.2.0 uses Debezium 3.7, but it uses 3.5. Fix this on main now, and update it for 2.4.0 in this PR at release.
  • RDI 2.4.0 also changes the VM log file paths, which this PR doesn't cover.

🤖 Generated with Claude Code

@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants