What's New in This Guide

This section introduces the documentation updates for release 25.1.1xx.

Release 25.1.103 - G20469-08, February 2026

Made minor editorial changes in the document.

Release 25.1.103 - G20469-07, February 2026

Upgrade Updates

Added the section Verifying the Schema Upgrade to verify that the schema upgrade was successful and has been replicated across the georeplication sites.

Fault Recovery Updates:

Updated the section Restoring Georeplication (GR) Failure to include enhanced GRR procedures with support for both manual and automated recovery, improved site selection, and better monitoring for seamless cnDBTier replication restoration.

Release 25.1.103 - G20469-06, October 2025

Upgrade Updates

• Removed the duplicated section "Upgrading cnDBTier Clusters".
• Added a step to perform post installation tasks after the upgrade is completed in the following sections:
  • Upgrading cnDBTier Clusters with an Upgrade Service Account
  • Upgrading cnDBTier Clusters without an Upgrade Service Account

Release 25.1.103 - G20469-05, October 2025

Post Installation Updates

Added steps to update the DBTier specific alerts file with DBTier namespace in the following sections:

• Loading cnDBTier Alerts to OSO Prometheus
• Loading cnDBTier Alerts to Prometheus Operator

Release 25.1.103 - G20469-04, August 2025

General Updates:

• Updated the release number to "25.1.103" in the entire document.

Fault Recovery Updates:

• Removed the steps that mention about the creation of NFs during georeplication failure recovery. For more information see the Restoring Georeplication (GR) Failure section.

Release 25.1.102 - G20469-03, July 2025

General Updates:

• Updated the release number to "25.1.102" in the entire document.

Installation Updates:

• Added a note in the Installing cnDBTier section to notify users to perform manual procedures or use fatal georeplication recovery procedures in case of any script failure during any operations.

Release 25.1.101 - G20469-02, May 2025

General Updates:

• Updated the release number to "25.1.101" in the entire document.
• Added a note to indicate installation-only parameters in Global Parameters section.

Release 25.1.100 - G20469-01, April 2025

General Updates:

• Updated the MySQL version from "8.4.2" to "8.4.3" in the entire document.
• Updated the release number to "25.1.100" in the entire document.
• Updated the timestamps in the sample outputs in the entire document.
• Added error correction policy details for 25.1.100 in the Oracle Error Correction Policy section.

Installation Updates:

• Added a note in the Installing cnDBTier section to highlight the points to consider when HTTPS is enabled.
• Updated the CPU and RAM resources for backup manager service in the Resource Requirement section.
• Added a step to create secrets that host the TLS certificates used to encrypt the communication between cnDBTier and NFs in the Creating Secrets section.
• Updated the steps to create HTTPS secret in the Creating Secrets section.
• The following updates are made in the Customizing cnDBTier section:
  • Added the following parameters which are used to enable and configure TLS for communication between cnDBTier and NFs in the Global Parameters section:
    • /global/ndbappTLS/enable
    • /global/ndbappTLS/caSecret
    • /global/ndbappTLS/serverSecret
    • /global/ndbappTLS/tlsversion
    • /global/ndbappTLS/caCertificate
    • /global/ndbappTLS/serverCertificate
    • /global/ndbappTLS/serverCertificateKey
  • Added the /global/parallelbackuptransferandrestore/enable parameter which is used to enable or disable parallel backup transfer and restore during a georeplication recovery in the Global Parameters section.
  • Updated the default value of /global/remotetransfer/faultrecoverybackuptransfer from true to false in the Global Parameters section.
  • Added the following parameters in the DB Replication Service Parameters section:
    • /db-replication-svc/initiatebackupBeforeGeoRecoveryRestore
    • /db-replication-svc/threadcountforbackupchecksumvalidation
  • Updated the default value of the /api/externalService/labels parameter in the API Parameters section to eliminate duplicate labels in ndbmysqldsvc.
  • Updated the default values of the following parameters in the DB Backup Manager Service Parameters section:
    • /db-backup-manager-svc/resources/limits/cpu (from 100 Mi to 1 Gi)
    • /db-backup-manager-svc/resources/limits/memory (from 128 Mi to 1 Gi)
    • /db-backup-manager-svc/resources/requests/cpu (from 128 Mi to 1 Gi)
    • /db-backup-manager-svc/resources/requests/memory (from 90 Mi to 1 Gi)
• Added a step in the Installation Task to alter NF user privilege to restrict communication from non-TLS NF sources.
• Updated the steps to create HTTPS certificates and added the recommended openssl version in the Creating HTTPS or TLS Certificates for Encrypted Connection section.

Upgrade, Rollback, and Uninstall Updates:

• Added a note in the following sections to highlight the points to consider when HTTPS is enabled:
  • unresolvable-reference.html#GUID-8069E610-7853-4F69-90A0-1C785F9A8849
  • Rolling Back cnDBTier
• Renamed the following upgrade procedures to clarify that the procedures are specific to TLS configured for replication:
  • Upgrading cnDBTier from Non-TLS to TLS Enabled Version (Replication)
  • Upgrading cnDBTier from TLS Enabled to Non-TLS Version (Replication)
• Added the following sections to provide the procedures to upgrade cnDBTier from a version where TLS is not enabled for NF communication to a version where TLS is enabled for NF communication and vice versa:
  • Upgrading cnDBTier from Non-TLS to TLS Enabled Version (NF Communication)
  • Upgrading cnDBTier from TLS Enabled to Non-TLS Version (NF Communication)
• Added a rollback prerequisite in the Prerequisites section to inform that the ndbmtd pods must be restarted with --initial flag if cnDBTier was upgraded from 23.4.6 to 25.1.100 and is now rolled back to 23.4.6.
• Renamed the following rollback procedures to clarify that the procedures are specific to TLS configured for replication:
  • Rolling Back cnDBTier from Non-TLS to TLS Enabled Version (Replication)
  • Rolling Back cnDBTier from TLS enabled to Non-TLS Version (Replication)
• Added the following sections to provide the procedures to roll back cnDBTier from a version where TLS is not enabled for NF communication to a version where TLS is enabled for NF communication and vice versa:
  • Rolling Back cnDBTier from Non-TLS to TLS Enabled Version (NF Communication)
  • Rolling Back cnDBTier from TLS enabled to Non-TLS Version (NF Communication)
• Updated the sample output in the Uninstalling cnDBTier section to include the secrets related to TLS certificates of application SQL pods.

Fault Recovery Updates:

• Updated the steps to restore database from backup in the Restoring Database from Backup with ndb_restore section.
• Added a step in the following fault recovery procedures to alter NF user privilege to allow NF communication over TLS:
  • Reinstalling cnDBTier Cluster
  • Resolving GR Failure Between cnDBTier Clusters in a Two-Cluster Replication
  • Resolving GR Failure Between cnDBTier Clusters in a Three-Cluster Replication
  • Restoring Two cnDBTier Clusters in a Three-Cluster Replication
  • Resolving GR Failure Between cnDBTier Clusters in a Four-Cluster Replication
• Added the following georeplication recovery statuses in the Georeplication Recovery Status section:
  • LOCK_NF_USERS
  • INITIATE_PARALLEL_BACKUP_TRANSFER
  • MONITOR_PARALLEL_BACKUP_TRANSFER
  • MONITOR_PARALLEL_BACKUP_RESTORE
  • PARALLEL_BACKUP_RESTORE_COMPLETED
  • GRR_FAILED
  • UNLOCK_NF_USERS