What's New in This Guide
This section introduces the documentation updates for release 25.1.1xx.
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:
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:
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/enableparameter 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/faultrecoverybackuptransferfrom 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/labelsparameter in the API Parameters section to eliminate duplicate labels inndbmysqldsvc. - 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 the following parameters which are used to enable
and configure TLS for communication between cnDBTier and NFs in the
Global Parameters section:
- 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
opensslversion 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:
- Renamed the following upgrade procedures to clarify that the procedures are specific to TLS configured for 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:
- Added a rollback prerequisite in the Prerequisites section to inform that the ndbmtd pods must be restarted with
--initialflag 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:
- 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:
- 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